Output(OS_CHORD)

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

The OS_CHORD style specifies that the Output function draws an arc and the chord connecting the endpoints of the arc. Since the resulting figure is closed, Output fills the figure as well as draws the border. GDI calls this style when an application calls the Chord function (GDI.348).

A graphics driver must support this style if the CC_CHORD 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 border.

lpPBrush

Points to a PBRUSH structure specifying the physical brush to fill the figure.

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 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 chord and wants GDI to simulate it.

Comments

Output draws the arc and chord by first filling the interior then drawing the border.

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_ARC), Output(OS_PIE)