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

Inheritance diagram of TextureContext

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.