Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                                     ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
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.
 
Parameter   Description
────────────────────────────────────────────────────────────────────────────
 
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.
 
See Also
 
Output(OS_BEGINNSCAN), Output(OS_ENDNSCAN)
 
 
                                      ♦