get_enableDpiCorrection();
set_enableDpiCorrection(value);
Object.defineProperty('enableDpiCorrection');
Type | Description |
---|---|
boolean | true if the viewer should view images with non-uniform DPI with the correct aspect ratio; otherwise, it is false. Default value is true. |
Changing the value of this property will fire the PropertyChanged and TransformChanged events.
When you set a new image in the viewer, you can also set the image resolution (DPI) into the ImageDpiX and ImageDpiY values. Some images such as FAX documents might have different values for horizontal and vertical resolution done mainly to compress the image during transfer. For example, a FAX TIF image might have 300 as the horizontal resolution and only 150 for the vertical. This image has an aspect ratio of 2/1.
When you set these values in ImageViewer, the image will be displayed squished vertically, since the image contains half the number of scanlines in the vertical direction. Document viewers will usually compensate for that by scaling the display transformation by 2 in the Y direction to correct the aspect ratio back to 1.
When you set EnableDpiCorrection to true, the ImageViewer control will do exactly that and the image will be displayed in the correct aspect ratio.