texture.create2D#ensureUploaded¶
Summary¶
texture.create2D#ensureUploaded starts the lazy asynchronous decode and GPU upload once. The call returns immediately; materials use fallback resources until upload completes.
Syntax¶
Texture2D.ensureUploaded(device: GPUDevice, queue: GPUQueue, colorSpace: TextureColorSpace = "linear"): void
texture.ensureUploaded(device, queue, colorSpace);
Parameters¶
| Name | Type | Required | Description |
|---|---|---|---|
device |
GPUDevice |
Yes | Device that owns the uploaded texture. The first call fixes the device for this upload. |
queue |
GPUQueue |
Yes | Queue used to copy decoded pixels and generate mipmaps. |
colorSpace |
TextureColorSpace |
No | Upload interpretation; default "linear". The first upload request fixes the texture's mipmap color space. |
Returns¶
void - No return value. A terminal asynchronous failure is exposed through uploadError and thrown by later upload/view requests.