A wrapper around a WebGLTexture that handles loading the texture data
from a Texture source and uploading it to the GPU as well as freeing
the uploaded texture.
Remarks
When accessing the ctxTexture property, the texture will be loaded if
it hasn't been already. ctxTexture will always return a valid WebGLTexture
and trigger the loading/uploading of the texture's data if it hasn't been
loaded yet.
Promise that resolves to the native WebGL texture or null on failure
Remarks
When this method resolves, the returned texture will be bound to the GL context state
and fully ready for use. This ensures proper GPU resource allocation timing.
free
free(): void
Free the WebGLTexture from the GPU
Returns void
load
load(): Promise<void>
Load the texture data from the Texture source and upload it to the GPU
Returns Promise<void>
Remarks
This method is called automatically when accessing the ctxTexture property
if the texture hasn't been loaded yet. But it can also be called manually
to force the texture to be pre-loaded prior to accessing the ctxTexture
property.
A wrapper around a WebGLTexture that handles loading the texture data from a Texture source and uploading it to the GPU as well as freeing the uploaded texture.
Remarks
When accessing the ctxTexture property, the texture will be loaded if it hasn't been already. ctxTexture will always return a valid WebGLTexture and trigger the loading/uploading of the texture's data if it hasn't been loaded yet.