GMImage.Raise
-------------

Raise image (lighten or darken the edges of an image to give a 3-D raised or lowered effect)

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

MBS( "GMImage.Raise"; ImageRef { ; Geometry; raisedFlag } ) 

**MBS**( **"GMImage.Raise";** /\* Raise image (lighten or darken the edges of an image to give a 3-D raised or lowered effect) \*/  
**$ImageRef**; /\* The image reference number.e.g. 1 \*/   
**$Geometry**; /\* Optional; The rectangle. Geometry is specified as a width and height "100x200". With an optional offset "100x200+10+20". For percent values, add a percent on the end, for % values add a %: "100x200%!"e.g. "100x200" \*/   
**$raisedFlag**) /\* Optional; A boolean flag.e.g. 0 \*/ 

### Parameters

| Parameter | Description | Example | Flags |
|---|---|---|---|
| ImageRef | The image reference number. | 1 |  |
| Geometry | The rectangle. Geometry is specified as a width and height "100x200". With an optional offset "100x200+10+20". For percent values, add a percent on the end, for % values add a %: "100x200%!" | "100x200" | Optional |
| raisedFlag | A boolean flag. | 0 | Optional |

### Result

Returns "OK" on success.

### Description

Raise image (lighten or darken the edges of an image to give a 3-D raised or lowered effect)  
### Examples

Raises the border of an image:

 Let ( \[   
$Image = MBS ("[GMImage.NewFromContainer](GMImageNewFromContainer.md)"; GraphicsMagick::image );   
$ScaleResult = MBS ("GMImage.Raise";$Image );   
$Result = MBS ("[GMImage.WriteToPNGContainer](GMImageWriteToPNGContainer.md)"; $Image );   
$Error = MBS ("[GMImage.Release](GMImageRelease.md)";$Image )  
\];   
$Result )  
Raise an image:

 # load images...   
Set Variable \[ $Image ; Value: MBS ( "[GMImage.NewFromFile](GMImageNewFromFile.md)"; "/Users/cs/Pictures/IMG\_3625.jpg") \]   
\# raise image   
Set Variable \[ $r ; Value: MBS ( "GMImage.Raise"; $Image ) \]   
\# and save to file   
Set Variable \[ $r ; Value: MBS ( "[GMImage.WriteToFile](GMImageWriteToFile.md)"; $Image ; "/Users/cs/Pictures/output.jpg") \]   
\# free memory   
Set Variable \[ $r ; Value: MBS ( "[GMImage.Release](GMImageRelease.md)"; $Image ) \]  
### See also

- [GMImage.Erase](GMImageErase.md)
- [GMImage.Hash](GMImageHash.md)
- [GMImage.List](GMImageList.md)
- [GMImage.New](GMImageNew.md)
- [GMImage.NewFromFile](GMImageNewFromFile.md)
- [GMImage.Resize](GMImageResize.md)
- [GMImage.Rows](GMImageRows.md)
- [GMImage.Wave](GMImageWave.md)
- [GMImage.WriteToFile](GMImageWriteToFile.md)
- [GMImage.WriteToPNGContainer](GMImageWriteToPNGContainer.md)

### Example Databases

- [GraphicsMagick/GraphicsMagick Sample](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/GraphicsMagick/GraphicsMagick%20Sample.shtml#7ScriptAnchor_)

This function checks for a license.

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

  
[GMImage.QuantumDepth](GMImageQuantumDepth.md) - [GMImage.RandomThreshold](GMImageRandomThreshold.md)

[HTML Version](GMImageRaise.shtml)