All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.lwjgl.vulkan.EXTBlendOperationAdvanced Maven / Gradle / Ivy

Go to download

A new generation graphics and compute API that provides high-efficiency, cross-platform access to modern GPUs used in a wide variety of devices from PCs and consoles to mobile phones and embedded platforms.

There is a newer version: 3.3.4
Show newest version
/*
 * Copyright LWJGL. All rights reserved.
 * License terms: https://www.lwjgl.org/license
 * MACHINE GENERATED FILE, DO NOT EDIT
 */
package org.lwjgl.vulkan;

/**
 * This extension adds a number of "{@code 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 {@link VkPhysicalDeviceBlendOperationAdvancedFeaturesEXT}{@code ::advancedBlendCoherentOperations} is {@link VK10#VK_FALSE FALSE}, the new blending operations are supported, but a memory dependency must separate each advanced blend operation on a given sample. {@link #VK_ACCESS_COLOR_ATTACHMENT_READ_NONCOHERENT_BIT_EXT ACCESS_COLOR_ATTACHMENT_READ_NONCOHERENT_BIT_EXT} is used to synchronize reads using advanced blend operations.
    • 
 * 
  • If {@link VkPhysicalDeviceBlendOperationAdvancedFeaturesEXT}{@code ::advancedBlendCoherentOperations} is {@link VK10#VK_TRUE 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 {@link VK10#VK_BLEND_OP_MIN BLEND_OP_MIN} and {@link VK10#VK_BLEND_OP_MAX BLEND_OP_MAX} blend operations simply compute component-wise minimums or maximums of source and destination color components. The {@link VK10#VK_BLEND_OP_ADD BLEND_OP_ADD}, {@link VK10#VK_BLEND_OP_SUBTRACT BLEND_OP_SUBTRACT}, and {@link VK10#VK_BLEND_OP_REVERSE_SUBTRACT 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 "{@code advanced}" blending operations. Unlike traditional blending operations using {@link VK10#VK_BLEND_OP_ADD BLEND_OP_ADD}, these blending equations do not use source and destination factors specified by {@code VkBlendFactor}. 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 {@code VkBlendOp}).

 * 
 * 
These blending operations are performed using premultiplied colors, where RGB colors can be considered premultiplied or non-premultiplied by alpha, according to the {@code srcPremultiplied} and {@code dstPremultiplied} members of {@link VkPipelineColorBlendAdvancedStateCreateInfoEXT}. 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 {@link VkPipelineColorBlendAdvancedStateCreateInfoEXT}{@code ::blendOverlap} can be used to specify a correlation between source and destination pixel coverage. If set to {@link #VK_BLEND_OVERLAP_CONJOINT_EXT 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 {@link #VK_BLEND_OVERLAP_DISJOINT_EXT 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 {@link #VK_BLEND_OVERLAP_UNCORRELATED_EXT 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 {@code 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 {@link VkPhysicalDeviceBlendOperationAdvancedPropertiesEXT}{@code ::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.

 * 
 * 

 * 
Name String

 * 
{@code VK_EXT_blend_operation_advanced}

 * 
Extension Type

 * 
Device extension

 * 
Registered Extension Number

 * 
149

 * 
Revision

 * 
2

 * 
Extension and Version Dependencies

 * 
    
 * 
  • Requires Vulkan 1.0
    • 
 * 

 * 
Contact

 * 
    
 * 
  • Jeff Bolz @jbolz
    • 
 * 

 * 
Last Modified Date

 * 
2017-06-12

 * 
Contributors

 * 
    
 * 
  • Jeff Bolz, NVIDIA
    • 
 * 

 * 

 */
public final class EXTBlendOperationAdvanced {

    /** The extension specification version. */
    public static final int VK_EXT_BLEND_OPERATION_ADVANCED_SPEC_VERSION = 2;

    /** The extension name. */
    public static final String VK_EXT_BLEND_OPERATION_ADVANCED_EXTENSION_NAME = "VK_EXT_blend_operation_advanced";

    /**
     * Extends {@code VkStructureType}.
     * 
     * 
Enum values:

     * 
     * 
    
     * 
  • {@link #VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_BLEND_OPERATION_ADVANCED_FEATURES_EXT STRUCTURE_TYPE_PHYSICAL_DEVICE_BLEND_OPERATION_ADVANCED_FEATURES_EXT}
    • 
     * 
  • {@link #VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_BLEND_OPERATION_ADVANCED_PROPERTIES_EXT STRUCTURE_TYPE_PHYSICAL_DEVICE_BLEND_OPERATION_ADVANCED_PROPERTIES_EXT}
    • 
     * 
  • {@link #VK_STRUCTURE_TYPE_PIPELINE_COLOR_BLEND_ADVANCED_STATE_CREATE_INFO_EXT STRUCTURE_TYPE_PIPELINE_COLOR_BLEND_ADVANCED_STATE_CREATE_INFO_EXT}
    • 
     * 

     */
    public static final int
        VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_BLEND_OPERATION_ADVANCED_FEATURES_EXT   = 1000148000,
        VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_BLEND_OPERATION_ADVANCED_PROPERTIES_EXT = 1000148001,
        VK_STRUCTURE_TYPE_PIPELINE_COLOR_BLEND_ADVANCED_STATE_CREATE_INFO_EXT     = 1000148002;

