SetLineStipple

Sets the current 16-bit line stipple pattern.

Declaration

void NAPI GA_2DStateFuncs::SetLineStipple(
    GA_stipple stipple)

Prototype In

snap/graphics.h

Parameters

stipple

New 16-bit line stipple pattern to set

 

Description

This function sets up a 16-bit line stipple for all subsequent stippled line drawing functions. In the stipple, pixel 0 corresponds to bit 0, pixel 1 = bit 1, ... pixel 15 = bit 15 etc. If the stippled line is drawn in transparent mode, where a bit is 0 in the stipple pattern the destination pixel remains untouched. If the stipple line is drawin in opaque mode, where a bit is 0 in the stipple pattern the destination pixel is drawn in the background color. In all cases where a bit in the stipple pattern is 1, the pixel is drawn in the foreground color.

Note:    When a new stipple pattern is downloaded, the line stipple count is reset back to 0.

See Also

SetLineStippleCount, SetLineStyle, DrawStippleLineInt, GA_2DRenderFuncs_DrawBresenhamStippleLine

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