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_ARC, 5, lpPoints, lpPPen, lpPBrush, lpDrawMode,
            lpClipRect)
LPPDEVICE lpDestDev;
LPPOINT lpPoints;
LPPPEN lpPPen;
LPPBRUSH lpPBrush;
LPDRAWMODE lpDrawMode;
LPRECT lpClipRect;
 
The OS_ARC style specifies that the Output function draws the arc that lies
between calculated endpoints on the specified ellipse.
 
A graphics driver must support the OS_ARC style if the CC_ELLIPSES or
CC_CIRCLES 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.
 
lpPBrush    Points to a PBRUSH structure. This parameter is not used to draw
            an arc.
 
lpDrawMode  Points to a DRAWMODE structure containing drawing information to
            draw the arc.
 
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 arc and chord. Otherwise, it
is zero if the function encounters an unrecoverable error. The return value
is -1 if the function cannot draw the specified arc and wants GDI to
simulate it.
 
Comments
 
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.
 
See Also
 
Output(OS_CHORD), Output(OS_PIE)
 
 
                                      ♦