| Safe Haskell | Safe-Inferred |
|---|---|
| Language | Haskell2010 |
Vulkan.Extensions.VK_EXT_image_sliced_view_of_3d
Description
Name
VK_EXT_image_sliced_view_of_3d - device extension
VK_EXT_image_sliced_view_of_3d
- Name String
VK_EXT_image_sliced_view_of_3d
- Extension Type
- Device extension
- Registered Extension Number
- 419
- Revision
- 1
- Ratification Status
- Not ratified
- Extension and Version Dependencies
- VK_KHR_maintenance1 and VK_KHR_get_physical_device_properties2
- Special Use
- Contact
- Extension Proposal
- VK_EXT_image_sliced_view_of_3d
Other Extension Metadata
- Last Modified Date
- 2023-01-24
- IP Status
- No known IP claims.
- Contributors
- Mike Blumenkrantz, Valve
- Hans-Kristian Arntzen, Valve
- Ricardo Garcia, Igalia
- Shahbaz Youssefi, Google
- Piers Daniell, NVIDIA
Description
This extension allows creating 3D views of 3D images such that the views contain a subset of the slices in the image, using a Z offset and range, for the purpose of using the views as storage image descriptors. This matches functionality in D3D12 and is primarily intended to support D3D12 emulation.
New Structures
New Enum Constants
Version History
Revision 1, 2022-10-21 (Mike Blumenkrantz)
- Initial revision
See Also
REMAINING_3D_SLICES_EXT,
ImageViewSlicedCreateInfoEXT,
PhysicalDeviceImageSlicedViewOf3DFeaturesEXT
Document Notes
For more information, see the Vulkan Specification
This page is a generated document. Fixes and changes should be made to the generator scripts, not directly.
Synopsis
- data ImageViewSlicedCreateInfoEXT = ImageViewSlicedCreateInfoEXT {}
- data PhysicalDeviceImageSlicedViewOf3DFeaturesEXT = PhysicalDeviceImageSlicedViewOf3DFeaturesEXT {}
- type EXT_IMAGE_SLICED_VIEW_OF_3D_SPEC_VERSION = 1
- pattern EXT_IMAGE_SLICED_VIEW_OF_3D_SPEC_VERSION :: forall a. Integral a => a
- type EXT_IMAGE_SLICED_VIEW_OF_3D_EXTENSION_NAME = "VK_EXT_image_sliced_view_of_3d"
- pattern EXT_IMAGE_SLICED_VIEW_OF_3D_EXTENSION_NAME :: forall a. (Eq a, IsString a) => a
- type REMAINING_3D_SLICES_EXT = 4294967295
- pattern REMAINING_3D_SLICES_EXT :: Word32
Documentation
data ImageViewSlicedCreateInfoEXT Source #
VkImageViewSlicedCreateInfoEXT - Specify the subset of 3D slices of an image view
Description
When this structure is chained to
ImageViewCreateInfo the sliceOffset field is
treated as a Z-offset for the sliced view and sliceCount specifies the
range. Shader accesses using a Z coordinate of 0 will access the depth
slice corresponding to sliceOffset in the image, and in a shader, the
maximum in-bounds Z coordinate for the view is sliceCount - 1.
A sliced 3D view must only be used with a single mip level. The slice
coordinates are integer coordinates within the
subresourceRange.baseMipLevel used to create the image view.
The effective view depth is equal to extent.depth used to create the
image for this view adjusted by subresourceRange.baseMipLevel as
specified in
Image Mip Level Sizing.
Shader access to this image view is only affected by
ImageViewSlicedCreateInfoEXT if it uses a descriptor of type
DESCRIPTOR_TYPE_STORAGE_IMAGE. For
access using any other descriptor type, the contents of
ImageViewSlicedCreateInfoEXT are ignored; instead, sliceOffset is
treated as being equal to 0, and sliceCount is treated as being equal
to REMAINING_3D_SLICES_EXT.
Valid Usage
-
sliceOffsetmust be less than the effective view depth as specified in Image Mip Level Sizing
- If
sliceCountis notREMAINING_3D_SLICES_EXT, it must be be non-zero andsliceOffset+sliceCountmust be less than or equal to the effective view depth as specified in Image Mip Level Sizing -
imagemust have been created withimageTypeequal toIMAGE_TYPE_3D -
viewTypemust beIMAGE_VIEW_TYPE_3D - The image view must reference exactly 1 mip level
- The imageSlicedViewOf3D feature must be enabled on the device
Valid Usage (Implicit)
-
sTypemust beSTRUCTURE_TYPE_IMAGE_VIEW_SLICED_CREATE_INFO_EXT
See Also
Constructors
| ImageViewSlicedCreateInfoEXT | |
Fields
| |
Instances
data PhysicalDeviceImageSlicedViewOf3DFeaturesEXT Source #
VkPhysicalDeviceImageSlicedViewOf3DFeaturesEXT - Structure describing whether slice-based views of 3D images can be used in storage image descriptors
Members
The members of the PhysicalDeviceImageSlicedViewOf3DFeaturesEXT
structure describe the following features:
Description
If the PhysicalDeviceImageSlicedViewOf3DFeaturesEXT structure is
included in the pNext chain of the
PhysicalDeviceFeatures2
structure passed to
getPhysicalDeviceFeatures2,
it is filled in to indicate whether each corresponding feature is
supported. PhysicalDeviceImageSlicedViewOf3DFeaturesEXT can also be
used in the pNext chain of DeviceCreateInfo to
selectively enable these features.
Valid Usage (Implicit)
See Also
Constructors
| PhysicalDeviceImageSlicedViewOf3DFeaturesEXT | |
Fields
| |
Instances
pattern EXT_IMAGE_SLICED_VIEW_OF_3D_SPEC_VERSION :: forall a. Integral a => a Source #
type EXT_IMAGE_SLICED_VIEW_OF_3D_EXTENSION_NAME = "VK_EXT_image_sliced_view_of_3d" Source #
pattern EXT_IMAGE_SLICED_VIEW_OF_3D_EXTENSION_NAME :: forall a. (Eq a, IsString a) => a Source #
type REMAINING_3D_SLICES_EXT = 4294967295 Source #
pattern REMAINING_3D_SLICES_EXT :: Word32 Source #
VK_REMAINING_3D_SLICES_EXT - Sentinel for all remaining 3D slices