mirror of
https://git.dev.opencascade.org/repos/occt.git
synced 2025-04-10 18:51:21 +03:00
3c4b62a436
OpenGl_Texture::Init2DMultisample() - new method to initialize multisampled texture. Graphic3d_RenderingParams::NbMsaaSamples - add option defining MSAA samples number. RayTracing will keep using FBO without MSAA, however it is possible to combine MSAA for rasterization and FSAA for RayTracing. OpenGl_FrameBuffer constructor has been changed to do not take arguments. OpenGl_FrameBuffer::Init() method has been extended with mandatory parameters defining Color and Depth attachment formats and optional parameter defining number of MSAA parameters. Draw Harness, add option -msaa to vrenderparams.
299 lines
8.7 KiB
C++
299 lines
8.7 KiB
C++
// Created by: Kirill GAVRILOV
|
|
// Copyright (c) 2013-2014 OPEN CASCADE SAS
|
|
//
|
|
// This file is part of Open CASCADE Technology software library.
|
|
//
|
|
// This library is free software; you can redistribute it and/or modify it under
|
|
// the terms of the GNU Lesser General Public License version 2.1 as published
|
|
// by the Free Software Foundation, with special exception defined in the file
|
|
// OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
|
|
// distribution for complete text of the license and disclaimer of any warranty.
|
|
//
|
|
// Alternatively, this file may be used under the terms of Open CASCADE
|
|
// commercial license or contractual agreement.
|
|
|
|
#ifndef _OpenGl_Texture_H__
|
|
#define _OpenGl_Texture_H__
|
|
|
|
#include <OpenGl_GlCore13.hxx>
|
|
#include <OpenGl_Resource.hxx>
|
|
#include <Graphic3d_TypeOfTexture.hxx>
|
|
|
|
class OpenGl_Context;
|
|
class Graphic3d_TextureParams;
|
|
class Image_PixMap;
|
|
|
|
//! Selects preferable texture format for specified parameters.
|
|
template<class T>
|
|
struct OpenGl_TextureFormatSelector
|
|
{
|
|
// Not implemented
|
|
};
|
|
|
|
template<>
|
|
struct OpenGl_TextureFormatSelector<GLubyte>
|
|
{
|
|
static GLint Internal (GLuint theChannels)
|
|
{
|
|
switch (theChannels)
|
|
{
|
|
case 1:
|
|
return GL_R8;
|
|
case 2:
|
|
return GL_RG8;
|
|
case 3:
|
|
return GL_RGB8;
|
|
case 4:
|
|
return GL_RGBA8;
|
|
default:
|
|
return GL_NONE;
|
|
}
|
|
}
|
|
};
|
|
|
|
template<>
|
|
struct OpenGl_TextureFormatSelector<GLushort>
|
|
{
|
|
static GLint Internal (GLuint theChannels)
|
|
{
|
|
switch (theChannels)
|
|
{
|
|
case 1:
|
|
return GL_R16;
|
|
case 2:
|
|
return GL_RG16;
|
|
case 3:
|
|
return GL_RGB16;
|
|
case 4:
|
|
return GL_RGBA16;
|
|
default:
|
|
return GL_NONE;
|
|
}
|
|
}
|
|
};
|
|
|
|
template<>
|
|
struct OpenGl_TextureFormatSelector<GLfloat>
|
|
{
|
|
static GLint Internal (GLuint theChannels)
|
|
{
|
|
switch (theChannels)
|
|
{
|
|
case 1:
|
|
return GL_R32F;
|
|
case 2:
|
|
return GL_RG32F;
|
|
case 3:
|
|
return GL_RGB32F;
|
|
case 4:
|
|
return GL_RGBA32F;
|
|
default:
|
|
return GL_NONE;
|
|
}
|
|
}
|
|
};
|
|
|
|
//! Stores parameters of OpenGL texture format.
|
|
class OpenGl_TextureFormat
|
|
{
|
|
friend class OpenGl_Texture;
|
|
|
|
public:
|
|
|
|
//! Returns OpenGL format of the pixel data.
|
|
inline GLenum Format() const
|
|
{
|
|
switch (myChannels)
|
|
{
|
|
case 1:
|
|
return GL_RED;
|
|
case 2:
|
|
return GL_RG;
|
|
case 3:
|
|
return GL_RGB;
|
|
case 4:
|
|
return GL_RGBA;
|
|
default:
|
|
return GL_NONE;
|
|
}
|
|
}
|
|
|
|
//! Returns OpenGL internal format of the pixel data.
|
|
inline GLint Internal() const
|
|
{
|
|
return myInternal;
|
|
}
|
|
|
|
//! Returns texture format for specified type and number of channels.
|
|
template<class T, int N>
|
|
static OpenGl_TextureFormat Create()
|
|
{
|
|
return OpenGl_TextureFormat (N, OpenGl_TextureFormatSelector<T>::Internal (N));
|
|
}
|
|
|
|
private:
|
|
|
|
//! Creates new texture format.
|
|
OpenGl_TextureFormat (const GLint theChannels,
|
|
const GLint theInternal)
|
|
: myInternal (theInternal),
|
|
myChannels (theChannels) {}
|
|
|
|
private:
|
|
|
|
GLint myInternal; //!< OpenGL internal format of the pixel data
|
|
GLint myChannels; //!< Number of channels for each pixel (from 1 to 4)
|
|
|
|
};
|
|
|
|
class OpenGl_Texture;
|
|
DEFINE_STANDARD_HANDLE(OpenGl_Texture, OpenGl_Resource)
|
|
|
|
//! Texture resource.
|
|
class OpenGl_Texture : public OpenGl_Resource
|
|
{
|
|
|
|
public:
|
|
|
|
//! Helpful constants
|
|
static const GLuint NO_TEXTURE = 0;
|
|
|
|
public:
|
|
|
|
//! Create uninitialized VBO.
|
|
Standard_EXPORT OpenGl_Texture (const Handle(Graphic3d_TextureParams)& theParams = NULL);
|
|
|
|
//! Destroy object.
|
|
Standard_EXPORT virtual ~OpenGl_Texture();
|
|
|
|
//! @return true if current object was initialized
|
|
inline bool IsValid() const
|
|
{
|
|
return myTextureId != NO_TEXTURE;
|
|
}
|
|
|
|
//! @return target to which the texture is bound (GL_TEXTURE_1D, GL_TEXTURE_2D)
|
|
inline GLenum GetTarget() const
|
|
{
|
|
return myTarget;
|
|
}
|
|
|
|
//! @return texture width (0 LOD)
|
|
inline GLsizei SizeX() const
|
|
{
|
|
return mySizeX;
|
|
}
|
|
|
|
//! @return texture height (0 LOD)
|
|
inline GLsizei SizeY() const
|
|
{
|
|
return mySizeY;
|
|
}
|
|
|
|
//! @return texture ID
|
|
inline GLuint TextureId() const
|
|
{
|
|
return myTextureId;
|
|
}
|
|
|
|
//! @return texture format (not sized)
|
|
inline GLenum GetFormat() const
|
|
{
|
|
return myTextFormat;
|
|
}
|
|
|
|
//! Return true for GL_RED and GL_ALPHA formats.
|
|
bool IsAlpha() const
|
|
{
|
|
return myIsAlpha;
|
|
}
|
|
|
|
//! Setup to interprete the format as Alpha by Shader Manager
|
|
//! (should be GL_ALPHA within compatible context or GL_RED otherwise).
|
|
void SetAlpha (const bool theValue)
|
|
{
|
|
myIsAlpha = theValue;
|
|
}
|
|
|
|
//! Creates Texture id if not yet generated.
|
|
//! Data should be initialized by another method.
|
|
Standard_EXPORT bool Create (const Handle(OpenGl_Context)& theCtx);
|
|
|
|
//! Destroy object - will release GPU memory if any.
|
|
Standard_EXPORT virtual void Release (OpenGl_Context* theCtx);
|
|
|
|
//! Bind this Texture to specified unit.
|
|
Standard_EXPORT void Bind (const Handle(OpenGl_Context)& theCtx,
|
|
const GLenum theTextureUnit = GL_TEXTURE0) const;
|
|
|
|
//! Unbind texture from specified unit.
|
|
Standard_EXPORT void Unbind (const Handle(OpenGl_Context)& theCtx,
|
|
const GLenum theTextureUnit = GL_TEXTURE0) const;
|
|
|
|
//! Notice that texture will be unbound after this call.
|
|
Standard_EXPORT bool Init (const Handle(OpenGl_Context)& theCtx,
|
|
const Image_PixMap& theImage,
|
|
const Graphic3d_TypeOfTexture theType);
|
|
|
|
//! Initialize the texture with specified format, size and texture type.
|
|
//! If theImage is empty the texture data will contain trash.
|
|
//! Notice that texture will be unbound after this call.
|
|
Standard_EXPORT bool Init (const Handle(OpenGl_Context)& theCtx,
|
|
const GLint theTextFormat,
|
|
const GLenum thePixelFormat,
|
|
const GLenum theDataType,
|
|
const GLsizei theSizeX,
|
|
const GLsizei theSizeY,
|
|
const Graphic3d_TypeOfTexture theType,
|
|
const Image_PixMap* theImage = NULL);
|
|
|
|
//! Initialize the 2D multisampling texture using glTexImage2DMultisample().
|
|
Standard_EXPORT bool Init2DMultisample (const Handle(OpenGl_Context)& theCtx,
|
|
const GLsizei theNbSamples,
|
|
const GLint theTextFormat,
|
|
const GLsizei theSizeX,
|
|
const GLsizei theSizeY);
|
|
|
|
//! Allocates texture rectangle with specified format and size.
|
|
//! \note Texture data is not initialized (will contain trash).
|
|
Standard_EXPORT bool InitRectangle (const Handle(OpenGl_Context)& theCtx,
|
|
const Standard_Integer theSizeX,
|
|
const Standard_Integer theSizeY,
|
|
const OpenGl_TextureFormat& theFormat);
|
|
|
|
//! @return true if texture was generated within mipmaps
|
|
Standard_EXPORT const Standard_Boolean HasMipmaps() const;
|
|
|
|
//! @return assigned texture parameters (not necessary applied)
|
|
Standard_EXPORT const Handle(Graphic3d_TextureParams)& GetParams() const;
|
|
|
|
//! @param texture parameters
|
|
Standard_EXPORT void SetParams (const Handle(Graphic3d_TextureParams)& theParams);
|
|
|
|
//! Return texture type and format by Image_PixMap data format.
|
|
Standard_EXPORT static bool GetDataFormat (const Handle(OpenGl_Context)& theCtx,
|
|
const Image_PixMap& theData,
|
|
GLint& theTextFormat,
|
|
GLenum& thePixelFormat,
|
|
GLenum& theDataType);
|
|
|
|
protected:
|
|
|
|
GLuint myTextureId; //!< GL resource ID
|
|
GLenum myTarget; //!< GL_TEXTURE_1D/GL_TEXTURE_2D
|
|
GLsizei mySizeX; //!< texture width
|
|
GLsizei mySizeY; //!< texture height
|
|
GLenum myTextFormat; //!< texture format - GL_RGB, GL_RGBA,...
|
|
Standard_Boolean myHasMipmaps; //!< flag indicates that texture was uploaded with mipmaps
|
|
bool myIsAlpha; //!< indicates alpha format
|
|
|
|
Handle(Graphic3d_TextureParams) myParams; //!< texture parameters
|
|
|
|
public:
|
|
|
|
DEFINE_STANDARD_RTTI(OpenGl_Texture, OpenGl_Resource) // Type definition
|
|
|
|
};
|
|
|
|
#endif // _OpenGl_Texture_H__
|