Vulkan.Extensions.VK_KHR_ray_tracing_maintenance1

Name

VK_KHR_ray_tracing_maintenance1 - device extension

VK_KHR_ray_tracing_maintenance1

Name String

VK_KHR_ray_tracing_maintenance1

Extension Type

Device extension

Registered Extension Number

387

Revision

1

Extension and Version Dependencies

• Requires support for Vulkan 1.1
• Requires VK_KHR_acceleration_structure to be enabled for any device-level functionality

Contact

• Daniel Koch @dgkoch%0A*Here describe the issue or question you have about the VK_KHR_ray_tracing_maintenance1 extension*

Other Extension Metadata

Last Modified Date

2022-02-21

Interactions and External Dependencies

• This extension requires SPV_KHR_ray_cull_mask
• This extension provides API support for GLSL_EXT_ray_cull_mask
• Interacts with VK_KHR_ray_tracing_pipeline
• Interacts with VK_KHR_synchronization2

Contributors

• Stu Smith, AMD
• Tobias Hector, AMD
• Marius Bjorge, Arm
• Tom Olson, Arm
• Yuriy O’Donnell, Epic Games
• Yunpeng Zhu, Huawei
• Andrew Garrard, Imagination
• Dae Kim, Imagination
• Joshua Barczak, Intel
• Lionel Landwerlin, Intel
• Daniel Koch, NVIDIA
• Eric Werness, NVIDIA
• Spencer Fricke, Samsung

Description

VK_KHR_ray_tracing_maintenance1 adds a collection of minor ray tracing features, none of which would warrant an entire extension of their own.

The new features are as follows:

• Adds support for the SPV_KHR_ray_cull_mask SPIR-V extension in Vulkan. This extension provides access to built-in CullMaskKHR shader variable which contains the value of the OpTrace* Cull Mask parameter. This new shader variable is accessible in the intersection, any-hit, closest-hit and miss shader stages.

• Adds support for a new pipeline stage and access mask built on top of VK_KHR_synchronization2:

  • PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_COPY_BIT_KHR to specify execution of acceleration structure copy commands
  • ACCESS_2_SHADER_BINDING_TABLE_READ_BIT_KHR to specify read access to a shader binding table in any shader pipeline stage

• Adds two new acceleration structure query parameters:

  • QUERY_TYPE_ACCELERATION_STRUCTURE_SIZE_KHR to query the acceleration structure size on the device timeline
  • QUERY_TYPE_ACCELERATION_STRUCTURE_SERIALIZATION_BOTTOM_LEVEL_POINTERS_KHR to query the number of bottom level acceleration structure pointers for serialization
• Adds an optional new indirect ray tracing dispatch command, cmdTraceRaysIndirect2KHR, which sources the shader binding table parameters as well as the dispatch dimensions from the device. The rayTracingPipelineTraceRaysIndirect2 feature indicates whether this functionality is supported.

New Commands

If VK_KHR_ray_tracing_pipeline is supported:

• cmdTraceRaysIndirect2KHR

New Structures

• Extending PhysicalDeviceFeatures2, DeviceCreateInfo:

  • PhysicalDeviceRayTracingMaintenance1FeaturesKHR

If VK_KHR_ray_tracing_pipeline is supported:

• TraceRaysIndirectCommand2KHR

New Enum Constants

• KHR_RAY_TRACING_MAINTENANCE_1_EXTENSION_NAME

• KHR_RAY_TRACING_MAINTENANCE_1_SPEC_VERSION

• Extending QueryType:

  • QUERY_TYPE_ACCELERATION_STRUCTURE_SERIALIZATION_BOTTOM_LEVEL_POINTERS_KHR
  • QUERY_TYPE_ACCELERATION_STRUCTURE_SIZE_KHR

• Extending StructureType:

  • STRUCTURE_TYPE_PHYSICAL_DEVICE_RAY_TRACING_MAINTENANCE_1_FEATURES_KHR

If VK_KHR_synchronization2 is supported:

• Extending PipelineStageFlagBits2:

  • PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_COPY_BIT_KHR

If VK_KHR_synchronization2 and VK_KHR_ray_tracing_pipeline is supported:

