TextureContext

class TextureContext

Bases: BufferContext, AdaptiveLruPage

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()), the GSG will create some internal handle for the texture and store it here. The texture stores all of these handles internally.

Inheritance diagram

static TypeHandle get_class_type(void)

UpdateSeq get_image_modified(void) const

Returns a sequence number which is guaranteed to change at least every time the texture image data (including mipmap levels) are modified.

SparseArray get_image_modified_pages(int n = 0) const

Returns a SparseArray indicating which pages of the texture have been modified since the last call to mark_loaded().

virtual uint64_t get_native_buffer_id(void) const

Similar to get_native_id, but some implementations use a separate identifier for the buffer object associated with buffer textures. Returns 0 if the underlying implementation does not support this, or if this is not a buffer texture.

virtual uint64_t get_native_id(void) const

Returns an implementation-defined handle or pointer that can be used to interface directly with the underlying API. Returns 0 if the underlying implementation does not support this.

UpdateSeq get_properties_modified(void) const

Returns a sequence number which is guaranteed to change at least every time the texture properties (unrelated to the image) are modified.

Texture *get_texture(void) const

Returns the pointer to the associated Texture object.

int get_view(void) const

Returns the specific view of a multiview texture this context represents. In the usual case, with a non-multiview texture, this will be 0.

bool was_image_modified(void) const

Returns true if the texture image has been modified since the last time mark_loaded() was called.

bool was_image_page_modified(int z, int n) const

Returns true if the given page of the texture image has been modified since the last time mark_loaded() was called.

bool was_modified(void) const

Returns true if the texture properties or image have been modified since the last time mark_loaded() was called.

bool was_properties_modified(void) const

Returns true if the texture properties (unrelated to the image) have been modified since the last time mark_loaded() was called.