KHRMaintenance2 (LWJGL 3.2.4 SNAPSHOT

java.lang.Object
- org.lwjgl.vulkan.KHRMaintenance2

```
public final class KHRMaintenance2
extends java.lang.Object
```
VK_KHR_maintenance2 adds a collection of minor features that were intentionally left out or overlooked from the original Vulkan 1.0 release.
The new features are as follows:
- Allow the application to specify which aspect of an input attachment might be read for a given subpass.
- Allow implementations to express the clipping behavior of points.
- Allow creating images with usage flags that may not be supported for the base image’s format, but are supported for image views of the image that have a different but compatible format.
- Allow creating uncompressed image views of compressed images.
- Allow the application to select between an upper-left and lower-left origin for the tessellation domain space.
- Adds two new image layouts for depth stencil images to allow either the depth or stencil aspect to be read-only while the other aspect is writable.
Input Attachment Specification

Input attachment specification allows an application to specify which aspect of a multi-aspect image (e.g. a combined depth stencil format) will be accessed via a subpassLoad operation.

On some implementations there may be a performance penalty if the implementation does not know (at CreateRenderPass time) which aspect(s) of multi-aspect images can be accessed as input attachments.

Promotion to Vulkan 1.1

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

Input Attachment Specification Example

Consider the case where a render pass has two subpasses and two attachments.

Attachment 0 has the format FORMAT_D24_UNORM_S8_UINT, attachment 1 has some color format.

Subpass 0 writes to attachment 0, subpass 1 reads only the depth information from attachment 0 (using inputAttachmentRead) and writes to attachment 1.
```
     VkInputAttachmentAspectReferenceKHR references[] = {
         {
             .subpass = 1,
             .inputAttachmentIndex = 0,
             .aspectMask = VK_IMAGE_ASPECT_DEPTH_BIT
         }
     };
 
     VkRenderPassInputAttachmentAspectCreateInfoKHR specifyAspects = {
         .sType = VK_STRUCTURE_TYPE_RENDER_PASS_INPUT_ATTACHMENT_ASPECT_CREATE_INFO_KHR,
         .pNext = NULL,
         .aspectReferenceCount = 1,
         .pAspectReferences = references
     };
 
 
     VkRenderPassCreateInfo createInfo = {
         ...
         .pNext = &specifyAspects,
         ...
     }
 
     vkCreateRenderPass(...);
```
Name String

VK_KHR_maintenance2

Extension Type

Device extension

Registered Extension Number

118

Revision

1

Extension and Version Dependencies
- Requires Vulkan 1.0
Deprecation state
- Promoted to Vulkan 1.1
Contact
- Michael Worcester michaelworcester
Last Modified Date

2017-09-05

Interactions and External Dependencies
- Promoted to Vulkan 1.1 Core
Contributors
- Michael Worcester, Imagination Technologies
- Stuart Smith, Imagination Technologies
- Jeff Bolz, NVIDIA
- Daniel Koch, NVIDIA
- Jan-Harald Fredriksen, ARM
- Daniel Rakos, AMD
- Neil Henning, Codeplay
- Piers Daniell, NVIDIA

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`VK_IMAGE_CREATE_BLOCK_TEXEL_VIEW_COMPATIBLE_BIT_KHR` Extends `VkImageCreateFlagBits`.
`static int`	`VK_IMAGE_CREATE_EXTENDED_USAGE_BIT_KHR` Extends `VkImageCreateFlagBits`.
`static int`	`VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL_KHR` Extends `VkImageLayout`.
`static int`	`VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL_KHR` Extends `VkImageLayout`.
`static java.lang.String`	`VK_KHR_MAINTENANCE2_EXTENSION_NAME` The extension name.
`static int`	`VK_KHR_MAINTENANCE2_SPEC_VERSION` The extension specification version.
`static int`	`VK_POINT_CLIPPING_BEHAVIOR_ALL_CLIP_PLANES_KHR` Extends `VkPointClippingBehavior`.
`static int`	`VK_POINT_CLIPPING_BEHAVIOR_USER_CLIP_PLANES_ONLY_KHR` Extends `VkPointClippingBehavior`.
`static int`	`VK_STRUCTURE_TYPE_IMAGE_VIEW_USAGE_CREATE_INFO_KHR` Extends `VkStructureType`.
`static int`	`VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_POINT_CLIPPING_PROPERTIES_KHR` Extends `VkStructureType`.
`static int`	`VK_STRUCTURE_TYPE_PIPELINE_TESSELLATION_DOMAIN_ORIGIN_STATE_CREATE_INFO_KHR` Extends `VkStructureType`.
`static int`	`VK_STRUCTURE_TYPE_RENDER_PASS_INPUT_ATTACHMENT_ASPECT_CREATE_INFO_KHR` Extends `VkStructureType`.
`static int`	`VK_TESSELLATION_DOMAIN_ORIGIN_LOWER_LEFT_KHR` Extends `VkTessellationDomainOrigin`.
`static int`	`VK_TESSELLATION_DOMAIN_ORIGIN_UPPER_LEFT_KHR` Extends `VkTessellationDomainOrigin`.

Method Summary
- Methods inherited from class java.lang.Object
  equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - VK_KHR_MAINTENANCE2_SPEC_VERSION
```
public static final int VK_KHR_MAINTENANCE2_SPEC_VERSION
```
    The extension specification version.
    
    See Also:
    
    Constant Field Values
  - VK_KHR_MAINTENANCE2_EXTENSION_NAME
```
public static final java.lang.String VK_KHR_MAINTENANCE2_EXTENSION_NAME
```
    The extension name.
    
    See Also:
    
    Constant Field Values
  - VK_IMAGE_CREATE_BLOCK_TEXEL_VIEW_COMPATIBLE_BIT_KHR
```
public static final int VK_IMAGE_CREATE_BLOCK_TEXEL_VIEW_COMPATIBLE_BIT_KHR
```
    Extends VkImageCreateFlagBits.
    Enum values:
    - IMAGE_CREATE_BLOCK_TEXEL_VIEW_COMPATIBLE_BIT_KHR
    - IMAGE_CREATE_EXTENDED_USAGE_BIT_KHR
    See Also:
    
    Constant Field Values
  - VK_IMAGE_CREATE_EXTENDED_USAGE_BIT_KHR
```
public static final int VK_IMAGE_CREATE_EXTENDED_USAGE_BIT_KHR
```
    Extends VkImageCreateFlagBits.
    Enum values:
    - IMAGE_CREATE_BLOCK_TEXEL_VIEW_COMPATIBLE_BIT_KHR
    - IMAGE_CREATE_EXTENDED_USAGE_BIT_KHR
    See Also:
    
    Constant Field Values
  - VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_POINT_CLIPPING_PROPERTIES_KHR
```
public static final int VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_POINT_CLIPPING_PROPERTIES_KHR
```
    Extends VkStructureType.
    Enum values:
    See Also:
    
    Constant Field Values
  - VK_STRUCTURE_TYPE_RENDER_PASS_INPUT_ATTACHMENT_ASPECT_CREATE_INFO_KHR
```
public static final int VK_STRUCTURE_TYPE_RENDER_PASS_INPUT_ATTACHMENT_ASPECT_CREATE_INFO_KHR
```
    Extends VkStructureType.
    Enum values:
    See Also:
    
    Constant Field Values
  - VK_STRUCTURE_TYPE_IMAGE_VIEW_USAGE_CREATE_INFO_KHR
```
public static final int VK_STRUCTURE_TYPE_IMAGE_VIEW_USAGE_CREATE_INFO_KHR
```
    Extends VkStructureType.
    Enum values:
    See Also:
    
    Constant Field Values
  - VK_STRUCTURE_TYPE_PIPELINE_TESSELLATION_DOMAIN_ORIGIN_STATE_CREATE_INFO_KHR
```
public static final int VK_STRUCTURE_TYPE_PIPELINE_TESSELLATION_DOMAIN_ORIGIN_STATE_CREATE_INFO_KHR
```
    Extends VkStructureType.
    Enum values:
    See Also:
    
    Constant Field Values
  - VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL_KHR
```
public static final int VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL_KHR
```
    Extends VkImageLayout.
    Enum values:
    - IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL_KHR
    - IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL_KHR
    See Also:
    
    Constant Field Values
  - VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL_KHR
```
public static final int VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL_KHR
```
    Extends VkImageLayout.
    Enum values:
    - IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL_KHR
    - IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL_KHR
    See Also:
    
    Constant Field Values
  - VK_POINT_CLIPPING_BEHAVIOR_ALL_CLIP_PLANES_KHR
```
public static final int VK_POINT_CLIPPING_BEHAVIOR_ALL_CLIP_PLANES_KHR
```
    Extends VkPointClippingBehavior.
    Enum values:
    - POINT_CLIPPING_BEHAVIOR_ALL_CLIP_PLANES_KHR
    - POINT_CLIPPING_BEHAVIOR_USER_CLIP_PLANES_ONLY_KHR
    See Also:
    
    Constant Field Values
  - VK_POINT_CLIPPING_BEHAVIOR_USER_CLIP_PLANES_ONLY_KHR
```
public static final int VK_POINT_CLIPPING_BEHAVIOR_USER_CLIP_PLANES_ONLY_KHR
```
    Extends VkPointClippingBehavior.
    Enum values:
    - POINT_CLIPPING_BEHAVIOR_ALL_CLIP_PLANES_KHR
    - POINT_CLIPPING_BEHAVIOR_USER_CLIP_PLANES_ONLY_KHR
    See Also:
    
    Constant Field Values
  - VK_TESSELLATION_DOMAIN_ORIGIN_UPPER_LEFT_KHR
```
public static final int VK_TESSELLATION_DOMAIN_ORIGIN_UPPER_LEFT_KHR
```
    Extends VkTessellationDomainOrigin.
    Enum values:
    - TESSELLATION_DOMAIN_ORIGIN_UPPER_LEFT_KHR
    - TESSELLATION_DOMAIN_ORIGIN_LOWER_LEFT_KHR
    See Also:
    
    Constant Field Values
  - VK_TESSELLATION_DOMAIN_ORIGIN_LOWER_LEFT_KHR
```
public static final int VK_TESSELLATION_DOMAIN_ORIGIN_LOWER_LEFT_KHR
```
    Extends VkTessellationDomainOrigin.
    Enum values:
    - TESSELLATION_DOMAIN_ORIGIN_UPPER_LEFT_KHR
    - TESSELLATION_DOMAIN_ORIGIN_LOWER_LEFT_KHR
    See Also:
    
    Constant Field Values

Class KHRMaintenance2

Input Attachment Specification

Promotion to Vulkan 1.1

Input Attachment Specification Example

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

VK_KHR_MAINTENANCE2_SPEC_VERSION

VK_KHR_MAINTENANCE2_EXTENSION_NAME

VK_IMAGE_CREATE_BLOCK_TEXEL_VIEW_COMPATIBLE_BIT_KHR

Enum values:

VK_IMAGE_CREATE_EXTENDED_USAGE_BIT_KHR

Enum values:

VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_POINT_CLIPPING_PROPERTIES_KHR

Enum values:

VK_STRUCTURE_TYPE_RENDER_PASS_INPUT_ATTACHMENT_ASPECT_CREATE_INFO_KHR

Enum values:

VK_STRUCTURE_TYPE_IMAGE_VIEW_USAGE_CREATE_INFO_KHR

Enum values:

VK_STRUCTURE_TYPE_PIPELINE_TESSELLATION_DOMAIN_ORIGIN_STATE_CREATE_INFO_KHR

Enum values:

VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL_KHR

Enum values:

VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL_KHR

Enum values:

VK_POINT_CLIPPING_BEHAVIOR_ALL_CLIP_PLANES_KHR

Enum values:

VK_POINT_CLIPPING_BEHAVIOR_USER_CLIP_PLANES_ONLY_KHR

Enum values:

VK_TESSELLATION_DOMAIN_ORIGIN_UPPER_LEFT_KHR

Enum values:

VK_TESSELLATION_DOMAIN_ORIGIN_LOWER_LEFT_KHR

Enum values: