Safe Haskell	Safe-Inferred
Language	Haskell2010

Vulkan.Extensions.VK_EXT_line_rasterization

Description

Name

VK_EXT_line_rasterization - device extension

VK_EXT_line_rasterization

Name String: VK_EXT_line_rasterization

Extension Type

Device extension

Registered Extension Number

260

Revision

1

Ratification Status

Not ratified

Extension and Version Dependencies

VK_KHR_get_physical_device_properties2 or Version 1.1

Special Use

CAD support

Contact

Jeff Bolz @jeffbolznv%0A*Here describe the issue or question you have about the VK_EXT_line_rasterization extension*

Other Extension Metadata

Last Modified Date: 2019-05-09

IP Status

No known IP claims.

Contributors

Jeff Bolz, NVIDIA
Allen Jensen, NVIDIA
Faith Ekstrand, Intel

Description

This extension adds some line rasterization features that are commonly used in CAD applications and supported in other APIs like OpenGL. Bresenham-style line rasterization is supported, smooth rectangular lines (coverage to alpha) are supported, and stippled lines are supported for all three line rasterization modes.

New Commands

cmdSetLineStippleEXT

New Structures

Extending PhysicalDeviceFeatures2, DeviceCreateInfo:
- PhysicalDeviceLineRasterizationFeaturesEXT

Extending PhysicalDeviceProperties2:
- PhysicalDeviceLineRasterizationPropertiesEXT
Extending PipelineRasterizationStateCreateInfo:
- PipelineRasterizationLineStateCreateInfoEXT

New Enums

LineRasterizationModeEXT

New Enum Constants

EXT_LINE_RASTERIZATION_EXTENSION_NAME

Issues

1) Do we need to support Bresenham-style and smooth lines with more than one rasterization sample? i.e. the equivalent of glDisable(GL_MULTISAMPLE) in OpenGL when the framebuffer has more than one sample?

RESOLVED: Yes. For simplicity, Bresenham line rasterization carries forward a few restrictions from OpenGL, such as not supporting per-sample shading, alpha to coverage, or alpha to one.

Version History

Revision 1, 2019-05-09 (Jeff Bolz)
- Initial draft

Document Notes

For more information, see the Vulkan Specification

This page is a generated document. Fixes and changes should be made to the generator scripts, not directly.

Synopsis

cmdSetLineStippleEXT :: forall io. MonadIO io => CommandBuffer -> ("lineStippleFactor" ::: Word32) -> ("lineStipplePattern" ::: Word16) -> io ()
data PhysicalDeviceLineRasterizationFeaturesEXT = PhysicalDeviceLineRasterizationFeaturesEXT {
- rectangularLines :: Bool
- bresenhamLines :: Bool
- smoothLines :: Bool
- stippledRectangularLines :: Bool
- stippledBresenhamLines :: Bool
- stippledSmoothLines :: Bool
}
data PhysicalDeviceLineRasterizationPropertiesEXT = PhysicalDeviceLineRasterizationPropertiesEXT {
- lineSubPixelPrecisionBits :: Word32
}
data PipelineRasterizationLineStateCreateInfoEXT = PipelineRasterizationLineStateCreateInfoEXT {
}
newtype LineRasterizationModeEXT where
- LineRasterizationModeEXT Int32
- pattern LINE_RASTERIZATION_MODE_DEFAULT_EXT :: LineRasterizationModeEXT
- pattern LINE_RASTERIZATION_MODE_RECTANGULAR_EXT :: LineRasterizationModeEXT
- pattern LINE_RASTERIZATION_MODE_BRESENHAM_EXT :: LineRasterizationModeEXT
- pattern LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_EXT :: LineRasterizationModeEXT
type EXT_LINE_RASTERIZATION_SPEC_VERSION = 1
pattern EXT_LINE_RASTERIZATION_SPEC_VERSION :: forall a. Integral a => a
type EXT_LINE_RASTERIZATION_EXTENSION_NAME = "VK_EXT_line_rasterization"
pattern EXT_LINE_RASTERIZATION_EXTENSION_NAME :: forall a. (Eq a, IsString a) => a

Documentation

cmdSetLineStippleEXT Source #

Arguments

