Output(OS_ARC)

  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.

Parameters

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)