• Extending AccessFlagBits2:

  • ACCESS_2_SHADER_BINDING_TABLE_READ_BIT_KHR

New Built-In Variables

• CullMaskKHR

New SPIR-V Capabilities

• RayCullMaskKHR

Issues

None Yet!

Version History

• Revision 1, 2022-02-21 (Members of the Vulkan Ray Tracing TSG)

  • internal revisions

See Also

PhysicalDeviceRayTracingMaintenance1FeaturesKHR

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.

Documentation

cmdTraceRaysIndirect2KHR

Arguments

:: forall io. MonadIO io

=> CommandBuffer

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

-> ("indirectDeviceAddress" ::: DeviceAddress)

indirectDeviceAddress is a buffer device address which is a pointer to a TraceRaysIndirectCommand2KHR structure containing the trace ray parameters.

-> io ()

vkCmdTraceRaysIndirect2KHR - Initialize an indirect ray tracing dispatch with indirect shader binding tables

Description

cmdTraceRaysIndirect2KHR behaves similarly to cmdTraceRaysIndirectKHR except that shader binding table parameters as well as dispatch dimensions are read by the device from indirectDeviceAddress during execution.

Valid Usage

• If a Sampler created with magFilter or minFilter equal to FILTER_LINEAR and compareEnable equal to FALSE is used to sample a ImageView as a result of this command, then the image view’s format features must contain FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT

