Skip to main content

Abstract Class: ExternalTexture

Defined in: modules/core/src/adapter/resources/external-texture.ts:24

Concrete backend binding snapshot for opaque external texture data.

Extends​

Constructors​

Constructor​

new ExternalTexture(device, props): ExternalTexture

Defined in: modules/core/src/adapter/resources/external-texture.ts:46

Creates concrete external binding metadata from a source or borrowed handle.

Parameters​

device​

Device

Device that owns this concrete external binding snapshot.

props​

ExternalTextureProps

Source, borrowed handle, dimensions, and sampler for this snapshot.

Returns​

ExternalTexture

Overrides​

Resource.constructor

Properties​

destroyed​

destroyed: boolean = false

Defined in: modules/core/src/adapter/resources/resource.ts:131

Whether this resource has been destroyed

Inherited from​

Resource.destroyed

device​

abstract readonly device: Device

Defined in: modules/core/src/adapter/resources/resource.ts:124

The device that this resource is associated with

Inherited from​

Resource.device

handle​

abstract readonly handle: unknown

Defined in: modules/core/src/adapter/resources/resource.ts:126

The handle for the underlying resource, e.g. WebGL object or WebGPU handle

Inherited from​

Resource.handle

height​

readonly height: number

Defined in: modules/core/src/adapter/resources/external-texture.ts:28

Height in pixels for this concrete sampled binding.

id​

id: string

Defined in: modules/core/src/adapter/resources/resource.ts:118

props.id, for debugging.

Inherited from​

Resource.id

props​

readonly props: Required<Props>

Defined in: modules/core/src/adapter/resources/resource.ts:120

The props that this resource was created with

Inherited from​

Resource.props

sampler​

abstract sampler: Sampler

Defined in: modules/core/src/adapter/resources/external-texture.ts:30

Default sampler for this external texture.

updateTimestamp​

updateTimestamp: number

Defined in: modules/core/src/adapter/resources/external-texture.ts:34

Device timestamp of this external binding acquisition.

userData​

readonly userData: Record<string, unknown> = {}

Defined in: modules/core/src/adapter/resources/resource.ts:122

User data object, reserved for the application

Inherited from​

Resource.userData

width​

readonly width: number

Defined in: modules/core/src/adapter/resources/external-texture.ts:26

Width in pixels for this concrete sampled binding.

defaultProps​

static defaultProps: Required<ExternalTextureProps>

Defined in: modules/core/src/adapter/resources/external-texture.ts:55

Default resolved properties used by concrete external texture bindings.

Overrides​

Resource.defaultProps

Accessors​

[toStringTag]​

Get Signature​

get [toStringTag](): string

Defined in: modules/core/src/adapter/resources/external-texture.ts:37

Resource label used by debug output.

Returns​

string

Overrides​

Resource.[toStringTag]

isHandleBorrowed​

Get Signature​

get isHandleBorrowed(): boolean

Defined in: modules/core/src/adapter/resources/resource.ts:147

Whether luma.gl may only reference the opaque externally owned resource handle.

Returns​

boolean

Inherited from​

Resource.isHandleBorrowed

ownsHandle​

Get Signature​

get ownsHandle(): boolean

Defined in: modules/core/src/adapter/resources/resource.ts:140

Whether luma.gl created and owns the underlying resource handle.

Returns​

boolean

Inherited from​

Resource.ownsHandle

Methods​

attachResource()​

attachResource(resource): void

Defined in: modules/core/src/adapter/resources/resource.ts:200

Attaches a resource. Attached resources are auto destroyed when this resource is destroyed Called automatically when sub resources are auto created but can be called by application

Parameters​

resource​

Resource<ResourceProps>

Returns​

void

Inherited from​

Resource.attachResource

delete()​

delete(): this

Defined in: modules/core/src/adapter/resources/resource.ts:181

Returns​

this

Deprecated​

Use destroy()

Inherited from​

Resource.delete

destroy()​

destroy(): void

Defined in: modules/core/src/adapter/resources/resource.ts:173

destroy can be called on any resource to release it before it is garbage collected.

Returns​

void

Inherited from​

Resource.destroy

destroyAttachedResource()​

destroyAttachedResource(resource): void

Defined in: modules/core/src/adapter/resources/resource.ts:214

Destroys a resource (only if owned), and removes from the owned (auto-destroy) list for this resource.

Parameters​

resource​

Resource<ResourceProps>

Returns​

void

Inherited from​

Resource.destroyAttachedResource

destroyAttachedResources()​

destroyAttachedResources(): void

Defined in: modules/core/src/adapter/resources/resource.ts:221

Destroy all owned resources. Make sure the resources are no longer needed before calling.

Returns​

void

Inherited from​

Resource.destroyAttachedResources

detachResource()​

detachResource(resource): void

Defined in: modules/core/src/adapter/resources/resource.ts:207

Detach an attached resource. The resource will no longer be auto-destroyed when this resource is destroyed.

Parameters​

resource​

Resource<ResourceProps>

Returns​

void

Inherited from​

Resource.detachResource

getProps()​

getProps(): object

Defined in: modules/core/src/adapter/resources/resource.ts:190

Combines a map of user props and default props, only including props from defaultProps

Returns​

object

returns a map of overridden default props

Inherited from​

Resource.getProps

setSampler()​

abstract setSampler(sampler): this

Defined in: modules/core/src/adapter/resources/external-texture.ts:32

Replace the default sampler used for paired shader sampler bindings.

Parameters​

sampler​

SamplerProps | Sampler

Returns​

this

toJSON()​

toJSON(): string

Defined in: modules/core/src/adapter/resources/resource.ts:113

Compact serialization for assertion diffs and structured debug logs.

Returns​

string

Inherited from​

Resource.toJSON

toString()​

toString(): string

Defined in: modules/core/src/adapter/resources/resource.ts:108

Returns​

string

Inherited from​

Resource.toString