Output(OS_SCANLINES)

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

The OS_SCANLINES style specifies that the Output function draws a series of horizontal line segments at a specified vertical position. GDI calls this function when simulating output such as filling a polygon.

Every graphics driver should support the OS_SCANLINES style.

Parameters

lpDestDev

Points to a PDEVICE or PBITMAP structure specifying the destination device or bitmap.

wCount

Specifies the number of POINT structures in the array pointed to by the lpPoints parameter.

lpPoints

Points to an array of POINT structures containing the scan line coordinates. The y member in the first POINT structure specifies the y-coordinate to draw the scan lines. In each subsequent structure, the x member specifies the x-coordinate of a scan line's starting point and the y member specifies the x-coordinate of the ending point.

lpPPen

Points to a PPEN structure specifying the physical pen to draw scan lines.

lpPBrush

Points to a PBRUSH structure specifying the physical brush to draw the scan lines.

lpDrawMode

Points to a DRAWMODE structure containing information to use when drawing, such as binary-raster operation, background mode, and foreground and background color.

lpClipRect

Points to a RECT structure containing coordinates for the clipping rectangle. If the lpClipRect parameter is NULL, the clipping rectangle is the entire display surface.

Return Value

The return value is 1 if the function is successful. Otherwise, it is zero if the function encounters an unrecoverable error.

Comments

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 the lpPBrush parameter, or by the pen pointed to by the lpPPen parameter if lpPBrush is NULL. If Output uses the pen to draw the scan lines, it should not dither the pen color.