Class ImageTexture

Texture consisting of an image loaded from a URL

Remarks

The ImageTexture's ImageTextureProps.src prop defines the image URL to be downloaded.

By default, the texture's alpha values will be premultiplied into its color values which is generally the desired setting before they are sent to the texture's associated Shader. However, in special cases you may want the Shader to receive straight (non-premultiplied) values. In that case you can disable the default behavior by setting the ImageTextureProps.premultiplyAlpha prop to false.

Hierarchy (View Summary)

Texture
- ImageTexture

Constructors

constructor

new ImageTexture(
txManager: CoreTextureManager,
props: Required<ImageTextureProps>,
): ImageTexture
Parameters
- txManager: CoreTextureManager
- props: Required<ImageTextureProps>
Returns ImageTexture
Overrides Texture.constructor
- Defined in src/core/textures/ImageTexture.ts:156

Properties

cacheKey

cacheKey: null | string = null

Cache key assigned by CoreTextureManager when this texture is stored in the key cache. null when the texture is not cached.

ctxTexture

ctxTexture: undefined | CoreContextTexture

maxRetryCount

maxRetryCount: number

memUsed

memUsed: number = 0

preventCleanup

preventCleanup: boolean = false

props

props: Required<ImageTextureProps>

`Readonly`renderable

renderable: boolean = false

`Readonly`renderableOwners

renderableOwners: Set<string | number> = ...

retryCount

retryCount: number = 0

Memory used by this texture in bytes

Remarks

This is tracked by the TextureMemoryManager and updated when the texture is loaded/freed. Set to 0 when texture is not loaded.

state

state: TextureState = 'initial'

textureData

textureData: null | TextureData = null

`Protected`txManager

txManager: CoreTextureManager

type

type: TextureType = TextureType.image

`Static`z$typeProps

z$__type__Props: ImageTextureProps

Accessors

dimensions

get dimensions(): null | Dimensions
Returns null | Dimensions
Inherited from Texture.dimensions
- Defined in src/core/textures/Texture.ts:236

error

get error(): null | TextureError
Returns null | TextureError
Inherited from Texture.error
- Defined in src/core/textures/Texture.ts:240

Methods

canBeCleanedUp

canBeCleanedUp(): boolean
Checks if the texture can be safely cleaned up. Considers the renderable state, startup grace period, and renderable owners.

Returns boolean
Inherited from Texture.canBeCleanedUp
- Defined in src/core/textures/Texture.ts:272

clearListeners

clearListeners(events: readonly string[]): void
Clear all listeners for the given event names by setting their array length to 0, WITHOUT deleting the keys. This keeps the eventListeners object in V8's fast-properties mode and avoids re-allocating the arrays on the next on() call. Use this for objects with a known fixed set of event names (e.g. CoreAnimation, CoreAnimationController).

Only writes arr.length = 0 when the array is non-empty -- skips the write (and the write barrier on old-gen objects) when already empty, which is the common case after unregisterAnimation() has removed all listeners.
Parameters
- events: readonly string[]
Returns void
Inherited from Texture.clearListeners
- Defined in src/common/EventEmitter.ts:137

destroy

destroy(): void
Destroy the texture.

Returns void
Remarks
This method is called when the texture is no longer needed and should be cleaned up.
Inherited from Texture.destroy
- Defined in src/core/textures/Texture.ts:404

determineImageTypeAndLoadImage

determineImageTypeAndLoadImage(): | Promise<ImageResponse>
| { data: null; premultiplyAlpha?: undefined }
| {
data: null | ImageBitmap | HTMLCanvasElement | ImageData;
premultiplyAlpha: null | boolean;
}
Returns
    | Promise<ImageResponse>
    | { data: null; premultiplyAlpha?: undefined }
    | {
        data: null | ImageBitmap | HTMLCanvasElement | ImageData;
        premultiplyAlpha: null | boolean;
    }
- Defined in src/core/textures/ImageTexture.ts:211

emit

emit(event: string, data?: any): void
Parameters
- event: string
- Optionaldata: any
Returns void
Inherited from Texture.emit
- Defined in src/common/EventEmitter.ts:80

free

free(): void
Free the core context texture for this Texture.

Returns void
Remarks
The ctxTexture is created by the renderer and lives on the GPU.
Inherited from Texture.free
- Defined in src/core/textures/Texture.ts:380

freeTextureData

freeTextureData(): void
Free the source texture data for this Texture.

Returns void
Remarks
The texture data is the source data that is used to populate the CoreContextTexture. e.g. ImageData that is downloaded from a URL.
Inherited from Texture.freeTextureData
- Defined in src/core/textures/Texture.ts:421

getTextureData

getTextureData(): Promise<TextureData>
Get the texture data for this texture.

Returns Promise<TextureData>
The texture data for this texture.

Remarks
This method is called by the CoreContextTexture when the texture is loaded. The texture data is then used to populate the CoreContextTexture.
Inherited from Texture.getTextureData
- Defined in src/core/textures/Texture.ts:478

getTextureSource

getTextureSource(): Promise<TextureData>
Get the texture source for this texture.

Returns Promise<TextureData>
Remarks
This method is called by the CoreContextTexture when the texture is loaded. The texture source is then used to populate the CoreContextTexture.
Overrides Texture.getTextureSource
- Defined in src/core/textures/ImageTexture.ts:167

hasListeners

hasListeners(event?: string): boolean
Check whether this emitter has any listeners registered.
Parameters
- Optionalevent: string
  Optional event name. When provided, checks only that event. When omitted, checks all events.
Returns boolean
true if at least one listener is registered.
Inherited from Texture.hasListeners
- Defined in src/common/EventEmitter.ts:104

