TgpuRenderPipeline

Defined in: packages/typegpu/src/core/pipeline/renderPipeline.ts:166

Extends

TgpuNamable.SelfResolvable.Timeable

Type Parameters

Targets

Targets = never

Properties

[$internal]

readonly [$internal]: RenderPipelineInternals

Defined in: packages/typegpu/src/core/pipeline/renderPipeline.ts:168

Overrides

SelfResolvable.[$internal]

[$soul]

readonly [$soul]: TgpuRenderPipelineSoul

Defined in: packages/typegpu/src/core/pipeline/renderPipeline.ts:169

hasIndexBuffer

readonly hasIndexBuffer: boolean

Defined in: packages/typegpu/src/core/pipeline/renderPipeline.ts:171

resourceType

readonly resourceType: "render-pipeline"

Defined in: packages/typegpu/src/core/pipeline/renderPipeline.ts:170

Methods

[$resolve]()

[$resolve](ctx): ResolvedSnippet

Defined in: packages/typegpu/src/types.ts:426

Parameters

ctx

ResolutionCtx

Returns

ResolvedSnippet

Inherited from

SelfResolvable.[$resolve]

$name()

$name(label): this

Defined in: packages/typegpu/src/shared/meta.ts:44

Parameters

label

string

Returns

this

Inherited from

TgpuNamable.$name

draw()

draw(vertexCount, instanceCount?, firstVertex?, firstInstance?): void

Defined in: packages/typegpu/src/core/pipeline/renderPipeline.ts:231

Parameters

vertexCount

number

instanceCount?

number

firstVertex?

number

firstInstance?

number

Returns

void

drawIndexedIndirect()

drawIndexedIndirect(indirectBuffer, indirectOffset?): void

Defined in: packages/typegpu/src/core/pipeline/renderPipeline.ts:271

Draws indexed primitives using parameters read from a buffer. The buffer must contain 5 consecutive 32-bit integer values (indexCount u32, instanceCount u32, firstIndex u32, baseVertex i32, firstInstance u32). To get the correct offset within complex data structures, use d.memoryLayoutOf(...).

Parameters

indirectBuffer

Buffer marked with ‘indirect’ usage containing draw parameters or raw GPUBuffer

GPUBuffer | TgpuBuffer<BaseData> & IndirectFlag

indirectOffset?

PrimitiveOffsetInfo pointing to the first draw parameter. If not provided, starts at offset 0. To obtain safe offsets, use d.memoryLayoutOf(...).

number | PrimitiveOffsetInfo

Returns

void

drawIndirect()

drawIndirect(indirectBuffer, indirectOffset?): void

Defined in: packages/typegpu/src/core/pipeline/renderPipeline.ts:258

Draws primitives using parameters read from a buffer. The buffer must contain 4 consecutive u32 values (vertexCount, instanceCount, firstVertex, firstInstance). To get the correct offset within complex data structures, use d.memoryLayoutOf(...).

Parameters

indirectBuffer

Buffer marked with ‘indirect’ usage containing draw parameters or raw GPUBuffer

GPUBuffer | TgpuBuffer<BaseData> & IndirectFlag

indirectOffset?

PrimitiveOffsetInfo pointing to the first draw parameter. If not provided, starts at offset 0. To obtain safe offsets, use d.memoryLayoutOf(...).

number | PrimitiveOffsetInfo

Returns

void

initAsync()

initAsync(): Promise<void>

Defined in: packages/typegpu/src/core/pipeline/renderPipeline.ts:242

Immediately resolves the pipeline, then awaits device.createRenderPipelineAsync(). NOTE: it is not necessary to initialize pipelines manually.

Returns

Promise<void>

initSync()

initSync(): void

Defined in: packages/typegpu/src/core/pipeline/renderPipeline.ts:248

Immediately resolves the pipeline and creates WebGPU resources. NOTE: it is not necessary to initialize pipelines manually.

Returns

void

toString()

toString(): string

Defined in: packages/typegpu/src/types.ts:427

Returns

string

Inherited from

SelfResolvable.toString

with()

Call Signature

with<TData>(vertexLayout, buffer): this

Defined in: packages/typegpu/src/core/pipeline/renderPipeline.ts:173

Type Parameters

TData

TData extends WgslArray<BaseData> | Disarray<BaseData>

Parameters

vertexLayout

TgpuVertexLayout<TData>

buffer

GPUBuffer | TgpuBuffer<TData> & VertexFlag

Returns

this

Call Signature

with<Entries>(bindGroupLayout, bindGroup): this

Defined in: packages/typegpu/src/core/pipeline/renderPipeline.ts:181

