音视频专辑OpenGL+Metal图像处理

《Metal》官方文档翻译007--图形渲染：渲染命令编码器（下

2017-10-20  本文已影响59人  张芳涛

执行固定功能渲染命令编码器操作

使用这些MTLRenderCommandEncoder方法设置固定功能图形状态值：

使用以下MTLRenderCommandEncoder方法对固定功能状态更改命令进行编码：

使用视口和像素坐标系

Metal将其归一化设备坐标（NDC）系统定义为2x2x1立方体，其中心位于（0,0,0.5）。NDC系统的x和y的左侧和底部分别指定为-1。NDC系统的x和y的右侧和顶部分别指定为+1。

视口指定从NDC到窗口坐标的转换。Metal视口是由setViewport:方法指定的3D变换MTLRenderCommandEncoder。窗口坐标的起点在左上角。在Metal中，像素中心偏移（0.5,0.5）。例如，原点的像素的中心为（0.5,0.5）; 右边相邻像素的中心是（1.5,0.5）。纹理也是如此。

执行深度和模板操作

深度和模板操作是您指定的碎片操作，如下所示：

1：指定MTLDepthStencilDescriptor包含深度/模板状态设置的自定义对象。创建自定义MTLDepthStencilDescriptor对象可能需要创建一个或两个MTLStencilDescriptor适用于前面的图元和背面图元的对象。

2：MTLDepthStencilState通过调用深度/模板状态描述符的newDepthStencilStateWithDescriptor:方法来创建一个对象MTLDevice。

3：要设置深度/模板状态，调用setDepthStencilState:的方法MTLRenderCommandEncoder与MTLDepthStencilState。

4：如果模板测试正在使用中，请调用setStencilReferenceValue:以指定模板参考值。

如果启用了深度测试，则渲染流水线状态必须包含深度附件以支持写入深度值。要执行模板测试，渲染流水线状态必须包括模板附件。要配置附件，请参阅创建和配置渲染流水线描述符。

如果您将定期更改深度/模板状态，则可能需要重新使用状态描述符对象，根据需要修改其属性值以创建更多的状态对象。

注意： 要从着色器函数中的深度格式纹理进行采样，请在着色器中实现采样操作而不使用MTLSamplerState。

使用MTLDepthStencilDescriptor对象的属性设置深度和模板状态：

不需要显式禁用模板状态。Metal决定是否启用模板测试，基于模板描述符是否配置为有效的模板操作。

清单5-13显示了创建和使用MTLDepthStencilDescriptor对象创建对象的示例，MTLDepthStencilState然后将其与render命令编码器一起使用。在这个例子中，前端基元的模板状态是从frontFaceStencil深度/模板状态描述符的属性中进行访问的。对于背面原语，模板测试被明确禁用。

清单5-13 创建和使用深度/模板描述符

MTLDepthStencilDescriptor *dsDesc = [[MTLDepthStencilDescriptor alloc] init];
if (dsDesc == nil)
 exit(1);   //  if the descriptor could not be allocated
dsDesc.depthCompareFunction = MTLCompareFunctionLess;
dsDesc.depthWriteEnabled = YES;

dsDesc.frontFaceStencil.stencilCompareFunction = MTLCompareFunctionEqual;
dsDesc.frontFaceStencil.stencilFailureOperation = MTLStencilOperationKeep;
dsDesc.frontFaceStencil.depthFailureOperation = 
MTLStencilOperationIncrementClamp;
dsDesc.frontFaceStencil.depthStencilPassOperation =
                      MTLStencilOperationIncrementClamp;
dsDesc.frontFaceStencil.readMask = 0x1;
dsDesc.frontFaceStencil.writeMask = 0x1;
dsDesc.backFaceStencil = nil;
id <MTLDepthStencilState> dsState = [device
                      newDepthStencilStateWithDescriptor:dsDesc];

[renderEnc setDepthStencilState:dsState];
[renderEnc setStencilReferenceValue:0xFF];

以下属性定义了模板测试MTLStencilDescriptor：

绘制几何图元

在建立管道状态和固定功能状态后，可以调用以下MTLRenderCommandEncoder方法绘制几何图元。这些绘制方法引用资源（如包含顶点坐标，纹理坐标，曲面法线和其他数据的缓冲区）来执行与之前建立的着色器功能和其他状态的管道MTLRenderCommandEncoder。

对于上面列出的每个原始渲染方法，第一个输入值使用其中一个值确定原始类型MTLPrimitiveType。其他输入值确定哪些顶点用于组合图元。对于所有这些方法，instanceStart输入值决定了绘制的第一个实例，instanceCount输入值决定了绘制多少个实例。

