vulakn教程--Drawing a Triangle--Pipeline--Fixed function

发表于2016-12-05
评论0 1.7k浏览
Fixed functions
      这一章节的内容主要是Pipeline中不可编程部分的配置。

Vertex input
      VkPipelineVertexInputStateCreateInfo 代表我们传递给Vertex Shader 顶点数据的格式,它涉及以下两个方面:
       顶点数据的描述(Bindings) :数据间的间隔,以及判断数据是顶点数据(pre-vertex)还是实例数据(pre-instance)。
      顶点属性的描述(Attribute Descriptions):传入到Vertex Shader 里的属性(attributes)类型,从哪个Binding加载以及offset。
       因为我们把顶点硬编码到Shader Code中了,所以这个结构先赋空值,当我们有需要的时候再回过头来重新审视这个结构。
VkPipelineVertexInputStateCreateInfo vertexInputInfo = {}; 
vertexInputInfo.sType = VK_STRUCTURE_TYPE_PIPELINE_VERTEX_INPUT_STATE_CREATE_INFO; 
vertexInputInfo.vertexBindingDescriptionCount = 0; 
vertexInputInfo.pVertexBindingDescriptions = nullptr; // Optional 
vertexInputInfo.vertexAttributeDescriptionCount = 0; 
vertexInputInfo.pVertexAttributeDescriptions = nullptr; // Optional

Input assembly
VkPipelineInputAssemblyStateCreateInfo 描述了两个内容:我们要画什么样的几何图形和图元顶点是否可以重用(primitive restart should be enabled)。
VkPipelineInputAssemblyStateCreateInfo inputAssembly = {}; 
inputAssembly.sType = VK_STRUCTURE_TYPE_PIPELINE_INPUT_ASSEMBLY_STATE_CREATE_INF
O; 
inputAssembly.topology = VK_PRIMITIVE_TOPOLOGY_TRIANGLE_LIST; 
inputAssembly.primitiveRestartEnable = VK_FALSE;
topology 的可选值有: 
VK_PRIMITIVE_TOPOLOGY_POINT_LIST: 画点 
VK_PRIMITIVE_TOPOLOGY_LINE_LIST: 每两个点为一条线,顶点不能重用 
VK_PRIMITIVE_TOPOLOGY_LINE_STRIP: 一条线的第二个顶点可以作为下一条线的起点(可重用) 
VK_PRIMITIVE_TOPOLOGY_TRIANGLE_LIST: 每三个点一个三角形,顶点不可重用 
VK_PRIMITIVE_TOPOLOGY_TRIANGLE_STRIP: 一个三角形的第三个点可以作为下一个三角形的起点(可重用)
primitiveRestartEnable 与_STRIP有关,先置 FLASE。

Viewports and scissors
       Viewport 其实就是输出结果被渲染到FrameBuffer的多大区域中。它总是从坐标(0,0)点开始,具有一定宽(width)和高(height)的矩形区域。这个区域我们用VkViewport表示:
VkViewport viewport = {}; 
viewport.x = 0.0f; 
viewport.y = 0.0f; 
viewport.width = (float) swapChainExtent.width; 
viewport.height = (float) swapChainExtent.height; 
viewport.minDepth = 0.0f; 
viewport.maxDepth = 1.0f;
        正如在创建swpaChain时所描述的那样,swapChain及其Image的尺寸可能和window的尺寸不同。我们用Swap Chain的 width和height 赋值Viewport, 因为接下来Swap Chain的 images 将作为FrameBuffer使用。Min/maxDepth表示FrameBuffer的深度范围,深度取值在[0.0 , 1.0]范围内,注意,minDepth可能大于maxDepth,如果没有什么特殊需要,我们将按照标准的定义, 即:minDepth=0 , maxDepth=1.0 。
       Viewport 定义了image 到 FrameBuffer的变换,而Scissor 矩形框决定哪些区域的像素将会被存储,在Scissor矩形框外的像素将会在光栅化(像素化)阶段被丢弃。所以,比起变换,Scissor 更像是一个过滤器。如图:


     这里我们想画整个FrameBuffer ,所以我们这样定义Scissor :
