|
|
FQO: V1 Completed
|
|
XDrawArc() XDrawArc() Name XDrawArc - draw an arc fitting inside a rectangle. Synopsis XDrawArc(display, drawable, gc, x, y, width, height, angle1, angle2) Display *display; Drawable drawable; GC gc; int x, y; unsigned int width, height; int angle1, angle2; Arguments display Specifies a connection to an X server; returned from XOpenDisplay(). drawable Specifies the drawable. gc Specifies the graphics context. x Specify the x and y coordinates of the upper-left corner of the rectangle that contains the arc, relative to the origin of the y specified drawable. width Specify the width and height in pixels of the major and minor axes of the arc. height angle1 Specifies the start of the arc relative to the three-o'clock position from the center. Angles are specified in 64ths of a degree (360 * 64 is a complete circle). angle2 Specifies the end of the arc relative to the start of the arc. Angles are specified in 64ths of a degree (360 * 64 is a complete circle). Description XDrawArc() draws a circular or elliptical arc. An arc is specified by a rectangle and two angles. The x and y coordinates are relative to the origin of the drawable, and define the upper-left corner of the rectangle. The center of the circle or ellipse is the center of the rectangle, and the major and minor axes are specified by the width and height, respectively. The angles are signed integers in 64ths of a degree, with positive values indicating counterclockwise motion and negative values indicating clockwise motion, truncated to a maximum of 360 degrees. The start of the arc is specified by angle1 relative to the three-o'clock position from the center, and the path and extent of the arc is specified by angle2 relative to the start of the arc. By specifying one axis to be zero, a horizontal or vertical line is drawn (inefficiently). Angles are computed based solely on the coordinate system and ignore the aspect ratio. In other words, if the bounding rectangle of the arc is not square and angle1 is zero and angle2 is (45x64), a point drawn from the center of the bounding box through the endpoint of the arc will pass through the corner of the rectangle. For any given arc, no pixel is drawn more than once, even if angle2 is greater than angle1 by more than 360 degrees. See XDrawArcs() for a detailed description of the pixels drawn by XDrawArc(). XDrawArc() uses these graphics context components: function, plane_mask, line_width, line_style, cap_style, join_style, fill_style, sub- window_ mode, clip_x_origin, clip_y_origin, and clip_mask. This function also uses these graphics context mode-dependent components: foreground, background, tile, stipple, ts_x_origin, ts_y_origin, dash_offset, and dashes. For more information, see Volume One, Chapter 6, Drawing Graphics and Text. Errors BadDrawable BadGC BadMatch See Also XClearArea(), XClearWindow(), XCopyArea(), XCopyPlane(), XDraw, XDrawArcs(), XDrawFilled(), XDrawLine(), XDrawLines(), XDrawPoint(), XDraw- Points(), XDrawRectangle(), XDrawRectangles(), XDrawSegments(), XFillArc(), XFillArcs(), XFillPolygon(), XFillRectangle(), XFillRectan- gles(). Xlib - Drawing Primitives XDrawArc()
