Function

CGContextAddEllipseInRect

Adds an ellipse that fits inside the specified rectangle.

Declaration

void CGContextAddEllipseInRect(CGContextRef c, CGRect rect);

Parameters

context

A graphics context.

rect

A rectangle that defines the area for the ellipse to fit in.

Discussion

The ellipse is approximated by a sequence of Bézier curves. Its center is the midpoint of the rectangle defined by the rect parameter. If the rectangle is square, then the ellipse is circular with a radius equal to one-half the width (or height) of the rectangle. If the rect parameter specifies a rectangular shape, then the major and minor axes of the ellipse are defined by the width and height of the rectangle.

The ellipse forms a complete subpath of the path—that is, the ellipse drawing starts with a move-to operation and ends with a close-subpath operation, with all moves oriented in the clockwise direction.

See Also

Constructing Paths

CGContextAddArc

Adds an arc of a circle to the current path, possibly preceded by a straight line segment

CGContextAddArcToPoint

Adds an arc of a circle to the current path, using a radius and tangent points.

CGContextAddCurveToPoint

Appends a cubic Bézier curve from the current point, using the provided control points and end point .

CGContextAddLines

Adds a sequence of connected straight-line segments to the current path.

CGContextAddLineToPoint

Appends a straight line segment from the current point to the provided point .

CGContextAddPath

Adds a previously created path object to the current path in a graphics context.

CGContextCopyPath

Returns a path object built from the current path information in a graphics context.

CGContextAddQuadCurveToPoint

Appends a quadratic Bézier curve from the current point, using a control point and an end point you specify.

CGContextAddRect

Adds a rectangular path to the current path.

CGContextAddRects

Adds a set of rectangular paths to the current path.

CGContextBeginPath

Creates a new empty path in a graphics context.

CGContextClosePath

Closes and terminates the current path’s subpath.

CGContextMoveToPoint

Begins a new subpath at the point you specify.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software