Output(OS_CIRCLE)

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.

Parameters

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.

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)