| Components | All | New | MacOS | Windows | Linux | iOS | ||||
| Examples | Mac & Win | Server | Client | Guides | Statistic | FMM | Blog | Deprecated | Old | |
GMImage.SetOrientation
Sets the image orientation.
| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
| GraphicsMagick | 2.0 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |
MBS( "GMImage.SetOrientation"; ImageRef; Orientation ) More
Parameters
| Parameter | Description | Example |
|---|---|---|
| ImageRef | The image reference number. | 1 |
| Orientation | The orientation value. | 1 |
Result
Returns "OK" on success.
Description
Sets the image orientation.Possible values:
| Name | Value | Description |
|---|---|---|
| UndefinedOrientation | 0 | Unknown |
| TopLeftOrientation | 1 | Line direction: Left to right, Frame Direction: Top to bottom |
| TopRightOrientation | 2 | Line direction: Right to left, Frame Direction: Top to bottom |
| BottomRightOrientation | 3 | Line direction: Right to left, Frame Direction: Bottom to top |
| BottomLeftOrientation | 4 | Line direction: Left to right, Frame Direction: Bottom to top |
| LeftTopOrientation | 5 | Line direction: Top to bottom, Frame Direction: Left to right |
| RightTopOrientation | 6 | Line direction: Top to bottom, Frame Direction: Right to left |
| RightBottomOrientation | 7 | Line direction: Bottom to top, Frame Direction: Right to left |
| LeftBottomOrientation | 8 | Line direction: Bottom to top, Frame Direction: Left to right |
See also GMImage.AutoOrient.
Examples
Set orientation
#load a picture
Set Variable [$image; Value:MBS( "GMImage.NewFromContainer"; Test::BigImage)]
# Set orientation to 1
Set Variable [$r; Value:MBS( "GMImage.SetOrientation"; $image; 1)]
#write back to container
Set Field [Test::Result; MBS( "GMImage.WriteToPNGContainer"; $image;)]
#cleanup
Set Variable [$Error; Value:MBS("GMImage.Release";$image)]
Set Variable [$image; Value:MBS( "GMImage.NewFromContainer"; Test::BigImage)]
# Set orientation to 1
Set Variable [$r; Value:MBS( "GMImage.SetOrientation"; $image; 1)]
#write back to container
Set Field [Test::Result; MBS( "GMImage.WriteToPNGContainer"; $image;)]
#cleanup
Set Variable [$Error; Value:MBS("GMImage.Release";$image)]
See also
- GMImage.AutoOrient
- GMImage.GetEXIFOrientation
- GMImage.GetOrientation
- GMImage.New
- GMImage.NewFromContainer
- GMImage.Release
- GMImage.SetEXIFOrientation
- GMImage.WriteToPNGContainer
Example Databases
Blog Entries
This function checks for a license.
Created 18th August 2014, last changed 12nd August 2021