    /**
     * Extends {@code VkBlendOp}.
     * 
     * 
Enum values:

     * 
     * 
    
     * 
  • {@link #VK_BLEND_OP_ZERO_EXT BLEND_OP_ZERO_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_SRC_EXT BLEND_OP_SRC_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_DST_EXT BLEND_OP_DST_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_SRC_OVER_EXT BLEND_OP_SRC_OVER_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_DST_OVER_EXT BLEND_OP_DST_OVER_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_SRC_IN_EXT BLEND_OP_SRC_IN_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_DST_IN_EXT BLEND_OP_DST_IN_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_SRC_OUT_EXT BLEND_OP_SRC_OUT_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_DST_OUT_EXT BLEND_OP_DST_OUT_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_SRC_ATOP_EXT BLEND_OP_SRC_ATOP_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_DST_ATOP_EXT BLEND_OP_DST_ATOP_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_XOR_EXT BLEND_OP_XOR_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_MULTIPLY_EXT BLEND_OP_MULTIPLY_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_SCREEN_EXT BLEND_OP_SCREEN_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_OVERLAY_EXT BLEND_OP_OVERLAY_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_DARKEN_EXT BLEND_OP_DARKEN_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_LIGHTEN_EXT BLEND_OP_LIGHTEN_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_COLORDODGE_EXT BLEND_OP_COLORDODGE_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_COLORBURN_EXT BLEND_OP_COLORBURN_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_HARDLIGHT_EXT BLEND_OP_HARDLIGHT_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_SOFTLIGHT_EXT BLEND_OP_SOFTLIGHT_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_DIFFERENCE_EXT BLEND_OP_DIFFERENCE_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_EXCLUSION_EXT BLEND_OP_EXCLUSION_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_INVERT_EXT BLEND_OP_INVERT_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_INVERT_RGB_EXT BLEND_OP_INVERT_RGB_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_LINEARDODGE_EXT BLEND_OP_LINEARDODGE_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_LINEARBURN_EXT BLEND_OP_LINEARBURN_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_VIVIDLIGHT_EXT BLEND_OP_VIVIDLIGHT_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_LINEARLIGHT_EXT BLEND_OP_LINEARLIGHT_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_PINLIGHT_EXT BLEND_OP_PINLIGHT_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_HARDMIX_EXT BLEND_OP_HARDMIX_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_HSL_HUE_EXT BLEND_OP_HSL_HUE_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_HSL_SATURATION_EXT BLEND_OP_HSL_SATURATION_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_HSL_COLOR_EXT BLEND_OP_HSL_COLOR_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_HSL_LUMINOSITY_EXT BLEND_OP_HSL_LUMINOSITY_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_PLUS_EXT BLEND_OP_PLUS_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_PLUS_CLAMPED_EXT BLEND_OP_PLUS_CLAMPED_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_PLUS_CLAMPED_ALPHA_EXT BLEND_OP_PLUS_CLAMPED_ALPHA_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_PLUS_DARKER_EXT BLEND_OP_PLUS_DARKER_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_MINUS_EXT BLEND_OP_MINUS_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_MINUS_CLAMPED_EXT BLEND_OP_MINUS_CLAMPED_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_CONTRAST_EXT BLEND_OP_CONTRAST_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_INVERT_OVG_EXT BLEND_OP_INVERT_OVG_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_RED_EXT BLEND_OP_RED_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_GREEN_EXT BLEND_OP_GREEN_EXT}
    • 
     * 
  • {@link #VK_BLEND_OP_BLUE_EXT BLEND_OP_BLUE_EXT}
    • 
     * 

     */
    public static final int
        VK_BLEND_OP_ZERO_EXT               = 1000148000,
        VK_BLEND_OP_SRC_EXT                = 1000148001,
        VK_BLEND_OP_DST_EXT                = 1000148002,
        VK_BLEND_OP_SRC_OVER_EXT           = 1000148003,
        VK_BLEND_OP_DST_OVER_EXT           = 1000148004,
        VK_BLEND_OP_SRC_IN_EXT             = 1000148005,
        VK_BLEND_OP_DST_IN_EXT             = 1000148006,
        VK_BLEND_OP_SRC_OUT_EXT            = 1000148007,
        VK_BLEND_OP_DST_OUT_EXT            = 1000148008,
        VK_BLEND_OP_SRC_ATOP_EXT           = 1000148009,
        VK_BLEND_OP_DST_ATOP_EXT           = 1000148010,
        VK_BLEND_OP_XOR_EXT                = 1000148011,
        VK_BLEND_OP_MULTIPLY_EXT           = 1000148012,
        VK_BLEND_OP_SCREEN_EXT             = 1000148013,
        VK_BLEND_OP_OVERLAY_EXT            = 1000148014,
        VK_BLEND_OP_DARKEN_EXT             = 1000148015,
        VK_BLEND_OP_LIGHTEN_EXT            = 1000148016,
        VK_BLEND_OP_COLORDODGE_EXT         = 1000148017,
        VK_BLEND_OP_COLORBURN_EXT          = 1000148018,
        VK_BLEND_OP_HARDLIGHT_EXT          = 1000148019,
        VK_BLEND_OP_SOFTLIGHT_EXT          = 1000148020,
        VK_BLEND_OP_DIFFERENCE_EXT         = 1000148021,
        VK_BLEND_OP_EXCLUSION_EXT          = 1000148022,
        VK_BLEND_OP_INVERT_EXT             = 1000148023,
        VK_BLEND_OP_INVERT_RGB_EXT         = 1000148024,
        VK_BLEND_OP_LINEARDODGE_EXT        = 1000148025,
        VK_BLEND_OP_LINEARBURN_EXT         = 1000148026,
        VK_BLEND_OP_VIVIDLIGHT_EXT         = 1000148027,
        VK_BLEND_OP_LINEARLIGHT_EXT        = 1000148028,
        VK_BLEND_OP_PINLIGHT_EXT           = 1000148029,
        VK_BLEND_OP_HARDMIX_EXT            = 1000148030,
        VK_BLEND_OP_HSL_HUE_EXT            = 1000148031,
        VK_BLEND_OP_HSL_SATURATION_EXT     = 1000148032,
        VK_BLEND_OP_HSL_COLOR_EXT          = 1000148033,
        VK_BLEND_OP_HSL_LUMINOSITY_EXT     = 1000148034,
        VK_BLEND_OP_PLUS_EXT               = 1000148035,
        VK_BLEND_OP_PLUS_CLAMPED_EXT       = 1000148036,
        VK_BLEND_OP_PLUS_CLAMPED_ALPHA_EXT = 1000148037,
        VK_BLEND_OP_PLUS_DARKER_EXT        = 1000148038,
        VK_BLEND_OP_MINUS_EXT              = 1000148039,
        VK_BLEND_OP_MINUS_CLAMPED_EXT      = 1000148040,
        VK_BLEND_OP_CONTRAST_EXT           = 1000148041,
        VK_BLEND_OP_INVERT_OVG_EXT         = 1000148042,
        VK_BLEND_OP_RED_EXT                = 1000148043,
        VK_BLEND_OP_GREEN_EXT              = 1000148044,
        VK_BLEND_OP_BLUE_EXT               = 1000148045;

