---

TextureContext Class Reference

This is a special class object that holds all the information returned by a particular GSG to indicate the texture's internal context identifier. More...

#include <textureContext.h>

Inheritance diagram for TextureContext:

List of all members.

Public Member Functions
	TextureContext (Texture *tex)
virtual size_t	estimate_texture_memory ()
	Estimates the amount of texture memory that will be consumed by loading this texture.
void	mark_dirty (int flags_to_set)
	Marks the context "dirty", i.e.
void	clear_dirty_flags (int flags_to_clear=~0)
	Removes the indicated flags from the "dirty" bits.
int	get_dirty_flags () const
	Returns the current state of the dirty flags.
virtual TypeHandle	get_type () const
virtual TypeHandle	force_init_type ()
int	get_type_index () const
	Returns the internal index number associated with this object's TypeHandle, a unique number for each different type.
bool	is_of_type (TypeHandle handle) const
	Returns true if the current object is or derives from the indicated type.
bool	is_exact_type (TypeHandle handle) const
	Returns true if the current object is the indicated type exactly.
Static Public Member Functions
TypeHandle	get_class_type ()
void	init_type ()
	This function is declared non-inline to work around a compiler bug in g++ 2.96.
Public Attributes
Texture *	_texture
Private Attributes
int	_dirty_flags
Static Private Attributes
TypeHandle	_type_handle

---

Detailed Description

This is a special class object that holds all the information returned by a particular GSG to indicate the texture's internal context identifier.

Textures typically have an immediate-mode and a retained-mode operation. When using textures in retained-mode (in response to Texture::prepare_texture()), the GSG will create some internal handle for the texture and store it here. The texture stores all of these handles internally.

Definition at line 55 of file textureContext.h.

---

Constructor & Destructor Documentation

TextureContext::TextureContext (  Texture *  tex  )  [inline]

Definition at line 31 of file textureContext.I. References _dirty_flags, and INLINE.

---

Member Function Documentation

void TextureContext::clear_dirty_flags (  int  flags_to_clear = ~0  )  [inline]

Removes the indicated flags from the "dirty" bits. See mark_dirty(). The value is the union of all the bits that are to be cleared; if a bit is set in the parameter, it will be removed from the dirty set. Bits that are not set in this parameter are left unchanged. This function is intended to be called by the GSG after it has updated the texture parameters. Definition at line 103 of file textureContext.I. Referenced by DXGraphicsStateGuardian8::draw_sphere().

size_t TextureContext::estimate_texture_memory (   )  [virtual]

Estimates the amount of texture memory that will be consumed by loading this texture. This is mainly useful for debugging and reporting purposes. Returns a value in bytes. Definition at line 46 of file textureContext.cxx. References _texture, Texture::FT_linear_mipmap_linear, Texture::FT_linear_mipmap_nearest, Texture::FT_nearest_mipmap_linear, Texture::FT_nearest_mipmap_nearest, and size_t.

virtual TypeHandle TextureContext::force_init_type (  void   )  [inline, virtual]

Reimplemented from SavedContext. Reimplemented in CRTextureContext, DXTextureContext7, DXTextureContext8, and GLTextureContext. Definition at line 86 of file textureContext.h.

TypeHandle TextureContext::get_class_type (  void   )  [inline, static]

Reimplemented from SavedContext. Reimplemented in CRTextureContext, DXTextureContext7, DXTextureContext8, and GLTextureContext. Definition at line 75 of file textureContext.h. Referenced by GLTextureContext::init_type(), DXTextureContext8::init_type(), DXTextureContext7::init_type(), and CRTextureContext::init_type().

int TextureContext::get_dirty_flags (   )  const [inline]

Returns the current state of the dirty flags. If this is non-zero, it represents the union of all properties that have been changed since the last call to clear_dirty_flags(). This function is intended to be called by the GSG to determine what properties need to be updated. See Texture::DirtyFlags for a list of possible bits. Definition at line 131 of file textureContext.I. Referenced by DXGraphicsStateGuardian8::draw_sphere().

