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 not REMAINING_3D_SLICES_EXT, it must be non-zero andsliceOffset+sliceCountmust be less than or equal to the effective view depth as specified in Image Mip Level Sizingimagemust have been created withimageTypeequal to IMAGE_TYPE_3DviewTypemust be IMAGE_VIEW_TYPE_3DThe image view must reference exactly 1 mip level
The imageSlicedViewOf3D feature must be enabled
Valid Usage (Implicit)
sTypemust be STRUCTURE_TYPE_IMAGE_VIEW_SLICED_CREATE_INFO_EXT
Structure Chaining
See Also
Constructors
ImageViewSlicedCreateInfoEXTsliceOffset :: Word32sliceOffsetis the Z-offset for the first 3D slice accessible to the image view.sliceCount :: Word32sliceCountis the number of 3D slices accessible to the image view.
Instances6Eq, Show, Storable, FromCStruct, ToCStruct, Zero
Eq ImageViewSlicedCreateInfoEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_image_sliced_view_of_3dShow ImageViewSlicedCreateInfoEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_image_sliced_view_of_3dStorable ImageViewSlicedCreateInfoEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_image_sliced_view_of_3dFromCStruct ImageViewSlicedCreateInfoEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_image_sliced_view_of_3dToCStruct ImageViewSlicedCreateInfoEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_image_sliced_view_of_3dZero ImageViewSlicedCreateInfoEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_image_sliced_view_of_3d