Class Textures

Texture manager.

Load textures from different sources and get texture handles to use when rendering.

Remarks

This service keeps hold of all sources used to create textures. This allows restoring textures and contents after a context-loss (https://developer.mozilla.org/en-US/docs/Web/API/HTMLCanvasElement/webglcontextlost_event).

Implements

RenderContextLifeCycleHandler

Index

Constructors

Properties

driverTextures textureSources

Accessors

Methods

addFromImageBitmap addFromURL deleteSource initialize uninitialize

Constructors

constructor

new Textures(driverTextures: DriverTextures): Textures
Parameters
- driverTextures: DriverTextures
  The driver texture implementation.
Returns Textures
- Defined in app/textures.ts:31

Properties

`Protected` `Readonly`driverTextures

driverTextures: DriverTextures

The driver texture implementation.

`Protected` `Readonly`textureSources

textureSources: Map<TextureHandle, ImageBitmap> = ...

Accessors

white

get white(): TextureHandle
1x1 pixel white texture. To be used as placeholder/default texture.

Returns TextureHandle
- Defined in app/textures.ts:23

Methods

addFromImageBitmap

addFromImageBitmap(
imageBitmap: ImageBitmap,
resourceOptions?: ResourceOptions,
): Promise<TextureHandle>
Create a texture directly from an ImageBitmap.
Parameters
- imageBitmap: ImageBitmap
  Image bitmap
- OptionalresourceOptions: ResourceOptions
  Options for the created resource
Returns Promise<TextureHandle>
Promise of the resulting TextureHandle
- Defined in app/textures.ts:58

addFromURL

addFromURL(
    url: RequestInfo | URL,
    resourceOptions?: ResourceOptions,
    options?: {
        fetchOptions?: RequestInit;
        imageBitmapOptions?: ImageBitmapOptions;
    },
): Promise<TextureHandle>
Fetch an ImageBitmap from the given URL and create a texture from it.
Parameters
- url: RequestInfo | URL
  URL
- OptionalresourceOptions: ResourceOptions
- Optionaloptions: { fetchOptions?: RequestInit; imageBitmapOptions?: ImageBitmapOptions }
  Options for the fetch request/created resource
Returns Promise<TextureHandle>
Promise of the resulting TextureHandle
- Defined in app/textures.ts:39

deleteSource

deleteSource(handle: TextureHandle): boolean
Delete the source for the given handle. Does not remove the texture itself.
Parameters
- handle: TextureHandle
  Handle to remove the source for
Returns boolean
true if a source was removed
- Defined in app/textures.ts:77

initialize

initialize(): Promise<void>
Initialize any rendering resources associated with this handler. E.g., compile shaders, create textures.

Returns Promise<void>
Remarks
Rendering will only continue when all handler's initialize promises have resolved.
Implementation of RenderContextLifeCycleHandler.initialize
- Defined in app/textures.ts:81

uninitialize

uninitialize(): Promise<void>
Uninitialize any rendering resources associated with this handler. E.g., delete shaders.

Returns Promise<void>
Implementation of RenderContextLifeCycleHandler.uninitialize
- Defined in app/textures.ts:91