All functions   Mac OS X   Windows   Crossplatform   Components   New in version: 1.0   1.1   1.2   1.3   1.4   1.5   1.6   1.7   1.8   2.0  

GMImage.RandomThreshold

Component: GraphicsMagick
Mac OS X: Works
Windows: Works

MBS( "GMImage.RandomThreshold"; ImageRef; thresholds )

Parameters

Parameter Description Example value
ImageRef The image reference (a number returned from the GMImage.New functions) 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"

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.

Feedback: Report problem or ask question.