Function

CGPathAddLines

Appends an array of new line segments to a mutable graphics path.

Declaration

void CGPathAddLines(CGMutablePathRef path, const CGAffineTransform *m, const CGPoint *points, size_t count);

Parameters

path

The mutable path to change.

m

A pointer to an affine transformation matrix, or NULL if no transformation is needed. If specified, Core Graphics applies the transformation to the lines before adding them to the path.

points

An array of points that specifies the line segments to add.

count

The number of elements in the array.

Discussion

This is a convenience function that adds a sequence of connected line segments to a path. This function is equivalent to calling the CGPathMoveToPoint function to move to the starting point of the first line segment, then repeatedly calling the CGPathAddLineToPoint to append the sequence of line segments.

See Also

Modifying Core Graphics Paths

CGPathAddArc

Appends an arc to a mutable graphics path, possibly preceded by a straight line segment.

CGPathAddRelativeArc

Appends an arc to a mutable graphics path, possibly preceded by a straight line segment.

CGPathAddArcToPoint

Appends an arc to a mutable graphics path, possibly preceded by a straight line segment.

CGPathAddCurveToPoint

Appends a cubic Bézier curve to a mutable graphics path.

CGPathAddLineToPoint

Appends a line segment to a mutable graphics path.

CGPathAddPath

Appends a path to onto a mutable graphics path.

CGPathAddQuadCurveToPoint

Appends a quadratic Bézier curve to a mutable graphics path.

CGPathAddRect

Appends a rectangle to a mutable graphics path.

CGPathAddRects

Appends an array of rectangles to a mutable graphics path.

CGPathAddRoundedRect

Appends a rounded rectangle to a mutable graphics path.

CGPathApply

For each element in a graphics path, calls a custom applier function.

CGPathMoveToPoint

Starts a new subpath at a specified location in a mutable graphics path.

CGPathCloseSubpath

Closes and completes a subpath in a mutable graphics path.

CGPathAddEllipseInRect

Adds to a path an ellipse that fits inside a rectangle.