    /** Extends {@code VkAccessFlagBits}. */
    public static final int VK_ACCESS_COLOR_ATTACHMENT_READ_NONCOHERENT_BIT_EXT = 0x80000;

    /**
     * VkBlendOverlapEXT - Enumerant specifying the blend overlap parameter
     * 
     * 
Description

     * 
     * 
    
     * 
  • {@link #VK_BLEND_OVERLAP_UNCORRELATED_EXT BLEND_OVERLAP_UNCORRELATED_EXT} specifies that there is no correlation between the source and destination coverage.
    • 
     * 
  • {@link #VK_BLEND_OVERLAP_CONJOINT_EXT BLEND_OVERLAP_CONJOINT_EXT} specifies that the source and destination coverage are considered to have maximal overlap.
    • 
     * 
  • {@link #VK_BLEND_OVERLAP_DISJOINT_EXT BLEND_OVERLAP_DISJOINT_EXT} specifies that the source and destination coverage are considered to have minimal overlap.
    • 
     * 

     * 
     * 
Advanced Blend Overlap Modes

     * 
     * 
     * 
     * 
     * 
     * 
     * 
     * 
     * 
Overlap ModeWeighting Equations
{@link #VK_BLEND_OVERLAP_UNCORRELATED_EXT BLEND_OVERLAP_UNCORRELATED_EXT}
     * p0(As, Ad) = AsAd \\
     * p1(As, Ad) = As(1 − Ad) \\
     * p2(As, Ad) = Ad(1 − As) \\
{@link #VK_BLEND_OVERLAP_CONJOINT_EXT BLEND_OVERLAP_CONJOINT_EXT}
     * p0(As, Ad) = min(As, Ad) \\
     * p1(As, Ad) = max(As − Ad, 0) \\
     * p2(As, Ad) = max(Ad − As, 0) \\
{@link #VK_BLEND_OVERLAP_DISJOINT_EXT BLEND_OVERLAP_DISJOINT_EXT}
     * p0(As, Ad) = max(As + Ad − 1, 0) \\
     * p1(As, Ad) = min(As, 1 − Ad) \\
     * p2(As, Ad) = min(Ad, 1 − As) \\

     * 
     * 
See Also

     * 
     * 
{@link VkPipelineColorBlendAdvancedStateCreateInfoEXT}

     */
    public static final int
        VK_BLEND_OVERLAP_UNCORRELATED_EXT = 0,
        VK_BLEND_OVERLAP_DISJOINT_EXT     = 1,
        VK_BLEND_OVERLAP_CONJOINT_EXT     = 2;

    private EXTBlendOperationAdvanced() {}

}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy