Number of references to this object. If at least a single reference was counted, this object can neither be initialized (and thus created) nor uninitialized (and thus deleted). The reference count is controlled via ref() and unref() functions.
Asserts the objects initialization status to be true. Note that the implementation is cached and forwarded to either an empty function when initialized and to an acutal assert(false) otherwise.
Asserts the objects initialization status to be false. Note that the implementation is cached and forwarded to either an empty function when uninitialized and to an acutal assert(false) otherwise.
Default texture, e.g., used for unbind.
Returns the number of bytes this object approximately allocates on the GPU. The size will be zero when no image data was passed to the texture object.
Read-only access to the objects context, used to get context information and WebGL API access.
The depth of the texture object in px.
Cached format of the data provided to the texture object for efficient resize. This is set on initialization and might change on data transfers.
The height of the texture object in px.
Every GPU asset that allocates memory should provide a human readable identifier for GPU allocation tracking and debugging purposes. Please note that the identifier might changed on initialization due to the generation and assignment of a unique identifier.
Property getter for readonly access to the initialization status of an initializable instance.
Cached internal format of the texture for efficient resize. This can only be changed by re-initialization.
Read-only access to the WebGL object handle.
Convenience getter for the 3-tuple containing width and height.
Cached type of the data provided to the texture used for efficient resize. This is set on initialization and might change on data transfers.
Cached object status used to derive validity when initialized.
The width of the texture object in px.
Bind the texture object to a texture unit.
Create a texture object on the GPU.
Initial width of the texture in px.
Initial height of the texture in px.
Initial depth of the texture in px.
Internal format of the texture object.
Format of the texture data even though no data is passed.
Data type of the texel data.
Pass image data to the texture object.
Texel data that will be copied into the objects data store.
Allows to skip binding the texture (e.g., when binding is handled outside).
Allows to skip unbinding the texture (e.g., when binding is handled outside).
Delete the texture object on the GPU. This should have the reverse effect of create.
Sets the texture object's magnification and minification filter.
Value for the TEXTURE_MAG_FILTER parameter.
Value for the TEXTURE_MIN_FILTER parameter.
Allows to skip binding the texture (e.g., when binding is handled outside).
Allows to skip unbinding the texture (e.g., when binding is handled outside).
Asynchronous load of an image comprising a column/row of slices via URL or data URI. Please note that due to the lack of sub-data access on images, the slices are loaded using a auxiliary canvas and context (temporarily). The sub images (slices) are drawn using the canvas and the image data is then captured.
Uniform resource locator string referencing image slices that should be loaded (data URI supported).
Number of slices (resulting in the 3D texture's depth) vertically aligned within the image.
Enable cross origin data loading.
Optional: Whether or not to use horizontal (rows) instead of vertical (columns) slice alignment.
Asynchronous load of multiple images, each containing a column/row of slices, via URL or data URI. This can be used, e. g., for a dynamically sized array of 3D textures. Note that all the images must have the exact same dimensions. Each image is loaded and drawn into a large, multi-row/-column image. This image is then used as a base64 encoded PNG for subsequent usage in the regular @see {load} function.
Uniform resource locator strings referencing a set of equally-sized images that should be loaded (data URI supported).
Number of slices (resulting in the 3D texture's depth) vertically aligned within each image.
Enable cross origin data loading.
Optional: Whether or not to use horizontal (rows) instead of vertical (columns) slice alignment.
Increment the reference count of this object.
This can be used to reformat the texture image without creating a new texture object. Please note that this resets the texture's image data to undefined. @see data for setting new image data.
Internal format of the texture object.
Format of the texture data even though no data is passed.
Data type of the texel data.
Allows to skip binding the texture (e.g., when binding is handled outside).
Allows to skip unbinding the texture (e.g., when binding is handled outside).
This should be used to implement efficient resize the texture.
Targeted/new width of the texture in px.
Targeted/new height of the texture in px.
Targeted/new depth of the texture in px.
Allows to skip binding the texture (e.g., when binding is handled outside).
Allows to skip unbinding the texture (e.g., when binding is handled outside).
Unbind the texture object from a texture unit.
Decrement the reference count of this object.
Sets the texture object's wrapping function for s and t coordinates.
Value for the TEXTURE_WRAP_S parameter, defaulted to CLAMP_TO_EDGE.
Value for the TEXTURE_WRAP_T parameter, defaulted to CLAMP_TO_EDGE.
Value for the TEXTURE_WRAP_R parameter, defaulted to CLAMP_TO_EDGE.
Allows to skip binding the texture (e.g., when binding is handled outside).
Allows to skip unbinding the texture (e.g., when binding is handled outside).
Method decorator for asserting the initialization status of an initializable to be true.
Method decorator for asserting the initialization status of an initializable to be false.
Method decorator for discarding of Initializable inheritors. This decorator asserts the initialization
status of the instance that is to be discarded, invokes its uninitialization, and falsifies the
initialization status. In order to encourage the use of assertInitialized and assertUninitialized they are
dynamically bound to a static, always-failing assert and an empty/undefined function respectively.
Method decorator for initialization of Initializable inheritors. This decorator asserts the initialization status
of the instance that is to be initialized, invokes its initialization with arbitrary number of parameters,
and sets the initialization status to the initialization success (either false or true).
In order to encourage the use of assertInitialized and assertUninitialized they are dynamically
bound to either a static, always-failing assert or an empty/undefined function.
Method decorator for uninitialization of Initializable inheritors. This decorator asserts the initialization
status of the instance that is to be uninitialized, invokes its uninitialization, and falsifies the
initialization status. In order to encourage the use of assertInitialized and assertUninitialized they are
dynamically bound to a static, always-failing assert and an empty/undefined function respectively.
Wrapper for an WebGL 2D texture providing size accessors and requiring for bind, unbind, resize, validity, and initialization implementations. The texture object is created on initialization and deleted on uninitialization. After being initialized, the texture can be resized, reformated, and data can set directly or via load: