@lightningjs/renderer
    Preparing search index...

    Class TextureAbstract

    Represents a source of texture data for a CoreContextTexture.

    Texture sources are used to populate a CoreContextTexture when that texture is loaded. Texture data retrieved by the CoreContextTexture by the getTextureData method. It's the responsibility of the concerete Texture subclass to implement this method appropriately.

    Hierarchy (View Summary)

    Index
    constructor
    cacheKey contextGeneration ctxTexture maxRetryCount memUsed preventCleanup renderable renderableOwners retryCount state textureData txManager type
    dimensions error
    canBeCleanedUp clearListeners destroy emit emitSafe free freeTextureData getTextureData getTextureSource hasListeners invalidateContext isWithinStartupGracePeriod load loadCtxTexture notifyContextLost off on once onChangeIsRenderable? release removeAllListeners setRenderableOwner setState makeCacheKey resolveDefaults
    cacheKey: string | null = null

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

    contextGeneration: number = 0
    ctxTexture: CoreContextTexture | undefined
    maxRetryCount: number
    memUsed: number = 0
    preventCleanup: boolean = false
    renderable: boolean = false
    renderableOwners: Set<string | number> = ...
    retryCount: number = 0

    Memory used by this texture in bytes

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

    state: TextureState = 'initial'
    textureData: TextureData | null = null
    txManager: CoreTextureManager
    type: TextureType = TextureType.generic

    • Checks if the texture can be safely cleaned up. Considers the renderable state, startup grace period, and renderable owners.

      Returns boolean

    • 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

    • Destroy the texture.

      Returns void

      This method is called when the texture is no longer needed and should be cleaned up.

    • Emit to all listeners, isolating each one from the others.

      Parameters

      • event: string
      • Optionaldata: any
      • OptionalonError: LoopErrorHandler

      Returns void

      Unlike emit, a throwing listener neither aborts the remaining listeners nor propagates to the caller (e.g. the rAF loop). Each error is routed to onError (handleLoopError) or console.error and iteration continues. Internal renderer code should keep using emit (fail loudly); app-facing boundaries should use this.

      Kept as a separate method so the hot emit path — and more importantly its callers in the frame loop — stay try-free for older JITs.

    • Free the core context texture for this Texture.

      Returns void

      The ctxTexture is created by the renderer and lives on the GPU.

    • Free the source texture data for this Texture.

      Returns void

      The texture data is the source data that is used to populate the CoreContextTexture. e.g. ImageData that is downloaded from a URL.

    • Get the texture data for this texture.

      Returns Promise<TextureData>

      The texture data for this texture.

      This method is called by the CoreContextTexture when the texture is loaded. The texture data is then used to populate the CoreContextTexture.

    • Get the texture source for this texture.

      Returns Promise<TextureData>

      This method is called by the CoreContextTexture when the texture is loaded. The texture source is then used to populate the CoreContextTexture.

    • 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.

    • 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

    • Load the core context texture for this Texture. The ctxTexture is created by the renderer and lives on the GPU.

      Returns CoreContextTexture

    • Event called when the Texture becomes renderable or unrenderable.

      Parameters

      • isRenderable: boolean

        true if this Texture has renderable owners.

      Returns void

      Used by subclasses like SubTexture propogate then renderability of the Texture to other referenced Textures.

    • Release the texture data and core context texture for this Texture without changing state.

      Returns void

      The ctxTexture is created by the renderer and lives on the GPU.

    • Add/remove an owner to/from the Texture based on its renderability.

      Parameters

      • owner: string | number
      • renderable: boolean

      Returns void

      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.

    • Make a cache key for this texture.

      Parameters

      • props: unknown

      Returns string | false

      A cache key for this texture or false if the texture type does not support caching.

      Each concrete Texture subclass must implement this method to provide an appropriate cache key for the texture type including the texture's properties that uniquely identify a copy of the texture. If the texture type does not support caching, then this method should return false.

    • Resolve the default values for the texture's properties.

      Parameters

      • props: unknown

      Returns Record<string, any>

      The default values for the texture's properties.

      Each concrete Texture subclass must implement this method to provide default values for the texture's optional properties.

    Settings
    Member Visibility

    On This Page
    Constructors
    Properties
    Accessors
    Methods