GMImage.RandomThresholdChannel
------------------------------

Random threshold image.

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

MBS( "GMImage.RandomThresholdChannel"; ImageRef; thresholds; ChannelType ) 

**MBS**( **"GMImage.RandomThresholdChannel";** /\* Random threshold image. \*/  
**$ImageRef**; /\* The image reference number.e.g. 1 \*/   
**$thresholds**; /\* 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" \*/   
**$ChannelType**) /\* ChannelTypee.g. One of the following values: RedChannel = 1 (RGB Red channel), CyanChannel = 2 (CMYK Cyan channel), GreenChannel = 3 (RGB Green channel), MagentaChannel = 4 (CMYK Magenta channel), BlueChannel = 5 (RGB Blue channel), YellowChannel = 6 (CMYK Yellow channel), OpacityChannel = 7 (Opacity channel), BlackChannel = 8 (CMYK Black (K) channel), MatteChannel = 9 (Same as Opacity channel (deprecated)), AllChannels = 10 (Color channels), GrayChannel = 11 (Color channels represent an intensity.) \*/ 

### Parameters

| Parameter | Description | Example |
|---|---|---|
| ImageRef | The image reference number. | 1 |
| thresholds | 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" |
| ChannelType | ChannelType | One of the following values: RedChannel = 1 (RGB Red channel), CyanChannel = 2 (CMYK Cyan channel), GreenChannel = 3 (RGB Green channel), MagentaChannel = 4 (CMYK Magenta channel), BlueChannel = 5 (RGB Blue channel), YellowChannel = 6 (CMYK Yellow channel), OpacityChannel = 7 (Opacity channel), BlackChannel = 8 (CMYK Black (K) channel), MatteChannel = 9 (Same as Opacity channel (deprecated)), AllChannels = 10 (Color channels), GrayChannel = 11 (Color channels represent an intensity.) |

### Result

Returns "OK" on success.

### Description

Random threshold image.  
Changes the value of individual pixels based on the intensity of each pixel compared to a random threshold. The result is a low-contrast, two color image. The thresholds\_ argument is a geometry containing LOWxHIGH thresholds. If the string contains 2x2, 3x3, or 4x4, then an ordered dither of order 2, 3, or 4 will be performed instead. If a ChannelType argument is specified then only the specified channel is altered. This is a very fast alternative to 'quantize' based dithering.  
This function checks for a license.

Created 18th August 2014 , last changed 18th August 2014

  
[GMImage.RandomThreshold](GMImageRandomThreshold.md) - [GMImage.Read](GMImageRead.md)

[HTML Version](GMImageRandomThresholdChannel.shtml)