Output(OS_ARC)


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

Draws the arc that lies between calculated endpoints on the specified ellipse.

1

Function was successful.

0

Unrecoverable error occurred.

-1

Function does not support specified style.


lpDestDev

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

wStyle

Must be OS_ARC.

wCount

Must be 5.

lpPoints

Address of an array that contains five POINT structures:

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

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

lpPBrush

Address of a PBRUSH structure. This parameter is not used to draw an arc.

lpDrawMode

Address of a DRAWMODE structure that contains drawing information that is used to draw the arc.

lpClipRect

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

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.

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.

See also PDEVICE, PBITMAP, DRAWMODE, RECT, POINT