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


If set, transform image to black and white.

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


Parameter Description Example
ImageRef The image reference number. 1
flag A boolean value. 1


Returns "OK" on success.


If set, transform image to black and white.


Three ways to make a black & white image:

# make black and white with threshold
Set Variable [$r; Value: MBS("GMImage.Threshold";$Image; 127) ]

# mark as monochrome image
Set Variable [$r; Value: MBS("GMImage.SetMonochrome";$Image; 1) ]

# set type to 1 for black/white
Set Variable [$r; Value: MBS("GMImage.SetType";$Image; 1) ]

See also

This function checks for a license.

Created 18th August 2014, last changed 3th February 2023

GMImage.SetModulusDepth - GMImage.SetOrientation