DrawStippleLineInt

Draws a stippled, single pixel wide line with integer coordinates.

Declaration

void NAPI GA_2DRenderFuncs::DrawStippleLineInt(
N_int32 x1,
N_int32 y1,
N_int32 x2,
N_int32 y2,
N_int32 drawLast,
N_int32 transparent)

Prototype In

snap/graphics.h

Parameters

x1 | X1 coordinate
y1 | Y1 coordinate
x2 | X2 coordinate
y2 | Y2 coordinate
drawLast | 1 to draw last pixel, 0 to skip it
transparent | 1 if the line is transparent, 0 if opaque

Description

This function renders a stippled line at the specified location and the currently active colors, mix and stipple pattern. This routine will render a line from (x1,y1) to (x2,y2) inclusive. If the drawLast parameter is set, the last pixel in the line (x2,y2) will be drawn, otherwise it will be skipped. This feature allows multiple lines to be linked together as a polyline for CAD style operations while drawing in XOR mode (and is also required for compatibility with Microsoft Windows).

If the transparent parameter is set to 1, where a bit is 0 in the stipple pattern the destination pixel remains untouched. If the transparent parameter is set to 0, 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.

See Also

GA_2DRenderFuncs_DrawBresenhamStippleLine, DrawLineInt, SetLineStipple, SetLineStippleCount

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