Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old

GMImage.RandomThresholdChannel

Random threshold image.

Component Version macOS Windows Linux Server iOS SDK
GraphicsMagick 2.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "GMImage.RandomThresholdChannel"; ImageRef; thresholds; ChannelType )   More

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 - GMImage.Read