Package org.lwjgl.vulkan

Class EXTDepthBiasControl

java.lang.Object

org.lwjgl.vulkan.EXTDepthBiasControl

public class EXTDepthBiasControl
extends Object

This extension adds a new structure, VkDepthBiasRepresentationInfoEXT, that can be added to a pNext chain of VkPipelineRasterizationStateCreateInfo and allows setting the scaling and representation of depth bias for a pipeline.

This state can also be set dynamically by using the new structure mentioned above in combination with the new vkCmdSetDepthBias2EXT command.

Name String

VK_EXT_depth_bias_control

Extension Type

Device extension

Registered Extension Number

284

Revision

1

Extension and Version Dependencies

VK_KHR_get_physical_device_properties2 or Version 1.1

Special Use

• D3D support

Contact

• Joshua Ashton Joshua-Ashton

Extension Proposal

VK_EXT_depth_bias_control

Other Extension Metadata

Last Modified Date

2023-02-15

IP Status

No known IP claims.

Contributors

• Joshua Ashton, VALVE
• Hans-Kristian Arntzen, VALVE
• Mike Blumenkrantz, VALVE
• Georg Lehmann, VALVE
• Piers Daniell, NVIDIA
• Lionel Landwerlin, INTEL
• Tobias Hector, AMD
• Ricardo Garcia, IGALIA
• Jan-Harald Fredriksen, ARM
• Shahbaz Youssefi, GOOGLE
• Tom Olson, ARM

Field Summary

Fields

Modifier and Type	Field	Description
static final int	VK_DEPTH_BIAS_REPRESENTATION_FLOAT_EXT	VkDepthBiasRepresentationEXT - Specify the depth bias representation
static final int	VK_DEPTH_BIAS_REPRESENTATION_LEAST_REPRESENTABLE_VALUE_FORCE_UNORM_EXT	VkDepthBiasRepresentationEXT - Specify the depth bias representation
static final int	VK_DEPTH_BIAS_REPRESENTATION_LEAST_REPRESENTABLE_VALUE_FORMAT_EXT	VkDepthBiasRepresentationEXT - Specify the depth bias representation
static final String	VK_EXT_DEPTH_BIAS_CONTROL_EXTENSION_NAME	The extension name.
static final int	VK_EXT_DEPTH_BIAS_CONTROL_SPEC_VERSION	The extension specification version.
static final int	VK_STRUCTURE_TYPE_DEPTH_BIAS_INFO_EXT	Extends VkStructureType.
static final int	VK_STRUCTURE_TYPE_DEPTH_BIAS_REPRESENTATION_INFO_EXT	Extends VkStructureType.
static final int	VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_DEPTH_BIAS_CONTROL_FEATURES_EXT	Extends VkStructureType.

Method Summary

Modifier and Type	Method	Description
static void	nvkCmdSetDepthBias2EXT(org.lwjgl.vulkan.VkCommandBuffer commandBuffer, long pDepthBiasInfo)	Unsafe version of: CmdSetDepthBias2EXT
static void	vkCmdSetDepthBias2EXT(org.lwjgl.vulkan.VkCommandBuffer commandBuffer, VkDepthBiasInfoEXT pDepthBiasInfo)	Set depth bias factors and clamp 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_DEPTH_BIAS_CONTROL_SPEC_VERSION

public static final int VK_EXT_DEPTH_BIAS_CONTROL_SPEC_VERSION

The extension specification version.

See Also:

• Constant Field Values

VK_EXT_DEPTH_BIAS_CONTROL_EXTENSION_NAME

public static final String VK_EXT_DEPTH_BIAS_CONTROL_EXTENSION_NAME

The extension name.

See Also:

• Constant Field Values

VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_DEPTH_BIAS_CONTROL_FEATURES_EXT

public static final int VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_DEPTH_BIAS_CONTROL_FEATURES_EXT

Extends VkStructureType.

Enum values:

• STRUCTURE_TYPE_PHYSICAL_DEVICE_DEPTH_BIAS_CONTROL_FEATURES_EXT
• STRUCTURE_TYPE_DEPTH_BIAS_INFO_EXT
• STRUCTURE_TYPE_DEPTH_BIAS_REPRESENTATION_INFO_EXT

See Also:

• Constant Field Values

VK_STRUCTURE_TYPE_DEPTH_BIAS_INFO_EXT

public static final int VK_STRUCTURE_TYPE_DEPTH_BIAS_INFO_EXT

Extends VkStructureType.

Enum values:

• STRUCTURE_TYPE_PHYSICAL_DEVICE_DEPTH_BIAS_CONTROL_FEATURES_EXT
• STRUCTURE_TYPE_DEPTH_BIAS_INFO_EXT
• STRUCTURE_TYPE_DEPTH_BIAS_REPRESENTATION_INFO_EXT

See Also:

• Constant Field Values

VK_STRUCTURE_TYPE_DEPTH_BIAS_REPRESENTATION_INFO_EXT

