a port of the Processing Visualization Language
Class PImage
Name

blend()

Examples
example pic
// @pjs preload must be used to preload the image
/* @pjs preload="rockies.jpg,degaul.jpg"; */
PImage img = loadImage("rockies.jpg");
PImage img2 = loadImage("degaul.jpg"); 
img.blend(img2, 0, 0, 33, 100, 67, 0, 33, 100, ADD); 
image(img, 0, 0);
image(img2, 0, 0);
example pic
// @pjs preload must be used to preload the image
/* @pjs preload="rockies.jpg,degaul.jpg"; */
PImage img = loadImage("rockies.jpg");
PImage img2 = loadImage("degaul.jpg"); 
img.blend(img2, 0, 0, 33, 100, 67, 0, 33, 100, SUBTRACT); 
image(img, 0, 0);
image(img2, 0, 0);
example pic
// @pjs preload must be used to preload the image
/* @pjs preload="rockies.jpg,degaul.jpg"; */
PImage img = loadImage("rockies.jpg");
PImage img2 = loadImage("degaul.jpg"); 
img.blend(img2, 0, 0, 33, 100, 67, 0, 33, 100, DARKEST); 
image(img, 0, 0);
image(img2, 0, 0);
example pic
// @pjs preload must be used to preload the image
/* @pjs preload="rockies.jpg,degaul.jpg"; */
PImage img = loadImage("rockies.jpg");
PImage img2 = loadImage("degaul.jpg"); 
img.blend(img2, 0, 0, 33, 100, 67, 0, 33, 100, LIGHTEST); 
image(img, 0, 0);
image(img2, 0, 0);
Description

Blends a region of pixels into the image specified by the img parameter. These copies utilize full alpha channel support and a choice of the following modes to blend the colors of source pixels (A) with the ones of pixels in the destination image (B):

BLEND - linear interpolation of colours: C = A*factor + B

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 colour succeeds: C = min(A*factor, B)

LIGHTEST - only the lightest colour 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.

OVERLAY - A mix of MULTIPLY and SCREEN. Multiplies dark values, and screens light values.

HARD_LIGHT - SCREEN when greater than 50% gray, MULTIPLY when lower.

SOFT_LIGHT - Mix of DARKEST and LIGHTEST. Works like OVERLAY, but not as harsh.

DODGE - Lightens light tones and increases contrast, ignores darks. Called "Color Dodge" in Illustrator and Photoshop.

BURN - Darker areas are applied, increasing contrast, ignores lights. Called "Color Burn" in Illustrator and Photoshop.

All modes use the alpha information (highest byte) of source image pixels as the blending factor. If the source and destination regions are different sizes, the image will be automatically resized to match the destination size. If the srcImg parameter is not used, the display window is used as the source image.

This function ignores imageMode().

Syntax
img.blend(x,y,width,height,dx,dy,dwidth,dheight,MODE)

img.blend(srcImg,x,y,width,height,dx,dy,dwidth,dheight,MODE)
Parameters
img PImage: any variable of type PImage
x int: X coordinate of the source's upper left corner
y int: Y coordinate of the source's upper left corner
width int: source image width
height int: source image height
dx int: X coordinate of the destination's upper left corner
dy int: Y coordinate of the destination's upper left corner
dwidth int: destination image width
dheight int: destination image height
srcImg PImage:a image variable referring to the source image.
MODE Either BLEND, ADD, SUBTRACT, LIGHTEST, DARKEST, DIFFERENCE, EXCLUSION, MULTIPLY, SCREEN, OVERLAY, HARD_LIGHT, SOFT_LIGHT, DODGE, BURN
Returns None
Usage Web & Application
Related alpha()
copy()

This reference is licensed under the CC BY-NC-SA 2.0 license:

Creative Commons License
Fork me on GitHub