如前所述，setTriangleFillMode:确定三角形是否被渲染为填充或线框，setCullMode:并且setFrontFacingWinding:设置确定GPU是否在渲染期间剔除三角形。有关更多信息，请参阅固定功能状态操作）。

渲染点基元时，顶点函数的着色器语言代码必须提供[[ point_size ]]属性，或者点大小未定义。

当渲染具有平坦阴影的三角形原语时，第一个顶点的属性（也称为激发顶点）用于整个三角形。顶点函数的着色器语言代码必须提供[[ flat ]]插值限定符。

有关所有Metal着色语言属性和限定词的详细信息，请参阅“ Metal着色语言指南”。

结束渲染通行证

要终止渲染遍，请调用endEncoding渲染命令编码器。在结束上一个命令编码器之后，您可以创建任何类型的新命令编码器，以将其他命令编码到命令缓冲区中。

代码示例：绘制三角形

清单5-14所示的以下步骤描述了渲染三角形的基本过程。

1：创建一个MTLCommandQueue并使用它创建一个MTLCommandBuffer。

2：创建一个MTLRenderPassDescriptor指定用作命令缓冲区中编码渲染命令的目的地的附件集合。

在此示例中，仅设置和使用第一个颜色附件。（currentTexture假定变量包含一个MTLTexture用于颜色附件的变量。）然后MTLRenderPassDescriptor用于创建一个新的MTLRenderCommandEncoder。

3：创建两个MTLBuffer对象，posBuf并且colBuf，和呼叫newBufferWithBytes:length:options:复制顶点坐标和顶点颜色数据，posData和colData分别，到缓冲存储器。

4：调用两次setVertexBuffer:offset:atIndex:方法MTLRenderCommandEncoder来指定坐标和颜色。

该方法的atIndex输入值setVertexBuffer:offset:atIndex:对应于buffer(atIndex)顶点函数的源代码中的属性。

5：MTLRenderPipelineDescriptor在流水线描述符中创建并建立顶点和碎片函数：

6：创建一个MTLRenderPipelineState从MTLRenderPipelineDescriptor调用newRenderPipelineStateWithDescriptor:error:或类似的方法MTLDevice。然后setRenderPipelineState:的方法MTLRenderCommandEncoder使用创建流水线状态进行渲染。

7：调用附加命令的drawPrimitives:vertexStart:vertexCount:方法MTLRenderCommandEncoder来执行填充三角形（类型MTLPrimitiveTypeTriangle）的渲染。

8：调用该endEncoding方法来结束此渲染过程的编码。并调用commit的方法MTLCommandBuffer，以在设备上执行的命令。

清单5-14 绘制三角形的Metal代码

id <MTLDevice> device = MTLCreateSystemDefaultDevice();

id <MTLCommandQueue> commandQueue = [device newCommandQueue];
id <MTLCommandBuffer> commandBuffer = [commandQueue commandBuffer];

MTLRenderPassDescriptor *renderPassDesc
                           = [MTLRenderPassDescriptor renderPassDescriptor];
renderPassDesc.colorAttachments[0].texture = currentTexture;
renderPassDesc.colorAttachments[0].loadAction = MTLLoadActionClear;
renderPassDesc.colorAttachments[0].clearColor = MTLClearColorMake(0.0,1.0,1.0,1.0);
id <MTLRenderCommandEncoder> renderEncoder =
        [commandBuffer renderCommandEncoderWithDescriptor:renderPassDesc];

static const float posData[] = {
    0.0f, 0.33f, 0.0f, 1.f,
    -0.33f, -0.33f, 0.0f, 1.f,
    0.33f, -0.33f, 0.0f, 1.f,
};
static const float colData[] = {
    1.f, 0.f, 0.f, 1.f,
    0.f, 1.f, 0.f, 1.f,
    0.f, 0.f, 1.f, 1.f,
};
id <MTLBuffer> posBuf = [device newBufferWithBytes:posData
    length:sizeof(posData) options:nil];
id <MTLBuffer> colBuf = [device newBufferWithBytes:colorData
    length:sizeof(colData) options:nil];
[renderEncoder setVertexBuffer:posBuf offset:0 atIndex:0];
[renderEncoder setVertexBuffer:colBuf offset:0 atIndex:1];

NSError *errors;
id <MTLLibrary> library = [device newLibraryWithSource:progSrc options:nil
                       error:&errors];
id <MTLFunction> vertFunc = [library newFunctionWithName:@"hello_vertex"];
id <MTLFunction> fragFunc = [library newFunctionWithName:@"hello_fragment"];
MTLRenderPipelineDescriptor *renderPipelineDesc
                               = [[MTLRenderPipelineDescriptor alloc] init];
