osg::Texture Class Reference

Inheritance diagram for osg::Texture:

osg::StateAttribute osg::Object osg::Referenced osg::Texture1D osg::Texture2D osg::Texture2DArray osg::Texture3D osg::TextureCubeMap osg::TextureRectangle osgText::Font::GlyphTexture

List of all members.

Public Types

enum  WrapParameter { WRAP_S, WRAP_T, WRAP_R }
enum  WrapMode {
  CLAMP = GL_CLAMP, CLAMP_TO_EDGE = GL_CLAMP_TO_EDGE, CLAMP_TO_BORDER = GL_CLAMP_TO_BORDER_ARB, REPEAT = GL_REPEAT,
  MIRROR = GL_MIRRORED_REPEAT_IBM
}
enum  FilterParameter { MIN_FILTER, MAG_FILTER }
enum  FilterMode {
  LINEAR = GL_LINEAR, LINEAR_MIPMAP_LINEAR = GL_LINEAR_MIPMAP_LINEAR, LINEAR_MIPMAP_NEAREST = GL_LINEAR_MIPMAP_NEAREST, NEAREST = GL_NEAREST,
  NEAREST_MIPMAP_LINEAR = GL_NEAREST_MIPMAP_LINEAR, NEAREST_MIPMAP_NEAREST = GL_NEAREST_MIPMAP_NEAREST
}
enum  InternalFormatMode {
  USE_IMAGE_DATA_FORMAT, USE_USER_DEFINED_FORMAT, USE_ARB_COMPRESSION, USE_S3TC_DXT1_COMPRESSION,
  USE_S3TC_DXT3_COMPRESSION, USE_S3TC_DXT5_COMPRESSION
}
enum  InternalFormatType { NORMALIZED = 0x0, FLOAT = 0x1, SIGNED_INTEGER = 0x2, UNSIGNED_INTEGER = 0x4 }
enum  ShadowCompareFunc {
  NEVER = GL_NEVER, LESS = GL_LESS, EQUAL = GL_EQUAL, LEQUAL = GL_LEQUAL,
  GREATER = GL_GREATER, NOTEQUAL = GL_NOTEQUAL, GEQUAL = GL_GEQUAL, ALWAYS = GL_ALWAYS
}
enum  ShadowTextureMode { LUMINANCE = GL_LUMINANCE, INTENSITY = GL_INTENSITY, ALPHA = GL_ALPHA }
enum  GenerateMipmapMode { GENERATE_MIPMAP_NONE, GENERATE_MIPMAP, GENERATE_MIPMAP_TEX_PARAMETER }
typedef std::list< ref_ptr
< TextureObject > > 
TextureObjectList

Public Member Functions

 Texture ()
 Texture (const Texture &text, const CopyOp &copyop=CopyOp::SHALLOW_COPY)