:: forall io. MonadIO io
=> CommandBuffer	`commandBuffer` is the command buffer into which the command will be recorded.
-> ("lineStippleFactor" ::: Word32)	`lineStippleFactor` is the repeat factor used in stippled line rasterization.
-> ("lineStipplePattern" ::: Word16)	`lineStipplePattern` is the bit pattern used in stippled line rasterization.
-> io ()

vkCmdSetLineStippleEXT - Set line stipple dynamically for a command buffer

Description

This command sets the line stipple state for subsequent drawing commands when drawing using shader objects, or when the graphics pipeline is created with DYNAMIC_STATE_LINE_STIPPLE_EXT set in PipelineDynamicStateCreateInfo::pDynamicStates. Otherwise, this state is specified by the PipelineRasterizationLineStateCreateInfoEXT::lineStippleFactor and PipelineRasterizationLineStateCreateInfoEXT::lineStipplePattern values used to create the currently active pipeline.

Valid Usage

lineStippleFactor must be in the range [1,256]

Valid Usage (Implicit)

commandBuffer must be a valid CommandBuffer handle

commandBuffer must be in the recording state
The CommandPool that commandBuffer was allocated from must support graphics operations
This command must only be called outside of a video coding scope

Host Synchronization

Host access to commandBuffer must be externally synchronized

Host access to the CommandPool that commandBuffer was allocated from must be externally synchronized

Command Properties

'

Command Buffer Levels	Render Pass Scope	Video Coding Scope	Supported Queue Types	Command Type
Primary Secondary	Both	Outside	Graphics	State

Members

This structure describes the following features:

Description

If the PhysicalDeviceLineRasterizationFeaturesEXT structure is included in the pNext chain of the PhysicalDeviceFeatures2 structure passed to getPhysicalDeviceFeatures2, it is filled in to indicate whether each corresponding feature is supported. PhysicalDeviceLineRasterizationFeaturesEXT can also be used in the pNext chain of DeviceCreateInfo to selectively enable these features.

Valid Usage (Implicit)

Description

If the PhysicalDeviceLineRasterizationPropertiesEXT structure is included in the pNext chain of the PhysicalDeviceProperties2 structure passed to getPhysicalDeviceProperties2, it is filled in with each corresponding implementation-dependent property.

Valid Usage (Implicit)

Description

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

Valid Usage

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

If lineRasterizationMode is LINE_RASTERIZATION_MODE_BRESENHAM_EXT, then the bresenhamLines feature must be enabled
If lineRasterizationMode is LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_EXT, then the smoothLines feature must be enabled
If stippledLineEnable is TRUE and lineRasterizationMode is LINE_RASTERIZATION_MODE_RECTANGULAR_EXT, then the stippledRectangularLines feature must be enabled
If stippledLineEnable is TRUE and lineRasterizationMode is LINE_RASTERIZATION_MODE_BRESENHAM_EXT, then the stippledBresenhamLines feature must be enabled
If stippledLineEnable is TRUE and lineRasterizationMode is LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_EXT, then the stippledSmoothLines feature must be enabled
If stippledLineEnable is TRUE and lineRasterizationMode is LINE_RASTERIZATION_MODE_DEFAULT_EXT, then the stippledRectangularLines feature must be enabled and PhysicalDeviceLimits::strictLines must be TRUE

Valid Usage (Implicit)

sType must be STRUCTURE_TYPE_PIPELINE_RASTERIZATION_LINE_STATE_CREATE_INFO_EXT

lineRasterizationMode must be a valid LineRasterizationModeEXT value

