Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server (Not)   Client   Old   Guides   Examples
New in version: 6.2   6.3   6.4   6.5   7.0   7.1   7.2   7.3   7.4   7.5    Statistic  

GMImage.ColorizeRGB

Colorize image with pen color, using specified percent opacity for red, green, and blue quantums.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
GraphicsMagick 2.0 Yes Yes Yes Yes Yes

MBS( "GMImage.ColorizeRGB"; ImageRef; opacityRed; opacityGreen; opacityBlue; penColor )

Parameters

Parameter Description Example value
ImageRef The image reference number. 1
opacityRed Percent from 0 to 100. 50
opacityGreen Percent from 0 to 100. 50
opacityBlue Percent from 0 to 100. 50
penColor A color value.
This can be a string in the following format "HSL h s l a", "YUV y u v a", "RGB r g b a", "MONO m a", "GRAY g a" or "COLOR R G B a". Alpha value a is optional. Range of values is 0 to 1.0 except if you use COLOR where RGB values are 0 to 255.
Starting with version 5.4 of our plugin, you can use hex notation. # followed by 2 digits for red, green, blue and optional alpha, e.g. #FF0000 for full red.
"RGB 1 0 0"

Result

Returns "OK" on success.

Description

Colorize image with pen color, using specified percent opacity for red, green, and blue quantums.
Blends the fill color with each pixel in the image.
A percentage blend is specified with opacity. Control the application of different color components by specifying a different percentage for each component (e.g. 90/100/10 is 90% red, 100% green, and 10% blue).

Examples

Colorize an image

MBS("GMImage.ColorizeRGB"; $BigImageRef; 10; 0; 0; "green")

Colorize by adding 10% blue:

Set Variable [$BigImageRef; Value:MBS("GMImage.NewFromContainer"; Test::BigImage)]
#10% blue
Set Variable [$Result; Value:MBS("GMImage.ColorizeRGB"; $BigImageRef; 10; 10; 10; "blue")]
Set Field [Test::Result; MBS( "GMImage.WriteToJPEGContainer"; $BigImageRef )]
Set Variable [$Error; Value:MBS("GMImage.Destroy";$BigImageRef)]

See also


GMImage.Colorize   -   GMImage.Columns

Feedback: Report problem or ask question.




Links
MBS Xojo blog