Safe Haskell	None
Language	Haskell2010

Vulkan.Extensions.VK_KHR_acceleration_structure

Description

Name

VK_KHR_acceleration_structure - device extension

VK_KHR_acceleration_structure

Name String: VK_KHR_acceleration_structure

Extension Type

Device extension

Registered Extension Number

151

Revision

13

Extension and Version Dependencies

Requires Vulkan 1.1
Requires VK_EXT_descriptor_indexing
Requires VK_KHR_buffer_device_address
Requires VK_KHR_deferred_host_operations

Contact

Daniel Koch @dgkoch%0A<<Here describe the issue or question you have about the VK_KHR_acceleration_structure extension> >

Other Extension Metadata

Last Modified Date: 2021-09-30

Contributors

Samuel Bourasseau, Adobe
Matthäus Chajdas, AMD
Greg Grebe, AMD
Nicolai Hähnle, AMD
Tobias Hector, AMD
Dave Oldcorn, AMD
Skyler Saleh, AMD
Mathieu Robart, Arm
Marius Bjorge, Arm
Tom Olson, Arm
Sebastian Tafuri, EA
Henrik Rydgard, Embark
Juan Cañada, Epic Games
Patrick Kelly, Epic Games
Yuriy O’Donnell, Epic Games
Michael Doggett, Facebook/Oculus
Ricardo Garcia, Igalia
Andrew Garrard, Imagination
Don Scorgie, Imagination
Dae Kim, Imagination
Joshua Barczak, Intel
Slawek Grajewski, Intel
Jeff Bolz, NVIDIA
Pascal Gautron, NVIDIA
Daniel Koch, NVIDIA
Christoph Kubisch, NVIDIA
Ashwin Lele, NVIDIA
Robert Stepinski, NVIDIA
Martin Stich, NVIDIA
Nuno Subtil, NVIDIA
Eric Werness, NVIDIA
Jon Leech, Khronos
Jeroen van Schijndel, OTOY
Juul Joosten, OTOY
Alex Bourd, Qualcomm
Roman Larionov, Qualcomm
David McAllister, Qualcomm
Lewis Gordon, Samsung
Ralph Potter, Samsung
Jasper Bekkers, Traverse Research
Jesse Barker, Unity
Baldur Karlsson, Valve

Description

In order to be efficient, rendering techniques such as ray tracing need a quick way to identify which primitives may be intersected by a ray traversing the geometries. Acceleration structures are the most common way to represent the geometry spatially sorted, in order to quickly identify such potential intersections.

This extension adds new functionalities:

Acceleration structure objects and build commands
Structures to describe geometry inputs to acceleration structure builds
Acceleration structure copy commands

New Object Types

AccelerationStructureKHR

New Commands

buildAccelerationStructuresKHR

New Structures

AabbPositionsKHR

New Unions

AccelerationStructureGeometryDataKHR

New Enums

AccelerationStructureBuildTypeKHR

New Bitmasks

AccelerationStructureCreateFlagsKHR

New Enum Constants

KHR_ACCELERATION_STRUCTURE_EXTENSION_NAME

If VK_KHR_format_feature_flags2 is supported:

Extending FormatFeatureFlagBits2KHR:
- FORMAT_FEATURE_2_ACCELERATION_STRUCTURE_VERTEX_BUFFER_BIT_KHR

Issues

How does this extension differ from VK_NV_ray_tracing?

DISCUSSION:

The following is a summary of the main functional differences between VK_KHR_acceleration_structure and VK_NV_ray_tracing:

added acceleration structure serialization / deserialization (COPY_ACCELERATION_STRUCTURE_MODE_SERIALIZE_KHR, COPY_ACCELERATION_STRUCTURE_MODE_DESERIALIZE_KHR, cmdCopyAccelerationStructureToMemoryKHR, cmdCopyMemoryToAccelerationStructureKHR)
document inactive primitives and instances
added PhysicalDeviceAccelerationStructureFeaturesKHR structure
added indirect and batched acceleration structure builds (cmdBuildAccelerationStructuresIndirectKHR)
added host acceleration structure commands
reworked geometry structures so they could be better shared between device, host, and indirect builds
explicitly made AccelerationStructureKHR use device addresses
added acceleration structure compatibility check function (getDeviceAccelerationStructureCompatibilityKHR)
add parameter for requesting memory requirements for host and/or device build
added format feature for acceleration structure build vertex formats (FORMAT_FEATURE_ACCELERATION_STRUCTURE_VERTEX_BUFFER_BIT_KHR)

Can you give a more detailed comparision of differences and similarities between VK_NV_ray_tracing and VK_KHR_acceleration_structure?

DISCUSSION:

The following is a more detailed comparision of which commands, structures, and enums are aliased, changed, or removed.

Aliased functionality — enums, structures, and commands that are considered equivalent:
- GeometryTypeNV ↔ GeometryTypeKHR
- AccelerationStructureTypeNV ↔ AccelerationStructureTypeKHR
- CopyAccelerationStructureModeNV ↔ CopyAccelerationStructureModeKHR
- GeometryFlagsNV ↔ GeometryFlagsKHR
- GeometryFlagBitsNV ↔ GeometryFlagBitsKHR
- GeometryInstanceFlagsNV ↔ GeometryInstanceFlagsKHR
- GeometryInstanceFlagBitsNV ↔ GeometryInstanceFlagBitsKHR
- BuildAccelerationStructureFlagsNV ↔ BuildAccelerationStructureFlagsKHR
- BuildAccelerationStructureFlagBitsNV ↔ BuildAccelerationStructureFlagBitsKHR
- TransformMatrixNV ↔ TransformMatrixKHR (added to VK_NV_ray_tracing for descriptive purposes)
- AabbPositionsNV ↔ AabbPositionsKHR (added to VK_NV_ray_tracing for descriptive purposes)
- AccelerationStructureInstanceNV ↔ AccelerationStructureInstanceKHR (added to VK_NV_ray_tracing for descriptive purposes)
Changed enums, structures, and commands:
- renamed GEOMETRY_INSTANCE_TRIANGLE_CULL_DISABLE_BIT_NV → GEOMETRY_INSTANCE_TRIANGLE_FACING_CULL_DISABLE_BIT_KHR in GeometryInstanceFlagBitsKHR
- GeometryTrianglesNV → AccelerationStructureGeometryTrianglesDataKHR (device or host address instead of buffer+offset)
- GeometryAABBNV → AccelerationStructureGeometryAabbsDataKHR (device or host address instead of buffer+offset)
- GeometryDataNV → AccelerationStructureGeometryDataKHR (union of triangle/aabbs/instances)
- GeometryNV → AccelerationStructureGeometryKHR (changed type of geometry)
- AccelerationStructureCreateInfoNV → AccelerationStructureCreateInfoKHR (reshuffle geometry layout/information)
- PhysicalDeviceRayTracingPropertiesNV → PhysicalDeviceAccelerationStructurePropertiesKHR (for acceleration structure properties, renamed maxTriangleCount to maxPrimitiveCount, added per stage and update after bind limits) and PhysicalDeviceRayTracingPipelinePropertiesKHR (for ray tracing pipeline properties)
- AccelerationStructureMemoryRequirementsInfoNV (deleted - replaced by allocating on top of Buffer)
- WriteDescriptorSetAccelerationStructureNV → WriteDescriptorSetAccelerationStructureKHR (different acceleration structure type)
- createAccelerationStructureNV → createAccelerationStructureKHR (device address, different geometry layout/information)
- getAccelerationStructureMemoryRequirementsNV (deleted - replaced by allocating on top of Buffer)
- cmdBuildAccelerationStructureNV → cmdBuildAccelerationStructuresKHR (params moved to structs, layout differences)
- cmdCopyAccelerationStructureNV → cmdCopyAccelerationStructureKHR (params to struct, extendable)
- getAccelerationStructureHandleNV → getAccelerationStructureDeviceAddressKHR (device address instead of handle)
- AccelerationStructureMemoryRequirementsTypeNV → size queries for scratch space moved to getAccelerationStructureBuildSizesKHR
- destroyAccelerationStructureNV → destroyAccelerationStructureKHR (different acceleration structure types)
- cmdWriteAccelerationStructuresPropertiesNV → cmdWriteAccelerationStructuresPropertiesKHR (different acceleration structure types)
Added enums, structures and commands:
- GEOMETRY_TYPE_INSTANCES_KHR to GeometryTypeKHR enum
- COPY_ACCELERATION_STRUCTURE_MODE_SERIALIZE_KHR, COPY_ACCELERATION_STRUCTURE_MODE_DESERIALIZE_KHR to CopyAccelerationStructureModeKHR enum
- PhysicalDeviceAccelerationStructureFeaturesKHR structure
- AccelerationStructureBuildTypeKHR enum
- BuildAccelerationStructureModeKHR enum
- DeviceOrHostAddressKHR and DeviceOrHostAddressConstKHR unions
- AccelerationStructureBuildRangeInfoKHR struct
- AccelerationStructureGeometryInstancesDataKHR struct
- AccelerationStructureDeviceAddressInfoKHR struct
- AccelerationStructureVersionInfoKHR struct
- StridedDeviceAddressRegionKHR struct
- CopyAccelerationStructureToMemoryInfoKHR struct
- CopyMemoryToAccelerationStructureInfoKHR struct
- CopyAccelerationStructureInfoKHR struct
- buildAccelerationStructuresKHR command (host build)
- copyAccelerationStructureKHR command (host copy)
- copyAccelerationStructureToMemoryKHR (host serialize)
- copyMemoryToAccelerationStructureKHR (host deserialize)
- writeAccelerationStructuresPropertiesKHR (host properties)
- cmdCopyAccelerationStructureToMemoryKHR (device serialize)
- cmdCopyMemoryToAccelerationStructureKHR (device deserialize)
- getDeviceAccelerationStructureCompatibilityKHR (serialization)

What are the changes between the public provisional (VK_KHR_ray_tracing v8) release and the internal provisional (VK_KHR_ray_tracing v9) release?

added geometryFlags to VkAccelerationStructureCreateGeometryTypeInfoKHR (later reworked to obsolete this)
added minAccelerationStructureScratchOffsetAlignment property to VkPhysicalDeviceRayTracingPropertiesKHR
fix naming and return enum from getDeviceAccelerationStructureCompatibilityKHR
- renamed VkAccelerationStructureVersionKHR to AccelerationStructureVersionInfoKHR
- renamed VK_STRUCTURE_TYPE_ACCELERATION_STRUCTURE_VERSION_KHR to STRUCTURE_TYPE_ACCELERATION_STRUCTURE_VERSION_INFO_KHR
- removed VK_ERROR_INCOMPATIBLE_VERSION_KHR
- added AccelerationStructureCompatibilityKHR enum
- remove return value from getDeviceAccelerationStructureCompatibilityKHR and added return enum parameter
Require Vulkan 1.1
added creation time capture and replay flags
- added AccelerationStructureCreateFlagBitsKHR and AccelerationStructureCreateFlagsKHR
- renamed the flags member of AccelerationStructureCreateInfoKHR to buildFlags (later removed) and added the createFlags member
change cmdBuildAccelerationStructuresIndirectKHR to use buffer device address for indirect parameter
make VK_KHR_deferred_host_operations an interaction instead of a required extension (later went back on this)
renamed VkAccelerationStructureBuildOffsetInfoKHR to AccelerationStructureBuildRangeInfoKHR
- renamed the ppOffsetInfos parameter of cmdBuildAccelerationStructuresKHR to ppBuildRangeInfos
Re-unify geometry description between build and create
- remove VkAccelerationStructureCreateGeometryTypeInfoKHR and VK_STRUCTURE_TYPE_ACCELERATION_STRUCTURE_CREATE_GEOMETRY_TYPE_INFO_KHR
- added VkAccelerationStructureCreateSizeInfoKHR structure (later removed)
- change type of the pGeometryInfos member of AccelerationStructureCreateInfoKHR from VkAccelerationStructureCreateGeometryTypeInfoKHR to AccelerationStructureGeometryKHR (later removed)
- added pCreateSizeInfos member to AccelerationStructureCreateInfoKHR (later removed)
Fix ppGeometries ambiguity, add pGeometries
- remove geometryArrayOfPointers member of VkAccelerationStructureBuildGeometryInfoKHR
- disambiguate two meanings of ppGeometries by explicitly adding pGeometries to the AccelerationStructureBuildGeometryInfoKHR structure and require one of them be NULL
added nullDescriptor support for acceleration structures
changed the update member of AccelerationStructureBuildGeometryInfoKHR from a bool to the mode BuildAccelerationStructureModeKHR enum which allows future extensibility in update types
Clarify deferred host ops for pipeline creation
- DeferredOperationKHR is now a top-level parameter for buildAccelerationStructuresKHR, createRayTracingPipelinesKHR, copyAccelerationStructureToMemoryKHR, copyAccelerationStructureKHR, and copyMemoryToAccelerationStructureKHR
- removed VkDeferredOperationInfoKHR structure
- change deferred host creation/return parameter behavior such that the implementation can modify such parameters until the deferred host operation completes
- VK_KHR_deferred_host_operations is required again
Change acceleration structure build to always be sized
- de-alias AccelerationStructureMemoryRequirementsTypeNV and VkAccelerationStructureMemoryRequirementsTypeKHR, and remove VkAccelerationStructureMemoryRequirementsTypeKHR
- add getAccelerationStructureBuildSizesKHR command and AccelerationStructureBuildSizesInfoKHR structure and STRUCTURE_TYPE_ACCELERATION_STRUCTURE_BUILD_SIZES_INFO_KHR enum to query sizes for acceleration structures and scratch storage
- move size queries for scratch space to getAccelerationStructureBuildSizesKHR
- remove compactedSize, buildFlags, maxGeometryCount, pGeometryInfos, pCreateSizeInfos members of AccelerationStructureCreateInfoKHR and add the size member
- add maxVertex member to AccelerationStructureGeometryTrianglesDataKHR structure
- remove VkAccelerationStructureCreateSizeInfoKHR structure

What are the changes between the internal provisional (VK_KHR_ray_tracing v9) release and the final (VK_KHR_acceleration_structure v11) release?

refactor VK_KHR_ray_tracing into 3 extensions, enabling implementation flexibility and decoupling ray query support from ray pipelines:
- VK_KHR_acceleration_structure (for acceleration structure operations)
- VK_KHR_ray_tracing_pipeline (for ray tracing pipeline and shader stages)
- VK_KHR_ray_query (for ray queries in existing shader stages)
clarify buffer usage flags for ray tracing
- BUFFER_USAGE_RAY_TRACING_BIT_NV is left alone in VK_NV_ray_tracing (required on scratch and instanceData)
- BUFFER_USAGE_SHADER_BINDING_TABLE_BIT_KHR is added as an alias of BUFFER_USAGE_RAY_TRACING_BIT_NV in VK_KHR_ray_tracing_pipeline and is required on shader binding table buffers
- BUFFER_USAGE_ACCELERATION_STRUCTURE_BUILD_INPUT_READ_ONLY_BIT_KHR is added in VK_KHR_acceleration_structure for all vertex, index, transform, aabb, and instance buffer data referenced by device build commands
- BUFFER_USAGE_STORAGE_BUFFER_BIT is used for scratchData
add max primitive counts (ppMaxPrimitiveCounts) to cmdBuildAccelerationStructuresIndirectKHR
Allocate acceleration structures from VkBuffers and add a mode to constrain the device address
- de-alias BindAccelerationStructureMemoryInfoNV and bindAccelerationStructureMemoryNV, and remove VkBindAccelerationStructureMemoryInfoKHR, VkAccelerationStructureMemoryRequirementsInfoKHR, and vkGetAccelerationStructureMemoryRequirementsKHR
- acceleration structures now take a Buffer and offset at creation time for memory placement
- add a new BUFFER_USAGE_ACCELERATION_STRUCTURE_STORAGE_BIT_KHR buffer usage for such buffers
- add a new ACCELERATION_STRUCTURE_TYPE_GENERIC_KHR acceleration structure type for layering
move GEOMETRY_TYPE_INSTANCES_KHR to main enum instead of being added via extension
make build commands more consistent - all now build multiple acceleration structures and are named plurally (cmdBuildAccelerationStructuresIndirectKHR, cmdBuildAccelerationStructuresKHR, buildAccelerationStructuresKHR)
add interactions with DESCRIPTOR_SET_LAYOUT_CREATE_UPDATE_AFTER_BIND_POOL_BIT for acceleration structures, including a new feature (descriptorBindingAccelerationStructureUpdateAfterBind) and 3 new properties (maxPerStageDescriptorAccelerationStructures, maxPerStageDescriptorUpdateAfterBindAccelerationStructures, maxDescriptorSetUpdateAfterBindAccelerationStructures)
extension is no longer provisional
define synchronization requirements for builds, traces, and copies
define synchronization requirements for AS build inputs and indirect build buffer

What is ACCELERATION_STRUCTURE_TYPE_GENERIC_KHR for?

RESOLVED: It is primarily intended for API layering. In DXR, the acceleration structure is basically just a buffer in a special layout, and you do not know at creation time whether it will be used as a top or bottom level acceleration structure. We thus added a generic acceleration structure type whose type is unknown at creation time, but is specified at build time instead. Applications which are written directly for Vulkan should not use it.

Version History

Revision 1, 2019-12-05 (Members of the Vulkan Ray Tracing TSG)
- Internal revisions (forked from VK_NV_ray_tracing)

