SkPath

SkPath is a core class in the Skia graphics library used to describe shapes for filling or stroking. It represents geometry as a sequence of contours defined by a compact combination of commands (verbs) and a parallel list of points. The primary verbs include moveTo, lineTo, quadTo, conicTo (which carries a weight for the conic segment), cubicTo, and close. A path may consist of multiple contours, and a fill type setting determines how the interior of the path is filled (for example, winding or even-odd rules).

Construction and modification are supported either directly or via a builder. You can create an empty SkPath and append segments with methods such as moveTo, lineTo, quadTo, conicTo, and cubicTo, or use higher-level helpers like addRect, addOval, and addPath. SkPath can also be transformed or animated with matrices, and it can be combined with other paths through various operations.

Boolean path operations are provided to combine two paths using a path operation (often via SkPath::Op) with options such as union, intersection, difference, xor, and reverse difference. These operations produce a new path that reflects the chosen boolean combination.

Rendering and measurement are routine tasks for SkPath. The path is passed to rendering routines such as canvas drawPath for filling or stroking. SkPathMeasure enables length measurement and sampling positions along the path, useful for animations and path-based effects. SkPath can also be iterated with SkPath::Iter to inspect its commands and points, and its bounds, empty state, and other properties can be queried as needed.

See also: Skia, SkPathBuilder, SkCanvas, SkPathMeasure, SkPathEffect.