Modulevulkan-3.27GHC2021

Vulkan.Extensions.VK_EXT_blend_operation_advanced

Name

VK_EXT_blend_operation_advanced - device extension

VK_EXT_blend_operation_advanced

Name String: VK_EXT_blend_operation_advanced

Extension Type

Device extension

Registered Extension Number

149

Revision

Ratification Status

Ratified

Extension and Version Dependencies

VK_KHR_get_physical_device_properties2

Vulkan Version 1.1

Contact

Jeff Bolz @jeffbolznv%0A*Here describe the issue or question you have about the VK_EXT_blend_operation_advanced extension*

Other Extension Metadata

Last Modified Date: 2017-06-12

Contributors

Jeff Bolz, NVIDIA

Description

This extension adds a number of “advanced” blending operations that can be used to perform new color blending operations, many of which are more complex than the standard blend modes provided by unextended Vulkan. This extension requires different styles of usage, depending on the level of hardware support and the enabled features:

If PhysicalDeviceBlendOperationAdvancedFeaturesEXT::advancedBlendCoherentOperations is FALSE, the new blending operations are supported, but a memory dependency must separate each advanced blend operation on a given sample. ACCESS_COLOR_ATTACHMENT_READ_NONCOHERENT_BIT_EXT is used to synchronize reads using advanced blend operations.
If PhysicalDeviceBlendOperationAdvancedFeaturesEXT::advancedBlendCoherentOperations is TRUE, advanced blend operations obey primitive order just like basic blend operations.

In unextended Vulkan, the set of blending operations is limited, and can be expressed very simply. The BLEND_OP_MIN and BLEND_OP_MAX blend operations simply compute component-wise minimums or maximums of source and destination color components. The BLEND_OP_ADD, BLEND_OP_SUBTRACT, and BLEND_OP_REVERSE_SUBTRACT modes multiply the source and destination colors by source and destination factors and either add the two products together or subtract one from the other. This limited set of operations supports many common blending operations but precludes the use of more sophisticated transparency and blending operations commonly available in many dedicated imaging APIs.

This extension provides a number of new “advanced” blending operations. Unlike traditional blending operations using BLEND_OP_ADD, these blending equations do not use source and destination factors specified by BlendFactor. Instead, each blend operation specifies a complete equation based on the source and destination colors. These new blend operations are used for both RGB and alpha components; they must not be used to perform separate RGB and alpha blending (via different values of color and alpha BlendOp).

These blending operations are performed using premultiplied colors, where RGB colors can be considered premultiplied or non-premultiplied by alpha, according to the srcPremultiplied and dstPremultiplied members of PipelineColorBlendAdvancedStateCreateInfoEXT. If a color is considered non-premultiplied, the (R,G,B) color components are multiplied by the alpha component prior to blending. For non-premultiplied color components in the range [0,1], the corresponding premultiplied color component would have values in the range [0 × A, 1 × A].

Many of these advanced blending equations are formulated where the result of blending source and destination colors with partial coverage have three separate contributions: from the portions covered by both the source and the destination, from the portion covered only by the source, and from the portion covered only by the destination. The blend parameter PipelineColorBlendAdvancedStateCreateInfoEXT::blendOverlap can be used to specify a correlation between source and destination pixel coverage. If set to BLEND_OVERLAP_CONJOINT_EXT, the source and destination are considered to have maximal overlap, as would be the case if drawing two objects on top of each other. If set to BLEND_OVERLAP_DISJOINT_EXT, the source and destination are considered to have minimal overlap, as would be the case when rendering a complex polygon tessellated into individual non-intersecting triangles. If set to BLEND_OVERLAP_UNCORRELATED_EXT, the source and destination coverage are assumed to have no spatial correlation within the pixel.

In addition to the coherency issues on implementations not supporting advancedBlendCoherentOperations, this extension has several limitations worth noting. First, the new blend operations have a limit on the number of color attachments they can be used with, as indicated by PhysicalDeviceBlendOperationAdvancedPropertiesEXT::advancedBlendMaxColorAttachments. Additionally, blending precision may be limited to 16-bit floating-point, which may result in a loss of precision and dynamic range for framebuffer formats with 32-bit floating-point components, and in a loss of precision for formats with 12- and 16-bit signed or unsigned normalized integer components.

Issues

None.

Version History

Revision 1, 2017-06-12 (Jeff Bolz)
- Internal revisions

Revision 2, 2017-06-12 (Jeff Bolz)
- Internal revisions

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.

6 types

Packagevulkan-3.27
Exports11
LanguageGHC2021
LicenceBSD-3-Clause
SourceVK_EXT_blend_operation_advanced.hs

datadata PhysicalDeviceBlendOperationAdvancedFeaturesEXT

VkPhysicalDeviceBlendOperationAdvancedFeaturesEXT - Structure describing advanced blending features that can be supported by an implementation

Members

This structure describes the following feature:

Description

If the PhysicalDeviceBlendOperationAdvancedFeaturesEXT 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 PhysicalDeviceBlendOperationAdvancedFeaturesEXT, 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.

Structure Chaining

Extends the structures

Constructors

