Structures

VkPipelineRasterizationLineStateCreateInfo

Structure specifying parameters of a newly created pipeline line rasterization state

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;
  • sType is a VkStructureType value identifying this structure.
  • pNext is NULL or a pointer to a structure extending this structure.
  • lineRasterizationMode is a VkLineRasterizationMode 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-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