Function

CGContextClipToRects

Sets the clipping path to the intersection of the current clipping path with the region defined by an array of rectangles.

Declaration

void CGContextClipToRects(CGContextRef c, const CGRect *rects, size_t count);

Parameters

c

The graphics context for which to set the clipping path.

rects

An array of rectangles. The locations and dimensions of the rectangles are specified in the user space coordinate system.

count

The total number of array entries in the rects parameter.

Discussion

This function sets the clipping path to the intersection of the current clipping path and the region within the specified rectangles.

After determining the new clipping path, the function resets the context’s current path to an empty path.

See Also

Modifying Clipping Paths

CGContextClip

Modifies the current clipping path, using the nonzero winding number rule.

CGContextEOClip

Modifies the current clipping path, using the even-odd rule.

CGContextClipToRect

Sets the clipping path to the intersection of the current clipping path with the area defined by the specified rectangle.

CGContextGetClipBoundingBox

Returns the bounding box of a clipping path.

CGContextClipToMask

Maps a mask into the specified rectangle and intersects it with the current clipping area of the graphics context.

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