OpenSceneGraph 3.6.5
|
Texture pure virtual base class that encapsulates OpenGL texture functionality common to the various types of OSG textures. More...
#include <Texture>
Classes | |
class | TextureObject |
struct | TextureProfile |
Public Member Functions | |
Texture () | |
Texture (const Texture &text, const CopyOp ©op=CopyOp::SHALLOW_COPY) | |
Copy constructor using CopyOp to manage deep vs shallow copy. | |
virtual osg::Object * | cloneType () const =0 |
Clone the type of an attribute, with Object* return type. | |
virtual osg::Object * | clone (const CopyOp ©op) const =0 |
Clone an attribute, with Object* return type. | |
virtual bool | isSameKindAs (const osg::Object *obj) const |
Return true if this and obj are of the same kind of object. | |
virtual const char * | libraryName () const |
Return the name of the attribute's library. | |
virtual const char * | className () const |
Return the name of the attribute's class type. | |
virtual Texture * | asTexture () |
Fast alternative to dynamic_cast<> for determining if state attribute is a Texture. | |
virtual const Texture * | asTexture () const |
Fast alternative to dynamic_cast<> for determining if state attribute is a Texture. | |
virtual Type | getType () const |
Return the Type identifier of the attribute's class type. | |
virtual bool | isTextureAttribute () const |
Return true if StateAttribute is a type which controls texturing and needs to be issued w.r.t to specific texture unit. | |
virtual GLenum | getTextureTarget () const =0 |
virtual int | getTextureWidth () const |
virtual int | getTextureHeight () const |
virtual int | getTextureDepth () const |
void | setWrap (WrapParameter which, WrapMode wrap) |
Sets the texture wrap mode. | |
WrapMode | getWrap (WrapParameter which) const |
Gets the texture wrap mode. | |
void | setBorderColor (const Vec4d &color) |
Sets the border color. | |
const Vec4d & | getBorderColor () const |
Gets the border color. | |
void | setBorderWidth (GLint width) |
Sets the border width. | |
GLint | getBorderWidth () const |
void | setFilter (FilterParameter which, FilterMode filter) |
Sets the texture filter mode. | |
FilterMode | getFilter (FilterParameter which) const |
Gets the texture filter mode. | |
void | setMaxAnisotropy (float anis) |
Sets the maximum anisotropy value, default value is 1.0 for no anisotropic filtering. | |
float | getMaxAnisotropy () const |
Gets the maximum anisotropy value. | |
void | setMinLOD (float minlod) |
Sets the minimum level of detail value. | |
float | getMinLOD () const |
Gets the minimum level of detail value. | |
void | setMaxLOD (float maxlod) |
Sets the maximum level of detail value. | |
float | getMaxLOD () const |
Gets the maximum level of detail value. | |
void | setLODBias (float lodbias) |
Gets the level of detail bias value. | |
float | getLODBias () const |
Sets the level of detail bias value. | |
void | setSwizzle (const Vec4i &swizzle) |
Configure the source of texture swizzling for all channels. | |
const Vec4i & | getSwizzle () const |
Gets the source of texture swizzling for all channels. | |
void | setUseHardwareMipMapGeneration (bool useHardwareMipMapGeneration) |
Sets the hardware mipmap generation hint. | |
bool | getUseHardwareMipMapGeneration () const |
Gets the hardware mipmap generation hint. | |
void | setUnRefImageDataAfterApply (bool flag) |
Sets whether or not the apply() function will unreference the image data. | |
bool | getUnRefImageDataAfterApply () const |
Gets whether or not apply() unreferences image data. | |
void | setClientStorageHint (bool flag) |
Sets whether to use client storage for the texture, if supported by the graphics system. | |
bool | getClientStorageHint () const |
Gets whether to use client storage for the texture. | |
void | setResizeNonPowerOfTwoHint (bool flag) |
Sets whether to force the texture to resize images that have dimensions that are not a power of two. | |
bool | getResizeNonPowerOfTwoHint () const |
Gets whether texture will force non power to two images to be resized. | |
void | setInternalFormatMode (InternalFormatMode mode) |
Sets the internal texture format mode. | |
InternalFormatMode | getInternalFormatMode () const |
Gets the internal texture format mode. | |
void | setInternalFormat (GLint internalFormat) |
Sets the internal texture format. | |
GLint | getInternalFormat () const |
Gets the internal texture format. | |
bool | isCompressedInternalFormat () const |
Return true if the internal format is one of the compressed formats. | |
void | setSourceFormat (GLenum sourceFormat) |
Sets the external source image format, used as a fallback when no osg::Image is attached to provide the source image format. | |
GLenum | getSourceFormat () const |
Gets the external source image format. | |
void | setSourceType (GLenum sourceType) |
Sets the external source data type, used as a fallback when no osg::Image is attached to provide the source image format. | |
GLenum | getSourceType () const |
Gets the external source data type. | |
InternalFormatType | getInternalFormatType () const |
Get the internal texture format type. | |
GLenum | selectSizedInternalFormat (const osg::Image *image=0) const |
virtual bool | isDirty (unsigned int) const |
return true if the texture image data has been modified and the associated GL texture object needs to be updated. | |
TextureObject * | getTextureObject (unsigned int contextID) const |
Returns a pointer to the TextureObject for the current context. | |
void | setTextureObject (unsigned int contextID, TextureObject *to) |
void | dirtyTextureObject () |
Forces a recompile on next apply() of associated OpenGL texture objects. | |
bool | areAllTextureObjectsLoaded () const |
Returns true if the texture objects for all the required graphics contexts are loaded. | |
unsigned int & | getTextureParameterDirty (unsigned int contextID) const |
Gets the dirty flag for the current contextID. | |
void | dirtyTextureParameters () |
Force a reset on next apply() of associated OpenGL texture parameters. | |
void | allocateMipmapLevels () |
Force a manual allocation of the mipmap levels on the next apply() call. | |
void | setShadowComparison (bool flag) |
Sets GL_TEXTURE_COMPARE_MODE_ARB to GL_COMPARE_R_TO_TEXTURE_ARB See http://oss.sgi.com/projects/ogl-sample/registry/ARB/shadow.txt. | |
bool | getShadowComparison () const |
void | setShadowCompareFunc (ShadowCompareFunc func) |
Sets shadow texture comparison function. | |
ShadowCompareFunc | getShadowCompareFunc () const |
void | setShadowTextureMode (ShadowTextureMode mode) |
Sets shadow texture mode after comparison. | |
ShadowTextureMode | getShadowTextureMode () const |
void | setShadowAmbient (float shadow_ambient) |
Sets the TEXTURE_COMPARE_FAIL_VALUE_ARB texture parameter. | |
float | getShadowAmbient () const |
virtual void | setImage (unsigned int face, Image *image)=0 |
Sets the texture image for the specified face. | |
template<class T> | |
void | setImage (unsigned int face, const ref_ptr< T > &image) |
virtual Image * | getImage (unsigned int face)=0 |
Gets the texture image for the specified face. | |
virtual const Image * | getImage (unsigned int face) const =0 |
Gets the const texture image for specified face. | |
virtual unsigned int | getNumImages () const =0 |
Gets the number of images that can be assigned to this Texture. | |
void | setReadPBuffer (GraphicsContext *context) |
Set the PBuffer graphics context to read from when using PBuffers for RenderToTexture. | |
template<class T> | |
void | setReadPBuffer (const ref_ptr< T > &context) |
GraphicsContext * | getReadPBuffer () |
Get the PBuffer graphics context to read from when using PBuffers for RenderToTexture. | |
const GraphicsContext * | getReadPBuffer () const |
Get the const PBuffer graphics context to read from when using PBuffers for RenderToTexture. | |
virtual void | apply (State &state) const =0 |
Texture is a pure virtual base class, apply must be overridden. | |
virtual void | compileGLObjects (State &state) const |
Calls apply(state) to compile the texture. | |
virtual void | resizeGLObjectBuffers (unsigned int maxSize) |
Resize any per context GLObject buffers to specified size. | |
virtual void | releaseGLObjects (State *state=0) const |
If State is non-zero, this function releases OpenGL objects for the specified graphics context. | |
void | applyTexImage2D_load (State &state, GLenum target, const Image *image, GLsizei width, GLsizei height, GLsizei numMipmapLevels) const |
Helper method. | |
void | applyTexImage2D_subload (State &state, GLenum target, const Image *image, GLsizei width, GLsizei height, GLint inInternalFormat, GLsizei numMipmapLevels) const |
Helper method. | |
TextureObject * | generateAndAssignTextureObject (unsigned int contextID, GLenum target) const |
TextureObject * | generateAndAssignTextureObject (unsigned int contextID, GLenum target, GLint numMipmapLevels, GLenum internalFormat, GLsizei width, GLsizei height, GLsizei depth, GLint border) const |
Public Member Functions inherited from osg::StateAttribute | |
StateAttribute () | |
StateAttribute (const StateAttribute &sa, const CopyOp ©op=CopyOp::SHALLOW_COPY) | |
virtual StateAttribute * | asStateAttribute () |
Convert 'this' into a StateAttribute pointer if Object is a StateAttribute, otherwise return 0. | |
virtual const StateAttribute * | asStateAttribute () const |
convert 'const this' into a const StateAttribute pointer if Object is a StateAttribute, otherwise return 0. | |
virtual unsigned int | getMember () const |
Return the member identifier within the attribute's class type. | |
TypeMemberPair | getTypeMemberPair () const |
Return the TypeMemberPair that uniquely identifies this type member. | |
virtual int | compare (const StateAttribute &sa) const =0 |
Return -1 if *this < *rhs, 0 if *this==*rhs, 1 if *this>*rhs. | |
bool | operator< (const StateAttribute &rhs) const |
bool | operator== (const StateAttribute &rhs) const |
bool | operator!= (const StateAttribute &rhs) const |
const ParentList & | getParents () const |
Get the parent list of this StateAttribute. | |
StateSet * | getParent (unsigned int i) |
const StateSet * | getParent (unsigned int i) const |
Get a single const parent of this StateAttribute. | |
unsigned int | getNumParents () const |
Get the number of parents of this StateAttribute. | |
void | setShaderComponent (ShaderComponent *sc) |
ShaderComponent * | getShaderComponent () |
const ShaderComponent * | getShaderComponent () const |
virtual bool | getModeUsage (ModeUsage &) const |
Return the modes associated with this StateAttribute. | |
virtual bool | checkValidityOfAssociatedModes (osg::State &) const |
Check the modes associated with this StateAttribute are supported by current OpenGL drivers, and if not set the associated mode in osg::State to be black listed/invalid. | |
void | setUpdateCallback (StateAttributeCallback *uc) |
Set the UpdateCallback which allows users to attach customize the updating of an object during the update traversal. | |
StateAttributeCallback * | getUpdateCallback () |
Get the non const UpdateCallback. | |
const StateAttributeCallback * | getUpdateCallback () const |
Get the const UpdateCallback. | |
void | setEventCallback (StateAttributeCallback *ec) |
Set the EventCallback which allows users to attach customize the updating of an object during the Event traversal. | |
StateAttributeCallback * | getEventCallback () |
Get the non const EventCallback. | |
const StateAttributeCallback * | getEventCallback () const |
Get the const EventCallback. | |
Public Member Functions inherited from osg::Object | |
Object () | |
Construct an object. | |
Object (bool threadSafeRefUnref) | |
Object (const Object &, const CopyOp ©op=CopyOp::SHALLOW_COPY) | |
Copy constructor, optional CopyOp object can be used to control shallow vs deep copying of dynamic data. | |
std::string | getCompoundClassName () const |
return the compound class name that combines the library name and class name. | |
virtual Node * | asNode () |
Convert 'this' into a Node pointer if Object is a Node, otherwise return 0. | |
virtual const Node * | asNode () const |
convert 'const this' into a const Node pointer if Object is a Node, otherwise return 0. | |
virtual NodeVisitor * | asNodeVisitor () |
Convert 'this' into a NodeVisitor pointer if Object is a NodeVisitor, otherwise return 0. | |
virtual const NodeVisitor * | asNodeVisitor () const |
convert 'const this' into a const NodeVisitor pointer if Object is a NodeVisitor, otherwise return 0. | |
virtual StateSet * | asStateSet () |
Convert 'this' into a StateSet pointer if Object is a StateSet, otherwise return 0. | |
virtual const StateSet * | asStateSet () const |
convert 'const this' into a const StateSet pointer if Object is a StateSet, otherwise return 0. | |
virtual Uniform * | asUniform () |
Convert 'this' into a Uniform pointer if Object is a Uniform, otherwise return 0. | |
virtual const Uniform * | asUniform () const |
convert 'const this' into a const Uniform pointer if Object is a Uniform, otherwise return 0. | |
virtual Camera * | asCamera () |
Convert 'this' into a Camera pointer if Node is a Camera, otherwise return 0. | |
virtual const Camera * | asCamera () const |
convert 'const this' into a const Camera pointer if Node is a Camera, otherwise return 0. | |
virtual Drawable * | asDrawable () |
Convert 'this' into a Drawable pointer if Object is a Drawable, otherwise return 0. | |
virtual const Drawable * | asDrawable () const |
convert 'const this' into a const Drawable pointer if Object is a Drawable, otherwise return 0. | |
virtual Callback * | asCallback () |
Convert 'this' into a Callback pointer if Object is a Callback, otherwise return 0. | |
virtual const Callback * | asCallback () const |
convert 'const this' into a const Callback pointer if Object is a Callback, otherwise return 0. | |
virtual CallbackObject * | asCallbackObject () |
Convert 'this' into a CallbackObject pointer if Object is a CallbackObject, otherwise return 0. | |
virtual const CallbackObject * | asCallbackObject () const |
convert 'const this' into a const CallbackObject pointer if Object is a CallbackObject, otherwise return 0. | |
virtual UserDataContainer * | asUserDataContainer () |
Convert 'this' into a UserDataContainer pointer if Object is a UserDataContainer, otherwise return 0. | |
virtual const UserDataContainer * | asUserDataContainer () const |
convert 'const this' into a const UserDataContainer pointer if Object is a UserDataContainer, otherwise return 0. | |
virtual ValueObject * | asValueObject () |
Convert 'this' into a ValueObject pointer if Object is a ValueObject, otherwise return 0. | |
virtual const ValueObject * | asValueObject () const |
Convert 'this' into a ValueObject pointer if Object is a ValueObject, otherwise return 0. | |
virtual Image * | asImage () |
Convert 'this' into a Image pointer if Object is a Image, otherwise return 0. | |
virtual const Image * | asImage () const |
Convert 'this' into a Image pointer if Object is a Image, otherwise return 0. | |
virtual void | setThreadSafeRefUnref (bool threadSafe) |
Set whether to use a mutex to ensure ref() and unref() are thread safe. | |
virtual void | setName (const std::string &name) |
Set the name of object using C++ style string. | |
void | setName (const char *name) |
Set the name of object using a C style string. | |
const std::string & | getName () const |
Get the name of object. | |
void | setDataVariance (DataVariance dv) |
Set the data variance of this object. | |
DataVariance | getDataVariance () const |
Get the data variance of this object. | |
virtual void | computeDataVariance () |
Compute the DataVariance based on an assessment of callback etc. | |
void | setUserDataContainer (osg::UserDataContainer *udc) |
set the UserDataContainer object. | |
template<class T> | |
void | setUserDataContainer (const ref_ptr< T > &udc) |
osg::UserDataContainer * | getUserDataContainer () |
get the UserDataContainer attached to this object. | |
const osg::UserDataContainer * | getUserDataContainer () const |
get the const UserDataContainer attached to this object. | |
osg::UserDataContainer * | getOrCreateUserDataContainer () |
Convenience method that returns the UserDataContainer, and if one doesn't already exist creates and assigns a DefaultUserDataContainer to the Object and then return this new UserDataContainer. | |
virtual void | setUserData (Referenced *obj) |
Set user data, data must be subclassed from Referenced to allow automatic memory handling. | |
template<class T> | |
void | setUserData (const ref_ptr< T > &ud) |
virtual Referenced * | getUserData () |
Get user data. | |
virtual const Referenced * | getUserData () const |
Get const user data. | |
template<typename T> | |
bool | getUserValue (const std::string &name, T &value) const |
Convenience method that casts the named UserObject to osg::TemplateValueObject<T> and gets the value. | |
template<typename T> | |
void | setUserValue (const std::string &name, const T &value) |
Convenience method that creates the osg::TemplateValueObject<T> to store the specified value and adds it as a named UserObject. | |
template<typename T> | |
BoolValueObject UCharValueObject UShortValueObject UIntValueObject DoubleValueObject Vec3fValueObject Vec2dValueObject Vec4dValueObject PlaneValueObject MatrixdValueObject BoundingBoxdValueObject BoundingSpheredValueObject bool | getUserValue (const std::string &name, T &value) const |
provide implementation of osg::Object::getUserValue(..) template | |
Public Member Functions inherited from osg::Referenced | |
Referenced () | |
Referenced (bool threadSafeRefUnref) | |
Deprecated, Referenced is now always uses thread safe ref/unref, use default Referenced() constructor instead. | |
Referenced (const Referenced &) | |
Referenced & | operator= (const Referenced &) |
bool | getThreadSafeRefUnref () const |
Get whether a mutex is used to ensure ref() and unref() are thread safe. | |
OpenThreads::Mutex * | getRefMutex () const |
Get the mutex used to ensure thread safety of ref()/unref(). | |
int | ref () const |
Increment the reference count by one, indicating that this object has another pointer which is referencing it. | |
int | unref () const |
Decrement the reference count by one, indicating that a pointer to this object is no longer referencing it. | |
int | unref_nodelete () const |
Decrement the reference count by one, indicating that a pointer to this object is no longer referencing it. | |
int | referenceCount () const |
Return the number of pointers currently referencing this object. | |
ObserverSet * | getObserverSet () const |
Get the ObserverSet if one is attached, otherwise return NULL. | |
ObserverSet * | getOrCreateObserverSet () const |
Get the ObserverSet if one is attached, otherwise create an ObserverSet, attach it, then return this newly created ObserverSet. | |
void | addObserver (Observer *observer) const |
Add a Observer that is observing this object, notify the Observer when this object gets deleted. | |
void | removeObserver (Observer *observer) const |
Remove Observer that is observing this object. |
Static Public Member Functions | |
static bool | isCompressedInternalFormat (GLint internalFormat) |
Determine whether the given internalFormat is a compressed image format. | |
static void | getCompressedSize (GLenum internalFormat, GLint width, GLint height, GLint depth, GLint &blockSize, GLint &size) |
Determine the size of a compressed image, given the internalFormat, the width, the height, and the depth of the image. | |
static osg::ref_ptr< TextureObject > | generateTextureObject (const Texture *texture, unsigned int contextID, GLenum target) |
static osg::ref_ptr< TextureObject > | generateTextureObject (const Texture *texture, unsigned int contextID, GLenum target, GLint numMipmapLevels, GLenum internalFormat, GLsizei width, GLsizei height, GLsizei depth, GLint border) |
Static Public Member Functions inherited from osg::Referenced | |
static OpenThreads::Mutex * | getGlobalReferencedMutex () |
Get the optional global Referenced mutex, this can be shared between all osg::Referenced. | |
static void | setDeleteHandler (DeleteHandler *handler) |
Set a DeleteHandler to which deletion of all referenced counted objects will be delegated. | |
static DeleteHandler * | getDeleteHandler () |
Get a DeleteHandler. |
Protected Types | |
typedef buffered_value< unsigned int > | TexParameterDirtyList |
typedef buffered_object< ref_ptr< TextureObject > > | TextureObjectBuffer |
Protected Member Functions | |
virtual | ~Texture () |
virtual void | computeInternalFormat () const =0 |
void | computeInternalFormatWithImage (const osg::Image &image) const |
Computes the internal format from Image parameters. | |
void | computeRequiredTextureDimensions (State &state, const osg::Image &image, GLsizei &width, GLsizei &height, GLsizei &numMipmapLevels) const |
Computes the texture dimension for the given Image. | |
void | computeInternalFormatType () const |
Computes the internal format type. | |
void | applyTexParameters (GLenum target, State &state) const |
Helper method. | |
bool | isHardwareMipmapGenerationEnabled (const State &state) const |
Returns true if _useHardwareMipMapGeneration is true and either glGenerateMipmapEXT() or GL_GENERATE_MIPMAP_SGIS are supported. | |
bool | isSafeToUnrefImageData (const State &state) const |
Returns true if the associated Image should be released and it's safe to do so. | |
GenerateMipmapMode | mipmapBeforeTexImage (const State &state, bool hardwareMipmapOn) const |
Helper methods to be called before and after calling gl[Compressed][Copy]Tex[Sub]Image2D to handle generating mipmaps. | |
void | mipmapAfterTexImage (State &state, GenerateMipmapMode beforeResult) const |
void | generateMipmap (State &state) const |
Helper method to generate mipmap levels by calling of glGenerateMipmapEXT. | |
virtual void | allocateMipmap (State &state) const =0 |
Allocate mipmap levels of the texture by subsequent calling of glTexImage* function. | |
int | compareTexture (const Texture &rhs) const |
Returns -1 if *this < *rhs, 0 if *this==*rhs, 1 if *this>*rhs. | |
int | compareTextureObjects (const Texture &rhs) const |
Returns -1 if *this < *rhs, 0 if *this==*rhs, 1 if *this>*rhs. | |
Protected Member Functions inherited from osg::StateAttribute | |
virtual | ~StateAttribute () |
void | addParent (osg::StateSet *object) |
void | removeParent (osg::StateSet *object) |
Protected Member Functions inherited from osg::Object | |
virtual | ~Object () |
Object destructor. | |
Protected Member Functions inherited from osg::Referenced | |
virtual | ~Referenced () |
void | signalObserversAndDelete (bool signalDelete, bool doDelete) const |
void | deleteUsingDeleteHandler () const |
Texture pure virtual base class that encapsulates OpenGL texture functionality common to the various types of OSG textures.
|
protected |
|
protected |
typedef std::list< ref_ptr<TextureObject> > osg::Texture::TextureObjectList |
Returned by mipmapBeforeTexImage() to indicate what mipmapAfterTexImage() should do.
Enumerator | |
---|---|
GENERATE_MIPMAP_NONE | |
GENERATE_MIPMAP | |
GENERATE_MIPMAP_TEX_PARAMETER |
Texture type determined by the internal texture format.
Enumerator | |
---|---|
NORMALIZED | default OpenGL format (clamped values to [0,1) or [0,255]) |
FLOAT | float values, Shader Model 3.0 (see ARB_texture_float) |
SIGNED_INTEGER | Signed integer values (see EXT_texture_integer) |
UNSIGNED_INTEGER | Unsigned integer value (see EXT_texture_integer) |
osg::Texture::Texture | ( | ) |
Referenced by asTexture(), asTexture(), compareTexture(), compareTextureObjects(), generateTextureObject(), generateTextureObject(), osg::Texture::TextureObject::getTexture(), isSameKindAs(), osg::Texture::TextureObject::setTexture(), Texture(), osg::Texture::TextureObject::TextureObject(), osg::Texture::TextureObject::TextureObject(), and osg::Texture::TextureObject::TextureObject().
osg::Texture::Texture | ( | const Texture & | text, |
const CopyOp & | copyop = CopyOp::SHALLOW_COPY ) |
Copy constructor using CopyOp to manage deep vs shallow copy.
References osg::CopyOp::SHALLOW_COPY, and Texture().
|
protectedvirtual |
|
protectedpure virtual |
Allocate mipmap levels of the texture by subsequent calling of glTexImage* function.
Implemented in osg::Texture1D, osg::Texture2D, osg::Texture2DArray, osg::Texture2DMultisample, osg::Texture3D, osg::TextureBuffer, osg::TextureCubeMap, and osg::TextureRectangle.
void osg::Texture::allocateMipmapLevels | ( | ) |
Force a manual allocation of the mipmap levels on the next apply() call.
User is responsible for filling the mipmap levels with valid data. The OpenGL's glGenerateMipmapEXT function is used to generate the mipmap levels. If glGenerateMipmapEXT is not supported or texture's internal format is not supported by the glGenerateMipmapEXT, then empty mipmap levels will be allocated manually. The mipmap levels are also allocated if a non-mipmapped min filter is used.
|
pure virtual |
Texture is a pure virtual base class, apply must be overridden.
Reimplemented from osg::StateAttribute.
Implemented in osg::Texture1D, osg::Texture2D, osg::Texture2DArray, osg::Texture2DMultisample, osg::Texture3D, osg::TextureBuffer, osg::TextureCubeMap, and osg::TextureRectangle.
void osg::Texture::applyTexImage2D_load | ( | State & | state, |
GLenum | target, | ||
const Image * | image, | ||
GLsizei | width, | ||
GLsizei | height, | ||
GLsizei | numMipmapLevels ) const |
Helper method.
Creates the texture, but doesn't set or use a texture binding. Note: Don't call this method directly unless you're implementing a subload callback.
void osg::Texture::applyTexImage2D_subload | ( | State & | state, |
GLenum | target, | ||
const Image * | image, | ||
GLsizei | width, | ||
GLsizei | height, | ||
GLint | inInternalFormat, | ||
GLsizei | numMipmapLevels ) const |
Helper method.
Subloads images into the texture, but doesn't set or use a texture binding. Note: Don't call this method directly unless you're implementing a subload callback.
|
protected |
Helper method.
Sets texture parameters.
bool osg::Texture::areAllTextureObjectsLoaded | ( | ) | const |
Returns true if the texture objects for all the required graphics contexts are loaded.
Referenced by isSafeToUnrefImageData().
|
inlinevirtual |
Fast alternative to dynamic_cast<> for determining if state attribute is a Texture.
Reimplemented from osg::StateAttribute.
References Texture().
|
inlinevirtual |
Fast alternative to dynamic_cast<> for determining if state attribute is a Texture.
Reimplemented from osg::StateAttribute.
References Texture().
|
inlinevirtual |
Return the name of the attribute's class type.
Reimplemented from osg::StateAttribute.
Reimplemented in osgText::GlyphTexture.
|
pure virtual |
Clone an attribute, with Object* return type.
Must be defined by derived classes.
Implements osg::StateAttribute.
|
pure virtual |
Clone the type of an attribute, with Object* return type.
Must be defined by derived classes.
Implements osg::StateAttribute.
|
protected |
Returns -1 if *this < *rhs, 0 if *this==*rhs, 1 if *this>*rhs.
References Texture().
|
protected |
Returns -1 if *this < *rhs, 0 if *this==*rhs, 1 if *this>*rhs.
References Texture().
|
virtual |
Calls apply(state) to compile the texture.
Reimplemented from osg::StateAttribute.
|
protectedpure virtual |
Implemented in osg::Texture1D, osg::Texture2D, osg::Texture2DArray, osg::Texture2DMultisample, osg::Texture3D, osg::TextureBuffer, osg::TextureCubeMap, and osg::TextureRectangle.
Referenced by getInternalFormat().
|
protected |
Computes the internal format type.
Referenced by setInternalFormat().
|
protected |
Computes the internal format from Image parameters.
|
protected |
Computes the texture dimension for the given Image.
void osg::Texture::dirtyTextureObject | ( | ) |
Forces a recompile on next apply() of associated OpenGL texture objects.
void osg::Texture::dirtyTextureParameters | ( | ) |
Force a reset on next apply() of associated OpenGL texture parameters.
Referenced by setBorderColor(), setBorderWidth(), and setSwizzle().
TextureObject * osg::Texture::generateAndAssignTextureObject | ( | unsigned int | contextID, |
GLenum | target ) const |
TextureObject * osg::Texture::generateAndAssignTextureObject | ( | unsigned int | contextID, |
GLenum | target, | ||
GLint | numMipmapLevels, | ||
GLenum | internalFormat, | ||
GLsizei | width, | ||
GLsizei | height, | ||
GLsizei | depth, | ||
GLint | border ) const |
|
protected |
Helper method to generate mipmap levels by calling of glGenerateMipmapEXT.
If it is not supported, then call the virtual allocateMipmap() method
|
static |
References Texture().
Referenced by osg::Texture2D::SubloadCallback::generateTextureObject().
|
static |
References Texture().
|
inline |
Gets the border color.
References _borderColor.
|
inline |
References _borderWidth.
|
inline |
Gets whether to use client storage for the texture.
References _clientStorageHint.
|
static |
Determine the size of a compressed image, given the internalFormat, the width, the height, and the depth of the image.
The block size and the size are output parameters.
FilterMode osg::Texture::getFilter | ( | FilterParameter | which | ) | const |
Gets the texture filter mode.
|
pure virtual |
Gets the const texture image for specified face.
Implemented in osg::Texture1D, osg::Texture2D, osg::Texture2DArray, osg::Texture2DMultisample, osg::Texture3D, osg::TextureBuffer, osg::TextureCubeMap, and osg::TextureRectangle.
|
pure virtual |
Gets the texture image for the specified face.
Implemented in osg::Texture1D, osg::Texture2D, osg::Texture2DArray, osg::Texture2DMultisample, osg::Texture3D, osg::TextureBuffer, osg::TextureCubeMap, and osg::TextureRectangle.
|
inline |
Gets the internal texture format.
References _internalFormat, and computeInternalFormat().
|
inline |
Gets the internal texture format mode.
References _internalFormatMode.
|
inline |
Get the internal texture format type.
References _internalFormatType.
|
inline |
Sets the level of detail bias value.
References _lodbias.
|
inline |
Gets the maximum anisotropy value.
References _maxAnisotropy.
|
inline |
Gets the maximum level of detail value.
References _maxlod.
|
inline |
Gets the minimum level of detail value.
References _minlod.
|
pure virtual |
Gets the number of images that can be assigned to this Texture.
Implemented in osg::Texture1D, osg::Texture2D, osg::Texture2DArray, osg::Texture2DMultisample, osg::Texture3D, osg::TextureBuffer, osg::TextureCubeMap, and osg::TextureRectangle.
|
inline |
Get the PBuffer graphics context to read from when using PBuffers for RenderToTexture.
References _readPBuffer.
|
inline |
Get the const PBuffer graphics context to read from when using PBuffers for RenderToTexture.
References _readPBuffer.
|
inline |
Gets whether texture will force non power to two images to be resized.
References _resizeNonPowerOfTwoHint.
|
inline |
References _shadow_ambient.
|
inline |
References _shadow_compare_func.
|
inline |
References _use_shadow_comparison.
|
inline |
References _shadow_texture_mode.
|
inline |
Gets the external source image format.
References _sourceFormat.
|
inline |
Gets the external source data type.
References _sourceType.
|
inline |
Gets the source of texture swizzling for all channels.
References _swizzle.
|
inlinevirtual |
Reimplemented in osg::Texture1D, osg::Texture2D, osg::Texture2DArray, osg::Texture2DMultisample, osg::Texture3D, osg::TextureBuffer, osg::TextureCubeMap, and osg::TextureRectangle.
|
inlinevirtual |
Reimplemented in osg::Texture1D, osg::Texture2D, osg::Texture2DArray, osg::Texture2DMultisample, osg::Texture3D, osg::TextureBuffer, osg::TextureCubeMap, and osg::TextureRectangle.
|
inline |
Returns a pointer to the TextureObject for the current context.
References _textureObjectBuffer.
|
inline |
Gets the dirty flag for the current contextID.
References _texParametersDirtyList.
|
pure virtual |
Implemented in osg::Texture1D, osg::Texture2D, osg::Texture2DArray, osg::Texture2DMultisample, osg::Texture3D, osg::TextureBuffer, osg::TextureCubeMap, and osg::TextureRectangle.
References osg::StateAttribute::getModeUsage(), getTextureTarget(), and osg::StateAttribute::ModeUsage::usesTextureMode().
Referenced by getTextureTarget().
|
inlinevirtual |
Reimplemented in osg::Texture1D, osg::Texture2D, osg::Texture2DArray, osg::Texture2DMultisample, osg::Texture3D, osg::TextureBuffer, osg::TextureCubeMap, and osg::TextureRectangle.
|
inlinevirtual |
Return the Type identifier of the attribute's class type.
Implements osg::StateAttribute.
References osg::StateAttribute::TEXTURE.
|
inline |
Gets whether or not apply() unreferences image data.
References _unrefImageDataAfterApply.
|
inline |
Gets the hardware mipmap generation hint.
References _useHardwareMipMapGeneration.
WrapMode osg::Texture::getWrap | ( | WrapParameter | which | ) | const |
Gets the texture wrap mode.
bool osg::Texture::isCompressedInternalFormat | ( | ) | const |
Return true if the internal format is one of the compressed formats.
|
static |
Determine whether the given internalFormat is a compressed image format.
|
inlinevirtual |
return true if the texture image data has been modified and the associated GL texture object needs to be updated.
Reimplemented in osg::Texture1D, osg::Texture2D, osg::Texture2DArray, osg::Texture3D, osg::TextureBuffer, osg::TextureCubeMap, and osg::TextureRectangle.
|
protected |
Returns true if _useHardwareMipMapGeneration is true and either glGenerateMipmapEXT() or GL_GENERATE_MIPMAP_SGIS are supported.
|
inlineprotected |
Returns true if the associated Image should be released and it's safe to do so.
References _unrefImageDataAfterApply, areAllTextureObjectsLoaded(), and osg::State::getMaxTexturePoolSize().
|
inlinevirtual |
Return true if this and obj are of the same kind of object.
Reimplemented from osg::StateAttribute.
|
inlinevirtual |
Return true if StateAttribute is a type which controls texturing and needs to be issued w.r.t to specific texture unit.
Reimplemented from osg::StateAttribute.
|
inlinevirtual |
Return the name of the attribute's library.
Reimplemented from osg::StateAttribute.
|
protected |
|
protected |
Helper methods to be called before and after calling gl[Compressed][Copy]Tex[Sub]Image2D to handle generating mipmaps.
|
virtual |
If State is non-zero, this function releases OpenGL objects for the specified graphics context.
Otherwise, releases OpenGL objects for all graphics contexts.
Reimplemented from osg::StateAttribute.
|
virtual |
Resize any per context GLObject buffers to specified size.
Reimplemented from osg::StateAttribute.
Reimplemented in osgText::GlyphTexture.
GLenum osg::Texture::selectSizedInternalFormat | ( | const osg::Image * | image = 0 | ) | const |
|
inline |
Sets the border color.
Only used when wrap mode is CLAMP_TO_BORDER. The border color will be casted to the appropriate type to match the internal pixel format of the texture.
References _borderColor, and dirtyTextureParameters().
|
inline |
Sets the border width.
References _borderWidth, and dirtyTextureParameters().
|
inline |
Sets whether to use client storage for the texture, if supported by the graphics system.
Note: If enabled, and the graphics system supports it, the osg::Image(s) associated with this texture cannot be deleted, so the UnRefImageDataAfterApply flag would be ignored.
References _clientStorageHint.
void osg::Texture::setFilter | ( | FilterParameter | which, |
FilterMode | filter ) |
Sets the texture filter mode.
Referenced by osg::TextureRectangle::TextureRectangle().
|
inline |
References osg::ref_ptr< T >::get(), and setImage().
Referenced by setImage().
|
pure virtual |
Sets the texture image for the specified face.
Implemented in osg::Texture1D, osg::Texture2D, osg::Texture2DArray, osg::Texture2DMultisample, osg::Texture3D, osg::TextureBuffer, osg::TextureCubeMap, and osg::TextureRectangle.
|
inline |
Sets the internal texture format.
Implicitly sets the internalFormatMode to USE_USER_DEFINED_FORMAT. The corresponding internal format type will be computed.
References _internalFormat, _internalFormatMode, computeInternalFormatType(), and USE_USER_DEFINED_FORMAT.
|
inline |
Sets the internal texture format mode.
Note: If the texture format is USE_IMAGE_DATA_FORMAT, USE_ARB_COMPRESSION, or USE_S3TC_COMPRESSION, the internal format mode is set automatically and will overwrite the previous _internalFormat.
References _internalFormatMode.
void osg::Texture::setLODBias | ( | float | lodbias | ) |
Gets the level of detail bias value.
void osg::Texture::setMaxAnisotropy | ( | float | anis | ) |
Sets the maximum anisotropy value, default value is 1.0 for no anisotropic filtering.
If hardware does not support anisotropic filtering, use normal filtering (equivalent to a max anisotropy value of 1.0. Valid range is 1.0f upwards. The maximum value depends on the graphics system.
void osg::Texture::setMaxLOD | ( | float | maxlod | ) |
Sets the maximum level of detail value.
void osg::Texture::setMinLOD | ( | float | minlod | ) |
Sets the minimum level of detail value.
|
inline |
References osg::ref_ptr< T >::get(), and setReadPBuffer().
Referenced by setReadPBuffer().
|
inline |
Set the PBuffer graphics context to read from when using PBuffers for RenderToTexture.
References _readPBuffer.
|
inline |
Sets whether to force the texture to resize images that have dimensions that are not a power of two.
If enabled, NPOT images will be resized, whether or not NPOT textures are supported by the hardware. If disabled, NPOT images will not be resized if supported by hardware.
References _resizeNonPowerOfTwoHint.
|
inline |
Sets the TEXTURE_COMPARE_FAIL_VALUE_ARB texture parameter.
See http://oss.sgi.com/projects/ogl-sample/registry/ARB/shadow_ambient.txt.
References _shadow_ambient.
|
inline |
Sets shadow texture comparison function.
References _shadow_compare_func.
|
inline |
Sets GL_TEXTURE_COMPARE_MODE_ARB to GL_COMPARE_R_TO_TEXTURE_ARB See http://oss.sgi.com/projects/ogl-sample/registry/ARB/shadow.txt.
References _use_shadow_comparison.
|
inline |
Sets shadow texture mode after comparison.
References _shadow_texture_mode.
|
inline |
Sets the external source image format, used as a fallback when no osg::Image is attached to provide the source image format.
References _sourceFormat.
|
inline |
Sets the external source data type, used as a fallback when no osg::Image is attached to provide the source image format.
References _sourceType.
|
inline |
Configure the source of texture swizzling for all channels.
References _swizzle, and dirtyTextureParameters().
|
inline |
References _textureObjectBuffer.
|
inline |
Sets whether or not the apply() function will unreference the image data.
If enabled, and the image data is only referenced by this Texture, apply() will delete the image data.
References _unrefImageDataAfterApply.
|
inline |
Sets the hardware mipmap generation hint.
If enabled, it will only be used if supported in the graphics system.
References _useHardwareMipMapGeneration.
Referenced by osg::Texture2D::Texture2D().
void osg::Texture::setWrap | ( | WrapParameter | which, |
WrapMode | wrap ) |
Sets the texture wrap mode.
Referenced by osg::TextureRectangle::TextureRectangle().
|
protected |
Referenced by getBorderColor(), and setBorderColor().
|
protected |
Referenced by getBorderWidth(), and setBorderWidth().
|
protected |
Referenced by getClientStorageHint(), and setClientStorageHint().
|
mutableprotected |
Referenced by getInternalFormat(), and setInternalFormat().
|
protected |
Referenced by getInternalFormatMode(), setInternalFormat(), and setInternalFormatMode().
|
mutableprotected |
Referenced by getInternalFormatType().
|
protected |
Referenced by getLODBias().
|
protected |
|
protected |
Referenced by getMaxAnisotropy().
|
protected |
Referenced by getMaxLOD().
|
protected |
|
protected |
Referenced by getMinLOD().
|
mutableprotected |
Referenced by getReadPBuffer(), getReadPBuffer(), and setReadPBuffer().
|
protected |
Referenced by getResizeNonPowerOfTwoHint(), and setResizeNonPowerOfTwoHint().
|
protected |
Referenced by getShadowAmbient(), and setShadowAmbient().
|
protected |
Referenced by getShadowCompareFunc(), and setShadowCompareFunc().
|
protected |
Referenced by getShadowTextureMode(), and setShadowTextureMode().
|
mutableprotected |
Referenced by getSourceFormat(), and setSourceFormat().
|
mutableprotected |
Referenced by getSourceType(), and setSourceType().
|
protected |
Referenced by getSwizzle(), and setSwizzle().
|
mutableprotected |
|
mutableprotected |
Referenced by getTextureParameterDirty().
|
mutableprotected |
Referenced by getTextureObject(), and setTextureObject().
|
protected |
Referenced by getUnRefImageDataAfterApply(), isSafeToUnrefImageData(), and setUnRefImageDataAfterApply().
|
protected |
Referenced by getShadowComparison(), and setShadowComparison().
|
protected |
Referenced by getUseHardwareMipMapGeneration(), and setUseHardwareMipMapGeneration().
|
protected |
|
protected |
|
protected |
![]() | Generated at Sun Jul 27 2025 00:00:00 for the OpenSceneGraph by doxygen 1.14.0. |