• If a Sampler created with mipmapMode equal to SAMPLER_MIPMAP_MODE_LINEAR and compareEnable equal to FALSE is used to sample a ImageView as a result of this command, then the image view’s format features must contain FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT
• If a ImageView is sampled with depth comparison, the image view’s format features must contain FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT
• If a ImageView is accessed using atomic operations as a result of this command, then the image view’s format features must contain FORMAT_FEATURE_STORAGE_IMAGE_ATOMIC_BIT
• If a ImageView is sampled with FILTER_CUBIC_EXT as a result of this command, then the image view’s format features must contain FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT
• Any ImageView being sampled with FILTER_CUBIC_EXT as a result of this command must have a ImageViewType and format that supports cubic filtering, as specified by FilterCubicImageViewImageFormatPropertiesEXT::filterCubic returned by getPhysicalDeviceImageFormatProperties2
• Any ImageView being sampled with FILTER_CUBIC_EXT with a reduction mode of either SAMPLER_REDUCTION_MODE_MIN or SAMPLER_REDUCTION_MODE_MAX as a result of this command must have a ImageViewType and format that supports cubic filtering together with minmax filtering, as specified by FilterCubicImageViewImageFormatPropertiesEXT::filterCubicMinmax returned by getPhysicalDeviceImageFormatProperties2
• Any Image created with a ImageCreateInfo::flags containing IMAGE_CREATE_CORNER_SAMPLED_BIT_NV sampled as a result of this command must only be sampled using a SamplerAddressMode of SAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE
• For any ImageView being written as a storage image where the image format field of the OpTypeImage is Unknown, the view’s format features must contain FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT
• For any ImageView being read as a storage image where the image format field of the OpTypeImage is Unknown, the view’s format features must contain FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT
• For any BufferView being written as a storage texel buffer where the image format field of the OpTypeImage is Unknown, the view’s buffer features must contain FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT
• Any BufferView being read as a storage texel buffer where the image format field of the OpTypeImage is Unknown then the view’s buffer features must contain FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT
• For each set n that is statically used by the Pipeline bound to the pipeline bind point used by this command, a descriptor set must have been bound to n at the same pipeline bind point, with a PipelineLayout that is compatible for set n, with the PipelineLayout used to create the current Pipeline, as described in ???
• If the maintenance4 feature is not enabled, then for each push constant that is statically used by the Pipeline bound to the pipeline bind point used by this command, a push constant value must have been set for the same pipeline bind point, with a PipelineLayout that is compatible for push constants, with the PipelineLayout used to create the current Pipeline, as described in ???
• Descriptors in each bound descriptor set, specified via cmdBindDescriptorSets, must be valid if they are statically used by the Pipeline bound to the pipeline bind point used by this command and the bound Pipeline was not created with PIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT
• If the descriptors used by the Pipeline bound to the pipeline bind point were specified via cmdBindDescriptorSets, the bound Pipeline must have been created without PIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT
• Descriptors in bound descriptor buffers, specified via cmdSetDescriptorBufferOffsetsEXT, must be valid if they are dynamically used by the Pipeline bound to the pipeline bind point used by this command and the bound Pipeline was created with PIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT
• If the descriptors used by the Pipeline bound to the pipeline bind point were specified via cmdSetDescriptorBufferOffsetsEXT, the bound Pipeline must have been created with PIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT
• If a descriptor is dynamically used with a Pipeline created with PIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT, the descriptor memory must be resident.
• A valid pipeline must be bound to the pipeline bind point used by this command
• If the Pipeline object bound to the pipeline bind point used by this command requires any dynamic state, that state must have been set or inherited (if the VK_NV_inherited_viewport_scissor extension is enabled) for commandBuffer, and done so after any previously bound pipeline with the corresponding state not specified as dynamic
• There must not have been any calls to dynamic state setting commands for any state not specified as dynamic in the Pipeline object bound to the pipeline bind point used by this command, since that pipeline was bound
• If the Pipeline object bound to the pipeline bind point used by this command accesses a Sampler object that uses unnormalized coordinates, that sampler must not be used to sample from any Image with a ImageView of the type IMAGE_VIEW_TYPE_3D, IMAGE_VIEW_TYPE_CUBE, IMAGE_VIEW_TYPE_1D_ARRAY, IMAGE_VIEW_TYPE_2D_ARRAY or IMAGE_VIEW_TYPE_CUBE_ARRAY, in any shader stage
• If the Pipeline object bound to the pipeline bind point used by this command accesses a Sampler object that uses unnormalized coordinates, that sampler must not be used with any of the SPIR-V OpImageSample* or OpImageSparseSample* instructions with ImplicitLod, Dref or Proj in their name, in any shader stage
• If the Pipeline object bound to the pipeline bind point used by this command accesses a Sampler object that uses unnormalized coordinates, that sampler must not be used with any of the SPIR-V OpImageSample* or OpImageSparseSample* instructions that includes a LOD bias or any offset values, in any shader stage
• If any stage of the Pipeline object bound to the pipeline bind point used by this command accesses a uniform buffer, and that stage was created without enabling either PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT or PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT for uniformBuffers, and the robustBufferAccess feature is not enabled, that stage must not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point
• If any stage of the Pipeline object bound to the pipeline bind point used by this command accesses a storage buffer, and that stage was created without enabling either PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT or PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT for storageBuffers, and the robustBufferAccess feature is not enabled, that stage must not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point
• If commandBuffer is an unprotected command buffer and protectedNoFault is not supported, any resource accessed by the Pipeline object bound to the pipeline bind point used by this command must not be a protected resource
• If the Pipeline object bound to the pipeline bind point used by this command accesses a Sampler or ImageView object that enables sampler Y′CBCR conversion, that object must only be used with OpImageSample* or OpImageSparseSample* instructions
• If the Pipeline object bound to the pipeline bind point used by this command accesses a Sampler or ImageView object that enables sampler Y′CBCR conversion, that object must not use the ConstOffset and Offset operands
• If a ImageView is accessed using OpImageWrite as a result of this command, then the Type of the Texel operand of that instruction must have at least as many components as the image view’s format
• If a BufferView is accessed using OpImageWrite as a result of this command, then the Type of the Texel operand of that instruction must have at least as many components as the buffer view’s format
• If a ImageView with a Format that has a 64-bit component width is accessed as a result of this command, the SampledType of the OpTypeImage operand of that instruction must have a Width of 64
• If a ImageView with a Format that has a component width less than 64-bit is accessed as a result of this command, the SampledType of the OpTypeImage operand of that instruction must have a Width of 32
• If a BufferView with a Format that has a 64-bit component width is accessed as a result of this command, the SampledType of the OpTypeImage operand of that instruction must have a Width of 64
• If a BufferView with a Format that has a component width less than 64-bit is accessed as a result of this command, the SampledType of the OpTypeImage operand of that instruction must have a Width of 32
• If the sparseImageInt64Atomics feature is not enabled, Image objects created with the IMAGE_CREATE_SPARSE_RESIDENCY_BIT flag must not be accessed by atomic instructions through an OpTypeImage with a SampledType with a Width of 64 by this command
• If the sparseImageInt64Atomics feature is not enabled, Buffer objects created with the BUFFER_CREATE_SPARSE_RESIDENCY_BIT flag must not be accessed by atomic instructions through an OpTypeImage with a SampledType with a Width of 64 by this command
• If OpImageWeightedSampleQCOM is used to sample a ImageView as a result of this command, then the image view’s format features must contain FORMAT_FEATURE_2_WEIGHT_SAMPLED_IMAGE_BIT_QCOM
• If OpImageWeightedSampleQCOM uses a ImageView as a sample weight image as a result of this command, then the image view’s format features must contain FORMAT_FEATURE_2_WEIGHT_IMAGE_BIT_QCOM
• If OpImageBoxFilterQCOM is used to sample a ImageView as a result of this command, then the image view’s format features must contain FORMAT_FEATURE_2_BOX_FILTER_SAMPLED_BIT_QCOM
• If OpImageBlockMatchSSDQCOM is used to read from an ImageView as a result of this command, then the image view’s format features must contain FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM
• If OpImageBlockMatchSADQCOM is used to read from an ImageView as a result of this command, then the image view’s format features must contain FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM
• If OpImageBlockMatchSADQCOM or OpImageBlockMatchSSDQCOM is used to read from a reference image as result of this command, then the specified reference coordinates must not fail integer texel coordinate validation.
• If OpImageWeightedSampleQCOM, OpImageBoxFilterQCOM, OpImageBlockMatchSSDQCOM, or OpImageBlockMatchSADQCOM uses a Sampler as a result of this command, then the sampler must have been created with SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM.
• If any command other than OpImageWeightedSampleQCOM, OpImageBoxFilterQCOM, OpImageBlockMatchSSDQCOM, or OpImageBlockMatchSADQCOM uses a Sampler as a result of this command, then the sampler must not have been created with SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM.
• Any shader invocation executed by this command must terminate
• Any shader group handle referenced by this call must have been queried from the currently bound ray tracing pipeline
• This command must not cause a shader call instruction to be executed from a shader invocation with a recursion depth greater than the value of maxPipelineRayRecursionDepth used to create the bound ray tracing pipeline
• commandBuffer must not be a protected command buffer
• If the buffer from which indirectDeviceAddress was queried is non-sparse then it must be bound completely and contiguously to a single DeviceMemory object
• The buffer from which indirectDeviceAddress was queried must have been created with the BUFFER_USAGE_INDIRECT_BUFFER_BIT bit set
• indirectDeviceAddress must be a multiple of 4
• All device addresses between indirectDeviceAddress and indirectDeviceAddress + sizeof(TraceRaysIndirectCommand2KHR) - 1 must be in the buffer device address range of the same buffer
• The rayTracingPipelineTraceRaysIndirect2 feature must be enabled
• If the bound ray tracing pipeline was created with PIPELINE_CREATE_RAY_TRACING_ALLOW_MOTION_BIT_NV PhysicalDeviceRayTracingMotionBlurFeaturesNV::rayTracingMotionBlurPipelineTraceRaysIndirect feature must be enabled

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• commandBuffer must be in the recording state
• The CommandPool that commandBuffer was allocated from must support compute operations
• This command must only be called outside of a render pass instance
• 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 CommandPool 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	Outside	Outside	Compute	Action

