align

align ( integer Input, integer Output, floating Ix1, integerIy1, floating Ix2, integerIy2,
floating Ix3, integerIy3, floating Ix4, integerIy4, floating Ix1, integerIy1,
floating Rx1, integer Ry1, floating Rx2, integerRy2, floating Rx3, integerRy3,
floating Rx4, integerRy4 )

Use this function to align one image with another by defining a set of fiducial points.

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.

Ix1, Iy1, Ix2, Iy2, Ix3, Iy3, Ix4, Iy4

Floating variables or constants specifying the coordinates of four points in the input image to be aligned with the corresponding points in a reference image. The coordinates are given in pixels.

Rx1, Ry1, Rx2, Ry2, Rx3, Ry3, Rx4, Ry4

Floating variables or constants specifying the coordinates of four points in the reference image with which the input image has to be aligned. The coordinates are given in pixels.

Error flags

ERR_OK

The flag set if successful.

ERR_FAILED

The flag set if failed.

Example

align (1, 2, 10, 10, 300, 10, 10, 300, 300, 300

28, 47, 400, 30, 15, 360, 347, 280)