Allows to create a bindgroup very easy (single string) and fast (cached descriptor). The layout could be an existing GPUBindGroupLayout or a string describing it, using syntax described in the function createSimpleBindGroupLayout.

Parameters

layout

string | GPUBindGroupLayout

items

label

string

Returns

GPUBindGroup

createSimpleBindGroupLayout()

createSimpleBindGroupLayout(types_key, label): GPUBindGroupLayout

Defined in: packages/charm/src/graphics/WebGPU/WebGPURenderContext.ts:215

Helper to build BindGroupLayout using a very simple interface: You must pass a string that contain a description of usage of every bindGroupItem in the right order, separated by commas. The properties of a single item are separated by '|' character: Example: "vs|uniform,fs|texture" means two items, one uniform for the vertex shader and one texture for the fragment shader.

Here is a list of all available keywords:

vs: used in a vertex shader
fs: used in a fragment shader
cs: used in a compute shader
uniform: used as uniform in a shader
read: read only buffer
store: storage buffer
texture: texture 2D
texture_multisampled: texture multisampled
texture_depth: depth texture
texture_depth_multisampled: depth texture multisampled
cube: texture Cubemap
sampler: texture sampler
dynamic: uniform buffer with dynamic offset All this keywords can be mixed to define all properties of every item. This string also applies as a hash for reusing bindgroup layouts. Use this method in conjunction with createSimpleBindGroup.

Parameters

types_key

string

label

string

Returns

GPUBindGroupLayout

createSimpleRenderPassDescriptor()

createSimpleRenderPassDescriptor(targetTexture): GPURenderPassDescriptor

Defined in: packages/charm/src/graphics/WebGPU/WebGPURenderContext.ts:363

An easy way to create a RenderPassDescriptor given a texture

Parameters

targetTexture

GPUTexture

Returns

GPURenderPassDescriptor

destroy()

destroy(): void

Defined in: packages/charm/src/graphics/WebGPU/WebGPURenderContext.ts:105

Returns

void

drawGeometryFromRenderable()

drawGeometryFromRenderable(renderable, renderPass, lastGeometryIndex): number

Defined in: packages/charm/src/graphics/WebGPU/WebGPURenderContext.ts:658

does the draw call once all is set

Parameters

renderable

RenderableDescriptor

renderPass

GPURenderPassEncoder

lastGeometryIndex

number = -1

Returns

number

getBufferBindGroup()

getBufferBindGroup(input, usage): GPUBindGroup

Defined in: packages/charm/src/graphics/WebGPU/WebGPURenderContext.ts:515

Asumes usage is for compute shader

Parameters

input

GPUBuffer

usage

number = eBindGroupUsage.fragment

Returns

GPUBindGroup

getPipeline()

getPipeline(material, shader, primitive, sampleCount, colorFormat, depthFormat?, colorFormat2?): GPURenderPipeline

Defined in: packages/charm/src/graphics/WebGPU/WebGPURenderContext.ts:540

Finds the right pipeline by generating a hash from the input

Parameters

material

Material

shader

WebGPUShader

primitive

WebGPUPrimitive

sampleCount

number

colorFormat

GPUTextureFormat

depthFormat?

"none" | GPUTextureFormat

colorFormat2?

GPUTextureFormat

Returns

GPURenderPipeline

getQuadBindGroup()

getQuadBindGroup(input): GPUBindGroup

Defined in: packages/charm/src/graphics/WebGPU/WebGPURenderContext.ts:383

Helper when you want to render a screen quad to apply some fx to a texture. It creates a BindGroup with the texture, sampler and generic uniform together.

Parameters

input

GPUTexture

Returns

GPUBindGroup

getSampler()

getSampler(textureSampler): GPUSampler

Defined in: packages/charm/src/graphics/WebGPU/WebGPURenderContext.ts:138

Creates a GPUSampler from a TextureSampler object, caching the result.

Parameters

textureSampler

TextureSampler

Returns

GPUSampler

getTexture()

getTexture(name, url?): WebGPUTexture

Defined in: packages/charm/src/graphics/WebGPU/WebGPURenderContext.ts:460

Retrieves a texture, and if doesnt exist, it tryes to load it.

Parameters

name

string

url?

string

Returns

WebGPUTexture

getTextureBindGroup()

getTextureBindGroup(input, usage, noSampler, format?): GPUBindGroup

Defined in: packages/charm/src/graphics/WebGPU/WebGPURenderContext.ts:482

Asumes usage is for fragment shader

Parameters

input

GPUTexture

usage

number = eBindGroupUsage.fragment

noSampler

boolean = false