renderPipelineDesc.vertexFunction = vertFunc;
renderPipelineDesc.fragmentFunction = fragFunc;
renderPipelineDesc.colorAttachments[0].pixelFormat = currentTexture.pixelFormat;
id <MTLRenderPipelineState> pipeline = [device
         
newRenderPipelineStateWithDescriptor:renderPipelineDesc error:&errors];
[renderEncoder setRenderPipelineState:pipeline];
[renderEncoder drawPrimitives:MTLPrimitiveTypeTriangle
           vertexStart:0 vertexCount:3];
[renderEncoder endEncoding];
[commandBuffer commit];

在清单5-14中，一个MTLFunction对象代表着名的着色器函数hello_vertex。该setVertexBuffer:offset:atIndex:方法MTLRenderCommandEncoder用于指定作为参数传递的顶点资源（在这种情况下为两个缓冲区对象）hello_vertex。方法的atIndex输入值setVertexBuffer:offset:atIndex:对应于buffer(atIndex)顶点函数的源代码中的属性，如清单5-15所示。

清单5-15 相应的着色器功能声明

vertex VertexOutput hello_vertex(

const global float4 *pos_data [[ buffer(0) ]],

const global float4 *color_data [[ buffer(1) ]])

{

...

}

使用多个线程编码单个渲染通过

在某些情况下，您的应用程序的性能可能受到单个渲染通过的编码命令的单CPU工作负载的限制。然而，通过将工作负载分割为多个CPU线程上编码的多个渲染通道来尝试规避此瓶颈也可能不利地影响性能，因为每个渲染传递都需要自己的中间附件存储和加载操作来保留渲染目标内容。

而是使用一个MTLParallelRenderCommandEncoder对象来管理MTLRenderCommandEncoder共享相同命令缓冲区并渲染传递描述符的多个下级对象。并行渲染命令编码器确保附件加载和存储动作仅在整个渲染遍的开始和结束时发生，而不是在每个从属渲染命令编码器的命令集的开始和结束。使用这种架构，您可以MTLRenderCommandEncoder以安全和高性能的方式并行分配每个对象到其自己的线程。

要创建并行渲染命令编码器，请使用对象的parallelRenderCommandEncoderWithDescriptor:方法MTLCommandBuffer。要创建从属渲染命令编码器，请从要执行命令编码的每个CPU线程调用该对象的renderCommandEncoder方法MTLParallelRenderCommandEncoder一次。由相同的并行渲染命令编码器创建的所有下级命令编码器将命令编码到相同的命令缓冲区。命令按照创建渲染命令编码器的顺序编码到命令缓冲区。要结束对特定渲染命令编码器的编码，请调用其endEncoding方法MTLRenderCommandEncoder。你已经结束了对并行渲染指令编码器创建的所有渲染指令编码器编码后，调用endEncoding的方法MTLParallelRenderCommandEncoder来结束渲染通道。

清单5-16显示了MTLParallelRenderCommandEncoder创建三个MTLRenderCommandEncoder对象：rCE1，rCE2，和rCE3。

清单5-16 具有三个渲染命令编码器的并行渲染编码器

MTLRenderPassDescriptor *renderPassDesc 
                 = [MTLRenderPassDescriptor renderPassDescriptor];
renderPassDesc.colorAttachments[0].texture = currentTexture;
renderPassDesc.colorAttachments[0].loadAction = MTLLoadActionClear;
renderPassDesc.colorAttachments[0].clearColor = MTLClearColorMake(0.0,0.0,0.0,1.0);

id <MTLParallelRenderCommandEncoder> parallelRCE = [commandBuffer 
              parallelRenderCommandEncoderWithDescriptor:renderPassDesc];
id <MTLRenderCommandEncoder> rCE1 = [parallelRCE renderCommandEncoder];
id <MTLRenderCommandEncoder> rCE2 = [parallelRCE renderCommandEncoder];
id <MTLRenderCommandEncoder> rCE3 = [parallelRCE renderCommandEncoder];

//  not shown: rCE1, rCE2, and rCE3 call methods to encode graphics commands
//
//  rCE1 commands are processed first, because it was created first
//  even though rCE2 and rCE3 end earlier than rCE1
[rCE2 endEncoding];
[rCE3 endEncoding];
[rCE1 endEncoding];

 //  all MTLRenderCommandEncoders must end before 
 MTLParallelRenderCommandEncoder
[parallelRCE endEncoding];

命令编码器调用endEncoding的顺序与命令编码和附加到的顺序无关MTLCommandBuffer。因为MTLParallelRenderCommandEncoder，MTLCommandBuffer始终包含按照下面的渲染命令编码器创建顺序的命令，如图5-6所示。

图5-6 平行渲染通过中渲染命令编码器的顺序

下一页
上一页

上一篇下一篇

猜你喜欢

热点阅读