PhysicalDeviceBlendOperationAdvancedFeaturesEXT
- advancedBlendCoherentOperations :: Bool
  advancedBlendCoherentOperations specifies whether blending using advanced blend operations is guaranteed to execute atomically and in primitive order. If this is TRUE, ACCESS_COLOR_ATTACHMENT_READ_NONCOHERENT_BIT_EXT is treated the same as ACCESS_COLOR_ATTACHMENT_READ_BIT, and advanced blending needs no additional synchronization over basic blending. If this is FALSE, then memory dependencies are required to guarantee order between two advanced blending operations that occur on the same sample.

Instances6Eq, Show, Storable, FromCStruct, ToCStruct, Zero

Eq PhysicalDeviceBlendOperationAdvancedFeaturesEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_blend_operation_advanced
Show PhysicalDeviceBlendOperationAdvancedFeaturesEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_blend_operation_advanced
Storable PhysicalDeviceBlendOperationAdvancedFeaturesEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_blend_operation_advanced
FromCStruct PhysicalDeviceBlendOperationAdvancedFeaturesEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_blend_operation_advanced
ToCStruct PhysicalDeviceBlendOperationAdvancedFeaturesEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_blend_operation_advanced
Zero PhysicalDeviceBlendOperationAdvancedFeaturesEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_blend_operation_advanced

datadata PhysicalDeviceBlendOperationAdvancedPropertiesEXT

VkPhysicalDeviceBlendOperationAdvancedPropertiesEXT - Structure describing advanced blending limits that can be supported by an implementation

Description

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

Structure Chaining

Extends the structure

PhysicalDeviceProperties2

Constructors

PhysicalDeviceBlendOperationAdvancedPropertiesEXT
- advancedBlendMaxColorAttachments :: Word32
  advancedBlendMaxColorAttachments is one greater than the highest color attachment index that can be used in a render pass instance, for a pipeline that uses an advanced blend operation.
- advancedBlendIndependentBlend :: Bool
  advancedBlendIndependentBlend specifies whether advanced blend operations can vary per-attachment.
- advancedBlendNonPremultipliedSrcColor :: Bool
  advancedBlendNonPremultipliedSrcColor specifies whether the source color can be treated as non-premultiplied. If this is FALSE, then PipelineColorBlendAdvancedStateCreateInfoEXT::srcPremultiplied must be TRUE.
- advancedBlendNonPremultipliedDstColor :: Bool
  advancedBlendNonPremultipliedDstColor specifies whether the destination color can be treated as non-premultiplied. If this is FALSE, then PipelineColorBlendAdvancedStateCreateInfoEXT::dstPremultiplied must be TRUE.
- advancedBlendCorrelatedOverlap :: Bool
  advancedBlendCorrelatedOverlap specifies whether the overlap mode can be treated as correlated. If this is FALSE, then PipelineColorBlendAdvancedStateCreateInfoEXT::blendOverlap must be BLEND_OVERLAP_UNCORRELATED_EXT.
- advancedBlendAllOperations :: Bool
  advancedBlendAllOperations specifies whether all advanced blend operation enums are supported. See the valid usage of PipelineColorBlendAttachmentState.

Instances6Eq, Show, Storable, FromCStruct, ToCStruct, Zero

Eq PhysicalDeviceBlendOperationAdvancedPropertiesEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_blend_operation_advanced
Show PhysicalDeviceBlendOperationAdvancedPropertiesEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_blend_operation_advanced
Storable PhysicalDeviceBlendOperationAdvancedPropertiesEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_blend_operation_advanced
FromCStruct PhysicalDeviceBlendOperationAdvancedPropertiesEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_blend_operation_advanced
ToCStruct PhysicalDeviceBlendOperationAdvancedPropertiesEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_blend_operation_advanced
Zero PhysicalDeviceBlendOperationAdvancedPropertiesEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_blend_operation_advanced

datadata PipelineColorBlendAdvancedStateCreateInfoEXT

VkPipelineColorBlendAdvancedStateCreateInfoEXT - Structure specifying parameters that affect advanced blend operations

Description

If this structure is not present, srcPremultiplied and dstPremultiplied are both considered to be TRUE, and blendOverlap is considered to be BLEND_OVERLAP_UNCORRELATED_EXT.

Valid Usage

If the non-premultiplied source color property is not supported, srcPremultiplied must be TRUE

If the non-premultiplied destination color property is not supported, dstPremultiplied must be TRUE
If the correlated overlap property is not supported, blendOverlap must be BLEND_OVERLAP_UNCORRELATED_EXT

Valid Usage (Implicit)

sType must be STRUCTURE_TYPE_PIPELINE_COLOR_BLEND_ADVANCED_STATE_CREATE_INFO_EXT

blendOverlap must be a valid BlendOverlapEXT value

Structure Chaining

Extends the structure

PipelineColorBlendStateCreateInfo

Constructors

PipelineColorBlendAdvancedStateCreateInfoEXT
- srcPremultiplied :: Bool
  srcPremultiplied specifies whether the source color of the blend operation is treated as premultiplied.
