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.

Promotion to VK_KHR_line_rasterization

All functionality in this extension is included in VK_KHR_line_rasterization, with the suffix changed to KHR. The original enum names are still available as aliases of the KHR functionality.

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

Deprecation State

• Promoted to VK_KHR_line_rasterization extension

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	VkLineRasterizationModeKHR - Line rasterization modes
static final int	VK_LINE_RASTERIZATION_MODE_BRESENHAM_KHR	VkLineRasterizationModeKHR - Line rasterization modes
static final int	VK_LINE_RASTERIZATION_MODE_DEFAULT_EXT	VkLineRasterizationModeKHR - Line rasterization modes
static final int	VK_LINE_RASTERIZATION_MODE_DEFAULT_KHR	VkLineRasterizationModeKHR - Line rasterization modes
static final int	VK_LINE_RASTERIZATION_MODE_RECTANGULAR_EXT	VkLineRasterizationModeKHR - Line rasterization modes
static final int	VK_LINE_RASTERIZATION_MODE_RECTANGULAR_KHR	VkLineRasterizationModeKHR - Line rasterization modes
static final int	VK_LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_EXT	VkLineRasterizationModeKHR - Line rasterization modes
static final int	VK_LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_KHR	VkLineRasterizationModeKHR - 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(org.lwjgl.vulkan.VkCommandBuffer commandBuffer, int lineStippleFactor, short lineStipplePattern)	See CmdSetLineStippleKHR.

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_KHR

public static final int VK_LINE_RASTERIZATION_MODE_DEFAULT_KHR

VkLineRasterizationModeKHR - Line rasterization modes

Description

• LINE_RASTERIZATION_MODE_DEFAULT_KHR is equivalent to LINE_RASTERIZATION_MODE_RECTANGULAR_KHR 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_KHR specifies lines drawn as if they were rectangles extruded from the line
• LINE_RASTERIZATION_MODE_BRESENHAM_KHR 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_KHR specifies lines drawn if they were rectangles extruded from the line, with alpha falloff, as defined in Smooth Lines.

See Also

VkPipelineRasterizationLineStateCreateInfoKHR, CmdSetLineRasterizationModeEXT

Enum values:

• LINE_RASTERIZATION_MODE_DEFAULT_EXT
• LINE_RASTERIZATION_MODE_RECTANGULAR_EXT
• LINE_RASTERIZATION_MODE_BRESENHAM_EXT
• LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_EXT

See Also:

• Constant Field Values

VK_LINE_RASTERIZATION_MODE_DEFAULT_EXT

public static final int VK_LINE_RASTERIZATION_MODE_DEFAULT_EXT

VkLineRasterizationModeKHR - Line rasterization modes

Description

• LINE_RASTERIZATION_MODE_DEFAULT_KHR is equivalent to LINE_RASTERIZATION_MODE_RECTANGULAR_KHR 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_KHR specifies lines drawn as if they were rectangles extruded from the line
• LINE_RASTERIZATION_MODE_BRESENHAM_KHR 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_KHR specifies lines drawn if they were rectangles extruded from the line, with alpha falloff, as defined in Smooth Lines.

See Also

VkPipelineRasterizationLineStateCreateInfoKHR, CmdSetLineRasterizationModeEXT

Enum values:

• LINE_RASTERIZATION_MODE_DEFAULT_EXT
• LINE_RASTERIZATION_MODE_RECTANGULAR_EXT
• LINE_RASTERIZATION_MODE_BRESENHAM_EXT
• LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_EXT

See Also:

• Constant Field Values

VK_LINE_RASTERIZATION_MODE_RECTANGULAR_KHR

public static final int VK_LINE_RASTERIZATION_MODE_RECTANGULAR_KHR

VkLineRasterizationModeKHR - Line rasterization modes

Description

• LINE_RASTERIZATION_MODE_DEFAULT_KHR is equivalent to LINE_RASTERIZATION_MODE_RECTANGULAR_KHR 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_KHR specifies lines drawn as if they were rectangles extruded from the line
• LINE_RASTERIZATION_MODE_BRESENHAM_KHR 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_KHR specifies lines drawn if they were rectangles extruded from the line, with alpha falloff, as defined in Smooth Lines.

See Also

VkPipelineRasterizationLineStateCreateInfoKHR, CmdSetLineRasterizationModeEXT

Enum values:

• LINE_RASTERIZATION_MODE_DEFAULT_EXT
• LINE_RASTERIZATION_MODE_RECTANGULAR_EXT
• LINE_RASTERIZATION_MODE_BRESENHAM_EXT
• LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_EXT

See Also:

• Constant Field Values

VK_LINE_RASTERIZATION_MODE_RECTANGULAR_EXT

public static final int VK_LINE_RASTERIZATION_MODE_RECTANGULAR_EXT

VkLineRasterizationModeKHR - Line rasterization modes

Description

