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.