PixelDissolve performs a pixel dissolve either from a source image to a destination image or by using the same image.
The return value of the function must be passed in on subsequent calls to continue the pixel dissolve until it is finished. If the source image does not equal the destination image, pixels are copied from the source to the destination by using all of the properties. This process allows dissolving from a blank image into a fully populated image.
If the source and destination images are equal, pixels are filled with the color parameter. This process allows dissolving away from a fully populated image. In this mode, the destination point parameter is ignored.
|
Parameters |
Description |
|
DrawableImage* source |
The input drawable image to use |
|
const Rect<SInt32>& sourceRect |
A rectangle that defines the area of the source image to use as input. |
|
const Point<SInt32>& destPoint |
The point within the destination image that corresponds to the upper-left corner of the source rectangle. |
|
unsigned randomSeed |
The random seed to use to start the pixel dissolve. |
|
unsigned numPixels |
The default is 1/30 of the source area (width x height). |
|
Color fill |
The fill color to use. |
The new random seed value to use for subsequent calls.