format?

GPUTextureFormat

Returns

GPUBindGroup

getTextureSamplerDescriptor()

getTextureSamplerDescriptor(textureSampler): GPUSamplerDescriptor

Defined in: packages/charm/src/graphics/WebGPU/WebGPURenderContext.ts:152

Transforms a TextureSampler object into a GPUSamplerDescriptor object. It caches the result to go faster.

Parameters

textureSampler

TextureSampler

Returns

GPUSamplerDescriptor

loadTexture()

loadTexture(url, sRGB): WebGPUTexture

Defined in: packages/charm/src/graphics/WebGPU/WebGPURenderContext.ts:432

Parameters

url

string

sRGB

boolean = true

Returns

WebGPUTexture

registerTexture()

registerTexture(name, texture): void

Defined in: packages/charm/src/graphics/WebGPU/WebGPURenderContext.ts:468

Parameters

name

string

texture

WebGPUTexture

Returns

void

reset()

reset(): void

Defined in: packages/charm/src/graphics/WebGPU/WebGPURenderContext.ts:110

called to prepare for next frame, it sets up some offset to 0

Returns

void

setAsCurrent()

setAsCurrent(): void

Defined in: packages/charm/src/graphics/WebGPU/WebGPURenderContext.ts:115

Makes it the current one so it can be fetched from other places using WebGPURenderContext.current.

Returns

void

updatePendingBuffers()

updatePendingBuffers(): void

Defined in: packages/charm/src/graphics/WebGPU/WebGPURenderContext.ts:419

Called at the end of the framegraph

Returns

void

Class: WebGPURenderContext ​

Constructors ​

Constructor ​

Parameters ​

device ​

Returns ​

Properties ​

alphaAddBlendDescriptor ​

alphaBlendDescriptor ​

backend ​

bindGroupCache ​

bindGroupLayoutCache ​

bufferBindGroupsCache ​

buffersPendingUpdate ​

computeCache ​

computePipelineCache ​

currentRenderBuffer? ​

currentRenderPass? ​

defaultViewFormat ​

device ​

dynUniforms ​

globalsUniformBuffer? ​

mipmapGenerator ​

renderPipelineCache ​

renderPipelineDescriptorCache ​

samplerCache ​

shaderCache ​

textureBindGroupsCache ​

textureSampler ​

texturesCache ​

current ​

Accessors ​

renderPipelineDescriptorCacheValues ​

Get Signature ​

Returns ​

Methods ​

addBufferToPending() ​

Parameters ​

buffer ​

Returns ​

applyShaderToTexture() ​

Parameters ​

encoder ​

input ​

destination ​

shader ​

data ​

Returns ​

clearCache() ​

Returns ​

createSimpleBindGroup() ​

Parameters ​

layout ​

items ​

label ​

Returns ​

createSimpleBindGroupLayout() ​

Parameters ​

types_key ​

label ​

Returns ​

createSimpleRenderPassDescriptor() ​

Parameters ​

targetTexture ​

Returns ​

destroy() ​

Returns ​

drawGeometryFromRenderable() ​

Parameters ​

renderable ​

renderPass ​

lastGeometryIndex ​

Returns ​

getBufferBindGroup() ​

Parameters ​

input ​

usage ​

Returns ​

getPipeline() ​

Parameters ​

Class: WebGPURenderContext

Constructors

Constructor

Parameters

device

Returns

Properties

alphaAddBlendDescriptor

alphaBlendDescriptor

backend

bindGroupCache

bindGroupLayoutCache

bufferBindGroupsCache

buffersPendingUpdate

computeCache

computePipelineCache

currentRenderBuffer?

currentRenderPass?

defaultViewFormat

device

dynUniforms

globalsUniformBuffer?

mipmapGenerator

renderPipelineCache

renderPipelineDescriptorCache

samplerCache

shaderCache

textureBindGroupsCache

textureSampler

texturesCache

current

Accessors

renderPipelineDescriptorCacheValues

Get Signature

Returns

Methods

addBufferToPending()

Parameters

buffer

Returns

applyShaderToTexture()

Parameters

encoder

input

destination

shader

data

Returns

clearCache()

Returns

createSimpleBindGroup()

Parameters

layout

items

label

Returns

createSimpleBindGroupLayout()

Parameters

types_key

label

Returns

createSimpleRenderPassDescriptor()

Parameters

targetTexture

Returns

destroy()

Returns

drawGeometryFromRenderable()

Parameters

renderable

renderPass

lastGeometryIndex

Returns

getBufferBindGroup()

Parameters

input

usage

Returns

getPipeline()

Parameters