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](component_GraphicsMagick.md) | [2.0](newinversion20.md) | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |

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

**MBS**( **"GMImage.ColorizeRGB";** /\* Colorize image with pen color, using specified percent opacity for red, green, and blue quantums. \*/  
**$ImageRef**; /\* The image reference number.e.g. 1 \*/   
**$opacityRed**; /\* Percent from 0 to 100.e.g. 50 \*/   
**$opacityGreen**; /\* Percent from 0 to 100.e.g. 50 \*/   
**$opacityBlue**; /\* Percent from 0 to 100.e.g. 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.e.g. "RGB 1 0 0" \*/ 

### 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](GMImageNewFromContainer.md)"; Test::BigImage )\]  
\#10% blue   
Set Variable \[$Result ; Value:MBS ("GMImage.ColorizeRGB"; $BigImageRef ; 10; 10; 10; "blue")\]  
Set Field \[Test::Result ; MBS ( "[GMImage.WriteToJPEGContainer](GMImageWriteToJPEGContainer.md)"; $BigImageRef )\]  
Set Variable \[$Error ; Value:MBS ("[GMImage.Release](GMImageRelease.md)";$BigImageRef )\]  
### See also

- [GMImage.Colorize](GMImageColorize.md)
- [GMImage.New](GMImageNew.md)
- [GMImage.NewFromContainer](GMImageNewFromContainer.md)
- [GMImage.Release](GMImageRelease.md)
- [GMImage.WriteToJPEGContainer](GMImageWriteToJPEGContainer.md)

This function checks for a license.

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

  
[GMImage.Colorize](GMImageColorize.md) - [GMImage.Columns](GMImageColumns.md)

[HTML Version](GMImageColorizeRGB.shtml)