VkRect2D scissor = {}; 
scissor.offset = {0, 0}; 
scissor.extent = swapChainExtent;
     这里我们用到了VkRect2D 结构:
typedef struct VkRect2D { 
    VkOffset2D offset; 
    VkExtent2D extent; 
} VkRect2D;
VkOffset2D 结构:
typedef struct VkOffset2D { 
    int32_t x; 
    int32_t y; 
} VkOffset2D;
VkExtent2D 结构:
typedef struct VkExtent2D { 
    uint32_t width; 
    uint32_t height; 
}VkExtent2D;
       现在我们需要将Viewport和Scissor 结合起来,把他们运用到Pipeline的Viewport 状态(viewport state)中:
VkPipelineViewportStateCreateInfo viewportState = {};
viewportState.sType = VK_STRUCTURE_TYPE_PIPELINE_VIEWPORT_STATE_CREATE_INFO;
viewportState.viewportCount = 1;
viewportState.pViewports = &viewport;
viewportState.scissorCount = 1;
viewportState.pScissors = &scissor;
       注意,从VkPipelineViewportStateCreateInfo的结构上来看,在某些显卡上,我们可以使用多个Viewport和多个Scissor ,这涉及到显卡的支持,在我们创建Logicsl Device时,VkPhysicalDeviceFeatures 字段里有 VkBool32 multiViewport;的定义,你可以检查自己的显卡是否支持这个特性。

Rasterizer
     光栅化(我个人更喜欢像素化这个称呼),它把来自Vertex Shader 操作后顶点组成的几何图形离散化成一个个片原(fragment),然后将片原传递到Fragment Shader 里进行着色。光栅化也执行depth testing、face culling 和 scissor test。你可以配置,选择是将整个多边形离散化成片原,还是只离散化边框(edges)(又叫 : wireframe rending),我们通过如下结构来进行设置:
VkPipelineRasterizationStateCreateInfo rasterizer = {};
rasterizer.sType = VK_STRUCTURE_TYPE_PIPELINE_RASTERIZATION_STATE_CREATE_INFO;
rasterizer.depthClampEnable = VK_FALSE;
rasterizer.rasterizerDiscardEnable = VK_FALSE
 depthClampEnable 如果设置成VK_TRUE,那些在视景体近平面(near)和远平面(far)之外的片原将会被拉紧/截取?(clamped 什么意思??),而不是丢弃,这在有些情况下很有用,但需要显卡特性支持。
      rasterizerDiscardEnable 如果为VK_TRUE, 几何数据(geometry)将无法通过Rasterization阶段,FrameBuffer 将得不到任何输出数据。
rasterizer.polygonMode = VK_POLYGON_MODE_FILL;
polygonMode 表示我们将从几何图形中产生生么样的片原(fragments),它的取值有以下几种:
VK_POLYGON_MODE_FILL: 填充整个多边形区域的片原 
VK_POLYGON_MODE_LINE: 只有多边形边界(edges)的片原 
VK_POLYGON_MODE_POINT: 只画多边形顶点
   这里我们要画三角形区域,所以采用VK_POLYGON_MODE_FILL。
