AspectRatioCorrection Property

Summary

Manual aspect ratio correction value

Syntax

C++

public virtual double AspectRatioCorrection { get; set; }

Public Overridable Property AspectRatioCorrection() As Double 
   Get 
   Set

public:  
   virtual property double AspectRatioCorrection 
   { 
      double get() 
      void set(double value) 
   }

Property Value

The manual aspect ratio correction value. Default value is 1.

Remarks

Changing the value of this property will fire the PropertyChanged and TransformChanged events.

When displaying images, sometimes it is necessary to set a manual aspect ratio correction to compensate for irregular screen resolution (pixel size). For example, if you display an image that is 100 by 100 pixels on most monitors, the image will not be an exact square on screen because most monitors have pixels that are rectangular in shape. Setting the AspectRatioCorrection value can fix this issue.

The AspectRatioCorrection is multiplied by the current vertical scale factor of the control YScaleFactor at all times regardless of the SizeMode value.

Example

This example shows the effect changing AspectRatioCorrection have on how the image is displayed.

Run the demo, now as you click the Example button, the aspect ratio alternates between 1, 2 and 0.5

Start with the ImageViewer example, remove all the code inside the example function (search for the "// TODO: add example code here" comment) and insert the following code:

using Leadtools; 
using Leadtools.Controls; 
using Leadtools.Codecs; 
using Leadtools.Drawing; 
using LeadtoolsExamples.Common; 
using Leadtools.ImageProcessing; 
using Leadtools.ImageProcessing.Color; 
 
MessageBox.Show("Current _imageViewer.AspectRatioCorrection is " + _imageViewer.AspectRatioCorrection); 
// Now, change the AspectRatioCorrection to the default 
_imageViewer.AspectRatioCorrection = 1;

Imports Leadtools 
Imports Leadtools.Controls 
Imports Leadtools.Codecs 
Imports Leadtools.Drawing 
Imports Leadtools.ImageProcessing 
Imports Leadtools.ImageProcessing.Color 
Imports LeadtoolsControlsExamples.LeadtoolsExamples.Common 
 
Public Sub ImageViewerAspectRatioCorrection_Example() 
   MessageBox.Show("Current _imageViewer.AspectRatioCorrection is " & _imageViewer.AspectRatioCorrection) 
   ' Now, change the AspectRatioCorrection to the default 
   _imageViewer.AspectRatioCorrection = 1 
End Sub

Requirements

Target Platforms

Reference

ImageViewer Class

ImageViewer Members

Leadtools.Controls Namespace

Download our FREE evaluation

Help Version 20.0.2020.4.3

Leadtools.Controls Assembly

Introduction

Getting Started

Namespaces

Leadtools.Controls Namespace

Assemblies