Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Guides   Examples
New in version: 7.0   7.1   7.2   7.3   7.4   7.5   8.0   8.1   8.2   8.3    Statistic  


Modulate percent hue, saturation, and brightness of an image.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
GraphicsMagick 2.0 Yes Yes Yes Yes Yes

MBS( "GMImage.Modulate"; ImageRef; brightness; saturation; hue )


Parameter Description Example value
ImageRef The image reference number. 1
brightness The brightness value. 100
saturation The saturation value. 0
hue The hue value. 100


Returns "OK" on success.


Modulate percent hue, saturation, and brightness of an image.
Modulation of saturation and brightness is as a ratio of the current value (100 for no change). Modulation of hue is an absolute rotation of -180 degrees to +180 degrees from the current position corresponding to an argument range of 0 to 200 (100 for no change).


Increase brightness:

MBS("GMImage.Modulate"; $Image; 110; 100; 100);

Increase saturation:

MBS("GMImage.Modulate"; $Image; 100; 110; 100);

Increase hue:

MBS("GMImage.Modulate"; $Image; 100; 100; 110);

See also

GMImage.Minify   -   GMImage.MontageGeometry

Feedback: Report problem or ask question.

MBS Xojo Chart Plugins