1terizer.lineWidth = 1.0f; //线条粗细
/*  卷绕方式与背面裁剪
  规定裁剪那个面:前面和背面,从摄像机的角度看,顶点按逆时针组成的图形
  是正面,顺时背面。正反面的卷绕方式可以自定义。
*/
rasterizer.cullMode = VK_CULL_MODE_BACK_BIT; 
rasterizer.frontFace = VK_FRONT_FACE_CLOCKWISE;
cullMode 表示裁剪方式 ,结构: 
“` 
typedef enum VkCullModeFlagBits { 
VK_CULL_MODE_NONE = 0, 
VK_CULL_MODE_FRONT_BIT = 0x00000001, 
VK_CULL_MODE_BACK_BIT = 0x00000002, 
VK_CULL_MODE_FRONT_AND_BACK = 0x00000003, 
} VkCullModeFlagBits;
>frontFace 表示正面的卷绕方式 ,结构:
>```
>typedef enum VkFrontFace { 
    VK_FRONT_FACE_COUNTER_CLOCKWISE = 0, 
    VK_FRONT_FACE_CLOCKWISE = 1, 
} VkFrontFace;
rasterizer.depthBiasEnable = VK_FALSE; 
rasterizer.depthBiasConstantFactor = 0.0f; // Optional 
rasterizer.depthBiasClamp = 0.0f; // Optional 
rasterizer.depthBiasSlopeFactor = 0.0f; // Optional
     光栅化可以改变深度值,我们暂时不使用这些选项。

Multisampling
     多重采样可以执行防锯齿的功能,在我们的应用中不需要使用,你可以查看文档去了解:
VkPipelineMultisampleStateCreateInfo multisampling = {}; 
multisampling.sType = VK_STRUCTURE_TYPE_PIPELINE_MULTISAMPLE_STATE_CREATE_INFO; 
multisampling.sampleShadingEnable = VK_FALSE; 
multisampling.rasterizationSamples = VK_SAMPLE_COUNT_1_BIT; multisampling.minSampleShading = 1.0f; // Optional 
multisampling.pSampleMask = nullptr; /// Optional 
multisampling.alphaToCoverageEnable = VK_FALSE; // Optional
multisampling.alphaToOneEnable = VK_FALSE; // Optional
Depth and stencil testing
      如果我们使用depth和stencil buffer就要配置VkPipelineDepthStencilStateCreateInfo 参数,我们目前还没有使用它,当用到的时候我们在回过头来拜访它,现在值空即可。

Color blending
        Fagment Shader 输出的颜色结果要和FrameBuffer中已有的颜色整合到一起,这里有两种方式:
       混合(mix) 新颜色和旧颜色来产生最终的颜色。
       将新颜色和旧颜色通过按位运算(bitwise)整合在一起。
       为了完成颜色混合,我们需要填充两个结构体: VkPipelineColorBlendAttachmentState 对每一个FrameBuffer进行配置(per attached framebuffer)VkPipelineColorBlendStateCreateInfo对全局的颜色( global color)混合进行设置。在我们的应用中只有一个FrameBuffer。 
     先看一下 VkPipelineColorBlendAttachmentState :
