ExifOrientationMode Enum
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Specifies the EXIF orientation flag behavior when obtaining pixel data.
public enum class ExifOrientationMode/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class ExifOrientationMode[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum ExifOrientationModevar value = Windows.Graphics.Imaging.ExifOrientationMode.ignoreExifOrientationPublic Enum ExifOrientationMode- Inheritance
-
ExifOrientationMode
- Attributes
Windows requirements
| Device family |
Windows 10 (introduced in 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduced in v1.0)
|
Fields
| Name | Value | Description |
|---|---|---|
| IgnoreExifOrientation | 0 | The EXIF orientation flag is ignored. No rotation or flip operations are performed. |
| RespectExifOrientation | 1 | If the image frame contains a valid EXIF orientation flag, the specified rotation and/or flip operations are performed on the pixel data. |
Remarks
Some image formats, including JPEG, TIFF, and JPEG-XR, support EXIF orientation metadata. This metadata specifies a flip and/or rotation operation that should be applied to the raw image data so it is oriented correctly. You can read the EXIF orientation metadata and apply the corresponding transform yourself, or you can use this enumeration to automatically determine and apply the correct transform.
If you specify RespectExifOrientation, the resulting orientation operation is combined with any flip and rotation operations that you have specified using BitmapTransform.
For example, you call BitmapDecoder.GetPixelDataAsync using RespectExifOrientation and a BitmapRotation value of Clockwise90Degrees, and the particular image being decoded has an EXIF orientation flag specifying a counterclockwise 90 degree rotation. In this example, the ExifOrientationMode and BitmapRotation options are added together for a net rotation of 180 degrees clockwise.
In addition, if you specify RespectExifOrientation along with a clip using BitmapTransform.Bounds, the bounding rectangle must take into account the change in coordinate space from the EXIF orientation operation. You can obtain the full image size after EXIF orientation is applied by using OrientedPixelWidth and OrientedPixelHeight.