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

GMImage.GetEXIFOrientation

Queries orientation from EXIF.

Component Version macOS Windows Linux Server iOS SDK
GraphicsMagick 6.5 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "GMImage.GetEXIFOrientation"; ImageRef )   More

Parameters

Parameter Description Example
ImageRef The image reference number. 1

Result

Returns value or error.

Description

Queries orientation from EXIF.
Returns number from 0 to 8 depending on rotation.
This function can only read orientation, if there is an EXIF block in image.

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

Examples

Shows EXIF orientation:

Set Variable [ $image ; Value: MBS("GMImage.NewFromFile"; "/Users/cs/Desktop/image4.png") ]
Set Variable [ $value ; Value: MBS("GMImage.GetEXIFOrientation"; $image) ]
Show Custom Dialog [ "Orientation in EXIF" ; $value ]
Set Variable [ $r ; Value: MBS("GMImage.Release"; $image) ]

See also

Blog Entries

This function checks for a license.

Created 30th November 2016, last changed 17th September 2020


GMImage.GetDepth - GMImage.GetEndian