vulkan
Safe HaskellNone
LanguageHaskell2010

Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Description

Name

VK_KHR_ray_tracing_pipeline - device extension

VK_KHR_ray_tracing_pipeline

Name String
VK_KHR_ray_tracing_pipeline
Extension Type
Device extension
Registered Extension Number
348
Revision
1
Ratification Status
Ratified
Extension and Version Dependencies

VK_KHR_spirv_1_4      or

Vulkan Version 1.2 and VK_KHR_acceleration_structure

API Interactions
  • Interacts with VK_KHR_ray_query
SPIR-V Dependencies
Contact

Other Extension Metadata

Last Modified Date
2020-11-12
Interactions and External Dependencies
Contributors
  • 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
  • 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
  • Spencer Fricke, Samsung
  • Lewis Gordon, Samsung
  • Ralph Potter, Samsung
  • Jasper Bekkers, Traverse Research
  • Jesse Barker, Unity
  • Baldur Karlsson, Valve

Description

Rasterization has been the dominant method to produce interactive graphics, but increasing performance of graphics hardware has made ray tracing a viable option for interactive rendering. Being able to integrate ray tracing with traditional rasterization makes it easier for applications to incrementally add ray traced effects to existing applications or to do hybrid approaches with rasterization for primary visibility and ray tracing for secondary queries.

To enable ray tracing, this extension adds a few different categories of new functionality:

  • A new ray tracing pipeline type with new shader domains: ray generation, intersection, any-hit, closest hit, miss, and callable
  • A shader binding indirection table to link shader groups with acceleration structure items
  • Ray tracing commands which initiate the ray pipeline traversal and invocation of the various new shader domains depending on which traversal conditions are met

This extension adds support for the following SPIR-V extension in Vulkan:

  • SPV_KHR_ray_tracing

New Commands

New Structures

New Enums

New Enum Constants

New or Modified Built-In Variables

New SPIR-V Capabilities

Issues

  1. How does this extension differ from VK_NV_ray_tracing?

DISCUSSION:

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

  • added support for indirect ray tracing (cmdTraceRaysIndirectKHR)

  • uses SPV_KHR_ray_tracing instead of SPV_NV_ray_tracing

    • refer to KHR SPIR-V enums instead of NV SPIR-V enums (which are functionally equivalent and aliased to the same values).
    • added RayGeometryIndexKHR built-in
  • removed vkCompileDeferredNV compilation functionality and replaced with deferred host operations interactions for ray tracing
  • added PhysicalDeviceRayTracingPipelineFeaturesKHR structure

  • extended PhysicalDeviceRayTracingPipelinePropertiesKHR structure

    • renamed maxRecursionDepth to maxRayRecursionDepth and it has a minimum of 1 instead of 31
    • require shaderGroupHandleSize to be 32 bytes
    • added maxRayDispatchInvocationCount, shaderGroupHandleAlignment and maxRayHitAttributeSize
  • reworked geometry structures so they could be better shared between device, host, and indirect builds
  • changed SBT parameters to a structure and added size (StridedDeviceAddressRegionKHR)
  • add parameter for requesting memory requirements for host and/or device build
  • added pipeline library support for ray tracing
  • added watertightness guarantees
  • added no-null-shader pipeline flags (VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_*_SHADERS_BIT_KHR)
  • added memory model interactions with ray tracing and define how subgroups work and can be repacked
  1. Can you give a more detailed comparison of differences and similarities between VK_NV_ray_tracing and VK_KHR_ray_tracing_pipeline?

DISCUSSION:

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

  1. What are the changes between the public provisional (VK_KHR_ray_tracing v8) release and the internal provisional (VK_KHR_ray_tracing v9) release?
  1. What are the changes between the internal provisional (VK_KHR_ray_tracing v9) release and the final (VK_KHR_acceleration_structure v11 / VK_KHR_ray_tracing_pipeline v1) 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)

  • Require Volatile for the following builtins in the ray generation, closest hit, miss, intersection, and callable shader stages:

    • SubgroupSize, SubgroupLocalInvocationId, SubgroupEqMask, SubgroupGeMask, SubgroupGtMask, SubgroupLeMask, SubgroupLtMask
    • SMIDNV, WarpIDNV

  • clarify buffer usage flags for ray tracing

  • rename maxRecursionDepth to maxRayPipelineRecursionDepth (pipeline creation) and maxRayRecursionDepth (limit) to reduce confusion
  • Add queryable maxRayHitAttributeSize limit and rename members of RayTracingPipelineInterfaceCreateInfoKHR to maxPipelineRayPayloadSize and maxPipelineRayHitAttributeSize for clarity
  • Update SPIRV capabilities to use RayTracingKHR
  • extension is no longer provisional
  • define synchronization requirements for indirect trace rays and indirect buffer
  1. This extension adds gl_InstanceID for the intersection, any-hit, and closest hit shaders, but in KHR_vulkan_glsl, gl_InstanceID is replaced with gl_InstanceIndex. Which should be used for Vulkan in this extension?

RESOLVED: This extension uses gl_InstanceID and maps it to InstanceId in SPIR-V. It is acknowledged that this is different than other shader stages in Vulkan. There are two main reasons for the difference here:

  • symmetry with gl_PrimitiveID which is also available in these shaders
  • there is no “baseInstance” relevant for these shaders, and so ID makes it more obvious that this is zero-based.
  1. Why is VK_KHR_pipeline_library an interaction instead of a required dependency, particularly when the “Device Extensions” section says it is required to be supported anyhow?

RESOLVED: If the VK_KHR_pipeline_library extension were a required dependency, then every application would need to enable the extension whether or not they actually want to use the pipeline library functionality. Developers found this to be annoying and unfriendly behavior. We do wish to require all implementations to support it though, and thus it is listed as a requirement in device extensions section.

Sample Code

Example ray generation GLSL shader

#version 450 core
#extension GL_EXT_ray_tracing : require
layout(set = 0, binding = 0, rgba8) uniform image2D image;
layout(set = 0, binding = 1) uniform accelerationStructureEXT as;
layout(location = 0) rayPayloadEXT float payload;

void main()
{
   vec4 col = vec4(0, 0, 0, 1);

   vec3 origin = vec3(float(gl_LaunchIDEXT.x)/float(gl_LaunchSizeEXT.x), float(gl_LaunchIDEXT.y)/float(gl_LaunchSizeEXT.y), 1.0);
   vec3 dir = vec3(0.0, 0.0, -1.0);

   traceRayEXT(as, 0, 0xff, 0, 1, 0, origin, 0.0, dir, 1000.0, 0);

   col.y = payload;

   imageStore(image, ivec2(gl_LaunchIDEXT.xy), col);
}

