GPUDevice: метод createRenderPipelineAsync()

Метод createRenderPipelineAsync() интерфейса GPUDevice возвращает Promise, который выполняется с GPURenderPipeline, который может контролировать этапы шейдеров вершин и фрагментов и использоваться в GPURenderPassEncoder или GPURenderBundleEncoder, как только конвейер можно использовать без задержек.

descriptor

См. определение дескриптора для метода GPUDevice.createRenderPipeline().

Promise, который выполняется с экземпляром объекта GPURenderPipeline, когда созданный конвейер готов к использованию без дополнительных задержек.

Если создание конвейера завершится ошибкой, и созданный конвейер окажется недействительным, возвращённое обещание отклонится с GPUPipelineError:

• Если это внутренняя ошибка, у GPUPipelineError будет reason значение "internal".
• Если это ошибка валидации, у GPUPipelineError будет reason значение "validation".

Ошибка валидации может возникнуть, если любое из следующих условий ложно:

• Для объектов depthStencil:
  • format — это формат depth-or-stencil.
  • Свойства depthBias, depthBiasClamp и depthBiasSlopeScale установлены в значения 0 для линий и точек, т. е. если topology установлено в значения "line-list", "line-strip", или "point-list".
  • Если depthWriteEnabled — true или depthCompare не равно "always", у format есть глубинная составляющая.
  • Если свойства stencilFront или stencilBack не соответствуют значениям по умолчанию, у format есть составляющая глубины.
• Для объектов fragment:
  • targets.length меньше или равно maxColorAttachments GPUDevice пределу.
  • Для каждого target, численное значение writeMask меньше или равно 16.
  • Если любая из операций смешения использует альфа-канал источника (например, "src-alpha-saturated"), у результата есть альфа-канал (то есть это должен быть vec4).
  • Если свойство entryPoint опущено, код шейдера содержит единственную функцию точки входа для фрагментного шейдера, которую браузер использует в качестве функции точки входа по умолчанию.
• Для объектов primitive :
  • Если используется свойство unclippedDepth , то depth-clip-control функция включена.
• Для объектов vertex :
  • Если свойство entryPoint опущено, код шейдера содержит единственную функцию точки входа для вершинного шейдера, которую браузер использует в качестве функции точки входа по умолчанию.

В следующем примере показан базовый пример построения объекта дескриптора конвейера рендеринга, который затем используется для создания GPURenderPipeline с помощью вызова createRenderPipelineAsync().

async function init() {
  // ...

  const vertexBuffers = [
    {
      attributes: [
        {
          shaderLocation: 0, // position
          offset: 0,
          format: "float32x4",
        },
        {
          shaderLocation: 1, // color
          offset: 16,
          format: "float32x4",
        },
      ],
      arrayStride: 32,
      stepMode: "vertex",
    },
  ];

  const pipelineDescriptor = {
    vertex: {
      module: shaderModule,
      entryPoint: "vertex_main",
      buffers: vertexBuffers,
    },
    fragment: {
      module: shaderModule,
      entryPoint: "fragment_main",
      targets: [
        {
          format: navigator.gpu.getPreferredCanvasFormat(),
        },
      ],
    },
    primitive: {
      topology: "triangle-list",
    },
    layout: "auto",
  };

  const renderPipeline =
    await device.createRenderPipelineAsync(pipelineDescriptor);

  // ...
}

• API WebGPU