CGPathMoveToPoint

CGPathMoveToPoint is a function in the Core Graphics framework on Apple operating systems. It is used to create or modify a path. Specifically, CGPathMoveToPoint sets the current point of a path without drawing a line. This is essential for starting new subpaths or creating disconnected segments within a single path.

When you call CGPathMoveToPoint, you provide a point to which the path's current position is moved. If the path is empty, this point becomes the starting point of the first subpath. If a subpath has already begun, calling CGPathMoveToPoint effectively ends the current subpath and begins a new one at the specified coordinates. Subsequent drawing operations, such as adding lines or curves, will start from this new current point.

This function is a fundamental building block when constructing complex shapes using Core Graphics. For instance, to draw multiple distinct shapes within one CGPath object, you would use CGPathMoveToPoint to reposition the current point before drawing each new shape. It is often used in conjunction with other path-adding functions like CGPathAddLineToPoint, CGPathAddCurveToPoint, and CGPathAddArc. The function takes a CGMutablePathRef and a CGPoint as arguments.