Storable PhysicalDeviceLineRasterizationFeaturesEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_line_rasterization Methods sizeOf :: PhysicalDeviceLineRasterizationFeaturesEXT -> Int # alignment :: PhysicalDeviceLineRasterizationFeaturesEXT -> Int # peekElemOff :: Ptr PhysicalDeviceLineRasterizationFeaturesEXT -> Int -> IO PhysicalDeviceLineRasterizationFeaturesEXT # pokeElemOff :: Ptr PhysicalDeviceLineRasterizationFeaturesEXT -> Int -> PhysicalDeviceLineRasterizationFeaturesEXT -> IO () # peekByteOff :: Ptr b -> Int -> IO PhysicalDeviceLineRasterizationFeaturesEXT # pokeByteOff :: Ptr b -> Int -> PhysicalDeviceLineRasterizationFeaturesEXT -> IO () # peek :: Ptr PhysicalDeviceLineRasterizationFeaturesEXT -> IO PhysicalDeviceLineRasterizationFeaturesEXT # poke :: Ptr PhysicalDeviceLineRasterizationFeaturesEXT -> PhysicalDeviceLineRasterizationFeaturesEXT -> IO () #
Show PhysicalDeviceLineRasterizationFeaturesEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_line_rasterization Methods showsPrec :: Int -> PhysicalDeviceLineRasterizationFeaturesEXT -> ShowS # show :: PhysicalDeviceLineRasterizationFeaturesEXT -> String # showList :: [PhysicalDeviceLineRasterizationFeaturesEXT] -> ShowS #
Eq PhysicalDeviceLineRasterizationFeaturesEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_line_rasterization Methods (==) :: PhysicalDeviceLineRasterizationFeaturesEXT -> PhysicalDeviceLineRasterizationFeaturesEXT -> Bool # (/=) :: PhysicalDeviceLineRasterizationFeaturesEXT -> PhysicalDeviceLineRasterizationFeaturesEXT -> Bool #
FromCStruct PhysicalDeviceLineRasterizationFeaturesEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_line_rasterization Methods peekCStruct :: Ptr PhysicalDeviceLineRasterizationFeaturesEXT -> IO PhysicalDeviceLineRasterizationFeaturesEXT Source #
ToCStruct PhysicalDeviceLineRasterizationFeaturesEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_line_rasterization Methods withCStruct :: PhysicalDeviceLineRasterizationFeaturesEXT -> (Ptr PhysicalDeviceLineRasterizationFeaturesEXT -> IO b) -> IO b Source # pokeCStruct :: Ptr PhysicalDeviceLineRasterizationFeaturesEXT -> PhysicalDeviceLineRasterizationFeaturesEXT -> IO b -> IO b Source # withZeroCStruct :: (Ptr PhysicalDeviceLineRasterizationFeaturesEXT -> IO b) -> IO b Source # pokeZeroCStruct :: Ptr PhysicalDeviceLineRasterizationFeaturesEXT -> IO b -> IO b Source # cStructSize :: Int Source # cStructAlignment :: Int Source #
Zero PhysicalDeviceLineRasterizationFeaturesEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_line_rasterization Methods zero :: PhysicalDeviceLineRasterizationFeaturesEXT Source #

Storable PhysicalDeviceLineRasterizationPropertiesEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_line_rasterization Methods sizeOf :: PhysicalDeviceLineRasterizationPropertiesEXT -> Int # alignment :: PhysicalDeviceLineRasterizationPropertiesEXT -> Int # peekElemOff :: Ptr PhysicalDeviceLineRasterizationPropertiesEXT -> Int -> IO PhysicalDeviceLineRasterizationPropertiesEXT # pokeElemOff :: Ptr PhysicalDeviceLineRasterizationPropertiesEXT -> Int -> PhysicalDeviceLineRasterizationPropertiesEXT -> IO () # peekByteOff :: Ptr b -> Int -> IO PhysicalDeviceLineRasterizationPropertiesEXT # pokeByteOff :: Ptr b -> Int -> PhysicalDeviceLineRasterizationPropertiesEXT -> IO () # peek :: Ptr PhysicalDeviceLineRasterizationPropertiesEXT -> IO PhysicalDeviceLineRasterizationPropertiesEXT # poke :: Ptr PhysicalDeviceLineRasterizationPropertiesEXT -> PhysicalDeviceLineRasterizationPropertiesEXT -> IO () #
Show PhysicalDeviceLineRasterizationPropertiesEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_line_rasterization Methods showsPrec :: Int -> PhysicalDeviceLineRasterizationPropertiesEXT -> ShowS # show :: PhysicalDeviceLineRasterizationPropertiesEXT -> String # showList :: [PhysicalDeviceLineRasterizationPropertiesEXT] -> ShowS #
Eq PhysicalDeviceLineRasterizationPropertiesEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_line_rasterization Methods (==) :: PhysicalDeviceLineRasterizationPropertiesEXT -> PhysicalDeviceLineRasterizationPropertiesEXT -> Bool # (/=) :: PhysicalDeviceLineRasterizationPropertiesEXT -> PhysicalDeviceLineRasterizationPropertiesEXT -> Bool #
FromCStruct PhysicalDeviceLineRasterizationPropertiesEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_line_rasterization Methods peekCStruct :: Ptr PhysicalDeviceLineRasterizationPropertiesEXT -> IO PhysicalDeviceLineRasterizationPropertiesEXT Source #
ToCStruct PhysicalDeviceLineRasterizationPropertiesEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_line_rasterization Methods withCStruct :: PhysicalDeviceLineRasterizationPropertiesEXT -> (Ptr PhysicalDeviceLineRasterizationPropertiesEXT -> IO b) -> IO b Source # pokeCStruct :: Ptr PhysicalDeviceLineRasterizationPropertiesEXT -> PhysicalDeviceLineRasterizationPropertiesEXT -> IO b -> IO b Source # withZeroCStruct :: (Ptr PhysicalDeviceLineRasterizationPropertiesEXT -> IO b) -> IO b Source # pokeZeroCStruct :: Ptr PhysicalDeviceLineRasterizationPropertiesEXT -> IO b -> IO b Source # cStructSize :: Int Source # cStructAlignment :: Int Source #
Zero PhysicalDeviceLineRasterizationPropertiesEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_line_rasterization Methods zero :: PhysicalDeviceLineRasterizationPropertiesEXT Source #

