TcxCustomImageProperties.ExifAutoRotation Property

Specifies if the image editor rotates an image based on EXIF metadata.

Declaration

property ExifAutoRotation: TdxDefaultBoolean read; write; default bDefault;

Property Value

Type	Default	Description
TdxDefaultBoolean	bDefault	If bDefault, the TdxGPImage.DefaultImageExifAutoRotation class property value defines if the image editor rotates an image based on EXIF metadata. If bTrue, the editor always rotates the displayed image if its rotation angle is defined in EXIF metadata. If bFalse, the editor always ignores the displayed image’s rotation angle defined in EXIF metadata.

Remarks

In addition to ancillary tags and device-related settings, EXIF metadata can include information on effects and transformations applied to an image. DevExpress image editors^[1] and containers can automatically apply an image rotation angle defined in EXIF metadata. The applied rotation angle does not affect the source image.

You can set the ExifAutoRotation property to bTrue or bFalse to explicitly enable or disable automatic image rotation based on EXIF metadata.

Code Example: Disable EXIF Image Rotation Globally

The following code example disables the global EXIF image rotation setting:

Delphi

uses
  dxGDIPlusClasses;
// ...
  TdxGPImage.DefaultImageExifAutoRotation := False;

C++

#include "dxGDIPlusClasses.hpp"
// ...
  TdxGPImage::DefaultImageExifAutoRotation = false;

Default Value

The ExifAutoRotation property’s default value is bDefault.

The default ExifAutoRotation property value indicates that the TdxGPImage.DefaultImageExifAutoRotation class property determines if the image editor rotates an image whose EXIF metadata defines a rotation angle.

Footnotes

1. The TcxImage editor supports EXIF image rotation when used as a standalone editor or as an in-place editor in Data Grid, Tree List, Vertical Grid, and Pivot Grid controls.