Components | All | New | MacOS | Windows | Linux | iOS | ||||
Examples | Mac & Win | Server | Client | Guides | Statistic | FMM | Blog | Deprecated | Old |
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
This function checks for a license.
Created 18th August 2014, last changed 11st November 2019
