deflinestyle(3G)

NAME
     deflinestyle - defines a linestyle

C SPECIFICATION
     void deflinestyle(n, ls)
     short n;
     Linestyle ls;

PARAMETERS
     n    expects the constant that you want to use as an identifier for the
          linestyle described by ls. This constant is used as an index into a
          table of linestyles. By default, index 0 contains the pattern
          0xFFFF, which draws solid lines and cannot be redefined.

     ls   expects a 16-bit pattern to use as a linestyle.  This pattern is
          stored in the linestyle table at index n. You can define up to 65536
          distinct linestyles.

DESCRIPTION
     deflinestyle defines a linestyle that is a write-enabled pattern applied
     when lines are drawn.  The least-significant bit of the linestyle is ap-
     plied first. Use setlinestyle to select a linestyle for use.  The select-
     ed linestyle is sometimes referred to as the current linestyle.

SEE ALSO
     defcursor, defpattern, defrasterfont, getlstyle, lsrepeat, setlinestyle

NOTES
     This routine is available only in immediate mode.

     On the Personal Iris, there is a performance penalty for drawing non-
     solid lines; there is no penalty on the other IRIS-4D models.

     When deflinestyle is used to modify the current linestyle, the new lines-
     tyle becomes current only when setlinestyle is called again.