Package org.lwjgl.vulkan

Class EXTLineRasterization

java.lang.Object

org.lwjgl.vulkan.EXTLineRasterization

public class EXTLineRasterization
extends Object

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.

VK_EXT_line_rasterization

Name String

VK_EXT_line_rasterization

Extension Type

Device extension

Registered Extension Number

260

Revision

1

Extension and Version Dependencies

VK_KHR_get_physical_device_properties2 or Version 1.1

Special Use

• CAD support

Contact

• Jeff Bolz jeffbolznv

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

Field Summary

Fields

Modifier and Type	Field	Description
static final int	VK_DYNAMIC_STATE_LINE_STIPPLE_EXT	Extends VkDynamicState.
static final String	VK_EXT_LINE_RASTERIZATION_EXTENSION_NAME	The extension name.
static final int	VK_EXT_LINE_RASTERIZATION_SPEC_VERSION	The extension specification version.
static final int	VK_LINE_RASTERIZATION_MODE_BRESENHAM_EXT	VkLineRasterizationModeEXT - Line rasterization modes
static final int	VK_LINE_RASTERIZATION_MODE_DEFAULT_EXT	VkLineRasterizationModeEXT - Line rasterization modes
static final int	VK_LINE_RASTERIZATION_MODE_RECTANGULAR_EXT	VkLineRasterizationModeEXT - Line rasterization modes
static final int	VK_LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_EXT	VkLineRasterizationModeEXT - Line rasterization modes
static final int	VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_LINE_RASTERIZATION_FEATURES_EXT	Extends VkStructureType.
static final int	VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_LINE_RASTERIZATION_PROPERTIES_EXT	Extends VkStructureType.
static final int	VK_STRUCTURE_TYPE_PIPELINE_RASTERIZATION_LINE_STATE_CREATE_INFO_EXT	Extends VkStructureType.

Method Summary

Modifier and Type	Method	Description
static void	vkCmdSetLineStippleEXT(VkCommandBuffer commandBuffer, int lineStippleFactor, short lineStipplePattern)	Set line stipple dynamically for a command buffer.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

VK_EXT_LINE_RASTERIZATION_SPEC_VERSION

public static final int VK_EXT_LINE_RASTERIZATION_SPEC_VERSION

The extension specification version.

See Also:

• Constant Field Values

VK_EXT_LINE_RASTERIZATION_EXTENSION_NAME

public static final String VK_EXT_LINE_RASTERIZATION_EXTENSION_NAME

The extension name.

See Also:

• Constant Field Values

VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_LINE_RASTERIZATION_FEATURES_EXT

public static final int VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_LINE_RASTERIZATION_FEATURES_EXT

Extends VkStructureType.

Enum values:

• STRUCTURE_TYPE_PHYSICAL_DEVICE_LINE_RASTERIZATION_FEATURES_EXT
• STRUCTURE_TYPE_PIPELINE_RASTERIZATION_LINE_STATE_CREATE_INFO_EXT
• STRUCTURE_TYPE_PHYSICAL_DEVICE_LINE_RASTERIZATION_PROPERTIES_EXT

See Also:

• Constant Field Values

VK_STRUCTURE_TYPE_PIPELINE_RASTERIZATION_LINE_STATE_CREATE_INFO_EXT

public static final int VK_STRUCTURE_TYPE_PIPELINE_RASTERIZATION_LINE_STATE_CREATE_INFO_EXT

Extends VkStructureType.

Enum values:

• STRUCTURE_TYPE_PHYSICAL_DEVICE_LINE_RASTERIZATION_FEATURES_EXT
• STRUCTURE_TYPE_PIPELINE_RASTERIZATION_LINE_STATE_CREATE_INFO_EXT
• STRUCTURE_TYPE_PHYSICAL_DEVICE_LINE_RASTERIZATION_PROPERTIES_EXT

See Also:

• Constant Field Values

VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_LINE_RASTERIZATION_PROPERTIES_EXT

public static final int VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_LINE_RASTERIZATION_PROPERTIES_EXT

Extends VkStructureType.

Enum values:

• STRUCTURE_TYPE_PHYSICAL_DEVICE_LINE_RASTERIZATION_FEATURES_EXT
• STRUCTURE_TYPE_PIPELINE_RASTERIZATION_LINE_STATE_CREATE_INFO_EXT
• STRUCTURE_TYPE_PHYSICAL_DEVICE_LINE_RASTERIZATION_PROPERTIES_EXT

See Also:

• Constant Field Values

VK_DYNAMIC_STATE_LINE_STIPPLE_EXT

public static final int VK_DYNAMIC_STATE_LINE_STIPPLE_EXT