virtual TypeHandle TextureContext::get_type (  void   )  const [inline, virtual]

Reimplemented from SavedContext. Reimplemented in CRTextureContext, DXTextureContext7, DXTextureContext8, and GLTextureContext. Definition at line 83 of file textureContext.h.

int TypedObject::get_type_index (   )  const [inline, inherited]

Returns the internal index number associated with this object's TypeHandle, a unique number for each different type. This is equivalent to get_type().get_index(). Definition at line 71 of file typedObject.I. References TypeHandle::get_name(), TypedObject::get_type(), and INLINE.

void TextureContext::init_type (  void   )  [inline, static]

This function is declared non-inline to work around a compiler bug in g++ 2.96. Making it inline seems to cause problems in the optimizer. Reimplemented from SavedContext. Reimplemented in CRTextureContext, DXTextureContext7, DXTextureContext8, and GLTextureContext. Definition at line 78 of file textureContext.h.

bool TypedObject::is_exact_type (  TypeHandle  handle  )  const [inline, inherited]

Returns true if the current object is the indicated type exactly. Definition at line 101 of file typedObject.I. Referenced by PT(), and CollisionNode::xform().

bool TypedObject::is_of_type (  TypeHandle  handle  )  const [inline, inherited]

Returns true if the current object is or derives from the indicated type. Definition at line 86 of file typedObject.I. Referenced by EggMaterialCollection::collapse_equivalent_materials(), EggTextureCollection::collapse_equivalent_textures(), DeferredNodeProperty::compose(), AnimBundleMaker::create_s_channel(), CharacterMaker::create_slider(), ProjectionScreen::cull_callback(), DataNode::define_output(), EggNode::determine_draw_order(), CharacterMaker::egg_to_index(), EggGroupUniquifier::EggGroupUniquifier(), EggPoolUniquifier::EggPoolUniquifier(), EggGroupNode::find_textures(), StaticTextFont::get_glyph(), EggMaterialCollection::insert_materials(), EggTextureCollection::insert_textures(), CharacterJoint::make_copy(), PT(), EggGroupNode::r_flatten_transforms(), EggGroupNode::r_transform_vertices(), EggGroupNode::recompute_polygon_normals(), CollisionLevelState::reserve(), PandaFramework::reset_frame_rate(), PandaFramework::set_texture(), EggGroupNode::steal_children(), and DataGraphTraverser::traverse().

void TextureContext::mark_dirty (  int  flags_to_set  )  [inline]

Marks the context "dirty", i.e. its properties are different from the last time the GSG has seen them. Presumably, the GSG will respond by updating the properties and clearing the dirty bits the next time it renders the texture. The value is the union of all the bits that are to be set dirty; bits that are not set in this parameter are left unchanged. See Texture::DirtyFlags for a list of available bits. Usually this function is not called directly, but rather is called by Texture::mark_dirty() as a result of changing properties directly on the texture. Definition at line 72 of file textureContext.I. References _texture.

---

Member Data Documentation

int TextureContext::_dirty_flags [private]

Definition at line 71 of file textureContext.h. Referenced by TextureContext().

Texture* TextureContext::_texture

Definition at line 64 of file textureContext.h. Referenced by GLGraphicsStateGuardian::bind_texture(), DXGraphicsStateGuardian8::draw_sphere(), estimate_texture_memory(), DXTextureContext8::FillDDSurfTexturePixels(), mark_dirty(), and CRGraphicsStateGuardian::release_geom_node().

TypeHandle TextureContext::_type_handle [static, private]

Reimplemented from SavedContext. Reimplemented in CRTextureContext, DXTextureContext7, DXTextureContext8, and GLTextureContext. Definition at line 27 of file textureContext.cxx.

---

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

• panda/src/gobj/textureContext.h
• panda/src/gobj/textureContext.cxx
• panda/src/gobj/textureContext.I

---