Difference between revisions of "BlendMode"

(Try "New feature" template instead)
(Use more new feature/remove feature)
Line 5: Line 5:
 
;replace: The colors of what's drawn completely replace what was on the screen, with no additional blending.
 
;replace: The colors of what's drawn completely replace what was on the screen, with no additional blending.
 
}}
 
}}
{{newin|[[0.9.1]]|091|type=constant}}
+
{{New feature|0.9.1|
 
;screen: 'Screen' blending.
 
;screen: 'Screen' blending.
{{newin|[[0.10.0]]|100|type=constants|plural=y}}
+
}}
 +
{{New feature|0.10.0|
 
;add: The pixel colors of what's drawn are added to the pixel colors already on the screen. The alpha of the screen is not modified.
 
;add: The pixel colors of what's drawn are added to the pixel colors already on the screen. The alpha of the screen is not modified.
 
;subtract: The pixel colors of what's drawn are subtracted from the pixel colors already on the screen. The alpha of the screen is not modified.
 
;subtract: The pixel colors of what's drawn are subtracted from the pixel colors already on the screen. The alpha of the screen is not modified.
 
;multiply: The pixel colors of what's drawn are multiplied with the pixel colors already on the screen (darkening them). The alpha of drawn objects is multiplied with the alpha of the screen rather than determining how much the colors on the screen are affected, even when the "alphamultiply" [[BlendAlphaMode]] is used.
 
;multiply: The pixel colors of what's drawn are multiplied with the pixel colors already on the screen (darkening them). The alpha of drawn objects is multiplied with the alpha of the screen rather than determining how much the colors on the screen are affected, even when the "alphamultiply" [[BlendAlphaMode]] is used.
----
+
}}
{{oldin|[[0.10.0]]|100|type=constants|plural=y}}
+
{{Removed feature|0.10.0|
 
;additive: Additive blend mode.
 
;additive: Additive blend mode.
{{newinoldin|[[0.7.0]]|070|[[0.10.0]]|100|type=constants|plural=y}}
+
}}
 +
{{Removed new feature|0.7.0|0.10.0|
 
;subtractive: Subtractive blend mode.
 
;subtractive: Subtractive blend mode.
 
;multiplicative: Multiply blend mode.
 
;multiplicative: Multiply blend mode.
{{newinoldin|[[0.8.0]]|080|[[0.10.0]]|100|type=constant}}
+
}}
 +
{{Removed new feature|0.8.0|0.10.0|
 
;premultiplied: Premultiplied alpha blend mode.
 
;premultiplied: Premultiplied alpha blend mode.
 +
}}
 
== Example ==
 
== Example ==
 
[[File:blendModes_0.9.2.png|800px|thumb|none]]
 
[[File:blendModes_0.9.2.png|800px|thumb|none]]

Revision as of 20:33, 31 January 2016

Different ways to do color blending. See BlendAlphaMode and the BlendMode Formulas for additional notes.

Constants

alpha
Alpha blending (normal). The alpha of what's drawn determines its opacity.
Available since LÖVE 0.9.0
replace
The colors of what's drawn completely replace what was on the screen, with no additional blending.


Available since LÖVE 0.9.1
screen
'Screen' blending.


Available since LÖVE 0.10.0
add
The pixel colors of what's drawn are added to the pixel colors already on the screen. The alpha of the screen is not modified.
subtract
The pixel colors of what's drawn are subtracted from the pixel colors already on the screen. The alpha of the screen is not modified.
multiply
The pixel colors of what's drawn are multiplied with the pixel colors already on the screen (darkening them). The alpha of drawn objects is multiplied with the alpha of the screen rather than determining how much the colors on the screen are affected, even when the "alphamultiply" BlendAlphaMode is used.


Removed in LÖVE 0.10.0
additive
Additive blend mode.


Available since LÖVE 0.7.0 and removed in LÖVE 0.10.0
subtractive
Subtractive blend mode.
multiplicative
Multiply blend mode.


Available since LÖVE 0.8.0 and removed in LÖVE 0.10.0
premultiplied
Premultiplied alpha blend mode.

Example

blendModes 0.9.2.png

Source .love

See Also


Other Languages