MaintainAspectRatio Property

Summary

Gets or sets a value which indicates whether the aspect ratio of the image should be maintained when creating the thumbnail.

Syntax

Objective-C

C++/CLI

Java

Python

public bool MaintainAspectRatio { get; set; }

@property (nonatomic, assign) BOOL maintainAspectRatio;

public boolean getMaintainAspectRatio() 
public void setMaintainAspectRatio(boolean value)

public: 
property bool MaintainAspectRatio { 
   bool get(); 
   void set (    bool ); 
}

MaintainAspectRatio # get and set (CodecsThumbnailOptions)

Property Value

Value	Description
true	To keep the aspect ratio of the image when creating the thumbnail.
false	To not keep the aspect ratio of the image when creating the thumbnail. The default value is false.

Remarks

When set to true, the generated thumbnail's width and height will not match both Width and Height if the original aspect ratio was not 1:1.

If you desire the thumbnail be generated with exactly the requested width and height while still maintaining the aspect ratio of the actual image, set both MaintainAspectRatio and ForceSize to true.

Example

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing; 
using Leadtools.ImageProcessing.Color; 
using Leadtools.Svg; 
 
 
public void ReadThumbnailExample() 
{ 
   RasterCodecs codecs = new RasterCodecs(); 
 
   string srcFileName = Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp"); 
 
   // Create a thumbnail with default options 
   CodecsThumbnailOptions options = CodecsThumbnailOptions.Default; 
   options.LoadStamp = false; 
   RasterImage thumbnail = codecs.ReadThumbnail(srcFileName, options, 1); 
 
   Debug.WriteLine("Thumbnail with default option:"); 
   Debug.WriteLine("  Size: {0} by {1} pixels. Bits/Pixel: {2}", thumbnail.Width, thumbnail.Height, thumbnail.BitsPerPixel); 
   thumbnail.Dispose(); 
 
   // Create a thumbnail with some options 
   options.LoadStamp = false; 
   options.Width = 40; 
   options.Height = 80; 
   options.ForceSize = true; 
   options.MaintainAspectRatio = false; 
   options.BackColor = RasterColor.FromKnownColor(RasterKnownColor.LightBlue); 
   options.BitsPerPixel = 8; 
   options.DitheringMethod = RasterDitheringMethod.None; 
   options.Order = RasterByteOrder.Rgb; 
   options.PaletteFlags = ColorResolutionCommandPaletteFlags.None; 
   options.Resample = false; 
   thumbnail = codecs.ReadThumbnail(srcFileName, options, 1); 
 
   Debug.WriteLine("Thumbnail with set option (size: {0} by {1}, Bits/Pixel: {2}, ForeSize: {3}", 
      options.Width, options.Height, options.BitsPerPixel, options.ForceSize); 
   Debug.WriteLine("  Size: {0} by {1} pixels. Bits/Pixel: {2}", thumbnail.Width, thumbnail.Height, thumbnail.BitsPerPixel); 
   thumbnail.Dispose(); 
 
   codecs.Dispose(); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS22\Resources\Images"; 
}

Requirements

Target Platforms

Reference

CodecsThumbnailOptions Structure

CodecsThumbnailOptions Members

Download our FREE evaluation

Help Version 22.0.2023.5.5

Leadtools.Codecs Assembly

Introduction

Getting Started

Namespaces

Leadtools.Codecs Namespace

Assemblies