Storable PipelineRasterizationLineStateCreateInfoEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_line_rasterization Methods sizeOf :: PipelineRasterizationLineStateCreateInfoEXT -> Int # alignment :: PipelineRasterizationLineStateCreateInfoEXT -> Int # peekElemOff :: Ptr PipelineRasterizationLineStateCreateInfoEXT -> Int -> IO PipelineRasterizationLineStateCreateInfoEXT # pokeElemOff :: Ptr PipelineRasterizationLineStateCreateInfoEXT -> Int -> PipelineRasterizationLineStateCreateInfoEXT -> IO () # peekByteOff :: Ptr b -> Int -> IO PipelineRasterizationLineStateCreateInfoEXT # pokeByteOff :: Ptr b -> Int -> PipelineRasterizationLineStateCreateInfoEXT -> IO () # peek :: Ptr PipelineRasterizationLineStateCreateInfoEXT -> IO PipelineRasterizationLineStateCreateInfoEXT # poke :: Ptr PipelineRasterizationLineStateCreateInfoEXT -> PipelineRasterizationLineStateCreateInfoEXT -> IO () #
Show PipelineRasterizationLineStateCreateInfoEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_line_rasterization Methods showsPrec :: Int -> PipelineRasterizationLineStateCreateInfoEXT -> ShowS # show :: PipelineRasterizationLineStateCreateInfoEXT -> String # showList :: [PipelineRasterizationLineStateCreateInfoEXT] -> ShowS #
Eq PipelineRasterizationLineStateCreateInfoEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_line_rasterization Methods (==) :: PipelineRasterizationLineStateCreateInfoEXT -> PipelineRasterizationLineStateCreateInfoEXT -> Bool # (/=) :: PipelineRasterizationLineStateCreateInfoEXT -> PipelineRasterizationLineStateCreateInfoEXT -> Bool #
FromCStruct PipelineRasterizationLineStateCreateInfoEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_line_rasterization Methods peekCStruct :: Ptr PipelineRasterizationLineStateCreateInfoEXT -> IO PipelineRasterizationLineStateCreateInfoEXT Source #
ToCStruct PipelineRasterizationLineStateCreateInfoEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_line_rasterization Methods withCStruct :: PipelineRasterizationLineStateCreateInfoEXT -> (Ptr PipelineRasterizationLineStateCreateInfoEXT -> IO b) -> IO b Source # pokeCStruct :: Ptr PipelineRasterizationLineStateCreateInfoEXT -> PipelineRasterizationLineStateCreateInfoEXT -> IO b -> IO b Source # withZeroCStruct :: (Ptr PipelineRasterizationLineStateCreateInfoEXT -> IO b) -> IO b Source # pokeZeroCStruct :: Ptr PipelineRasterizationLineStateCreateInfoEXT -> IO b -> IO b Source # cStructSize :: Int Source # cStructAlignment :: Int Source #
Zero PipelineRasterizationLineStateCreateInfoEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_line_rasterization Methods zero :: PipelineRasterizationLineStateCreateInfoEXT Source #