See Also

VK_KHR_ray_tracing_maintenance1, VK_KHR_ray_tracing_pipeline, CommandBuffer, DeviceAddress

data TraceRaysIndirectCommand2KHR

VkTraceRaysIndirectCommand2KHR - Structure specifying the parameters of an indirect trace ray command with indirect shader binding tables

Description

The members of TraceRaysIndirectCommand2KHR have the same meaning as the similarly named parameters of cmdTraceRaysKHR.

Indirect shader binding table buffer parameters must satisfy the same memory alignment and binding requirements as their counterparts in cmdTraceRaysIndirectKHR and cmdTraceRaysKHR.

Valid Usage

• If the buffer from which raygenShaderRecordAddress was queried is non-sparse then it must be bound completely and contiguously to a single DeviceMemory object

• The buffer from which the raygenShaderRecordAddress is queried must have been created with the BUFFER_USAGE_SHADER_BINDING_TABLE_BIT_KHR usage flag
• raygenShaderRecordAddress must be a multiple of PhysicalDeviceRayTracingPipelinePropertiesKHR::shaderGroupBaseAlignment
• If the buffer from which missShaderBindingTableAddress was queried is non-sparse then it must be bound completely and contiguously to a single DeviceMemory object
• The buffer from which the missShaderBindingTableAddress is queried must have been created with the BUFFER_USAGE_SHADER_BINDING_TABLE_BIT_KHR usage flag
• missShaderBindingTableAddress must be a multiple of PhysicalDeviceRayTracingPipelinePropertiesKHR::shaderGroupBaseAlignment
• missShaderBindingTableStride must be a multiple of PhysicalDeviceRayTracingPipelinePropertiesKHR::shaderGroupHandleAlignment
• missShaderBindingTableStride must be less than or equal to PhysicalDeviceRayTracingPipelinePropertiesKHR::maxShaderGroupStride
• If the buffer from which hitShaderBindingTableAddress was queried is non-sparse then it must be bound completely and contiguously to a single DeviceMemory object
• The buffer from which the hitShaderBindingTableAddress is queried must have been created with the BUFFER_USAGE_SHADER_BINDING_TABLE_BIT_KHR usage flag
• hitShaderBindingTableAddress must be a multiple of PhysicalDeviceRayTracingPipelinePropertiesKHR::shaderGroupBaseAlignment
• hitShaderBindingTableStride must be a multiple of PhysicalDeviceRayTracingPipelinePropertiesKHR::shaderGroupHandleAlignment
• hitShaderBindingTableStride must be less than or equal to PhysicalDeviceRayTracingPipelinePropertiesKHR::maxShaderGroupStride
• If the buffer from which callableShaderBindingTableAddress was queried is non-sparse then it must be bound completely and contiguously to a single DeviceMemory object
• The buffer from which the callableShaderBindingTableAddress is queried must have been created with the BUFFER_USAGE_SHADER_BINDING_TABLE_BIT_KHR usage flag
• callableShaderBindingTableAddress must be a multiple of PhysicalDeviceRayTracingPipelinePropertiesKHR::shaderGroupBaseAlignment
• callableShaderBindingTableStride must be a multiple of PhysicalDeviceRayTracingPipelinePropertiesKHR::shaderGroupHandleAlignment
• callableShaderBindingTableStride must be less than or equal to PhysicalDeviceRayTracingPipelinePropertiesKHR::maxShaderGroupStride
• If the currently bound ray tracing pipeline was created with flags that included PIPELINE_CREATE_RAY_TRACING_NO_NULL_CLOSEST_HIT_SHADERS_BIT_KHR, hitShaderBindingTableAddress must not be zero
• If the currently bound ray tracing pipeline was created with flags that included PIPELINE_CREATE_RAY_TRACING_NO_NULL_INTERSECTION_SHADERS_BIT_KHR, hitShaderBindingTableAddress must not be zero
• If the currently bound ray tracing pipeline was created with flags that included PIPELINE_CREATE_RAY_TRACING_NO_NULL_MISS_SHADERS_BIT_KHR, the shader group handle identified by missShaderBindingTableAddress must not be set to zero
• If the currently bound ray tracing pipeline was created with flags that included PIPELINE_CREATE_RAY_TRACING_NO_NULL_ANY_HIT_SHADERS_BIT_KHR, entries in the table identified by hitShaderBindingTableAddress accessed as a result of this command in order to execute an any-hit shader must not be set to zero
• If the currently bound ray tracing pipeline was created with flags that included PIPELINE_CREATE_RAY_TRACING_NO_NULL_CLOSEST_HIT_SHADERS_BIT_KHR, entries in the table identified by hitShaderBindingTableAddress accessed as a result of this command in order to execute a closest hit shader must not be set to zero
• If the currently bound ray tracing pipeline was created with flags that included PIPELINE_CREATE_RAY_TRACING_NO_NULL_INTERSECTION_SHADERS_BIT_KHR, entries in the table identified by hitShaderBindingTableAddress accessed as a result of this command in order to execute an intersection shader must not be set to zero
• Any non-zero hit shader group entries in the table identified by hitShaderBindingTableAddress accessed by this call from a geometry with a geometryType of GEOMETRY_TYPE_TRIANGLES_KHR must have been created with RAY_TRACING_SHADER_GROUP_TYPE_TRIANGLES_HIT_GROUP_KHR
• Any non-zero hit shader group entries in the table identified by hitShaderBindingTableAddress accessed by this call from a geometry with a geometryType of GEOMETRY_TYPE_AABBS_KHR must have been created with RAY_TRACING_SHADER_GROUP_TYPE_PROCEDURAL_HIT_GROUP_KHR
• width must be less than or equal to PhysicalDeviceLimits::maxComputeWorkGroupCount[0] × PhysicalDeviceLimits::maxComputeWorkGroupSize[0]
• height must be less than or equal to PhysicalDeviceLimits::maxComputeWorkGroupCount[1] × PhysicalDeviceLimits::maxComputeWorkGroupSize[1]
• depth must be less than or equal to PhysicalDeviceLimits::maxComputeWorkGroupCount[2] × PhysicalDeviceLimits::maxComputeWorkGroupSize[2]
• width × height × depth must be less than or equal to PhysicalDeviceRayTracingPipelinePropertiesKHR::maxRayDispatchInvocationCount

