Structures

VkPipelineRasterizationLineStateCreateInfoKHR

Structure specifying parameters of a newly created pipeline line rasterization state

Line segment rasterization options are controlled by the VkPipelineRasterizationLineStateCreateInfoKHR structure.

The VkPipelineRasterizationLineStateCreateInfoKHR structure is defined as:

typedef struct VkPipelineRasterizationLineStateCreateInfoKHR {
    VkStructureType sType;
    const void* pNext;
    VkLineRasterizationModeKHR lineRasterizationMode;
    VkBool32 stippledLineEnable;
    uint32_t lineStippleFactor;
    uint16_t lineStipplePattern;
} VkPipelineRasterizationLineStateCreateInfoKHR;

or the equivalent

typedef VkPipelineRasterizationLineStateCreateInfoKHR VkPipelineRasterizationLineStateCreateInfoEXT;
  • sType is a VkStructureType value identifying this structure.
  • pNext is NULL or a pointer to a structure extending this structure.
  • lineRasterizationMode is a VkLineRasterizationModeKHR value selecting the style of line rasterization.
  • stippledLineEnable enables stippled line rasterization.
  • lineStippleFactor is the repeat factor used in stippled line rasterization.
  • lineStipplePattern is the bit pattern used in stippled line rasterization.

If stippledLineEnable is VK_FALSE, the values of lineStippleFactor and lineStipplePattern are ignored.

Valid Usage

VUID-VkPipelineRasterizationLineStateCreateInfoKHR-lineRasterizationMode-02768

If lineRasterizationMode is VK_LINE_RASTERIZATION_MODE_RECTANGULAR_KHR, then the rectangularLines feature must be enabled

VUID-VkPipelineRasterizationLineStateCreateInfoKHR-lineRasterizationMode-02769

If lineRasterizationMode is VK_LINE_RASTERIZATION_MODE_BRESENHAM_KHR, then the bresenhamLines feature must be enabled

VUID-VkPipelineRasterizationLineStateCreateInfoKHR-lineRasterizationMode-02770

If lineRasterizationMode is VK_LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_KHR, then the smoothLines feature must be enabled

VUID-VkPipelineRasterizationLineStateCreateInfoKHR-stippledLineEnable-02771

If stippledLineEnable is VK_TRUE and lineRasterizationMode is VK_LINE_RASTERIZATION_MODE_RECTANGULAR_KHR, then the stippledRectangularLines feature must be enabled

VUID-VkPipelineRasterizationLineStateCreateInfoKHR-stippledLineEnable-02772

If stippledLineEnable is VK_TRUE and lineRasterizationMode is VK_LINE_RASTERIZATION_MODE_BRESENHAM_KHR, then the stippledBresenhamLines feature must be enabled

VUID-VkPipelineRasterizationLineStateCreateInfoKHR-stippledLineEnable-02773

If stippledLineEnable is VK_TRUE and lineRasterizationMode is VK_LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_KHR, then the stippledSmoothLines feature must be enabled

VUID-VkPipelineRasterizationLineStateCreateInfoKHR-stippledLineEnable-02774

If stippledLineEnable is VK_TRUE and lineRasterizationMode is VK_LINE_RASTERIZATION_MODE_DEFAULT_KHR, then the stippledRectangularLines feature must be enabled and VkPhysicalDeviceLimits::strictLines must be VK_TRUE

Valid Usage (Implicit)

VUID-VkPipelineRasterizationLineStateCreateInfoKHR-sType-sType

sType must be VK_STRUCTURE_TYPE_PIPELINE_RASTERIZATION_LINE_STATE_CREATE_INFO_KHR