Vulkan.Extensions.VK_KHR_fragment_shader_barycentric

Name

VK_KHR_fragment_shader_barycentric - device extension

VK_KHR_fragment_shader_barycentric

Name String

VK_KHR_fragment_shader_barycentric

Extension Type

Device extension

Registered Extension Number

323

Revision

1

Extension and Version Dependencies

• Requires support for Vulkan 1.0
• Requires VK_KHR_get_physical_device_properties2 to be enabled for any device-level functionality

Contact

• Stu Smith

Extension Proposal

VK_KHR_fragment_shader_barycentric

Other Extension Metadata

Last Modified Date

2022-03-10

IP Status

No known IP claims.

Interactions and External Dependencies

• This extension requires SPV_KHR_fragment_shader_barycentric
• This extension provides API support for GL_EXT_fragment_shader_barycentric

Contributors

• Stu Smith, AMD
• Tobias Hector, AMD
• Graeme Leese, Broadcom
• Jan-Harald Fredriksen, Arm
• Slawek Grajewski, Intel
• Pat Brown, NVIDIA
• Hans-Kristian Arntzen, Valve
• Contributors to the VK_NV_fragment_shader_barycentric specification

Description

This extension is based on the VK_NV_fragment_shader_barycentric extension, and adds support for the following SPIR-V extension in Vulkan:

• SPV_KHR_fragment_shader_barycentric

The extension provides access to three additional fragment shader variable decorations in SPIR-V:

• PerVertexKHR, which indicates that a fragment shader input will not have interpolated values, but instead must be accessed with an extra array index that identifies one of the vertices of the primitive producing the fragment
• BaryCoordKHR, which indicates that the variable is a three-component floating-point vector holding barycentric weights for the fragment produced using perspective interpolation
• BaryCoordNoPerspKHR, which indicates that the variable is a three-component floating-point vector holding barycentric weights for the fragment produced using linear interpolation

When using GLSL source-based shader languages, the following variables from GL_EXT_fragment_shader_barycentric map to these SPIR-V built-in decorations:

• in vec3 gl_BaryCoordEXT; → BaryCoordKHR
• in vec3 gl_BaryCoordNoPerspEXT; → BaryCoordNoPerspKHR

GLSL variables declared using the pervertexEXT GLSL qualifier are expected to be decorated with PerVertexKHR in SPIR-V.

New Structures

• Extending PhysicalDeviceFeatures2, DeviceCreateInfo:

  • PhysicalDeviceFragmentShaderBarycentricFeaturesKHR

• Extending PhysicalDeviceProperties2:

  • PhysicalDeviceFragmentShaderBarycentricPropertiesKHR

New Enum Constants

• KHR_FRAGMENT_SHADER_BARYCENTRIC_EXTENSION_NAME

• KHR_FRAGMENT_SHADER_BARYCENTRIC_SPEC_VERSION

• Extending StructureType:

  • STRUCTURE_TYPE_PHYSICAL_DEVICE_FRAGMENT_SHADER_BARYCENTRIC_FEATURES_KHR
  • STRUCTURE_TYPE_PHYSICAL_DEVICE_FRAGMENT_SHADER_BARYCENTRIC_PROPERTIES_KHR

New Built-In Variables

• BaryCoordKHR

• BaryCoordNoPerspKHR

New SPIR-V Decorations

• PerVertexKHR

New SPIR-V Capabilities

• FragmentBarycentricKHR

Issues

1) What are the interactions with MSAA and how are BaryCoordKHR and BaryCoordNoPerspKHR interpolated?

RESOLVED: The inputs decorated with BaryCoordKHR or BaryCoordNoPerspKHR may also be decorated with the Centroid or Sample qualifiers to specify interpolation, like any other fragment shader input. If shaderSampleRateInterpolationFunctions is enabled, the extended instructions InterpolateAtCentroid, InterpolateAtOffset, and InterpolateAtSample from the GLSL.std.450 may also be used with inputs decorated with BaryCoordKHR or BaryCoordNoPerspKHR.

Version History

• Revision 1, 2022-03-10 (Stu Smith)

  • Initial revision

See Also

PhysicalDeviceFragmentShaderBarycentricFeaturesKHR, PhysicalDeviceFragmentShaderBarycentricPropertiesKHR

Document Notes

For more information, see the Vulkan Specification

This page is a generated document. Fixes and changes should be made to the generator scripts, not directly.

Documentation

data PhysicalDeviceFragmentShaderBarycentricFeaturesKHR

VkPhysicalDeviceFragmentShaderBarycentricFeaturesKHR - Structure describing barycentric support in fragment shaders that can be supported by an implementation

Members

This structure describes the following feature:

Description

See Barycentric Interpolation for more information.

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

Valid Usage (Implicit)

See Also

VK_KHR_fragment_shader_barycentric, Bool32, StructureType

Constructors

PhysicalDeviceFragmentShaderBarycentricFeaturesKHR

Fields

• fragmentShaderBarycentric :: Bool

  fragmentShaderBarycentric indicates that the implementation supports the BaryCoordKHR and BaryCoordNoPerspKHR SPIR-V fragment shader built-ins and supports the PerVertexKHR SPIR-V decoration on fragment shader input variables.

Instances

Storable PhysicalDeviceFragmentShaderBarycentricFeaturesKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shader_barycentric

Methods

sizeOf :: PhysicalDeviceFragmentShaderBarycentricFeaturesKHR -> Int

alignment :: PhysicalDeviceFragmentShaderBarycentricFeaturesKHR -> Int

