copySelect

copySelect (integer Input, integer Output [, integer Left =-1, integer Top =-1 ] )

Use this function to copy a selection (region of interest) from one image to another.

Parameters

Input

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

Output

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

Left, Top

Optional integers specifying the coordinates of the top left corner of the bounding rectangle of the selection in the output image. The values should be given in pixels. If these parameters are set to –1 or omitted, the coordinates of the selection in the output image will match the coordinates of the original selection in the input image.

Default values: -1

Error flags

ERR_OK

The flag set if successful.

ERR_FAILED

The flag set if failed.

Example

The following set of statements creates a rectangular selection in image #1 and copies it into image #2:

setCurDir("samples")

loadIm (1,"sample14.iwd")

setSelect (1,SH_RECT,SEL_NEW, 20, 20, 300, 200)

grabim(2)

copySelect (1,2)