vulkan-3.13.3: Bindings to the Vulkan graphics API.
Safe HaskellNone
LanguageHaskell2010

Vulkan.Extensions.VK_KHR_shader_terminate_invocation

Description

Name

VK_KHR_shader_terminate_invocation - device extension

VK_KHR_shader_terminate_invocation

Name String
VK_KHR_shader_terminate_invocation
Extension Type
Device extension
Registered Extension Number
216
Revision
1
Extension and Version Dependencies
  • Requires Vulkan 1.0
  • Requires VK_KHR_get_physical_device_properties2
Contact

Other Extension Metadata

Last Modified Date
2020-08-11
IP Status
No known IP claims.
Interactions and External Dependencies
Contributors
  • Alan Baker, Google
  • Jeff Bolz, NVIDIA
  • Jesse Hall, Google
  • Ralph Potter, Samsung
  • Tom Olson, Arm

Description

This extension adds Vulkan support for the SPV_KHR_terminate_invocation SPIR-V extension. That SPIR-V extension provides a new instruction, OpTerminateInvocation, which causes a shader invocation to immediately terminate and sets the coverage of shaded samples to 0; only previously executed instructions will have observable effects. The OpTerminateInvocation instruction, along with the OpDemoteToHelperInvocation instruction from the VK_EXT_shader_demote_to_helper_invocation extension, together replace the OpKill instruction, which could behave like either of these instructions. OpTerminateInvocation provides the behavior required by the GLSL discard statement, and should be used when available by GLSL compilers and applications that need the GLSL discard behavior.

New Structures

New Enum Constants

Version History

  • Revision 1, 2020-08-11 (Jesse Hall)

See Also

PhysicalDeviceShaderTerminateInvocationFeaturesKHR

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

data PhysicalDeviceShaderTerminateInvocationFeaturesKHR Source #

VkPhysicalDeviceShaderTerminateInvocationFeaturesKHR - Structure describing support for the SPIR-V SPV_KHR_terminate_invocation extension

Members

This structure describes the following feature:

Description

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

Valid Usage (Implicit)

See Also

VK_KHR_shader_terminate_invocation, Bool32, StructureType

Constructors

PhysicalDeviceShaderTerminateInvocationFeaturesKHR 

Fields

  • shaderTerminateInvocation :: Bool

    shaderTerminateInvocation specifies whether the implementation supports SPIR-V modules that use the SPV_KHR_terminate_invocation extension.

Instances

Instances details
Eq PhysicalDeviceShaderTerminateInvocationFeaturesKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_shader_terminate_invocation

Show PhysicalDeviceShaderTerminateInvocationFeaturesKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_shader_terminate_invocation

Storable PhysicalDeviceShaderTerminateInvocationFeaturesKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_shader_terminate_invocation

FromCStruct PhysicalDeviceShaderTerminateInvocationFeaturesKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_shader_terminate_invocation

ToCStruct PhysicalDeviceShaderTerminateInvocationFeaturesKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_shader_terminate_invocation

Zero PhysicalDeviceShaderTerminateInvocationFeaturesKHR Source # 
Instance details

Defined in Vulkan.Extensions.VK_KHR_shader_terminate_invocation

type KHR_SHADER_TERMINATE_INVOCATION_EXTENSION_NAME = "VK_KHR_shader_terminate_invocation" Source #