deflinestyle(3G) 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.
Page 1