MGL_setLineStipple

Set the current line stipple pattern.

Declaration

void MGLAPI MGL_setLineStipple(
    ushort stipple)

Prototype In

mgraph.h

Parameters

stipple

New 16 - bit stipple pattern to set.

 

Description

Sets the current line stipple pattern. The line stipple pattern is used to determine which pixels in the line get drawn depending on which bits in the pattern are set. The stipple pattern is a 16-bit value, and everywhere that a bit is set to a 1 in the pattern, a pixel will be drawn in the line. Everywhere that a bit is a 0, the pixel will be skipped in the line. Note that bit 0 in the stipple pattern corresponds to pixel 0,16,32,... in the line, bit 1 is pixel 1,17,33 etc. To create a line that is drawn as a 'dot dot dash dash' you would use the following value:

0011100111001001b or 0x39C9

Note that to enable stippled line mode you must call MGL_setLineStyle, with the MGL_LINE_STIPPLE parameter. Also note that stippled lines can only be 1 pixel wide, and the pen size will be ignored when drawing a stippled line.

See Also

MGL_setLineStyle, MGL_setLineStippleCount, MGL_getLineStipple

Copyright © 2002 SciTech Software, Inc. Visit our web site at http://www.scitechsoft.com