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_CIRCLE, 2, lpPoints, lpPPen, lpPBrush,
            lpDrawMode, lpClipRect)
LPPDEVICE lpDestDev;
LPPOINT lpPoints;
LPPPEN lpPPen;
LPPBRUSH lpPBrush;
LPDRAWMODE lpDrawMode;
LPRECT lpClipRect;
 
The OS_CIRCLE style specifies that the Output function draws a circle. 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 Ellipse
function (GDI.24) with a bounding rectangle that is square.
 
A graphics driver must support this style if the 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 two 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.
 
lpPPen      Points to a PPEN structure specifying the physical pen to draw
            the border.
 
lpPBrush    Points to a PBRUSH structure specifying the physical brush to
            fill the circle.
 
lpDrawMode  Points to a DRAWMODE structure containing information when
            drawing the border and filling the interior.
 
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 circle. Otherwise, it is
zero if the function encounters an unrecoverable error. The return value is
-1 if the function cannot draw the specified circle and wants GDI to
simulate it.
 
Comments
 
Output draws the circle by first filling the interior then drawing the
border. The center of the circle is at the center of the bounding rectangle;
the radius is equal to half the width of the rectangle.
 
If a graphics driver can draw ellipses and has set the CC_ELLIPSES value in
the dpCurves member, it does not need to set the CC_CIRCLES value in the
dpCurves member. In such cases, GDI calls Output with the OS_ELLIPSE style
when an application draws a circle.
 
See Also
 
Output(OS_ELLIPSE)
 
 
                                      ♦