DrawClippedStippleLineInt
Draws a stippled, single pixel wide line with integer coordinates.
Declaration
N_int32 NAPI GA_2DRenderFuncs::DrawClippedStippleLineInt(
N_int32 x1,
N_int32 y1,
N_int32 x2,
N_int32 y2,
N_int32 drawLast,
N_int32 transparent,
N_int32 clipLeft,
N_int32 clipTop,
N_int32 clipRight,
N_int32 clipBottom)
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 |
clipLeft |
Left coordinate for clip rectangle (inclusive) |
clipTop |
Top coordinate for clip rectangle (inclusive) |
clipRight |
Right coordinate for clip rectangle (exclusive) |
clipBottom |
Bottom coordinate for clip rectangle (exclusive) |
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.
The output is clipped against the passed in clipping rectangle.
See Also
GA_2DRenderFuncs_DrawClippedBresenhamStippleLine, DrawClippedLineInt, SetLineStipple, SetLineStippleCount
Copyright © 2002 SciTech Software, Inc. Visit our web site at http://www.scitechsoft.com