Topics
All
MacOS
(Only)
Windows
(Only)
Linux
(Only, Not)
iOS
(Only, Not)
Components
Crossplatform Mac & Win
Server
Client
Old
Deprecated
Guides
Examples
Videos
New in version:
11.4
11.5
12.0
12.1
12.2
12.3
12.4
12.5
13.0
13.1
Statistic
FMM
Blog
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 |
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 paid license.
Created 18th August 2014, last changed 26th April 2019