- dstPremultiplied :: Bool
  dstPremultiplied specifies whether the destination color of the blend operation is treated as premultiplied.
- blendOverlap :: BlendOverlapEXT
  blendOverlap is a BlendOverlapEXT value specifying how the source and destination sample’s coverage is correlated.

Instances6Eq, Show, Storable, FromCStruct, ToCStruct, Zero

Eq PipelineColorBlendAdvancedStateCreateInfoEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_blend_operation_advanced
Show PipelineColorBlendAdvancedStateCreateInfoEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_blend_operation_advanced
Storable PipelineColorBlendAdvancedStateCreateInfoEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_blend_operation_advanced
FromCStruct PipelineColorBlendAdvancedStateCreateInfoEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_blend_operation_advanced
ToCStruct PipelineColorBlendAdvancedStateCreateInfoEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_blend_operation_advanced
Zero PipelineColorBlendAdvancedStateCreateInfoEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_blend_operation_advanced

newtypenewtype BlendOverlapEXT

VkBlendOverlapEXT - Enumerant specifying the blend overlap parameter

Description

BLEND_OVERLAP_UNCORRELATED_EXT specifies that there is no correlation between the source and destination coverage.

BLEND_OVERLAP_CONJOINT_EXT specifies that the source and destination coverage are considered to have maximal overlap.
BLEND_OVERLAP_DISJOINT_EXT specifies that the source and destination coverage are considered to have minimal overlap.

Overlap Mode	Weighting Equations
BLEND_OVERLAP_UNCORRELATED_EXT	\begin{aligned} p_0(A_s,A_d) & = A_sA_d \\ p_1(A_s,A_d) & = A_s(1-A_d) \\ p_2(A_s,A_d) & = A_d(1-A_s) \\ \end{aligned}
BLEND_OVERLAP_CONJOINT_EXT	\begin{aligned} p_0(A_s,A_d) & = min(A_s,A_d) \\ p_1(A_s,A_d) & = max(A_s-A_d,0) \\ p_2(A_s,A_d) & = max(A_d-A_s,0) \\ \end{aligned}
BLEND_OVERLAP_DISJOINT_EXT	\begin{aligned} p_0(A_s,A_d) & = max(A_s+A_d-1,0) \\ p_1(A_s,A_d) & = min(A_s,1-A_d) \\ p_2(A_s,A_d) & = min(A_d,1-A_s) \\ \end{aligned}

Overlap Mode

Weighting Equations

BLEND_OVERLAP_UNCORRELATED_EXT

                                              \begin{aligned}
p_0(A_s,A_d) & = A_sA_d \\
p_1(A_s,A_d) & = A_s(1-A_d) \\
p_2(A_s,A_d) & = A_d(1-A_s) \\
\end{aligned}

BLEND_OVERLAP_CONJOINT_EXT

                                              \begin{aligned}
p_0(A_s,A_d) & = min(A_s,A_d) \\
p_1(A_s,A_d) & = max(A_s-A_d,0) \\
p_2(A_s,A_d) & = max(A_d-A_s,0) \\
\end{aligned}

BLEND_OVERLAP_DISJOINT_EXT

                                              \begin{aligned}
p_0(A_s,A_d) & = max(A_s+A_d-1,0) \\
p_1(A_s,A_d) & = min(A_s,1-A_d) \\
p_2(A_s,A_d) & = min(A_d,1-A_s) \\
\end{aligned}

Advanced Blend Overlap Modes

Constructors

BlendOverlapEXT Int32

Instances6Eq, Ord, Read, Show, Storable, Zero

Eq BlendOverlapEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_blend_operation_advanced
Ord BlendOverlapEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_blend_operation_advanced
Read BlendOverlapEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_blend_operation_advanced
Show BlendOverlapEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_blend_operation_advanced
Storable BlendOverlapEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_blend_operation_advanced
Zero BlendOverlapEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_blend_operation_advanced

patternpattern BLEND_OVERLAP_UNCORRELATED_EXT :: BlendOverlapEXT

patternpattern BLEND_OVERLAP_DISJOINT_EXT :: BlendOverlapEXT

patternpattern BLEND_OVERLAP_CONJOINT_EXT :: BlendOverlapEXT

typetype EXT_BLEND_OPERATION_ADVANCED_SPEC_VERSION = 2

patternpattern EXT_BLEND_OPERATION_ADVANCED_SPEC_VERSION :: Integral a => a

typetype EXT_BLEND_OPERATION_ADVANCED_EXTENSION_NAME = "VK_EXT_blend_operation_advanced"

patternpattern EXT_BLEND_OPERATION_ADVANCED_EXTENSION_NAME :: (Eq a, IsString a) => a

Vulkan.Extensions.VK_EXT_blend_operation_advanced

Name

VK_EXT_blend_operation_advanced

Other Extension Metadata

Description

New Structures

New Enums

New Enum Constants

Issues

Version History

See Also

Document Notes

Members

Description

Structure Chaining

See Also

Constructors

Description

Structure Chaining

See Also

Constructors

Description

Valid Usage

Valid Usage (Implicit)

Structure Chaining

See Also

Constructors

Description

See Also

Constructors