typedef struct VkPipelineColorBlendAttachmentState {
    VkBool32 blendEnable;
    VkBlendFactor srcColorBlendFactor;
    VkBlendFactor dstColorBlendFactor;
    VkBlendOp colorBlendOp;
    VkBlendFactor srcAlphaBlendFactor;
    VkBlendFactor dstAlphaBlendFactor;
    VkBlendOp alphaBlendOp;
    VkColorComponentFlags colorWriteMask;
} VkPipelineColorBlendAttachmentState;
其中的 VkBlendFactor 结构:
typedef enum VkBlendFactor {
    VK_BLEND_FACTOR_ZERO = 0,
    VK_BLEND_FACTOR_ONE = 1,
    VK_BLEND_FACTOR_SRC_COLOR = 2,
    VK_BLEND_FACTOR_SRC_ALPHA = 6,
    ...
} VkBlendFactor;
VkBlendOp 结构
typedef enum VkBlendOp {
    VK_BLEND_OP_ADD = 0,
    VK_BLEND_OP_SUBTRACT = 1,
    VK_BLEND_OP_REVERSE_SUBTRACT = 2,
    VK_BLEND_OP_MIN = 3,
    VK_BLEND_OP_MAX = 4,
    ...
} VkBlendOp;
配置 VkPipelineColorBlendAttachmentState :
VkPipelineColorBlendAttachmentState colorBlendAttachment = {};
colorBlendAttachment.colorWriteMask = VK_COLOR_COMPONENT_R_BIT | VK_COLOR_COMPONENT_G_BIT | VK_COLOR_COMPONENT_B_BIT | VK_COLOR_COMPONENT_A_BIT; 
colorBlendAttachment.blendEnable = VK_FALSE; 
//Optional 
colorBlendAttachment.srcColorBlendFactor = VK_BLEND_FACTOR_ONE;
//Optional 
colorBlendAttachment.dstColorBlendFactor = VK_BLEND_FACTOR_ZERO; 
// Optional
colorBlendAttachment.colorBlendOp = VK_BLEND_OP_ADD; 
//Optional 
colorBlendAttachment.srcAlphaBlendFactor = VK_BLEND_FACTOR_ONE; 
//Optional  
colorBlendAttachment.dstAlphaBlendFactor = VK_BLEND_FACTOR_ZERO; 
colorBlendAttachment.alphaBlendOp = VK_BLEND_OP_ADD; // Optional
下面的伪代码显示了处理过程:
if (blendEnable) {
    finalColor.rgb = (srcColorBlendFactor * newColor.rgb)     (dstColorBlendFactor * oldColor.rgb);
    finalColor.a = (srcAlphaBlendFactor * newColor.a)     (dstAlphaBlendFactor * oldColor.a);
} else {
    finalColor = newColor;
}
finalColor = finalColor & colorWriteMask; //保留何种通道
我们更常用的可能是Alpha通道的混合:
colorBlendAttachment.blendEnable = VK_TRUE;
colorBlendAttachment.srcColorBlendFactor = VK_BLEND_FACTOR_SRC_ALPHA;
colorBlendAttachment.dstColorBlendFactor = VK_BLEND_FACTOR_ONE_MINUS_SRC_ALPHA;
colorBlendAttachment.colorBlendOp = VK_BLEND_OP_ADD;
colorBlendAttachment.srcAlphaBlendFactor = VK_BLEND_FACTOR_ONE;
colorBlendAttachment.dstAlphaBlendFactor = VK_BLEND_FACTOR_ZERO;
colorBlendAttachment.alphaBlendOp = VK_BLEND_OP_ADD;
伪代码:
finalColor.rgb = newAlpha * newColor + (1 - newAlpha) * oldColor; 
finalColor.a = newAlpha.a;
第二个配置结构 VkPipelineColorBlendStateCreateInfo :
typedef struct VkPipelineColorBlendStateCreateInfo {
    VkStructureType sType;
    const void* pNext;
    VkPipelineColorBlendStateCreateFlags flags;
    VkBool32 logicOpEnable;
    VkLogicOp logicOp;
    uint32_t attachmentCount;
    const VkPipelineColorBlendAttachmentState* pAttachments;
    float blendConstants[4];
} VkPipelineColorBlendStateCreateInfo;
VkLogicOp 结构:
typedef enum VkLogicOp {
    VK_LOGIC_OP_CLEAR = 0,
    VK_LOGIC_OP_AND = 1,
    VK_LOGIC_OP_AND_REVERSE = 2,
    VK_LOGIC_OP_COPY = 3,
    VK_LOGIC_OP_AND_INVERTED = 4,
    VK_LOGIC_OP_NO_OP = 5,
    VK_LOGIC_OP_XOR = 6,
    VK_LOGIC_OP_COPY_INVERTED = 12,
    VK_LOGIC_OP_OR_INVERTED = 13,
    ...
} VkLogicOp;
填充 VkPipelineColorBlendStateCreateInfo :
VkPipelineColorBlendStateCreateInfo colorBlending = {};
colorBlending.sType = VK_STRUCTURE_TYPE_PIPELINE_COLOR_BLEND_STATE_CREATE_INFO;
colorBlending.logicOpEnable = VK_FALSE;
colorBlending.logicOp = VK_LOGIC_OP_COPY; // Optional
colorBlending.attachmentCount = 1;
colorBlending.pAttachments = &colorBlendAttachment;
colorBlending.blendConstants[0] = 0.0f; // Optional 
colorBlending.blendConstants[1] = 0.0f; // Optional 
colorBlending.blendConstants[2] = 0.0f; // Optional 
colorBlending.blendConstants[3] = 0.0f; // Optional
        如果我们要使用第二种混合方式,即按位混合(bitewise combination), logicOpEnable就要设置成VK_TRUE,然后新旧颜色就按照logicOp中的操作类型按位进行运算,但此时,我们在第一种结构中设置的混合方式将不起作用,如同blendEnable设置成VK_FALSE一样,但是colorWriteMask 任然会被第二种方式使用。当然我们可能对这两种混合方式都不感冒,正如我们上面说做的那样:全部设置为VK_FALSE,表示fragment 中的颜色将直接写入FrameBuffer中。