virtual osg::ObjectcloneType () const =0
virtual osg::Objectclone (const CopyOp &copyop) const =0
virtual bool isSameKindAs (const osg::Object *obj) const
virtual const char * libraryName () const
virtual const char * className () const
virtual TextureasTexture ()
virtual const TextureasTexture () const
virtual Type getType () const
virtual bool isTextureAttribute () const
virtual GLenum getTextureTarget () const =0
virtual bool getModeUsage (StateAttribute::ModeUsage &usage) const
virtual int getTextureWidth () const
virtual int getTextureHeight () const
virtual int getTextureDepth () const
void setWrap (WrapParameter which, WrapMode wrap)
WrapMode getWrap (WrapParameter which) const
void setBorderColor (const Vec4d &color)
const Vec4dgetBorderColor () const
void setBorderWidth (GLint width)
GLint getBorderWidth () const
void setFilter (FilterParameter which, FilterMode filter)
FilterMode getFilter (FilterParameter which) const
void setMaxAnisotropy (float anis)
float getMaxAnisotropy () const
void setUseHardwareMipMapGeneration (bool useHardwareMipMapGeneration)
bool getUseHardwareMipMapGeneration () const
void setUnRefImageDataAfterApply (bool flag)
bool getUnRefImageDataAfterApply () const
void setClientStorageHint (bool flag)
bool getClientStorageHint () const
void setResizeNonPowerOfTwoHint (bool flag)
bool getResizeNonPowerOfTwoHint () const
void setInternalFormatMode (InternalFormatMode mode)
InternalFormatMode getInternalFormatMode () const
void setInternalFormat (GLint internalFormat)
GLint getInternalFormat () const
bool isCompressedInternalFormat () const
void setSourceFormat (GLenum sourceFormat)
GLenum getSourceFormat () const
void setSourceType (GLenum sourceType)
GLenum getSourceType () const
InternalFormatType getInternalFormatType () const
TextureObjectgetTextureObject (unsigned int contextID) const
void setTextureObject (unsigned int contextID, TextureObject *to)
void dirtyTextureObject ()
bool areAllTextureObjectsLoaded () const
unsigned int & getTextureParameterDirty (unsigned int contextID) const
void dirtyTextureParameters ()
void allocateMipmapLevels ()
void setShadowComparison (bool flag)
bool getShadowComparison () const
void setShadowCompareFunc (ShadowCompareFunc func)
ShadowCompareFunc getShadowCompareFunc () const
void setShadowTextureMode (ShadowTextureMode mode)
ShadowTextureMode getShadowTextureMode () const
void setShadowAmbient (float shadow_ambient)
float getShadowAmbient () const
virtual void setImage (unsigned int face, Image *image)=0
virtual ImagegetImage (unsigned int face)=0
virtual const ImagegetImage (unsigned int face) const =0
virtual unsigned int getNumImages () const =0
void setReadPBuffer (GraphicsContext *context)
GraphicsContextgetReadPBuffer ()
const GraphicsContextgetReadPBuffer () const
virtual void apply (State &state) const =0
virtual void compileGLObjects (State &state) const
virtual void resizeGLObjectBuffers (unsigned int maxSize)
virtual void releaseGLObjects (State *state=0) const
void applyTexImage2D_load (State &state, GLenum target, const Image *image, GLsizei width, GLsizei height, GLsizei numMipmapLevels) const
void applyTexImage2D_subload (State &state, GLenum target, const Image *image, GLsizei width, GLsizei height, GLint inInternalFormat, GLsizei numMipmapLevels) const

Static Public Member Functions

static ExtensionsgetExtensions (unsigned int contextID, bool createIfNotInitalized)
static void setExtensions (unsigned int contextID, Extensions *extensions)
static bool isCompressedInternalFormat (GLint internalFormat)
static void getCompressedSize (GLenum internalFormat, GLint width, GLint height, GLint depth, GLint &blockSize, GLint &size)
static osg::ref_ptr
< Texture::TextureObjectManager > & 
getTextureObjectManager (unsigned int contextID)
static TextureObjectgenerateTextureObject (const Texture *texture, unsigned int contextID, GLenum target)
static TextureObjectgenerateTextureObject (const Texture *texture, unsigned int contextID, GLenum target, GLint numMipmapLevels, GLenum internalFormat, GLsizei width, GLsizei height, GLsizei depth, GLint border)
static void setMinimumNumberOfTextureObjectsToRetainInCache (unsigned int minimum)
static unsigned int getMinimumNumberOfTextureObjectsToRetainInCache ()
static void deleteAllTextureObjects (unsigned int contextID)
static void discardAllTextureObjects (unsigned int contextID)
static void flushAllDeletedTextureObjects (unsigned int contextID)
static void discardAllDeletedTextureObjects (unsigned int contextID)
static void flushDeletedTextureObjects (unsigned int contextID, double currentTime, double &availableTime)
static void releaseTextureObject (unsigned int contextID, TextureObject *to)

Static Public Attributes

static unsigned int s_numberTextureReusedLastInLastFrame
static unsigned int s_numberNewTextureInLastFrame
static unsigned int s_numberDeletedTextureInLastFrame

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
void computeRequiredTextureDimensions (State &state, const osg::Image &image, GLsizei &width, GLsizei &height, GLsizei &numMipmapLevels) const
void computeInternalFormatType () const
void applyTexParameters (GLenum target, State &state) const
bool isHardwareMipmapGenerationEnabled (const State &state) const
GenerateMipmapMode mipmapBeforeTexImage (const State &state, bool hardwareMipmapOn) const
void mipmapAfterTexImage (State &state, GenerateMipmapMode beforeResult) const
void generateMipmap (State &state) const
virtual void allocateMipmap (State &state) const =0
int compareTexture (const Texture &rhs) const
int compareTextureObjects (const Texture &rhs) const

Protected Attributes

