Resize Method

Description

Resize the image.

Syntax

Visual Basic
Public Sub Resize( _ ByVal PageSize As EPageSize, _ Optional ByVal PageOrientation As EPageOrientation = epgoAuto, _ Optional ByVal ImageAlignment As EImageAlignment = epiaCenter, _ Optional ByVal Width As Double = 8.5, _ Optional ByVal Height As Double = 11, _ Optional ByVal Unit As ESizeUnit = esuInch _ )

Visual Basic

Public Sub Resize( _
   ByVal PageSize As EPageSize, _
   Optional ByVal PageOrientation As EPageOrientation = epgoAuto, _
   Optional ByVal ImageAlignment As EImageAlignment = epiaCenter, _
   Optional ByVal Width As Double = 8.5, _
   Optional ByVal Height As Double = 11, _
   Optional ByVal Unit As ESizeUnit = esuInch _
)

Parameters

PageSize

Value	Description
epgsA4	A4 page size
epgsCustom	Custom image size
epgsImage
epgsLedger	Ledger size
epgsLegal	Legal size
epgsLetter	Letter size
epgsNearest
epgsNearestMetric
epgsNearestStd
epgsOriginal	Image size before image is modified

Image page size after resizing

PageOrientation

Value	Description
epgoAuto	Orientation is determined automatically
epgoLandscape	Use landscape orientation
epgoPortrait	Use portrait orientation

Image orientation after resizing

ImageAlignment

Value	Description
epiaBestFit
epiaBottomCenter
epiaBottomLeft
epiaBottomRight
epiaCenter
epiaLeftCenter
epiaRightCenter
epiaStretch
epiaTopCenter
epiaTopLeft
epiaTopRight

Image alignment after resizing

Width

Image width if PageSize=epgsCustom

Height

Image width if PageSize=epgsCustom

Unit

Value	Description
esuCentimeter
esuInch
esuPixel

Unit of Width and Height parameters

Remarks

Scanning document of standard size often produces images of a slightly different dimension. Some image processing operations, like BorderExtract, AutoCrop, AutoDeskew change size of the image.

Resize method sets of an image to one of:

Predefined size (PageSize, PageOrientation parameters)
Custom size (PageSize = epgsCusom, Width, Height, Unit parameters)
Size of the image when it was open (PageSize = epgsOriginal)

Image data before resizing are:

Placed on the resized image according to ImageAlignment parameter in the center of a new image, one of the corners, or aligned with the center of one of the sides. NOTE: If ImageAlignment is not epiaBestFit and new image size is smaller than original some of original image information will be lost.
Scaled to occupy the maximum area of the resized image (ImageAlignment = epiaBestFit)