Type Parameters

Entries

Entries extends Record<string, TgpuLayoutEntry | null>

Parameters

bindGroupLayout

TgpuBindGroupLayout<Entries>

bindGroup

TgpuBindGroup<Entries>

Returns

this

Call Signature

with(bindGroupLayout, bindGroup): this

Defined in: packages/typegpu/src/core/pipeline/renderPipeline.ts:185

Parameters

bindGroupLayout

TgpuBindGroupLayout

bindGroup

GPUBindGroup

Returns

this

Call Signature

with(bindGroup): this

Defined in: packages/typegpu/src/core/pipeline/renderPipeline.ts:186

Parameters

bindGroup

TgpuBindGroup

Returns

this

Call Signature

with(pass): this

Defined in: packages/typegpu/src/core/pipeline/renderPipeline.ts:191

Directs subsequent draw calls into the given render pass or render bundle encoder, letting multiple pipelines share one pass (and one submission).

Parameters

pass

TgpuRenderCommands

Returns

this

Call Signature

with(encoder): this

Defined in: packages/typegpu/src/core/pipeline/renderPipeline.ts:196

Directs subsequent draw calls into the given command encoder. Each draw records its own render pass; the caller owns the submission.

Parameters

encoder

TgpuCommandEncoder

Returns

this

Call Signature

with(encoder): this

Defined in: packages/typegpu/src/core/pipeline/renderPipeline.ts:197

Parameters

encoder

GPUCommandEncoder

Returns

this

Call Signature

with(pass): this

Defined in: packages/typegpu/src/core/pipeline/renderPipeline.ts:198

Parameters

pass

GPURenderPassEncoder

Returns

this

Call Signature

with(bundleEncoder): this

Defined in: packages/typegpu/src/core/pipeline/renderPipeline.ts:199

Parameters

bundleEncoder

GPURenderBundleEncoder

Returns

this

withColorAttachment()

withColorAttachment(attachment): this

Defined in: packages/typegpu/src/core/pipeline/renderPipeline.ts:213

Attaches texture views to the pipeline’s targets (outputs).

Parameters

attachment

FragmentOutToColorAttachment<Targets>

The object should match the shape returned by the fragment shader, with values matching the ColorAttachment type.

Returns

this

Example

// Draw 3 vertices onto the context's canvas
pipeline
  .withColorAttachment({ view: context })
  .draw(3)

withDepthStencilAttachment()

withDepthStencilAttachment(attachment): this

Defined in: packages/typegpu/src/core/pipeline/renderPipeline.ts:215

Parameters

attachment

DepthStencilAttachment

Returns

this

withIndexBuffer()

Call Signature

withIndexBuffer(buffer, offsetElements?, sizeElements?): TgpuRenderPipeline<Targets> & HasIndexBuffer

Defined in: packages/typegpu/src/core/pipeline/renderPipeline.ts:219

Parameters

buffer

TgpuBuffer<BaseData> & IndexFlag

offsetElements?

number

sizeElements?

number

Returns

TgpuRenderPipeline<Targets> & HasIndexBuffer

Call Signature

withIndexBuffer(buffer, indexFormat, offsetBytes?, sizeBytes?): TgpuRenderPipeline<Targets> & HasIndexBuffer

Defined in: packages/typegpu/src/core/pipeline/renderPipeline.ts:224

Parameters

buffer

GPUBuffer

indexFormat

GPUIndexFormat

offsetBytes?

number

sizeBytes?

number

Returns

TgpuRenderPipeline<Targets> & HasIndexBuffer

withPerformanceCallback()

withPerformanceCallback(callback): this

Defined in: packages/typegpu/src/core/pipeline/timeable.ts:13

Attaches a callback reporting the GPU-side start and end timestamps of the pipeline’s pass. Repeated executions within one command encoder write to the same query set indices, so the callback fires once, with the timestamps of the last execution.

Parameters

callback

(start, end) => void | Promise<void>

Returns

this

Inherited from

Timeable.withPerformanceCallback

withStencilReference()

withStencilReference(reference): this

Defined in: packages/typegpu/src/core/pipeline/renderPipeline.ts:217

Parameters

reference

number

Returns

this

withTimestampWrites()

withTimestampWrites(options): this

Defined in: packages/typegpu/src/core/pipeline/timeable.ts:15

Parameters

options

beginningOfPassWriteIndex?

number

endOfPassWriteIndex?

number

querySet

GPUQuerySet | TgpuQuerySet<"timestamp">

Returns

this

Inherited from

Timeable.withTimestampWrites