Lines Matching refs:acceleration
5 [[acceleration-structure]]
9 [[acceleration-structure-def]]
15 The application is responsible for managing acceleration structure objects
16 (see <<resources-acceleration-structures,Acceleration Structures>>),
20 There are two types of acceleration structures, _top level acceleration
21 structures_ and _bottom level acceleration structures_.
23 An acceleration structure is considered to be constructed if an
24 <<acceleration-structure-building,acceleration structure build command>> or
25 <<acceleration-structure-copying,copy command>> has been executed with the
26 given acceleration structure as the destination.
33 The diagram shows the relationship between top and bottom level acceleration
38 [[acceleration-structure-geometry]]
44 [[acceleration-structure-top-level]]
47 Opaque acceleration structure for an array of instances.
51 The top level acceleration structure takes a reference to any bottom level
52 acceleration structure referenced by its instances.
53 Those bottom level acceleration structure objects must: be valid when the
54 top level acceleration structure is accessed.
57 [[acceleration-structure-bottom-level]]
60 Opaque acceleration structure for an array of geometries.
63 [[acceleration-structure-update]]
66 The API defines two types of operations to produce acceleration structures
69 * A _build_ operation is used to construct an acceleration structure.
70 * An _update_ operation is used to modify an existing acceleration
76 description of the acceleration structure, but is prohibited from changing
86 versa (as defined in <<acceleration-structure-inactive-prims>>).
97 If the original acceleration structure was built using opacity micromaps and
112 associated with any acceleration-structure triangle.
114 If the original acceleration structure was built using opacity micromaps and
119 If the original acceleration structure was built using opacity micromaps and
126 If the original acceleration structure was built using displacement
132 If the original acceleration structure was built using displacement
137 [[acceleration-structure-inactive-prims]]
150 An _inactive_ instance is one whose acceleration structure reference is `0`.
160 represented in the acceleration structure.
172 acceleration structure rebuild.
173 Applications must: not perform an acceleration structure update where an
174 object is active in the source acceleration structure but would be inactive
178 [[acceleration-structure-building]]
182 [open,refpage='vkCmdBuildAccelerationStructureNV',desc='Build an acceleration structure',type='prot…
186 To build an acceleration structure call:
192 * pname:pInfo contains the shared information for the acceleration
196 acceleration structures.
197 This parameter must: be `NULL` for bottom level acceleration structures.
200 * pname:update specifies whether to update the pname:dst acceleration
202 * pname:dst is a pointer to the target acceleration structure for the
204 * pname:src is a pointer to an existing acceleration structure that is to
205 be used to update the pname:dst acceleration structure.
277 <<acceleration-structure-inactive-prims>>
281 <<acceleration-structure-inactive-prims>>
298 [open,refpage='vkCmdBuildAccelerationStructuresKHR',desc='Build an acceleration structure',type='pr…
302 To build acceleration structures call:
308 * pname:infoCount is the number of acceleration structures to build.
313 the geometry used to build each acceleration structure.
324 to initiate multiple acceleration structures builds, however there is no
326 acceleration structure builds.
331 This means that an application cannot: build a top-level acceleration
333 associated bottom-level or instance acceleration structures are being built.
334 There also cannot: be any memory aliasing between any acceleration structure
338 [[acceleration-structure-scratch]]
339 Accesses to the acceleration structure scratch buffers as identified by the
390 [open,refpage='vkCmdBuildAccelerationStructuresIndirectKHR',desc='Build an acceleration structure w…
394 To build acceleration structures with some parameters sourced on the device
401 * pname:infoCount is the number of acceleration structures to build.
404 the geometry used to build each acceleration structure.
418 Accesses to acceleration structures, scratch buffers, vertex buffers, index
420 <<acceleration-structure-scratch,vkCmdBuildAccelerationStructuresKHR>>.
484 …nfoKHR',desc='Structure specifying the geometry data used to build an acceleration structure',type…
497 the type of acceleration structure being built.
500 parameters of the acceleration structure.
503 * pname:srcAccelerationStructure is a pointer to an existing acceleration
504 structure that is to be used to update the pname:dst acceleration
507 * pname:dstAccelerationStructure is a pointer to the target acceleration
521 acceleration structure geometry.
524 [[acceleration-structure-geometry-index]]
541 [[acceleration-structure-motion-instances]]
543 indicates that this build is a motion top level acceleration structure.
563 A top level acceleration structure with either motion instances or vertex
572 Otherwise, the target acceleration structure is updated and the source is
656 destination acceleration structure will be built using the specified
659 destination acceleration structure will be built using data in a source
660 acceleration structure, updated by the specified geometries.
693 …eometryKHR',desc='Structure specifying geometries to be built into an acceleration structure',type…
714 [open,refpage='VkAccelerationStructureGeometryDataKHR',desc='Union specifying acceleration structur…
732 …KHR',desc='Structure specifying a triangle geometry in a bottom-level acceleration structure',type…
756 are described to the space in which the acceleration structure is
765 acceleration structure geometry is instead restricted to being a 32-bit
789 …lesDataNV',desc='Structure specifying vertex motion in a bottom-level acceleration structure',type…
821 …EXT',desc='Structure specifying an opacity micromap in a bottom-level acceleration structure',type…
853 For each triangle in the geometry, the acceleration structure build fetches
905 …,desc='Structure specifying a displacement micromap in a bottom-level acceleration structure',type…
953 For each triangle in the geometry, the acceleration structure build fetches
1005 …cture specifying axis-aligned bounding box geometry in a bottom-level acceleration structure',type…
1073 …esc='Structure specifying a geometry consisting of instances of other acceleration structures',typ…
1092 <<acceleration-structure-motion-instances, motion instances>>
1111 …nceKHR',desc='Structure specifying a single acceleration structure instance for building into an a…
1115 _Acceleration structure instances_ can: be built into top-level acceleration
1117 Each acceleration structure instance is a separate entry in the top-level
1118 acceleration structure which includes all the geometry of a bottom-level
1119 acceleration structure at a transformed location.
1120 Multiple instances can: point to the same bottom level acceleration
1123 An acceleration structure instance is defined by the structure:
1134 transformation to be applied to the acceleration structure.
1148 (used by device operations which reference acceleration structures) or,
1150 which reference acceleration structures).
1229 …NV',desc='Structure specifying a single acceleration structure motion instance for building into a…
1234 acceleration structures.
1235 Each acceleration structure instance is a separate entry in the top-level
1236 acceleration structure which includes all the geometry of a bottom-level
1237 acceleration structure at a transformed location including a type of motion
1240 An acceleration structure motion instance is defined by the structure:
1262 …tanceDataNV',desc='Union specifying a acceleration structure motion instance data for building int…
1290 …peNV',desc='Enum specifying a type of acceleration structure motion instance data for building int…
1309 …,desc='Structure specifying a single acceleration structure matrix motion instance for building in…
1313 An acceleration structure matrix motion instance is defined by the
1319 transformation to be applied to the acceleration structure at time 0.
1321 transformation to be applied to the acceleration structure at time 1.
1335 (used by device operations which reference acceleration structures) or,
1337 which reference acceleration structures).
1369 …',desc='Structure specifying a single acceleration structure SRT motion instance for building into…
1373 An acceleration structure SRT motion instance is defined by the structure:
1378 transformation to be applied to the acceleration structure at time 0.
1380 transformation to be applied to the acceleration structure at time 1.
1394 (used by device operations which reference acceleration structures) or,
1396 which reference acceleration structures).
1432 An acceleration structure SRT transform is defined by the structure:
1508 …RangeInfoKHR',desc='Structure specifying build offsets and counts for acceleration structure build…
1517 corresponding acceleration structure geometry.
1551 in which the acceleration structure is defined.
1558 pname:primitiveCount is the number of acceleration structures.
1603 [[acceleration-structure-copying]]
1606 An additional command exists for copying acceleration structures without
1608 The acceleration structure object can: be compacted in order to improve
1611 acceleration structure.
1613 [open,refpage='vkCmdWriteAccelerationStructuresPropertiesKHR',desc='Write acceleration structure re…
1617 To query acceleration structure size parameters call:
1625 * pname:accelerationStructureCount is the count of acceleration structures
1628 previously built acceleration structures.
1636 Accesses to any of the acceleration structures listed in
1651 acceleration structure.
1655 acceleration structure.
1670 The pname:buffer used to create each acceleration structure in
1682 [open,refpage='vkCmdWriteAccelerationStructuresPropertiesNV',desc='Write acceleration structure res…
1686 To query acceleration structure size parameters call:
1692 * pname:accelerationStructureCount is the count of acceleration structures
1695 previously built acceleration structures.
1703 Accesses to any of the acceleration structures listed in
1724 All acceleration structures in pname:pAccelerationStructures must: have
1727 All acceleration structures in pname:pAccelerationStructures must: have
1740 [open,refpage='vkCmdCopyAccelerationStructureNV',desc='Copy an acceleration structure',type='protos…
1744 To copy an acceleration structure call:
1750 * pname:dst is the target acceleration structure for the copy.
1751 * pname:src is the source acceleration structure for the copy.
1777 [open,refpage='vkCmdCopyAccelerationStructureKHR',desc='Copy an acceleration structure',type='proto…
1781 To copy an acceleration structure call:
1790 This command copies the pname:pInfo->src acceleration structure to the
1791 pname:pInfo->dst acceleration structure in the manner specified by
1823 [open,refpage='VkCopyAccelerationStructureInfoKHR',desc='Parameters for copying an acceleration str…
1834 * pname:src is the source acceleration structure for the copy.
1835 * pname:dst is the target acceleration structure for the copy.
1864 copy of the acceleration structure specified in pname:src into the one
1866 The pname:dst acceleration structure must: have been created with the
1868 If pname:src contains references to other acceleration structures,
1869 pname:dst will reference the same acceleration structures.
1871 compact version of an acceleration structure pname:src into pname:dst.
1872 The acceleration structure pname:dst must: have been created with a size
1878 after the build of the acceleration structure specified by pname:src.
1879 If pname:src contains references to other acceleration structures,
1880 pname:dst will reference the same acceleration structures.
1882 acceleration structure to a semi-opaque format which can be reloaded on
1885 the semi-opaque serialization format in the buffer to the acceleration
1889 [open,refpage='vkCmdCopyAccelerationStructureToMemoryKHR',desc='Copy an acceleration structure to d…
1893 To copy an acceleration structure to device memory call:
1941 * A 64-bit integer of the count of the number of acceleration structure
1947 This will be zero for a bottom-level acceleration structure.
1948 For top-level acceleration structures this number is
1951 acceleration structure.
1959 original application-generated bottom-level acceleration structures to
1987 …lerationStructureToMemoryInfoKHR',desc='Parameters for serializing an acceleration structure',type…
1996 * pname:src is the source acceleration structure for the copy
2005 The source acceleration structure pname:src must: have been constructed
2021 …dCopyMemoryToAccelerationStructureKHR',desc='Copy device memory to an acceleration structure',type…
2025 To copy device memory to an acceleration structure call:
2055 This command can accept acceleration structures produced by either
2060 flink:vkCmdCopyAccelerationStructureToMemoryKHR, with any acceleration
2062 acceleration structures created before deserialization.
2088 …ToAccelerationStructureInfoKHR',desc='Parameters for deserializing an acceleration structure',type…
2102 * pname:dst is the target acceleration structure for the copy.
2111 potentially modified to relocate acceleration structure references as
2128 …iceAccelerationStructureCompatibilityKHR',desc='Check if a serialized acceleration structure is co…
2132 To check if a serialized acceleration structure is compatible with the
2167 * pname:pVersionData is a pointer to the version header of an acceleration
2176 serialized acceleration structure (via
2193 pname:pVersionData version acceleration structure is compatible with
2196 pname:pVersionData version acceleration structure is not compatible with
2201 [[host-acceleration-structure]]
2205 acceleration structure operations if the
2224 All acceleration structures used by the host commands must: be bound to
2225 host-visible memory, and all input data for acceleration structure builds
2227 Applications are not required to map acceleration structure memory when
2252 For efficient execution, acceleration structures manipulated using these
2258 [open,refpage='vkBuildAccelerationStructuresKHR',desc='Build an acceleration structure on the host'…
2262 To build acceleration structures on the host, call:
2266 * pname:device is the sname:VkDevice for which the acceleration structures
2271 * pname:infoCount is the number of acceleration structures to build.
2276 the geometry used to build each acceleration structure.
2290 initiate multiple acceleration structures builds, however there is no
2292 acceleration structure builds.
2297 This means that an application cannot: build a top-level acceleration
2299 associated bottom-level or instance acceleration structures are being built.
2300 There also cannot: be any memory aliasing between any acceleration structure
2326 acceleration structure referenced by the pname:geometry.instances.data
2386 acceleration structure referenced by the pname:geometry.instances.data
2419 [open,refpage='vkCopyAccelerationStructureKHR',desc='Copy an acceleration structure on the host',ty…
2423 To copy or compact an acceleration structure on the host, call:
2427 * pname:device is the device which owns the acceleration structures.
2462 [open,refpage='vkCopyMemoryToAccelerationStructureKHR',desc='Deserialize an acceleration structure …
2466 To copy host accessible memory to an acceleration structure, call:
2481 This command can accept acceleration structures produced by either
2509 [open,refpage='vkCopyAccelerationStructureToMemoryKHR',desc='Serialize an acceleration structure on…
2513 To copy an acceleration structure to host accessible memory, call:
2560 [open,refpage='vkWriteAccelerationStructuresPropertiesKHR',desc='Query acceleration structure meta-…
2564 To query acceleration structure size parameters on the host, call:
2568 * pname:device is the device which owns the acceleration structures in
2570 * pname:accelerationStructureCount is the count of acceleration structures
2573 previously built acceleration structures.
2633 The pname:buffer used to create each acceleration structure in
2638 The pname:buffer used to create each acceleration structure in