Version History

  • Revision 1, 2020-11-12 (Mathieu Robart, Daniel Koch, Eric Werness, Tobias Hector)

    • Decomposition of the specification, from VK_KHR_ray_tracing to VK_KHR_ray_tracing_pipeline (#1918,!3912)
    • require certain subgroup and sm_shader_builtin shader builtins to be decorated as volatile in the ray generation, closest hit, miss, intersection, and callable stages (#1924,!3903,!3954)
    • clarify buffer usage flags for ray tracing (#2181,!3939)
    • rename maxRecursionDepth to maxRayPipelineRecursionDepth and maxRayRecursionDepth (#2203,!3937)
    • add queryable maxRayHitAttributeSize and rename members of VkRayTracingPipelineInterfaceCreateInfoKHR (#2102,!3966)
    • update to use RayTracingKHR SPIR-V capability
    • add VUs for matching hit group type against geometry type (#2245,!3994)
    • require RayTMaxKHR be volatile in intersection shaders (#2268,!4030)
    • add numerical limits for ray parameters (#2235,!3960)
    • fix SBT indexing rules for device addresses (#2308,!4079)
    • relax formula for ray intersection candidate determination (#2322,!4080)
    • add more details on ShaderRecordBufferKHR variables (#2230,!4083)
    • clarify valid bits for InstanceCustomIndexKHR (GLSL/GLSL#19,!4128)
    • allow at most one IncomingRayPayloadKHR, IncomingCallableDataKHR, and HitAttributeKHR (!4129)
    • add minimum for maxShaderGroupStride (#2353,!4131)
    • require VK_KHR_pipeline_library extension to be supported (#2348,!4135)
    • clarify meaning of 'geometry index' (#2272,!4137)
    • restrict traces to TLAS (#2239,!4141)
    • add note about maxPipelineRayPayloadSize (#2383,!4172)
    • do not require raygen shader in pipeline libraries (!4185)
    • define sync for indirect trace rays and indirect buffer (#2407,!4208)

See Also

No cross-references are available

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

Documentation

cmdTraceRaysKHR Source #

Arguments

:: MonadIO io 
=> CommandBuffer

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

-> ("raygenShaderBindingTable" ::: StridedDeviceAddressRegionKHR)

pRaygenShaderBindingTable is a StridedDeviceAddressRegionKHR that holds the shader binding table data for the ray generation shader stage.

-> ("missShaderBindingTable" ::: StridedDeviceAddressRegionKHR)

pMissShaderBindingTable is a StridedDeviceAddressRegionKHR that holds the shader binding table data for the miss shader stage.

-> ("hitShaderBindingTable" ::: StridedDeviceAddressRegionKHR)

pHitShaderBindingTable is a StridedDeviceAddressRegionKHR that holds the shader binding table data for the hit shader stage.

-> ("callableShaderBindingTable" ::: StridedDeviceAddressRegionKHR)

pCallableShaderBindingTable is a StridedDeviceAddressRegionKHR that holds the shader binding table data for the callable shader stage.

-> ("width" ::: Word32)

width is the width of the ray trace query dimensions.

-> ("height" ::: Word32)

height is height of the ray trace query dimensions.

-> ("depth" ::: Word32)

depth is depth of the ray trace query dimensions.

-> io () 

vkCmdTraceRaysKHR - Initialize a ray tracing dispatch

Description

When the command is executed, a ray generation group of width × height × depth rays is assembled.

Valid Usage

Valid Usage (Implicit)

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 LevelsRender Pass ScopeVideo Coding ScopeSupported Queue TypesCommand Type
Primary SecondaryOutside Outside VK_QUEUE_COMPUTE_BIT Action

Conditional Rendering

vkCmdTraceRaysKHR is not affected by conditional rendering

See Also

VK_KHR_ray_tracing_pipeline, CommandBuffer, StridedDeviceAddressRegionKHR

getRayTracingShaderGroupHandlesKHR Source #

Arguments

:: MonadIO io 
=> Device

device is the logical device containing the ray tracing pipeline.

-> Pipeline

pipeline is the ray tracing pipeline object containing the shaders.

-> ("firstGroup" ::: Word32)

firstGroup is the index of the first group to retrieve a handle for from the RayTracingPipelineCreateInfoKHR::pGroups or RayTracingPipelineCreateInfoNV::pGroups array.

-> ("groupCount" ::: Word32)

groupCount is the number of shader handles to retrieve.

-> ("dataSize" ::: Word64)

dataSize is the size in bytes of the buffer pointed to by pData.

-> ("data" ::: Ptr ())

pData is a pointer to an application-allocated buffer where the results will be written.

-> io () 

vkGetRayTracingShaderGroupHandlesKHR - Query ray tracing pipeline shader group handles

Description

On success, an array of groupCount shader handles will be written to pData, with each element being of size PhysicalDeviceRayTracingPipelinePropertiesKHR::shaderGroupHandleSize.

If pipeline was created with PIPELINE_CREATE_LIBRARY_BIT_KHR and the pipelineLibraryGroupHandles feature is enabled applications can query group handles from that pipeline, even if the pipeline is a library and is never bound to a command buffer. These group handles remain bitwise identical for any pipeline which references the pipeline library. Group indices are assigned as-if the pipeline was created without PIPELINE_CREATE_LIBRARY_BIT_KHR.

Valid Usage

  • pipeline must be a ray tracing pipeline

Valid Usage (Implicit)

  • device must be a valid Device handle
  • pipeline must be a valid Pipeline handle
  • pData must be a valid pointer to an array of dataSize bytes
  • dataSize must be greater than 0
  • pipeline must have been created, allocated, or retrieved from device

Return Codes

Success
Failure

See Also

VK_KHR_ray_tracing_pipeline, VK_NV_ray_tracing, Device, Pipeline

getRayTracingCaptureReplayShaderGroupHandlesKHR Source #

Arguments

:: MonadIO io 
=> Device

device is the logical device containing the ray tracing pipeline.

-> Pipeline

pipeline is the ray tracing pipeline object containing the shaders.

-> ("firstGroup" ::: Word32)

firstGroup is the index of the first group to retrieve a handle for from the RayTracingPipelineCreateInfoKHR::pGroups array.

-> ("groupCount" ::: Word32)

groupCount is the number of shader handles to retrieve.

-> ("dataSize" ::: Word64)

dataSize is the size in bytes of the buffer pointed to by pData.

-> ("data" ::: Ptr ())

pData is a pointer to an application-allocated buffer where the results will be written.

-> io () 

vkGetRayTracingCaptureReplayShaderGroupHandlesKHR - Query opaque capture replay data for pipeline shader group handles

Description

On success, an array of groupCount shader handles will be written to pData, with each element being of size PhysicalDeviceRayTracingPipelinePropertiesKHR::shaderGroupHandleCaptureReplaySize.

Once queried, this opaque data can be provided at pipeline creation time (in a subsequent execution), using RayTracingShaderGroupCreateInfoKHR::pShaderGroupCaptureReplayHandle, as described in Ray Tracing Capture Replay.

If pipeline was created with PIPELINE_CREATE_LIBRARY_BIT_KHR and the pipelineLibraryGroupHandles feature is enabled applications can query capture replay group handles from that pipeline. The capture replay handle remains bitwise identical for any pipeline which references the pipeline library. Group indices are assigned as-if the pipeline was created without PIPELINE_CREATE_LIBRARY_BIT_KHR.

Valid Usage

  • pipeline must be a ray tracing pipeline

Valid Usage (Implicit)

  • device must be a valid Device handle
  • pipeline must be a valid Pipeline handle
  • pData must be a valid pointer to an array of dataSize bytes
  • dataSize must be greater than 0
  • pipeline must have been created, allocated, or retrieved from device

Return Codes

Success
Failure

See Also

VK_KHR_ray_tracing_pipeline, Device, Pipeline

createRayTracingPipelinesKHR Source #

Arguments

:: MonadIO io 
=> Device

device is the logical device that creates the ray tracing pipelines.

-> DeferredOperationKHR

deferredOperation is NULL_HANDLE or the handle of a valid DeferredOperationKHR request deferral object for this command.

-> PipelineCache

pipelineCache is either NULL_HANDLE, indicating that pipeline caching is disabled, or to enable caching, the handle of a valid PipelineCache object. The implementation must not access this object outside of the duration of this command.

-> ("createInfos" ::: Vector (SomeStruct RayTracingPipelineCreateInfoKHR))

pCreateInfos is a pointer to an array of RayTracingPipelineCreateInfoKHR structures.

-> ("allocator" ::: Maybe AllocationCallbacks)

pAllocator controls host memory allocation as described in the Memory Allocation chapter.

-> io (Result, "pipelines" ::: Vector Pipeline) 

vkCreateRayTracingPipelinesKHR - Creates a new ray tracing pipeline object

Description

The ERROR_INVALID_OPAQUE_CAPTURE_ADDRESS error is returned if the implementation is unable to reuse the shader group handles provided in RayTracingShaderGroupCreateInfoKHR::pShaderGroupCaptureReplayHandle when PhysicalDeviceRayTracingPipelineFeaturesKHR::rayTracingPipelineShaderGroupHandleCaptureReplay is enabled.

Pipelines are created and returned as described for Multiple Pipeline Creation.

Valid Usage

Valid Usage (Implicit)

  • device must be a valid Device handle
  • If deferredOperation is not NULL_HANDLE, deferredOperation must be a valid DeferredOperationKHR handle
  • If pipelineCache is not NULL_HANDLE, pipelineCache must be a valid PipelineCache handle
  • pCreateInfos must be a valid pointer to an array of createInfoCount valid RayTracingPipelineCreateInfoKHR structures
  • If pAllocator is not NULL, pAllocator must be a valid pointer to a valid AllocationCallbacks structure
  • pPipelines must be a valid pointer to an array of createInfoCount Pipeline handles
  • createInfoCount must be greater than 0
  • If deferredOperation is a valid handle, it must have been created, allocated, or retrieved from device
  • If pipelineCache is a valid handle, it must have been created, allocated, or retrieved from device

Return Codes

Success
Failure

See Also

VK_KHR_ray_tracing_pipeline, AllocationCallbacks, DeferredOperationKHR, Device, Pipeline, PipelineCache, RayTracingPipelineCreateInfoKHR

withRayTracingPipelinesKHR :: MonadIO io => Device -> DeferredOperationKHR -> PipelineCache -> Vector (SomeStruct RayTracingPipelineCreateInfoKHR) -> Maybe AllocationCallbacks -> (io (Result, Vector Pipeline) -> ((Result, Vector Pipeline) -> io ()) -> r) -> r Source #

A convenience wrapper to make a compatible pair of calls to createRayTracingPipelinesKHR and destroyPipeline

To ensure that destroyPipeline is always called: pass bracket (or the allocate function from your favourite resource management library) as the last argument. To just extract the pair pass (,) as the last argument.

cmdTraceRaysIndirectKHR Source #

Arguments

:: MonadIO io 
=> CommandBuffer

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

-> ("raygenShaderBindingTable" ::: StridedDeviceAddressRegionKHR)

pRaygenShaderBindingTable is a StridedDeviceAddressRegionKHR that holds the shader binding table data for the ray generation shader stage.

-> ("missShaderBindingTable" ::: StridedDeviceAddressRegionKHR)

pMissShaderBindingTable is a StridedDeviceAddressRegionKHR that holds the shader binding table data for the miss shader stage.

-> ("hitShaderBindingTable" ::: StridedDeviceAddressRegionKHR)

pHitShaderBindingTable is a StridedDeviceAddressRegionKHR that holds the shader binding table data for the hit shader stage.

-> ("callableShaderBindingTable" ::: StridedDeviceAddressRegionKHR)

pCallableShaderBindingTable is a StridedDeviceAddressRegionKHR that holds the shader binding table data for the callable shader stage.

-> ("indirectDeviceAddress" ::: DeviceAddress)

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

-> io () 

vkCmdTraceRaysIndirectKHR - Initialize an indirect ray tracing dispatch

Description

cmdTraceRaysIndirectKHR behaves similarly to cmdTraceRaysKHR except that the ray trace query dimensions are read by the device from indirectDeviceAddress during execution.

Valid Usage

Valid Usage (Implicit)

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 LevelsRender Pass ScopeVideo Coding ScopeSupported Queue TypesCommand Type
Primary SecondaryOutside Outside VK_QUEUE_COMPUTE_BIT Action

Conditional Rendering

vkCmdTraceRaysIndirectKHR is not affected by conditional rendering

See Also

VK_KHR_ray_tracing_pipeline, CommandBuffer, DeviceAddress, StridedDeviceAddressRegionKHR

getRayTracingShaderGroupStackSizeKHR Source #

Arguments

:: MonadIO io 
=> Device

device is the logical device containing the ray tracing pipeline.

-> Pipeline

pipeline is the ray tracing pipeline object containing the shaders groups.

-> ("group" ::: Word32)

group is the index of the shader group to query.

-> ShaderGroupShaderKHR

groupShader is the type of shader from the group to query.

-> io DeviceSize 

vkGetRayTracingShaderGroupStackSizeKHR - Query ray tracing pipeline shader group shader stack size

Description

The return value is the ray tracing pipeline stack size in bytes for the specified shader as called from the specified shader group.

Valid Usage

  • pipeline must be a ray tracing pipeline
  • The value of group must be less than the number of shader groups in pipeline
  • The shader identified by groupShader in group must not be SHADER_UNUSED_KHR

Valid Usage (Implicit)

  • device must be a valid Device handle
  • pipeline must be a valid Pipeline handle
  • groupShader must be a valid ShaderGroupShaderKHR value
  • pipeline must have been created, allocated, or retrieved from device

See Also

VK_KHR_ray_tracing_pipeline, Device, Pipeline, ShaderGroupShaderKHR

cmdSetRayTracingPipelineStackSizeKHR Source #

Arguments

:: MonadIO io 
=> CommandBuffer

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

-> ("pipelineStackSize" ::: Word32)

pipelineStackSize is the stack size to use for subsequent ray tracing trace commands.

-> io () 

vkCmdSetRayTracingPipelineStackSizeKHR - Set the stack size dynamically for a ray tracing pipeline

Description

This command sets the stack size for subsequent ray tracing commands when the ray tracing pipeline is created with DYNAMIC_STATE_RAY_TRACING_PIPELINE_STACK_SIZE_KHR set in PipelineDynamicStateCreateInfo::pDynamicStates. Otherwise, the stack size is computed as described in Ray Tracing Pipeline Stack.

Valid Usage

  • pipelineStackSize must be large enough for any dynamic execution through the shaders in the ray tracing pipeline used by a subsequent trace call

Valid Usage (Implicit)

  • commandBuffer must be in the recording state
  • The CommandPool that commandBuffer was allocated from must support QUEUE_COMPUTE_BIT operations
  • This command must only be called outside of a render pass instance
  • This command must only be called outside of a video coding scope

Host Synchronization

  • Host access to commandBuffer must be externally synchronized
  • Host access to the CommandPool that commandBuffer was allocated from must be externally synchronized

Command Properties

'

Command Buffer LevelsRender Pass ScopeVideo Coding ScopeSupported Queue TypesCommand Type
Primary SecondaryOutside Outside VK_QUEUE_COMPUTE_BIT State

Conditional Rendering

vkCmdSetRayTracingPipelineStackSizeKHR is not affected by conditional rendering

See Also

VK_KHR_ray_tracing_pipeline, CommandBuffer

pattern PIPELINE_CREATE_2_RAY_TRACING_SKIP_BUILT_IN_PRIMITIVES_BIT_KHR :: PipelineCreateFlagBits2 Source #

data RayTracingShaderGroupCreateInfoKHR Source #

VkRayTracingShaderGroupCreateInfoKHR - Structure specifying shaders in a shader group

Description

If the pipeline is created with PIPELINE_CREATE_LIBRARY_BIT_KHR and the pipelineLibraryGroupHandles feature is enabled, pShaderGroupCaptureReplayHandle is inherited by all pipelines which link against this pipeline and remains bitwise identical for any pipeline which references this pipeline library.

Valid Usage

Valid Usage (Implicit)

See Also

VK_KHR_ray_tracing_pipeline, RayTracingPipelineCreateInfoKHR, RayTracingShaderGroupTypeKHR, StructureType

Constructors

RayTracingShaderGroupCreateInfoKHR 

Fields

Instances

Instances details
Storable RayTracingShaderGroupCreateInfoKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

sizeOf :: RayTracingShaderGroupCreateInfoKHR -> Int #

alignment :: RayTracingShaderGroupCreateInfoKHR -> Int #

peekElemOff :: Ptr RayTracingShaderGroupCreateInfoKHR -> Int -> IO RayTracingShaderGroupCreateInfoKHR #

pokeElemOff :: Ptr RayTracingShaderGroupCreateInfoKHR -> Int -> RayTracingShaderGroupCreateInfoKHR -> IO () #

peekByteOff :: Ptr b -> Int -> IO RayTracingShaderGroupCreateInfoKHR #

pokeByteOff :: Ptr b -> Int -> RayTracingShaderGroupCreateInfoKHR -> IO () #

peek :: Ptr RayTracingShaderGroupCreateInfoKHR -> IO RayTracingShaderGroupCreateInfoKHR #

poke :: Ptr RayTracingShaderGroupCreateInfoKHR -> RayTracingShaderGroupCreateInfoKHR -> IO () #

Show RayTracingShaderGroupCreateInfoKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

showsPrec :: Int -> RayTracingShaderGroupCreateInfoKHR -> ShowS #

show :: RayTracingShaderGroupCreateInfoKHR -> String #

showList :: [RayTracingShaderGroupCreateInfoKHR] -> ShowS #

FromCStruct RayTracingShaderGroupCreateInfoKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

peekCStruct :: Ptr RayTracingShaderGroupCreateInfoKHR -> IO RayTracingShaderGroupCreateInfoKHR Source #

ToCStruct RayTracingShaderGroupCreateInfoKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

withCStruct :: RayTracingShaderGroupCreateInfoKHR -> (Ptr RayTracingShaderGroupCreateInfoKHR -> IO b) -> IO b Source #

pokeCStruct :: Ptr RayTracingShaderGroupCreateInfoKHR -> RayTracingShaderGroupCreateInfoKHR -> IO b -> IO b Source #

withZeroCStruct :: (Ptr RayTracingShaderGroupCreateInfoKHR -> IO b) -> IO b Source #

pokeZeroCStruct :: Ptr RayTracingShaderGroupCreateInfoKHR -> IO b -> IO b Source #

cStructSize :: Int Source #

cStructAlignment :: Int Source #

Zero RayTracingShaderGroupCreateInfoKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

zero :: RayTracingShaderGroupCreateInfoKHR Source #

data RayTracingPipelineCreateInfoKHR (es :: [Type]) Source #

VkRayTracingPipelineCreateInfoKHR - Structure specifying parameters of a newly created ray tracing pipeline

Description

The parameters basePipelineHandle and basePipelineIndex are described in more detail in Pipeline Derivatives.

When PIPELINE_CREATE_LIBRARY_BIT_KHR is specified, this pipeline defines a pipeline library which cannot be bound as a ray tracing pipeline directly. Instead, pipeline libraries define common shaders and shader groups which can be included in future pipeline creation.

If pipeline libraries are included in pLibraryInfo, shaders defined in those libraries are treated as if they were defined as additional entries in pStages, appended in the order they appear in the pLibraries array and in the pStages array when those libraries were defined.

When referencing shader groups in order to obtain a shader group handle, groups defined in those libraries are treated as if they were defined as additional entries in pGroups, appended in the order they appear in the pLibraries array and in the pGroups array when those libraries were defined. The shaders these groups reference are set when the pipeline library is created, referencing those specified in the pipeline library, not in the pipeline that includes it.

The default stack size for a pipeline if DYNAMIC_STATE_RAY_TRACING_PIPELINE_STACK_SIZE_KHR is not provided is computed as described in Ray Tracing Pipeline Stack.

If the pNext chain includes a PipelineCreateFlags2CreateInfo structure, PipelineCreateFlags2CreateInfo::flags from that structure is used instead of flags from this structure.

If the pNext chain includes a VkRayTracingPipelineClusterAccelerationStructureCreateInfoNV structure, then that structure controls whether cluster acceleration structures are allowed in this ray tracing pipeline.

Valid Usage

Valid Usage (Implicit)

See Also

VK_KHR_ray_tracing_pipeline, Pipeline, PipelineCreateFlags, PipelineDynamicStateCreateInfo, PipelineLayout, PipelineLibraryCreateInfoKHR, PipelineShaderStageCreateInfo, RayTracingPipelineInterfaceCreateInfoKHR, RayTracingShaderGroupCreateInfoKHR, StructureType, createRayTracingPipelinesKHR

Constructors

RayTracingPipelineCreateInfoKHR 

Fields

Instances

Instances details
Extensible RayTracingPipelineCreateInfoKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

extensibleTypeName :: String Source #

getNext :: forall (es :: [Type]). RayTracingPipelineCreateInfoKHR es -> Chain es Source #

setNext :: forall (ds :: [Type]) (es :: [Type]). RayTracingPipelineCreateInfoKHR ds -> Chain es -> RayTracingPipelineCreateInfoKHR es Source #

extends :: forall e b proxy. Typeable e => proxy e -> (Extends RayTracingPipelineCreateInfoKHR e => b) -> Maybe b Source #

Show (Chain es) => Show (RayTracingPipelineCreateInfoKHR es) Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

showsPrec :: Int -> RayTracingPipelineCreateInfoKHR es -> ShowS #

show :: RayTracingPipelineCreateInfoKHR es -> String #

showList :: [RayTracingPipelineCreateInfoKHR es] -> ShowS #

(Extendss RayTracingPipelineCreateInfoKHR es, PeekChain es) => FromCStruct (RayTracingPipelineCreateInfoKHR es) Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

peekCStruct :: Ptr (RayTracingPipelineCreateInfoKHR es) -> IO (RayTracingPipelineCreateInfoKHR es) Source #

(Extendss RayTracingPipelineCreateInfoKHR es, PokeChain es) => ToCStruct (RayTracingPipelineCreateInfoKHR es) Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

withCStruct :: RayTracingPipelineCreateInfoKHR es -> (Ptr (RayTracingPipelineCreateInfoKHR es) -> IO b) -> IO b Source #

pokeCStruct :: Ptr (RayTracingPipelineCreateInfoKHR es) -> RayTracingPipelineCreateInfoKHR es -> IO b -> IO b Source #

withZeroCStruct :: (Ptr (RayTracingPipelineCreateInfoKHR es) -> IO b) -> IO b Source #

pokeZeroCStruct :: Ptr (RayTracingPipelineCreateInfoKHR es) -> IO b -> IO b Source #

cStructSize :: Int Source #

cStructAlignment :: Int Source #

es ~ ('[] :: [Type]) => Zero (RayTracingPipelineCreateInfoKHR es) Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

zero :: RayTracingPipelineCreateInfoKHR es Source #

data PhysicalDeviceRayTracingPipelineFeaturesKHR Source #

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

Members

This structure describes the following features:

Description

If the PhysicalDeviceRayTracingPipelineFeaturesKHR 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. If the application wishes to use a Device with any features described by PhysicalDeviceRayTracingPipelineFeaturesKHR, it must add an instance of the structure, with the desired feature members set to TRUE, to the pNext chain of DeviceCreateInfo when creating the Device.

Valid Usage

  • If rayTracingPipelineShaderGroupHandleCaptureReplayMixed is TRUE, rayTracingPipelineShaderGroupHandleCaptureReplay must also be TRUE

Valid Usage (Implicit)

See Also

VK_KHR_ray_tracing_pipeline, Bool32, StructureType

Constructors

PhysicalDeviceRayTracingPipelineFeaturesKHR 

Fields

Instances

Instances details
Eq PhysicalDeviceRayTracingPipelineFeaturesKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

(==) :: PhysicalDeviceRayTracingPipelineFeaturesKHR -> PhysicalDeviceRayTracingPipelineFeaturesKHR -> Bool #

(/=) :: PhysicalDeviceRayTracingPipelineFeaturesKHR -> PhysicalDeviceRayTracingPipelineFeaturesKHR -> Bool #

Storable PhysicalDeviceRayTracingPipelineFeaturesKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

sizeOf :: PhysicalDeviceRayTracingPipelineFeaturesKHR -> Int #

alignment :: PhysicalDeviceRayTracingPipelineFeaturesKHR -> Int #

peekElemOff :: Ptr PhysicalDeviceRayTracingPipelineFeaturesKHR -> Int -> IO PhysicalDeviceRayTracingPipelineFeaturesKHR #

pokeElemOff :: Ptr PhysicalDeviceRayTracingPipelineFeaturesKHR -> Int -> PhysicalDeviceRayTracingPipelineFeaturesKHR -> IO () #

peekByteOff :: Ptr b -> Int -> IO PhysicalDeviceRayTracingPipelineFeaturesKHR #

pokeByteOff :: Ptr b -> Int -> PhysicalDeviceRayTracingPipelineFeaturesKHR -> IO () #

peek :: Ptr PhysicalDeviceRayTracingPipelineFeaturesKHR -> IO PhysicalDeviceRayTracingPipelineFeaturesKHR #

poke :: Ptr PhysicalDeviceRayTracingPipelineFeaturesKHR -> PhysicalDeviceRayTracingPipelineFeaturesKHR -> IO () #

Show PhysicalDeviceRayTracingPipelineFeaturesKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

showsPrec :: Int -> PhysicalDeviceRayTracingPipelineFeaturesKHR -> ShowS #

show :: PhysicalDeviceRayTracingPipelineFeaturesKHR -> String #

showList :: [PhysicalDeviceRayTracingPipelineFeaturesKHR] -> ShowS #

FromCStruct PhysicalDeviceRayTracingPipelineFeaturesKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

peekCStruct :: Ptr PhysicalDeviceRayTracingPipelineFeaturesKHR -> IO PhysicalDeviceRayTracingPipelineFeaturesKHR Source #

ToCStruct PhysicalDeviceRayTracingPipelineFeaturesKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

withCStruct :: PhysicalDeviceRayTracingPipelineFeaturesKHR -> (Ptr PhysicalDeviceRayTracingPipelineFeaturesKHR -> IO b) -> IO b Source #

pokeCStruct :: Ptr PhysicalDeviceRayTracingPipelineFeaturesKHR -> PhysicalDeviceRayTracingPipelineFeaturesKHR -> IO b -> IO b Source #

withZeroCStruct :: (Ptr PhysicalDeviceRayTracingPipelineFeaturesKHR -> IO b) -> IO b Source #

pokeZeroCStruct :: Ptr PhysicalDeviceRayTracingPipelineFeaturesKHR -> IO b -> IO b Source #

cStructSize :: Int Source #

cStructAlignment :: Int Source #

Zero PhysicalDeviceRayTracingPipelineFeaturesKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

zero :: PhysicalDeviceRayTracingPipelineFeaturesKHR Source #

data PhysicalDeviceRayTracingPipelinePropertiesKHR Source #

VkPhysicalDeviceRayTracingPipelinePropertiesKHR - Properties of the physical device for ray tracing

Description

If the PhysicalDeviceRayTracingPipelinePropertiesKHR 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)

See Also

VK_KHR_ray_tracing_pipeline, StructureType

Constructors

PhysicalDeviceRayTracingPipelinePropertiesKHR 

Fields

Instances

Instances details
Eq PhysicalDeviceRayTracingPipelinePropertiesKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

(==) :: PhysicalDeviceRayTracingPipelinePropertiesKHR -> PhysicalDeviceRayTracingPipelinePropertiesKHR -> Bool #

(/=) :: PhysicalDeviceRayTracingPipelinePropertiesKHR -> PhysicalDeviceRayTracingPipelinePropertiesKHR -> Bool #

Storable PhysicalDeviceRayTracingPipelinePropertiesKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

sizeOf :: PhysicalDeviceRayTracingPipelinePropertiesKHR -> Int #

alignment :: PhysicalDeviceRayTracingPipelinePropertiesKHR -> Int #

peekElemOff :: Ptr PhysicalDeviceRayTracingPipelinePropertiesKHR -> Int -> IO PhysicalDeviceRayTracingPipelinePropertiesKHR #

pokeElemOff :: Ptr PhysicalDeviceRayTracingPipelinePropertiesKHR -> Int -> PhysicalDeviceRayTracingPipelinePropertiesKHR -> IO () #

peekByteOff :: Ptr b -> Int -> IO PhysicalDeviceRayTracingPipelinePropertiesKHR #

pokeByteOff :: Ptr b -> Int -> PhysicalDeviceRayTracingPipelinePropertiesKHR -> IO () #

peek :: Ptr PhysicalDeviceRayTracingPipelinePropertiesKHR -> IO PhysicalDeviceRayTracingPipelinePropertiesKHR #

poke :: Ptr PhysicalDeviceRayTracingPipelinePropertiesKHR -> PhysicalDeviceRayTracingPipelinePropertiesKHR -> IO () #

Show PhysicalDeviceRayTracingPipelinePropertiesKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

showsPrec :: Int -> PhysicalDeviceRayTracingPipelinePropertiesKHR -> ShowS #

show :: PhysicalDeviceRayTracingPipelinePropertiesKHR -> String #

showList :: [PhysicalDeviceRayTracingPipelinePropertiesKHR] -> ShowS #

FromCStruct PhysicalDeviceRayTracingPipelinePropertiesKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

peekCStruct :: Ptr PhysicalDeviceRayTracingPipelinePropertiesKHR -> IO PhysicalDeviceRayTracingPipelinePropertiesKHR Source #

ToCStruct PhysicalDeviceRayTracingPipelinePropertiesKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

withCStruct :: PhysicalDeviceRayTracingPipelinePropertiesKHR -> (Ptr PhysicalDeviceRayTracingPipelinePropertiesKHR -> IO b) -> IO b Source #

pokeCStruct :: Ptr PhysicalDeviceRayTracingPipelinePropertiesKHR -> PhysicalDeviceRayTracingPipelinePropertiesKHR -> IO b -> IO b Source #

withZeroCStruct :: (Ptr PhysicalDeviceRayTracingPipelinePropertiesKHR -> IO b) -> IO b Source #

pokeZeroCStruct :: Ptr PhysicalDeviceRayTracingPipelinePropertiesKHR -> IO b -> IO b Source #

cStructSize :: Int Source #

cStructAlignment :: Int Source #

Zero PhysicalDeviceRayTracingPipelinePropertiesKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

zero :: PhysicalDeviceRayTracingPipelinePropertiesKHR Source #

data StridedDeviceAddressRegionKHR Source #

VkStridedDeviceAddressRegionKHR - Structure specifying a region of device addresses with a stride

Valid Usage

  • If size is not zero, all addresses between deviceAddress and deviceAddress + size - 1 must be in the buffer device address range of the same buffer
  • If size is not zero, stride must be less than or equal to the size of the buffer from which deviceAddress was queried

Valid Usage (Implicit)

  • If deviceAddress is not 0, deviceAddress must be a valid DeviceAddress value

See Also

VK_KHR_ray_tracing_pipeline, VkClusterAccelerationStructureCommandsInfoNV, DeviceAddress, DeviceSize, cmdTraceRaysIndirectKHR, cmdTraceRaysKHR

Constructors

StridedDeviceAddressRegionKHR 

Fields

Instances

Instances details
Eq StridedDeviceAddressRegionKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

(==) :: StridedDeviceAddressRegionKHR -> StridedDeviceAddressRegionKHR -> Bool #

(/=) :: StridedDeviceAddressRegionKHR -> StridedDeviceAddressRegionKHR -> Bool #

Storable StridedDeviceAddressRegionKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

sizeOf :: StridedDeviceAddressRegionKHR -> Int #

alignment :: StridedDeviceAddressRegionKHR -> Int #

peekElemOff :: Ptr StridedDeviceAddressRegionKHR -> Int -> IO StridedDeviceAddressRegionKHR #

pokeElemOff :: Ptr StridedDeviceAddressRegionKHR -> Int -> StridedDeviceAddressRegionKHR -> IO () #

peekByteOff :: Ptr b -> Int -> IO StridedDeviceAddressRegionKHR #

pokeByteOff :: Ptr b -> Int -> StridedDeviceAddressRegionKHR -> IO () #

peek :: Ptr StridedDeviceAddressRegionKHR -> IO StridedDeviceAddressRegionKHR #

poke :: Ptr StridedDeviceAddressRegionKHR -> StridedDeviceAddressRegionKHR -> IO () #

Show StridedDeviceAddressRegionKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

showsPrec :: Int -> StridedDeviceAddressRegionKHR -> ShowS #

show :: StridedDeviceAddressRegionKHR -> String #

showList :: [StridedDeviceAddressRegionKHR] -> ShowS #

FromCStruct StridedDeviceAddressRegionKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

peekCStruct :: Ptr StridedDeviceAddressRegionKHR -> IO StridedDeviceAddressRegionKHR Source #

ToCStruct StridedDeviceAddressRegionKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

withCStruct :: StridedDeviceAddressRegionKHR -> (Ptr StridedDeviceAddressRegionKHR -> IO b) -> IO b Source #

pokeCStruct :: Ptr StridedDeviceAddressRegionKHR -> StridedDeviceAddressRegionKHR -> IO b -> IO b Source #

withZeroCStruct :: (Ptr StridedDeviceAddressRegionKHR -> IO b) -> IO b Source #

pokeZeroCStruct :: Ptr StridedDeviceAddressRegionKHR -> IO b -> IO b Source #

cStructSize :: Int Source #

cStructAlignment :: Int Source #

Zero StridedDeviceAddressRegionKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

zero :: StridedDeviceAddressRegionKHR Source #

data TraceRaysIndirectCommandKHR Source #

VkTraceRaysIndirectCommandKHR - Structure specifying the parameters of an indirect ray tracing command

Description

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

Valid Usage

See Also

VK_KHR_ray_tracing_pipeline

Constructors

TraceRaysIndirectCommandKHR 

Fields

  • width :: Word32

    width is the width of the ray trace query dimensions.

  • height :: Word32

    height is height of the ray trace query dimensions.

  • depth :: Word32

    depth is depth of the ray trace query dimensions.

Instances

Instances details
Eq TraceRaysIndirectCommandKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

(==) :: TraceRaysIndirectCommandKHR -> TraceRaysIndirectCommandKHR -> Bool #

(/=) :: TraceRaysIndirectCommandKHR -> TraceRaysIndirectCommandKHR -> Bool #

Storable TraceRaysIndirectCommandKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

sizeOf :: TraceRaysIndirectCommandKHR -> Int #

alignment :: TraceRaysIndirectCommandKHR -> Int #

peekElemOff :: Ptr TraceRaysIndirectCommandKHR -> Int -> IO TraceRaysIndirectCommandKHR #

pokeElemOff :: Ptr TraceRaysIndirectCommandKHR -> Int -> TraceRaysIndirectCommandKHR -> IO () #

peekByteOff :: Ptr b -> Int -> IO TraceRaysIndirectCommandKHR #

pokeByteOff :: Ptr b -> Int -> TraceRaysIndirectCommandKHR -> IO () #

peek :: Ptr TraceRaysIndirectCommandKHR -> IO TraceRaysIndirectCommandKHR #

poke :: Ptr TraceRaysIndirectCommandKHR -> TraceRaysIndirectCommandKHR -> IO () #

Show TraceRaysIndirectCommandKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

showsPrec :: Int -> TraceRaysIndirectCommandKHR -> ShowS #

show :: TraceRaysIndirectCommandKHR -> String #

showList :: [TraceRaysIndirectCommandKHR] -> ShowS #

FromCStruct TraceRaysIndirectCommandKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

peekCStruct :: Ptr TraceRaysIndirectCommandKHR -> IO TraceRaysIndirectCommandKHR Source #

ToCStruct TraceRaysIndirectCommandKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

withCStruct :: TraceRaysIndirectCommandKHR -> (Ptr TraceRaysIndirectCommandKHR -> IO b) -> IO b Source #

pokeCStruct :: Ptr TraceRaysIndirectCommandKHR -> TraceRaysIndirectCommandKHR -> IO b -> IO b Source #

withZeroCStruct :: (Ptr TraceRaysIndirectCommandKHR -> IO b) -> IO b Source #

pokeZeroCStruct :: Ptr TraceRaysIndirectCommandKHR -> IO b -> IO b Source #

cStructSize :: Int Source #

cStructAlignment :: Int Source #

Zero TraceRaysIndirectCommandKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

zero :: TraceRaysIndirectCommandKHR Source #

data RayTracingPipelineInterfaceCreateInfoKHR Source #

VkRayTracingPipelineInterfaceCreateInfoKHR - Structure specifying additional interface information when using libraries

Description

maxPipelineRayPayloadSize is calculated as the maximum size of the block (in bytes) declared in the RayPayloadKHR or IncomingRayPayloadKHR storage classes. maxPipelineRayHitAttributeSize is calculated as the maximum size of any block (in bytes) declared in the HitAttributeKHR or HitObjectAttributeEXT storage class. As variables in these storage classes do not have explicit offsets, the size should be calculated as if each variable has a scalar alignment equal to the largest scalar alignment of any of the block’s members.

There is no explicit upper limit for maxPipelineRayPayloadSize, but in practice it should be kept as small as possible. Similar to invocation local memory, it must be allocated for each shader invocation and for devices which support many simultaneous invocations, this storage can rapidly be exhausted, resulting in failure.

Valid Usage (Implicit)

See Also

VK_KHR_ray_tracing_pipeline, RayTracingPipelineCreateInfoKHR, StructureType

Constructors

RayTracingPipelineInterfaceCreateInfoKHR 

Fields

Instances

Instances details
Eq RayTracingPipelineInterfaceCreateInfoKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

(==) :: RayTracingPipelineInterfaceCreateInfoKHR -> RayTracingPipelineInterfaceCreateInfoKHR -> Bool #

(/=) :: RayTracingPipelineInterfaceCreateInfoKHR -> RayTracingPipelineInterfaceCreateInfoKHR -> Bool #

Storable RayTracingPipelineInterfaceCreateInfoKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

sizeOf :: RayTracingPipelineInterfaceCreateInfoKHR -> Int #

alignment :: RayTracingPipelineInterfaceCreateInfoKHR -> Int #

peekElemOff :: Ptr RayTracingPipelineInterfaceCreateInfoKHR -> Int -> IO RayTracingPipelineInterfaceCreateInfoKHR #

pokeElemOff :: Ptr RayTracingPipelineInterfaceCreateInfoKHR -> Int -> RayTracingPipelineInterfaceCreateInfoKHR -> IO () #

peekByteOff :: Ptr b -> Int -> IO RayTracingPipelineInterfaceCreateInfoKHR #

pokeByteOff :: Ptr b -> Int -> RayTracingPipelineInterfaceCreateInfoKHR -> IO () #

peek :: Ptr RayTracingPipelineInterfaceCreateInfoKHR -> IO RayTracingPipelineInterfaceCreateInfoKHR #

poke :: Ptr RayTracingPipelineInterfaceCreateInfoKHR -> RayTracingPipelineInterfaceCreateInfoKHR -> IO () #

Show RayTracingPipelineInterfaceCreateInfoKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

showsPrec :: Int -> RayTracingPipelineInterfaceCreateInfoKHR -> ShowS #

show :: RayTracingPipelineInterfaceCreateInfoKHR -> String #

showList :: [RayTracingPipelineInterfaceCreateInfoKHR] -> ShowS #

FromCStruct RayTracingPipelineInterfaceCreateInfoKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

peekCStruct :: Ptr RayTracingPipelineInterfaceCreateInfoKHR -> IO RayTracingPipelineInterfaceCreateInfoKHR Source #

ToCStruct RayTracingPipelineInterfaceCreateInfoKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

withCStruct :: RayTracingPipelineInterfaceCreateInfoKHR -> (Ptr RayTracingPipelineInterfaceCreateInfoKHR -> IO b) -> IO b Source #

pokeCStruct :: Ptr RayTracingPipelineInterfaceCreateInfoKHR -> RayTracingPipelineInterfaceCreateInfoKHR -> IO b -> IO b Source #

withZeroCStruct :: (Ptr RayTracingPipelineInterfaceCreateInfoKHR -> IO b) -> IO b Source #

pokeZeroCStruct :: Ptr RayTracingPipelineInterfaceCreateInfoKHR -> IO b -> IO b Source #

cStructSize :: Int Source #

cStructAlignment :: Int Source #

Zero RayTracingPipelineInterfaceCreateInfoKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

zero :: RayTracingPipelineInterfaceCreateInfoKHR Source #

newtype RayTracingShaderGroupTypeKHR Source #

VkRayTracingShaderGroupTypeKHR - Shader group types

Description

For current group types, the hit group type could be inferred from the presence or absence of the intersection shader, but we provide the type explicitly for future hit groups that do not have that property.

See Also

VK_KHR_ray_tracing_pipeline, VK_NV_ray_tracing, RayTracingShaderGroupCreateInfoKHR, RayTracingShaderGroupCreateInfoNV

Constructors

RayTracingShaderGroupTypeKHR Int32 

Bundled Patterns

pattern RAY_TRACING_SHADER_GROUP_TYPE_GENERAL_KHR :: RayTracingShaderGroupTypeKHR 
pattern RAY_TRACING_SHADER_GROUP_TYPE_TRIANGLES_HIT_GROUP_KHR :: RayTracingShaderGroupTypeKHR 
pattern RAY_TRACING_SHADER_GROUP_TYPE_PROCEDURAL_HIT_GROUP_KHR :: RayTracingShaderGroupTypeKHR 

Instances

Instances details
Eq RayTracingShaderGroupTypeKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

(==) :: RayTracingShaderGroupTypeKHR -> RayTracingShaderGroupTypeKHR -> Bool #

(/=) :: RayTracingShaderGroupTypeKHR -> RayTracingShaderGroupTypeKHR -> Bool #

Ord RayTracingShaderGroupTypeKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

compare :: RayTracingShaderGroupTypeKHR -> RayTracingShaderGroupTypeKHR -> Ordering #

(<) :: RayTracingShaderGroupTypeKHR -> RayTracingShaderGroupTypeKHR -> Bool #

(<=) :: RayTracingShaderGroupTypeKHR -> RayTracingShaderGroupTypeKHR -> Bool #

(>) :: RayTracingShaderGroupTypeKHR -> RayTracingShaderGroupTypeKHR -> Bool #

(>=) :: RayTracingShaderGroupTypeKHR -> RayTracingShaderGroupTypeKHR -> Bool #

max :: RayTracingShaderGroupTypeKHR -> RayTracingShaderGroupTypeKHR -> RayTracingShaderGroupTypeKHR #

min :: RayTracingShaderGroupTypeKHR -> RayTracingShaderGroupTypeKHR -> RayTracingShaderGroupTypeKHR #

Storable RayTracingShaderGroupTypeKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

sizeOf :: RayTracingShaderGroupTypeKHR -> Int #

alignment :: RayTracingShaderGroupTypeKHR -> Int #

peekElemOff :: Ptr RayTracingShaderGroupTypeKHR -> Int -> IO RayTracingShaderGroupTypeKHR #

pokeElemOff :: Ptr RayTracingShaderGroupTypeKHR -> Int -> RayTracingShaderGroupTypeKHR -> IO () #

peekByteOff :: Ptr b -> Int -> IO RayTracingShaderGroupTypeKHR #

pokeByteOff :: Ptr b -> Int -> RayTracingShaderGroupTypeKHR -> IO () #

peek :: Ptr RayTracingShaderGroupTypeKHR -> IO RayTracingShaderGroupTypeKHR #

poke :: Ptr RayTracingShaderGroupTypeKHR -> RayTracingShaderGroupTypeKHR -> IO () #

Read RayTracingShaderGroupTypeKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

readsPrec :: Int -> ReadS RayTracingShaderGroupTypeKHR #

readList :: ReadS [RayTracingShaderGroupTypeKHR] #

readPrec :: ReadPrec RayTracingShaderGroupTypeKHR #

readListPrec :: ReadPrec [RayTracingShaderGroupTypeKHR] #

Show RayTracingShaderGroupTypeKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

showsPrec :: Int -> RayTracingShaderGroupTypeKHR -> ShowS #

show :: RayTracingShaderGroupTypeKHR -> String #

showList :: [RayTracingShaderGroupTypeKHR] -> ShowS #

Zero RayTracingShaderGroupTypeKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

zero :: RayTracingShaderGroupTypeKHR Source #

newtype ShaderGroupShaderKHR Source #

VkShaderGroupShaderKHR - Shader group shaders

Description

See Also

VK_KHR_ray_tracing_pipeline, getRayTracingShaderGroupStackSizeKHR

Constructors

ShaderGroupShaderKHR Int32 

Bundled Patterns

pattern SHADER_GROUP_SHADER_GENERAL_KHR :: ShaderGroupShaderKHR 
pattern SHADER_GROUP_SHADER_CLOSEST_HIT_KHR :: ShaderGroupShaderKHR 
pattern SHADER_GROUP_SHADER_ANY_HIT_KHR :: ShaderGroupShaderKHR 
pattern SHADER_GROUP_SHADER_INTERSECTION_KHR :: ShaderGroupShaderKHR 

Instances

Instances details
Eq ShaderGroupShaderKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

(==) :: ShaderGroupShaderKHR -> ShaderGroupShaderKHR -> Bool #

(/=) :: ShaderGroupShaderKHR -> ShaderGroupShaderKHR -> Bool #

Ord ShaderGroupShaderKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

compare :: ShaderGroupShaderKHR -> ShaderGroupShaderKHR -> Ordering #

(<) :: ShaderGroupShaderKHR -> ShaderGroupShaderKHR -> Bool #

(<=) :: ShaderGroupShaderKHR -> ShaderGroupShaderKHR -> Bool #

(>) :: ShaderGroupShaderKHR -> ShaderGroupShaderKHR -> Bool #

(>=) :: ShaderGroupShaderKHR -> ShaderGroupShaderKHR -> Bool #

max :: ShaderGroupShaderKHR -> ShaderGroupShaderKHR -> ShaderGroupShaderKHR #

min :: ShaderGroupShaderKHR -> ShaderGroupShaderKHR -> ShaderGroupShaderKHR #

Storable ShaderGroupShaderKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

sizeOf :: ShaderGroupShaderKHR -> Int #

alignment :: ShaderGroupShaderKHR -> Int #

peekElemOff :: Ptr ShaderGroupShaderKHR -> Int -> IO ShaderGroupShaderKHR #

pokeElemOff :: Ptr ShaderGroupShaderKHR -> Int -> ShaderGroupShaderKHR -> IO () #

peekByteOff :: Ptr b -> Int -> IO ShaderGroupShaderKHR #

pokeByteOff :: Ptr b -> Int -> ShaderGroupShaderKHR -> IO () #

peek :: Ptr ShaderGroupShaderKHR -> IO ShaderGroupShaderKHR #

poke :: Ptr ShaderGroupShaderKHR -> ShaderGroupShaderKHR -> IO () #

Read ShaderGroupShaderKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

readsPrec :: Int -> ReadS ShaderGroupShaderKHR #

readList :: ReadS [ShaderGroupShaderKHR] #

readPrec :: ReadPrec ShaderGroupShaderKHR #

readListPrec :: ReadPrec [ShaderGroupShaderKHR] #

Show ShaderGroupShaderKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

showsPrec :: Int -> ShaderGroupShaderKHR -> ShowS #

show :: ShaderGroupShaderKHR -> String #

showList :: [ShaderGroupShaderKHR] -> ShowS #

Zero ShaderGroupShaderKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_ray_tracing_pipeline

Methods

zero :: ShaderGroupShaderKHR Source #

type KHR_RAY_TRACING_PIPELINE_SPEC_VERSION = 1 Source #

pattern KHR_RAY_TRACING_PIPELINE_SPEC_VERSION :: Integral a => a Source #

type KHR_RAY_TRACING_PIPELINE_EXTENSION_NAME = "VK_KHR_ray_tracing_pipeline" Source #

pattern KHR_RAY_TRACING_PIPELINE_EXTENSION_NAME :: (Eq a, IsString a) => a Source #

newtype DeferredOperationKHR Source #

VkDeferredOperationKHR - A deferred operation

Description

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

See Also

VK_DEFINE_NON_DISPATCHABLE_HANDLE, VK_KHR_deferred_host_operations, buildAccelerationStructuresKHR, buildMicromapsEXT, copyAccelerationStructureKHR, copyAccelerationStructureToMemoryKHR, copyMemoryToAccelerationStructureKHR, copyMemoryToMicromapEXT, copyMicromapEXT, copyMicromapToMemoryEXT, createDataGraphPipelinesARM, createDeferredOperationKHR, createRayTracingPipelinesKHR, deferredOperationJoinKHR, destroyDeferredOperationKHR, getDeferredOperationMaxConcurrencyKHR, getDeferredOperationResultKHR

Constructors

DeferredOperationKHR Word64 

Instances

Instances details
Eq DeferredOperationKHR Source # 
Instance details

Defined in Vulkan.Extensions.Handles

Methods

(==) :: DeferredOperationKHR -> DeferredOperationKHR -> Bool #

(/=) :: DeferredOperationKHR -> DeferredOperationKHR -> Bool #

Ord DeferredOperationKHR Source # 
Instance details

Defined in Vulkan.Extensions.Handles

Methods

compare :: DeferredOperationKHR -> DeferredOperationKHR -> Ordering #

(<) :: DeferredOperationKHR -> DeferredOperationKHR -> Bool #

(<=) :: DeferredOperationKHR -> DeferredOperationKHR -> Bool #

(>) :: DeferredOperationKHR -> DeferredOperationKHR -> Bool #

(>=) :: DeferredOperationKHR -> DeferredOperationKHR -> Bool #

max :: DeferredOperationKHR -> DeferredOperationKHR -> DeferredOperationKHR #

min :: DeferredOperationKHR -> DeferredOperationKHR -> DeferredOperationKHR #

Storable DeferredOperationKHR Source # 
Instance details

Defined in Vulkan.Extensions.Handles

Methods

sizeOf :: DeferredOperationKHR -> Int #

alignment :: DeferredOperationKHR -> Int #

peekElemOff :: Ptr DeferredOperationKHR -> Int -> IO DeferredOperationKHR #

pokeElemOff :: Ptr DeferredOperationKHR -> Int -> DeferredOperationKHR -> IO () #

peekByteOff :: Ptr b -> Int -> IO DeferredOperationKHR #

pokeByteOff :: Ptr b -> Int -> DeferredOperationKHR -> IO () #

peek :: Ptr DeferredOperationKHR -> IO DeferredOperationKHR #

poke :: Ptr DeferredOperationKHR -> DeferredOperationKHR -> IO () #

Show DeferredOperationKHR Source # 
Instance details

Defined in Vulkan.Extensions.Handles

Methods

showsPrec :: Int -> DeferredOperationKHR -> ShowS #

show :: DeferredOperationKHR -> String #

showList :: [DeferredOperationKHR] -> ShowS #

HasObjectType DeferredOperationKHR Source # 
Instance details

Defined in Vulkan.Extensions.Handles

Methods

objectTypeAndHandle :: DeferredOperationKHR -> (ObjectType, Word64) Source #

IsHandle DeferredOperationKHR Source # 
Instance details

Defined in Vulkan.Extensions.Handles

Zero DeferredOperationKHR Source # 
Instance details

Defined in Vulkan.Extensions.Handles

Methods

zero :: DeferredOperationKHR Source #

data PipelineLibraryCreateInfoKHR Source #

VkPipelineLibraryCreateInfoKHR - Structure specifying pipeline libraries to use when creating a pipeline

Valid Usage

Valid Usage (Implicit)

  • If libraryCount is not 0, pLibraries must be a valid pointer to an array of libraryCount valid Pipeline handles

See Also

VK_KHR_pipeline_library, ExecutionGraphPipelineCreateInfoAMDX, Pipeline, RayTracingPipelineCreateInfoKHR, StructureType

Constructors

PipelineLibraryCreateInfoKHR 

Fields

Instances

Instances details
Show PipelineLibraryCreateInfoKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_pipeline_library

Methods

showsPrec :: Int -> PipelineLibraryCreateInfoKHR -> ShowS #

show :: PipelineLibraryCreateInfoKHR -> String #

showList :: [PipelineLibraryCreateInfoKHR] -> ShowS #

FromCStruct PipelineLibraryCreateInfoKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_pipeline_library

Methods

peekCStruct :: Ptr PipelineLibraryCreateInfoKHR -> IO PipelineLibraryCreateInfoKHR Source #

ToCStruct PipelineLibraryCreateInfoKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_pipeline_library

Methods

withCStruct :: PipelineLibraryCreateInfoKHR -> (Ptr PipelineLibraryCreateInfoKHR -> IO b) -> IO b Source #

pokeCStruct :: Ptr PipelineLibraryCreateInfoKHR -> PipelineLibraryCreateInfoKHR -> IO b -> IO b Source #

withZeroCStruct :: (Ptr PipelineLibraryCreateInfoKHR -> IO b) -> IO b Source #

pokeZeroCStruct :: Ptr PipelineLibraryCreateInfoKHR -> IO b -> IO b Source #

cStructSize :: Int Source #

cStructAlignment :: Int Source #

Zero PipelineLibraryCreateInfoKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_pipeline_library

Methods

zero :: PipelineLibraryCreateInfoKHR Source #

type SHADER_UNUSED_KHR = 4294967295 Source #

pattern SHADER_UNUSED_KHR :: Word32 Source #

VK_SHADER_UNUSED_KHR - Sentinel for an unused shader index

See Also

VK_KHR_ray_tracing_pipeline, VK_NV_ray_tracing