genWedge

genWedge ( integer Input, integer Output [, floating Angle =0, floating R1 =minpix,

floating R2 =maxpix, integer G1, integer G2, integer B1, integer B2 ] )

Use this function to generate a gray or color wedge in an image or selection. For a grayscale image the wedge is generated by applying the gradient of intensity between two selected levels. For a color image the RGB interpolation between the boundary colors is used.

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.

Angle

An optional positive floating variable or constant specifying the angle between the gradient line and horizontal. The angle is measured in degrees clockwise.

Default value: 0

R1, R2

Optional floating arguments specifying the levels of red at the beginning and at the end of the wedge respectively. If the input image is of a grayscale type, these parameters define the initial and final gray levels of the wedge. If these parameters are omitted, the function will generate the wedge that covers the full intensity range of the image.

G1, G2

Optional integers specifying the levels of green at the beginning and at the end of the wedge respectively. These parameters are disregarded for a color image.

B1, B2

Optional integers specifying the levels of blue at the beginning and at the end of the wedge respectively. These parameters are disregarded for a color image.

Error flags

ERR_OK

The flag set if successful.

ERR_FAILED

The flag set if failed.

Example

This set of statements creates a 16-bit grayscale image with a 45-degrees wedge:

createIm (1, IM_GRAY16, 512, 512)

genWedge (1, 1, 45)