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.pNextisNULLor 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