peekElemOff :: Ptr PhysicalDeviceFragmentShaderBarycentricFeaturesKHR -> Int -> IO PhysicalDeviceFragmentShaderBarycentricFeaturesKHR

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

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

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

peek :: Ptr PhysicalDeviceFragmentShaderBarycentricFeaturesKHR -> IO PhysicalDeviceFragmentShaderBarycentricFeaturesKHR

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

Show PhysicalDeviceFragmentShaderBarycentricFeaturesKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shader_barycentric

Methods

showsPrec :: Int -> PhysicalDeviceFragmentShaderBarycentricFeaturesKHR -> ShowS

show :: PhysicalDeviceFragmentShaderBarycentricFeaturesKHR -> String

showList :: [PhysicalDeviceFragmentShaderBarycentricFeaturesKHR] -> ShowS

Eq PhysicalDeviceFragmentShaderBarycentricFeaturesKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shader_barycentric

Methods

(==) :: PhysicalDeviceFragmentShaderBarycentricFeaturesKHR -> PhysicalDeviceFragmentShaderBarycentricFeaturesKHR -> Bool

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

FromCStruct PhysicalDeviceFragmentShaderBarycentricFeaturesKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shader_barycentric

Methods

peekCStruct :: Ptr PhysicalDeviceFragmentShaderBarycentricFeaturesKHR -> IO PhysicalDeviceFragmentShaderBarycentricFeaturesKHR

ToCStruct PhysicalDeviceFragmentShaderBarycentricFeaturesKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shader_barycentric

Methods

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

pokeCStruct :: Ptr PhysicalDeviceFragmentShaderBarycentricFeaturesKHR -> PhysicalDeviceFragmentShaderBarycentricFeaturesKHR -> IO b -> IO b

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

pokeZeroCStruct :: Ptr PhysicalDeviceFragmentShaderBarycentricFeaturesKHR -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero PhysicalDeviceFragmentShaderBarycentricFeaturesKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shader_barycentric

Methods

zero :: PhysicalDeviceFragmentShaderBarycentricFeaturesKHR

data PhysicalDeviceFragmentShaderBarycentricPropertiesKHR

VkPhysicalDeviceFragmentShaderBarycentricPropertiesKHR - Structure describing fragment shader barycentric limits of an implementation

Description

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

Valid Usage (Implicit)

See Also

VK_KHR_fragment_shader_barycentric, Bool32, StructureType

Constructors

PhysicalDeviceFragmentShaderBarycentricPropertiesKHR

Fields

• triStripVertexOrderIndependentOfProvokingVertex :: Bool

  triStripVertexOrderIndependentOfProvokingVertex indicates that the implementation does not change its vertex numbering for triangle strip primitives when the provoking vertex mode is PROVOKING_VERTEX_MODE_LAST_VERTEX_EXT, as shown in the last vertex table.

Instances

Storable PhysicalDeviceFragmentShaderBarycentricPropertiesKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shader_barycentric

Methods

sizeOf :: PhysicalDeviceFragmentShaderBarycentricPropertiesKHR -> Int

alignment :: PhysicalDeviceFragmentShaderBarycentricPropertiesKHR -> Int

peekElemOff :: Ptr PhysicalDeviceFragmentShaderBarycentricPropertiesKHR -> Int -> IO PhysicalDeviceFragmentShaderBarycentricPropertiesKHR

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

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

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

peek :: Ptr PhysicalDeviceFragmentShaderBarycentricPropertiesKHR -> IO PhysicalDeviceFragmentShaderBarycentricPropertiesKHR

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

Show PhysicalDeviceFragmentShaderBarycentricPropertiesKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shader_barycentric

Methods

showsPrec :: Int -> PhysicalDeviceFragmentShaderBarycentricPropertiesKHR -> ShowS

show :: PhysicalDeviceFragmentShaderBarycentricPropertiesKHR -> String

showList :: [PhysicalDeviceFragmentShaderBarycentricPropertiesKHR] -> ShowS

Eq PhysicalDeviceFragmentShaderBarycentricPropertiesKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shader_barycentric

Methods

(==) :: PhysicalDeviceFragmentShaderBarycentricPropertiesKHR -> PhysicalDeviceFragmentShaderBarycentricPropertiesKHR -> Bool

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

FromCStruct PhysicalDeviceFragmentShaderBarycentricPropertiesKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shader_barycentric

Methods

peekCStruct :: Ptr PhysicalDeviceFragmentShaderBarycentricPropertiesKHR -> IO PhysicalDeviceFragmentShaderBarycentricPropertiesKHR

ToCStruct PhysicalDeviceFragmentShaderBarycentricPropertiesKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shader_barycentric

Methods

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

pokeCStruct :: Ptr PhysicalDeviceFragmentShaderBarycentricPropertiesKHR -> PhysicalDeviceFragmentShaderBarycentricPropertiesKHR -> IO b -> IO b

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

pokeZeroCStruct :: Ptr PhysicalDeviceFragmentShaderBarycentricPropertiesKHR -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero PhysicalDeviceFragmentShaderBarycentricPropertiesKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shader_barycentric

Methods

zero :: PhysicalDeviceFragmentShaderBarycentricPropertiesKHR

type KHR_FRAGMENT_SHADER_BARYCENTRIC_SPEC_VERSION = 1

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

type KHR_FRAGMENT_SHADER_BARYCENTRIC_EXTENSION_NAME = "VK_KHR_fragment_shader_barycentric"

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