Output(OS_POLYSCANLINE)

WORD Output(LPPDEVICE lpDestDev, WORD wStyle, WORD wCount, 
    LPPOINT lpPoints, LPPPEN lpPPen, LPPBRUSH lpPBrush, 
    LPDRAWMODE lpDrawMode, LPRECT lpClipRect);

Draws a series of horizontal line segments at a specified vertical position. GDI calls this function when simulating output, such as when filling a polygon. Unlike OS_SCANLINES, it is not necessary that every graphics driver support the OS_POLYSCANLINE style.

• Returns 1 if the function is successful, zero otherwise.

lpDestDev

Address of a PDEVICE or PBITMAP structure that specifies the destination device or bitmap.

wStyle

Must be OS_POLYSCANLINE.

wCount

The number of SCAN structures in the array pointed to by the lpPoints parameter.

lpPoints

Address of an array of SCAN structures that contain the information needed to draw the scanlines. The driver must draw every SCAN structure in the array.

lpPPen

Address of a PPEN structure that specifies the physical pen that is used to draw scan lines.

lpPBrush

Address of a PBRUSH structure that specifies the physical brush that is used to draw the scan lines.

lpDrawMode

Address of a DRAWMODE structure that contains information to use when drawing, such as binary-raster operation, background mode, and foreground and background color.

lpClipRect

Address of a RECT structure that contains coordinates for the clipping rectangle. If this parameter is NULL, the clipping rectangle is the entire display surface.

Output draws a scan line from the starting point up to, but not including, the ending point. The function draws all lines with the brush pointed to by lpPBrush, or by the pen pointed to by lpPPen if lpPBrush is NULL. If Output uses the pen to draw the scan lines, it should not dither the pen color.

Vector device drivers need not support OS_POLYSCANLINE. Since OS_SCANLINES and OS_POLYSCANLINE are functionally equivalent, vector devices lose nothing by omitting this support.

See also DRAWMODE, Output(OS_BEGINNSCAN), Output(OS_ENDNSCAN), Output(OS_SCANLINES), PBITMAP, PDEVICE, POINT, RECT, SCAN