Interface GPUTextureDescriptor

Hierarchy

Properties

dimension? format label? mipLevelCount? sampleCount? size textureBindingViewDimension? usage viewFormats?

Properties

Optional dimension

dimension?: GPUTextureDimension

Whether the texture is one-dimensional, an array of two-dimensional layers, or three-dimensional.

format

format: GPUTextureFormat

The format of the texture.

Optional label

label?: string

The initial value of GPUObjectBase#labe | PUObjectBase.label.

Optional mipLevelCount

mipLevelCount?: number

The number of mip levels the texture will contain.

Optional sampleCount

sampleCount?: number

The sample count of the texture. A sampleCount > 1 indicates a multisampled texture.

size

size: GPUExtent3DStrict

The width, height, and depth or layer count of the texture.

Optional textureBindingViewDimension

textureBindingViewDimension?: GPUTextureViewDimension

PROPOSED addition for Compatibility Mode: https://github.com/gpuweb/gpuweb/blob/main/proposals/compatibility-mode.md#1-texture-view-dimension-may-be-specified

[In compatibility mode,] When specifying a texture, a textureBindingViewDimension property determines the views which can be bound from that texture for sampling. Binding a view of a different dimension for sampling than specified at texture creation time will cause a validation error.

usage

usage: number

The allowed usages for the texture.

Optional viewFormats

viewFormats?: Iterable<GPUTextureFormat>

Specifies what view format values will be allowed when calling createView on this texture (in addition to the texture's actual format).

Adding a format to this list may have a significant performance impact, so it is best to avoid adding formats unnecessarily. The actual performance impact is highly dependent on the target system; developers must test various systems to find out the impact on their particular application. For example, on some systems any texture with a format or viewFormats entry including GPUTextureFormat#"rgba8unorm-srgb" will perform less optimally than a GPUTextureFormat#"rgba8unorm" texture which does not. Similar caveats exist for other formats and pairs of formats on other systems.
Formats in this list must be texture view format compatible with the texture format.
Two GPUTextureFormats `format` and `viewFormat` are texture view format compatible if: - `format` equals `viewFormat`, or - `format` and `viewFormat` differ only in whether they are `srgb` formats (have the `-srgb` suffix).

Settings

Member Visibility

Theme

Generated using TypeDoc