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

GMImage.Modulate

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

Component Version macOS Windows Linux Server iOS SDK
GraphicsMagick 2.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "GMImage.Modulate"; ImageRef; brightness; saturation; hue )   More

Parameters

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

Result

Returns "OK" on success.

Description

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).

Examples

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);

Modulate an image:

Set Variable [ $image ; Value: MBS("GMImage.NewFromContainer"; MyTable::InputImage) ]
Set Variable [ $r ; Value: MBS ("GMImage.Modulate" ; $image ; 150 ; 150 ; 150 ) ]
Set Field [ MyTable::Brightened ; MBS("GMImage.WriteToJPEGContainer";$image) ]
Set Variable [ $r ; Value: MBS("GMImage.Release"; $image) ]

See also

Blog Entries

This function checks for a license.

Created 18th August 2014, last changed 26th April 2019


GMImage.Minify - GMImage.MontageGeometry