Package org.lwjgl.vulkan

Class KHRLineRasterization

java.lang.Object

org.lwjgl.vulkan.KHRLineRasterization

public class KHRLineRasterization
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 Vulkan 1.4

Functionality in this extension is included in core Vulkan 1.4 with the KHR suffix omitted. The original type, enum and command names are still available as aliases of the core functionality.

When Version 1.4 is supported, the bresenhamLines feature must be supported.

Name String

VK_KHR_line_rasterization

Extension Type

Device extension

Registered Extension Number

535

Revision

1

Extension and Version Dependencies

VK_KHR_get_physical_device_properties2 or Version 1.1

Deprecation State

• Promoted to Vulkan 1.4

Contact

• Piers Daniell pdaniell-nv

Other Extension Metadata

Last Modified Date

2023-06-08

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_KHR	Extends VkDynamicState.
static final String	VK_KHR_LINE_RASTERIZATION_EXTENSION_NAME	The extension name.
static final int	VK_KHR_LINE_RASTERIZATION_SPEC_VERSION	The extension specification version.
static final int	VK_LINE_RASTERIZATION_MODE_BRESENHAM_KHR	Extends VkLineRasterizationMode.
static final int	VK_LINE_RASTERIZATION_MODE_DEFAULT_KHR	Extends VkLineRasterizationMode.
static final int	VK_LINE_RASTERIZATION_MODE_RECTANGULAR_KHR	Extends VkLineRasterizationMode.
static final int	VK_LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_KHR	Extends VkLineRasterizationMode.
static final int	VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_LINE_RASTERIZATION_FEATURES_KHR	Extends VkStructureType.
static final int	VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_LINE_RASTERIZATION_PROPERTIES_KHR	Extends VkStructureType.
static final int	VK_STRUCTURE_TYPE_PIPELINE_RASTERIZATION_LINE_STATE_CREATE_INFO_KHR	Extends VkStructureType.

Method Summary

Modifier and Type	Method	Description
static void	vkCmdSetLineStippleKHR(org.lwjgl.vulkan.VkCommandBuffer commandBuffer, int lineStippleFactor, short lineStipplePattern)	See CmdSetLineStipple.

Methods inherited from class java.lang.Object

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

Field Details

VK_KHR_LINE_RASTERIZATION_SPEC_VERSION

public static final int VK_KHR_LINE_RASTERIZATION_SPEC_VERSION

The extension specification version.

See Also:

• Constant Field Values

VK_KHR_LINE_RASTERIZATION_EXTENSION_NAME

public static final String VK_KHR_LINE_RASTERIZATION_EXTENSION_NAME

The extension name.

See Also:

• Constant Field Values

VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_LINE_RASTERIZATION_FEATURES_KHR

public static final int VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_LINE_RASTERIZATION_FEATURES_KHR

Extends VkStructureType.

Enum values:

• STRUCTURE_TYPE_PHYSICAL_DEVICE_LINE_RASTERIZATION_FEATURES_KHR
• STRUCTURE_TYPE_PIPELINE_RASTERIZATION_LINE_STATE_CREATE_INFO_KHR
• STRUCTURE_TYPE_PHYSICAL_DEVICE_LINE_RASTERIZATION_PROPERTIES_KHR

See Also:

• Constant Field Values

VK_STRUCTURE_TYPE_PIPELINE_RASTERIZATION_LINE_STATE_CREATE_INFO_KHR

public static final int VK_STRUCTURE_TYPE_PIPELINE_RASTERIZATION_LINE_STATE_CREATE_INFO_KHR

Extends VkStructureType.

Enum values:

• STRUCTURE_TYPE_PHYSICAL_DEVICE_LINE_RASTERIZATION_FEATURES_KHR
• STRUCTURE_TYPE_PIPELINE_RASTERIZATION_LINE_STATE_CREATE_INFO_KHR
• STRUCTURE_TYPE_PHYSICAL_DEVICE_LINE_RASTERIZATION_PROPERTIES_KHR

See Also:

• Constant Field Values

VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_LINE_RASTERIZATION_PROPERTIES_KHR

public static final int VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_LINE_RASTERIZATION_PROPERTIES_KHR

Extends VkStructureType.

Enum values:

• STRUCTURE_TYPE_PHYSICAL_DEVICE_LINE_RASTERIZATION_FEATURES_KHR
• STRUCTURE_TYPE_PIPELINE_RASTERIZATION_LINE_STATE_CREATE_INFO_KHR
• STRUCTURE_TYPE_PHYSICAL_DEVICE_LINE_RASTERIZATION_PROPERTIES_KHR

See Also:

• Constant Field Values

VK_DYNAMIC_STATE_LINE_STIPPLE_KHR

public static final int VK_DYNAMIC_STATE_LINE_STIPPLE_KHR

Extends VkDynamicState.

See Also:

• Constant Field Values

VK_LINE_RASTERIZATION_MODE_DEFAULT_KHR

public static final int VK_LINE_RASTERIZATION_MODE_DEFAULT_KHR

Extends VkLineRasterizationMode.

Enum values:

• LINE_RASTERIZATION_MODE_DEFAULT_KHR
• LINE_RASTERIZATION_MODE_RECTANGULAR_KHR
• LINE_RASTERIZATION_MODE_BRESENHAM_KHR
• LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_KHR

See Also:

• Constant Field Values

VK_LINE_RASTERIZATION_MODE_RECTANGULAR_KHR

public static final int VK_LINE_RASTERIZATION_MODE_RECTANGULAR_KHR

Extends VkLineRasterizationMode.

Enum values:

• LINE_RASTERIZATION_MODE_DEFAULT_KHR
• LINE_RASTERIZATION_MODE_RECTANGULAR_KHR
• LINE_RASTERIZATION_MODE_BRESENHAM_KHR
• LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_KHR

See Also:

• Constant Field Values

VK_LINE_RASTERIZATION_MODE_BRESENHAM_KHR

public static final int VK_LINE_RASTERIZATION_MODE_BRESENHAM_KHR

Extends VkLineRasterizationMode.

Enum values:

• LINE_RASTERIZATION_MODE_DEFAULT_KHR
• LINE_RASTERIZATION_MODE_RECTANGULAR_KHR
• LINE_RASTERIZATION_MODE_BRESENHAM_KHR
• LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_KHR

See Also:

• Constant Field Values

VK_LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_KHR

public static final int VK_LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_KHR

Extends VkLineRasterizationMode.

Enum values:

• LINE_RASTERIZATION_MODE_DEFAULT_KHR
• LINE_RASTERIZATION_MODE_RECTANGULAR_KHR
• LINE_RASTERIZATION_MODE_BRESENHAM_KHR
• LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_KHR

See Also:

• Constant Field Values

Method Details

vkCmdSetLineStippleKHR

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

See CmdSetLineStipple.

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.