TexParameterDirtyList _texParametersDirtyList
TexParameterDirtyList _texMipmapGenerationDirtyList
WrapMode _wrap_s
WrapMode _wrap_t
WrapMode _wrap_r
FilterMode _min_filter
FilterMode _mag_filter
float _maxAnisotropy
bool _useHardwareMipMapGeneration
bool _unrefImageDataAfterApply
bool _clientStorageHint
bool _resizeNonPowerOfTwoHint
Vec4d _borderColor
GLint _borderWidth
InternalFormatMode _internalFormatMode
InternalFormatType _internalFormatType
GLint _internalFormat
GLenum _sourceFormat
GLenum _sourceType
bool _use_shadow_comparison
ShadowCompareFunc _shadow_compare_func
ShadowTextureMode _shadow_texture_mode
float _shadow_ambient
TextureObjectBuffer _textureObjectBuffer
ref_ptr< GraphicsContext_readPBuffer

Classes

class  Extensions
class  TextureObject
class  TextureObjectManager
class  TextureObjectSet
struct  TextureProfile


Detailed Description

Texture pure virtual base class that encapsulates OpenGl texture functionality common to the various types of OSG textures.

Member Typedef Documentation

typedef buffered_value<unsigned int> osg::Texture::TexParameterDirtyList [protected]


Member Enumeration Documentation

Enumerator:
WRAP_S 
WRAP_T 
WRAP_R 

Enumerator:
CLAMP 
CLAMP_TO_EDGE 
CLAMP_TO_BORDER 
REPEAT 
MIRROR 

Enumerator:
MIN_FILTER 
MAG_FILTER 

Enumerator:
LINEAR 
LINEAR_MIPMAP_LINEAR 
LINEAR_MIPMAP_NEAREST 
NEAREST 
NEAREST_MIPMAP_LINEAR 
NEAREST_MIPMAP_NEAREST 

Enumerator:
USE_IMAGE_DATA_FORMAT 
USE_USER_DEFINED_FORMAT 
USE_ARB_COMPRESSION 
USE_S3TC_DXT1_COMPRESSION 
USE_S3TC_DXT3_COMPRESSION 
USE_S3TC_DXT5_COMPRESSION 

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).

Enumerator:
NEVER 
LESS 
EQUAL 
LEQUAL 
GREATER 
NOTEQUAL 
GEQUAL 
ALWAYS 

Enumerator:
LUMINANCE 
INTENSITY 
ALPHA 

Returned by mipmapBeforeTexImage() to indicate what mipmapAfterTexImage() should do

Enumerator:
GENERATE_MIPMAP_NONE 
GENERATE_MIPMAP 
GENERATE_MIPMAP_TEX_PARAMETER 


Constructor & Destructor Documentation

osg::Texture::Texture (  ) 

osg::Texture::Texture ( const Texture text,
const CopyOp copyop = CopyOp::SHALLOW_COPY 
)

Copy constructor using CopyOp to manage deep vs shallow copy.

virtual osg::Texture::~Texture (  )  [protected, virtual]


Member Function Documentation

virtual osg::Object* osg::Texture::cloneType (  )  const [pure virtual]

Clone the type of an attribute, with Object* return type. Must be defined by derived classes.

Implements osg::StateAttribute.

virtual osg::Object* osg::Texture::clone ( const CopyOp  )  const [pure virtual]

Clone an attribute, with Object* return type. Must be defined by derived classes.

Implements osg::StateAttribute.

virtual bool osg::Texture::isSameKindAs ( const osg::Object obj  )  const [inline, virtual]

Return true if this and obj are of the same kind of object.

Reimplemented from osg::StateAttribute.

References NULL.

virtual const char* osg::Texture::libraryName (  )  const [inline, virtual]

Return the name of the attribute's library.

Reimplemented from osg::StateAttribute.

virtual const char* osg::Texture::className (  )  const [inline, virtual]

Return the name of the attribute's class type.

Reimplemented from osg::StateAttribute.

Reimplemented in osgText::Font::GlyphTexture.

virtual Texture* osg::Texture::asTexture (  )  [inline, virtual]

Fast alternative to dynamic_cast<> for determining if state attribute is a Texture.

Reimplemented from osg::StateAttribute.

virtual const Texture* osg::Texture::asTexture (  )  const [inline, virtual]

Fast alternative to dynamic_cast<> for determining if state attribute is a Texture.

Reimplemented from osg::StateAttribute.

virtual Type osg::Texture::getType (  )  const [inline, virtual]

Return the Type identifier of the attribute's class type.

Implements osg::StateAttribute.

virtual bool osg::Texture::isTextureAttribute (  )  const [inline, virtual]

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.

