Path class

A complex, one-dimensional subset of a plane.

A path consists of a number of subpaths, and a current point.

Subpaths consist of segments of various types, such as lines, arcs, or beziers. Subpaths can be open or closed, and can self-intersect.

Closed subpaths enclose a (possibly discontiguous) region of the plane based on the current fillType.

The current point is initially at the origin. After each operation adding a segment to a subpath, the current point is updated to the end of that segment.

Paths can be drawn on canvases using Canvas.drawPath, and can used to create clip regions using Canvas.clipPath.

Constructors

Path()
Create a new empty Path object.
Path.from(Path source)
Creates a copy of another Path. [...]
factory

Properties

fillType PathFillType
Determines how the interior of this path is calculated. [...]
read / write
hashCode int
The hash code for this object. [...]
read-only, inherited
runtimeType Type
A representation of the runtime type of the object.
read-only, inherited

Methods

addArc(Rect oval, double startAngle, double sweepAngle) → void
Adds a new subpath with one arc segment that consists of the arc that follows the edge of the oval bounded by the given rectangle, from startAngle radians around the oval up to startAngle + sweepAngle radians around the oval, with zero radians being the point on the right hand side of the oval that crosses the horizontal line that intersects the center of the rectangle and with positive angles going clockwise around the oval.
addOval(Rect oval) → void
Adds a new subpath that consists of a curve that forms the ellipse that fills the given rectangle. [...]
addPath(Path path, Offset offset, { Float64List matrix4 }) → void
Adds a new subpath that consists of the given path offset by the given offset. [...]
addPolygon(List<Offset> points, bool close) → void
Adds a new subpath with a sequence of line segments that connect the given points. [...]
addRect(Rect rect) → void
Adds a new subpath that consists of four lines that outline the given rectangle.
addRRect(RRect rrect) → void
Adds a new subpath that consists of the straight lines and curves needed to form the rounded rectangle described by the argument.
arcTo(Rect rect, double startAngle, double sweepAngle, bool forceMoveTo) → void
If the forceMoveTo argument is false, adds a straight line segment and an arc segment. [...]
arcToPoint(Offset arcEnd, { Radius radius: Radius.zero, double rotation: 0.0, bool largeArc: false, bool clockwise: true }) → void
Appends up to four conic curves weighted to describe an oval of radius and rotated by rotation. [...]
close() → void
Closes the last subpath, as if a straight line had been drawn from the current point to the first point of the subpath.
computeMetrics({bool forceClosed: false }) PathMetrics
Creates a PathMetrics object for this path. [...]
conicTo(double x1, double y1, double x2, double y2, double w) → void
Adds a bezier segment that curves from the current point to the given point (x2,y2), using the control points (x1,y1) and the weight w. If the weight is greater than 1, then the curve is a hyperbola; if the weight equals 1, it's a parabola; and if it is less than 1, it is an ellipse.
contains(Offset point) bool
Tests to see if the given point is within the path. (That is, whether the point would be in the visible portion of the path if the path was used with Canvas.clipPath.) [...]
cubicTo(double x1, double y1, double x2, double y2, double x3, double y3) → void
Adds a cubic bezier segment that curves from the current point to the given point (x3,y3), using the control points (x1,y1) and (x2,y2).
extendWithPath(Path path, Offset offset, { Float64List matrix4 }) → void
Adds the given path to this path by extending the current segment of this path with the the first segment of the given path. [...]
getBounds() Rect
Computes the bounding rectangle for this path. [...]
lineTo(double x, double y) → void
Adds a straight line segment from the current point to the given point.
moveTo(double x, double y) → void
Starts a new subpath at the given coordinate.
quadraticBezierTo(double x1, double y1, double x2, double y2) → void
Adds a quadratic bezier segment that curves from the current point to the given point (x2,y2), using the control point (x1,y1).
relativeArcToPoint(Offset arcEndDelta, { Radius radius: Radius.zero, double rotation: 0.0, bool largeArc: false, bool clockwise: true }) → void
Appends up to four conic curves weighted to describe an oval of radius and rotated by rotation. [...]
relativeConicTo(double x1, double y1, double x2, double y2, double w) → void
Adds a bezier segment that curves from the current point to the point at the offset (x2,y2) from the current point, using the control point at the offset (x1,y1) from the current point and the weight w. If the weight is greater than 1, then the curve is a hyperbola; if the weight equals 1, it's a parabola; and if it is less than 1, it is an ellipse.
relativeCubicTo(double x1, double y1, double x2, double y2, double x3, double y3) → void
Adds a cubic bezier segment that curves from the current point to the point at the offset (x3,y3) from the current point, using the control points at the offsets (x1,y1) and (x2,y2) from the current point.
relativeLineTo(double dx, double dy) → void
Adds a straight line segment from the current point to the point at the given offset from the current point.
relativeMoveTo(double dx, double dy) → void
Starts a new subpath at the given offset from the current point.
relativeQuadraticBezierTo(double x1, double y1, double x2, double y2) → void
Adds a quadratic bezier segment that curves from the current point to the point at the offset (x2,y2) from the current point, using the control point at the offset (x1,y1) from the current point.
reset() → void
Clears the Path object of all subpaths, returning it to the same state it had when it was created. The current point is reset to the origin.
shift(Offset offset) Path
Returns a copy of the path with all the segments of every subpath translated by the given offset.
transform(Float64List matrix4) Path
Returns a copy of the path with all the segments of every subpath transformed by the given matrix.
noSuchMethod(Invocation invocation) → dynamic
Invoked when a non-existent method or property is accessed. [...]
inherited
toString() String
Returns a string representation of this object.
inherited

Operators

operator ==(dynamic other) bool
The equality operator. [...]
inherited

Static Methods

combine(PathOperation operation, Path path1, Path path2) Path
Combines the two paths according to the manner specified by the given operation. [...]