LEADTOOLS Image File Support (Leadtools.Codecs assembly)
LEAD Technologies, Inc

SizeMode Property






Gets or sets a value that indicates the transformation to use when converting the logical size specified in PageWidth and PageHeight to the final physical raster image size. .NET support WinRT support
Syntax
public CodecsRasterizeDocumentSizeMode SizeMode {get; set;}
'Declaration
 
Public Property SizeMode As CodecsRasterizeDocumentSizeMode
'Usage
 
Dim instance As CodecsRasterizeDocumentLoadOptions
Dim value As CodecsRasterizeDocumentSizeMode
 
instance.SizeMode = value
 
value = instance.SizeMode
public CodecsRasterizeDocumentSizeMode SizeMode {get; set;}
 get_SizeMode();
set_SizeMode(value);
public:
property CodecsRasterizeDocumentSizeMode SizeMode {
   CodecsRasterizeDocumentSizeMode get();
   void set (    CodecsRasterizeDocumentSizeMode value);
}

Property Value

A CodecsRasterizeDocumentSizeMode enumeration member that indicates the transformation to use when converting the logical size specified in PageWidth and PageHeight to the final physical raster image size. Default value is CodecsRasterizeDocumentSizeMode.None.
Remarks

LEADTOOLS provides support for loading a document as a raster image. Document formats such as PDF, XPS, DOC/DOCX(2007/2010), PPT/PPTX(2007/2010), XLS/XLSX(2007/2010), RTF and Text do not contain physical width, height or resolution. It is up to the loader (in this case, the RasterCodecs object) to specify the transformation from logical coordinates to physical pixels through a process called rasterization. For more information, refer to CodecsRasterizeDocumentLoadOptions.

You can use the SizeMode property to specify how to use PageWidth and PageHeight to control the final raster image size. LEADTOOLS will determine the original document size (a value that can be obtained in CodecsDocumentImageInfo.PageWidth and CodecsDocumentImageInfo.PageHeight) and then apply the transformation from this value to determine the final Leadtools.RasterImage width and height as follows:

CodecsRasterizeDocumentLoadOptions.SizeMode Description
CodecsRasterizeDocumentSizeMode.None

Use the original document width and height. No transformation will be performed and CodecsRasterizeDocumentLoadOptions.PageWidth and CodecsRasterizeDocumentLoadOptions.PageHeight are not used.

The final Leadtools.RasterImage will have a width or height value equals to the original document size.

CodecsRasterizeDocumentSizeMode.Fit

Fit the resulting raster image into CodecsRasterizeDocumentLoadOptions.PageWidth and CodecsRasterizeDocumentLoadOptions.PageHeight while maintaining the aspect ratio. If the original document size is smaller than the requested page size, no transformation is performed.

The final Leadtools.RasterImage will have a width or height equal to or less than the requested page width or height but not greater.

CodecsRasterizeDocumentSizeMode.FitAlways

Always fit the resulting raster image into CodecsRasterizeDocumentLoadOptions.PageWidth and CodecsRasterizeDocumentLoadOptions.PageHeight while maintaining the aspect ratio. If the original document size is smaller than the requested page size, then the resulting image is scaled up.

The final Leadtools.RasterImage will have a width or height equal to the requested page width or height. Not less and not greater.

CodecsRasterizeDocumentSizeMode.FitWidth

Fit the resulting raster image width into CodecsRasterizeDocumentLoadOptions.PageWidth while maintaining the aspect ratio. The image height will be calculated based on the transformation and CodecsRasterizeDocumentLoadOptions.PageHeight is not used.

The final Leadtools.RasterImage will have a width equal to the requested page width. The height depends on the original document height.

CodecsRasterizeDocumentSizeMode.Stretch

The resulting raster image width and height will be exactly equal to CodecsRasterizeDocumentLoadOptions.PageWidth and CodecsRasterizeDocumentLoadOptions.PageHeight. The aspect ratio can be different than the original document.

The final Leadtools.RasterImage will have a width and height equal to the requested page width and height.

Example
For an example, refer to CodecsRasterizeDocumentLoadOptions.
Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also

Reference

CodecsRasterizeDocumentLoadOptions Class
CodecsRasterizeDocumentLoadOptions Members
CodecsRasterizeDocumentLoadOptions Class
Implementing PDF Plug in Features
CodecsDocumentImageInfo Class

 

 


Products | Support | Contact Us | Copyright Notices

© 2006-2012 All Rights Reserved. LEAD Technologies, Inc.