See Also

VK_KHR_ray_tracing_maintenance1, VK_KHR_ray_tracing_pipeline, DeviceAddress, DeviceSize

Constructors

TraceRaysIndirectCommand2KHR

Fields

• raygenShaderRecordAddress :: DeviceAddress

  raygenShaderRecordAddress is a DeviceAddress of the ray generation shader binding table record used by this command.

• raygenShaderRecordSize :: DeviceSize

  raygenShaderRecordSize is a DeviceSize number of bytes corresponding to the ray generation shader binding table record at base address raygenShaderRecordAddress.

• missShaderBindingTableAddress :: DeviceAddress

  missShaderBindingTableAddress is a DeviceAddress of the first record in the miss shader binding table used by this command.

• missShaderBindingTableSize :: DeviceSize

  missShaderBindingTableSize is a DeviceSize number of bytes corresponding to the total size of the miss shader binding table at missShaderBindingTableAddress that may be accessed by this command.

• missShaderBindingTableStride :: DeviceSize

  missShaderBindingTableStride is a DeviceSize number of bytes between records of the miss shader binding table.

• hitShaderBindingTableAddress :: DeviceAddress

  hitShaderBindingTableAddress is a DeviceAddress of the first record in the hit shader binding table used by this command.

• hitShaderBindingTableSize :: DeviceSize

  hitShaderBindingTableSize is a DeviceSize number of bytes corresponding to the total size of the hit shader binding table at hitShaderBindingTableAddress that may be accessed by this command.