isWithinStartupGracePeriod

isWithinStartupGracePeriod(): boolean
Checks if the texture is within the startup grace period. During this period, textures are protected from cleanup to prevent race conditions during app initialization.

Returns boolean
Inherited from Texture.isWithinStartupGracePeriod
- Defined in src/core/textures/Texture.ts:249

load

load(): void
Returns void
Inherited from Texture.load
- Defined in src/core/textures/Texture.ts:341

loadCtxTexture

loadCtxTexture(): CoreContextTexture
Load the core context texture for this Texture. The ctxTexture is created by the renderer and lives on the GPU.

Returns CoreContextTexture
Inherited from Texture.loadCtxTexture
- Defined in src/core/textures/Texture.ts:366

off

off(event: string, listener?: EventListener): void
Parameters
- event: string
- Optionallistener: EventListener
Returns void
Inherited from Texture.off
- Defined in src/common/EventEmitter.ts:51

on

on(event: string, listener: EventListener): void
Parameters
- event: string
- listener: EventListener
Returns void
Inherited from Texture.on
- Defined in src/common/EventEmitter.ts:37

once

once(event: string, listener: EventListener): void
Parameters
- event: string
- listener: EventListener
Returns void
Inherited from Texture.once
- Defined in src/common/EventEmitter.ts:72

`Optional`onChangeIsRenderable

onChangeIsRenderable?(isRenderable: boolean): void
Event called when the Texture becomes renderable or unrenderable.
Parameters
- isRenderable: boolean
  true if this Texture has renderable owners.
Returns void
Remarks
Used by subclasses like SubTexture propogate then renderability of the Texture to other referenced Textures.
Inherited from Texture.onChangeIsRenderable
- Defined in src/core/textures/Texture.ts:358

release

release(): void
Release the texture data and core context texture for this Texture without changing state.

Returns void
Remarks
The ctxTexture is created by the renderer and lives on the GPU.
Inherited from Texture.release
- Defined in src/core/textures/Texture.ts:391

removeAllListeners

removeAllListeners(): void
Returns void
Inherited from Texture.removeAllListeners
- Defined in src/common/EventEmitter.ts:122

setRenderableOwner

setRenderableOwner(owner: string | number, renderable: boolean): void
Add/remove an owner to/from the Texture based on its renderability.
Parameters
- owner: string | number
- renderable: boolean
Returns void
Remarks
Any object can own a texture, be it a CoreNode or even the state object from a Text Renderer.

When the reference to the texture that an owner object holds is replaced or cleared it must call this with renderable=false to release the owner association.
Inherited from Texture.setRenderableOwner
- Defined in src/core/textures/Texture.ts:316

setState

setState(
state: TextureState,
errorOrDimensions?: TextureError | Dimensions,
): void
Parameters
- state: TextureState
- OptionalerrorOrDimensions: TextureError | Dimensions
Returns void
Inherited from Texture.setState
- Defined in src/core/textures/Texture.ts:425

`Static`makeCacheKey

makeCacheKey(props: ImageTextureProps): string | false
Generates a cache key for the ImageTexture based on the provided props.
Parameters
- props: ImageTextureProps
  The props used to generate the cache key.
Returns string | false
The cache key as a string, or false if the key cannot be generated.
Overrides Texture.makeCacheKey
- Defined in src/core/textures/ImageTexture.ts:263

`Static`resolveDefaults

resolveDefaults(props: ImageTextureProps): Required<ImageTextureProps>
Resolve the default values for the texture's properties.
Parameters
- props: ImageTextureProps
Returns Required<ImageTextureProps>
The default values for the texture's properties.

Remarks
Each concrete Texture subclass must implement this method to provide default values for the texture's optional properties.
Overrides Texture.resolveDefaults
- Defined in src/core/textures/ImageTexture.ts:285

Class ImageTexture

Remarks

Hierarchy (View Summary)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns ImageTexture

Properties

cacheKey

ctxTexture

maxRetryCount

memUsed

preventCleanup

props

Readonlyrenderable

ReadonlyrenderableOwners

retryCount

Remarks

state

textureData

ProtectedtxManager

type

Staticz$__type__Props

Accessors

dimensions

Returns null | Dimensions

error

Returns null | TextureError

Methods

canBeCleanedUp

Returns boolean

clearListeners

Parameters

Returns void

destroy

Returns void

Remarks

determineImageTypeAndLoadImage

Returns | Promise<ImageResponse> | { data: null; premultiplyAlpha?: undefined } | { data: null | ImageBitmap | HTMLCanvasElement | ImageData; premultiplyAlpha: null | boolean; }

emit

Parameters

Returns void

free

Returns void

Remarks

freeTextureData

Returns void

Remarks

getTextureData

Returns Promise<TextureData>

Remarks

getTextureSource

Returns Promise<TextureData>

Remarks

hasListeners

Parameters

Returns boolean

isWithinStartupGracePeriod

Returns boolean

load

Returns void

loadCtxTexture

Returns CoreContextTexture

off

Parameters

Returns void

on

Parameters

Returns void

once

Parameters

Returns void

OptionalonChangeIsRenderable

Parameters

Returns void

`Readonly`renderable

`Readonly`renderableOwners

`Protected`txManager

`Static`z$typeProps

Returns
| Promise<ImageResponse>
| { data: null; premultiplyAlpha?: undefined }
| {
data: null | ImageBitmap | HTMLCanvasElement | ImageData;
premultiplyAlpha: null | boolean;
}

`Optional`onChangeIsRenderable

`Static`makeCacheKey

`Static`resolveDefaults