Interface RenderMaterialParams

Parameters used to create a RenderMaterial

interface RenderMaterialParams {
    uniforms?: ReadOnlyInputBindings;
    storages?: ReadWriteInputBindings;
    bindings?: BindGroupBindingElement[];
    label?: string;
    shaders?: MaterialShaders;
    useAsyncPipeline?: boolean;
    bindGroups?: BindGroup[];
    samplers?: Sampler[];
    textures?: Texture[];
    domTextures?: DOMTexture[];
    useProjection?: boolean;
    transparent?: boolean;
    depth?: boolean;
    depthWriteEnabled?: boolean;
    depthCompare?: GPUCompareFunction;
    depthFormat?: GPUTextureFormat;
    cullMode?: GPUCullMode;
    sampleCount?: number;
    targets?: GPUColorTargetState[];
    verticesOrder?: GPUFrontFace;
    topology?: GPUPrimitiveTopology;
}

Hierarchy (view full)

Properties

uniforms? storages? bindings? label? shaders? useAsyncPipeline? bindGroups? samplers? textures? domTextures? useProjection? transparent? depth? depthWriteEnabled? depthCompare? depthFormat? cullMode? sampleCount? targets? verticesOrder? topology?

Properties

Optional uniforms

uniforms?: ReadOnlyInputBindings

uniforms input to pass to a BindGroup

Optional storages

storages?: ReadWriteInputBindings

read only or read/write storages input to pass to a BindGroup

Optional bindings

bindings?: BindGroupBindingElement[]

array of already created bindings (buffers, texture, etc.) to pass to this BindGroup

Optional label

label?: string

The label of the Material, sent to various GPU objects for debugging purpose

Optional shaders

shaders?: MaterialShaders

Shaders to use with this Material

Optional useAsyncPipeline

useAsyncPipeline?: boolean

Whether to compile the Material GPUPipelineBase | pipeline asynchronously or not

Optional bindGroups

bindGroups?: BindGroup[]

Array of already created bind groups to be used by this Material

Optional samplers

samplers?: Sampler[]

Array of already created samplers to be used by this Material

Optional textures

textures?: Texture[]

Array of already created Texture to be used by this Material

Optional domTextures

domTextures?: DOMTexture[]

Array of already created DOMTexture to be used by this Material

Optional useProjection

useProjection?: boolean

Whether this RenderMaterial should implicitly use the renderer camera bind group

Optional transparent

transparent?: boolean

Whether this RenderMaterial should be treated as transparent. Impacts the render pipeline blend property

Optional depth

depth?: boolean

Whether this RenderMaterial should write to the depth buffer

Optional depthWriteEnabled

depthWriteEnabled?: boolean

Whether this RenderMaterial should enable depth write

Optional depthCompare

depthCompare?: GPUCompareFunction

Depth function to use with this RenderMaterial

Optional depthFormat

depthFormat?: GPUTextureFormat

Format of the depth texture to use with this RenderMaterial

Optional cullMode

cullMode?: GPUCullMode

Cull mode to use with this RenderMaterial

Optional sampleCount

sampleCount?: number

The sampleCount of the RenderPass onto which we'll be drawing. Set internally.

Optional targets

targets?: GPUColorTargetState[]

Array of one or multiple targets properties.

Each target should be an object with the optional format, blend and writeMask properties.

The format property will be internally patched to match the output RenderPass target (default to the renderer preferred format).

If defined, the blend property can override the default transparent blending if set.

Optional verticesOrder

verticesOrder?: GPUFrontFace

Vertices order to be used by the render pipeline

Optional topology

topology?: GPUPrimitiveTopology

Topology to use with this RenderMaterial, i.e. whether to draw triangles or points (see https://www.w3.org/TR/webgpu/#enumdef-gpuprimitivetopology)

Settings

Member Visibility

Theme

On This Page