• hitShaderBindingTableStride :: DeviceSize

  hitShaderBindingTableStride is a DeviceSize number of bytes between records of the hit shader binding table.

• callableShaderBindingTableAddress :: DeviceAddress

  callableShaderBindingTableAddress is a DeviceAddress of the first record in the callable shader binding table used by this command.

• callableShaderBindingTableSize :: DeviceSize

  callableShaderBindingTableSize is a DeviceSize number of bytes corresponding to the total size of the callable shader binding table at callableShaderBindingTableAddress that may be accessed by this command.

• callableShaderBindingTableStride :: DeviceSize

  callableShaderBindingTableStride is a DeviceSize number of bytes between records of the callable shader binding table.

• width :: Word32

  width is the width of the ray trace query dimensions.

• height :: Word32

  height is height of the ray trace query dimensions.

• depth :: Word32

  depth is depth of the ray trace query dimensions.

Instances

Storable TraceRaysIndirectCommand2KHR

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_maintenance1

Methods

sizeOf :: TraceRaysIndirectCommand2KHR -> Int

alignment :: TraceRaysIndirectCommand2KHR -> Int

peekElemOff :: Ptr TraceRaysIndirectCommand2KHR -> Int -> IO TraceRaysIndirectCommand2KHR

pokeElemOff :: Ptr TraceRaysIndirectCommand2KHR -> Int -> TraceRaysIndirectCommand2KHR -> IO ()

