Path class Null safety
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
Properties
- fillType ↔ PathFillType
-
Determines how the interior of this path is calculated.
read / write
- hashCode → int
-
The hash code for this object.
read-onlyinherited
- runtimeType → Type
-
A representation of the runtime type of the object.
read-onlyinherited
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 the sub-paths of
path
, offset byoffset
, to this path. -
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 byrotation
(measured in degrees and clockwise). -
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, which can describe various properties about the contours of the 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.
FfiNative<
Void Function(Pointer< (Pointer<Void>, Float, Float, Float, Float, Float)>('Path::conicTo', isLeaf: true)">@FfiNative<Void> , Float, Float, Float, Float, Float)>Void Function(Pointer< (Pointer<Void>, Float, Float, Float, Float, Float)>('Path::conicTo', isLeaf: true)Void> , Float, Float, Float, Float, Float)> -
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).
FfiNative<
Void Function(Pointer< (Pointer<Void>, Float, Float, Float, Float, Float, Float)>('Path::cubicTo', isLeaf: true)">@FfiNative<Void> , Float, Float, Float, Float, Float, Float)>Void Function(Pointer< (Pointer<Void>, Float, Float, Float, Float, Float, Float)>('Path::cubicTo', isLeaf: true)Void> , Float, Float, Float, Float, Float, Float)> -
extendWithPath(
Path path, Offset offset, {Float64List? matrix4}) → void -
Adds the sub-paths of
path
, offset byoffset
, to this path. The current sub-path is extended with the first sub-path ofpath
, connecting them with a lineTo if necessary. -
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.
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a non-existent method or property is accessed.
inherited
-
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).
FfiNative<
Void Function(Pointer< (Pointer<Void>, Float, Float, Float, Float)>('Path::quadraticBezierTo', isLeaf: true)">@FfiNative<Void> , Float, Float, Float, Float)>Void Function(Pointer< (Pointer<Void>, Float, Float, Float, Float)>('Path::quadraticBezierTo', isLeaf: true)Void> , Float, Float, Float, Float)> -
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 byrotation
(measured in degrees and clockwise). -
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.
FfiNative<
Void Function(Pointer< (Pointer<Void>, Float, Float, Float, Float, Float)>('Path::relativeConicTo', isLeaf: true)">@FfiNative<Void> , Float, Float, Float, Float, Float)>Void Function(Pointer< (Pointer<Void>, Float, Float, Float, Float, Float)>('Path::relativeConicTo', isLeaf: true)Void> , Float, Float, Float, Float, Float)> -
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.
FfiNative<
Void Function(Pointer< (Pointer<Void>, Float, Float, Float, Float, Float, Float)>('Path::relativeCubicTo', isLeaf: true)">@FfiNative<Void> , Float, Float, Float, Float, Float, Float)>Void Function(Pointer< (Pointer<Void>, Float, Float, Float, Float, Float, Float)>('Path::relativeCubicTo', isLeaf: true)Void> , Float, Float, Float, Float, Float, Float)> -
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.
FfiNative<
Void Function(Pointer< (Pointer<Void>, Float, Float, Float, Float)>('Path::relativeQuadraticBezierTo', isLeaf: true)">@FfiNative<Void> , Float, Float, Float, Float)>Void Function(Pointer< (Pointer<Void>, Float, Float, Float, Float)>('Path::relativeQuadraticBezierTo', isLeaf: true)Void> , Float, Float, Float, Float)> -
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.
-
toString(
) → String -
A string representation of this object.
inherited
-
transform(
Float64List matrix4) → Path - Returns a copy of the path with all the segments of every sub-path transformed by the given matrix.
Operators
-
operator ==(
Object 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
.