PictureEffects Xojo and Real Studio Plugin

MapEffect.ApplyInPlace Method

Applies the effect on a given source image with a given mask without creating a new image, the result is written into the source image. Very Important read the remarks.

ApplyInPlace(
   source as Picture,
   red() as UInt8,
   green() as UInt8,
   blue() as UInt8,
   mask as Picture)

Parameters

source
The source image.
red()
The red channel mapping, defined as: Dim red(255) as UInt8, where array elements 0 - 255 contain the mapping for the red channel.
green()
The green channel mapping, defined as: Dim green(255) as UInt8, where array elements 0 - 255 contain the mapping for the green channel.
blue()
The blue channel mapping, defined as: Dim blue(255) as UInt8, where array elements 0 - 255 contain the mapping for the blue channel.
mask
To limit the filtering to certain pixels then set a picture defining the mask to this parameter. Pass nil to this parameter if the filtering should not be limited to certain pixels.

The mask picture must be a 32 bit picture and must be same size as the src picture. If the mask picture is not 32 bits and same size as the src picture then the function will fail and leave the result picture unchanged.

Remarks

Do not use this to attempt to modify constant images that should not be changed. Constant images are for example images embedded into the project.

See Also

MapEffect Class