resize
Top  Previous  Next

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)