Storable LineRasterizationModeEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_line_rasterization Methods sizeOf :: LineRasterizationModeEXT -> Int # alignment :: LineRasterizationModeEXT -> Int # peekElemOff :: Ptr LineRasterizationModeEXT -> Int -> IO LineRasterizationModeEXT # pokeElemOff :: Ptr LineRasterizationModeEXT -> Int -> LineRasterizationModeEXT -> IO () # peekByteOff :: Ptr b -> Int -> IO LineRasterizationModeEXT # pokeByteOff :: Ptr b -> Int -> LineRasterizationModeEXT -> IO () # peek :: Ptr LineRasterizationModeEXT -> IO LineRasterizationModeEXT # poke :: Ptr LineRasterizationModeEXT -> LineRasterizationModeEXT -> IO () #
Read LineRasterizationModeEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_line_rasterization Methods readsPrec :: Int -> ReadS LineRasterizationModeEXT # readList :: ReadS [LineRasterizationModeEXT] # readPrec :: ReadPrec LineRasterizationModeEXT # readListPrec :: ReadPrec [LineRasterizationModeEXT] #
Show LineRasterizationModeEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_line_rasterization Methods showsPrec :: Int -> LineRasterizationModeEXT -> ShowS # show :: LineRasterizationModeEXT -> String # showList :: [LineRasterizationModeEXT] -> ShowS #
Eq LineRasterizationModeEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_line_rasterization Methods (==) :: LineRasterizationModeEXT -> LineRasterizationModeEXT -> Bool # (/=) :: LineRasterizationModeEXT -> LineRasterizationModeEXT -> Bool #
Ord LineRasterizationModeEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_line_rasterization Methods compare :: LineRasterizationModeEXT -> LineRasterizationModeEXT -> Ordering # (<) :: LineRasterizationModeEXT -> LineRasterizationModeEXT -> Bool # (<=) :: LineRasterizationModeEXT -> LineRasterizationModeEXT -> Bool # (>) :: LineRasterizationModeEXT -> LineRasterizationModeEXT -> Bool # (>=) :: LineRasterizationModeEXT -> LineRasterizationModeEXT -> Bool # max :: LineRasterizationModeEXT -> LineRasterizationModeEXT -> LineRasterizationModeEXT # min :: LineRasterizationModeEXT -> LineRasterizationModeEXT -> LineRasterizationModeEXT #
Zero LineRasterizationModeEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_line_rasterization Methods zero :: LineRasterizationModeEXT Source #

Name

VK_EXT_line_rasterization

Other Extension Metadata

Description

New Commands

New Structures

New Enums

New Enum Constants

Issues

Version History

See Also

Document Notes

Documentation

Description

Valid Usage

Valid Usage (Implicit)

Host Synchronization

Command Properties

See Also

Members

Description

Valid Usage (Implicit)

See Also

Instances

Description

Valid Usage (Implicit)

See Also

Instances

Description

Valid Usage

Valid Usage (Implicit)

See Also

Instances

See Also

Instances

PhysicalDeviceLineRasterizationPropertiesEXT
Fields lineSubPixelPrecisionBits :: Word32 `lineSubPixelPrecisionBits` is the number of bits of subpixel precision in framebuffer coordinates xf and yf when rasterizing line segments.

pattern LINE_RASTERIZATION_MODE_DEFAULT_EXT :: LineRasterizationModeEXT	`LINE_RASTERIZATION_MODE_DEFAULT_EXT` is equivalent to `LINE_RASTERIZATION_MODE_RECTANGULAR_EXT` if `PhysicalDeviceLimits`::`strictLines` is `TRUE`, otherwise lines are drawn as non-`strictLines` parallelograms. Both of these modes are defined in Basic Line Segment Rasterization.
pattern LINE_RASTERIZATION_MODE_RECTANGULAR_EXT :: LineRasterizationModeEXT	`LINE_RASTERIZATION_MODE_RECTANGULAR_EXT` specifies lines drawn as if they were rectangles extruded from the line
pattern LINE_RASTERIZATION_MODE_BRESENHAM_EXT :: LineRasterizationModeEXT	`LINE_RASTERIZATION_MODE_BRESENHAM_EXT` specifies lines drawn by determining which pixel diamonds the line intersects and exits, as defined in Bresenham Line Segment Rasterization.
pattern LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_EXT :: LineRasterizationModeEXT	`LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_EXT` specifies lines drawn if they were rectangles extruded from the line, with alpha falloff, as defined in Smooth Lines.