VkPipelineRasterizationLineStateCreateInfo
Line segment rasterization options are controlled by the VkPipelineRasterizationLineStateCreateInfo structure.
The VkPipelineRasterizationLineStateCreateInfo structure is defined
as:
typedef struct VkPipelineRasterizationLineStateCreateInfo {
    VkStructureType sType;
    const void* pNext;
    VkLineRasterizationMode lineRasterizationMode;
    VkBool32 stippledLineEnable;
    uint32_t lineStippleFactor;
    uint16_t lineStipplePattern;
} VkPipelineRasterizationLineStateCreateInfo;
or the equivalent
typedef VkPipelineRasterizationLineStateCreateInfo VkPipelineRasterizationLineStateCreateInfoKHR;
or the equivalent
typedef VkPipelineRasterizationLineStateCreateInfo VkPipelineRasterizationLineStateCreateInfoEXT;
- sTypeis a VkStructureType value identifying this structure.
- pNextis- NULLor a pointer to a structure extending this structure.
- lineRasterizationModeis a VkLineRasterizationMode value selecting the style of line rasterization.
- stippledLineEnableenables stippled line rasterization.
- lineStippleFactoris the repeat factor used in stippled line rasterization.
- lineStipplePatternis the bit pattern used in stippled line rasterization.
If stippledLineEnable is VK_FALSE, the values of
lineStippleFactor and lineStipplePattern are ignored.
Valid Usage
VUID-VkPipelineRasterizationLineStateCreateInfo-lineRasterizationMode-02768
If lineRasterizationMode is
VK_LINE_RASTERIZATION_MODE_RECTANGULAR, then the
rectangularLines feature must be
enabled
VUID-VkPipelineRasterizationLineStateCreateInfo-lineRasterizationMode-02769
If lineRasterizationMode is
VK_LINE_RASTERIZATION_MODE_BRESENHAM, then the
bresenhamLines feature must be
enabled
VUID-VkPipelineRasterizationLineStateCreateInfo-lineRasterizationMode-02770
If lineRasterizationMode is
VK_LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH, then the
smoothLines feature must be enabled
VUID-VkPipelineRasterizationLineStateCreateInfo-stippledLineEnable-02771
If stippledLineEnable is VK_TRUE and
lineRasterizationMode is
VK_LINE_RASTERIZATION_MODE_RECTANGULAR, then the
stippledRectangularLines
feature must be enabled
VUID-VkPipelineRasterizationLineStateCreateInfo-stippledLineEnable-02772
If stippledLineEnable is VK_TRUE and
lineRasterizationMode is
VK_LINE_RASTERIZATION_MODE_BRESENHAM, then the
stippledBresenhamLines
feature must be enabled
VUID-VkPipelineRasterizationLineStateCreateInfo-stippledLineEnable-02773
If stippledLineEnable is VK_TRUE and
lineRasterizationMode is
VK_LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH, then the
stippledSmoothLines feature
must be enabled
VUID-VkPipelineRasterizationLineStateCreateInfo-stippledLineEnable-02774
If stippledLineEnable is VK_TRUE and
lineRasterizationMode is VK_LINE_RASTERIZATION_MODE_DEFAULT,
then the stippledRectangularLines feature must be enabled and
VkPhysicalDeviceLimits::strictLines must be VK_TRUE
Valid Usage (Implicit)
VUID-VkPipelineRasterizationLineStateCreateInfo-sType-sType
sType must be VK_STRUCTURE_TYPE_PIPELINE_RASTERIZATION_LINE_STATE_CREATE_INFO
VUID-VkPipelineRasterizationLineStateCreateInfo-lineRasterizationMode-parameter
lineRasterizationMode must be a valid VkLineRasterizationMode value