resize

resize ( integer Input, integer Output, integer Width, integer Height
[, integer Mode =1, integer Units =0 ] )

Use this function to resize an image or selection.

Parameters

Input

An integer between 0 and 116 specifying the input image frame number. A value of 0 represents the DMA memory buffer of the video device. Values in the range of 100-116 correspond to hidden frames.

Output

An integer between 1 and 116 specifying the output image frame number. Values in the range of 100-116 correspond to hidden frames.

Width

A positive integer specifying the width of the output image in pixels or as a percentage of the width of the input image or selection as indicated by the Unit parameter.

Height

A positive integer specifying the height of the output image in pixels or as a percentage of the height of the input image or selection as indicated by the Unit parameter.

Mode

An optional enumerated integer that describes the interpolation mode to use. Must be one of the following values:

M_NONE=0 – no interpolation is performed. Missing pixels will be substituted with the adjacent pixels.

M_BILINEAR=1 – calculate the values of missing pixels by performing bilinear interpolation of the adjacent pixels in the process of image resampling.

Default value: M_BILINEAR

Unit

An optional enumerated integer that describes the units in which the Width and Height are given. Must be one of the following values:

U_PIXEL=0 – Width and Height contain the actual pixel dimensions of the output image.

U_PERCENT=1 – Width and Height contain are given in percents to the pixel dimensions of the input image.

Default value: U_PIXEL

Error flags

ERR_OK

The flag set if successful.

ERR_FAILED

The flag set if failed.

Example

The following operator will resize an image to 65% of its original size using bilinear interpolation:

resize (1, 2, 65, 65, M_BILINEAR, U_PERCENT)