Revision 2, 2019-12-20 (Daniel Koch, Eric Werness)
- Add const version of DeviceOrHostAddress (!3515)
- Add VU to clarify that only handles in the current pipeline are valid (!3518)
- Restore some missing VUs and add in-place update language (#1902, !3522)
- rename VkAccelerationStructureInstanceKHR member from accelerationStructure to accelerationStructureReference to better match its type (!3523)
- Allow VK_ERROR_INVALID_OPAQUE_CAPTURE_ADDRESS for pipeline creation if shader group handles cannot be reused (!3523)
- update documentation for the VK_ERROR_INVALID_OPAQUE_CAPTURE_ADDRESS error code and add missing documentation for new return codes from VK_KHR_deferred_host_operations (!3523)
- list new query types for VK_KHR_ray_tracing (!3523)
- Fix VU statements for VkAccelerationStructureGeometryKHR referring to correct union members and update to use more current wording (!3523)
Revision 3, 2020-01-10 (Daniel Koch, Jon Leech, Christoph Kubisch)
- Fix 'instance of' and 'that/which contains/defines' markup issues (!3528)
- factor out VK_KHR_pipeline_library as stand-alone extension (!3540)
- Resolve Vulkan-hpp issues (!3543)
- add missing require for VkGeometryInstanceFlagsKHR
- de-alias VK_STRUCTURE_TYPE_ACCELERATION_STRUCTURE_CREATE_INFO_NV since the KHR structure is no longer equivalent
- add len to pDataSize attribute for vkWriteAccelerationStructuresPropertiesKHR
Revision 4, 2020-01-23 (Daniel Koch, Eric Werness)
- Improve vkWriteAccelerationStructuresPropertiesKHR, add return value and VUs (#1947)
- Clarify language to allow multiple raygen shaders (#1959)
- Various editorial feedback (!3556)
- Add language to help deal with looped self-intersecting fans (#1901)
- Change vkCmdTraceRays{Indirect}KHR args to pointers (!3559)
- Add scratch address validation language (#1941, !3551)
- Fix definition and add hierarchy information for shader call scope (#1977, !3571)
Revision 5, 2020-02-04 (Eric Werness, Jeff Bolz, Daniel Koch)
- remove vestigial accelerationStructureUUID (!3582)
- update definition of repack instructions and improve memory model interactions (#1910, #1913, !3584)
- Fix wrong sType for VkPhysicalDeviceRayTracingFeaturesKHR (#1988)
- Use provisional SPIR-V capabilities (#1987)
- require rayTraversalPrimitiveCulling if rayQuery is supported (#1927)
- Miss shaders do not have object parameters (!3592)
- Fix missing required types in XML (!3592)
- clarify matching conditions for update (!3592)
- add goal that host and device builds be similar (!3592)
- clarify that maxPrimitiveCount limit should apply to triangles and AABBs (!3592)
- Require alignment for instance arrayOfPointers (!3592)
- Zero is a valid value for instance flags (!3592)
- Add some alignment VUs that got lost in refactoring (!3592)
- Recommend TMin epsilon rather than culling (!3592)
- Get angle from dot product not cross product (!3592)
- Clarify that AH can access the payload and attributes (!3592)
- Match DXR behavior for inactive primitive definition (!3592)
- Use a more generic term than degenerate for inactive to avoid confusion (!3592)
Revision 6, 2020-02-20 (Daniel Koch)
- fix some dangling NV references (#1996)
- rename VkCmdTraceRaysIndirectCommandKHR to VkTraceRaysIndirectCommandKHR (!3607)
- update contributor list (!3611)
- use uint64_t instead of VkAccelerationStructureReferenceKHR in VkAccelerationStructureInstanceKHR (#2004)
Revision 7, 2020-02-28 (Tobias Hector)
- remove HitTKHR SPIR-V builtin (spirv/spirv-extensions#7)
Revision 8, 2020-03-06 (Tobias Hector, Dae Kim, Daniel Koch, Jeff Bolz, Eric Werness)
- explicitly state that Tmax is updated when new closest intersection is accepted (#2020,!3536)
- Made references to min and max t values consistent (!3644)
- finish enumerating differences relative to VK_NV_ray_tracing in issues (1) and (2) (#1974,!3642)
- fix formatting in some math equations (!3642)
- Restrict the Hit Kind operand of OpReportIntersectionKHR to 7-bits (spirv/spirv-extensions#8,!3646)
- Say ray tracing 'should' be watertight (#2008,!3631)
- Clarify memory requirements for ray tracing buffers (#2005,!3649)
- Add callable size limits (#1997,!3652)
Revision 9, 2020-04-15 (Eric Werness, Daniel Koch, Tobias Hector, Joshua Barczak)
- Add geometry flags to acceleration structure creation (!3672)
- add build scratch memory alignment (minAccelerationStructureScratchOffsetAlignment) (#2065,!3725)
- fix naming and return enum from vkGetDeviceAccelerationStructureCompatibilityKHR (#2051,!3726)
- require SPIR-V 1.4 (#2096,!3777)
- added creation time capture/replay flags (#2104,!3774)
- require Vulkan 1.1 (#2133,!3806)
- use device addresses instead of VkBuffers for ray tracing commands (#2074,!3815)
- add interactions with Vulkan 1.2 and VK_KHR_vulkan_memory_model (#2133,!3830)
- make VK_KHR_pipeline_library an interaction instead of required (2108,!3830)
- make VK_KHR_deferred_host_operations an interaction instead of required (#2045,!3830)
- removed maxCallableSize and added explicit stack size management for ray pipelines (#1997,!3817,!3772,!3844)
- improved documentation for VkAccelerationStructureVersionInfoKHR (#2135,3835)
- rename VkAccelerationStructureBuildOffsetInfoKHR to VkAccelerationStructureBuildRangeInfoKHR (#2058,!3754)
- Re-unify geometry description between build and create (!3754)
- Fix ppGeometries ambiguity, add pGeometries (#2032,!3811)
- add interactions with VK_EXT_robustness2 and allow nullDescriptor support for acceleration structures (#1920,!3848)
- added future extensibility for AS updates (#2114,!3849)
- Fix VU for dispatchrays and add a limit on the size of the full grid (#2160,!3851)
- Add shaderGroupHandleAlignment property (#2180,!3875)
- Clarify deferred host ops for pipeline creation (#2067,!3813)
- Change acceleration structure build to always be sized (2197,#2198,!3854,!3883,!3880)
Revision 10, 2020-07-03 (Mathieu Robart, Daniel Koch, Eric Werness, Tobias Hector)
- Decomposition of the specification, from VK_KHR_ray_tracing to VK_KHR_acceleration_structure (#1918,!3912)
- clarify buffer usage flags for ray tracing (#2181,!3939)
- add max primitive counts to build indirect command (#2233,!3944)
- Allocate acceleration structures from VkBuffers and add a mode to constrain the device address (#2131,!3936)
- Move VK_GEOMETRY_TYPE_INSTANCES_KHR to main enum (#2243,!3952)
- make build commands more consistent (#2247,!3958)
- add interactions with UPDATE_AFTER_BIND (#2128,!3986)
- correct and expand build command VUs (!4020)
- fix copy command VUs (!4018)
- added various alignment requirements (#2229,!3943)
- fix valid usage for arrays of geometryCount items (#2198,!4010)
- define what is allowed to change on RTAS updates and relevant VUs (#2177,!3961)
Revision 11, 2020-11-12 (Eric Werness, Josh Barczak, Daniel Koch, Tobias Hector)
- de-alias NV and KHR acceleration structure types and associated commands (#2271,!4035)
- specify alignment for host copy commands (#2273,!4037)
- document FORMAT_FEATURE_ACCELERATION_STRUCTURE_VERTEX_BUFFER_BIT_KHR
- specify that acceleration structures are non-linear (#2289,!4068)
- add several missing VUs for strides, vertexFormat, and indexType (#2315,!4069)
- restore VUs for VkAccelerationStructureBuildGeometryInfoKHR (#2337,!4098)
- ban multi-instance memory for host operations (#2324,!4102)
- allow dstAccelerationStructure to be null for vkGetAccelerationStructureBuildSizesKHR (#2330,!4111)
- more build VU cleanup (4130)
- specify host endianness for AS serialization (#2261,!4136)
- add invertible transform matrix VU (#1710,!4140)
- require geometryCount to be 1 for TLAS builds (!4145)
- improved validity conditions for build addresses (#4142)
- add single statement SPIR-V VUs, build limit VUs (!4158)
- document limits for vertex and aabb strides (#2390,!4184)
- specify that PIPELINE_STAGE_ACCELERATION_STRUCTURE_BUILD_BIT_KHR applies to AS copies (4173)
- define sync for AS build inputs and indirect buffer (#2407,!4208)
Revision 12, 2021-08-06 (Samuel Bourasseau)
- rename VK_GEOMETRY_INSTANCE_TRIANGLE_FRONT_COUNTERCLOCKWISE_BIT_KHR to VK_GEOMETRY_INSTANCE_TRIANGLE_FLIP_FACING_BIT_KHR (keep previous as alias).
- Clarify description and add note.
Revision 13, 2021-09-30 (Jon Leech)
- Add interaction with VK_KHR_format_feature_flags2 to vk.xml

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

destroyAccelerationStructureKHR :: forall io. MonadIO io => Device -> AccelerationStructureKHR -> ("allocator" ::: Maybe AllocationCallbacks) -> io ()
cmdCopyAccelerationStructureKHR :: forall io. MonadIO io => CommandBuffer -> CopyAccelerationStructureInfoKHR -> io ()
copyAccelerationStructureKHR :: forall io. MonadIO io => Device -> DeferredOperationKHR -> CopyAccelerationStructureInfoKHR -> io Result
cmdCopyAccelerationStructureToMemoryKHR :: forall io. MonadIO io => CommandBuffer -> CopyAccelerationStructureToMemoryInfoKHR -> io ()
copyAccelerationStructureToMemoryKHR :: forall io. MonadIO io => Device -> DeferredOperationKHR -> CopyAccelerationStructureToMemoryInfoKHR -> io Result
cmdCopyMemoryToAccelerationStructureKHR :: forall io. MonadIO io => CommandBuffer -> CopyMemoryToAccelerationStructureInfoKHR -> io ()
copyMemoryToAccelerationStructureKHR :: forall io. MonadIO io => Device -> DeferredOperationKHR -> CopyMemoryToAccelerationStructureInfoKHR -> io Result
cmdWriteAccelerationStructuresPropertiesKHR :: forall io. MonadIO io => CommandBuffer -> ("accelerationStructures" ::: Vector AccelerationStructureKHR) -> QueryType -> QueryPool -> ("firstQuery" ::: Word32) -> io ()
writeAccelerationStructuresPropertiesKHR :: forall io. MonadIO io => Device -> ("accelerationStructures" ::: Vector AccelerationStructureKHR) -> QueryType -> ("dataSize" ::: Word64) -> ("data" ::: Ptr ()) -> ("stride" ::: Word64) -> io ()
getDeviceAccelerationStructureCompatibilityKHR :: forall io. MonadIO io => Device -> AccelerationStructureVersionInfoKHR -> io AccelerationStructureCompatibilityKHR
createAccelerationStructureKHR :: forall a io. (Extendss AccelerationStructureCreateInfoKHR a, PokeChain a, MonadIO io) => Device -> AccelerationStructureCreateInfoKHR a -> ("allocator" ::: Maybe AllocationCallbacks) -> io AccelerationStructureKHR
withAccelerationStructureKHR :: forall a io r. (Extendss AccelerationStructureCreateInfoKHR a, PokeChain a, MonadIO io) => Device -> AccelerationStructureCreateInfoKHR a -> Maybe AllocationCallbacks -> (io AccelerationStructureKHR -> (AccelerationStructureKHR -> io ()) -> r) -> r
cmdBuildAccelerationStructuresKHR :: forall io. MonadIO io => CommandBuffer -> ("infos" ::: Vector AccelerationStructureBuildGeometryInfoKHR) -> ("buildRangeInfos" ::: Vector (Vector AccelerationStructureBuildRangeInfoKHR)) -> io ()
cmdBuildAccelerationStructuresIndirectKHR :: forall io. MonadIO io => CommandBuffer -> ("infos" ::: Vector AccelerationStructureBuildGeometryInfoKHR) -> ("indirectDeviceAddresses" ::: Vector DeviceAddress) -> ("indirectStrides" ::: Vector Word32) -> ("maxPrimitiveCounts" ::: Vector (Vector Word32)) -> io ()
buildAccelerationStructuresKHR :: forall io. MonadIO io => Device -> DeferredOperationKHR -> ("infos" ::: Vector AccelerationStructureBuildGeometryInfoKHR) -> ("buildRangeInfos" ::: Vector (Vector AccelerationStructureBuildRangeInfoKHR)) -> io Result
getAccelerationStructureDeviceAddressKHR :: forall io. MonadIO io => Device -> AccelerationStructureDeviceAddressInfoKHR -> io DeviceAddress
getAccelerationStructureBuildSizesKHR :: forall io. MonadIO io => Device -> AccelerationStructureBuildTypeKHR -> ("buildInfo" ::: AccelerationStructureBuildGeometryInfoKHR) -> ("maxPrimitiveCounts" ::: Vector Word32) -> io ("sizeInfo" ::: AccelerationStructureBuildSizesInfoKHR)
pattern GEOMETRY_INSTANCE_TRIANGLE_FRONT_COUNTERCLOCKWISE_BIT_KHR :: GeometryInstanceFlagBitsKHR
data WriteDescriptorSetAccelerationStructureKHR = WriteDescriptorSetAccelerationStructureKHR {
- accelerationStructures :: Vector AccelerationStructureKHR
}
data PhysicalDeviceAccelerationStructureFeaturesKHR = PhysicalDeviceAccelerationStructureFeaturesKHR {
- accelerationStructure :: Bool
- accelerationStructureCaptureReplay :: Bool
- accelerationStructureIndirectBuild :: Bool
- accelerationStructureHostCommands :: Bool
- descriptorBindingAccelerationStructureUpdateAfterBind :: Bool
}
data PhysicalDeviceAccelerationStructurePropertiesKHR = PhysicalDeviceAccelerationStructurePropertiesKHR {
- maxGeometryCount :: Word64
- maxInstanceCount :: Word64
- maxPrimitiveCount :: Word64
- maxPerStageDescriptorAccelerationStructures :: Word32
- maxPerStageDescriptorUpdateAfterBindAccelerationStructures :: Word32
- maxDescriptorSetAccelerationStructures :: Word32
- maxDescriptorSetUpdateAfterBindAccelerationStructures :: Word32
- minAccelerationStructureScratchOffsetAlignment :: Word32
}
data AccelerationStructureGeometryTrianglesDataKHR (es :: [Type]) = AccelerationStructureGeometryTrianglesDataKHR {
- next :: Chain es
- vertexFormat :: Format
- vertexData :: DeviceOrHostAddressConstKHR
- vertexStride :: DeviceSize
- maxVertex :: Word32
- indexType :: IndexType
- indexData :: DeviceOrHostAddressConstKHR
- transformData :: DeviceOrHostAddressConstKHR
}
data AccelerationStructureGeometryAabbsDataKHR = AccelerationStructureGeometryAabbsDataKHR {
- data' :: DeviceOrHostAddressConstKHR
- stride :: DeviceSize
}
data AccelerationStructureGeometryInstancesDataKHR = AccelerationStructureGeometryInstancesDataKHR {
- arrayOfPointers :: Bool
- data' :: DeviceOrHostAddressConstKHR
}
data AccelerationStructureGeometryKHR = AccelerationStructureGeometryKHR {
- geometryType :: GeometryTypeKHR
- geometry :: AccelerationStructureGeometryDataKHR
- flags :: GeometryFlagsKHR
}
data AccelerationStructureBuildGeometryInfoKHR = AccelerationStructureBuildGeometryInfoKHR {
- type' :: AccelerationStructureTypeKHR
- flags :: BuildAccelerationStructureFlagsKHR
- mode :: BuildAccelerationStructureModeKHR
- srcAccelerationStructure :: AccelerationStructureKHR
- dstAccelerationStructure :: AccelerationStructureKHR
- geometries :: Vector AccelerationStructureGeometryKHR
- scratchData :: DeviceOrHostAddressKHR
}
data AccelerationStructureBuildRangeInfoKHR = AccelerationStructureBuildRangeInfoKHR {
- primitiveCount :: Word32
- primitiveOffset :: Word32
- firstVertex :: Word32
- transformOffset :: Word32
}
data AccelerationStructureCreateInfoKHR (es :: [Type]) = AccelerationStructureCreateInfoKHR {
- next :: Chain es
- createFlags :: AccelerationStructureCreateFlagsKHR
- buffer :: Buffer
- offset :: DeviceSize
- size :: DeviceSize
- type' :: AccelerationStructureTypeKHR
- deviceAddress :: DeviceAddress
}
data AabbPositionsKHR = AabbPositionsKHR {
- minX :: Float
- minY :: Float
- minZ :: Float
- maxX :: Float
- maxY :: Float
- maxZ :: Float
}
data TransformMatrixKHR = TransformMatrixKHR {
- matrixRow0 :: (Float, Float, Float, Float)
- matrixRow1 :: (Float, Float, Float, Float)
- matrixRow2 :: (Float, Float, Float, Float)
}
data AccelerationStructureInstanceKHR = AccelerationStructureInstanceKHR {
- transform :: TransformMatrixKHR
- instanceCustomIndex :: Word32
- mask :: Word32
- instanceShaderBindingTableRecordOffset :: Word32
- flags :: GeometryInstanceFlagsKHR
- accelerationStructureReference :: Word64
}
data AccelerationStructureDeviceAddressInfoKHR = AccelerationStructureDeviceAddressInfoKHR {
- accelerationStructure :: AccelerationStructureKHR
}
data AccelerationStructureVersionInfoKHR = AccelerationStructureVersionInfoKHR {
- versionData :: ByteString
}
data CopyAccelerationStructureInfoKHR = CopyAccelerationStructureInfoKHR {
- src :: AccelerationStructureKHR
- dst :: AccelerationStructureKHR
- mode :: CopyAccelerationStructureModeKHR
}
data CopyAccelerationStructureToMemoryInfoKHR = CopyAccelerationStructureToMemoryInfoKHR {
- src :: AccelerationStructureKHR
- dst :: DeviceOrHostAddressKHR
- mode :: CopyAccelerationStructureModeKHR
}
data CopyMemoryToAccelerationStructureInfoKHR = CopyMemoryToAccelerationStructureInfoKHR {
- src :: DeviceOrHostAddressConstKHR
- dst :: AccelerationStructureKHR
- mode :: CopyAccelerationStructureModeKHR
}
data AccelerationStructureBuildSizesInfoKHR = AccelerationStructureBuildSizesInfoKHR {
- accelerationStructureSize :: DeviceSize
- updateScratchSize :: DeviceSize
- buildScratchSize :: DeviceSize
}
data DeviceOrHostAddressKHR
- = DeviceAddress DeviceAddress
- | HostAddress (Ptr ())
data DeviceOrHostAddressConstKHR
- = DeviceAddressConst DeviceAddress
- | HostAddressConst (Ptr ())
data AccelerationStructureGeometryDataKHR
- = Triangles (SomeStruct AccelerationStructureGeometryTrianglesDataKHR)
- | Aabbs AccelerationStructureGeometryAabbsDataKHR
- | Instances AccelerationStructureGeometryInstancesDataKHR
type GeometryInstanceFlagsKHR = GeometryInstanceFlagBitsKHR
newtype GeometryInstanceFlagBitsKHR where
- GeometryInstanceFlagBitsKHR Flags
- pattern GEOMETRY_INSTANCE_TRIANGLE_FACING_CULL_DISABLE_BIT_KHR :: GeometryInstanceFlagBitsKHR
- pattern GEOMETRY_INSTANCE_TRIANGLE_FLIP_FACING_BIT_KHR :: GeometryInstanceFlagBitsKHR
- pattern GEOMETRY_INSTANCE_FORCE_OPAQUE_BIT_KHR :: GeometryInstanceFlagBitsKHR
- pattern GEOMETRY_INSTANCE_FORCE_NO_OPAQUE_BIT_KHR :: GeometryInstanceFlagBitsKHR
type GeometryFlagsKHR = GeometryFlagBitsKHR
newtype GeometryFlagBitsKHR where
- GeometryFlagBitsKHR Flags
- pattern GEOMETRY_OPAQUE_BIT_KHR :: GeometryFlagBitsKHR
- pattern GEOMETRY_NO_DUPLICATE_ANY_HIT_INVOCATION_BIT_KHR :: GeometryFlagBitsKHR
type BuildAccelerationStructureFlagsKHR = BuildAccelerationStructureFlagBitsKHR
newtype BuildAccelerationStructureFlagBitsKHR where
- BuildAccelerationStructureFlagBitsKHR Flags
- pattern BUILD_ACCELERATION_STRUCTURE_ALLOW_UPDATE_BIT_KHR :: BuildAccelerationStructureFlagBitsKHR
- pattern BUILD_ACCELERATION_STRUCTURE_ALLOW_COMPACTION_BIT_KHR :: BuildAccelerationStructureFlagBitsKHR
- pattern BUILD_ACCELERATION_STRUCTURE_PREFER_FAST_TRACE_BIT_KHR :: BuildAccelerationStructureFlagBitsKHR
- pattern BUILD_ACCELERATION_STRUCTURE_PREFER_FAST_BUILD_BIT_KHR :: BuildAccelerationStructureFlagBitsKHR
- pattern BUILD_ACCELERATION_STRUCTURE_LOW_MEMORY_BIT_KHR :: BuildAccelerationStructureFlagBitsKHR
- pattern BUILD_ACCELERATION_STRUCTURE_MOTION_BIT_NV :: BuildAccelerationStructureFlagBitsKHR
type AccelerationStructureCreateFlagsKHR = AccelerationStructureCreateFlagBitsKHR
newtype AccelerationStructureCreateFlagBitsKHR where
- AccelerationStructureCreateFlagBitsKHR Flags
- pattern ACCELERATION_STRUCTURE_CREATE_DEVICE_ADDRESS_CAPTURE_REPLAY_BIT_KHR :: AccelerationStructureCreateFlagBitsKHR
- pattern ACCELERATION_STRUCTURE_CREATE_MOTION_BIT_NV :: AccelerationStructureCreateFlagBitsKHR
newtype CopyAccelerationStructureModeKHR where
- CopyAccelerationStructureModeKHR Int32
- pattern COPY_ACCELERATION_STRUCTURE_MODE_CLONE_KHR :: CopyAccelerationStructureModeKHR
- pattern COPY_ACCELERATION_STRUCTURE_MODE_COMPACT_KHR :: CopyAccelerationStructureModeKHR
- pattern COPY_ACCELERATION_STRUCTURE_MODE_SERIALIZE_KHR :: CopyAccelerationStructureModeKHR
- pattern COPY_ACCELERATION_STRUCTURE_MODE_DESERIALIZE_KHR :: CopyAccelerationStructureModeKHR
newtype BuildAccelerationStructureModeKHR where
- BuildAccelerationStructureModeKHR Int32
- pattern BUILD_ACCELERATION_STRUCTURE_MODE_BUILD_KHR :: BuildAccelerationStructureModeKHR
- pattern BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR :: BuildAccelerationStructureModeKHR
newtype AccelerationStructureTypeKHR where
- AccelerationStructureTypeKHR Int32
- pattern ACCELERATION_STRUCTURE_TYPE_TOP_LEVEL_KHR :: AccelerationStructureTypeKHR
- pattern ACCELERATION_STRUCTURE_TYPE_BOTTOM_LEVEL_KHR :: AccelerationStructureTypeKHR
- pattern ACCELERATION_STRUCTURE_TYPE_GENERIC_KHR :: AccelerationStructureTypeKHR
newtype GeometryTypeKHR where
- GeometryTypeKHR Int32
- pattern GEOMETRY_TYPE_TRIANGLES_KHR :: GeometryTypeKHR
- pattern GEOMETRY_TYPE_AABBS_KHR :: GeometryTypeKHR
- pattern GEOMETRY_TYPE_INSTANCES_KHR :: GeometryTypeKHR
newtype AccelerationStructureBuildTypeKHR where
- AccelerationStructureBuildTypeKHR Int32
- pattern ACCELERATION_STRUCTURE_BUILD_TYPE_HOST_KHR :: AccelerationStructureBuildTypeKHR
- pattern ACCELERATION_STRUCTURE_BUILD_TYPE_DEVICE_KHR :: AccelerationStructureBuildTypeKHR
- pattern ACCELERATION_STRUCTURE_BUILD_TYPE_HOST_OR_DEVICE_KHR :: AccelerationStructureBuildTypeKHR
newtype AccelerationStructureCompatibilityKHR where
- AccelerationStructureCompatibilityKHR Int32
- pattern ACCELERATION_STRUCTURE_COMPATIBILITY_COMPATIBLE_KHR :: AccelerationStructureCompatibilityKHR
- pattern ACCELERATION_STRUCTURE_COMPATIBILITY_INCOMPATIBLE_KHR :: AccelerationStructureCompatibilityKHR
type FormatFeatureFlags2KHR = FormatFeatureFlagBits2KHR
newtype FormatFeatureFlagBits2KHR where
- FormatFeatureFlagBits2KHR Flags64
- pattern FORMAT_FEATURE_2_SAMPLED_IMAGE_BIT_KHR :: FormatFeatureFlagBits2KHR
- pattern FORMAT_FEATURE_2_STORAGE_IMAGE_BIT_KHR :: FormatFeatureFlagBits2KHR
- pattern FORMAT_FEATURE_2_STORAGE_IMAGE_ATOMIC_BIT_KHR :: FormatFeatureFlagBits2KHR
- pattern FORMAT_FEATURE_2_UNIFORM_TEXEL_BUFFER_BIT_KHR :: FormatFeatureFlagBits2KHR
- pattern FORMAT_FEATURE_2_STORAGE_TEXEL_BUFFER_BIT_KHR :: FormatFeatureFlagBits2KHR
- pattern FORMAT_FEATURE_2_STORAGE_TEXEL_BUFFER_ATOMIC_BIT_KHR :: FormatFeatureFlagBits2KHR
- pattern FORMAT_FEATURE_2_VERTEX_BUFFER_BIT_KHR :: FormatFeatureFlagBits2KHR
- pattern FORMAT_FEATURE_2_COLOR_ATTACHMENT_BIT_KHR :: FormatFeatureFlagBits2KHR
- pattern FORMAT_FEATURE_2_COLOR_ATTACHMENT_BLEND_BIT_KHR :: FormatFeatureFlagBits2KHR
- pattern FORMAT_FEATURE_2_DEPTH_STENCIL_ATTACHMENT_BIT_KHR :: FormatFeatureFlagBits2KHR
- pattern FORMAT_FEATURE_2_BLIT_SRC_BIT_KHR :: FormatFeatureFlagBits2KHR
- pattern FORMAT_FEATURE_2_BLIT_DST_BIT_KHR :: FormatFeatureFlagBits2KHR
- pattern FORMAT_FEATURE_2_SAMPLED_IMAGE_FILTER_LINEAR_BIT_KHR :: FormatFeatureFlagBits2KHR
- pattern FORMAT_FEATURE_2_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT :: FormatFeatureFlagBits2KHR
- pattern FORMAT_FEATURE_2_TRANSFER_SRC_BIT_KHR :: FormatFeatureFlagBits2KHR
- pattern FORMAT_FEATURE_2_TRANSFER_DST_BIT_KHR :: FormatFeatureFlagBits2KHR
- pattern FORMAT_FEATURE_2_SAMPLED_IMAGE_FILTER_MINMAX_BIT_KHR :: FormatFeatureFlagBits2KHR
- pattern FORMAT_FEATURE_2_MIDPOINT_CHROMA_SAMPLES_BIT_KHR :: FormatFeatureFlagBits2KHR
- pattern FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_LINEAR_FILTER_BIT_KHR :: FormatFeatureFlagBits2KHR
- pattern FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_SEPARATE_RECONSTRUCTION_FILTER_BIT_KHR :: FormatFeatureFlagBits2KHR
- pattern FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_CHROMA_RECONSTRUCTION_EXPLICIT_BIT_KHR :: FormatFeatureFlagBits2KHR
- pattern FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_CHROMA_RECONSTRUCTION_EXPLICIT_FORCEABLE_BIT_KHR :: FormatFeatureFlagBits2KHR
- pattern FORMAT_FEATURE_2_DISJOINT_BIT_KHR :: FormatFeatureFlagBits2KHR
- pattern FORMAT_FEATURE_2_COSITED_CHROMA_SAMPLES_BIT_KHR :: FormatFeatureFlagBits2KHR
- pattern FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT_KHR :: FormatFeatureFlagBits2KHR
- pattern FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT_KHR :: FormatFeatureFlagBits2KHR
- pattern FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT_KHR :: FormatFeatureFlagBits2KHR
- pattern FORMAT_FEATURE_2_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR :: FormatFeatureFlagBits2KHR
- pattern FORMAT_FEATURE_2_FRAGMENT_DENSITY_MAP_BIT_EXT :: FormatFeatureFlagBits2KHR
- pattern FORMAT_FEATURE_2_ACCELERATION_STRUCTURE_VERTEX_BUFFER_BIT_KHR :: FormatFeatureFlagBits2KHR
type KHR_ACCELERATION_STRUCTURE_SPEC_VERSION = 13
pattern KHR_ACCELERATION_STRUCTURE_SPEC_VERSION :: forall a. Integral a => a
type KHR_ACCELERATION_STRUCTURE_EXTENSION_NAME = "VK_KHR_acceleration_structure"
pattern KHR_ACCELERATION_STRUCTURE_EXTENSION_NAME :: forall a. (Eq a, IsString a) => a
newtype AccelerationStructureKHR = AccelerationStructureKHR Word64
newtype DeferredOperationKHR = DeferredOperationKHR Word64
newtype DebugReportObjectTypeEXT where
- DebugReportObjectTypeEXT Int32
- pattern DEBUG_REPORT_OBJECT_TYPE_UNKNOWN_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_INSTANCE_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_PHYSICAL_DEVICE_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_DEVICE_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_QUEUE_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_SEMAPHORE_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_COMMAND_BUFFER_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_FENCE_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_DEVICE_MEMORY_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_BUFFER_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_IMAGE_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_EVENT_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_QUERY_POOL_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_BUFFER_VIEW_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_IMAGE_VIEW_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_SHADER_MODULE_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_PIPELINE_CACHE_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_PIPELINE_LAYOUT_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_RENDER_PASS_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_PIPELINE_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_DESCRIPTOR_SET_LAYOUT_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_SAMPLER_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_DESCRIPTOR_POOL_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_DESCRIPTOR_SET_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_FRAMEBUFFER_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_COMMAND_POOL_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_SURFACE_KHR_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_SWAPCHAIN_KHR_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_DEBUG_REPORT_CALLBACK_EXT_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_DISPLAY_KHR_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_DISPLAY_MODE_KHR_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_VALIDATION_CACHE_EXT_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_BUFFER_COLLECTION_FUCHSIA_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_ACCELERATION_STRUCTURE_NV_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_SAMPLER_YCBCR_CONVERSION_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_ACCELERATION_STRUCTURE_KHR_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_CU_FUNCTION_NVX_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_CU_MODULE_NVX_EXT :: DebugReportObjectTypeEXT
- pattern DEBUG_REPORT_OBJECT_TYPE_DESCRIPTOR_UPDATE_TEMPLATE_EXT :: DebugReportObjectTypeEXT
type Flags64 = Word64

Documentation

destroyAccelerationStructureKHR Source #

Arguments

:: forall io. MonadIO io
=> Device	`device` is the logical device that destroys the acceleration structure.
-> AccelerationStructureKHR	`accelerationStructure` is the acceleration structure to destroy.
-> ("allocator" ::: Maybe AllocationCallbacks)	`pAllocator` controls host memory allocation as described in the Memory Allocation chapter.
-> io ()

vkDestroyAccelerationStructureKHR - Destroy an acceleration structure object

Valid Usage

All submitted commands that refer to accelerationStructure must have completed execution

If AllocationCallbacks were provided when accelerationStructure was created, a compatible set of callbacks must be provided here
If no AllocationCallbacks were provided when accelerationStructure was created, pAllocator must be NULL

Valid Usage (Implicit)

device must be a valid Device handle

If accelerationStructure is not NULL_HANDLE, accelerationStructure must be a valid AccelerationStructureKHR handle
If pAllocator is not NULL, pAllocator must be a valid pointer to a valid AllocationCallbacks structure
If accelerationStructure is a valid handle, it must have been created, allocated, or retrieved from device

Host Synchronization

Host access to accelerationStructure must be externally synchronized

Description

This command copies the pInfo->src acceleration structure to the pInfo->dst acceleration structure in the manner specified by pInfo->mode.

Accesses to pInfo->src and pInfo->dst must be synchronized with the PIPELINE_STAGE_ACCELERATION_STRUCTURE_BUILD_BIT_KHR pipeline stage and an access type of ACCESS_ACCELERATION_STRUCTURE_READ_BIT_KHR or ACCESS_ACCELERATION_STRUCTURE_WRITE_BIT_KHR as appropriate.

Valid Usage

The buffer used to create pInfo->src must be bound to device memory

The buffer used to create pInfo->dst must be bound to device memory

Valid Usage (Implicit)

commandBuffer must be a valid CommandBuffer handle

pInfo must be a valid pointer to a valid CopyAccelerationStructureInfoKHR structure
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

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	Supported Queue Types
Primary Secondary	Outside	Compute

Description

This command fulfills the same task as cmdCopyAccelerationStructureKHR but is executed by the host.

Valid Usage

If deferredOperation is not NULL_HANDLE, it must be a valid DeferredOperationKHR object

Any previous deferred operation that was associated with deferredOperation must be complete
The buffer used to create pInfo->src must be bound to host-visible device memory
The buffer used to create pInfo->dst must be bound to host-visible device memory
The ::accelerationStructureHostCommands feature must be enabled
The buffer used to create pInfo->src must be bound to memory that was not allocated with multiple instances
The buffer used to create pInfo->dst must be bound to memory that was not allocated with multiple instances

Valid Usage (Implicit)

device must be a valid Device handle

If deferredOperation is not NULL_HANDLE, deferredOperation must be a valid DeferredOperationKHR handle
pInfo must be a valid pointer to a valid CopyAccelerationStructureInfoKHR structure
If deferredOperation is a valid handle, it must have been created, allocated, or retrieved from device

Return Codes

Success

Failure

Description

Accesses to pInfo->src must be synchronized with the PIPELINE_STAGE_ACCELERATION_STRUCTURE_BUILD_BIT_KHR pipeline stage and an access type of ACCESS_ACCELERATION_STRUCTURE_READ_BIT_KHR. Accesses to the buffer indicated by pInfo->dst.deviceAddress must be synchronized with the PIPELINE_STAGE_ACCELERATION_STRUCTURE_BUILD_BIT_KHR pipeline stage and an access type of ACCESS_TRANSFER_WRITE_BIT.

This command produces the same results as copyAccelerationStructureToMemoryKHR, but writes its result to a device address, and is executed on the device rather than the host. The output may not necessarily be bit-for-bit identical, but it can be equally used by either cmdCopyMemoryToAccelerationStructureKHR or copyMemoryToAccelerationStructureKHR.

The defined header structure for the serialized data consists of:

UUID_SIZE bytes of data matching PhysicalDeviceIDProperties::driverUUID
UUID_SIZE bytes of data identifying the compatibility for comparison using getDeviceAccelerationStructureCompatibilityKHR
A 64-bit integer of the total size matching the value queried using QUERY_TYPE_ACCELERATION_STRUCTURE_SERIALIZATION_SIZE_KHR
A 64-bit integer of the deserialized size to be passed in to AccelerationStructureCreateInfoKHR::size
A 64-bit integer of the count of the number of acceleration structure handles following. This will be zero for a bottom-level acceleration structure. For top-level acceleration structures this number is implementation-dependent; the number of and ordering of the handles may not match the instance descriptions which were used to build the acceleration structure.

The corresponding handles matching the values returned by getAccelerationStructureDeviceAddressKHR or getAccelerationStructureHandleNV are tightly packed in the buffer following the count. The application is expected to store a mapping between those handles and the original application-generated bottom-level acceleration structures to provide when deserializing. The serialized data is written to the buffer (or read from the buffer) according to the host endianness.

Valid Usage

pInfo->dst.deviceAddress must be a valid device address for a buffer bound to device memory

pInfo->dst.deviceAddress must be aligned to 256 bytes
If the buffer pointed to by pInfo->dst.deviceAddress is non-sparse then it must be bound completely and contiguously to a single DeviceMemory object
The buffer used to create pInfo->src must be bound to device memory

Valid Usage (Implicit)

commandBuffer must be a valid CommandBuffer handle

pInfo must be a valid pointer to a valid CopyAccelerationStructureToMemoryInfoKHR structure
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

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	Supported Queue Types
Primary Secondary	Outside	Compute

Description

This command fulfills the same task as cmdCopyAccelerationStructureToMemoryKHR but is executed by the host.

This command produces the same results as cmdCopyAccelerationStructureToMemoryKHR, but writes its result directly to a host pointer, and is executed on the host rather than the device. The output may not necessarily be bit-for-bit identical, but it can be equally used by either cmdCopyMemoryToAccelerationStructureKHR or copyMemoryToAccelerationStructureKHR.

Valid Usage

If deferredOperation is not NULL_HANDLE, it must be a valid DeferredOperationKHR object

Any previous deferred operation that was associated with deferredOperation must be complete
The buffer used to create pInfo->src must be bound to host-visible device memory
pInfo->dst.hostAddress must be a valid host pointer
pInfo->dst.hostAddress must be aligned to 16 bytes
The ::accelerationStructureHostCommands feature must be enabled
The buffer used to create pInfo->src must be bound to memory that was not allocated with multiple instances

Valid Usage (Implicit)

device must be a valid Device handle

If deferredOperation is not NULL_HANDLE, deferredOperation must be a valid DeferredOperationKHR handle
pInfo must be a valid pointer to a valid CopyAccelerationStructureToMemoryInfoKHR structure
If deferredOperation is a valid handle, it must have been created, allocated, or retrieved from device

Return Codes

Success

Failure

Description

Accesses to pInfo->dst must be synchronized with the PIPELINE_STAGE_ACCELERATION_STRUCTURE_BUILD_BIT_KHR pipeline stage and an access type of ACCESS_ACCELERATION_STRUCTURE_WRITE_BIT_KHR. Accesses to the buffer indicated by pInfo->src.deviceAddress must be synchronized with the PIPELINE_STAGE_ACCELERATION_STRUCTURE_BUILD_BIT_KHR pipeline stage and an access type of ACCESS_TRANSFER_READ_BIT.

This command can accept acceleration structures produced by either cmdCopyAccelerationStructureToMemoryKHR or copyAccelerationStructureToMemoryKHR.

The structure provided as input to deserialize is as described in cmdCopyAccelerationStructureToMemoryKHR, with any acceleration structure handles filled in with the newly-queried handles to bottom level acceleration structures created before deserialization. These do not need to be built at deserialize time, but must be created.

Valid Usage

pInfo->src.deviceAddress must be a valid device address for a buffer bound to device memory

pInfo->src.deviceAddress must be aligned to 256 bytes
If the buffer pointed to by pInfo->src.deviceAddress is non-sparse then it must be bound completely and contiguously to a single DeviceMemory object
The buffer used to create pInfo->dst must be bound to device memory

Valid Usage (Implicit)

commandBuffer must be a valid CommandBuffer handle

pInfo must be a valid pointer to a valid CopyMemoryToAccelerationStructureInfoKHR structure
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

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	Supported Queue Types
Primary Secondary	Outside	Compute

Description

This command fulfills the same task as cmdCopyMemoryToAccelerationStructureKHR but is executed by the host.

This command can accept acceleration structures produced by either cmdCopyAccelerationStructureToMemoryKHR or copyAccelerationStructureToMemoryKHR.

Valid Usage

If deferredOperation is not NULL_HANDLE, it must be a valid DeferredOperationKHR object

Any previous deferred operation that was associated with deferredOperation must be complete
pInfo->src.hostAddress must be a valid host pointer
pInfo->src.hostAddress must be aligned to 16 bytes
The buffer used to create pInfo->dst must be bound to host-visible device memory
The ::accelerationStructureHostCommands feature must be enabled
The buffer used to create pInfo->dst must be bound to memory that was not allocated with multiple instances

Valid Usage (Implicit)

device must be a valid Device handle

If deferredOperation is not NULL_HANDLE, deferredOperation must be a valid DeferredOperationKHR handle
pInfo must be a valid pointer to a valid CopyMemoryToAccelerationStructureInfoKHR structure
If deferredOperation is a valid handle, it must have been created, allocated, or retrieved from device

Return Codes

Success

Failure

Description

Accesses to any of the acceleration structures listed in pAccelerationStructures must be synchronized with the PIPELINE_STAGE_ACCELERATION_STRUCTURE_BUILD_BIT_KHR pipeline stage and an access type of ACCESS_ACCELERATION_STRUCTURE_READ_BIT_KHR.

If queryType is QUERY_TYPE_ACCELERATION_STRUCTURE_COMPACTED_SIZE_KHR, then the value written out is the number of bytes required by a compacted acceleration structure.
If queryType is QUERY_TYPE_ACCELERATION_STRUCTURE_SERIALIZATION_SIZE_KHR, then the value written out is the number of bytes required by a serialized acceleration structure.

Valid Usage

queryPool must have been created with a queryType matching queryType

The queries identified by queryPool and firstQuery must be unavailable
The buffer used to create each acceleration structure in pAccelerationStructures must be bound to device memory
The sum of query plus accelerationStructureCount must be less than or equal to the number of queries in queryPool
All acceleration structures in pAccelerationStructures must have been built prior to the execution of this command
All acceleration structures in pAccelerationStructures must have been built with BUILD_ACCELERATION_STRUCTURE_ALLOW_COMPACTION_BIT_KHR if queryType is QUERY_TYPE_ACCELERATION_STRUCTURE_COMPACTED_SIZE_KHR
queryType must be QUERY_TYPE_ACCELERATION_STRUCTURE_COMPACTED_SIZE_KHR or QUERY_TYPE_ACCELERATION_STRUCTURE_SERIALIZATION_SIZE_KHR

Valid Usage (Implicit)

commandBuffer must be a valid CommandBuffer handle

pAccelerationStructures must be a valid pointer to an array of accelerationStructureCount valid AccelerationStructureKHR handles
queryType must be a valid QueryType value
queryPool must be a valid QueryPool 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
accelerationStructureCount must be greater than 0
Each of commandBuffer, queryPool, and the elements of pAccelerationStructures must have been created, allocated, or retrieved from the same Device

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	Supported Queue Types
Primary Secondary	Outside	Compute

Description

This command fulfills the same task as cmdWriteAccelerationStructuresPropertiesKHR but is executed by the host.

Valid Usage

All acceleration structures in pAccelerationStructures must have been built prior to the execution of this command

All acceleration structures in pAccelerationStructures must have been built with BUILD_ACCELERATION_STRUCTURE_ALLOW_COMPACTION_BIT_KHR if queryType is QUERY_TYPE_ACCELERATION_STRUCTURE_COMPACTED_SIZE_KHR
queryType must be QUERY_TYPE_ACCELERATION_STRUCTURE_COMPACTED_SIZE_KHR or QUERY_TYPE_ACCELERATION_STRUCTURE_SERIALIZATION_SIZE_KHR
If queryType is QUERY_TYPE_ACCELERATION_STRUCTURE_COMPACTED_SIZE_KHR, then stride must be a multiple of the size of DeviceSize
If queryType is QUERY_TYPE_ACCELERATION_STRUCTURE_COMPACTED_SIZE_KHR, then data must point to a DeviceSize
If queryType is QUERY_TYPE_ACCELERATION_STRUCTURE_SERIALIZATION_SIZE_KHR, then stride must be a multiple of the size of DeviceSize
If queryType is QUERY_TYPE_ACCELERATION_STRUCTURE_SERIALIZATION_SIZE_KHR, then data must point to a DeviceSize
dataSize must be greater than or equal to accelerationStructureCount*stride
The buffer used to create each acceleration structure in pAccelerationStructures must be bound to host-visible device memory
The ::accelerationStructureHostCommands feature must be enabled
The buffer used to create each acceleration structure in pAccelerationStructures must be bound to memory that was not allocated with multiple instances

Valid Usage (Implicit)

device must be a valid Device handle

pAccelerationStructures must be a valid pointer to an array of accelerationStructureCount valid AccelerationStructureKHR handles
queryType must be a valid QueryType value
pData must be a valid pointer to an array of dataSize bytes
accelerationStructureCount must be greater than 0
dataSize must be greater than 0
Each element of pAccelerationStructures must have been created, allocated, or retrieved from device

Return Codes

Success

SUCCESS

Failure

Description

Similar to other objects in Vulkan, the acceleration structure creation merely creates an object with a specific “shape”. The type and quantity of geometry that can be built into an acceleration structure is determined by the parameters of AccelerationStructureCreateInfoKHR.

Populating the data in the object after allocating and binding memory is done with commands such as cmdBuildAccelerationStructuresKHR, buildAccelerationStructuresKHR, cmdCopyAccelerationStructureKHR, and copyAccelerationStructureKHR.

The input buffers passed to acceleration structure build commands will be referenced by the implementation for the duration of the command. After the command completes, the acceleration structure may hold a reference to any acceleration structure specified by an active instance contained therein. Apart from this referencing, acceleration structures must be fully self-contained. The application may re-use or free any memory which was used by the command as an input or as scratch without affecting the results of ray traversal.

Valid Usage

The accelerationStructure feature must be enabled

If AccelerationStructureCreateInfoKHR::deviceAddress is not zero, the accelerationStructureCaptureReplay feature must be enabled
If device was created with multiple physical devices, then the bufferDeviceAddressMultiDevice feature must be enabled

Valid Usage (Implicit)

device must be a valid Device handle

pCreateInfo must be a valid pointer to a valid AccelerationStructureCreateInfoKHR structure
If pAllocator is not NULL, pAllocator must be a valid pointer to a valid AllocationCallbacks structure
pAccelerationStructure must be a valid pointer to a AccelerationStructureKHR handle

Return Codes

Success

SUCCESS

Failure

Description

The cmdBuildAccelerationStructuresKHR command provides the ability to initiate multiple acceleration structures builds, however there is no ordering or synchronization implied between any of the individual acceleration structure builds.

Note

This means that an application cannot build a top-level acceleration structure in the same cmdBuildAccelerationStructuresKHR call as the associated bottom-level or instance acceleration structures are being built. There also cannot be any memory aliasing between any acceleration structure memories or scratch memories being used by any of the builds.

Accesses to the acceleration structure scratch buffers as identified by the AccelerationStructureBuildGeometryInfoKHR::scratchData buffer device addresses must be synchronized with the PIPELINE_STAGE_ACCELERATION_STRUCTURE_BUILD_BIT_KHR pipeline stage and an access type of ACCESS_ACCELERATION_STRUCTURE_READ_BIT_KHR or ACCESS_ACCELERATION_STRUCTURE_WRITE_BIT_KHR. Similarly for accesses to each AccelerationStructureBuildGeometryInfoKHR::srcAccelerationStructure and AccelerationStructureBuildGeometryInfoKHR::dstAccelerationStructure.

Accesses to other input buffers as identified by any used values of AccelerationStructureGeometryMotionTrianglesDataNV::vertexData, AccelerationStructureGeometryTrianglesDataKHR::vertexData, AccelerationStructureGeometryTrianglesDataKHR::indexData, AccelerationStructureGeometryTrianglesDataKHR::transformData, AccelerationStructureGeometryAabbsDataKHR::data, and AccelerationStructureGeometryInstancesDataKHR::data must be synchronized with the PIPELINE_STAGE_ACCELERATION_STRUCTURE_BUILD_BIT_KHR pipeline stage and an access type of ACCESS_SHADER_READ_BIT.

Valid Usage

The mode member of each element of pInfos must be a valid BuildAccelerationStructureModeKHR value

If the srcAccelerationStructure member of any element of pInfos is not NULL_HANDLE, the srcAccelerationStructure member must be a valid AccelerationStructureKHR handle
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, its srcAccelerationStructure member must not be NULL_HANDLE
The srcAccelerationStructure member of any element of pInfos must not be the same acceleration structure as the dstAccelerationStructure member of any other element of pInfos
The dstAccelerationStructure member of any element of pInfos must not be the same acceleration structure as the dstAccelerationStructure member of any other element of pInfos
The dstAccelerationStructure member of any element of pInfos must be a valid AccelerationStructureKHR handle
For each element of pInfos, if its type member is ACCELERATION_STRUCTURE_TYPE_TOP_LEVEL_KHR, its dstAccelerationStructure member must have been created with a value of AccelerationStructureCreateInfoKHR::type equal to either ACCELERATION_STRUCTURE_TYPE_TOP_LEVEL_KHR or ACCELERATION_STRUCTURE_TYPE_GENERIC_KHR
For each element of pInfos, if its type member is ACCELERATION_STRUCTURE_TYPE_BOTTOM_LEVEL_KHR, its dstAccelerationStructure member must have been created with a value of AccelerationStructureCreateInfoKHR::type equal to either ACCELERATION_STRUCTURE_TYPE_BOTTOM_LEVEL_KHR or ACCELERATION_STRUCTURE_TYPE_GENERIC_KHR
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, inactive primitives in its srcAccelerationStructure member must not be made active
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, active primitives in its srcAccelerationStructure member must not be made inactive
The dstAccelerationStructure member of any element of pInfos must not be referenced by the geometry.instances.data member of any element of pGeometries or ppGeometries with a geometryType of GEOMETRY_TYPE_INSTANCES_KHR in any other element of pInfos
The range of memory backing the dstAccelerationStructure member of any element of pInfos that is accessed by this command must not overlap the memory backing the srcAccelerationStructure member of any other element of pInfos with a mode equal to BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, which is accessed by this command
The range of memory backing the dstAccelerationStructure member of any element of pInfos that is accessed by this command must not overlap the memory backing the dstAccelerationStructure member of any other element of pInfos, which is accessed by this command
The range of memory backing the dstAccelerationStructure member of any element of pInfos that is accessed by this command must not overlap the memory backing the scratchData member of any element of pInfos (including the same element), which is accessed by this command
The range of memory backing the scratchData member of any element of pInfos that is accessed by this command must not overlap the memory backing the scratchData member of any other element of pInfos, which is accessed by this command
The range of memory backing the scratchData member of any element of pInfos that is accessed by this command must not overlap the memory backing the srcAccelerationStructure member of any element of pInfos with a mode equal to BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR (including the same element), which is accessed by this command
The range of memory backing the dstAccelerationStructure member of any element of pInfos that is accessed by this command must not overlap the memory backing any acceleration structure referenced by the geometry.instances.data member of any element of pGeometries or ppGeometries with a geometryType of GEOMETRY_TYPE_INSTANCES_KHR in any other element of pInfos, which is accessed by this command
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, its srcAccelerationStructure member must have previously been constructed with BUILD_ACCELERATION_STRUCTURE_ALLOW_UPDATE_BIT_KHR set in AccelerationStructureBuildGeometryInfoKHR::flags in the build
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, its srcAccelerationStructure and dstAccelerationStructure members must either be the same AccelerationStructureKHR, or not have any memory aliasing
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, its geometryCount member must have the same value which was specified when srcAccelerationStructure was last built
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, its flags member must have the same value which was specified when srcAccelerationStructure was last built
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, its type member must have the same value which was specified when srcAccelerationStructure was last built
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, then for each AccelerationStructureGeometryKHR structure referred to by its pGeometries or ppGeometries members, its geometryType member must have the same value which was specified when srcAccelerationStructure was last built
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, then for each AccelerationStructureGeometryKHR structure referred to by its pGeometries or ppGeometries members, its flags member must have the same value which was specified when srcAccelerationStructure was last built
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, then for each AccelerationStructureGeometryKHR structure referred to by its pGeometries or ppGeometries members, if geometryType is GEOMETRY_TYPE_TRIANGLES_KHR, its geometry.triangles.vertexFormat member must have the same value which was specified when srcAccelerationStructure was last built
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, then for each AccelerationStructureGeometryKHR structure referred to by its pGeometries or ppGeometries members, if geometryType is GEOMETRY_TYPE_TRIANGLES_KHR, its geometry.triangles.maxVertex member must have the same value which was specified when srcAccelerationStructure was last built
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, then for each AccelerationStructureGeometryKHR structure referred to by its pGeometries or ppGeometries members, if geometryType is GEOMETRY_TYPE_TRIANGLES_KHR, its geometry.triangles.indexType member must have the same value which was specified when srcAccelerationStructure was last built
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, then for each AccelerationStructureGeometryKHR structure referred to by its pGeometries or ppGeometries members, if geometryType is GEOMETRY_TYPE_TRIANGLES_KHR, if its geometry.triangles.transformData address was NULL when srcAccelerationStructure was last built, then it must be NULL
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, then for each AccelerationStructureGeometryKHR structure referred to by its pGeometries or ppGeometries members, if geometryType is GEOMETRY_TYPE_TRIANGLES_KHR, if its geometry.triangles.transformData address was not NULL when srcAccelerationStructure was last built, then it must not be NULL
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, then for each AccelerationStructureGeometryKHR structure referred to by its pGeometries or ppGeometries members, if geometryType is GEOMETRY_TYPE_TRIANGLES_KHR, and geometry.triangles.indexType is not INDEX_TYPE_NONE_KHR, then the value of each index referenced must be the same as the corresponding index value when srcAccelerationStructure was last built
For each AccelerationStructureBuildRangeInfoKHR referenced by this command, its primitiveCount member must have the same value which was specified when srcAccelerationStructure was last built
For each AccelerationStructureBuildRangeInfoKHR referenced by this command, if the corresponding geometry uses indices, its firstVertex member must have the same value which was specified when srcAccelerationStructure was last built
For each element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_INSTANCES_KHR, the corresponding ppBuildRangeInfos[i][j].primitiveCount must be less than or equal to PhysicalDeviceAccelerationStructurePropertiesKHR::maxInstanceCount
For each element of pInfos, the buffer used to create its dstAccelerationStructure member must be bound to device memory
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR the buffer used to create its srcAccelerationStructure member must be bound to device memory
For each element of pInfos, the buffer used to create each acceleration structure referenced by the geometry.instances.data member of any element of pGeometries or ppGeometries with a geometryType of GEOMETRY_TYPE_INSTANCES_KHR must be bound to device memory
If pInfos[i].mode is BUILD_ACCELERATION_STRUCTURE_MODE_BUILD_KHR, all addresses between pInfos[i].scratchData.deviceAddress and pInfos[i].scratchData.deviceAddress + N - 1 must be in the buffer device address range of the same buffer, where N is given by the buildScratchSize member of the AccelerationStructureBuildSizesInfoKHR structure returned from a call to getAccelerationStructureBuildSizesKHR with an identical AccelerationStructureBuildGeometryInfoKHR structure and primitive count
If pInfos[i].mode is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, all addresses between pInfos[i].scratchData.deviceAddress and pInfos[i].scratchData.deviceAddress + N - 1 must be in the buffer device address range of the same buffer, where N is given by the updateScratchSize member of the AccelerationStructureBuildSizesInfoKHR structure returned from a call to getAccelerationStructureBuildSizesKHR with an identical AccelerationStructureBuildGeometryInfoKHR structure and primitive count
The buffers from which the buffer device addresses for all of the geometry.triangles.vertexData, geometry.triangles.indexData, geometry.triangles.transformData, geometry.aabbs.data, and geometry.instances.data members of all pInfos[i].pGeometries and pInfos[i].ppGeometries are queried must have been created with the BUFFER_USAGE_ACCELERATION_STRUCTURE_BUILD_INPUT_READ_ONLY_BIT_KHR usage flag
The buffer from which the buffer device address pInfos[i].scratchData.deviceAddress is queried must have been created with BUFFER_USAGE_STORAGE_BUFFER_BIT usage flag
For each element of pInfos, its scratchData.deviceAddress member must be a valid device address obtained from getBufferDeviceAddress
For each element of pInfos, if scratchData.deviceAddress is the address of a non-sparse buffer then it must be bound completely and contiguously to a single DeviceMemory object
For each element of pInfos, its scratchData.deviceAddress member must be a multiple of PhysicalDeviceAccelerationStructurePropertiesKHR::minAccelerationStructureScratchOffsetAlignment
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_TRIANGLES_KHR, geometry.triangles.vertexData.deviceAddress must be a valid device address obtained from getBufferDeviceAddress
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_TRIANGLES_KHR, if geometry.triangles.vertexData.deviceAddress is the address of a non-sparse buffer then it must be bound completely and contiguously to a single DeviceMemory object
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_TRIANGLES_KHR, geometry.triangles.vertexData.deviceAddress must be aligned to the size in bytes of the smallest component of the format in vertexFormat
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_TRIANGLES_KHR, if geometry.triangles.indexType is not INDEX_TYPE_NONE_KHR, geometry.triangles.indexData.deviceAddress must be a valid device address obtained from getBufferDeviceAddress
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_TRIANGLES_KHR, if geometry.triangles.indexType is not INDEX_TYPE_NONE_KHR, if geometry.triangles.indexData.deviceAddress is the address of a non-sparse buffer then it must be bound completely and contiguously to a single DeviceMemory object
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_TRIANGLES_KHR, and with geometry.triangles.indexType not equal to INDEX_TYPE_NONE_KHR, geometry.triangles.indexData.deviceAddress must be aligned to the size in bytes of the type in indexType
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_TRIANGLES_KHR, if geometry.triangles.transformData.deviceAddress is not 0, it must be a valid device address obtained from getBufferDeviceAddress
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_TRIANGLES_KHR, if geometry.triangles.transformData.deviceAddress is the address of a non-sparse buffer then it must be bound completely and contiguously to a single DeviceMemory object
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_TRIANGLES_KHR, if geometry.triangles.transformData.deviceAddress is not 0, it must be aligned to 16 bytes
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_AABBS_KHR, geometry.aabbs.data.deviceAddress must be a valid device address obtained from getBufferDeviceAddress
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_AABBS_KHR, if geometry.aabbs.data.deviceAddress is the address of a non-sparse buffer then it must be bound completely and contiguously to a single DeviceMemory object
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_AABBS_KHR, geometry.aabbs.data.deviceAddress must be aligned to 8 bytes
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_INSTANCES_KHR, if geometry.arrayOfPointers is FALSE, geometry.instances.data.deviceAddress must be aligned to 16 bytes
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_INSTANCES_KHR, if geometry.arrayOfPointers is TRUE, geometry.instances.data.deviceAddress must be aligned to 8 bytes
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_INSTANCES_KHR, if geometry.arrayOfPointers is TRUE, each element of geometry.instances.data.deviceAddress in device memory must be aligned to 16 bytes
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_INSTANCES_KHR, geometry.instances.data.deviceAddress must be a valid device address obtained from getBufferDeviceAddress
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_INSTANCES_KHR, if geometry.instances.data.deviceAddress is the address of a non-sparse buffer then it must be bound completely and contiguously to a single DeviceMemory object
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_INSTANCES_KHR, each AccelerationStructureInstanceKHR::accelerationStructureReference value in geometry.instances.data.deviceAddress must be a valid device address containing a value obtained from getAccelerationStructureDeviceAddressKHR
For each pInfos[i], dstAccelerationStructure must have been created with a value of AccelerationStructureCreateInfoKHR::size greater than or equal to the memory size required by the build operation, as returned by getAccelerationStructureBuildSizesKHR with pBuildInfo = pInfos[i] and with each element of the pMaxPrimitiveCounts array greater than or equal to the equivalent ppBuildRangeInfos[i][j].primitiveCount values for j in [0,pInfos[i].geometryCount)
Each element of ppBuildRangeInfos[i] must be a valid pointer to an array of pInfos[i].geometryCount AccelerationStructureBuildRangeInfoKHR structures

Valid Usage (Implicit)

commandBuffer must be a valid CommandBuffer handle

pInfos must be a valid pointer to an array of infoCount valid AccelerationStructureBuildGeometryInfoKHR structures
ppBuildRangeInfos must be a valid pointer to an array of infoCount AccelerationStructureBuildRangeInfoKHR structures
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
infoCount must be greater than 0

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	Supported Queue Types
Primary Secondary	Outside	Compute

Description

Accesses to acceleration structures, scratch buffers, vertex buffers, index buffers, and instance buffers must be synchronized as with cmdBuildAccelerationStructuresKHR.

Accesses to any element of pIndirectDeviceAddresses must be synchronized with the PIPELINE_STAGE_ACCELERATION_STRUCTURE_BUILD_BIT_KHR pipeline stage and an access type of ACCESS_INDIRECT_COMMAND_READ_BIT.

Valid Usage

The mode member of each element of pInfos must be a valid BuildAccelerationStructureModeKHR value

If the srcAccelerationStructure member of any element of pInfos is not NULL_HANDLE, the srcAccelerationStructure member must be a valid AccelerationStructureKHR handle
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, its srcAccelerationStructure member must not be NULL_HANDLE
The srcAccelerationStructure member of any element of pInfos must not be the same acceleration structure as the dstAccelerationStructure member of any other element of pInfos
The dstAccelerationStructure member of any element of pInfos must not be the same acceleration structure as the dstAccelerationStructure member of any other element of pInfos
The dstAccelerationStructure member of any element of pInfos must be a valid AccelerationStructureKHR handle
For each element of pInfos, if its type member is ACCELERATION_STRUCTURE_TYPE_TOP_LEVEL_KHR, its dstAccelerationStructure member must have been created with a value of AccelerationStructureCreateInfoKHR::type equal to either ACCELERATION_STRUCTURE_TYPE_TOP_LEVEL_KHR or ACCELERATION_STRUCTURE_TYPE_GENERIC_KHR
For each element of pInfos, if its type member is ACCELERATION_STRUCTURE_TYPE_BOTTOM_LEVEL_KHR, its dstAccelerationStructure member must have been created with a value of AccelerationStructureCreateInfoKHR::type equal to either ACCELERATION_STRUCTURE_TYPE_BOTTOM_LEVEL_KHR or ACCELERATION_STRUCTURE_TYPE_GENERIC_KHR
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, inactive primitives in its srcAccelerationStructure member must not be made active
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, active primitives in its srcAccelerationStructure member must not be made inactive
The dstAccelerationStructure member of any element of pInfos must not be referenced by the geometry.instances.data member of any element of pGeometries or ppGeometries with a geometryType of GEOMETRY_TYPE_INSTANCES_KHR in any other element of pInfos
The range of memory backing the dstAccelerationStructure member of any element of pInfos that is accessed by this command must not overlap the memory backing the srcAccelerationStructure member of any other element of pInfos with a mode equal to BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, which is accessed by this command
The range of memory backing the dstAccelerationStructure member of any element of pInfos that is accessed by this command must not overlap the memory backing the dstAccelerationStructure member of any other element of pInfos, which is accessed by this command
The range of memory backing the dstAccelerationStructure member of any element of pInfos that is accessed by this command must not overlap the memory backing the scratchData member of any element of pInfos (including the same element), which is accessed by this command
The range of memory backing the scratchData member of any element of pInfos that is accessed by this command must not overlap the memory backing the scratchData member of any other element of pInfos, which is accessed by this command
The range of memory backing the scratchData member of any element of pInfos that is accessed by this command must not overlap the memory backing the srcAccelerationStructure member of any element of pInfos with a mode equal to BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR (including the same element), which is accessed by this command
The range of memory backing the dstAccelerationStructure member of any element of pInfos that is accessed by this command must not overlap the memory backing any acceleration structure referenced by the geometry.instances.data member of any element of pGeometries or ppGeometries with a geometryType of GEOMETRY_TYPE_INSTANCES_KHR in any other element of pInfos, which is accessed by this command
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, its srcAccelerationStructure member must have previously been constructed with BUILD_ACCELERATION_STRUCTURE_ALLOW_UPDATE_BIT_KHR set in AccelerationStructureBuildGeometryInfoKHR::flags in the build
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, its srcAccelerationStructure and dstAccelerationStructure members must either be the same AccelerationStructureKHR, or not have any memory aliasing
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, its geometryCount member must have the same value which was specified when srcAccelerationStructure was last built
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, its flags member must have the same value which was specified when srcAccelerationStructure was last built
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, its type member must have the same value which was specified when srcAccelerationStructure was last built
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, then for each AccelerationStructureGeometryKHR structure referred to by its pGeometries or ppGeometries members, its geometryType member must have the same value which was specified when srcAccelerationStructure was last built
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, then for each AccelerationStructureGeometryKHR structure referred to by its pGeometries or ppGeometries members, its flags member must have the same value which was specified when srcAccelerationStructure was last built
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, then for each AccelerationStructureGeometryKHR structure referred to by its pGeometries or ppGeometries members, if geometryType is GEOMETRY_TYPE_TRIANGLES_KHR, its geometry.triangles.vertexFormat member must have the same value which was specified when srcAccelerationStructure was last built
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, then for each AccelerationStructureGeometryKHR structure referred to by its pGeometries or ppGeometries members, if geometryType is GEOMETRY_TYPE_TRIANGLES_KHR, its geometry.triangles.maxVertex member must have the same value which was specified when srcAccelerationStructure was last built
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, then for each AccelerationStructureGeometryKHR structure referred to by its pGeometries or ppGeometries members, if geometryType is GEOMETRY_TYPE_TRIANGLES_KHR, its geometry.triangles.indexType member must have the same value which was specified when srcAccelerationStructure was last built
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, then for each AccelerationStructureGeometryKHR structure referred to by its pGeometries or ppGeometries members, if geometryType is GEOMETRY_TYPE_TRIANGLES_KHR, if its geometry.triangles.transformData address was NULL when srcAccelerationStructure was last built, then it must be NULL
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, then for each AccelerationStructureGeometryKHR structure referred to by its pGeometries or ppGeometries members, if geometryType is GEOMETRY_TYPE_TRIANGLES_KHR, if its geometry.triangles.transformData address was not NULL when srcAccelerationStructure was last built, then it must not be NULL
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, then for each AccelerationStructureGeometryKHR structure referred to by its pGeometries or ppGeometries members, if geometryType is GEOMETRY_TYPE_TRIANGLES_KHR, and geometry.triangles.indexType is not INDEX_TYPE_NONE_KHR, then the value of each index referenced must be the same as the corresponding index value when srcAccelerationStructure was last built
For each AccelerationStructureBuildRangeInfoKHR referenced by this command, its primitiveCount member must have the same value which was specified when srcAccelerationStructure was last built
For each AccelerationStructureBuildRangeInfoKHR referenced by this command, if the corresponding geometry uses indices, its firstVertex member must have the same value which was specified when srcAccelerationStructure was last built
For each element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_INSTANCES_KHR, the corresponding ppMaxPrimitiveCounts[i][j] must be less than or equal to PhysicalDeviceAccelerationStructurePropertiesKHR::maxInstanceCount
For each element of pInfos, the buffer used to create its dstAccelerationStructure member must be bound to device memory
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR the buffer used to create its srcAccelerationStructure member must be bound to device memory
For each element of pInfos, the buffer used to create each acceleration structure referenced by the geometry.instances.data member of any element of pGeometries or ppGeometries with a geometryType of GEOMETRY_TYPE_INSTANCES_KHR must be bound to device memory
If pInfos[i].mode is BUILD_ACCELERATION_STRUCTURE_MODE_BUILD_KHR, all addresses between pInfos[i].scratchData.deviceAddress and pInfos[i].scratchData.deviceAddress + N - 1 must be in the buffer device address range of the same buffer, where N is given by the buildScratchSize member of the AccelerationStructureBuildSizesInfoKHR structure returned from a call to getAccelerationStructureBuildSizesKHR with an identical AccelerationStructureBuildGeometryInfoKHR structure and primitive count
If pInfos[i].mode is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, all addresses between pInfos[i].scratchData.deviceAddress and pInfos[i].scratchData.deviceAddress + N - 1 must be in the buffer device address range of the same buffer, where N is given by the updateScratchSize member of the AccelerationStructureBuildSizesInfoKHR structure returned from a call to getAccelerationStructureBuildSizesKHR with an identical AccelerationStructureBuildGeometryInfoKHR structure and primitive count
The buffers from which the buffer device addresses for all of the geometry.triangles.vertexData, geometry.triangles.indexData, geometry.triangles.transformData, geometry.aabbs.data, and geometry.instances.data members of all pInfos[i].pGeometries and pInfos[i].ppGeometries are queried must have been created with the BUFFER_USAGE_ACCELERATION_STRUCTURE_BUILD_INPUT_READ_ONLY_BIT_KHR usage flag
The buffer from which the buffer device address pInfos[i].scratchData.deviceAddress is queried must have been created with BUFFER_USAGE_STORAGE_BUFFER_BIT usage flag
For each element of pInfos, its scratchData.deviceAddress member must be a valid device address obtained from getBufferDeviceAddress
For each element of pInfos, if scratchData.deviceAddress is the address of a non-sparse buffer then it must be bound completely and contiguously to a single DeviceMemory object
For each element of pInfos, its scratchData.deviceAddress member must be a multiple of PhysicalDeviceAccelerationStructurePropertiesKHR::minAccelerationStructureScratchOffsetAlignment
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_TRIANGLES_KHR, geometry.triangles.vertexData.deviceAddress must be a valid device address obtained from getBufferDeviceAddress
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_TRIANGLES_KHR, if geometry.triangles.vertexData.deviceAddress is the address of a non-sparse buffer then it must be bound completely and contiguously to a single DeviceMemory object
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_TRIANGLES_KHR, geometry.triangles.vertexData.deviceAddress must be aligned to the size in bytes of the smallest component of the format in vertexFormat
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_TRIANGLES_KHR, if geometry.triangles.indexType is not INDEX_TYPE_NONE_KHR, geometry.triangles.indexData.deviceAddress must be a valid device address obtained from getBufferDeviceAddress
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_TRIANGLES_KHR, if geometry.triangles.indexType is not INDEX_TYPE_NONE_KHR, if geometry.triangles.indexData.deviceAddress is the address of a non-sparse buffer then it must be bound completely and contiguously to a single DeviceMemory object
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_TRIANGLES_KHR, and with geometry.triangles.indexType not equal to INDEX_TYPE_NONE_KHR, geometry.triangles.indexData.deviceAddress must be aligned to the size in bytes of the type in indexType
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_TRIANGLES_KHR, if geometry.triangles.transformData.deviceAddress is not 0, it must be a valid device address obtained from getBufferDeviceAddress
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_TRIANGLES_KHR, if geometry.triangles.transformData.deviceAddress is the address of a non-sparse buffer then it must be bound completely and contiguously to a single DeviceMemory object
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_TRIANGLES_KHR, if geometry.triangles.transformData.deviceAddress is not 0, it must be aligned to 16 bytes
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_AABBS_KHR, geometry.aabbs.data.deviceAddress must be a valid device address obtained from getBufferDeviceAddress
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_AABBS_KHR, if geometry.aabbs.data.deviceAddress is the address of a non-sparse buffer then it must be bound completely and contiguously to a single DeviceMemory object
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_AABBS_KHR, geometry.aabbs.data.deviceAddress must be aligned to 8 bytes
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_INSTANCES_KHR, if geometry.arrayOfPointers is FALSE, geometry.instances.data.deviceAddress must be aligned to 16 bytes
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_INSTANCES_KHR, if geometry.arrayOfPointers is TRUE, geometry.instances.data.deviceAddress must be aligned to 8 bytes
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_INSTANCES_KHR, if geometry.arrayOfPointers is TRUE, each element of geometry.instances.data.deviceAddress in device memory must be aligned to 16 bytes
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_INSTANCES_KHR, geometry.instances.data.deviceAddress must be a valid device address obtained from getBufferDeviceAddress
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_INSTANCES_KHR, if geometry.instances.data.deviceAddress is the address of a non-sparse buffer then it must be bound completely and contiguously to a single DeviceMemory object
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_INSTANCES_KHR, each AccelerationStructureInstanceKHR::accelerationStructureReference value in geometry.instances.data.deviceAddress must be a valid device address containing a value obtained from getAccelerationStructureDeviceAddressKHR
For any element of pIndirectDeviceAddresses, if the buffer from which it was queried is non-sparse then it must be bound completely and contiguously to a single DeviceMemory object
For any element of pIndirectDeviceAddresses[i], all device addresses between pIndirectDeviceAddresses[i] and pIndirectDeviceAddresses[i] + (pInfos[i].geometryCount × pIndirectStrides[i]) - 1 must be in the buffer device address range of the same buffer
For any element of pIndirectDeviceAddresses, the buffer from which it was queried must have been created with the BUFFER_USAGE_INDIRECT_BUFFER_BIT bit set
Each element of pIndirectDeviceAddresses must be a multiple of 4
Each element of pIndirectStrides must be a multiple of 4
commandBuffer must not be a protected command buffer
The ::accelerationStructureIndirectBuild feature must be enabled
Each AccelerationStructureBuildRangeInfoKHR structure referenced by any element of pIndirectDeviceAddresses must be a valid AccelerationStructureBuildRangeInfoKHR structure
pInfos[i].dstAccelerationStructure must have been created with a value of AccelerationStructureCreateInfoKHR::size greater than or equal to the memory size required by the build operation, as returned by getAccelerationStructureBuildSizesKHR with pBuildInfo = pInfos[i] and pMaxPrimitiveCounts = ppMaxPrimitiveCounts[i]
Each ppMaxPrimitiveCounts[i][j] must be greater than or equal to the the primitiveCount value specified by the AccelerationStructureBuildRangeInfoKHR structure located at pIndirectDeviceAddresses[i] + (j × pIndirectStrides[i])

Valid Usage (Implicit)

commandBuffer must be a valid CommandBuffer handle

pInfos must be a valid pointer to an array of infoCount valid AccelerationStructureBuildGeometryInfoKHR structures
pIndirectDeviceAddresses must be a valid pointer to an array of infoCount DeviceAddress values
pIndirectStrides must be a valid pointer to an array of infoCount uint32_t values
ppMaxPrimitiveCounts must be a valid pointer to an array of infoCount uint32_t values
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
infoCount must be greater than 0

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	Supported Queue Types
Primary Secondary	Outside	Compute

Description

This command fulfills the same task as cmdBuildAccelerationStructuresKHR but is executed by the host.

The buildAccelerationStructuresKHR command provides the ability to initiate multiple acceleration structures builds, however there is no ordering or synchronization implied between any of the individual acceleration structure builds.

Note

This means that an application cannot build a top-level acceleration structure in the same buildAccelerationStructuresKHR call as the associated bottom-level or instance acceleration structures are being built. There also cannot be any memory aliasing between any acceleration structure memories or scratch memories being used by any of the builds.

Valid Usage

The mode member of each element of pInfos must be a valid BuildAccelerationStructureModeKHR value

If the srcAccelerationStructure member of any element of pInfos is not NULL_HANDLE, the srcAccelerationStructure member must be a valid AccelerationStructureKHR handle
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, its srcAccelerationStructure member must not be NULL_HANDLE
The srcAccelerationStructure member of any element of pInfos must not be the same acceleration structure as the dstAccelerationStructure member of any other element of pInfos
The dstAccelerationStructure member of any element of pInfos must not be the same acceleration structure as the dstAccelerationStructure member of any other element of pInfos
The dstAccelerationStructure member of any element of pInfos must be a valid AccelerationStructureKHR handle
For each element of pInfos, if its type member is ACCELERATION_STRUCTURE_TYPE_TOP_LEVEL_KHR, its dstAccelerationStructure member must have been created with a value of AccelerationStructureCreateInfoKHR::type equal to either ACCELERATION_STRUCTURE_TYPE_TOP_LEVEL_KHR or ACCELERATION_STRUCTURE_TYPE_GENERIC_KHR
For each element of pInfos, if its type member is ACCELERATION_STRUCTURE_TYPE_BOTTOM_LEVEL_KHR, its dstAccelerationStructure member must have been created with a value of AccelerationStructureCreateInfoKHR::type equal to either ACCELERATION_STRUCTURE_TYPE_BOTTOM_LEVEL_KHR or ACCELERATION_STRUCTURE_TYPE_GENERIC_KHR
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, inactive primitives in its srcAccelerationStructure member must not be made active
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, active primitives in its srcAccelerationStructure member must not be made inactive
The dstAccelerationStructure member of any element of pInfos must not be referenced by the geometry.instances.data member of any element of pGeometries or ppGeometries with a geometryType of GEOMETRY_TYPE_INSTANCES_KHR in any other element of pInfos
The range of memory backing the dstAccelerationStructure member of any element of pInfos that is accessed by this command must not overlap the memory backing the srcAccelerationStructure member of any other element of pInfos with a mode equal to BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, which is accessed by this command
The range of memory backing the dstAccelerationStructure member of any element of pInfos that is accessed by this command must not overlap the memory backing the dstAccelerationStructure member of any other element of pInfos, which is accessed by this command
The range of memory backing the dstAccelerationStructure member of any element of pInfos that is accessed by this command must not overlap the memory backing the scratchData member of any element of pInfos (including the same element), which is accessed by this command
The range of memory backing the scratchData member of any element of pInfos that is accessed by this command must not overlap the memory backing the scratchData member of any other element of pInfos, which is accessed by this command
The range of memory backing the scratchData member of any element of pInfos that is accessed by this command must not overlap the memory backing the srcAccelerationStructure member of any element of pInfos with a mode equal to BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR (including the same element), which is accessed by this command
The range of memory backing the dstAccelerationStructure member of any element of pInfos that is accessed by this command must not overlap the memory backing any acceleration structure referenced by the geometry.instances.data member of any element of pGeometries or ppGeometries with a geometryType of GEOMETRY_TYPE_INSTANCES_KHR in any other element of pInfos, which is accessed by this command
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, its srcAccelerationStructure member must have previously been constructed with BUILD_ACCELERATION_STRUCTURE_ALLOW_UPDATE_BIT_KHR set in AccelerationStructureBuildGeometryInfoKHR::flags in the build
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, its srcAccelerationStructure and dstAccelerationStructure members must either be the same AccelerationStructureKHR, or not have any memory aliasing
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, its geometryCount member must have the same value which was specified when srcAccelerationStructure was last built
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, its flags member must have the same value which was specified when srcAccelerationStructure was last built
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, its type member must have the same value which was specified when srcAccelerationStructure was last built
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, then for each AccelerationStructureGeometryKHR structure referred to by its pGeometries or ppGeometries members, its geometryType member must have the same value which was specified when srcAccelerationStructure was last built
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, then for each AccelerationStructureGeometryKHR structure referred to by its pGeometries or ppGeometries members, its flags member must have the same value which was specified when srcAccelerationStructure was last built
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, then for each AccelerationStructureGeometryKHR structure referred to by its pGeometries or ppGeometries members, if geometryType is GEOMETRY_TYPE_TRIANGLES_KHR, its geometry.triangles.vertexFormat member must have the same value which was specified when srcAccelerationStructure was last built
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, then for each AccelerationStructureGeometryKHR structure referred to by its pGeometries or ppGeometries members, if geometryType is GEOMETRY_TYPE_TRIANGLES_KHR, its geometry.triangles.maxVertex member must have the same value which was specified when srcAccelerationStructure was last built
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, then for each AccelerationStructureGeometryKHR structure referred to by its pGeometries or ppGeometries members, if geometryType is GEOMETRY_TYPE_TRIANGLES_KHR, its geometry.triangles.indexType member must have the same value which was specified when srcAccelerationStructure was last built
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, then for each AccelerationStructureGeometryKHR structure referred to by its pGeometries or ppGeometries members, if geometryType is GEOMETRY_TYPE_TRIANGLES_KHR, if its geometry.triangles.transformData address was NULL when srcAccelerationStructure was last built, then it must be NULL
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, then for each AccelerationStructureGeometryKHR structure referred to by its pGeometries or ppGeometries members, if geometryType is GEOMETRY_TYPE_TRIANGLES_KHR, if its geometry.triangles.transformData address was not NULL when srcAccelerationStructure was last built, then it must not be NULL
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, then for each AccelerationStructureGeometryKHR structure referred to by its pGeometries or ppGeometries members, if geometryType is GEOMETRY_TYPE_TRIANGLES_KHR, and geometry.triangles.indexType is not INDEX_TYPE_NONE_KHR, then the value of each index referenced must be the same as the corresponding index value when srcAccelerationStructure was last built
For each AccelerationStructureBuildRangeInfoKHR referenced by this command, its primitiveCount member must have the same value which was specified when srcAccelerationStructure was last built
For each AccelerationStructureBuildRangeInfoKHR referenced by this command, if the corresponding geometry uses indices, its firstVertex member must have the same value which was specified when srcAccelerationStructure was last built
For each element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_INSTANCES_KHR, the corresponding ppBuildRangeInfos[i][j].primitiveCount must be less than or equal to PhysicalDeviceAccelerationStructurePropertiesKHR::maxInstanceCount
For each pInfos[i], dstAccelerationStructure must have been created with a value of AccelerationStructureCreateInfoKHR::size greater than or equal to the memory size required by the build operation, as returned by getAccelerationStructureBuildSizesKHR with pBuildInfo = pInfos[i] and with each element of the pMaxPrimitiveCounts array greater than or equal to the equivalent ppBuildRangeInfos[i][j].primitiveCount values for j in [0,pInfos[i].geometryCount)
Each element of ppBuildRangeInfos[i] must be a valid pointer to an array of pInfos[i].geometryCount AccelerationStructureBuildRangeInfoKHR structures
If deferredOperation is not NULL_HANDLE, it must be a valid DeferredOperationKHR object
Any previous deferred operation that was associated with deferredOperation must be complete
For each element of pInfos, the buffer used to create its dstAccelerationStructure member must be bound to host-visible device memory
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR the buffer used to create its srcAccelerationStructure member must be bound to host-visible device memory
For each element of pInfos, the buffer used to create each acceleration structure referenced by the geometry.instances.data member of any element of pGeometries or ppGeometries with a geometryType of GEOMETRY_TYPE_INSTANCES_KHR must be bound to host-visible device memory
The ::accelerationStructureHostCommands feature must be enabled
If pInfos[i].mode is BUILD_ACCELERATION_STRUCTURE_MODE_BUILD_KHR, all addresses between pInfos[i].scratchData.hostAddress and pInfos[i].scratchData.hostAddress + N - 1 must be valid host memory, where N is given by the buildScratchSize member of the AccelerationStructureBuildSizesInfoKHR structure returned from a call to getAccelerationStructureBuildSizesKHR with an identical AccelerationStructureBuildGeometryInfoKHR structure and primitive count
If pInfos[i].mode is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR, all addresses between pInfos[i].scratchData.hostAddress and pInfos[i].scratchData.hostAddress + N - 1 must be valid host memory, where N is given by the updateScratchSize member of the AccelerationStructureBuildSizesInfoKHR structure returned from a call to getAccelerationStructureBuildSizesKHR with an identical AccelerationStructureBuildGeometryInfoKHR structure and primitive count
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_TRIANGLES_KHR, geometry.triangles.vertexData.hostAddress must be a valid host address
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_TRIANGLES_KHR, if geometry.triangles.indexType is not INDEX_TYPE_NONE_KHR, geometry.triangles.indexData.hostAddress must be a valid host address
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_TRIANGLES_KHR, if geometry.triangles.transformData.hostAddress is not 0, it must be a valid host address
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_AABBS_KHR, geometry.aabbs.data.hostAddress must be a valid host address
For each element of pInfos, the buffer used to create its dstAccelerationStructure member must be bound to memory that was not allocated with multiple instances
For each element of pInfos, if its mode member is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR the buffer used to create its srcAccelerationStructure member must be bound to memory that was not allocated with multiple instances
For each element of pInfos, the buffer used to create each acceleration structure referenced by the geometry.instances.data member of any element of pGeometries or ppGeometries with a geometryType of GEOMETRY_TYPE_INSTANCES_KHR must be bound to memory that was not allocated with multiple instances
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_INSTANCES_KHR, geometry.instances.data.hostAddress must be a valid host address
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_INSTANCES_KHR, each AccelerationStructureInstanceKHR::accelerationStructureReference value in geometry.instances.data.hostAddress must be a valid AccelerationStructureKHR object
For any element of pInfos[i].pGeometries or pInfos[i].ppGeometries with a geometryType of GEOMETRY_TYPE_INSTANCES_KHR with BUILD_ACCELERATION_STRUCTURE_MOTION_BIT_NV set, each accelerationStructureReference in any structure in AccelerationStructureMotionInstanceNV value in geometry.instances.data.hostAddress must be a valid AccelerationStructureKHR object

Valid Usage (Implicit)

device must be a valid Device handle

If deferredOperation is not NULL_HANDLE, deferredOperation must be a valid DeferredOperationKHR handle
pInfos must be a valid pointer to an array of infoCount valid AccelerationStructureBuildGeometryInfoKHR structures
ppBuildRangeInfos must be a valid pointer to an array of infoCount AccelerationStructureBuildRangeInfoKHR structures
infoCount must be greater than 0
If deferredOperation is a valid handle, it must have been created, allocated, or retrieved from device

Return Codes

Success

Failure

Description

The 64-bit return value is an address of the acceleration structure, which can be used for device and shader operations that involve acceleration structures, such as ray traversal and acceleration structure building.

If the acceleration structure was created with a non-zero value of AccelerationStructureCreateInfoKHR::deviceAddress, the return value will be the same address.

If the acceleration structure was created with a type of ACCELERATION_STRUCTURE_TYPE_GENERIC_KHR, the returned address must be consistent with the relative offset to other acceleration structures with type ACCELERATION_STRUCTURE_TYPE_GENERIC_KHR allocated with the same Buffer. That is, the difference in returned addresses between the two must be the same as the difference in offsets provided at acceleration structure creation.

Note

The acceleration structure device address may be different from the buffer device address corresponding to the acceleration structure’s start offset in its storage buffer for acceleration structure types other than ACCELERATION_STRUCTURE_TYPE_GENERIC_KHR.

Valid Usage

If device was created with multiple physical devices, then the bufferDeviceAddressMultiDevice feature must be enabled

Valid Usage (Implicit)

device must be a valid Device handle

pInfo must be a valid pointer to a valid AccelerationStructureDeviceAddressInfoKHR structure

Description

The srcAccelerationStructure, dstAccelerationStructure, and mode members of pBuildInfo are ignored. Any DeviceOrHostAddressKHR members of pBuildInfo are ignored by this command, except that the hostAddress member of AccelerationStructureGeometryTrianglesDataKHR::transformData will be examined to check if it is NULL.

An acceleration structure created with the accelerationStructureSize returned by this command supports any build or update with a AccelerationStructureBuildGeometryInfoKHR structure and array of AccelerationStructureBuildRangeInfoKHR structures subject to the following properties:

The build command is a host build command, and buildType is ACCELERATION_STRUCTURE_BUILD_TYPE_HOST_KHR or ACCELERATION_STRUCTURE_BUILD_TYPE_HOST_OR_DEVICE_KHR
The build command is a device build command, and buildType is ACCELERATION_STRUCTURE_BUILD_TYPE_DEVICE_KHR or ACCELERATION_STRUCTURE_BUILD_TYPE_HOST_OR_DEVICE_KHR
For AccelerationStructureBuildGeometryInfoKHR:
- Its type, and flags members are equal to pBuildInfo->type andm pBuildInfo->flags, respectively.
- geometryCount is less than or equal to pBuildInfo->geometryCount.
- For each element of either pGeometries or ppGeometries at a given index, its geometryType member is equal to pBuildInfo->geometryType.
- For each element of either pGeometries or ppGeometries at a given index, with a geometryType member equal to GEOMETRY_TYPE_TRIANGLES_KHR, the vertexFormat and indexType members of geometry.triangles are equal to the corresponding members of the same element in pBuildInfo.
- For each element of either pGeometries or ppGeometries at a given index, with a geometryType member equal to GEOMETRY_TYPE_TRIANGLES_KHR, the maxVertex member of geometry.triangles is less than or equal to the corresponding member of the same element in pBuildInfo.
- For each element of either pGeometries or ppGeometries at a given index, with a geometryType member equal to GEOMETRY_TYPE_TRIANGLES_KHR, if the applicable address in the transformData member of geometry.triangles is not NULL, the corresponding transformData.hostAddress parameter in pBuildInfo is not NULL.
For each AccelerationStructureBuildRangeInfoKHR corresponding to the AccelerationStructureBuildGeometryInfoKHR:
- Its primitiveCount member is less than or equal to the corresponding element of pMaxPrimitiveCounts.

Similarly, the updateScratchSize value will support any build command specifying the BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR mode under the above conditions, and the buildScratchSize value will support any build command specifying the BUILD_ACCELERATION_STRUCTURE_MODE_BUILD_KHR mode under the above conditions.

Valid Usage

The rayTracingPipeline or rayQuery feature must be enabled

If device was created with multiple physical devices, then the bufferDeviceAddressMultiDevice feature must be enabled
If pBuildInfo->geometryCount is not 0, pMaxPrimitiveCounts must be a valid pointer to an array of pBuildInfo->geometryCount uint32_t values
If pBuildInfo->pGeometries or pBuildInfo->ppGeometries has a geometryType of GEOMETRY_TYPE_INSTANCES_KHR, each pMaxPrimitiveCounts[i] must be less than or equal to PhysicalDeviceAccelerationStructurePropertiesKHR::maxInstanceCount

Valid Usage (Implicit)

device must be a valid Device handle

buildType must be a valid AccelerationStructureBuildTypeKHR value
pBuildInfo must be a valid pointer to a valid AccelerationStructureBuildGeometryInfoKHR structure
If pMaxPrimitiveCounts is not NULL, pMaxPrimitiveCounts must be a valid pointer to an array of pBuildInfo->geometryCount uint32_t values
pSizeInfo must be a valid pointer to a AccelerationStructureBuildSizesInfoKHR structure

Members

This structure describes the following features:

Description

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

Valid Usage (Implicit)

Description

Due to the fact that the geometry, instance, and primitive counts are specified at acceleration structure creation as 32-bit values, maxGeometryCount, maxInstanceCount, and maxPrimitiveCount must not exceed 232-1.

If the PhysicalDeviceAccelerationStructurePropertiesKHR structure is included in the pNext chain of the PhysicalDeviceProperties2 structure passed to getPhysicalDeviceProperties2, it is filled in with each corresponding implementation-dependent property.

Limits specified by this structure must match those specified with the same name in PhysicalDeviceRayTracingPropertiesNV.

Valid Usage (Implicit)

Description

Note

Unlike the stride for vertex buffers in VertexInputBindingDescription for graphics pipelines which must not exceed maxVertexInputBindingStride, vertexStride for acceleration structure geometry is instead restricted to being a 32-bit value.

Valid Usage

vertexStride must be a multiple of the size in bytes of the smallest component of vertexFormat

vertexStride must be less than or equal to 232-1
vertexFormat must support the FORMAT_FEATURE_ACCELERATION_STRUCTURE_VERTEX_BUFFER_BIT_KHR in FormatProperties::bufferFeatures as returned by getPhysicalDeviceFormatProperties2
indexType must be INDEX_TYPE_UINT16, INDEX_TYPE_UINT32, or INDEX_TYPE_NONE_KHR

Valid Usage (Implicit)

sType must be STRUCTURE_TYPE_ACCELERATION_STRUCTURE_GEOMETRY_TRIANGLES_DATA_KHR

pNext must be NULL or a pointer to a valid instance of AccelerationStructureGeometryMotionTrianglesDataNV
The sType value of each struct in the pNext chain must be unique
vertexFormat must be a valid Format value
indexType must be a valid IndexType value

Description

Only one of pGeometries or ppGeometries can be a valid pointer, the other must be NULL. Each element of the non-NULL array describes the data used to build each acceleration structure geometry.

The index of each element of the pGeometries or ppGeometries members of AccelerationStructureBuildGeometryInfoKHR is used as the /geometry index/ during ray traversal. The geometry index is available in ray shaders via the RayGeometryIndexKHR built-in, and is used to determine hit and intersection shaders executed during traversal. The geometry index is available to ray queries via the OpRayQueryGetIntersectionGeometryIndexKHR instruction.

Setting BUILD_ACCELERATION_STRUCTURE_MOTION_BIT_NV in flags indicates that this build is a motion top level acceleration structure. A motion top level uses instances of format AccelerationStructureMotionInstanceNV if AccelerationStructureGeometryInstancesDataKHR::arrayOfPointers is FALSE.

If AccelerationStructureGeometryInstancesDataKHR::arrayOfPointers is TRUE, the pointer for any given element of the array of instance pointers consists of 4 bits of AccelerationStructureMotionInstanceTypeNV in the low 4 bits of the pointer identifying the type of structure at the pointer. The device address accessed is the value in the array with the low 4 bits set to zero. The structure at the pointer is one of AccelerationStructureInstanceKHR, AccelerationStructureMatrixMotionInstanceNV or AccelerationStructureSRTMotionInstanceNV, depending on the type value encoded in the low 4 bits.

A top level acceleration structure with either motion instances or vertex motion in its instances must set BUILD_ACCELERATION_STRUCTURE_MOTION_BIT_NV in flags.

Members srcAccelerationStructure and dstAccelerationStructure may be the same or different for an update operation (when mode is BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR). If they are the same, the update happens in-place. Otherwise, the target acceleration structure is updated and the source is not modified.

Valid Usage

type must not be ACCELERATION_STRUCTURE_TYPE_GENERIC_KHR

Only one of pGeometries or ppGeometries can be a valid pointer, the other must be NULL
If type is ACCELERATION_STRUCTURE_TYPE_TOP_LEVEL_KHR, the geometryType member of elements of either pGeometries or ppGeometries must be GEOMETRY_TYPE_INSTANCES_KHR
If type is ACCELERATION_STRUCTURE_TYPE_TOP_LEVEL_KHR, geometryCount must be 1
If type is ACCELERATION_STRUCTURE_TYPE_BOTTOM_LEVEL_KHR the geometryType member of elements of either pGeometries or ppGeometries must not be GEOMETRY_TYPE_INSTANCES_KHR
If type is ACCELERATION_STRUCTURE_TYPE_BOTTOM_LEVEL_KHR then the geometryType member of each geometry in either pGeometries or ppGeometries must be the same
If type is ACCELERATION_STRUCTURE_TYPE_BOTTOM_LEVEL_KHR then geometryCount must be less than or equal to PhysicalDeviceAccelerationStructurePropertiesKHR::maxGeometryCount
If type is ACCELERATION_STRUCTURE_TYPE_BOTTOM_LEVEL_KHR and the geometryType member of either pGeometries or ppGeometries is GEOMETRY_TYPE_AABBS_KHR, the total number of AABBs in all geometries must be less than or equal to PhysicalDeviceAccelerationStructurePropertiesKHR::maxPrimitiveCount
If type is ACCELERATION_STRUCTURE_TYPE_BOTTOM_LEVEL_KHR and the geometryType member of either pGeometries or ppGeometries is GEOMETRY_TYPE_TRIANGLES_KHR, the total number of triangles in all geometries must be less than or equal to PhysicalDeviceAccelerationStructurePropertiesKHR::maxPrimitiveCount
If flags has the BUILD_ACCELERATION_STRUCTURE_PREFER_FAST_TRACE_BIT_KHR bit set, then it must not have the BUILD_ACCELERATION_STRUCTURE_PREFER_FAST_BUILD_BIT_KHR bit set
If dstAccelerationStructure was created with ACCELERATION_STRUCTURE_CREATE_MOTION_BIT_NV set in AccelerationStructureCreateInfoKHR::flags, BUILD_ACCELERATION_STRUCTURE_MOTION_BIT_NV must be set in flags
If BUILD_ACCELERATION_STRUCTURE_MOTION_BIT_NV is set in flags, dstAccelerationStructure must have been created with ACCELERATION_STRUCTURE_CREATE_MOTION_BIT_NV set in AccelerationStructureCreateInfoKHR::flags
If BUILD_ACCELERATION_STRUCTURE_MOTION_BIT_NV is set in flags, type must not be ACCELERATION_STRUCTURE_TYPE_GENERIC_KHR

Valid Usage (Implicit)

sType must be STRUCTURE_TYPE_ACCELERATION_STRUCTURE_BUILD_GEOMETRY_INFO_KHR

pNext must be NULL
type must be a valid AccelerationStructureTypeKHR value
flags must be a valid combination of BuildAccelerationStructureFlagBitsKHR values
If geometryCount is not 0, and pGeometries is not NULL, pGeometries must be a valid pointer to an array of geometryCount valid AccelerationStructureGeometryKHR structures
If geometryCount is not 0, and ppGeometries is not NULL, ppGeometries must be a valid pointer to an array of geometryCount valid pointers to valid AccelerationStructureGeometryKHR structures
Both of dstAccelerationStructure, and srcAccelerationStructure that are valid handles of non-ignored parameters must have been created, allocated, or retrieved from the same Device

Description

The primitive count and primitive offset are interpreted differently depending on the GeometryTypeKHR used:

For geometries of type GEOMETRY_TYPE_TRIANGLES_KHR, primitiveCount is the number of triangles to be built, where each triangle is treated as 3 vertices.
- If the geometry uses indices, primitiveCount × 3 indices are consumed from AccelerationStructureGeometryTrianglesDataKHR::indexData, starting at an offset of primitiveOffset. The value of firstVertex is added to the index values before fetching vertices.
- If the geometry does not use indices, primitiveCount × 3 vertices are consumed from AccelerationStructureGeometryTrianglesDataKHR::vertexData, starting at an offset of primitiveOffset + AccelerationStructureGeometryTrianglesDataKHR::vertexStride × firstVertex.
- If AccelerationStructureGeometryTrianglesDataKHR::transformData is not NULL, a single TransformMatrixKHR structure is consumed from AccelerationStructureGeometryTrianglesDataKHR::transformData, at an offset of transformOffset. This matrix describes a transformation from the space in which the vertices for all triangles in this geometry are described to the space in which the acceleration structure is defined.
For geometries of type GEOMETRY_TYPE_AABBS_KHR, primitiveCount is the number of axis-aligned bounding boxes. primitiveCount AabbPositionsKHR structures are consumed from AccelerationStructureGeometryAabbsDataKHR::data, starting at an offset of primitiveOffset.
For geometries of type GEOMETRY_TYPE_INSTANCES_KHR, primitiveCount is the number of acceleration structures. primitiveCount AccelerationStructureInstanceKHR or AccelerationStructureMotionInstanceNV structures are consumed from AccelerationStructureGeometryInstancesDataKHR::data, starting at an offset of primitiveOffset.

Valid Usage

For geometries of type GEOMETRY_TYPE_TRIANGLES_KHR, if the geometry uses indices, the offset primitiveOffset from AccelerationStructureGeometryTrianglesDataKHR::indexData must be a multiple of the element size of AccelerationStructureGeometryTrianglesDataKHR::indexType

For geometries of type GEOMETRY_TYPE_TRIANGLES_KHR, if the geometry does not use indices, the offset primitiveOffset from AccelerationStructureGeometryTrianglesDataKHR::vertexData must be a multiple of the component size of AccelerationStructureGeometryTrianglesDataKHR::vertexFormat
For geometries of type GEOMETRY_TYPE_TRIANGLES_KHR, the offset transformOffset from AccelerationStructureGeometryTrianglesDataKHR::transformData must be a multiple of 16
For geometries of type GEOMETRY_TYPE_AABBS_KHR, the offset primitiveOffset from AccelerationStructureGeometryAabbsDataKHR::data must be a multiple of 8
For geometries of type GEOMETRY_TYPE_INSTANCES_KHR, the offset primitiveOffset from AccelerationStructureGeometryInstancesDataKHR::data must be a multiple of 16

Description

If deviceAddress is zero, no specific address is requested.

If deviceAddress is not zero, deviceAddress must be an address retrieved from an identically created acceleration structure on the same implementation. The acceleration structure must also be placed on an identically created buffer and at the same offset.

Applications should avoid creating acceleration structures with application-provided addresses and implementation-provided addresses in the same process, to reduce the likelihood of ERROR_INVALID_OPAQUE_CAPTURE_ADDRESS_KHR errors.

Note

The expected usage for this is that a trace capture/replay tool will add the BUFFER_CREATE_DEVICE_ADDRESS_CAPTURE_REPLAY_BIT flag to all buffers that use BUFFER_USAGE_SHADER_DEVICE_ADDRESS_BIT, and will add BUFFER_USAGE_SHADER_DEVICE_ADDRESS_BIT to all buffers used as storage for an acceleration structure where deviceAddress is not zero. This also means that the tool will need to add MEMORY_ALLOCATE_DEVICE_ADDRESS_BIT to memory allocations to allow the flag to be set where the application may not have otherwise required it. During capture the tool will save the queried opaque device addresses in the trace. During replay, the buffers will be created specifying the original address so any address values stored in the trace data will remain valid.

Implementations are expected to separate such buffers in the GPU address space so normal allocations will avoid using these addresses. Apps/tools should avoid mixing app-provided and implementation-provided addresses for buffers created with BUFFER_CREATE_DEVICE_ADDRESS_CAPTURE_REPLAY_BIT, to avoid address space allocation conflicts.

Applications should create an acceleration structure with a specific AccelerationStructureTypeKHR other than ACCELERATION_STRUCTURE_TYPE_GENERIC_KHR.

If the acceleration structure will be the target of a build operation, the required size for an acceleration structure can be queried with getAccelerationStructureBuildSizesKHR. If the acceleration structure is going to be the target of a compacting copy, cmdWriteAccelerationStructuresPropertiesKHR or writeAccelerationStructuresPropertiesKHR can be used to obtain the compacted size required.

If the acceleration structure will be the target of a build operation with BUILD_ACCELERATION_STRUCTURE_MOTION_BIT_NV it must include ACCELERATION_STRUCTURE_CREATE_MOTION_BIT_NV in flags and include AccelerationStructureMotionInfoNV as an extension structure in pNext with the number of instances as metadata for the object.

Valid Usage

If deviceAddress is not zero, createFlags must include ACCELERATION_STRUCTURE_CREATE_DEVICE_ADDRESS_CAPTURE_REPLAY_BIT_KHR

If createFlags includes ACCELERATION_STRUCTURE_CREATE_DEVICE_ADDRESS_CAPTURE_REPLAY_BIT_KHR, PhysicalDeviceAccelerationStructureFeaturesKHR::accelerationStructureCaptureReplay must be TRUE
buffer must have been created with a usage value containing BUFFER_USAGE_ACCELERATION_STRUCTURE_STORAGE_BIT_KHR
buffer must not have been created with BUFFER_CREATE_SPARSE_RESIDENCY_BIT
The sum of offset and size must be less than the size of buffer
offset must be a multiple of 256 bytes
If ACCELERATION_STRUCTURE_CREATE_MOTION_BIT_NV is set in flags and type is ACCELERATION_STRUCTURE_TYPE_TOP_LEVEL_KHR, one member of the pNext chain must be a pointer to a valid instance of AccelerationStructureMotionInfoNV
If any geometry includes AccelerationStructureGeometryMotionTrianglesDataNV then flags must contain ACCELERATION_STRUCTURE_CREATE_MOTION_BIT_NV

Valid Usage (Implicit)

sType must be STRUCTURE_TYPE_ACCELERATION_STRUCTURE_CREATE_INFO_KHR

pNext must be NULL or a pointer to a valid instance of AccelerationStructureMotionInfoNV
The sType value of each struct in the pNext chain must be unique
createFlags must be a valid combination of AccelerationStructureCreateFlagBitsKHR values
buffer must be a valid Buffer handle
type must be a valid AccelerationStructureTypeKHR value

Description

The C language specification does not define the ordering of bit-fields, but in practice, this struct produces the correct layout with existing compilers. The intended bit pattern is for the following:

If a compiler produces code that diverges from that pattern, applications must employ another method to set values according to the correct bit pattern.

Valid Usage (Implicit)

Description

Note

pVersionData is a pointer to an array of 2*UUID_SIZE uint8_t values instead of two UUID_SIZE arrays as the expected use case for this member is to be pointed at the header of an previously serialized acceleration structure (via cmdCopyAccelerationStructureToMemoryKHR or copyAccelerationStructureToMemoryKHR) that is loaded in memory. Using arrays would necessitate extra memory copies of the UUIDs.

Valid Usage (Implicit)

Description

GEOMETRY_INSTANCE_FORCE_NO_OPAQUE_BIT_KHR and GEOMETRY_INSTANCE_FORCE_OPAQUE_BIT_KHR must not be used in the same flag.

Description

Note

BUILD_ACCELERATION_STRUCTURE_ALLOW_UPDATE_BIT_KHR and BUILD_ACCELERATION_STRUCTURE_ALLOW_COMPACTION_BIT_KHR may take more time and memory than a normal build, and so should only be used when those features are needed.

Description

The following bits may be set in linearTilingFeatures and optimalTilingFeatures, specifying that the features are supported by images or image views or sampler Y′CBCR conversion objects created with the queried getPhysicalDeviceFormatProperties2::format:

FORMAT_FEATURE_2_SAMPLED_IMAGE_BIT_KHR specifies that an image view can be sampled from.
FORMAT_FEATURE_2_STORAGE_IMAGE_BIT_KHR specifies that an image view can be used as a storage image.
FORMAT_FEATURE_2_STORAGE_IMAGE_ATOMIC_BIT_KHR specifies that an image view can be used as storage image that supports atomic operations.
FORMAT_FEATURE_2_COLOR_ATTACHMENT_BIT_KHR specifies that an image view can be used as a framebuffer color attachment and as an input attachment.
FORMAT_FEATURE_2_COLOR_ATTACHMENT_BLEND_BIT_KHR specifies that an image view can be used as a framebuffer color attachment that supports blending and as an input attachment.
FORMAT_FEATURE_2_DEPTH_STENCIL_ATTACHMENT_BIT_KHR specifies that an image view can be used as a framebuffer depth/stencil attachment and as an input attachment.
FORMAT_FEATURE_2_BLIT_SRC_BIT_KHR specifies that an image can be used as srcImage for the cmdBlitImage2KHR and cmdBlitImage commands.
FORMAT_FEATURE_2_BLIT_DST_BIT_KHR specifies that an image can be used as dstImage for the cmdBlitImage2KHR and cmdBlitImage commands.
FORMAT_FEATURE_2_SAMPLED_IMAGE_FILTER_LINEAR_BIT_KHR specifies that if FORMAT_FEATURE_2_SAMPLED_IMAGE_BIT_KHR is also set, an image view can be used with a sampler that has either of magFilter or minFilter set to FILTER_LINEAR, or mipmapMode set to SAMPLER_MIPMAP_MODE_LINEAR. If FORMAT_FEATURE_2_BLIT_SRC_BIT_KHR is also set, an image can be used as the srcImage to cmdBlitImage2KHR and cmdBlitImage with a filter of FILTER_LINEAR. This bit must only be exposed for formats that also support the FORMAT_FEATURE_2_SAMPLED_IMAGE_BIT_KHR or FORMAT_FEATURE_2_BLIT_SRC_BIT_KHR.
If the format being queried is a depth/stencil format, this bit only specifies that the depth aspect (not the stencil aspect) of an image of this format supports linear filtering. Where depth comparison is supported it may be linear filtered whether this bit is present or not, but where this bit is not present the filtered value may be computed in an implementation-dependent manner which differs from the normal rules of linear filtering. The resulting value must be in the range [0,1] and should be proportional to, or a weighted average of, the number of comparison passes or failures.
FORMAT_FEATURE_2_TRANSFER_SRC_BIT_KHR specifies that an image can be used as a source image for copy commands.
FORMAT_FEATURE_2_TRANSFER_DST_BIT_KHR specifies that an image can be used as a destination image for copy commands and clear commands.
FORMAT_FEATURE_2_SAMPLED_IMAGE_FILTER_MINMAX_BIT_KHR specifies Image can be used as a sampled image with a min or max SamplerReductionMode. This bit must only be exposed for formats that also support the FORMAT_FEATURE_2_SAMPLED_IMAGE_BIT_KHR.
FORMAT_FEATURE_2_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT specifies that Image can be used with a sampler that has either of magFilter or minFilter set to FILTER_CUBIC_EXT, or be the source image for a blit with filter set to FILTER_CUBIC_EXT. This bit must only be exposed for formats that also support the FORMAT_FEATURE_2_SAMPLED_IMAGE_BIT_KHR. If the format being queried is a depth/stencil format, this only specifies that the depth aspect is cubic filterable.
FORMAT_FEATURE_2_MIDPOINT_CHROMA_SAMPLES_BIT_KHR specifies that an application can define a sampler Y′CBCR conversion using this format as a source, and that an image of this format can be used with a SamplerYcbcrConversionCreateInfo xChromaOffset and/or yChromaOffset of CHROMA_LOCATION_MIDPOINT. Otherwise both xChromaOffset and yChromaOffset must be CHROMA_LOCATION_COSITED_EVEN. If a format does not incorporate chroma downsampling (it is not a “422” or “420” format) but the implementation supports sampler Y′CBCR conversion for this format, the implementation must set FORMAT_FEATURE_2_MIDPOINT_CHROMA_SAMPLES_BIT_KHR.
FORMAT_FEATURE_2_COSITED_CHROMA_SAMPLES_BIT_KHR specifies that an application can define a sampler Y′CBCR conversion using this format as a source, and that an image of this format can be used with a SamplerYcbcrConversionCreateInfo xChromaOffset and/or yChromaOffset of CHROMA_LOCATION_COSITED_EVEN. Otherwise both xChromaOffset and yChromaOffset must be CHROMA_LOCATION_MIDPOINT. If neither FORMAT_FEATURE_2_COSITED_CHROMA_SAMPLES_BIT_KHR nor FORMAT_FEATURE_2_MIDPOINT_CHROMA_SAMPLES_BIT_KHR is set, the application must not define a sampler Y′CBCR conversion using this format as a source.
FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_LINEAR_FILTER_BIT_KHR specifies that an application can define a sampler Y′CBCR conversion using this format as a source with chromaFilter set to FILTER_LINEAR.
FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_SEPARATE_RECONSTRUCTION_FILTER_BIT_KHR specifies that the format can have different chroma, min, and mag filters.
FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_CHROMA_RECONSTRUCTION_EXPLICIT_BIT_KHR specifies that reconstruction is explicit, as described in https://www.khronos.org/registry/vulkan/specs/1.2-extensions/html/vkspec.html#textures-chroma-reconstruction. If this bit is not present, reconstruction is implicit by default.
FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_CHROMA_RECONSTRUCTION_EXPLICIT_FORCEABLE_BIT_KHR specifies that reconstruction can be forcibly made explicit by setting SamplerYcbcrConversionCreateInfo::forceExplicitReconstruction to TRUE. If the format being queried supports FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_CHROMA_RECONSTRUCTION_EXPLICIT_BIT_KHR it must also support FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_CHROMA_RECONSTRUCTION_EXPLICIT_FORCEABLE_BIT_KHR.
FORMAT_FEATURE_2_DISJOINT_BIT_KHR specifies that a multi-planar image can have the IMAGE_CREATE_DISJOINT_BIT set during image creation. An implementation must not set FORMAT_FEATURE_2_DISJOINT_BIT_KHR for single-plane formats.
FORMAT_FEATURE_2_FRAGMENT_DENSITY_MAP_BIT_EXT specifies that an image view can be used as a fragment density map attachment.
FORMAT_FEATURE_2_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR specifies that an image view can be used as a fragment shading rate attachment. An implementation must not set this feature for formats with numeric type other than *UINT, or set it as a buffer feature.
FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT_KHR specifies that image views created with this format can be used as storage images for read operations without specifying a format.
FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT_KHR specifies that image views created with this format can be used as storage images for write operations without specifying a format.
FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT_KHR specifies that image views created with this format can be used for depth comparison performed by OpImage*Dref instructions.

The following bits may be set in bufferFeatures, specifying that the features are supported by buffers or buffer views created with the queried getPhysicalDeviceFormatProperties2::format:

FORMAT_FEATURE_2_UNIFORM_TEXEL_BUFFER_BIT_KHR specifies that the format can be used to create a buffer view that can be bound to a DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER descriptor.
FORMAT_FEATURE_2_STORAGE_TEXEL_BUFFER_BIT_KHR specifies that the format can be used to create a buffer view that can be bound to a DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER descriptor.
FORMAT_FEATURE_2_STORAGE_TEXEL_BUFFER_ATOMIC_BIT_KHR specifies that atomic operations are supported on DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER with this format.
FORMAT_FEATURE_2_VERTEX_BUFFER_BIT_KHR specifies that the format can be used as a vertex attribute format (VertexInputAttributeDescription::format).
FORMAT_FEATURE_2_ACCELERATION_STRUCTURE_VERTEX_BUFFER_BIT_KHR specifies that the format can be used as the vertex format when creating an acceleration structure (AccelerationStructureGeometryTrianglesDataKHR::vertexFormat). This format can also be used as the vertex format in host memory when doing host acceleration structure builds.

Description

This handle refers to a tracking structure which manages the execution state for a deferred command.

Description

'

`DebugReportObjectTypeEXT`	Vulkan Handle Type
`DEBUG_REPORT_OBJECT_TYPE_UNKNOWN_EXT`	Unknown/Undefined Handle
`DEBUG_REPORT_OBJECT_TYPE_INSTANCE_EXT`	`Instance`
`DEBUG_REPORT_OBJECT_TYPE_PHYSICAL_DEVICE_EXT`	`PhysicalDevice`
`DEBUG_REPORT_OBJECT_TYPE_DEVICE_EXT`	`Device`
`DEBUG_REPORT_OBJECT_TYPE_QUEUE_EXT`	`Queue`
`DEBUG_REPORT_OBJECT_TYPE_SEMAPHORE_EXT`	`Semaphore`
`DEBUG_REPORT_OBJECT_TYPE_COMMAND_BUFFER_EXT`	`CommandBuffer`
`DEBUG_REPORT_OBJECT_TYPE_FENCE_EXT`	`Fence`
`DEBUG_REPORT_OBJECT_TYPE_DEVICE_MEMORY_EXT`	`DeviceMemory`
`DEBUG_REPORT_OBJECT_TYPE_BUFFER_EXT`	`Buffer`
`DEBUG_REPORT_OBJECT_TYPE_IMAGE_EXT`	`Image`
`DEBUG_REPORT_OBJECT_TYPE_EVENT_EXT`	`Event`
`DEBUG_REPORT_OBJECT_TYPE_QUERY_POOL_EXT`	`QueryPool`
`DEBUG_REPORT_OBJECT_TYPE_BUFFER_VIEW_EXT`	`BufferView`
`DEBUG_REPORT_OBJECT_TYPE_IMAGE_VIEW_EXT`	`ImageView`
`DEBUG_REPORT_OBJECT_TYPE_SHADER_MODULE_EXT`	`ShaderModule`
`DEBUG_REPORT_OBJECT_TYPE_PIPELINE_CACHE_EXT`	`PipelineCache`
`DEBUG_REPORT_OBJECT_TYPE_PIPELINE_LAYOUT_EXT`	`PipelineLayout`
`DEBUG_REPORT_OBJECT_TYPE_RENDER_PASS_EXT`	`RenderPass`
`DEBUG_REPORT_OBJECT_TYPE_PIPELINE_EXT`	`Pipeline`
`DEBUG_REPORT_OBJECT_TYPE_DESCRIPTOR_SET_LAYOUT_EXT`	`DescriptorSetLayout`
`DEBUG_REPORT_OBJECT_TYPE_SAMPLER_EXT`	`Sampler`
`DEBUG_REPORT_OBJECT_TYPE_DESCRIPTOR_POOL_EXT`	`DescriptorPool`
`DEBUG_REPORT_OBJECT_TYPE_DESCRIPTOR_SET_EXT`	`DescriptorSet`
`DEBUG_REPORT_OBJECT_TYPE_FRAMEBUFFER_EXT`	`Framebuffer`
`DEBUG_REPORT_OBJECT_TYPE_COMMAND_POOL_EXT`	`CommandPool`
`DEBUG_REPORT_OBJECT_TYPE_SURFACE_KHR_EXT`	`SurfaceKHR`
`DEBUG_REPORT_OBJECT_TYPE_SWAPCHAIN_KHR_EXT`	`SwapchainKHR`
`DEBUG_REPORT_OBJECT_TYPE_DEBUG_REPORT_CALLBACK_EXT_EXT`	`DebugReportCallbackEXT`
`DEBUG_REPORT_OBJECT_TYPE_DISPLAY_KHR_EXT`	`DisplayKHR`
`DEBUG_REPORT_OBJECT_TYPE_DISPLAY_MODE_KHR_EXT`	`DisplayModeKHR`
`DEBUG_REPORT_OBJECT_TYPE_DESCRIPTOR_UPDATE_TEMPLATE_EXT`	`DescriptorUpdateTemplate`

DebugReportObjectTypeEXT and Vulkan Handle Relationship

Note

The primary expected use of ERROR_VALIDATION_FAILED_EXT is for validation layer testing. It is not expected that an application would see this error code during normal use of the validation layers.

Description

When the 31 bits available in Flags are insufficient, the Flags64 type can be passed to commands and structures to represent up to 64 options. Flags64 is not used directly in the API. Instead, a Vk*Flags2 type which is an alias of Flags64, and whose name matches the corresponding Vk*FlagBits2 that are valid for that type, is used.

Any Vk*Flags2 member or parameter used in the API as an input must be a valid combination of bit flags. A valid combination is either zero or the bitwise OR of valid bit flags. A bit flag is valid if:

The bit flag is defined as part of the Vk*FlagBits2 type, where the bits type is obtained by taking the flag type and replacing the trailing Flags2 with FlagBits2. For example, a flag value of type AccessFlags2KHR must contain only bit flags defined by AccessFlagBits2KHR.
The flag is allowed in the context in which it is being used. For example, in some cases, certain bit flags or combinations of bit flags are mutually exclusive.

Any Vk*Flags2 member or parameter returned from a query command or otherwise output from Vulkan to the application may contain bit flags undefined in its corresponding Vk*FlagBits2 type. An application cannot rely on the state of these unspecified bits.

Note

Both the Vk*FlagBits2 type, and the individual bits defined for that type, are defined as uint64_t integers in the C API. This is in contrast to the 32-bit types, where the Vk*FlagBits type is defined as a C enum and the individual bits as enumerants belonging to that enum. As a result, there is less compile-time type checking possible for the 64-bit types. This is unavoidable since there is no sufficiently portable way to define a 64-bit enum type in C99.

Show WriteDescriptorSetAccelerationStructureKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods showsPrec :: Int -> WriteDescriptorSetAccelerationStructureKHR -> ShowS # show :: WriteDescriptorSetAccelerationStructureKHR -> String # showList :: [WriteDescriptorSetAccelerationStructureKHR] -> ShowS #
FromCStruct WriteDescriptorSetAccelerationStructureKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods peekCStruct :: Ptr WriteDescriptorSetAccelerationStructureKHR -> IO WriteDescriptorSetAccelerationStructureKHR Source #
ToCStruct WriteDescriptorSetAccelerationStructureKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods withCStruct :: WriteDescriptorSetAccelerationStructureKHR -> (Ptr WriteDescriptorSetAccelerationStructureKHR -> IO b) -> IO b Source # pokeCStruct :: Ptr WriteDescriptorSetAccelerationStructureKHR -> WriteDescriptorSetAccelerationStructureKHR -> IO b -> IO b Source # withZeroCStruct :: (Ptr WriteDescriptorSetAccelerationStructureKHR -> IO b) -> IO b Source # pokeZeroCStruct :: Ptr WriteDescriptorSetAccelerationStructureKHR -> IO b -> IO b Source # cStructSize :: Int Source # cStructAlignment :: Int Source #
Zero WriteDescriptorSetAccelerationStructureKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods zero :: WriteDescriptorSetAccelerationStructureKHR Source #

Eq PhysicalDeviceAccelerationStructureFeaturesKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods (==) :: PhysicalDeviceAccelerationStructureFeaturesKHR -> PhysicalDeviceAccelerationStructureFeaturesKHR -> Bool # (/=) :: PhysicalDeviceAccelerationStructureFeaturesKHR -> PhysicalDeviceAccelerationStructureFeaturesKHR -> Bool #
Show PhysicalDeviceAccelerationStructureFeaturesKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods showsPrec :: Int -> PhysicalDeviceAccelerationStructureFeaturesKHR -> ShowS # show :: PhysicalDeviceAccelerationStructureFeaturesKHR -> String # showList :: [PhysicalDeviceAccelerationStructureFeaturesKHR] -> ShowS #
Storable PhysicalDeviceAccelerationStructureFeaturesKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods sizeOf :: PhysicalDeviceAccelerationStructureFeaturesKHR -> Int # alignment :: PhysicalDeviceAccelerationStructureFeaturesKHR -> Int # peekElemOff :: Ptr PhysicalDeviceAccelerationStructureFeaturesKHR -> Int -> IO PhysicalDeviceAccelerationStructureFeaturesKHR # pokeElemOff :: Ptr PhysicalDeviceAccelerationStructureFeaturesKHR -> Int -> PhysicalDeviceAccelerationStructureFeaturesKHR -> IO () # peekByteOff :: Ptr b -> Int -> IO PhysicalDeviceAccelerationStructureFeaturesKHR # pokeByteOff :: Ptr b -> Int -> PhysicalDeviceAccelerationStructureFeaturesKHR -> IO () # peek :: Ptr PhysicalDeviceAccelerationStructureFeaturesKHR -> IO PhysicalDeviceAccelerationStructureFeaturesKHR # poke :: Ptr PhysicalDeviceAccelerationStructureFeaturesKHR -> PhysicalDeviceAccelerationStructureFeaturesKHR -> IO () #
FromCStruct PhysicalDeviceAccelerationStructureFeaturesKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods peekCStruct :: Ptr PhysicalDeviceAccelerationStructureFeaturesKHR -> IO PhysicalDeviceAccelerationStructureFeaturesKHR Source #
ToCStruct PhysicalDeviceAccelerationStructureFeaturesKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods withCStruct :: PhysicalDeviceAccelerationStructureFeaturesKHR -> (Ptr PhysicalDeviceAccelerationStructureFeaturesKHR -> IO b) -> IO b Source # pokeCStruct :: Ptr PhysicalDeviceAccelerationStructureFeaturesKHR -> PhysicalDeviceAccelerationStructureFeaturesKHR -> IO b -> IO b Source # withZeroCStruct :: (Ptr PhysicalDeviceAccelerationStructureFeaturesKHR -> IO b) -> IO b Source # pokeZeroCStruct :: Ptr PhysicalDeviceAccelerationStructureFeaturesKHR -> IO b -> IO b Source # cStructSize :: Int Source # cStructAlignment :: Int Source #
Zero PhysicalDeviceAccelerationStructureFeaturesKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods zero :: PhysicalDeviceAccelerationStructureFeaturesKHR Source #

Eq PhysicalDeviceAccelerationStructurePropertiesKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods (==) :: PhysicalDeviceAccelerationStructurePropertiesKHR -> PhysicalDeviceAccelerationStructurePropertiesKHR -> Bool # (/=) :: PhysicalDeviceAccelerationStructurePropertiesKHR -> PhysicalDeviceAccelerationStructurePropertiesKHR -> Bool #
Show PhysicalDeviceAccelerationStructurePropertiesKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods showsPrec :: Int -> PhysicalDeviceAccelerationStructurePropertiesKHR -> ShowS # show :: PhysicalDeviceAccelerationStructurePropertiesKHR -> String # showList :: [PhysicalDeviceAccelerationStructurePropertiesKHR] -> ShowS #
Storable PhysicalDeviceAccelerationStructurePropertiesKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods sizeOf :: PhysicalDeviceAccelerationStructurePropertiesKHR -> Int # alignment :: PhysicalDeviceAccelerationStructurePropertiesKHR -> Int # peekElemOff :: Ptr PhysicalDeviceAccelerationStructurePropertiesKHR -> Int -> IO PhysicalDeviceAccelerationStructurePropertiesKHR # pokeElemOff :: Ptr PhysicalDeviceAccelerationStructurePropertiesKHR -> Int -> PhysicalDeviceAccelerationStructurePropertiesKHR -> IO () # peekByteOff :: Ptr b -> Int -> IO PhysicalDeviceAccelerationStructurePropertiesKHR # pokeByteOff :: Ptr b -> Int -> PhysicalDeviceAccelerationStructurePropertiesKHR -> IO () # peek :: Ptr PhysicalDeviceAccelerationStructurePropertiesKHR -> IO PhysicalDeviceAccelerationStructurePropertiesKHR # poke :: Ptr PhysicalDeviceAccelerationStructurePropertiesKHR -> PhysicalDeviceAccelerationStructurePropertiesKHR -> IO () #
FromCStruct PhysicalDeviceAccelerationStructurePropertiesKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods peekCStruct :: Ptr PhysicalDeviceAccelerationStructurePropertiesKHR -> IO PhysicalDeviceAccelerationStructurePropertiesKHR Source #
ToCStruct PhysicalDeviceAccelerationStructurePropertiesKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods withCStruct :: PhysicalDeviceAccelerationStructurePropertiesKHR -> (Ptr PhysicalDeviceAccelerationStructurePropertiesKHR -> IO b) -> IO b Source # pokeCStruct :: Ptr PhysicalDeviceAccelerationStructurePropertiesKHR -> PhysicalDeviceAccelerationStructurePropertiesKHR -> IO b -> IO b Source # withZeroCStruct :: (Ptr PhysicalDeviceAccelerationStructurePropertiesKHR -> IO b) -> IO b Source # pokeZeroCStruct :: Ptr PhysicalDeviceAccelerationStructurePropertiesKHR -> IO b -> IO b Source # cStructSize :: Int Source # cStructAlignment :: Int Source #
Zero PhysicalDeviceAccelerationStructurePropertiesKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods zero :: PhysicalDeviceAccelerationStructurePropertiesKHR Source #

Extensible AccelerationStructureGeometryTrianglesDataKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods extensibleTypeName :: String Source # getNext :: forall (es :: [Type]). AccelerationStructureGeometryTrianglesDataKHR es -> Chain es Source # setNext :: forall (ds :: [Type]) (es :: [Type]). AccelerationStructureGeometryTrianglesDataKHR ds -> Chain es -> AccelerationStructureGeometryTrianglesDataKHR es Source # extends :: forall e b proxy. Typeable e => proxy e -> (Extends AccelerationStructureGeometryTrianglesDataKHR e => b) -> Maybe b Source #
Show (Chain es) => Show (AccelerationStructureGeometryTrianglesDataKHR es) Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods showsPrec :: Int -> AccelerationStructureGeometryTrianglesDataKHR es -> ShowS # show :: AccelerationStructureGeometryTrianglesDataKHR es -> String # showList :: [AccelerationStructureGeometryTrianglesDataKHR es] -> ShowS #
(Extendss AccelerationStructureGeometryTrianglesDataKHR es, PokeChain es) => ToCStruct (AccelerationStructureGeometryTrianglesDataKHR es) Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods withCStruct :: AccelerationStructureGeometryTrianglesDataKHR es -> (Ptr (AccelerationStructureGeometryTrianglesDataKHR es) -> IO b) -> IO b Source # pokeCStruct :: Ptr (AccelerationStructureGeometryTrianglesDataKHR es) -> AccelerationStructureGeometryTrianglesDataKHR es -> IO b -> IO b Source # withZeroCStruct :: (Ptr (AccelerationStructureGeometryTrianglesDataKHR es) -> IO b) -> IO b Source # pokeZeroCStruct :: Ptr (AccelerationStructureGeometryTrianglesDataKHR es) -> IO b -> IO b Source # cStructSize :: Int Source # cStructAlignment :: Int Source #
es ~ ('[] :: [Type]) => Zero (AccelerationStructureGeometryTrianglesDataKHR es) Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods zero :: AccelerationStructureGeometryTrianglesDataKHR es Source #

Show AccelerationStructureGeometryAabbsDataKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods showsPrec :: Int -> AccelerationStructureGeometryAabbsDataKHR -> ShowS # show :: AccelerationStructureGeometryAabbsDataKHR -> String # showList :: [AccelerationStructureGeometryAabbsDataKHR] -> ShowS #
ToCStruct AccelerationStructureGeometryAabbsDataKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods withCStruct :: AccelerationStructureGeometryAabbsDataKHR -> (Ptr AccelerationStructureGeometryAabbsDataKHR -> IO b) -> IO b Source # pokeCStruct :: Ptr AccelerationStructureGeometryAabbsDataKHR -> AccelerationStructureGeometryAabbsDataKHR -> IO b -> IO b Source # withZeroCStruct :: (Ptr AccelerationStructureGeometryAabbsDataKHR -> IO b) -> IO b Source # pokeZeroCStruct :: Ptr AccelerationStructureGeometryAabbsDataKHR -> IO b -> IO b Source # cStructSize :: Int Source # cStructAlignment :: Int Source #
Zero AccelerationStructureGeometryAabbsDataKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods zero :: AccelerationStructureGeometryAabbsDataKHR Source #

:: forall io. MonadIO io
=> CommandBuffer	`commandBuffer` is the command buffer into which the command will be recorded.
-> CopyAccelerationStructureInfoKHR	`pInfo` is a pointer to a `CopyAccelerationStructureInfoKHR` structure defining the copy operation.
-> io ()

:: forall io. MonadIO io
=> Device	`device` is the device which owns the acceleration structures.
-> DeferredOperationKHR	`deferredOperation` is an optional `DeferredOperationKHR` to request deferral for this command.
-> CopyAccelerationStructureInfoKHR	`pInfo` is a pointer to a `CopyAccelerationStructureInfoKHR` structure defining the copy operation.
-> io Result

:: forall io. MonadIO io
=> Device	`device` is the device which owns `pInfo->src`.
-> DeferredOperationKHR	`deferredOperation` is an optional `DeferredOperationKHR` to request deferral for this command.
-> CopyAccelerationStructureToMemoryInfoKHR	`pInfo` is a pointer to a `CopyAccelerationStructureToMemoryInfoKHR` structure defining the copy operation.
-> io Result

:: forall io. MonadIO io
=> Device	`device` is the device to check the version against.
-> AccelerationStructureVersionInfoKHR	`pVersionInfo` is a pointer to a `AccelerationStructureVersionInfoKHR` structure specifying version information to check against the device.
-> io AccelerationStructureCompatibilityKHR

:: forall a io. (Extendss AccelerationStructureCreateInfoKHR a, PokeChain a, MonadIO io)
=> Device	`device` is the logical device that creates the acceleration structure object.
-> AccelerationStructureCreateInfoKHR a	`pCreateInfo` is a pointer to a `AccelerationStructureCreateInfoKHR` structure containing parameters affecting creation of the acceleration structure.
-> ("allocator" ::: Maybe AllocationCallbacks)	`pAllocator` controls host memory allocation as described in the Memory Allocation chapter.
-> io AccelerationStructureKHR

:: forall io. MonadIO io
=> Device	`device` is the `Device` for which the acceleration structures are being built.
-> DeferredOperationKHR	`deferredOperation` is an optional `DeferredOperationKHR` to request deferral for this command.
-> ("infos" ::: Vector AccelerationStructureBuildGeometryInfoKHR)	`pInfos` is a pointer to an array of `infoCount` `AccelerationStructureBuildGeometryInfoKHR` structures defining the geometry used to build each acceleration structure.
-> ("buildRangeInfos" ::: Vector (Vector AccelerationStructureBuildRangeInfoKHR))	`ppBuildRangeInfos` is a pointer to an array of `infoCount` pointers to arrays of `AccelerationStructureBuildRangeInfoKHR` structures. Each `ppBuildRangeInfos`[i] is a pointer to an array of `pInfos`[i].`geometryCount` `AccelerationStructureBuildRangeInfoKHR` structures defining dynamic offsets to the addresses where geometry data is stored, as defined by `pInfos`[i].
-> io Result

:: forall io. MonadIO io
=> Device	`device` is the logical device that the acceleration structure was created on.
-> AccelerationStructureDeviceAddressInfoKHR	`pInfo` is a pointer to a `AccelerationStructureDeviceAddressInfoKHR` structure specifying the acceleration structure to retrieve an address for.
-> io DeviceAddress

:: forall io. MonadIO io
=> Device	`device` is the logical device that will be used for creating the acceleration structure.
-> AccelerationStructureBuildTypeKHR	`buildType` defines whether host or device operations (or both) are being queried for.
-> ("buildInfo" ::: AccelerationStructureBuildGeometryInfoKHR)	`pBuildInfo` is a pointer to a `AccelerationStructureBuildGeometryInfoKHR` structure describing parameters of a build operation.
-> ("maxPrimitiveCounts" ::: Vector Word32)	`pMaxPrimitiveCounts` is a pointer to an array of `pBuildInfo->geometryCount` `uint32_t` values defining the number of primitives built into each geometry.
-> io ("sizeInfo" ::: AccelerationStructureBuildSizesInfoKHR)

WriteDescriptorSetAccelerationStructureKHR
Fields accelerationStructures :: Vector AccelerationStructureKHR `pAccelerationStructures` is a pointer to an array of `AccelerationStructureKHR` structures specifying the acceleration structures to update.

Show AccelerationStructureGeometryInstancesDataKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods showsPrec :: Int -> AccelerationStructureGeometryInstancesDataKHR -> ShowS # show :: AccelerationStructureGeometryInstancesDataKHR -> String # showList :: [AccelerationStructureGeometryInstancesDataKHR] -> ShowS #
ToCStruct AccelerationStructureGeometryInstancesDataKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods withCStruct :: AccelerationStructureGeometryInstancesDataKHR -> (Ptr AccelerationStructureGeometryInstancesDataKHR -> IO b) -> IO b Source # pokeCStruct :: Ptr AccelerationStructureGeometryInstancesDataKHR -> AccelerationStructureGeometryInstancesDataKHR -> IO b -> IO b Source # withZeroCStruct :: (Ptr AccelerationStructureGeometryInstancesDataKHR -> IO b) -> IO b Source # pokeZeroCStruct :: Ptr AccelerationStructureGeometryInstancesDataKHR -> IO b -> IO b Source # cStructSize :: Int Source # cStructAlignment :: Int Source #
Zero AccelerationStructureGeometryInstancesDataKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods zero :: AccelerationStructureGeometryInstancesDataKHR Source #

Show AccelerationStructureGeometryKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods showsPrec :: Int -> AccelerationStructureGeometryKHR -> ShowS # show :: AccelerationStructureGeometryKHR -> String # showList :: [AccelerationStructureGeometryKHR] -> ShowS #
ToCStruct AccelerationStructureGeometryKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods withCStruct :: AccelerationStructureGeometryKHR -> (Ptr AccelerationStructureGeometryKHR -> IO b) -> IO b Source # pokeCStruct :: Ptr AccelerationStructureGeometryKHR -> AccelerationStructureGeometryKHR -> IO b -> IO b Source # withZeroCStruct :: (Ptr AccelerationStructureGeometryKHR -> IO b) -> IO b Source # pokeZeroCStruct :: Ptr AccelerationStructureGeometryKHR -> IO b -> IO b Source # cStructSize :: Int Source # cStructAlignment :: Int Source #
Zero AccelerationStructureGeometryKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods zero :: AccelerationStructureGeometryKHR Source #

Show AccelerationStructureBuildGeometryInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods showsPrec :: Int -> AccelerationStructureBuildGeometryInfoKHR -> ShowS # show :: AccelerationStructureBuildGeometryInfoKHR -> String # showList :: [AccelerationStructureBuildGeometryInfoKHR] -> ShowS #
ToCStruct AccelerationStructureBuildGeometryInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods withCStruct :: AccelerationStructureBuildGeometryInfoKHR -> (Ptr AccelerationStructureBuildGeometryInfoKHR -> IO b) -> IO b Source # pokeCStruct :: Ptr AccelerationStructureBuildGeometryInfoKHR -> AccelerationStructureBuildGeometryInfoKHR -> IO b -> IO b Source # withZeroCStruct :: (Ptr AccelerationStructureBuildGeometryInfoKHR -> IO b) -> IO b Source # pokeZeroCStruct :: Ptr AccelerationStructureBuildGeometryInfoKHR -> IO b -> IO b Source # cStructSize :: Int Source # cStructAlignment :: Int Source #
Zero AccelerationStructureBuildGeometryInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods zero :: AccelerationStructureBuildGeometryInfoKHR Source #

Eq AccelerationStructureBuildRangeInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods (==) :: AccelerationStructureBuildRangeInfoKHR -> AccelerationStructureBuildRangeInfoKHR -> Bool # (/=) :: AccelerationStructureBuildRangeInfoKHR -> AccelerationStructureBuildRangeInfoKHR -> Bool #
Show AccelerationStructureBuildRangeInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods showsPrec :: Int -> AccelerationStructureBuildRangeInfoKHR -> ShowS # show :: AccelerationStructureBuildRangeInfoKHR -> String # showList :: [AccelerationStructureBuildRangeInfoKHR] -> ShowS #
Storable AccelerationStructureBuildRangeInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods sizeOf :: AccelerationStructureBuildRangeInfoKHR -> Int # alignment :: AccelerationStructureBuildRangeInfoKHR -> Int # peekElemOff :: Ptr AccelerationStructureBuildRangeInfoKHR -> Int -> IO AccelerationStructureBuildRangeInfoKHR # pokeElemOff :: Ptr AccelerationStructureBuildRangeInfoKHR -> Int -> AccelerationStructureBuildRangeInfoKHR -> IO () # peekByteOff :: Ptr b -> Int -> IO AccelerationStructureBuildRangeInfoKHR # pokeByteOff :: Ptr b -> Int -> AccelerationStructureBuildRangeInfoKHR -> IO () # peek :: Ptr AccelerationStructureBuildRangeInfoKHR -> IO AccelerationStructureBuildRangeInfoKHR # poke :: Ptr AccelerationStructureBuildRangeInfoKHR -> AccelerationStructureBuildRangeInfoKHR -> IO () #
FromCStruct AccelerationStructureBuildRangeInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods peekCStruct :: Ptr AccelerationStructureBuildRangeInfoKHR -> IO AccelerationStructureBuildRangeInfoKHR Source #
ToCStruct AccelerationStructureBuildRangeInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods withCStruct :: AccelerationStructureBuildRangeInfoKHR -> (Ptr AccelerationStructureBuildRangeInfoKHR -> IO b) -> IO b Source # pokeCStruct :: Ptr AccelerationStructureBuildRangeInfoKHR -> AccelerationStructureBuildRangeInfoKHR -> IO b -> IO b Source # withZeroCStruct :: (Ptr AccelerationStructureBuildRangeInfoKHR -> IO b) -> IO b Source # pokeZeroCStruct :: Ptr AccelerationStructureBuildRangeInfoKHR -> IO b -> IO b Source # cStructSize :: Int Source # cStructAlignment :: Int Source #
Zero AccelerationStructureBuildRangeInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods zero :: AccelerationStructureBuildRangeInfoKHR Source #

Extensible AccelerationStructureCreateInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods extensibleTypeName :: String Source # getNext :: forall (es :: [Type]). AccelerationStructureCreateInfoKHR es -> Chain es Source # setNext :: forall (ds :: [Type]) (es :: [Type]). AccelerationStructureCreateInfoKHR ds -> Chain es -> AccelerationStructureCreateInfoKHR es Source # extends :: forall e b proxy. Typeable e => proxy e -> (Extends AccelerationStructureCreateInfoKHR e => b) -> Maybe b Source #
Show (Chain es) => Show (AccelerationStructureCreateInfoKHR es) Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods showsPrec :: Int -> AccelerationStructureCreateInfoKHR es -> ShowS # show :: AccelerationStructureCreateInfoKHR es -> String # showList :: [AccelerationStructureCreateInfoKHR es] -> ShowS #
(Extendss AccelerationStructureCreateInfoKHR es, PeekChain es) => FromCStruct (AccelerationStructureCreateInfoKHR es) Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods peekCStruct :: Ptr (AccelerationStructureCreateInfoKHR es) -> IO (AccelerationStructureCreateInfoKHR es) Source #
(Extendss AccelerationStructureCreateInfoKHR es, PokeChain es) => ToCStruct (AccelerationStructureCreateInfoKHR es) Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods withCStruct :: AccelerationStructureCreateInfoKHR es -> (Ptr (AccelerationStructureCreateInfoKHR es) -> IO b) -> IO b Source # pokeCStruct :: Ptr (AccelerationStructureCreateInfoKHR es) -> AccelerationStructureCreateInfoKHR es -> IO b -> IO b Source # withZeroCStruct :: (Ptr (AccelerationStructureCreateInfoKHR es) -> IO b) -> IO b Source # pokeZeroCStruct :: Ptr (AccelerationStructureCreateInfoKHR es) -> IO b -> IO b Source # cStructSize :: Int Source # cStructAlignment :: Int Source #
es ~ ('[] :: [Type]) => Zero (AccelerationStructureCreateInfoKHR es) Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods zero :: AccelerationStructureCreateInfoKHR es Source #

Eq AabbPositionsKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods (==) :: AabbPositionsKHR -> AabbPositionsKHR -> Bool # (/=) :: AabbPositionsKHR -> AabbPositionsKHR -> Bool #
Show AabbPositionsKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods showsPrec :: Int -> AabbPositionsKHR -> ShowS # show :: AabbPositionsKHR -> String # showList :: [AabbPositionsKHR] -> ShowS #
Storable AabbPositionsKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods sizeOf :: AabbPositionsKHR -> Int # alignment :: AabbPositionsKHR -> Int # peekElemOff :: Ptr AabbPositionsKHR -> Int -> IO AabbPositionsKHR # pokeElemOff :: Ptr AabbPositionsKHR -> Int -> AabbPositionsKHR -> IO () # peekByteOff :: Ptr b -> Int -> IO AabbPositionsKHR # pokeByteOff :: Ptr b -> Int -> AabbPositionsKHR -> IO () # peek :: Ptr AabbPositionsKHR -> IO AabbPositionsKHR # poke :: Ptr AabbPositionsKHR -> AabbPositionsKHR -> IO () #
FromCStruct AabbPositionsKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods peekCStruct :: Ptr AabbPositionsKHR -> IO AabbPositionsKHR Source #
ToCStruct AabbPositionsKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods withCStruct :: AabbPositionsKHR -> (Ptr AabbPositionsKHR -> IO b) -> IO b Source # pokeCStruct :: Ptr AabbPositionsKHR -> AabbPositionsKHR -> IO b -> IO b Source # withZeroCStruct :: (Ptr AabbPositionsKHR -> IO b) -> IO b Source # pokeZeroCStruct :: Ptr AabbPositionsKHR -> IO b -> IO b Source # cStructSize :: Int Source # cStructAlignment :: Int Source #
Zero AabbPositionsKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods zero :: AabbPositionsKHR Source #

TransformMatrixKHR
Fields matrixRow0 :: (Float, Float, Float, Float) matrixRow1 :: (Float, Float, Float, Float) matrixRow2 :: (Float, Float, Float, Float)

Eq TransformMatrixKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods (==) :: TransformMatrixKHR -> TransformMatrixKHR -> Bool # (/=) :: TransformMatrixKHR -> TransformMatrixKHR -> Bool #
Show TransformMatrixKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods showsPrec :: Int -> TransformMatrixKHR -> ShowS # show :: TransformMatrixKHR -> String # showList :: [TransformMatrixKHR] -> ShowS #
Storable TransformMatrixKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods sizeOf :: TransformMatrixKHR -> Int # alignment :: TransformMatrixKHR -> Int # peekElemOff :: Ptr TransformMatrixKHR -> Int -> IO TransformMatrixKHR # pokeElemOff :: Ptr TransformMatrixKHR -> Int -> TransformMatrixKHR -> IO () # peekByteOff :: Ptr b -> Int -> IO TransformMatrixKHR # pokeByteOff :: Ptr b -> Int -> TransformMatrixKHR -> IO () # peek :: Ptr TransformMatrixKHR -> IO TransformMatrixKHR # poke :: Ptr TransformMatrixKHR -> TransformMatrixKHR -> IO () #
FromCStruct TransformMatrixKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods peekCStruct :: Ptr TransformMatrixKHR -> IO TransformMatrixKHR Source #
ToCStruct TransformMatrixKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods withCStruct :: TransformMatrixKHR -> (Ptr TransformMatrixKHR -> IO b) -> IO b Source # pokeCStruct :: Ptr TransformMatrixKHR -> TransformMatrixKHR -> IO b -> IO b Source # withZeroCStruct :: (Ptr TransformMatrixKHR -> IO b) -> IO b Source # pokeZeroCStruct :: Ptr TransformMatrixKHR -> IO b -> IO b Source # cStructSize :: Int Source # cStructAlignment :: Int Source #
Zero TransformMatrixKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods zero :: TransformMatrixKHR Source #

Show AccelerationStructureInstanceKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods showsPrec :: Int -> AccelerationStructureInstanceKHR -> ShowS # show :: AccelerationStructureInstanceKHR -> String # showList :: [AccelerationStructureInstanceKHR] -> ShowS #
Storable AccelerationStructureInstanceKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods sizeOf :: AccelerationStructureInstanceKHR -> Int # alignment :: AccelerationStructureInstanceKHR -> Int # peekElemOff :: Ptr AccelerationStructureInstanceKHR -> Int -> IO AccelerationStructureInstanceKHR # pokeElemOff :: Ptr AccelerationStructureInstanceKHR -> Int -> AccelerationStructureInstanceKHR -> IO () # peekByteOff :: Ptr b -> Int -> IO AccelerationStructureInstanceKHR # pokeByteOff :: Ptr b -> Int -> AccelerationStructureInstanceKHR -> IO () # peek :: Ptr AccelerationStructureInstanceKHR -> IO AccelerationStructureInstanceKHR # poke :: Ptr AccelerationStructureInstanceKHR -> AccelerationStructureInstanceKHR -> IO () #
FromCStruct AccelerationStructureInstanceKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods peekCStruct :: Ptr AccelerationStructureInstanceKHR -> IO AccelerationStructureInstanceKHR Source #
ToCStruct AccelerationStructureInstanceKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods withCStruct :: AccelerationStructureInstanceKHR -> (Ptr AccelerationStructureInstanceKHR -> IO b) -> IO b Source # pokeCStruct :: Ptr AccelerationStructureInstanceKHR -> AccelerationStructureInstanceKHR -> IO b -> IO b Source # withZeroCStruct :: (Ptr AccelerationStructureInstanceKHR -> IO b) -> IO b Source # pokeZeroCStruct :: Ptr AccelerationStructureInstanceKHR -> IO b -> IO b Source # cStructSize :: Int Source # cStructAlignment :: Int Source #
Zero AccelerationStructureInstanceKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods zero :: AccelerationStructureInstanceKHR Source #

AccelerationStructureDeviceAddressInfoKHR
Fields accelerationStructure :: AccelerationStructureKHR `accelerationStructure` specifies the acceleration structure whose address is being queried. `accelerationStructure` must be a valid `AccelerationStructureKHR` handle

Eq AccelerationStructureDeviceAddressInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods (==) :: AccelerationStructureDeviceAddressInfoKHR -> AccelerationStructureDeviceAddressInfoKHR -> Bool # (/=) :: AccelerationStructureDeviceAddressInfoKHR -> AccelerationStructureDeviceAddressInfoKHR -> Bool #
Show AccelerationStructureDeviceAddressInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods showsPrec :: Int -> AccelerationStructureDeviceAddressInfoKHR -> ShowS # show :: AccelerationStructureDeviceAddressInfoKHR -> String # showList :: [AccelerationStructureDeviceAddressInfoKHR] -> ShowS #
Storable AccelerationStructureDeviceAddressInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods sizeOf :: AccelerationStructureDeviceAddressInfoKHR -> Int # alignment :: AccelerationStructureDeviceAddressInfoKHR -> Int # peekElemOff :: Ptr AccelerationStructureDeviceAddressInfoKHR -> Int -> IO AccelerationStructureDeviceAddressInfoKHR # pokeElemOff :: Ptr AccelerationStructureDeviceAddressInfoKHR -> Int -> AccelerationStructureDeviceAddressInfoKHR -> IO () # peekByteOff :: Ptr b -> Int -> IO AccelerationStructureDeviceAddressInfoKHR # pokeByteOff :: Ptr b -> Int -> AccelerationStructureDeviceAddressInfoKHR -> IO () # peek :: Ptr AccelerationStructureDeviceAddressInfoKHR -> IO AccelerationStructureDeviceAddressInfoKHR # poke :: Ptr AccelerationStructureDeviceAddressInfoKHR -> AccelerationStructureDeviceAddressInfoKHR -> IO () #
FromCStruct AccelerationStructureDeviceAddressInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods peekCStruct :: Ptr AccelerationStructureDeviceAddressInfoKHR -> IO AccelerationStructureDeviceAddressInfoKHR Source #
ToCStruct AccelerationStructureDeviceAddressInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods withCStruct :: AccelerationStructureDeviceAddressInfoKHR -> (Ptr AccelerationStructureDeviceAddressInfoKHR -> IO b) -> IO b Source # pokeCStruct :: Ptr AccelerationStructureDeviceAddressInfoKHR -> AccelerationStructureDeviceAddressInfoKHR -> IO b -> IO b Source # withZeroCStruct :: (Ptr AccelerationStructureDeviceAddressInfoKHR -> IO b) -> IO b Source # pokeZeroCStruct :: Ptr AccelerationStructureDeviceAddressInfoKHR -> IO b -> IO b Source # cStructSize :: Int Source # cStructAlignment :: Int Source #
Zero AccelerationStructureDeviceAddressInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods zero :: AccelerationStructureDeviceAddressInfoKHR Source #

Name

VK_KHR_acceleration_structure

Other Extension Metadata

Description

New Object Types

New Commands

New Structures

New Unions

New Enums

New Bitmasks

New Enum Constants

Issues

Version History

See Also

Document Notes

Documentation

Valid Usage

Valid Usage (Implicit)

Host Synchronization

See Also

Description

Valid Usage

Valid Usage (Implicit)

Host Synchronization

Command Properties

See Also

Description

Valid Usage

Valid Usage (Implicit)

Return Codes

See Also

Description

Valid Usage

Valid Usage (Implicit)

Host Synchronization

Command Properties

See Also

Description

Valid Usage

Valid Usage (Implicit)

Return Codes

See Also

Description

Valid Usage

Valid Usage (Implicit)

Host Synchronization

Command Properties

See Also

Description

Valid Usage

Valid Usage (Implicit)

Return Codes

See Also

Description

Valid Usage

Valid Usage (Implicit)

Host Synchronization

Command Properties

See Also

Description

Valid Usage

Valid Usage (Implicit)

Return Codes

See Also

Valid Usage

Valid Usage (Implicit)

See Also

Description

Valid Usage

Valid Usage (Implicit)

Return Codes

See Also

Description

Valid Usage

Valid Usage (Implicit)

Host Synchronization

Command Properties

See Also

Description

Valid Usage

AccelerationStructureVersionInfoKHR
Fields versionData :: ByteString `pVersionData` is a pointer to the version header of an acceleration structure as defined in `cmdCopyAccelerationStructureToMemoryKHR` `pVersionData` must be a valid pointer to an array of \(2 \times \mathtt{VK\_UUID\_SIZE}\) `uint8_t` values

Show AccelerationStructureVersionInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods showsPrec :: Int -> AccelerationStructureVersionInfoKHR -> ShowS # show :: AccelerationStructureVersionInfoKHR -> String # showList :: [AccelerationStructureVersionInfoKHR] -> ShowS #
FromCStruct AccelerationStructureVersionInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods peekCStruct :: Ptr AccelerationStructureVersionInfoKHR -> IO AccelerationStructureVersionInfoKHR Source #
ToCStruct AccelerationStructureVersionInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods withCStruct :: AccelerationStructureVersionInfoKHR -> (Ptr AccelerationStructureVersionInfoKHR -> IO b) -> IO b Source # pokeCStruct :: Ptr AccelerationStructureVersionInfoKHR -> AccelerationStructureVersionInfoKHR -> IO b -> IO b Source # withZeroCStruct :: (Ptr AccelerationStructureVersionInfoKHR -> IO b) -> IO b Source # pokeZeroCStruct :: Ptr AccelerationStructureVersionInfoKHR -> IO b -> IO b Source # cStructSize :: Int Source # cStructAlignment :: Int Source #
Zero AccelerationStructureVersionInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods zero :: AccelerationStructureVersionInfoKHR Source #

CopyAccelerationStructureInfoKHR
Fields src :: AccelerationStructureKHR `src` is the source acceleration structure for the copy. dst :: AccelerationStructureKHR `dst` is the target acceleration structure for the copy. mode :: CopyAccelerationStructureModeKHR `mode` is a `CopyAccelerationStructureModeKHR` value specifying additional operations to perform during the copy.

Eq CopyAccelerationStructureInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods (==) :: CopyAccelerationStructureInfoKHR -> CopyAccelerationStructureInfoKHR -> Bool # (/=) :: CopyAccelerationStructureInfoKHR -> CopyAccelerationStructureInfoKHR -> Bool #
Show CopyAccelerationStructureInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods showsPrec :: Int -> CopyAccelerationStructureInfoKHR -> ShowS # show :: CopyAccelerationStructureInfoKHR -> String # showList :: [CopyAccelerationStructureInfoKHR] -> ShowS #
Storable CopyAccelerationStructureInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods sizeOf :: CopyAccelerationStructureInfoKHR -> Int # alignment :: CopyAccelerationStructureInfoKHR -> Int # peekElemOff :: Ptr CopyAccelerationStructureInfoKHR -> Int -> IO CopyAccelerationStructureInfoKHR # pokeElemOff :: Ptr CopyAccelerationStructureInfoKHR -> Int -> CopyAccelerationStructureInfoKHR -> IO () # peekByteOff :: Ptr b -> Int -> IO CopyAccelerationStructureInfoKHR # pokeByteOff :: Ptr b -> Int -> CopyAccelerationStructureInfoKHR -> IO () # peek :: Ptr CopyAccelerationStructureInfoKHR -> IO CopyAccelerationStructureInfoKHR # poke :: Ptr CopyAccelerationStructureInfoKHR -> CopyAccelerationStructureInfoKHR -> IO () #
FromCStruct CopyAccelerationStructureInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods peekCStruct :: Ptr CopyAccelerationStructureInfoKHR -> IO CopyAccelerationStructureInfoKHR Source #
ToCStruct CopyAccelerationStructureInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods withCStruct :: CopyAccelerationStructureInfoKHR -> (Ptr CopyAccelerationStructureInfoKHR -> IO b) -> IO b Source # pokeCStruct :: Ptr CopyAccelerationStructureInfoKHR -> CopyAccelerationStructureInfoKHR -> IO b -> IO b Source # withZeroCStruct :: (Ptr CopyAccelerationStructureInfoKHR -> IO b) -> IO b Source # pokeZeroCStruct :: Ptr CopyAccelerationStructureInfoKHR -> IO b -> IO b Source # cStructSize :: Int Source # cStructAlignment :: Int Source #
Zero CopyAccelerationStructureInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods zero :: CopyAccelerationStructureInfoKHR Source #

CopyAccelerationStructureToMemoryInfoKHR
Fields src :: AccelerationStructureKHR `src` is the source acceleration structure for the copy dst :: DeviceOrHostAddressKHR `dst` is the device or host address to memory which is the target for the copy mode :: CopyAccelerationStructureModeKHR `mode` is a `CopyAccelerationStructureModeKHR` value specifying additional operations to perform during the copy.

Show CopyAccelerationStructureToMemoryInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods showsPrec :: Int -> CopyAccelerationStructureToMemoryInfoKHR -> ShowS # show :: CopyAccelerationStructureToMemoryInfoKHR -> String # showList :: [CopyAccelerationStructureToMemoryInfoKHR] -> ShowS #
ToCStruct CopyAccelerationStructureToMemoryInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods withCStruct :: CopyAccelerationStructureToMemoryInfoKHR -> (Ptr CopyAccelerationStructureToMemoryInfoKHR -> IO b) -> IO b Source # pokeCStruct :: Ptr CopyAccelerationStructureToMemoryInfoKHR -> CopyAccelerationStructureToMemoryInfoKHR -> IO b -> IO b Source # withZeroCStruct :: (Ptr CopyAccelerationStructureToMemoryInfoKHR -> IO b) -> IO b Source # pokeZeroCStruct :: Ptr CopyAccelerationStructureToMemoryInfoKHR -> IO b -> IO b Source # cStructSize :: Int Source # cStructAlignment :: Int Source #
Zero CopyAccelerationStructureToMemoryInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods zero :: CopyAccelerationStructureToMemoryInfoKHR Source #

CopyMemoryToAccelerationStructureInfoKHR
Fields src :: DeviceOrHostAddressConstKHR `src` is the device or host address to memory containing the source data for the copy. dst :: AccelerationStructureKHR `dst` is the target acceleration structure for the copy. mode :: CopyAccelerationStructureModeKHR `mode` is a `CopyAccelerationStructureModeKHR` value specifying additional operations to perform during the copy.

Show CopyMemoryToAccelerationStructureInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods showsPrec :: Int -> CopyMemoryToAccelerationStructureInfoKHR -> ShowS # show :: CopyMemoryToAccelerationStructureInfoKHR -> String # showList :: [CopyMemoryToAccelerationStructureInfoKHR] -> ShowS #
ToCStruct CopyMemoryToAccelerationStructureInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods withCStruct :: CopyMemoryToAccelerationStructureInfoKHR -> (Ptr CopyMemoryToAccelerationStructureInfoKHR -> IO b) -> IO b Source # pokeCStruct :: Ptr CopyMemoryToAccelerationStructureInfoKHR -> CopyMemoryToAccelerationStructureInfoKHR -> IO b -> IO b Source # withZeroCStruct :: (Ptr CopyMemoryToAccelerationStructureInfoKHR -> IO b) -> IO b Source # pokeZeroCStruct :: Ptr CopyMemoryToAccelerationStructureInfoKHR -> IO b -> IO b Source # cStructSize :: Int Source # cStructAlignment :: Int Source #
Zero CopyMemoryToAccelerationStructureInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods zero :: CopyMemoryToAccelerationStructureInfoKHR Source #

Eq AccelerationStructureBuildSizesInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods (==) :: AccelerationStructureBuildSizesInfoKHR -> AccelerationStructureBuildSizesInfoKHR -> Bool # (/=) :: AccelerationStructureBuildSizesInfoKHR -> AccelerationStructureBuildSizesInfoKHR -> Bool #
Show AccelerationStructureBuildSizesInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods showsPrec :: Int -> AccelerationStructureBuildSizesInfoKHR -> ShowS # show :: AccelerationStructureBuildSizesInfoKHR -> String # showList :: [AccelerationStructureBuildSizesInfoKHR] -> ShowS #
Storable AccelerationStructureBuildSizesInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods sizeOf :: AccelerationStructureBuildSizesInfoKHR -> Int # alignment :: AccelerationStructureBuildSizesInfoKHR -> Int # peekElemOff :: Ptr AccelerationStructureBuildSizesInfoKHR -> Int -> IO AccelerationStructureBuildSizesInfoKHR # pokeElemOff :: Ptr AccelerationStructureBuildSizesInfoKHR -> Int -> AccelerationStructureBuildSizesInfoKHR -> IO () # peekByteOff :: Ptr b -> Int -> IO AccelerationStructureBuildSizesInfoKHR # pokeByteOff :: Ptr b -> Int -> AccelerationStructureBuildSizesInfoKHR -> IO () # peek :: Ptr AccelerationStructureBuildSizesInfoKHR -> IO AccelerationStructureBuildSizesInfoKHR # poke :: Ptr AccelerationStructureBuildSizesInfoKHR -> AccelerationStructureBuildSizesInfoKHR -> IO () #
FromCStruct AccelerationStructureBuildSizesInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods peekCStruct :: Ptr AccelerationStructureBuildSizesInfoKHR -> IO AccelerationStructureBuildSizesInfoKHR Source #
ToCStruct AccelerationStructureBuildSizesInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods withCStruct :: AccelerationStructureBuildSizesInfoKHR -> (Ptr AccelerationStructureBuildSizesInfoKHR -> IO b) -> IO b Source # pokeCStruct :: Ptr AccelerationStructureBuildSizesInfoKHR -> AccelerationStructureBuildSizesInfoKHR -> IO b -> IO b Source # withZeroCStruct :: (Ptr AccelerationStructureBuildSizesInfoKHR -> IO b) -> IO b Source # pokeZeroCStruct :: Ptr AccelerationStructureBuildSizesInfoKHR -> IO b -> IO b Source # cStructSize :: Int Source # cStructAlignment :: Int Source #
Zero AccelerationStructureBuildSizesInfoKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods zero :: AccelerationStructureBuildSizesInfoKHR Source #

Show DeviceOrHostAddressKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods showsPrec :: Int -> DeviceOrHostAddressKHR -> ShowS # show :: DeviceOrHostAddressKHR -> String # showList :: [DeviceOrHostAddressKHR] -> ShowS #
ToCStruct DeviceOrHostAddressKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods withCStruct :: DeviceOrHostAddressKHR -> (Ptr DeviceOrHostAddressKHR -> IO b) -> IO b Source # pokeCStruct :: Ptr DeviceOrHostAddressKHR -> DeviceOrHostAddressKHR -> IO b -> IO b Source # withZeroCStruct :: (Ptr DeviceOrHostAddressKHR -> IO b) -> IO b Source # pokeZeroCStruct :: Ptr DeviceOrHostAddressKHR -> IO b -> IO b Source # cStructSize :: Int Source # cStructAlignment :: Int Source #
Zero DeviceOrHostAddressKHR Source #
Instance details Defined in Vulkan.Extensions.VK_KHR_acceleration_structure Methods zero :: DeviceOrHostAddressKHR Source #