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
