Function createRenderPipeline

src/renderers/rendererUtils.ts:126–180

(device: GPUDevice, config: RenderPipelineConfig)

 * - `multisample.count: 1`
 */
export function createRenderPipeline(device: GPUDevice, config: RenderPipelineConfig): GPURenderPipeline {
  const layout: GPUPipelineLayout | 'auto' =
    config.layout ??
    (config.bindGroupLayouts ? device.createPipelineLayout({ bindGroupLayouts: [...config.bindGroupLayouts] }) : 'auto');

  const vertexStage = getStageModule(device, config.vertex);
  const vertexEntryPoint = vertexStage.entryPoint || DEFAULT_VERTEX_ENTRY;

  let fragment: GPUFragmentState | undefined = undefined;
  if (config.fragment) {
    const fragmentStage = getStageModule(device, config.fragment);
    const fragmentEntryPoint = fragmentStage.entryPoint || DEFAULT_FRAGMENT_ENTRY;

    let targets: readonly GPUColorTargetState[] | undefined = config.fragment.targets;
    if (!targets) {
      const formats = config.fragment.formats;
      if (!formats) {
        throw new Error(
          "createRenderPipeline(fragment): provide either `fragment.targets` or `fragment.formats` when a fragment stage is present."
        );
      }
      const formatList = Array.isArray(formats) ? formats : [formats];
      targets = formatList.map((format) => ({
        format,
        blend: config.fragment!.blend,
        writeMask: config.fragment!.writeMask,
      }));
    }

    fragment = {
      module: fragmentStage.module,
      entryPoint: fragmentEntryPoint,
      targets: [...targets],
      constants: fragmentStage.constants,
    };
  }

  const primitive: GPUPrimitiveState = config.primitive ?? { topology: 'triangle-list' };
  const multisample: GPUMultisampleState = config.multisample ?? { count: 1 };

  return device.createRenderPipeline({
    label: config.label,
    layout,
    vertex: {
      module: vertexStage.module,
      entryPoint: vertexEntryPoint,
      buffers: config.vertex.buffers ? [...config.vertex.buffers] : [],
      constants: vertexStage.constants,
    },
    fragment,
    primitive,
    depthStencil: config.depthStencil,
    multisample,
  });
}

/**
 * Creates a uniform buffer suitable for `@group/@binding` uniform bindings.