CmdTextureCreateFromBuffer

Creates a texture from an uploaded image buffer.

Notes:

• bufferId must refer to an upload with uploadType = "image-data".
• Supported formats: PNG, JPEG, WebP, AVIF.
• If mode is forward-atlas, creation can fail if an atlas already exists with a different configuration.

Arguments

Field	Type	Description
textureId	u32	Unique ID for the texture
label	Option	(Optional) Semantic name
bufferId	u64	ID of the uploaded buffer containing image data
srgb	Option	(Optional) Use sRGB (default: true)
mode	TextureCreateMode	(Optional) "standalone" or "forward-atlas" (default: "standalone")
atlasOptions	Option	(Optional) Options for atlas allocation

ForwardAtlasOptions

• tilePx: u32 (tile size in pixels, default: 256)
• layers: u32 (atlas layers, default: 1)

Response

Returns CmdResultTextureCreateFromBuffer:

Field	Type	Description
success	bool	Whether the texture was created
message	String	Status or error message

Runtime Behavior

• Decode is async and non-blocking.
• If decode completes before GPU readiness, decoded payload is retained and GPU upload is applied later.
• texture-dispose cancels/discards pending decode/upload state for the same textureId.