Orientation Property

Description:

Gets and sets the orientation with which the image was saved. The two most-often-used orientations are "Portrait" and "Landscape." However, in order to provide complete support for the TIFF file format, which defines eight image orientations, ImageGear interprets eight orientations. This property will return the orientation mode used, as an IG_ORIENT_... constant. For an image with a "Portrait" orientation, this value would normally be IG_ORIENT_TOP_LEFT. For an image with "Landscape" orientation, this value would be either IG_ORIENT_RIGHT_TOP or IG_ORIENT_LEFT_BOTTOM. The full list of constants is defined in enumIGOrientationValues.

Notice that the IG_ORIENT constants contain indicators of two directions. For IG_ORIENT_TOP_LEFT, the first direction is "TOP." This specifies the placement of row 0 of the image. The second direction is "LEFT", and this specifies the placement of column 0. Thus, IG_ORIENT_TOP_LEFT specifies that row 0 of the image stored in the file should be displayed at the top and column 0 should be displayed at the left. This is the normal orientation of most images. On the other hand, IG_ORIENT_LEFT_BOTTOM specifies that row 0 should be displayed at the left and column 0 at the bottom. For this to be True the image would have to be rotated 90 degrees counter clockwise.

The orientation setting of an image is for informational purposes only. This information is stored in the header structure of those file formats that support the storage of orientation information. The orientation setting tells how the image was intended to be displayed.

Property Type:

Read-write property

Return Type:

enumIGOrientationValues Enumeration

Default Value: IG_ORIENT_TOP_LEFT

Valid Values: An enumIGOrientationValues Enumeration value

Bits Per Pixel:

N/A