Path

Inherits: Shape

Draws a path with given elements with the given paint.

Whether this shape is filled, stroked, or both, is controlled by paint.style. If the path is filled, then sub-paths within it are implicitly closed (see Path.Close).

Properties

• elements(list[PathElement]) –

  The list of path elements.

• paint(Paint) –

  A style to draw a path with.

Properties

elements

elements: list[PathElement] = field(default_factory=list)

The list of path elements.

paint

paint: Paint = field(default_factory=lambda: Paint())

A style to draw a path with.

Classes

Arc

Inherits: PathElement

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 with top left corner at x and y and dimensions width and height, from start_angle radians around the oval up to start_angle + sweep_angle 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.

Properties

• height(float) –

  Height of the rectangle bounding the arc.

• start_angle(float) –

  Starting angle in radians of the arc.

• sweep_angle(float) –

  Sweep angle in radians from start_angle.

• width(float) –

  Width of the rectangle bounding the arc.

• x(float) –

  Top-left corner x of the rectangle bounding the arc.

• y(float) –

  Top-left corner y of the rectangle bounding the arc.

Properties

height

height: float

Height of the rectangle bounding the arc.

start_angle

start_angle: float

Starting angle in radians of the arc.

sweep_angle

sweep_angle: float

Sweep angle in radians from start_angle.

width

width: float

Width of the rectangle bounding the arc.

x

x: float

Top-left corner x of the rectangle bounding the arc.

y

y: float

Top-left corner y of the rectangle bounding the arc.

ArcTo

Inherits: PathElement

Appends up to four conic curves weighted to describe an oval of radius and rotated by rotation (measured in degrees and clockwise).

The first curve begins from the last point in the path and the last ends at x and y. The curves follow a path in a direction determined by clockwise (bool) and large_arc (bool) in such a way that the sweep angle is always less than 360 degrees.

A simple line is appended if either radius is zero or the last point in the path (x,y). The radii are scaled to fit the last path point if both are greater than zero but too small to describe an arc.

Properties

• clockwise(bool) –

  Whether the arc should be drawn clockwise.

• large_arc(bool) –

  Whether to use the large arc sweep.

• radius(float) –

  Radius of the arc.

• rotation(float) –

  Rotation of the arc in degrees.

• x(float) –

  Destination x coordinate of arc endpoint.

• y(float) –

  Destination y coordinate of arc endpoint.

Properties

clockwise

clockwise: bool = True

Whether the arc should be drawn clockwise.

large_arc

large_arc: bool = False

Whether to use the large arc sweep.

radius

radius: float = 0

Radius of the arc.

rotation

rotation: float = 0

Rotation of the arc in degrees.

x

x: float

Destination x coordinate of arc endpoint.

y

y: float

Destination y coordinate of arc endpoint.

Close

Inherits: PathElement

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.

CubicTo

Inherits: PathElement

Adds a cubic bezier segment that curves from the current point to the given point (x,y), using the control points (cp1x,cp1y) and (cp2x,cp2y).

Properties

• cp1x(float) –
• cp1y(float) –
• cp2x(float) –
• cp2y(float) –
• x(float) –
• y(float) –

Properties

cp1x

cp1x: float

cp1y

cp1y: float

cp2x

cp2x: float

cp2y

cp2y: float

x

x: float

y

y: float

LineTo

Inherits: PathElement

Adds a straight line segment from the current point to the given point (x,y).

Properties

• x(float) –
• y(float) –

Properties

x

x: float

y

y: float

MoveTo

Inherits: PathElement

Starts a new sub-path at the given point (x,y).

Properties

• x(float) –
• y(float) –

Properties

x

x: float

y

y: float

Oval

Inherits: PathElement

Adds a new sub-path that consists of a curve that forms the ellipse that fills the given rectangle.

Properties

• height(float) –

  Height of the bounding rectangle.

• width(float) –

  Width of the bounding rectangle.

• x(float) –

  The x-axis coordinate of the top-left of the bounding rectangle.

• y(float) –

  The y-axis coordinate of the top-left of the bounding rectangle.

Properties

height

height: float

Height of the bounding rectangle.

width

width: float

Width of the bounding rectangle.

x

x: float

The x-axis coordinate of the top-left of the bounding rectangle.

y

y: float

The y-axis coordinate of the top-left of the bounding rectangle.

PathElement

QuadraticTo

Inherits: PathElement

Adds a bezier segment that curves from the current point to the given point (x,y), using the control points (cp1x,cp1y) and the weight w.

Properties

• cp1x(float) –
• cp1y(float) –
• w(float) –

  If the weight is greater than 1, then the curve is a hyperbola;

• x(float) –
• y(float) –

Properties

cp1x

cp1x: float

cp1y

cp1y: float

w

w: float = 1

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.

x

x: float

y

y: float

Rect

Inherits: PathElement

Adds a rectangle as a new sub-path.

Properties

• border_radius(BorderRadiusValue | None) –

  Optional border radius to round rectangle corners.

• height(float) –

  Height of the rectangle.

• width(float) –

  Width of the rectangle.

• x(float) –

  The x-axis coordinate of the top-left of the rectangle.

• y(float) –

  The y-axis coordinate of the top-left of the rectangle.

Properties

border_radius

border_radius: BorderRadiusValue | None = None

Optional border radius to round rectangle corners.

height

height: float

Height of the rectangle.

width

width: float

Width of the rectangle.

x

x: float

The x-axis coordinate of the top-left of the rectangle.

y

y: float

The y-axis coordinate of the top-left of the rectangle.

SubPath

Inherits: PathElement

Adds the sub-path described by elements to the given point (x,y).

Properties

• elements(list[PathElement]) –
• x(float) –
• y(float) –

Properties

elements

elements: list[PathElement]

x

x: float

y

y: float