GPUDevice: метод createPipelineLayout()

Метод createPipelineLayout() интерфейса GPUDevice создаёт GPUPipelineLayout, определяющий GPUBindGroupLayout, используемые в конвейере. GPUBindGroup, используемые с конвейером во время кодирования команд, должны иметь совместимые GPUBindGroupLayout.

descriptor

Объект, содержащий следующие свойства:

bindGroupLayouts

Массив объектов GPUBindGroupLayout (которые в свою очередь создаются с помощью вызовов GPUDevice.createBindGroupLayout()). Каждый соответствует атрибуту @group в коде шейдера, содержащемся в GPUShaderModule, используемом в связанном конвейере.

label Необязательно

Строка, предоставляющая метку, которая может использоваться для идентификации объекта, например, в сообщениях GPUError или предупреждениях консоли.

Экземпляр объекта GPUPipelineLayout.

При вызове createPipelineLayout() должны быть соблюдены следующие критерии, в противном случае генерируется GPUValidationError, и возвращается невалидный объект GPUPipelineLayout:

• Объекты GPUBindGroupLayout в bindGroupLayouts должны быть валидными.
• Количество объектов GPUBindGroupLayout в bindGroupLayouts должно быть меньше, чем предел maxBindGroups GPUDevice ограничение.

Следующий фрагмент:

• Создаёт GPUBindGroupLayout, описывающий связывание с буфером, текстурой и сапплером.
• Создаёт GPUPipelineLayout, основанный на GPUBindGroupLayout.

// ...

const bindGroupLayout = device.createBindGroupLayout({
  entries: [
    {
      binding: 0,
      visibility: GPUShaderStage.VERTEX | GPUShaderStage.FRAGMENT,
      buffer: {},
    },
    {
      binding: 1,
      visibility: GPUShaderStage.FRAGMENT,
      texture: {},
    },
    {
      binding: 2,
      visibility: GPUShaderStage.FRAGMENT,
      sampler: {},
    },
  ],
});

const pipelineLayout = device.createPipelineLayout({
  bindGroupLayouts: [bindGroupLayout],
});

// ...

• API WebGPU