Package org.lwjgl.vulkan

Class KHRDepthStencilResolve

java.lang.Object

org.lwjgl.vulkan.KHRDepthStencilResolve

public final class KHRDepthStencilResolve
extends java.lang.Object

This extension adds support for automatically resolving multisampled depth/stencil attachments in a subpass in a similar manner as for color attachments.

Multisampled color attachments can be resolved at the end of a subpass by specifying pResolveAttachments entries corresponding to the pColorAttachments array entries. This does not allow for a way to map the resolve attachments to the depth/stencil attachment. The CmdResolveImage command does not allow for depth/stencil images. While there are other ways to resolve the depth/stencil attachment, they can give sub-optimal performance. Extending the VkSubpassDescription2 in this extension allows an application to add a pDepthStencilResolveAttachment, that is similar to the color pResolveAttachments, that the pDepthStencilAttachment can be resolved into.

Depth and stencil samples are resolved to a single value based on the resolve mode. The set of possible resolve modes is defined in the VkResolveModeFlagBits enum. The RESOLVE_MODE_SAMPLE_ZERO_BIT mode is the only mode that is required of all implementations (that support the extension or support Vulkan 1.2 or higher). Some implementations may also support averaging (the same as color sample resolve) or taking the minimum or maximum sample, which may be more suitable for depth/stencil resolve.

Promotion to Vulkan 1.2

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

VK_KHR_depth_stencil_resolve

Name String

VK_KHR_depth_stencil_resolve

Extension Type

Device extension

Registered Extension Number

200

Revision

1

Extension and Version Dependencies

• Requires Vulkan 1.0
• Requires VK_KHR_create_renderpass2

Deprecation state

• Promoted to Vulkan 1.2

Contact

• Jan-Harald Fredriksen janharald

Other Extension Metadata

Last Modified Date

2018-04-09

Interactions and External Dependencies

• Promoted to Vulkan 1.2 Core

Contributors

• Jan-Harald Fredriksen, Arm
• Andrew Garrard, Samsung Electronics
• Soowan Park, Samsung Electronics
• Jeff Bolz, NVIDIA
• Daniel Rakos, AMD

Field Summary

Fields

Modifier and Type	Field	Description
static java.lang.String	VK_KHR_DEPTH_STENCIL_RESOLVE_EXTENSION_NAME	The extension name.
static int	VK_KHR_DEPTH_STENCIL_RESOLVE_SPEC_VERSION	The extension specification version.
static int	VK_RESOLVE_MODE_AVERAGE_BIT_KHR VK_RESOLVE_MODE_MAX_BIT_KHR VK_RESOLVE_MODE_MIN_BIT_KHR VK_RESOLVE_MODE_NONE_KHR VK_RESOLVE_MODE_SAMPLE_ZERO_BIT_KHR	Extends VkResolveModeFlagBits.
static int	VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_DEPTH_STENCIL_RESOLVE_PROPERTIES_KHR VK_STRUCTURE_TYPE_SUBPASS_DESCRIPTION_DEPTH_STENCIL_RESOLVE_KHR	Extends VkStructureType.

Method Summary

Methods inherited from class java.lang.Object

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

Field Detail

VK_KHR_DEPTH_STENCIL_RESOLVE_SPEC_VERSION

The extension specification version.

VK_KHR_DEPTH_STENCIL_RESOLVE_EXTENSION_NAME

The extension name.

VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_DEPTH_STENCIL_RESOLVE_PROPERTIES_KHR, VK_STRUCTURE_TYPE_SUBPASS_DESCRIPTION_DEPTH_STENCIL_RESOLVE_KHR

Extends VkStructureType.

Enum values:

• STRUCTURE_TYPE_PHYSICAL_DEVICE_DEPTH_STENCIL_RESOLVE_PROPERTIES_KHR
• STRUCTURE_TYPE_SUBPASS_DESCRIPTION_DEPTH_STENCIL_RESOLVE_KHR

VK_RESOLVE_MODE_NONE_KHR, VK_RESOLVE_MODE_SAMPLE_ZERO_BIT_KHR, VK_RESOLVE_MODE_AVERAGE_BIT_KHR, VK_RESOLVE_MODE_MIN_BIT_KHR, VK_RESOLVE_MODE_MAX_BIT_KHR

Extends VkResolveModeFlagBits.

Enum values:

• RESOLVE_MODE_NONE_KHR
• RESOLVE_MODE_SAMPLE_ZERO_BIT_KHR
• RESOLVE_MODE_AVERAGE_BIT_KHR
• RESOLVE_MODE_MIN_BIT_KHR
• RESOLVE_MODE_MAX_BIT_KHR