GMImage.SetBorderColor
----------------------

Sets the Image border color.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [GraphicsMagick](component_GraphicsMagick.md) | [2.0](newinversion20.md) | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |

MBS( "GMImage.SetBorderColor"; ImageRef; Color ) 

**MBS**( **"GMImage.SetBorderColor";** /\* Sets the Image border color. \*/  
**$ImageRef**; /\* The image reference number.e.g. 1 \*/   
**$Color**) /\* 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 |
| Color | 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

Sets the Image border color.  
You can set this and call [GMImage.Border](GMImageBorder.md) to add border with given color.  
### Examples

Add whitespace on top and bottom of image:

 Let ( \[   
  
$Image = MBS ("[GMImage.NewFromContainer](GMImageNewFromContainer.md)"; GraphicsMagick::image );   
$r = MBS ( "GMImage.SetBorderColor"; $Image ; "white" );  
$r = MBS ("[GMImage.Border](GMImageBorder.md)";$Image ; "0x100");   
$Result = MBS ("[GMImage.WriteToPNGContainer](GMImageWriteToPNGContainer.md)"; $Image );   
  
$r = MBS ("[GMImage.Release](GMImageRelease.md)";$Image )  
\];   
  
$Result )  
### See also

- [GMImage.Border](GMImageBorder.md)
- [GMImage.GetBorderColor](GMImageGetBorderColor.md)
- [GMImage.GetBoxColor](GMImageGetBoxColor.md)
- [GMImage.New](GMImageNew.md)
- [GMImage.NewFromContainer](GMImageNewFromContainer.md)
- [GMImage.Release](GMImageRelease.md)
- [GMImage.SetBoxColor](GMImageSetBoxColor.md)
- [GMImage.SetMatteColor](GMImageSetMatteColor.md)
- [GMImage.SetPixelColor](GMImageSetPixelColor.md)
- [GMImage.SetStrokeColor](GMImageSetStrokeColor.md)

### Blog Entries

- [GraphicsMagick in FileMaker, part 4](https://www.mbsplugins.de/archive/2022-12-04/GraphicsMagick_in_FileMaker_pa/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

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

  
[GMImage.SetBackgroundTexture](GMImageSetBackgroundTexture.md) - [GMImage.SetBoxColor](GMImageSetBoxColor.md)

[HTML Version](GMImageSetBorderColor.shtml)