GMImage.Contrast
----------------

Contrast image (enhance intensity differences in image).

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

MBS( "GMImage.Contrast"; ImageRef; sharpen ) 

**MBS**( **"GMImage.Contrast";** /\* Contrast image (enhance intensity differences in image). \*/  
**$ImageRef**; /\* The image reference number.e.g. 1 \*/   
**$sharpen**) /\* The sharpen value.   
An integer number, either 0 or 1.e.g. 1 \*/ 

### Parameters

| Parameter | Description | Example |
|---|---|---|
| ImageRef | The image reference number. | 1 |
| sharpen | The sharpen value.    An integer number, either 0 or 1. | 1 |

### Result

Returns "OK" on success.

### Description

Contrast image (enhance intensity differences in image).  
Enhances the intensity differences between the lighter and darker elements of the image. Set sharpen to a value other than 0 to increase the image contrast otherwise the contrast is reduced.  
### Examples

Changes contrast:

 # load images...   
Set Variable \[ $Image ; Value: MBS ( "[GMImage.NewFromContainer](GMImageNewFromContainer.md)"; test::Input ) \]   
\# change constrast   
Set Variable \[ $r ; Value: MBS ( "GMImage.Contrast"; $Image ; 1) \]   
\# and save to container   
Set Field \[ test::Output ; MBS ( "[GMImage.WriteToPNGContainer](GMImageWriteToPNGContainer.md)"; $Image ; "test.png") \]   
\# free memory   
Set Variable \[ $r ; Value: MBS ( "[GMImage.Release](GMImageRelease.md)"; $Image ) \]  
### See also

- [GMImage.Coders](GMImageCoders.md)
- [GMImage.FontMap](GMImageFontMap.md)
- [GMImage.New](GMImageNew.md)
- [GMImage.NewFromContainer](GMImageNewFromContainer.md)
- [GMImage.Release](GMImageRelease.md)
- [GMImage.WriteToPNGContainer](GMImageWriteToPNGContainer.md)

This function checks for a license.

Created 18th August 2014 , last changed 28th July 2021

  
[GMImage.CompositeXY](GMImageCompositeXY.md) - [GMImage.Copy](GMImageCopy.md)

[HTML Version](GMImageContrast.shtml)