genGrid

genGrid ( integer Input, integer Output, integer Sx, integer Sy [, floating Angle =0 ,

integer Width =1, integer Blend =100 , floating R =maxpix, integer G =R, integer B =R ] )

Use this function to superimpose a rectangular grid on an image or selection. You can adjust the grid spacing and the angle at which it is positioned.

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.

Sx, Sy

Positive integers specifying the horizontal and vertical size of the grid cells in pixels.

Angle

A positive floating variable or constant specifying the angle between the grid lines and horizontal. The angle is measured in degrees clockwise.

Default value: 0

Width

A positive integer specifying the width of the grid lines in pixels.

Default value: 1

Blend

A integer between 1 and 100 specifying the percentage at which the grid lines will be blended with underlying pixels.

Default value: 100

R

An optional floating argument specifying the level of red for the grid lines. If the input image is of a grayscale type, this parameter defines the gray level of the grid. If this parameter is omitted, the grid will be assigned the maximum intensity permitted for the given image type.

G, B

Optional integers specifying the levels of green and blue for the grid lines. These parameters are disregarded for a color image.

Default values: same as R

Example

This set of statements superimposes a transparent red grid on a sample image:

setCurDir("samples")

loadIm (1,"sample14.iwd")

genGrid (1, 1, 40, 30, 0, 3, 30, 255, 0, 0)