GPR_$SET_LINE_PATTERN GPR Calls GPR_$SET_LINE_PATTERN
NAME
gpr_$set_line_pattern - specifies the pattern to use in drawing lines.
FORMAT
gpr_$set_line_pattern (repeat_count, pattern, length, status)
DESCRIPTION
This routine specifies the pattern to use in drawing lines.
gpr_$line, gpr_$polyline, and gpr_$multiline use the pattern/style most
recently defined by either gpr_$set_line_pattern or gpr_$set_linestyle.
The actual bits in the integers define the line pattern. You should set
the first bit in the pattern; otherwise, the vectors you draw will not
show the beginning of the line correctly.
Specifying the value of 0 for either repeat or length results in a solid
line.
Within each element of the bit pattern, the bits are used in order of
decreasing significance. This starts with the most significant bit of
entry 1 down to the least significant of entry 4.
Input Parameters
repeat_count
The replication factor for each bit in the pattern. This is a 2-
byte integer. Specifying a value of 0 results in a solid line.
pattern
The bit pattern, left justified, in gpr_$line_pattern_t format.
This is a four-element array of 2-byte integers.
length
The length of the pattern in bits. This is a 2-byte integer in the
range of 0 to 64. Specifying a value of 0 results in a solid line.
Output Parameters
status
Completion status, in status_$t format.
SEE ALSO
gpr_$set_linestyle, gpr_$inq_line_pattern, gpr_$set_draw_pattern.
NOTES
You may also set a line pattern with gpr_$set_linestyle. The pattern is
defined by the parameter gpr_$dotted.
gpr_$set_draw_pattern returns an error if called after
gpr_$set_line_pattern or gpr_$set_linestyle.
Use gpr_$set_draw_pattern to set a draw pattern for all line curve primi-
tives including arcs. gpr_$set_line_pattern sets a line pattern only for
lines and splines.