# VkPipelineRasterizationLineStateCreateInfoEXT(3) Manual Page

## Name

VkPipelineRasterizationLineStateCreateInfoEXT - Structure specifying parameters of a newly created pipeline line rasterization state

## C Specification

Line segment rasterization options are controlled by the VkPipelineRasterizationLineStateCreateInfoEXT structure.

The `VkPipelineRasterizationLineStateCreateInfoEXT` structure is defined as:

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

## Members

- `sType` is the type of this structure.

- `pNext` is `NULL` or a pointer to an extension-specific structure.

- `lineRasterizationMode` is a VkLineRasterizationModeEXT 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.

## Description

Valid Usage

- If `lineRasterizationMode` is `VK_LINE_RASTERIZATION_MODE_RECTANGULAR_EXT`, then the rectangularLines feature must be enabled

- If `lineRasterizationMode` is `VK_LINE_RASTERIZATION_MODE_BRESENHAM_EXT`, then the bresenhamLines feature must be enabled

- If `lineRasterizationMode` is `VK_LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_EXT`, then the smoothLines feature must be enabled

- If `stippledLineEnable` is `VK_TRUE` and `lineRasterizationMode` is `VK_LINE_RASTERIZATION_MODE_RECTANGULAR_EXT`, then the stippledRectangularLines feature must be enabled

- If `stippledLineEnable` is `VK_TRUE` and `lineRasterizationMode` is `VK_LINE_RASTERIZATION_MODE_BRESENHAM_EXT`, then the stippledBresenhamLines feature must be enabled

- If `stippledLineEnable` is `VK_TRUE` and `lineRasterizationMode` is `VK_LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_EXT`, then the stippledSmoothLines feature must be enabled

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

Valid Usage (Implicit)

- `sType` must be `VK_STRUCTURE_TYPE_PIPELINE_RASTERIZATION_LINE_STATE_CREATE_INFO_EXT`

- `lineRasterizationMode` must be a valid VkLineRasterizationModeEXT value

## See Also

`VkBool32`, VkLineRasterizationModeEXT, VkStructureType

## Document Notes

For more information, see the Vulkan Specification

This page is extracted from the Vulkan Specification. Fixes and changes should be made to the Specification, not directly.

## Copyright

Copyright (c) 2014-2020 Khronos Group. This work is licensed under a Creative Commons Attribution 4.0 International License.