virtual GLenum osg::Texture::getTextureTarget (  )  const [pure virtual]

virtual bool osg::Texture::getModeUsage ( StateAttribute::ModeUsage  )  const [inline, virtual]

Return the modes associated with this StateAttribute.

Reimplemented from osg::StateAttribute.

References osg::StateAttribute::ModeUsage::usesTextureMode().

virtual int osg::Texture::getTextureWidth (  )  const [inline, virtual]

virtual int osg::Texture::getTextureHeight (  )  const [inline, virtual]

virtual int osg::Texture::getTextureDepth (  )  const [inline, virtual]

void osg::Texture::setWrap ( WrapParameter  which,
WrapMode  wrap 
)

Sets the texture wrap mode.

WrapMode osg::Texture::getWrap ( WrapParameter  which  )  const

Gets the texture wrap mode.

void osg::Texture::setBorderColor ( const Vec4d color  )  [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.

const Vec4d& osg::Texture::getBorderColor (  )  const [inline]

Gets the border color.

void osg::Texture::setBorderWidth ( GLint  width  )  [inline]

Sets the border width.

GLint osg::Texture::getBorderWidth (  )  const [inline]

void osg::Texture::setFilter ( FilterParameter  which,
FilterMode  filter 
)

Sets the texture filter mode.

FilterMode osg::Texture::getFilter ( FilterParameter  which  )  const

Gets the texture filter mode.

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.

float osg::Texture::getMaxAnisotropy (  )  const [inline]

Gets the maximum anisotropy value.

void osg::Texture::setUseHardwareMipMapGeneration ( bool  useHardwareMipMapGeneration  )  [inline]

Sets the hardware mipmap generation hint. If enabled, it will only be used if supported in the graphics system.

bool osg::Texture::getUseHardwareMipMapGeneration (  )  const [inline]

Gets the hardware mipmap generation hint.

void osg::Texture::setUnRefImageDataAfterApply ( bool  flag  )  [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.

bool osg::Texture::getUnRefImageDataAfterApply (  )  const [inline]

Gets whether or not apply() unreferences image data.

void osg::Texture::setClientStorageHint ( bool  flag  )  [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.

bool osg::Texture::getClientStorageHint (  )  const [inline]

Gets whether to use client storage for the texture.

void osg::Texture::setResizeNonPowerOfTwoHint ( bool  flag  )  [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.

bool osg::Texture::getResizeNonPowerOfTwoHint (  )  const [inline]

Gets whether texture will force non power to two images to be resized.

void osg::Texture::setInternalFormatMode ( InternalFormatMode  mode  )  [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.

InternalFormatMode osg::Texture::getInternalFormatMode (  )  const [inline]

Gets the internal texture format mode.

void osg::Texture::setInternalFormat ( GLint  internalFormat  )  [inline]

Sets the internal texture format. Implicitly sets the internalFormatMode to USE_USER_DEFINED_FORMAT. The corresponding internal format type will be computed.

GLint osg::Texture::getInternalFormat (  )  const [inline]

Gets the internal texture format.

bool osg::Texture::isCompressedInternalFormat (  )  const

Return true if the internal format is one of the compressed formats.

void osg::Texture::setSourceFormat ( GLenum  sourceFormat  )  [inline]

Sets the external source image format, used as a fallback when no osg::Image is attached to provide the source image format.

GLenum osg::Texture::getSourceFormat (  )  const [inline]

Gets the external source image format.

void osg::Texture::setSourceType ( GLenum  sourceType  )  [inline]

Sets the external source data type, used as a fallback when no osg::Image is attached to provide the source image format.

GLenum osg::Texture::getSourceType (  )  const [inline]

Gets the external source data type.

InternalFormatType osg::Texture::getInternalFormatType (  )  const [inline]

Get the internal texture format type.

TextureObject* osg::Texture::getTextureObject ( unsigned int  contextID  )  const [inline]

Returns a pointer to the TextureBbject for the current context.

Referenced by osgDB::DatabasePager::isCompiled().

void osg::Texture::setTextureObject ( unsigned int  contextID,
TextureObject to 
) [inline]

void osg::Texture::dirtyTextureObject (  ) 

Forces a recompile on next apply() of associated OpenGL texture objects.

bool osg::Texture::areAllTextureObjectsLoaded (  )  const

Returns true if the texture objects for all the required graphics contexts are loaded.

unsigned int& osg::Texture::getTextureParameterDirty ( unsigned int  contextID  )  const [inline]

Gets the dirty flag for the current contextID.

void osg::Texture::dirtyTextureParameters (  ) 

Force a reset on next apply() of associated OpenGL texture parameters.

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.

void osg::Texture::setShadowComparison ( bool  flag  )  [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.

bool osg::Texture::getShadowComparison (  )  const [inline]

void osg::Texture::setShadowCompareFunc ( ShadowCompareFunc  func  )  [inline]

Sets shadow texture comparison function.

ShadowCompareFunc osg::Texture::getShadowCompareFunc (  )  const [inline]

void osg::Texture::setShadowTextureMode ( ShadowTextureMode  mode  )  [inline]

Sets shadow texture mode after comparison.

ShadowTextureMode osg::Texture::getShadowTextureMode (  )  const [inline]

void osg::Texture::setShadowAmbient ( float  shadow_ambient  )  [inline]

Sets the TEXTURE_COMPARE_FAIL_VALUE_ARB texture parameter. See http://oss.sgi.com/projects/ogl-sample/registry/ARB/shadow_ambient.txt.

float osg::Texture::getShadowAmbient (  )  const [inline]

virtual void osg::Texture::setImage ( unsigned int  face,
Image image 
) [pure virtual]

Sets the texture image for the specified face.

Implemented in osg::Texture1D, osg::Texture2D, osg::Texture2DArray, osg::Texture3D, osg::TextureCubeMap, and osg::TextureRectangle.

virtual Image* osg::Texture::getImage ( unsigned int  face  )  [pure virtual]

Gets the texture image for the specified face.

Implemented in osg::Texture1D, osg::Texture2D, osg::Texture2DArray, osg::Texture3D, osg::TextureCubeMap, and osg::TextureRectangle.

virtual const Image* osg::Texture::getImage ( unsigned int  face  )  const [pure virtual]

Gets the const texture image for specified face.

Implemented in osg::Texture1D, osg::Texture2D, osg::Texture2DArray, osg::Texture3D, osg::TextureCubeMap, and osg::TextureRectangle.

virtual unsigned int osg::Texture::getNumImages (  )  const [pure virtual]

Gets the number of images that can be assigned to this Texture.

Implemented in osg::Texture1D, osg::Texture2D, osg::Texture2DArray, osg::Texture3D, osg::TextureCubeMap, and osg::TextureRectangle.

void osg::Texture::setReadPBuffer ( GraphicsContext context  )  [inline]

Set the PBuffer graphics context to read from when using PBuffers for RenderToTexture.

GraphicsContext* osg::Texture::getReadPBuffer (  )  [inline]

Get the PBuffer graphics context to read from when using PBuffers for RenderToTexture.

const GraphicsContext* osg::Texture::getReadPBuffer (  )  const [inline]

Get the const PBuffer graphics context to read from when using PBuffers for RenderToTexture.

virtual void osg::Texture::apply ( State state  )  const [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::Texture3D, osg::TextureCubeMap, osg::TextureRectangle, and osgText::Font::GlyphTexture.

virtual void osg::Texture::compileGLObjects ( State state  )  const [virtual]

Calls apply(state) to compile the texture.

Reimplemented from osg::StateAttribute.

virtual void osg::Texture::resizeGLObjectBuffers ( unsigned int  maxSize  )  [virtual]

Resize any per context GLObject buffers to specified size.

Reimplemented from osg::StateAttribute.

Reimplemented in osgText::Font::GlyphTexture.

virtual void osg::Texture::releaseGLObjects ( State state = 0  )  const [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.

static Extensions* osg::Texture::getExtensions ( unsigned int  contextID,
bool  createIfNotInitalized 
) [static]

Gets the extension for the specified context. Creates the Extensions object for that context if it doesn't exist. Returns NULL if the Extensions object for the context doesn't exist and the createIfNotInitalized flag is false.

Reimplemented in osg::Texture2DArray, osg::Texture3D, and osg::TextureCubeMap.

static void osg::Texture::setExtensions ( unsigned int  contextID,
Extensions extensions 
) [static]

Overrides Extensions objects across graphics contexts. Typically used to ensure the same lowest common denominator of extensions on systems with different graphics pipes.

Reimplemented in osg::Texture2DArray, osg::Texture3D, and osg::TextureCubeMap.

static bool osg::Texture::isCompressedInternalFormat ( GLint  internalFormat  )  [static]

Determine whether the given internalFormat is a compressed image format.

static void osg::Texture::getCompressedSize ( GLenum  internalFormat,
GLint  width,
GLint  height,
GLint  depth,
GLint &  blockSize,
GLint &  size 
) [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.

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.

virtual void osg::Texture::computeInternalFormat (  )  const [protected, pure virtual]

void osg::Texture::computeInternalFormatWithImage ( const osg::Image image  )  const [protected]

void osg::Texture::computeRequiredTextureDimensions ( State state,
const osg::Image image,
GLsizei &  width,
GLsizei &  height,
GLsizei &  numMipmapLevels 
) const [protected]

void osg::Texture::computeInternalFormatType (  )  const [protected]

void osg::Texture::applyTexParameters ( GLenum  target,
State state 
) const [protected]

Helper method. Sets texture parameters.

bool osg::Texture::isHardwareMipmapGenerationEnabled ( const State state  )  const [protected]

Returns true if _useHardwareMipMapGeneration is true and either glGenerateMipmapEXT() or GL_GENERATE_MIPMAP_SGIS are supported.

GenerateMipmapMode osg::Texture::mipmapBeforeTexImage ( const State state,
bool  hardwareMipmapOn 
) const [protected]

Helper methods to be called before and after calling gl[Compressed][Copy]Tex[Sub]Image2D to handle generating mipmaps.

void osg::Texture::mipmapAfterTexImage ( State state,
GenerateMipmapMode  beforeResult 
) const [protected]

void osg::Texture::generateMipmap ( State state  )  const [protected]

Helper method to generate mipmap levels by calling of glGenerateMipmapEXT. If it is not supported, then call the virtual allocateMipmap() method

virtual void osg::Texture::allocateMipmap ( State state  )  const [protected, pure virtual]

Allocate mipmap levels of the texture by subsequent calling of glTexImage* function.

Implemented in osg::Texture1D, osg::Texture2D, osg::Texture2DArray, osg::Texture3D, osg::TextureCubeMap, and osg::TextureRectangle.

int osg::Texture::compareTexture ( const Texture rhs  )  const [protected]

Returns -1 if *this < *rhs, 0 if *this==*rhs, 1 if *this>*rhs.

int osg::Texture::compareTextureObjects ( const Texture rhs  )  const [protected]

Returns -1 if *this < *rhs, 0 if *this==*rhs, 1 if *this>*rhs.

static osg::ref_ptr<Texture::TextureObjectManager>& osg::Texture::getTextureObjectManager ( unsigned int  contextID  )  [static]

static TextureObject* osg::Texture::generateTextureObject ( const Texture texture,
unsigned int  contextID,
GLenum  target 
) [static]

static TextureObject* osg::Texture::generateTextureObject ( const Texture texture,
unsigned int  contextID,
GLenum  target,
GLint  numMipmapLevels,
GLenum  internalFormat,
GLsizei  width,
GLsizei  height,
GLsizei  depth,
GLint  border 
) [static]

static void osg::Texture::setMinimumNumberOfTextureObjectsToRetainInCache ( unsigned int  minimum  )  [static]

Set the minimum number of texture objects to retain in the deleted display list cache.

static unsigned int osg::Texture::getMinimumNumberOfTextureObjectsToRetainInCache (  )  [static]

Get the minimum number of display lists to retain in the deleted display list cache.

static void osg::Texture::deleteAllTextureObjects ( unsigned int  contextID  )  [static]

static void osg::Texture::discardAllTextureObjects ( unsigned int  contextID  )  [static]

static void osg::Texture::flushAllDeletedTextureObjects ( unsigned int  contextID  )  [static]

static void osg::Texture::discardAllDeletedTextureObjects ( unsigned int  contextID  )  [static]

static void osg::Texture::flushDeletedTextureObjects ( unsigned int  contextID,
double  currentTime,
double &  availableTime 
) [static]

static void osg::Texture::releaseTextureObject ( unsigned int  contextID,
TextureObject to 
) [static]


Member Data Documentation

float osg::Texture::_maxAnisotropy [protected]

GLint osg::Texture::_borderWidth [protected]

GLint osg::Texture::_internalFormat [mutable, protected]

GLenum osg::Texture::_sourceFormat [mutable, protected]

GLenum osg::Texture::_sourceType [mutable, protected]

float osg::Texture::_shadow_ambient [protected]


The documentation for this class was generated from the following file:

Generated on Sat Mar 20 12:33:59 2010 for openscenegraph by  doxygen 1.5.6