KHRBlendEquationAdvanced (LWJGL 3.2.4 SNAPSHOT

java.lang.Object
- org.lwjgl.opengl.KHRBlendEquationAdvanced

```
public class KHRBlendEquationAdvanced
extends java.lang.Object
```
Native bindings to the KHR_blend_equation_advanced extension.
This extension adds a number of "advanced" blending equations that can be used to perform new color blending operations, many of which are more complex than the standard blend modes provided by unextended OpenGL. This extension provides two different extension string entries:
- KHR_blend_equation_advanced:Provides the new blending equations, but guarantees defined results only if each sample is touched no more than once in any single rendering pass. The command BlendBarrierKHR is provided to indicate a boundary between passes.
- KHR_blend_equation_advanced_coherent: Provides the new blending equations, and guarantees that blending is done coherently and in API primitive order. An enable is provided to allow implementations to opt out of fully coherent blending and instead behave as though only KHR_blend_equation_advanced were supported.
Some implementations may support KHR_blend_equation_advanced without supporting KHR_blend_equation_advanced_coherent.

In unextended OpenGL, the set of blending equations is limited, and can be expressed very simply. The MIN and MAX blend equations simply compute component-wise minimums or maximums of source and destination color components. The FUNC_ADD, FUNC_SUBTRACT, and FUNC_REVERSE_SUBTRACT 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 equations. Unlike traditional blending operations using the FUNC_ADD equation, these blending equations do not use source and destination factors specified by BlendFunc. Instead, each blend equation specifies a complete equation based on the source and destination colors. These new blend equations are used for both RGB and alpha components; they may not be used to perform separate RGB and alpha blending (via functions like BlendEquationSeparate).

These blending operations are performed using premultiplied source and destination colors, where RGB colors produced by the fragment shader and stored in the framebuffer are considered to be multiplied by alpha (coverage). 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. Such equations are defined assuming that the source and destination coverage have no spatial correlation within the pixel.

In addition to the coherency issues on implementations not supporting KHR_blend_equation_advanced_coherent, this extension has several limitations worth noting. First, the new blend equations are not supported while rendering to more than one color buffer at once; an INVALID_OPERATION will be generated if an application attempts to render any primitives in this unsupported configuration. Additionally, blending precision may be limited to 16-bit floating-point, which could 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.

Requires OpenGL 2.0.

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`GL_COLORBURN_KHR` Accepted by the `mode` parameter of BlendEquation and BlendEquationi.
`static int`	`GL_COLORDODGE_KHR` Accepted by the `mode` parameter of BlendEquation and BlendEquationi.
`static int`	`GL_DARKEN_KHR` Accepted by the `mode` parameter of BlendEquation and BlendEquationi.
`static int`	`GL_DIFFERENCE_KHR` Accepted by the `mode` parameter of BlendEquation and BlendEquationi.
`static int`	`GL_EXCLUSION_KHR` Accepted by the `mode` parameter of BlendEquation and BlendEquationi.
`static int`	`GL_HARDLIGHT_KHR` Accepted by the `mode` parameter of BlendEquation and BlendEquationi.
`static int`	`GL_HSL_COLOR_KHR` Accepted by the `mode` parameter of BlendEquation and BlendEquationi.
`static int`	`GL_HSL_HUE_KHR` Accepted by the `mode` parameter of BlendEquation and BlendEquationi.
`static int`	`GL_HSL_LUMINOSITY_KHR` Accepted by the `mode` parameter of BlendEquation and BlendEquationi.
`static int`	`GL_HSL_SATURATION_KHR` Accepted by the `mode` parameter of BlendEquation and BlendEquationi.
`static int`	`GL_LIGHTEN_KHR` Accepted by the `mode` parameter of BlendEquation and BlendEquationi.
`static int`	`GL_MULTIPLY_KHR` Accepted by the `mode` parameter of BlendEquation and BlendEquationi.
`static int`	`GL_OVERLAY_KHR` Accepted by the `mode` parameter of BlendEquation and BlendEquationi.
`static int`	`GL_SCREEN_KHR` Accepted by the `mode` parameter of BlendEquation and BlendEquationi.
`static int`	`GL_SOFTLIGHT_KHR` Accepted by the `mode` parameter of BlendEquation and BlendEquationi.

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type Method and Description

static void glBlendBarrierKHR()
Specifies a boundary between passes when using advanced blend equations.
- Methods inherited from class java.lang.Object
  equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`glBlendBarrierKHR()` Specifies a boundary between passes when using advanced blend equations.

- Field Detail
  - GL_MULTIPLY_KHR
```
public static final int GL_MULTIPLY_KHR
```
    Accepted by the mode parameter of BlendEquation and BlendEquationi.
    
    See Also:
    
    Constant Field Values
  - GL_SCREEN_KHR
```
public static final int GL_SCREEN_KHR
```
    Accepted by the mode parameter of BlendEquation and BlendEquationi.
    
    See Also:
    
    Constant Field Values
  - GL_OVERLAY_KHR
```
public static final int GL_OVERLAY_KHR
```
    Accepted by the mode parameter of BlendEquation and BlendEquationi.
    
    See Also:
    
    Constant Field Values
  - GL_DARKEN_KHR
```
public static final int GL_DARKEN_KHR
```
    Accepted by the mode parameter of BlendEquation and BlendEquationi.
    
    See Also:
    
    Constant Field Values
  - GL_LIGHTEN_KHR
```
public static final int GL_LIGHTEN_KHR
```
    Accepted by the mode parameter of BlendEquation and BlendEquationi.
    
    See Also:
    
    Constant Field Values
  - GL_COLORDODGE_KHR
```
public static final int GL_COLORDODGE_KHR
```
    Accepted by the mode parameter of BlendEquation and BlendEquationi.
    
    See Also:
    
    Constant Field Values
  - GL_COLORBURN_KHR
```
public static final int GL_COLORBURN_KHR
```
    Accepted by the mode parameter of BlendEquation and BlendEquationi.
    
    See Also:
    
    Constant Field Values
  - GL_HARDLIGHT_KHR
```
public static final int GL_HARDLIGHT_KHR
```
    Accepted by the mode parameter of BlendEquation and BlendEquationi.
    
    See Also:
    
    Constant Field Values
  - GL_SOFTLIGHT_KHR
```
public static final int GL_SOFTLIGHT_KHR
```
    Accepted by the mode parameter of BlendEquation and BlendEquationi.
    
    See Also:
    
    Constant Field Values
  - GL_DIFFERENCE_KHR
```
public static final int GL_DIFFERENCE_KHR
```
    Accepted by the mode parameter of BlendEquation and BlendEquationi.
    
    See Also:
    
    Constant Field Values
  - GL_EXCLUSION_KHR
```
public static final int GL_EXCLUSION_KHR
```
    Accepted by the mode parameter of BlendEquation and BlendEquationi.
    
    See Also:
    
    Constant Field Values
  - GL_HSL_HUE_KHR
```
public static final int GL_HSL_HUE_KHR
```
    Accepted by the mode parameter of BlendEquation and BlendEquationi.
    
    See Also:
    
    Constant Field Values
  - GL_HSL_SATURATION_KHR
```
public static final int GL_HSL_SATURATION_KHR
```
    Accepted by the mode parameter of BlendEquation and BlendEquationi.
    
    See Also:
    
    Constant Field Values
  - GL_HSL_COLOR_KHR
```
public static final int GL_HSL_COLOR_KHR
```
    Accepted by the mode parameter of BlendEquation and BlendEquationi.
    
    See Also:
    
    Constant Field Values
  - GL_HSL_LUMINOSITY_KHR
```
public static final int GL_HSL_LUMINOSITY_KHR
```
    Accepted by the mode parameter of BlendEquation and BlendEquationi.
    
    See Also:
    
    Constant Field Values
- Method Detail
  - glBlendBarrierKHR
```
public static void glBlendBarrierKHR()
```
    Specifies a boundary between passes when using advanced blend equations.
    When using advanced blending equations, applications should split their rendering into a collection of blending passes, none of which touch an individual sample in the framebuffer more than once. The results of blending are undefined if the sample being blended has been touched previously in the same pass. Any command that causes the value of a sample to be modified using the framebuffer is considered to touch the sample, including clears, blended or unblended primitives, and BlitFramebuffer copies.

Class KHRBlendEquationAdvanced

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

GL_MULTIPLY_KHR

GL_SCREEN_KHR

GL_OVERLAY_KHR

GL_DARKEN_KHR

GL_LIGHTEN_KHR

GL_COLORDODGE_KHR

GL_COLORBURN_KHR

GL_HARDLIGHT_KHR

GL_SOFTLIGHT_KHR

GL_DIFFERENCE_KHR

GL_EXCLUSION_KHR

GL_HSL_HUE_KHR

GL_HSL_SATURATION_KHR

GL_HSL_COLOR_KHR

GL_HSL_LUMINOSITY_KHR

Method Detail

glBlendBarrierKHR