peekByteOff :: Ptr b -> Int -> IO TraceRaysIndirectCommand2KHR

pokeByteOff :: Ptr b -> Int -> TraceRaysIndirectCommand2KHR -> IO ()

peek :: Ptr TraceRaysIndirectCommand2KHR -> IO TraceRaysIndirectCommand2KHR

poke :: Ptr TraceRaysIndirectCommand2KHR -> TraceRaysIndirectCommand2KHR -> IO ()

Show TraceRaysIndirectCommand2KHR

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_maintenance1

Methods

showsPrec :: Int -> TraceRaysIndirectCommand2KHR -> ShowS

show :: TraceRaysIndirectCommand2KHR -> String

showList :: [TraceRaysIndirectCommand2KHR] -> ShowS

Eq TraceRaysIndirectCommand2KHR

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_maintenance1

Methods

(==) :: TraceRaysIndirectCommand2KHR -> TraceRaysIndirectCommand2KHR -> Bool

(/=) :: TraceRaysIndirectCommand2KHR -> TraceRaysIndirectCommand2KHR -> Bool

FromCStruct TraceRaysIndirectCommand2KHR

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_maintenance1

Methods

peekCStruct :: Ptr TraceRaysIndirectCommand2KHR -> IO TraceRaysIndirectCommand2KHR

ToCStruct TraceRaysIndirectCommand2KHR

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_maintenance1

Methods

withCStruct :: TraceRaysIndirectCommand2KHR -> (Ptr TraceRaysIndirectCommand2KHR -> IO b) -> IO b

pokeCStruct :: Ptr TraceRaysIndirectCommand2KHR -> TraceRaysIndirectCommand2KHR -> IO b -> IO b

withZeroCStruct :: (Ptr TraceRaysIndirectCommand2KHR -> IO b) -> IO b

pokeZeroCStruct :: Ptr TraceRaysIndirectCommand2KHR -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero TraceRaysIndirectCommand2KHR

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_maintenance1

Methods

zero :: TraceRaysIndirectCommand2KHR

data PhysicalDeviceRayTracingMaintenance1FeaturesKHR

VkPhysicalDeviceRayTracingMaintenance1FeaturesKHR - Structure describing the ray tracing maintenance features that can be supported by an implementation

Members

This structure describes the following features:

Description

If the PhysicalDeviceRayTracingMaintenance1FeaturesKHR 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. PhysicalDeviceRayTracingMaintenance1FeaturesKHR can also be used in the pNext chain of DeviceCreateInfo to selectively enable these features.

Valid Usage (Implicit)

See Also

VK_KHR_ray_tracing_maintenance1, Bool32, StructureType

Constructors

PhysicalDeviceRayTracingMaintenance1FeaturesKHR

Fields

• rayTracingMaintenance1 :: Bool

  rayTracingMaintenance1 indicates that the implementation supports the following:

  • The CullMaskKHR SPIR-V builtin using the SPV_KHR_ray_cull_mask SPIR-V extension.
  • Additional acceleration structure property queries: QUERY_TYPE_ACCELERATION_STRUCTURE_SERIALIZATION_BOTTOM_LEVEL_POINTERS_KHR and QUERY_TYPE_ACCELERATION_STRUCTURE_SIZE_KHR.
  • A new access flag ACCESS_2_SHADER_BINDING_TABLE_READ_BIT_KHR.
  • A new pipeline stage flag bit PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_COPY_BIT_KHR
• rayTracingPipelineTraceRaysIndirect2 :: Bool

  rayTracingPipelineTraceRaysIndirect2 indicates whether the implementation supports the extended indirect ray tracing command cmdTraceRaysIndirect2KHR.

Instances

Storable PhysicalDeviceRayTracingMaintenance1FeaturesKHR

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_maintenance1

Methods

sizeOf :: PhysicalDeviceRayTracingMaintenance1FeaturesKHR -> Int

alignment :: PhysicalDeviceRayTracingMaintenance1FeaturesKHR -> Int

peekElemOff :: Ptr PhysicalDeviceRayTracingMaintenance1FeaturesKHR -> Int -> IO PhysicalDeviceRayTracingMaintenance1FeaturesKHR

pokeElemOff :: Ptr PhysicalDeviceRayTracingMaintenance1FeaturesKHR -> Int -> PhysicalDeviceRayTracingMaintenance1FeaturesKHR -> IO ()

peekByteOff :: Ptr b -> Int -> IO PhysicalDeviceRayTracingMaintenance1FeaturesKHR

pokeByteOff :: Ptr b -> Int -> PhysicalDeviceRayTracingMaintenance1FeaturesKHR -> IO ()

peek :: Ptr PhysicalDeviceRayTracingMaintenance1FeaturesKHR -> IO PhysicalDeviceRayTracingMaintenance1FeaturesKHR

poke :: Ptr PhysicalDeviceRayTracingMaintenance1FeaturesKHR -> PhysicalDeviceRayTracingMaintenance1FeaturesKHR -> IO ()

Show PhysicalDeviceRayTracingMaintenance1FeaturesKHR

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_maintenance1

Methods

showsPrec :: Int -> PhysicalDeviceRayTracingMaintenance1FeaturesKHR -> ShowS

show :: PhysicalDeviceRayTracingMaintenance1FeaturesKHR -> String

showList :: [PhysicalDeviceRayTracingMaintenance1FeaturesKHR] -> ShowS

Eq PhysicalDeviceRayTracingMaintenance1FeaturesKHR

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_maintenance1

Methods

(==) :: PhysicalDeviceRayTracingMaintenance1FeaturesKHR -> PhysicalDeviceRayTracingMaintenance1FeaturesKHR -> Bool

(/=) :: PhysicalDeviceRayTracingMaintenance1FeaturesKHR -> PhysicalDeviceRayTracingMaintenance1FeaturesKHR -> Bool

FromCStruct PhysicalDeviceRayTracingMaintenance1FeaturesKHR

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_maintenance1

Methods

peekCStruct :: Ptr PhysicalDeviceRayTracingMaintenance1FeaturesKHR -> IO PhysicalDeviceRayTracingMaintenance1FeaturesKHR

ToCStruct PhysicalDeviceRayTracingMaintenance1FeaturesKHR

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_maintenance1

Methods

withCStruct :: PhysicalDeviceRayTracingMaintenance1FeaturesKHR -> (Ptr PhysicalDeviceRayTracingMaintenance1FeaturesKHR -> IO b) -> IO b

pokeCStruct :: Ptr PhysicalDeviceRayTracingMaintenance1FeaturesKHR -> PhysicalDeviceRayTracingMaintenance1FeaturesKHR -> IO b -> IO b

withZeroCStruct :: (Ptr PhysicalDeviceRayTracingMaintenance1FeaturesKHR -> IO b) -> IO b

pokeZeroCStruct :: Ptr PhysicalDeviceRayTracingMaintenance1FeaturesKHR -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero PhysicalDeviceRayTracingMaintenance1FeaturesKHR

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_maintenance1

Methods

zero :: PhysicalDeviceRayTracingMaintenance1FeaturesKHR

type KHR_RAY_TRACING_MAINTENANCE_1_SPEC_VERSION = 1

pattern KHR_RAY_TRACING_MAINTENANCE_1_SPEC_VERSION :: forall a. Integral a => a

type KHR_RAY_TRACING_MAINTENANCE_1_EXTENSION_NAME = "VK_KHR_ray_tracing_maintenance1"

pattern KHR_RAY_TRACING_MAINTENANCE_1_EXTENSION_NAME :: forall a. (Eq a, IsString a) => a