Vulkan-Docs/doc/specs/vulkan/man/VkPipelineRasterizationStateCreateInfo.txt
Jon Leech 85184f305a Change log for August 26, 2016 Vulkan 1.0.25 spec update:
* Bump API patch number and header version number to 25 for this update.
  * Structurally change the specification so that multiple extensions are
    included in the +1.0+ git branch, and specifications will include or not
    include those extensions at build time based on options passed to the
    Makefile. See +doc/specs/vulkan/README.html+ and the ``Layers and
    Extensions'' section of the ``Vulkan Documentation and Extensions''
    document for more information on this change.
  * Register and publish new extensions in the single-branch form:
  ** +VK_NV_external_memory_capabilities+
  ** +VK_NV_external_memory+
  ** +VK_NV_external_memory_win32+
  ** +VK_NV_win32_keyed_mutex+

Github Issues:

  * Clarify description of GetInstanceProcAddr and GetDeviceProcAddr (public
    issue 212).
  * Add SPIR-V <<textures-operation-validation, instruction validation>> for
    single-sampled images (public issue 316).
  * Fix spelling of ``tesselation'' in a few places and note it as an
    exception to the American spelling rules convention (public issue
    327).
  * Fix Makefile to create output directory for ``styleguide''
    target (public issue 329).
  * Fix numerous minor issues with incorrectly tags on enumerant names and
    table titles (public issue 330).
  * Generate specversion.txt date in UTC time and RFC 2822 format
    (public issue 335).
  * Convert link to the SPIR-V Specification for
    flink:VkShaderModuleCreateInfo into an internal link to the normative
    reference (public issue 336).
  * Add ename:VK_ERROR_OUT_OF_MEMORY error code to
    flink:vkCreateDebugReportCallbackEXT (public issue 337).

Internal Issues:

  * Update style guide regarding use of code:NULL and dname:VK_NULL_HANDLE
    (internal issue 393).
  * Change the definition of latexmath:[$q$] in the
    <<textures-image-level-selection,texture image level selection>> section
    to be the index of the maximum defined level for the view, not the
    number of levels in the view (internal issue 406).
  * Allow developers to override dname:VK_DEFINE_NON_DISPATCHABLE_HANDLE
    with their own binary-compatible definition (internal issue 439).
  * Fix +vk_platform.h+ conditional logic causing compile failure with some
    Android compilers (internal issue 441).
  * Implement the single-branch model as described above (internal issue
    461).

Other Issues:
2016-08-28 03:47:19 -07:00

82 lines
3.0 KiB
Plaintext

// Copyright (c) 2014-2016 Khronos Group. This work is licensed under a
// Creative Commons Attribution 4.0 International License; see
// http://creativecommons.org/licenses/by/4.0/
VkPipelineRasterizationStateCreateInfo(3)
=========================================
Name
----
VkPipelineRasterizationStateCreateInfo - Structure specifying parameters of a newly created pipeline rasterization state
C Specification
---------------
// refBegin VkPipelineRasterizationStateCreateInfo - Structure specifying parameters of a newly created pipeline rasterization state
The sname:VkPipelineRasterizationStateCreateInfo structure is defined as:
include::../api/structs/VkPipelineRasterizationStateCreateInfo.txt[]
Members
-------
* pname:sType is the type of this structure.
* pname:pNext is `NULL` or a pointer to an extension-specific structure.
* pname:flags is reserved for future use.
* pname:depthClampEnable controls whether to clamp the fragment's depth
values instead of clipping primitives to the z planes of the frustum, as
described in <<vertexpostproc-clipping,Primitive Clipping>>.
* pname:rasterizerDiscardEnable controls whether primitives are discarded
immediately before the rasterization stage.
* pname:polygonMode is the triangle rendering mode. See
elink:VkPolygonMode.
* pname:cullMode is the triangle facing direction used for primitive
culling. See elink:VkCullModeFlagBits.
* pname:frontFace is the front-facing triangle orientation to be used for
culling. See elink:VkFrontFace.
* pname:depthBiasEnable controls whether to bias fragment depth values.
* pname:depthBiasConstantFactor is a scalar factor controlling the
constant depth value added to each fragment.
* pname:depthBiasClamp is the maximum (or minimum) depth bias of a
fragment.
* pname:depthBiasSlopeFactor is a scalar factor applied to a fragment's
slope in depth bias calculations.
* pname:lineWidth is the width of rasterized line segments.
Description
-----------
ifdef::VK_AMD_rasterization_order[]
The application can: also chain a
sname:VkPipelineRasterizationStateRasterizationOrderAMD structure
to the sname:VkPipelineRasterizationStateCreateInfo structure through
its pname:pNext member. This structure enables selecting the rasterization
order to use when rendering with the corresponding graphics pipeline as
described in <<primrast-order, Rasterization Order>>.
endif::VK_AMD_rasterization_order[]
include::../validity/structs/VkPipelineRasterizationStateCreateInfo.txt[]
See Also
--------
basetype:VkBool32, elink:VkCullModeFlags, elink:VkFrontFace, slink:VkGraphicsPipelineCreateInfo, elink:VkPipelineRasterizationStateCreateFlags, elink:VkPolygonMode, elink:VkStructureType
Document Notes
--------------
For more information, see the Vulkan Specification at URL
https://www.khronos.org/registry/vulkan/specs/1.0/xhtml/vkspec.html#VkPipelineRasterizationStateCreateInfo
This page is extracted from the Vulkan Specification.
Fixes and changes should be made to the Specification,not directly.
include::footer.txt[]