deflinestyle(3G)					      deflinestyle(3G)

NAME    [Toc]    [Back]

     deflinestyle - defines a linestyle

C SPECIFICATION    [Toc]    [Back]

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

PARAMETERS    [Toc]    [Back]

     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    [Toc]    [Back]

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

SEE ALSO    [Toc]    [Back]

     defcursor,	defpattern, defrasterfont, getlstyle, lsrepeat,	setlinestyle

NOTES    [Toc]    [Back]

     This routine is available only in immediate mode.

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

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


									PPPPaaaaggggeeee 1111