blend_mode()

Blends the pixels in the display window according to a defined mode.

Examples

1
2
3
4
5
6
7
def setup():
    py5.background(0)
    py5.blend_mode(py5.ADD)
    py5.stroke(102)
    py5.stroke_weight(30)
    py5.line(25, 25, 75, 75)
    py5.line(75, 25, 25, 75)
1
2
3
4
5
6
7
def setup():
    py5.size(100, 100, py5.P2D)
    py5.blend_mode(py5.MULTIPLY)
    py5.stroke(51)
    py5.stroke_weight(30)
    py5.line(25, 25, 75, 75)
    py5.line(75, 25, 25, 75)

Description

Blends the pixels in the display window according to a defined mode. There is a choice of the following modes to blend the source pixels (A) with the ones of pixels already in the display window (B). Each pixel’s final color is the result of applying one of the blend modes with each channel of (A) and (B) independently. The red channel is compared with red, green with green, and blue with blue.

  • BLEND: linear interpolation of colors: C = A*factor + B. This is the default.

  • ADD: additive blending with white clip: C = min(A*factor + B, 255)

  • SUBTRACT: subtractive blending with black clip: C = max(B - A*factor, 0)

  • DARKEST: only the darkest color succeeds: C = min(A*factor, B)

  • LIGHTEST: only the lightest color succeeds: C = max(A*factor, B)

  • DIFFERENCE: subtract colors from underlying image.

  • EXCLUSION: similar to DIFFERENCE, but less extreme.

  • MULTIPLY: multiply the colors, result will always be darker.

  • SCREEN: opposite multiply, uses inverse values of the colors.

  • REPLACE: the pixels entirely replace the others and don’t utilize alpha (transparency) values

We recommend using blend_mode() and not the previous blend() function. However, unlike blend(), the blend_mode() function does not support the following: HARD_LIGHT, SOFT_LIGHT, OVERLAY, DODGE, BURN. On older hardware, the LIGHTEST, DARKEST, and DIFFERENCE modes might not be available as well.

Underlying Java method: blendMode

Syntax

blend_mode(mode: int, /) -> None

Parameters

  • mode: int - the blending mode to use

Updated on September 11, 2021 16:51:34pm UTC