Class Texture

constructor

• new Texture(): Texture

  Returns Texture

destroy

• destroy(ctx: Context): void

  Releases texture resources from GPU memory and unregisters entries from the VRAM tracker.

  Parameters

  • ctx: Context

    Active context.

  Returns void

onUpdate

• onUpdate(cb: () => void): () => void

  Registers a callback routine invoked when the asynchronous texture load successfully completes. Returns an unsubscribe function to safely detach the callback and prevent memory leaks.

  Parameters

  • cb: () => void

    The update callback function.

  Returns () => void

  A function to unsubscribe this callback.

StaticgetDummyBlack

• getDummyBlack(ctx: Context): Texture

  Resolves a global, cached 1x1 solid black pixel placeholder texture. Reuses the same instance across the entire context lifetime to optimize memory.

  Parameters

  • ctx: Context

    Active context.

  Returns Texture

  The black placeholder Texture.

StaticgetDummyNormal

• getDummyNormal(ctx: Context): Texture

  Resolves a global, cached 1x1 neutral normal map texture. Returns a straight-up vector (128, 128, 255, 255) representing (0, 0, 1) tangent coordinates. Reuses the same instance across the entire context lifetime.

  Parameters

  • ctx: Context

    Active context.

  Returns Texture

  The flat normal map fallback Texture.

StaticgetDummyWhite

• getDummyWhite(ctx: Context): Texture

  Resolves a global, cached 1x1 solid white pixel placeholder texture. Reuses the same instance across the entire context lifetime to optimize memory.

  Parameters

  • ctx: Context

    Active context.

  Returns Texture

  The white placeholder Texture.

StaticloadBackground

• loadBackground(
      ctx: Context,
      url: string,
      options?: { format?: GPUTextureFormat },
  ): Texture

  Spawns a Texture loading sequence in the background, immediately returning a container holding a 1x1 solid white pixel. Replaces the placeholder texture in-place once loading finishes, triggering all update listeners. Revokes Blob URLs automatically to prevent memory leaks.

  Parameters

  • ctx: Context

    Active context.

  • url: string

    Source address of the texture image.

  • options: { format?: GPUTextureFormat } = {}

    Custom format configurations.

  Returns Texture

  The newly allocated Texture instance.

gpuTexture

isLoaded

url