Difference between revisions of "BlendMode Formulas"

(Added 'screen' blend mode)
 
(8 intermediate revisions by 4 users not shown)
Line 1: Line 1:
−
Copied from: [http://www.love2d.org/forums/viewtopic.php?f=4&t=10268&p=62157&hilit=blend+formula#p62171 Forum Post]
+
Equations used when blending drawn content with the screen or active [[Canvas]].
  
−
LÖVE currently uses OpenGL and exposes some of the blend equations and functions of it.
+
Color components are in the range of [0, 1]. Results are clamped to [0, 1] except when a [[Canvas]] is active that has a floating-point / HDR [[CanvasFormat|format]].
  
−
Here's a list where the numbers are in the interval [0,1]; dst is the existing color in the buffer; src is the global color, texture color, or both of them mixed together (depending on the color mode); and res is the resulting color.
+
Description:
 +
 +
*'''dst''' - existing color in the screen.
 +
 
 +
*'''src''' - the color of the drawn object (the color output by the pixel shader, or the global color multiplied by the texture's color – if any, if no shader is used.)
 +
 
 +
*'''res''' - resulting color.
 +
 
 +
Here are the [[BlendMode]] formulas for all 0.10.x and later versions:
  
 
== alpha ==
 
== alpha ==
  
−
=== [[0.9.0]] and newer: ===
+
=== "alphamultiply" [[BlendAlphaMode|alpha mode]] ===
  
 
     res.r = dst.r * (1 - src.a) + src.r * src.a
 
     res.r = dst.r * (1 - src.a) + src.r * src.a
Line 14: Line 22:
 
     res.a = dst.a * (1 - src.a) + src.a
 
     res.a = dst.a * (1 - src.a) + src.a
  
−
=== 0.8.0 and older: ===
+
=== "premultiplied" [[BlendAlphaMode|alpha mode]] ===
 +
 
 +
    res.r = dst.r * (1 - src.a) + src.r
 +
    res.g = dst.g * (1 - src.a) + src.g
 +
    res.b = dst.b * (1 - src.a) + src.b
 +
    res.a = dst.a * (1 - src.a) + src.a
 +
 
 +
== add ==
 +
 
 +
=== "alphamultiply" [[BlendAlphaMode|alpha mode]] ===
 +
 
 +
    res.r = dst.r + (src.r * src.a)
 +
    res.g = dst.g + (src.g * src.a)
 +
    res.b = dst.b + (src.b * src.a)
 +
    res.a = dst.a
 +
 
 +
=== "premultiplied" [[BlendAlphaMode|alpha mode]] ===
 +
 
 +
    res.r = dst.r + src.r
 +
    res.g = dst.g + src.g
 +
    res.b = dst.b + src.b
 +
    res.a = dst.a
 +
 
 +
== subtract ==
 +
 
 +
=== "alphamultiply" [[BlendAlphaMode|alpha mode]] ===
 +
 
 +
    res.r = dst.r - (src.r * src.a)
 +
    res.g = dst.g - (src.g * src.a)
 +
    res.b = dst.b - (src.b * src.a)
 +
    res.a = dst.a
 +
 
 +
=== "premultiplied" [[BlendAlphaMode|alpha mode]] ===
 +
 
 +
    res.r = dst.r - src.r
 +
    res.g = dst.g - src.g
 +
    res.b = dst.b - src.b
 +
    res.a = dst.a
 +
 
 +
== replace ==
 +
 
 +
=== "alphamultiply" [[BlendAlphaMode|alpha mode]] ===
 +
 
 +
    res.r = src.r * src.a
 +
    res.g = src.g * src.a
 +
    res.b = src.b * src.a
 +
    res.a = src.a
 +
 
 +
=== "premultiplied" [[BlendAlphaMode|alpha mode]] ===
 +
 
 +
    res.r = src.r
 +
    res.g = src.g
 +
    res.b = src.b
 +
    res.a = src.a
 +
 
 +
== multiply ==
 +
 
 +
=== "premultiplied" [[BlendAlphaMode|alpha mode]] ===
 +
 
 +
    res.r = src.r * dst.r
 +
    res.g = src.g * dst.g
 +
    res.b = src.b * dst.b
 +
    res.a = src.a * dst.a
 +
 
 +
Note: In 0.10.x, ''multiply'' with ''alphamultiply'' uses the same equations as with ''premultiplied''. In [[11.0]] and later versions, this variation is not supported.
 +
 
 +
== lighten ==
 +
 
 +
=== "premultiplied" [[BlendAlphaMode|alpha mode]] ===
 +
 
 +
    res.r = max(src.r, dst.r)
 +
    res.g = max(src.g, dst.g)
 +
    res.b = max(src.b, dst.b)
 +
    res.a = max(src.a, dst.a)
 +
 
 +
== darken ==
 +
 
 +
=== "premultiplied" [[BlendAlphaMode|alpha mode]] ===
 +
 
 +
    res.r = min(src.r, dst.r)
 +
    res.g = min(src.g, dst.g)
 +
    res.b = min(src.b, dst.b)
 +
    res.a = min(src.a, dst.a)
 +
 
 +
== screen ==
 +
 
 +
Note: The math for this blend mode is not completely correct when using the "alphamultiply" alpha mode. Prefer the "premultiplied" variant (and be sure your content has its RGB multiplied by its alpha at some point before blending), when possible.
 +
 
 +
=== "alphamultiply" [[BlendAlphaMode|alpha mode]] ===
 +
 
 +
    res.r = dst.r * (1 - src.r) + (src.r * src.a)
 +
    res.g = dst.g * (1 - src.g) + (src.g * src.a)
 +
    res.b = dst.b * (1 - src.b) + (src.b * src.a)
 +
    res.a = dst.a * (1 - src.a) + src.a
 +
 
 +
=== "premultiplied" [[BlendAlphaMode|alpha mode]] ===
 +
 
 +
    res.r = dst.r * (1 - src.r) + src.r
 +
    res.g = dst.g * (1 - src.g) + src.g
 +
    res.b = dst.b * (1 - src.b) + src.b
 +
    res.a = dst.a * (1 - src.a) + src.a
 +
 
 +
== Older Versions ==
 +
 
 +
=== alpha ([[0.9.0]], [[0.9.1]], and [[0.9.2]]) ===
 +
 
 +
    res.r = dst.r * (1 - src.a) + src.r * src.a
 +
    res.g = dst.g * (1 - src.a) + src.g * src.a
 +
    res.b = dst.b * (1 - src.a) + src.b * src.a
 +
    res.a = dst.a * (1 - src.a) + src.a
 +
 
 +
=== alpha ([[0.8.0]] and older) ===
  
 
     res.r = dst.r * (1 - src.a) + src.r * src.a
 
     res.r = dst.r * (1 - src.a) + src.r * src.a
Line 21: Line 140:
 
     res.a = dst.a * (1 - src.a) + src.a * src.a
 
     res.a = dst.a * (1 - src.a) + src.a * src.a
  
−
== premultiplied ==
+
=== premultiplied ([[0.9.2]] and older) ===
  
 
     res.r = dst.r * (1 - src.a) + src.r
 
     res.r = dst.r * (1 - src.a) + src.r
Line 28: Line 147:
 
     res.a = dst.a * (1 - src.a) + src.a
 
     res.a = dst.a * (1 - src.a) + src.a
  
−
== screen ==
+
=== screen ([[0.9.2]] and older) ===
  
 
     res.r = dst.r * (1 - src.r) + src.r
 
     res.r = dst.r * (1 - src.r) + src.r
Line 35: Line 154:
 
     res.a = dst.a * (1 - src.a) + src.a
 
     res.a = dst.a * (1 - src.a) + src.a
  
−
== additive ==
+
=== additive ([[0.9.2]] and older) ===
  
 
     res.r = dst.r + (src.r * src.a)
 
     res.r = dst.r + (src.r * src.a)
Line 42: Line 161:
 
     res.a = dst.a + (src.a * src.a)
 
     res.a = dst.a + (src.a * src.a)
  
−
== subtractive ==
+
=== subtractive ([[0.9.2]] and older) ===
  
 
     res.r = dst.r - src.r * src.a
 
     res.r = dst.r - src.r * src.a
Line 49: Line 168:
 
     res.a = dst.a - src.a * src.a
 
     res.a = dst.a - src.a * src.a
  
−
== multiplicative ==
+
=== multiplicative ([[0.9.0]], [[0.9.1]], and [[0.9.2]]) ===
−
 
 
−
=== [[0.9.0]] and newer: ===
 
  
 
     res.r = src.r * dst.r
 
     res.r = src.r * dst.r
Line 58: Line 175:
 
     res.a = src.a * dst.a
 
     res.a = src.a * dst.a
  
−
=== 0.8.0 and older: ===
+
=== multiplicative ([[0.8.0]] and older) ===
  
 
     res.r = dst.r * (1 - src.a) + src.r * dst.r
 
     res.r = dst.r * (1 - src.a) + src.r * dst.r
Line 65: Line 182:
 
     res.a = dst.a * (1 - src.a) + src.a * dst.a
 
     res.a = dst.a * (1 - src.a) + src.a * dst.a
  
−
== replace ==
+
=== replace ([[0.9.2]] and older) ===
  
 
     res.r = src.r
 
     res.r = src.r
Line 71: Line 188:
 
     res.b = src.b
 
     res.b = src.b
 
     res.a = src.a
 
     res.a = src.a
−
 
−
== Notes ==
 
−
OpenGL clamps to [0,1] (except when rendering to HDR [[Canvas]]es) in case you're wondering if subtractive could have had negative values.
 
  
 
== See Also ==
 
== See Also ==
 
* [[BlendMode]]
 
* [[BlendMode]]
 +
 +
== Other Languages ==
 +
{{i18n|BlendMode Formulas}}

Latest revision as of 16:20, 28 September 2024

Equations used when blending drawn content with the screen or active Canvas.

Color components are in the range of [0, 1]. Results are clamped to [0, 1] except when a Canvas is active that has a floating-point / HDR format.

Description:

  • dst - existing color in the screen.
  • src - the color of the drawn object (the color output by the pixel shader, or the global color multiplied by the texture's color – if any, if no shader is used.)
  • res - resulting color.

Here are the BlendMode formulas for all 0.10.x and later versions:

alpha

"alphamultiply" alpha mode

   res.r = dst.r * (1 - src.a) + src.r * src.a
   res.g = dst.g * (1 - src.a) + src.g * src.a
   res.b = dst.b * (1 - src.a) + src.b * src.a
   res.a = dst.a * (1 - src.a) + src.a

"premultiplied" alpha mode

   res.r = dst.r * (1 - src.a) + src.r
   res.g = dst.g * (1 - src.a) + src.g
   res.b = dst.b * (1 - src.a) + src.b
   res.a = dst.a * (1 - src.a) + src.a

add

"alphamultiply" alpha mode

   res.r = dst.r + (src.r * src.a)
   res.g = dst.g + (src.g * src.a)
   res.b = dst.b + (src.b * src.a)
   res.a = dst.a

"premultiplied" alpha mode

   res.r = dst.r + src.r
   res.g = dst.g + src.g
   res.b = dst.b + src.b
   res.a = dst.a

subtract

"alphamultiply" alpha mode

   res.r = dst.r - (src.r * src.a)
   res.g = dst.g - (src.g * src.a)
   res.b = dst.b - (src.b * src.a)
   res.a = dst.a

"premultiplied" alpha mode

   res.r = dst.r - src.r
   res.g = dst.g - src.g
   res.b = dst.b - src.b
   res.a = dst.a

replace

"alphamultiply" alpha mode

   res.r = src.r * src.a
   res.g = src.g * src.a
   res.b = src.b * src.a
   res.a = src.a

"premultiplied" alpha mode

   res.r = src.r
   res.g = src.g
   res.b = src.b
   res.a = src.a

multiply

"premultiplied" alpha mode

   res.r = src.r * dst.r
   res.g = src.g * dst.g
   res.b = src.b * dst.b
   res.a = src.a * dst.a

Note: In 0.10.x, multiply with alphamultiply uses the same equations as with premultiplied. In 11.0 and later versions, this variation is not supported.

lighten

"premultiplied" alpha mode

   res.r = max(src.r, dst.r)
   res.g = max(src.g, dst.g)
   res.b = max(src.b, dst.b)
   res.a = max(src.a, dst.a)

darken

"premultiplied" alpha mode

   res.r = min(src.r, dst.r)
   res.g = min(src.g, dst.g)
   res.b = min(src.b, dst.b)
   res.a = min(src.a, dst.a)

screen

Note: The math for this blend mode is not completely correct when using the "alphamultiply" alpha mode. Prefer the "premultiplied" variant (and be sure your content has its RGB multiplied by its alpha at some point before blending), when possible.

"alphamultiply" alpha mode

   res.r = dst.r * (1 - src.r) + (src.r * src.a)
   res.g = dst.g * (1 - src.g) + (src.g * src.a)
   res.b = dst.b * (1 - src.b) + (src.b * src.a)
   res.a = dst.a * (1 - src.a) + src.a

"premultiplied" alpha mode

   res.r = dst.r * (1 - src.r) + src.r
   res.g = dst.g * (1 - src.g) + src.g
   res.b = dst.b * (1 - src.b) + src.b
   res.a = dst.a * (1 - src.a) + src.a

Older Versions

alpha (0.9.0, 0.9.1, and 0.9.2)

   res.r = dst.r * (1 - src.a) + src.r * src.a
   res.g = dst.g * (1 - src.a) + src.g * src.a
   res.b = dst.b * (1 - src.a) + src.b * src.a
   res.a = dst.a * (1 - src.a) + src.a

alpha (0.8.0 and older)

   res.r = dst.r * (1 - src.a) + src.r * src.a
   res.g = dst.g * (1 - src.a) + src.g * src.a
   res.b = dst.b * (1 - src.a) + src.b * src.a
   res.a = dst.a * (1 - src.a) + src.a * src.a

premultiplied (0.9.2 and older)

   res.r = dst.r * (1 - src.a) + src.r
   res.g = dst.g * (1 - src.a) + src.g
   res.b = dst.b * (1 - src.a) + src.b
   res.a = dst.a * (1 - src.a) + src.a

screen (0.9.2 and older)

   res.r = dst.r * (1 - src.r) + src.r
   res.g = dst.g * (1 - src.g) + src.g
   res.b = dst.b * (1 - src.b) + src.b
   res.a = dst.a * (1 - src.a) + src.a

additive (0.9.2 and older)

   res.r = dst.r + (src.r * src.a)
   res.g = dst.g + (src.g * src.a)
   res.b = dst.b + (src.b * src.a)
   res.a = dst.a + (src.a * src.a)

subtractive (0.9.2 and older)

   res.r = dst.r - src.r * src.a
   res.g = dst.g - src.g * src.a
   res.b = dst.b - src.b * src.a
   res.a = dst.a - src.a * src.a

multiplicative (0.9.0, 0.9.1, and 0.9.2)

   res.r = src.r * dst.r
   res.g = src.g * dst.g
   res.b = src.b * dst.b
   res.a = src.a * dst.a

multiplicative (0.8.0 and older)

   res.r = dst.r * (1 - src.a) + src.r * dst.r
   res.g = dst.g * (1 - src.a) + src.g * dst.g
   res.b = dst.b * (1 - src.a) + src.b * dst.b
   res.a = dst.a * (1 - src.a) + src.a * dst.a

replace (0.9.2 and older)

   res.r = src.r
   res.g = src.g
   res.b = src.b
   res.a = src.a

See Also

Other Languages

Dansk – Deutsch – English – Español – Français – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Polski – Português – Română – Slovenský – Suomi – Svenska – Türkçe – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – ไทย – 日本語 – 正體中文 – 简体中文 – Tiếng Việt – 한국어
More info

Retrieved from "https://love2d.org./w/index.php?title=BlendMode_Formulas&oldid=29328"