Extends VkDynamicState.

See Also:

• Constant Field Values

VK_LINE_RASTERIZATION_MODE_DEFAULT_EXT

public static final int VK_LINE_RASTERIZATION_MODE_DEFAULT_EXT

VkLineRasterizationModeEXT - Line rasterization modes

Description

• LINE_RASTERIZATION_MODE_DEFAULT_EXT is equivalent to LINE_RASTERIZATION_MODE_RECTANGULAR_EXT if VkPhysicalDeviceLimits::strictLines is TRUE, otherwise lines are drawn as non-strictLines parallelograms. Both of these modes are defined in Basic Line Segment Rasterization.
• LINE_RASTERIZATION_MODE_RECTANGULAR_EXT specifies lines drawn as if they were rectangles extruded from the line
• 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.
• 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.

See Also

VkPipelineRasterizationLineStateCreateInfoEXT, CmdSetLineRasterizationModeEXT

See Also:

• Constant Field Values

VK_LINE_RASTERIZATION_MODE_RECTANGULAR_EXT

public static final int VK_LINE_RASTERIZATION_MODE_RECTANGULAR_EXT

VkLineRasterizationModeEXT - Line rasterization modes

Description

• LINE_RASTERIZATION_MODE_DEFAULT_EXT is equivalent to LINE_RASTERIZATION_MODE_RECTANGULAR_EXT if VkPhysicalDeviceLimits::strictLines is TRUE, otherwise lines are drawn as non-strictLines parallelograms. Both of these modes are defined in Basic Line Segment Rasterization.
• LINE_RASTERIZATION_MODE_RECTANGULAR_EXT specifies lines drawn as if they were rectangles extruded from the line
• 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.
• 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.

See Also

VkPipelineRasterizationLineStateCreateInfoEXT, CmdSetLineRasterizationModeEXT

See Also:

• Constant Field Values

VK_LINE_RASTERIZATION_MODE_BRESENHAM_EXT

public static final int VK_LINE_RASTERIZATION_MODE_BRESENHAM_EXT

VkLineRasterizationModeEXT - Line rasterization modes

Description

• LINE_RASTERIZATION_MODE_DEFAULT_EXT is equivalent to LINE_RASTERIZATION_MODE_RECTANGULAR_EXT if VkPhysicalDeviceLimits::strictLines is TRUE, otherwise lines are drawn as non-strictLines parallelograms. Both of these modes are defined in Basic Line Segment Rasterization.
• LINE_RASTERIZATION_MODE_RECTANGULAR_EXT specifies lines drawn as if they were rectangles extruded from the line
• 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.
• 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.

See Also

VkPipelineRasterizationLineStateCreateInfoEXT, CmdSetLineRasterizationModeEXT

See Also:

• Constant Field Values

VK_LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_EXT

public static final int VK_LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_EXT

VkLineRasterizationModeEXT - Line rasterization modes

Description

• LINE_RASTERIZATION_MODE_DEFAULT_EXT is equivalent to LINE_RASTERIZATION_MODE_RECTANGULAR_EXT if VkPhysicalDeviceLimits::strictLines is TRUE, otherwise lines are drawn as non-strictLines parallelograms. Both of these modes are defined in Basic Line Segment Rasterization.
• LINE_RASTERIZATION_MODE_RECTANGULAR_EXT specifies lines drawn as if they were rectangles extruded from the line
• 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.
• 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.

See Also

VkPipelineRasterizationLineStateCreateInfoEXT, CmdSetLineRasterizationModeEXT

See Also:

• Constant Field Values

Method Details

vkCmdSetLineStippleEXT

public static void vkCmdSetLineStippleEXT(VkCommandBuffer commandBuffer,
 int lineStippleFactor,
 short lineStipplePattern)

Set line stipple dynamically for a command buffer.

C Specification

To dynamically set the line stipple state, call:

 void vkCmdSetLineStippleEXT(
     VkCommandBuffer                             commandBuffer,
     uint32_t                                    lineStippleFactor,
     uint16_t                                    lineStipplePattern);

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 VkPipelineDynamicStateCreateInfo::pDynamicStates. Otherwise, this state is specified by the VkPipelineRasterizationLineStateCreateInfoEXT::lineStippleFactor and VkPipelineRasterizationLineStateCreateInfoEXT::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 VkCommandBuffer handle
• commandBuffer must be in the recording state
• The VkCommandPool 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 VkCommandPool 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

Parameters:

commandBuffer - the command buffer into which the command will be recorded.

lineStippleFactor - the repeat factor used in stippled line rasterization.

lineStipplePattern - the bit pattern used in stippled line rasterization.