GPR_$SET_DRAW_PATTERN             GPR Calls              GPR_$SET_DRAW_PATTERN


NAME
     gpr_$set_draw_pattern - specifies the line pattern for lines and curves.

FORMAT
     gpr_$set_draw_pattern (repeat_count, pattern, length, status)

DESCRIPTION
     This routine specifies the line pattern to use in drawing all line and
     curve primitives.

     All line and curve primitives use the pattern/style most recently defined
     by gpr_$set_draw_pattern.  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 bit 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_$inq_draw_pattern, gpr_$inq_line_pattern.

NOTES
     You may set a line pattern with gpr_$set_linestyle or
     gpr_$set_line_pattern; however, once you have used gpr_$set_draw_pattern
     to set a line pattern, you must continue to use gpr_$set_draw_pattern to
     set line patterns.  Any subsequent calls to gpr_$set_linestyle or
     gpr_$set_line_pattern results in an error.

     gpr_$set_linestyle and gpr_$set_line_pattern sets a line pattern only for
     lines and splines: the line pattern does not affect other curved primi-
     tives.

     gpr_$inq_line_pattern returns an error if the draw pattern was set with
     gpr_$draw_pattern.

     You cannot set the line pattern for arcs if your application sets a line
     pattern with gpr_$set_line_pattern.