Output(OS_ELLIPSE)


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

Draws an ellipse.

1

Function was successful.

0

Unrecoverable error occurred.

-1

Function does not support the specified style.


lpDestDev

Address of a PDEVICE or PBITMAP structure that specifies the destination device or bitmap.

wStyle

Must be OS_ELLIPSE.

wCount

Must be 2.

lpPoints

Address of an array that contains 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

Address of a PPEN structure that specifies the physical pen that is used to draw the border.

lpPBrush

Address of a PBRUSH structure that specifies the physical brush that is used to fill the ellipse.

lpDrawMode

Address of a DRAWMODE structure that contains information that is used to draw the border and fill the interior.

lpClipRect

Address of a RECT structure that contains coordinates for the clipping rectangle. If this parameter is NULL, the clipping rectangle is the entire display surface.

Because the resulting figure is closed, Output fills the figure and draws the border. GDI calls this function when an application calls the Ellipse function (GDI.24).

A graphics driver must support this style if the CC_ELLIPSES value is set in the dpCurves member of the GDIINFO structure.

Output draws the ellipse by first filling the interior then drawing the border. The center of the ellipse is at the center of the bounding rectangle; the semi-major and semi-minor axes of the ellipse are equal to half the width and height of the rectangle.

See also PDEVICE, PBITMAP, DRAWMODE, RECT, POINT