Dynamic state
      当目前为止,以上我们为Pipeline 设置的属性,有一部分设置可以在不重建Pipeline的情况下被改变,比如:Viewport的大小,lineWidth 和 blend Constrants等。 通过VkDynamicsSate 我们可以知道可以改变那些东西:
typedef enum VkDynamicState {
    VK_DYNAMIC_STATE_VIEWPORT = 0,
    VK_DYNAMIC_STATE_SCISSOR = 1,
    VK_DYNAMIC_STATE_LINE_WIDTH = 2,
    VK_DYNAMIC_STATE_DEPTH_BIAS = 3,
    VK_DYNAMIC_STATE_BLEND_CONSTANTS = 4,
    VK_DYNAMIC_STATE_DEPTH_BOUNDS = 5,
    VK_DYNAMIC_STATE_STENCIL_COMPARE_MASK = 6,
    VK_DYNAMIC_STATE_STENCIL_WRITE_MASK = 7,
    VK_DYNAMIC_STATE_STENCIL_REFERENCE = 8,
} VkDynamicState
      如果要在绘制阶段改变一些设置,我们需要填写如下结构:
VkDynamicState dynamicStates[] = {
    VK_DYNAMIC_STATE_VIEWPORT,
    VK_DYNAMIC_STATE_LINE_WIDTH
};
VkPipelineDynamicStateCreateInfo dynamicState = {};
dynamicState.dynamicStateCount = 2;
dynamicState.pDynamicStates = dynamicStates;
       如果我们确实这么做了,那之前对这些属性的设置都将无效,在绘画阶段就会要求我们给出这些属性的具体设置。

Pipeline layout
       Uniform 全局变量如同我们之前介绍的Pipeline的可变部分一样,它们的改变不会导致Pipeline的重建。我们可以通过在绘画阶段改变这些uniform变量从而改变着色器(Shaders)的行为。最常用的情况就是传递给Vertex Shader 一个转换矩阵(Matrix),或者在Fragment Shader 中创建取样器(Samplers)。
      我们需要使用VkPipelineLayout 结构来来声明Uniform 变量,这个过程必须在Pipeline创建阶段完成。 我们目前还不需要uniform 变量,这里写一空结构:
VDeleter pipelineLayout {device, vkDestroyPipelineLayout}; // ÉùÃ÷
VkPipelineLayoutCreateInfo pipelineLayoutInfo = {};
pipelineLayoutInfo.sType = VK_STRUCTURE_TYPE_PIPELINE_LAYOUT_CREATE_INFO;
pipelineLayoutInfo.setLayoutCount = 0; // Optional 
pipelineLayoutInfo.pSetLayouts = nullptr; // Optional 
pipelineLayoutInfo.pushConstantRangeCount = 0; // Optional 
pipelineLayoutInfo.pPushConstantRanges = 0; // Optional
if (vkCreatePipelineLayout(device, &pipelineLayoutInfo, nullptr, &pipelineLayout) != VK_SUCCESS) {
    throw std::runtime_error("failed to create pipeline layout!");
}
原文源码 : Source code

如社区发表内容存在侵权行为,您可以点击这里查看侵权投诉指引