PImage::alpha() \ Language (API) \ Processing 1.0
Author: Casey Reas & Ben Fry
Description: Processing is an electronic sketchbook for developing ideas. It is a context for learning fundamentals of computer programming within the context of the electronic arts.
Keywords: Processing, Processing, Interactive Media, Electronic Arts, Programming, Java, Ben Fry, Casey Reas

Reference for Processing version 1.5. If you have a previous version, use the reference included with your software. If you see any errors or have suggestions, please let us know. If you prefer a more technical reference, visit the Processing Javadoc.

Class | PImage
Name | ### alpha()
Examples |
    PImage img = loadImage("test.jpg");
    PImage alphaImg = loadImage("mask.jpg");
    img.alpha(alphaImg);
    image(img, 0, 0);
    image(img, 25, 0);
Description | Set the alpha channel of an image. Because Processing can only load GIF and JPEG bitmaps, which do not support variable degrees of transparency, an image's alpha channel needs to be loaded as a separate image. This alpha image should only contain grayscale data. Only the blue color channel is used, which corresponds to values between 0 and 255. The image passed in an alpha channel needs to be of exactly the same size as the image it will be applied to. Instead of an alpha image, an integer array containing the alpha channel data can be specified directly. Again, this array must be of the same length as the target image's pixels array and should, as with the other version of the function, only contain grayscale data or values between 0-255. Using this array method is useful for using dynamic, generated alpha masks.
Syntax |
    img.alpha(alphaImg)
    img.alpha(alphaArray)
Parameters |
img | any variable of type PImage
alphaImg | PImage: any PImage object used as the alpha channel for "img", needs to be same size as "img"
alphaArray | int[]: any array of Integer numbers used as the alpha channel, needs to be same length as the image's pixel array
Usage | Web & Application

Updated on August 30, 2010 04:29:39pm EDT