2.6.5.4 imgResize

1 Menu Information
2 Brief Information
3 Command Line Usage
4 X-Function Execution Options
5 Variables
6 Description
7 Examples
8 Algorithm
9 References
10 Related X-Functions

Menu Information

Resize

Brief Information

Resize image

Command Line Usage

1. imgResize lock:=1 unit:=pixel w:=50;

2. imgResize lock:=1 unit:=percent h:=120 interpolate:=resample;

3. imgResize lock:=0 w:=120 h:=130 interpolate:=normal img:=mat(1) oimg:=mat(2);

X-Function Execution Options

Please refer to the page for additional option switches when accessing the x-function from script

Variables

Display Name	Variable Name	I/O and Type	Default Value	Description
Lock Proportions	lock	Input int	1	Specifies whether or not to keep the aspect ratio of the original image.
Unit	unit	Input int	percent	This variable works with two other variables, w and h. It specifies the units for them. Option list pixel:Pixel The width (w) and height (h) of the output image are measured in pixels. percent :Percent The width (w) and height (h) of the output image are measured in percentage of the width and height of the input image.
Width	w	Input/Output double		Specifies the width of the output image.
Height	h	Input/Output double		Specifies the height of the output image.
Input Matrix	img	Input Image	<active>	Specifies the source image to be manipulated. The default input is the active image.
Output Image	oimg	Output Image	<input>	Specifies the output image. By default, it is the same as the input image. See the syntax here.
Interpolation	interpolate	Input int	normal	Specifies the interpolation method which is used when the image is resized. Option list normal:Normal Uses nearest neighbor interpolation to produce the resized image. resample:Resample Uses bilinear interpolation and averaging to produce a higher-quality image. bicubic :Bicubic Uses bicubic interpolation and averaging to produce a higher quality image. This method is slower than Resample.

Description

This X-Function can be used to resize the input image to any size.

Examples

In this example, we use the imgResize function to resize the input image. We change its width to 300 pixels and its height to 200 pixels:

1. Create a new matrix and import car.bmp under \Samples\Image Processing and Analysis folder into it.

2. From the Origin menu, select Matrix: Set Dimensions. We can see the dimension of the image is 500*375.

ImgResize help English files image002.jpg

Click Cancel to close the dialog.

3. Make the input image is active and select Image: Geometric Transform: Resize. This opens the dialog of the imgResize X-Function.

4. In the imgResize X-Function dialog, change the settings as the screenshot below and click OK to close the dialog.

ImgResize help English files image004.jpg

A new image is created.

5. When the new image is active, choose Matrix: Set Dimensions from the Origin menu to view the dimension of this image.

ImgResize help English files image006.jpg


The original image	The output image

Algorithm

The resizing is implemented with L_SizeBitmap() function from LEADTOOLS Main API. Please refer to the LEADTOOLS Main API Help file, Version 14 and read the L_SizeBitmap topic.