Topics   All   MacOS (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Deprecated   Guides   Examples   Videos
New in version: 9.5   10.0   10.1   10.2   10.3   10.4   10.5   11.0   11.1   11.2    Statistic    FMM    Blog  

GMImage.ColorizeRGB

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

Component Version macOS Windows Linux Server iOS SDK
GraphicsMagick 2.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "GMImage.ColorizeRGB"; ImageRef; opacityRed; opacityGreen; opacityBlue; penColor )   More

Parameters

Parameter Description Example
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 65535.
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.Release";$BigImageRef)]

See also

Created 18th August 2014, last changed 11st November 2019


GMImage.Colorize - GMImage.Columns

Feedback: Report problem or ask question.