# Path class

A complex, one-dimensional subset of a plane.

A path consists of a number of sub-paths, and a current point.

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

Closed sub-paths 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 sub-path, 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 sub-path 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 sub-path 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 sub-path that consists of the given `path` offset by the given `offset`. [...]
addPolygon(List<Offset> points, bool close) → void
  Adds a new sub-path with a sequence of line segments that connect the given points. [...]
addRect(Rect rect) → void
  Adds a new sub-path that consists of four lines that outline the given rectangle.
addRRect(RRect rrect) → void
  Adds a new sub-path 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 sub-path, as if a straight line had been drawn from the current point to the first point of the sub-path.
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 sub-path 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 sub-path 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 sub-paths, 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 sub-path translated by the given offset.
transform(Float64List matrix4) → Path
  Returns a copy of the path with all the segments of every sub-path 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`. [...]