WithBinding

Creates a compute pipeline that executes the given callback in an exact number of threads. This is different from withCompute(...).createPipeline() in that it does a bounds check on the thread id, where as regular pipelines do not and work in units of workgroups.

Type Parameters

TArgs

TArgs extends number[]

Parameters

callback

(…args) => void

A function converted to WGSL and executed on the GPU. It can accept up to 3 parameters (x, y, z) which correspond to the global invocation ID of the executing thread.

Returns

TgpuGuardedComputePipeline<TArgs>

Examples

If no parameters are provided, the callback will be executed once, in a single thread.

const fooPipeline = root
  .createGuardedComputePipeline(() => {
    'use gpu';
    console.log('Hello, GPU!');
  });

fooPipeline.dispatchThreads();
// [GPU] Hello, GPU!

One parameter means n-threads will be executed in parallel.

const fooPipeline = root
  .createGuardedComputePipeline((x) => {
    'use gpu';
    if (x % 16 === 0) {
      // Logging every 16th thread
      console.log('I am the', x, 'thread');
    }
  });

// executing 512 threads
fooPipeline.dispatchThreads(512);
// [GPU] I am the 256 thread
// [GPU] I am the 272 thread
// ... (30 hidden logs)
// [GPU] I am the 16 thread
// [GPU] I am the 240 thread

createRenderPipeline()

Call Signature

createRenderPipeline<TVertexIn, TAttribs, TVertexOut, TFragmentOut>(descriptor): TgpuRenderPipeline<NormalizeOutput<TFragmentOut>>

Defined in: packages/typegpu/src/core/root/rootTypes.ts:264

Type Parameters

TVertexIn

TVertexIn extends In = Record<string, any>

TAttribs

TAttribs extends object = LayoutToAllowedAttribs<TVertexIn>

TVertexOut

TVertexOut = unknown

TFragmentOut

TFragmentOut = unknown

Parameters

descriptor

DescriptorBase & object

Returns

TgpuRenderPipeline<NormalizeOutput<TFragmentOut>>

Call Signature

createRenderPipeline<TVertexIn, TAttribs, TVertexOut>(descriptor): TgpuRenderPipeline<Void>

Defined in: packages/typegpu/src/core/root/rootTypes.ts:293

Type Parameters

TVertexIn

TVertexIn extends In = Record<string, any>

TAttribs

TAttribs extends object = LayoutToAllowedAttribs<TVertexIn>

TVertexOut

TVertexOut extends Out = Out

Parameters

descriptor

DescriptorBase & object

Returns

TgpuRenderPipeline<Void>

Call Signature

createRenderPipeline<TVertexIn, TAttribs, TVertexOut, TFragmentOut>(descriptor): TgpuRenderPipeline<Void> | TgpuRenderPipeline<NormalizeOutput<TFragmentOut>>

Defined in: packages/typegpu/src/core/root/rootTypes.ts:322

Type Parameters

TVertexIn

TVertexIn extends In = Record<string, any>

TAttribs

TAttribs extends object = LayoutToAllowedAttribs<TVertexIn>

TVertexOut

TVertexOut extends Out = Out

TFragmentOut

TFragmentOut = unknown

Parameters

descriptor

DescriptorBase & { attribs?: TAttribs; fragment: TgpuFragmentFn<VertexOutToVarying<OmitBuiltins<TVertexOut>> & Record<string, AnyFragmentInputBuiltin>, Assume<TFragmentOut, Out>> | (input) => AutoFragmentOut<Assume<TFragmentOut, v4f | AnyAutoCustoms>>; targets?: FragmentOutToTargets<NoInfer>; vertex: TgpuVertexFn<TVertexIn, Assume<TVertexOut, Out>> | (input) => AutoVertexOut<Assume<TVertexOut, AnyAutoCustoms>>; } | { attribs?: TAttribs; fragment?: TgpuFragmentFn<VertexOutToVarying<OmitBuiltins<TVertexOut>> & Record<string, AnyFragmentInputBuiltin>, Record<string, never>> | (input) => undefined; targets?: undefined; vertex: TgpuVertexFn<TVertexIn, Assume<TVertexOut, Out>> | (input) => AutoVertexOut<Assume<TVertexOut, AnyAutoCustoms>>; }