DRAW

Function

Draws an object.

Syntax

DRAW {position}
TYPE={type_lit_|_var|_col}
[HEIGHT={height_lit_|_var|_col}]
[WIDTH={width_lit_|_var|_col}]
[RULE={rule_lit_|_var|_col}]
[FILL-COLOR=({color_name_lit|_var|_col}|{rgb})]
[LINE-COLOR= {color_name_lit|_var|_col}|{rgb})]
[CAP={cap_lit_|_var|_col}]
[LINE-STYLE={line_style_lit_|_var|_col}]
[END-POINT=(row_lit_|_var|_col, column_lit_|_var|_col)]

Arguments

position

Starting position of the object.

TYPE

Type of object to draw. The value can be BOX,HORZ-LINE, VERT-LINE,LINE,or OVAL. (LINE and OVAL are not supported with –PRINTER:LP, –PRINTER:HP, or PRINTER:PS.)

HEIGHT

Object’s vertical length. Applies to BOX, VERT-LINE, and OVAL.

WIDTH

Object’s horizontal length. Applies to BOX, HORZ-LINE, and OVAL.

RULE

Line thickness. Applies to BOX, HORZ-LINE, VERT-LINE, LINE, and OVAL. This value is expressed in decipoints. (There are 720 decipoints per inch.) The default value is two decipoints.

FILL-COLOR

Color used to fill the object. Applies to BOX and OVAL. The default value is the FILL COLOR value in SET-COLOR.

LINE-COLOR

Color of the lines in the object. Applies to BOX, HORZ-LINE, VERT-LINE, LINE, and OVAL. The default value is the LINE COLOR value in SET-COLOR.

CAP

Type of cap used with an object. Applies to BOX, HORZ-LINE, VERT‑LINE, and LINE. BOX CAP values can ROUND, BEVEL, or MITER HORZ-LINE, VERT-LINE, and LINE CAP values can be ROUND, SQUARE, or FLAT.

Note:

CAP settings are ignored with -PRINTER:HT and -PRINTER:EH. When using -PRINTER:WP, MITER is substituted for BEVEL. CAP is ignored unless the LINE-SYTLE is set to SOLID.

LINE-STYLE

Line style of the object. Applies to HORZ-LINE, VERT-LINE, LINE, BOX, and OVAL.

Table 39. LINE-STYLE Values

Line StyleValue

SOLID

The image shows and example of a solid line.

SQUARE-DOT

The image shows an example of the square dot line style.

DASH

The image shows an example of a dash line style.

DASH-DOT

The image shows an example of a dash dot line styel.

LONG-DASH

The image shows an example of a long dash line style.

LONG-DASH-DOT

The image shows an example of a long dash dot line style.

LONG-DASH-DOT-DOT

The image shows an example of a long dash dot dot line style.

Note:

LINE STYLE settings are ignored with –PRINTER:LP, –PRINTER:HP, or PRINTER:PS. If you use one of these flags, the default value of SOLID is applied to the line.

END-POINT

The object’s ending coordinate. Applies to LINE.

Description

Draws the specified object on the page. For horizontal lines (TYPE=HORZ-LINE), the line is drawn just below the base of the line. For vertical lines (TYPE=VERT-LINE), the line is drawn just below the base of the starting line position to just below the base of the ending line position. After DRAW executes, Production Reporting changes the current print location to the starting location of the object. (This is different from the way PRINT works.)

Examples

Draw a wide box around the page:

DRAW (1,1) TYPE='BOX' WIDTH=78 HEIGHT=66 RULE=20

Draw a five-line shaded box without a border:

DRAW (1,1) TYPE='BOX' WIDTH=66 HEIGHT=5 RULE=0 FILL COLOR=(204,204,204)

Draw a line under the page heading:

DRAW (1,1) TYPE='HORZ LINE' WIDTH=66 RULE=10

Redline the paragraph:

DRAW (+3,+2) TYPE='VERT LINE' HEIGHT=4 RULE=6

Draw a blue circle with a red border (assumes that the layout line height and character width are the same value)

DRAW (1,1) TYPE='OVAL' HEIGHT=10 WIDTH=10 RULE=20 FILL COLOR=(’BLUE’) LINE COLOR=('RED')

Draw a box using a dashed line

DRAW (1,1) TYPE='BOX' WIDTH=78 HEIGHT=66 RULE=20 LINE STYLE='DASH'

See Also

GET-COLOR, PRINT, and SET-COLOR