• LINE_RASTERIZATION_MODE_DEFAULT_KHR is equivalent to LINE_RASTERIZATION_MODE_RECTANGULAR_KHR 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_KHR specifies lines drawn as if they were rectangles extruded from the line
• LINE_RASTERIZATION_MODE_BRESENHAM_KHR 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_KHR specifies lines drawn if they were rectangles extruded from the line, with alpha falloff, as defined in Smooth Lines.

See Also

VkPipelineRasterizationLineStateCreateInfoKHR, CmdSetLineRasterizationModeEXT

Enum values:

• LINE_RASTERIZATION_MODE_DEFAULT_EXT
• LINE_RASTERIZATION_MODE_RECTANGULAR_EXT
• LINE_RASTERIZATION_MODE_BRESENHAM_EXT
• LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_EXT

See Also:

• Constant Field Values

VK_LINE_RASTERIZATION_MODE_BRESENHAM_KHR

public static final int VK_LINE_RASTERIZATION_MODE_BRESENHAM_KHR

VkLineRasterizationModeKHR - Line rasterization modes

Description

• LINE_RASTERIZATION_MODE_DEFAULT_KHR is equivalent to LINE_RASTERIZATION_MODE_RECTANGULAR_KHR 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_KHR specifies lines drawn as if they were rectangles extruded from the line
• LINE_RASTERIZATION_MODE_BRESENHAM_KHR 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_KHR specifies lines drawn if they were rectangles extruded from the line, with alpha falloff, as defined in Smooth Lines.

See Also

VkPipelineRasterizationLineStateCreateInfoKHR, CmdSetLineRasterizationModeEXT

Enum values:

• LINE_RASTERIZATION_MODE_DEFAULT_EXT
• LINE_RASTERIZATION_MODE_RECTANGULAR_EXT
• LINE_RASTERIZATION_MODE_BRESENHAM_EXT
• LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_EXT

See Also:

• Constant Field Values

VK_LINE_RASTERIZATION_MODE_BRESENHAM_EXT

public static final int VK_LINE_RASTERIZATION_MODE_BRESENHAM_EXT

VkLineRasterizationModeKHR - Line rasterization modes

Description

• LINE_RASTERIZATION_MODE_DEFAULT_KHR is equivalent to LINE_RASTERIZATION_MODE_RECTANGULAR_KHR 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_KHR specifies lines drawn as if they were rectangles extruded from the line
• LINE_RASTERIZATION_MODE_BRESENHAM_KHR 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_KHR specifies lines drawn if they were rectangles extruded from the line, with alpha falloff, as defined in Smooth Lines.

See Also

VkPipelineRasterizationLineStateCreateInfoKHR, CmdSetLineRasterizationModeEXT

Enum values:

• LINE_RASTERIZATION_MODE_DEFAULT_EXT
• LINE_RASTERIZATION_MODE_RECTANGULAR_EXT
• LINE_RASTERIZATION_MODE_BRESENHAM_EXT
• LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_EXT

See Also:

• Constant Field Values

VK_LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_KHR

public static final int VK_LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_KHR

VkLineRasterizationModeKHR - Line rasterization modes

Description

• LINE_RASTERIZATION_MODE_DEFAULT_KHR is equivalent to LINE_RASTERIZATION_MODE_RECTANGULAR_KHR 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_KHR specifies lines drawn as if they were rectangles extruded from the line
• LINE_RASTERIZATION_MODE_BRESENHAM_KHR 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_KHR specifies lines drawn if they were rectangles extruded from the line, with alpha falloff, as defined in Smooth Lines.

See Also

VkPipelineRasterizationLineStateCreateInfoKHR, CmdSetLineRasterizationModeEXT

Enum values:

• LINE_RASTERIZATION_MODE_DEFAULT_EXT
• LINE_RASTERIZATION_MODE_RECTANGULAR_EXT
• LINE_RASTERIZATION_MODE_BRESENHAM_EXT
• LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_EXT

See Also:

• Constant Field Values

VK_LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_EXT

public static final int VK_LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_EXT

VkLineRasterizationModeKHR - Line rasterization modes

Description

• LINE_RASTERIZATION_MODE_DEFAULT_KHR is equivalent to LINE_RASTERIZATION_MODE_RECTANGULAR_KHR 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_KHR specifies lines drawn as if they were rectangles extruded from the line
• LINE_RASTERIZATION_MODE_BRESENHAM_KHR 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_KHR specifies lines drawn if they were rectangles extruded from the line, with alpha falloff, as defined in Smooth Lines.

See Also

VkPipelineRasterizationLineStateCreateInfoKHR, CmdSetLineRasterizationModeEXT

Enum values:

• LINE_RASTERIZATION_MODE_DEFAULT_EXT
• LINE_RASTERIZATION_MODE_RECTANGULAR_EXT
• LINE_RASTERIZATION_MODE_BRESENHAM_EXT
• LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_EXT

See Also:

• Constant Field Values

Method Details

vkCmdSetLineStippleEXT

public static void vkCmdSetLineStippleEXT(org.lwjgl.vulkan.VkCommandBuffer commandBuffer,
 int lineStippleFactor,
 short lineStipplePattern)

See CmdSetLineStippleKHR.

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.