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:

NameValueDescription
UndefinedOrientation0Unknown
TopLeftOrientation1Line direction: Left to right, Frame Direction: Top to bottom
TopRightOrientation2Line direction: Right to left, Frame Direction: Top to bottom
BottomRightOrientation3Line direction: Right to left, Frame Direction: Bottom to top
BottomLeftOrientation4Line direction: Left to right, Frame Direction: Bottom to top
LeftTopOrientation5Line direction: Top to bottom, Frame Direction: Left to right
RightTopOrientation6Line direction: Top to bottom, Frame Direction: Right to left
RightBottomOrientation7Line direction: Bottom to top, Frame Direction: Right to left
LeftBottomOrientation8Line 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)]

See also

Example Databases

Blog Entries

This function checks for a license.

Created 18th August 2014, last changed 12nd August 2021


GMImage.SetMonochrome - GMImage.SetPage