Add GPUPipelineBase.getBindGroupLayout.

Kangz · Kangz · commit aee44b1e6769 · 2020-01-15T16:02:51.000+01:00
diff --git a/spec/index.bs b/spec/index.bs
@@ -1590,6 +1590,10 @@ Pipelines {#pipelines}
 dictionary GPUPipelineDescriptorBase : GPUObjectDescriptorBase {
     required GPUPipelineLayout layout;
 };
+
+interface mixin GPUPipelineBase {
+    GPUBindGroupLayout getBindGroupLayout(unsigned long index);
+};
 </script>
 
 <script type=idl>
@@ -1607,6 +1611,7 @@ dictionary GPUProgrammableStageDescriptor {
 interface GPUComputePipeline {
 };
 GPUComputePipeline includes GPUObjectBase;
+GPUComputePipeline includes GPUPipelineBase;
 </script>
 
 ### Creation ### {#compute-pipeline-creation}
@@ -1624,6 +1629,7 @@ dictionary GPUComputePipelineDescriptor : GPUPipelineDescriptorBase {
 interface GPURenderPipeline {
 };
 GPURenderPipeline includes GPUObjectBase;
+GPURenderPipeline includes GPUPipelineBase;
 </script>
 
 ### Creation ### {#render-pipeline-creation}
@@ -1894,6 +1900,111 @@ dictionary GPUVertexAttributeDescriptor {
 };
 </script>
 
+## {{GPUPipelineBase/getBindGroupLayout()|getBindGroupLayout}} ## {#get-bind-group-layout}
+
+<dl dfn-type="method" dfn-for="GPUPipelineBase">
+    : <dfn>getBindGroupLayout(unsigned long index)</dfn>
+    ::
+        <div algorithm="GPUProgrammablePipeline.getBindGroupLayout(unsigned long index)">
+            1. If |index| is greater or equal to {{GPULimits/maxBindGroups}} :
+
+                1. Throw a {{RangeError}}.
+
+            1. If |this|.getBindGroupLayout has already been called with |index|:
+
+                1. Return the same object.
+
+            1. If |this| is an error:
+
+                1. Return an error {{GPUBindGroupLayout}}.
+
+            1. Let |bindings| be an empty sequence.
+            1. For each {{GPUProgrammableStageDescriptor}} |stage| in the descriptor for |this|:
+
+                1. For each resource |resource| in |stage|.{{GPUProgrammableStageDescriptor/module}}
+                    for the |stage|.{{GPUProgrammableStageDescriptor/entryPoint}} entry-point:
+
+                    1. If |resource|'s "group" decoration is not equal to |index|:
+
+                        1. Continue to the next loop iteration over resources.
+
+                    1. Let |binding| be a new {{GPUBindGroupLayoutBinding}}.
+                    1. Set |binding|.{{GPUBindGroupLayoutBinding/binding}} to |resource|'s "binding"
+                        decoration.
+                    1. Set |binding|.{{GPUBindGroupLayoutBinding/visibility}} to
+                        {{GPUShaderStage/VERTEX}} | {{GPUShaderStage/FRAGMENT}} |
+                        {{GPUShaderStage/COMPUTE}}.
+
+                        Issue: Have a set of all valid {{GPUShaderStage}} on the device.
+
+                    1. If |resource| is for a sampler binding:
+
+                            1. Set |binding|.{{GPUBindGroupLayoutBinding/type}} to
+                                {{GPUBindingType/sampler}}.
+
+                    1. If |resource| is for a buffer binding:
+
+                        1. If |resource| is for a uniform buffer:
+
+                            1. Set |binding|.{{GPUBindGroupLayoutBinding/type}} to
+                                {{GPUBindingType/uniform-buffer}}.
+
+                        1. If |resource| is for a storage buffer:
+
+                            1. If |resource| is read-only:
+
+                                1. Set |binding|.{{GPUBindGroupLayoutBinding/type}} to
+                                    {{GPUBindingType/readonly-storage-buffer}}.
+
+                            1. Else:
+
+                                1. Set |binding|.{{GPUBindGroupLayoutBinding/type}} to
+                                    {{GPUBindingType/storage-buffer}}.
+                                1. Set |binding|.{{GPUBindGroupLayoutBinding/visibility}} to
+                                    {{GPUShaderStage/FRAGMENT}} | {{GPUShaderStage/COMPUTE}}.
+
+                    1. If |resource| is for a texture binding:
+
+                        1. Set |binding|.{{GPUBindGroupLayoutBinding/textureComponentType}} to
+                            |resource|'s component type.
+                        1. Set |binding|.{{GPUBindGroupLayoutBinding/textureDimension}} to
+                            |resource|'s dimension.
+                        1. If |resource| is multisampled:
+
+                            1. Set |binding|.{{GPUBindGroupLayoutBinding/multisampled}} to true.
+
+                        1. If |resource| is for a sampled texture:
+
+                            1. Set |binding|.{{GPUBindGroupLayoutBinding/type}} to
+                                {{GPUBindingType/sampled-texture}}.
+
+                        1. If |resource| is for a storage texture:
+
+                            1. Set |binding|.{{GPUBindGroupLayoutBinding/type}} to
+                                {{GPUBindingType/storage-texture}}.
+                            1. Set |binding|.{{GPUBindGroupLayoutBinding/visibility}} to
+                                {{GPUShaderStage/FRAGMENT}} | {{GPUShaderStage/COMPUTE}}.
+
+                    1. Append |binding| to |bindings|
+
+            1. For each |b1| in |bindings|:
+
+                1. For each |b2| in |bindings| with |b2|.{{GPUBindGroupLayoutBinding/binding}}
+                    equal to |b1|.{{GPUBindGroupLayoutBinding/binding}}:
+
+                    1. If |b1| is not equal to |b2| by value:
+
+                        1. Return an error {{GPUBindGroupLayout}}.
+
+            1. Let |descriptor| be a new {{GPUBindGroupLayoutDescriptor}}.
+            1. Set |descriptor|.{{GPUBindGroupLayoutDescriptor/bindings}} to |bindings|.
+            1. Let |device| be |this|'s {{GPUDevice}}.
+            1. Let |layout| be the return value of calling |device|.{{GPUDevice/createBindGroupLayout()|createBindGroupLayout}}(|descriptor|).
+            1. Return |layout|.
+
+        </div>
+</dl>
+
 Command Buffers {#command-buffers}
 ==================================
 
