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_PIE, 5, lpPoints, lpPPen, lpPBrush, lpDrawMode,
            lpClipRect)
LPPDEVICE lpDestDev;
LPPOINT lpPoints;
LPPPEN lpPPen;
LPPBRUSH lpPBrush;
LPDRAWMODE lpDrawMode;
LPRECT lpClipRect;
 
The OS_PIE style specifies that the Output function draws an arc and two
line segments that connect the endpoints of the arc to the center of the
arc's bounding rectangle. Since the resulting figure is closed, Output fills
the figure as well as draws the border. GDI calls this function when an
application calls the Pie function (GDI.26).
 
A graphics driver must support the OS_PIE style if the CC_PIE value is set
in the dpCurves member of the GDIINFO structure.
 
Parameter   Description
────────────────────────────────────────────────────────────────────────────
 
lpDestDev   Points to a PDEVICE or PBITMAP structure specifying the
            destination device or bitmap.
 
lpPoints    Points to an array containing five POINT structures. The
            elements of the array are defined as follows.
 
            Index  Description
            ────────────────────────────────────────────────────────────────
            0      Upper-left corner of the bounding rectangle.
 
            1      Lower-right corner of the bounding rectangle.
 
            2      Starting point for the arc.
 
            3      Ending point for the arc.
 
            4      Start and stop angles. Reserved; do not use.
 
lpPPen      Points to a PPEN structure specifying the physical pen to draw
            the arc and line segments.
 
lpPBrush    Points to a PBRUSH structure specifying the brush to fill the
            figure.
 
lpDrawMode  Points to a DRAWMODE structure containing drawing information to
            draw the border and fill the figure.
 
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 draws the figure. Otherwise, it is
zero if the function encounters an unrecoverable error. The return value is
-1 if the function cannot draw the specified figure and wants GDI to
simulate it.
 
Comments
 
Output draws the pie-shaped figure by first filling the interior then
drawing the border.
 
Output draws an arc by drawing a portion of the ellipse contained in the
specified bounding rectangle. The function calculates the endpoints of the
arc using the starting and ending points; each endpoint is the intersection
of the ellipse and a ray drawn from the center of the bounding rectangle
through the specified starting or ending point. Output draws the arc in a
counterclockwise direction, from starting point up to, but not including,
the ending point.
 
Output draws the two line segments from the endpoints of the arc to the
point at the center of the bounding rectangle.
 
See Also
 
Output(OS_ARC), Output(OS_CHORD)
 
 
                                      ♦