public static final int VK_STRUCTURE_TYPE_DEPTH_BIAS_REPRESENTATION_INFO_EXT

Extends VkStructureType.

Enum values:

• STRUCTURE_TYPE_PHYSICAL_DEVICE_DEPTH_BIAS_CONTROL_FEATURES_EXT
• STRUCTURE_TYPE_DEPTH_BIAS_INFO_EXT
• STRUCTURE_TYPE_DEPTH_BIAS_REPRESENTATION_INFO_EXT

See Also:

• Constant Field Values

VK_DEPTH_BIAS_REPRESENTATION_LEAST_REPRESENTABLE_VALUE_FORMAT_EXT

public static final int VK_DEPTH_BIAS_REPRESENTATION_LEAST_REPRESENTABLE_VALUE_FORMAT_EXT

VkDepthBiasRepresentationEXT - Specify the depth bias representation

Description

• DEPTH_BIAS_REPRESENTATION_LEAST_REPRESENTABLE_VALUE_FORMAT_EXT specifies that the depth bias representation is a factor of the format’s r as described in Depth Bias.
• DEPTH_BIAS_REPRESENTATION_LEAST_REPRESENTABLE_VALUE_FORCE_UNORM_EXT specifies that the depth bias representation is a factor of a constant r defined by the bit-size or mantissa of the format as described in Depth Bias.
• DEPTH_BIAS_REPRESENTATION_FLOAT_EXT specifies that the depth bias representation is a factor of constant r equal to 1.

See Also

VkDepthBiasRepresentationInfoEXT

See Also:

• Constant Field Values

VK_DEPTH_BIAS_REPRESENTATION_LEAST_REPRESENTABLE_VALUE_FORCE_UNORM_EXT

public static final int VK_DEPTH_BIAS_REPRESENTATION_LEAST_REPRESENTABLE_VALUE_FORCE_UNORM_EXT

VkDepthBiasRepresentationEXT - Specify the depth bias representation

Description

• DEPTH_BIAS_REPRESENTATION_LEAST_REPRESENTABLE_VALUE_FORMAT_EXT specifies that the depth bias representation is a factor of the format’s r as described in Depth Bias.
• DEPTH_BIAS_REPRESENTATION_LEAST_REPRESENTABLE_VALUE_FORCE_UNORM_EXT specifies that the depth bias representation is a factor of a constant r defined by the bit-size or mantissa of the format as described in Depth Bias.
• DEPTH_BIAS_REPRESENTATION_FLOAT_EXT specifies that the depth bias representation is a factor of constant r equal to 1.

See Also

VkDepthBiasRepresentationInfoEXT

See Also:

• Constant Field Values

VK_DEPTH_BIAS_REPRESENTATION_FLOAT_EXT

public static final int VK_DEPTH_BIAS_REPRESENTATION_FLOAT_EXT

VkDepthBiasRepresentationEXT - Specify the depth bias representation

Description

• DEPTH_BIAS_REPRESENTATION_LEAST_REPRESENTABLE_VALUE_FORMAT_EXT specifies that the depth bias representation is a factor of the format’s r as described in Depth Bias.
• DEPTH_BIAS_REPRESENTATION_LEAST_REPRESENTABLE_VALUE_FORCE_UNORM_EXT specifies that the depth bias representation is a factor of a constant r defined by the bit-size or mantissa of the format as described in Depth Bias.
• DEPTH_BIAS_REPRESENTATION_FLOAT_EXT specifies that the depth bias representation is a factor of constant r equal to 1.

See Also

VkDepthBiasRepresentationInfoEXT

See Also:

• Constant Field Values

Method Details

nvkCmdSetDepthBias2EXT

public static void nvkCmdSetDepthBias2EXT(org.lwjgl.vulkan.VkCommandBuffer commandBuffer,
 long pDepthBiasInfo)

Unsafe version of: CmdSetDepthBias2EXT

vkCmdSetDepthBias2EXT

public static void vkCmdSetDepthBias2EXT(org.lwjgl.vulkan.VkCommandBuffer commandBuffer,
 VkDepthBiasInfoEXT pDepthBiasInfo)

Set depth bias factors and clamp dynamically for a command buffer.

C Specification

To dynamically set the depth bias parameters, call:

 void vkCmdSetDepthBias2EXT(
     VkCommandBuffer                             commandBuffer,
     const VkDepthBiasInfoEXT*                   pDepthBiasInfo);

Description

This command is functionally identical to CmdSetDepthBias, but includes extensible sub-structures that include sType and pNext parameters, allowing them to be more easily extended.

Valid Usage (Implicit)

• commandBuffer must be a valid VkCommandBuffer handle
• pDepthBiasInfo must be a valid pointer to a valid VkDepthBiasInfoEXT structure
• 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

See Also

VkDepthBiasInfoEXT

Parameters:

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

pDepthBiasInfo - a pointer to a VkDepthBiasInfoEXT structure specifying depth bias parameters.