Path¶
This module implements a geometric Path
, supported by several render
backends, with the goal to create such paths from DXF entities like LWPOLYLINE,
POLYLINE or HATCH and send them to the render backend,
see ezdxf.addons.drawing
.
Minimum common interface:
 matplotlib: PathPatch
matplotlib.path.Path() codes:
MOVETO
LINETO
CURVE3  quadratic Bèziercurve
CURVE4  cubic Bèziercurve
 PyQt: QPainterPath
moveTo()
lineTo()
quadTo()  quadratic Bèziercurve (converted to a cubic Bèziercurve)
cubicTo()  cubic Bèziercurve
 PyCairo: Context
move_to()
line_to()
no support for quadratic Bèziercurve
curve_to()  cubic Bèziercurve
 SVG: SVGPath
“M”  absolute move to
“L”  absolute line to
“Q”  absolute quadratic Bèziercurve
“C”  absolute cubic Bèziercurve
ARC and ELLIPSE entities are approximated by multiple cubic Béziercurves, which are close enough for display rendering. Nonrational SPLINES of 3rd degree can be represented exact as multiple cubic Béziercurves, other Bsplines will be approximated. The XLINE and the RAY entities are not supported, because of their infinite nature.
This Path
class is a full featured 3D object, although the backends
only support 2D paths.
The usability of the Path
class expanded by the introduction
of the reverse conversion from Path
to DXF entities (LWPOLYLINE,
POLYLINE, LINE), and many other tools in ezdxf v0.16.
To emphasize this new usability, the Path
class has got its own
subpackage ezdxf.path
.
 EmptyPath¶
Contains only a start point, the length of the path is 0 and the methods
Path.approximate()
,Path.flattening()
andPath.control_vertices()
do not yield any vertices. SinglePath¶
The
Path
object contains only one path without gaps, the propertyPath.has_sub_paths
isFalse
and the methodPath.sub_paths()
yields only this one path. MultiPath¶
The
Path
object contains more than one path, the propertyPath.has_sub_paths
isTrue
and the methodPath.sub_paths()
yields all paths within this object as singlepath objects. It is not possible to detect the orientation of a multipath object, therefore the methodsPath.has_clockwise_orientation()
,Path.clockwise()
andPath.counter_clockwise()
raise aTypeError
exception.
Warning
Always import from the top level ezdxf.path
, never from the
submodules
Factory Functions¶
Functions to create Path
objects from other objects.
 ezdxf.path.make_path(entity: DXFEntity) Path ¶
Factory function to create a single
Path
object from a DXF entity. Supported DXF types:LINE
CIRCLE
ARC
ELLIPSE
SPLINE and HELIX
LWPOLYLINE
2D and 3D POLYLINE
SOLID, TRACE, 3DFACE
IMAGE, WIPEOUT clipping path
VIEWPORT clipping path
HATCH as MultiPath object
 Parameters:
entity – DXF entity
segments – minimal count of cubic Béziercurves for elliptical arcs like CIRCLE, ARC, ELLIPSE, BULGE see
Path.add_ellipse()
level – subdivide level for SPLINE approximation, see
Path.add_spline()
 Raises:
TypeError – for unsupported DXF types
Render Functions¶
Functions to create DXF entities from paths and add them to the modelspace, a paperspace layout or a block definition.
 ezdxf.path.render_hatches(layout: GenericLayoutType, paths: Iterable[Path], *, edge_path: bool = True, distance: float = MAX_DISTANCE, segments: int = MIN_SEGMENTS, g1_tol: float = G1_TOL, extrusion: UVec = Z_AXIS, dxfattribs=None) EntityQuery ¶
Render the given paths into layout as
Hatch
entities. The extrusion vector is applied to all paths, all vertices are projected onto the plane normal to this extrusion vector. The default extrusion vector is the WCS zaxis. The plane elevation is the distance from the WCS origin to the start point of the first path. Parameters:
layout – the modelspace, a paperspace layout or a block definition
paths – iterable of
Path
orPath2d
objectsedge_path –
True
for edge paths build of LINE and SPLINE edges,False
for only LWPOLYLINE paths as boundary pathsdistance – maximum distance, see
Path.flattening()
segments – minimum segment count per Bézier curve to flatten polyline paths
g1_tol – tolerance for G1 continuity check to separate SPLINE edges
extrusion – extrusion vector for all paths
dxfattribs – additional DXF attribs
 Returns:
created entities in an
EntityQuery
object
 ezdxf.path.render_lines(layout: GenericLayoutType, paths: Iterable[Path], *, distance: float = MAX_DISTANCE, segments: int = MIN_SEGMENTS, dxfattribs=None) EntityQuery ¶
Render the given paths into layout as
Line
entities. Parameters:
layout – the modelspace, a paperspace layout or a block definition
paths – iterable of
Path`or :class:`Path2d
objectsdistance – maximum distance, see
Path.flattening()
segments – minimum segment count per Bézier curve
dxfattribs – additional DXF attribs
 Returns:
created entities in an
EntityQuery
object
 ezdxf.path.render_lwpolylines(layout: GenericLayoutType, paths: Iterable[Path], *, distance: float = MAX_DISTANCE, segments: int = MIN_SEGMENTS, extrusion: UVec = Z_AXIS, dxfattribs=None) EntityQuery ¶
Render the given paths into layout as
LWPolyline
entities. The extrusion vector is applied to all paths, all vertices are projected onto the plane normal to this extrusion vector. The default extrusion vector is the WCS zaxis. The plane elevation is the distance from the WCS origin to the start point of the first path. Parameters:
layout – the modelspace, a paperspace layout or a block definition
paths – iterable of
Path
orPath2d
objectsdistance – maximum distance, see
Path.flattening()
segments – minimum segment count per Bézier curve
extrusion – extrusion vector for all paths
dxfattribs – additional DXF attribs
 Returns:
created entities in an
EntityQuery
object
 ezdxf.path.render_mpolygons(layout: GenericLayoutType, paths: Iterable[Path], *, distance: float = MAX_DISTANCE, segments: int = MIN_SEGMENTS, extrusion: UVec = Z_AXIS, dxfattribs=None) EntityQuery ¶
Render the given paths into layout as
MPolygon
entities. The MPOLYGON entity supports only polyline boundary paths. All curves will be approximated.The extrusion vector is applied to all paths, all vertices are projected onto the plane normal to this extrusion vector. The default extrusion vector is the WCS zaxis. The plane elevation is the distance from the WCS origin to the start point of the first path.
 Parameters:
layout – the modelspace, a paperspace layout or a block definition
paths – iterable of
Path
orPath2d
objectsdistance – maximum distance, see
Path.flattening()
segments – minimum segment count per Bézier curve to flatten polyline paths
extrusion – extrusion vector for all paths
dxfattribs – additional DXF attribs
 Returns:
created entities in an
EntityQuery
object
 ezdxf.path.render_polylines2d(layout: GenericLayoutType, paths: Iterable[Path], *, distance: float = 0.01, segments: int = 4, extrusion: UVec = Z_AXIS, dxfattribs=None) EntityQuery ¶
Render the given paths into layout as 2D
Polyline
entities. The extrusion vector is applied to all paths, all vertices are projected onto the plane normal to this extrusion vector.The default extrusion vector is the WCS zaxis. The plane elevation is the distance from the WCS origin to the start point of the first path. Parameters:
layout – the modelspace, a paperspace layout or a block definition
paths – iterable of
Path
orPath2d
objectsdistance – maximum distance, see
Path.flattening()
segments – minimum segment count per Bézier curve
extrusion – extrusion vector for all paths
dxfattribs – additional DXF attribs
 Returns:
created entities in an
EntityQuery
object
 ezdxf.path.render_polylines3d(layout: GenericLayoutType, paths: Iterable[Path], *, distance: float = MAX_DISTANCE, segments: int = MIN_SEGMENTS, dxfattribs=None) EntityQuery ¶
Render the given paths into layout as 3D
Polyline
entities. Parameters:
layout – the modelspace, a paperspace layout or a block definition
paths – iterable of
Path`or :class:`Path2d
objectsdistance – maximum distance, see
Path.flattening()
segments – minimum segment count per Bézier curve
dxfattribs – additional DXF attribs
 Returns:
created entities in an
EntityQuery
object
 ezdxf.path.render_splines_and_polylines(layout: GenericLayoutType, paths: Iterable[Path], *, g1_tol: float = G1_TOL, dxfattribs=None) EntityQuery ¶
Render the given paths into layout as
Spline
and 3DPolyline
entities. Parameters:
layout – the modelspace, a paperspace layout or a block definition
paths – iterable of
Path`or :class:`Path2d
objectsg1_tol – tolerance for G1 continuity check
dxfattribs – additional DXF attribs
 Returns:
created entities in an
EntityQuery
object
Entity Maker¶
Functions to create DXF entities from paths.
 ezdxf.path.to_hatches(paths: Iterable[Path], *, edge_path: bool = True, distance: float = MAX_DISTANCE, segments: int = MIN_SEGMENTS, g1_tol: float = G1_TOL, extrusion: UVec = Z_AXIS, dxfattribs=None) Iterator[Hatch] ¶
Convert the given paths into
Hatch
entities. Uses LWPOLYLINE paths for boundaries without curves and edge paths, build of LINE and SPLINE edges, as boundary paths for boundaries including curves. The extrusion vector is applied to all paths, all vertices are projected onto the plane normal to this extrusion vector. The default extrusion vector is the WCS zaxis. The plane elevation is the distance from the WCS origin to the start point of the first path. Parameters:
paths – iterable of
Path
objectsedge_path –
True
for edge paths build of LINE and SPLINE edges,False
for only LWPOLYLINE paths as boundary pathsdistance – maximum distance, see
Path.flattening()
segments – minimum segment count per Bézier curve to flatten LWPOLYLINE paths
g1_tol – tolerance for G1 continuity check to separate SPLINE edges
extrusion – extrusion vector to all paths
dxfattribs – additional DXF attribs
 Returns:
iterable of
Hatch
objects
 ezdxf.path.to_lines(paths: Iterable[Path], *, distance: float = MAX_DISTANCE, segments: int = MIN_SEGMENTS, dxfattribs=None) Iterator[Line] ¶
Convert the given paths into
Line
entities. Parameters:
paths – iterable of
Path
objectsdistance – maximum distance, see
Path.flattening()
segments – minimum segment count per Bézier curve
dxfattribs – additional DXF attribs
 Returns:
iterable of
Line
objects
 ezdxf.path.to_lwpolylines(paths: Iterable[Path], *, distance: float = MAX_DISTANCE, segments: int = MIN_SEGMENTS, extrusion: UVec = Z_AXIS, dxfattribs=None) Iterator[LWPolyline] ¶
Convert the given paths into
LWPolyline
entities. The extrusion vector is applied to all paths, all vertices are projected onto the plane normal to this extrusion vector. The default extrusion vector is the WCS zaxis. The plane elevation is the distance from the WCS origin to the start point of the first path. Parameters:
paths – iterable of
Path
objectsdistance – maximum distance, see
Path.flattening()
segments – minimum segment count per Bézier curve
extrusion – extrusion vector for all paths
dxfattribs – additional DXF attribs
 Returns:
iterable of
LWPolyline
objects
 ezdxf.path.to_mpolygons(paths: Iterable[Path], *, distance: float = MAX_DISTANCE, segments: int = MIN_SEGMENTS, extrusion: UVec = Z_AXIS, dxfattribs=None) Iterator[MPolygon] ¶
Convert the given paths into
MPolygon
entities. In contrast to HATCH, MPOLYGON supports only polyline boundary paths. All curves will be approximated.The extrusion vector is applied to all paths, all vertices are projected onto the plane normal to this extrusion vector. The default extrusion vector is the WCS zaxis. The plane elevation is the distance from the WCS origin to the start point of the first path.
 Parameters:
paths – iterable of
Path
objectsdistance – maximum distance, see
Path.flattening()
segments – minimum segment count per Bézier curve to flatten LWPOLYLINE paths
extrusion – extrusion vector to all paths
dxfattribs – additional DXF attribs
 Returns:
iterable of
MPolygon
objects
 ezdxf.path.to_polylines2d(paths: Iterable[Path], *, distance: float = MAX_DISTANCE, segments: int = MIN_SEGMENTS, extrusion: UVec = Z_AXIS, dxfattribs=None) Iterator[Polyline] ¶
Convert the given paths into 2D
Polyline
entities. The extrusion vector is applied to all paths, all vertices are projected onto the plane normal to this extrusion vector. The default extrusion vector is the WCS zaxis. The plane elevation is the distance from the WCS origin to the start point of the first path. Parameters:
paths – iterable of
Path
objectsdistance – maximum distance, see
Path.flattening()
segments – minimum segment count per Bézier curve
extrusion – extrusion vector for all paths
dxfattribs – additional DXF attribs
 Returns:
iterable of 2D
Polyline
objects
 ezdxf.path.to_polylines3d(paths: Iterable[Path], *, distance: float = MAX_DISTANCE, segments: int = MIN_SEGMENTS, dxfattribs=None) Iterator[Polyline] ¶
Convert the given paths into 3D
Polyline
entities. Parameters:
paths – iterable of
Path
objectsdistance – maximum distance, see
Path.flattening()
segments – minimum segment count per Bézier curve
dxfattribs – additional DXF attribs
 Returns:
iterable of 3D
Polyline
objects
Tool Maker¶
Functions to create construction tools.
Utility Functions¶
 ezdxf.path.add_bezier3p(path: Path, curves: Iterable[Bezier3P]) None ¶
Add multiple quadratic Bèziercurves to the given path.
Autodetect the connection point to the given path, if neither the start nor the end point of the curves is close to the path end point, a line from the path end point to the start point of the first curve will be added automatically.
 ezdxf.path.add_bezier4p(path: Path, curves: Iterable[Bezier4P]) None ¶
Add multiple cubic Bèziercurves to the given path.
Autodetect the connection point to the given path, if neither the start nor the end point of the curves is close to the path end point, a line from the path end point to the start point of the first curve will be added automatically.
 ezdxf.path.add_ellipse(path: Path, ellipse: ConstructionEllipse, segments=1, reset=True) None ¶
Add an elliptical arc as multiple cubic Bèziercurves to the given path, use
from_arc()
constructor of classConstructionEllipse
to add circular arcs.Autodetect the connection point to the given path, if neither the start nor the end point of the ellipse is close to the path end point, a line from the path end point to the ellipse start point will be added automatically (see
add_bezier4p()
).By default, the start of an empty path is set to the start point of the ellipse, setting argument reset to
False
prevents this behavior. Parameters:
path –
Path
objectellipse – ellipse parameters as
ConstructionEllipse
objectsegments – count of Bèziercurve segments, at least one segment for each quarter (pi/2),
1
for as few as possible.reset – set start point to start of ellipse if path is empty
 ezdxf.path.add_spline(path: Path, spline: BSpline, level=4, reset=True) None ¶
Add a Bspline as multiple cubic Bèziercurves.
Nonrational Bsplines of 3rd degree gets a perfect conversion to cubic Bézier curves with a minimal count of curve segments, all other Bspline require much more curve segments for approximation.
Autodetect the connection point to the given path, if neither the start nor the end point of the Bspline is close to the path end point, a line from the path end point to the start point of the Bspline will be added automatically. (see
add_bezier4p()
).By default, the start of an empty path is set to the start point of the spline, setting argument reset to
False
prevents this behavior.
 ezdxf.path.bbox(paths: Iterable[Path], *, fast=False) BoundingBox ¶
Returns the
BoundingBox
for the given paths. Parameters:
paths – iterable of
Path
orPath2d
objectsfast – calculates the precise bounding box of Bèzier curves if
False
, otherwise uses the control points of Bézier curves to determine their bounding box.
 ezdxf.path.chamfer(points: Sequence[Vec3], length: float) Path ¶
Returns a
Path
with chamfers of given length between straight line segments. Parameters:
points – coordinates of the line segments
length – chamfer length
 ezdxf.path.chamfer2(points: Sequence[Vec3], a: float, b: float) Path ¶
Returns a
Path
with chamfers at the given distances a and b from the segment points between straight line segments. Parameters:
points – coordinates of the line segments
a – distance of the chamfer start point to the segment point
b – distance of the chamfer end point to the segment point
 ezdxf.path.fillet(points: Sequence[Vec3], radius: float) Path ¶
Returns a
Path
with circular fillets of given radius between straight line segments. Parameters:
points – coordinates of the line segments
radius – fillet radius
 ezdxf.path.fit_paths_into_box(paths: Iterable[Path], size: tuple[float, float, float], uniform: bool = True, source_box: BoundingBox  None = None) list[Path] ¶
Scale the given paths to fit into a box of the given size, so that all path vertices are inside these borders. If source_box is
None
the default source bounding box is calculated from the control points of the paths.Note: if the target size has a zsize of 0, the paths are projected into the xyplane, same is true for the xsize, projects into the yzplane and the ysize, projects into and xzplane.
 Parameters:
paths – iterable of
Path
objectssize – target box size as tuple of x, y and zsize values
uniform –
True
for uniform scalingsource_box – pass precalculated source bounding box, or
None
to calculate the default source bounding box from the control vertices
 ezdxf.path.have_close_control_vertices(a: Path, b: Path, *, rel_tol=1e9, abs_tol=1e12) bool ¶
Returns
True
if the control vertices of given paths are close.
 ezdxf.path.lines_to_curve3(path: Path) Path ¶
Replaces all lines by quadratic Bézier curves. Returns a new
Path
instance.
 ezdxf.path.lines_to_curve4(path: Path) Path ¶
Replaces all lines by cubic Bézier curves. Returns a new
Path
instance.
 ezdxf.path.polygonal_fillet(points: Sequence[Vec3], radius: float, count: int = 32) Path ¶
Returns a
Path
with polygonal fillets of given radius between straight line segments. The count argument defines the vertex count of the fillet for a full circle. Parameters:
points – coordinates of the line segments
radius – fillet radius
count – polygon vertex count for a full circle, minimum is 4
 ezdxf.path.single_paths(paths: Iterable[Path]) Iterable[Path] ¶
Yields all given paths and their subpaths as single path objects.
 ezdxf.path.to_multi_path(paths: Iterable[Path]) Path ¶
Returns a multipath object from all given paths and their subpaths. Ignores paths without any commands (empty paths).
 ezdxf.path.transform_paths(paths: Iterable[Path], m: Matrix44) list[Path] ¶
Transform multiple path objects at once by transformation matrix m. Returns a list of the transformed path objects.
 ezdxf.path.transform_paths_to_ocs(paths: Iterable[Path], ocs: OCS) list[Path] ¶
Transform multiple
Path
objects at once from WCS to OCS. Returns a list of the transformedPath
objects.
 ezdxf.path.triangulate(paths: Iterable[Path], max_sagitta: float = 0.01, min_segments: int = 16) Iterator[Sequence[Vec2]] ¶
Tessellate nested 2D paths into trianglefaces. For 3D paths the projection onto the xyplane will be triangulated.
 Parameters:
paths – iterable of nested Path instances
max_sagitta – maximum distance from the center of the curve to the center of the line segment between two approximation points to determine if a segment should be subdivided.
min_segments – minimum segment count per Bézier curve
Basic Shapes¶
 ezdxf.path.elliptic_transformation(center: UVec = (0, 0, 0), radius: float = 1, ratio: float = 1, rotation: float = 0) Matrix44 ¶
Returns the transformation matrix to transform a unit circle into an arbitrary circular or elliptic arc.
Example how to create an ellipse with a major axis length of 3, a minor axis length 1.5 and rotated about 90°:
m = elliptic_transformation(radius=3, ratio=0.5, rotation=math.pi / 2) ellipse = shapes.unit_circle(transform=m)
 Parameters:
center – curve center in WCS
radius – radius of the major axis in drawing units
ratio – ratio of minor axis to major axis
rotation – rotation angle about the zaxis in radians
 ezdxf.path.gear(count: int, top_width: float, bottom_width: float, height: float, outside_radius: float, transform: Matrix44  None = None) Path ¶
Returns a gear (cogwheel) shape as a
Path
object, with the center at (0, 0, 0). The base geometry is created by functionezdxf.render.forms.gear()
.Warning
This function does not create correct gears for mechanical engineering!
 Parameters:
count – teeth count >= 3
top_width – teeth width at outside radius
bottom_width – teeth width at base radius
height – teeth height; base radius = outside radius  height
outside_radius – outside radius
transform – transformation Matrix applied to the gear shape
 ezdxf.path.helix(radius: float, pitch: float, turns: float, ccw=True, segments: int = 4) Path ¶
Returns a helix as a
Path
object. The center of the helix is always (0, 0, 0), a positive pitch value creates a helix along the +zaxis, a negative value along the zaxis. Parameters:
radius – helix radius
pitch – the height of one complete helix turn
turns – count of turns
ccw – creates a counterclockwise turning (righthanded) helix if
True
segments – cubic Bezier segments per turn
 ezdxf.path.ngon(count: int, length: float  None = None, radius: float = 1.0, transform: Matrix44  None = None) Path ¶
Returns a regular polygon a
Path
object, with the center at (0, 0, 0). The polygon size is determined by the edge length or the circum radius argument. If both are given length has higher priority. Default size is a radius of 1. The ngon starts with the first vertex is on the xaxis! The base geometry is created by functionezdxf.render.forms.ngon()
. Parameters:
count – count of polygon corners >= 3
length – length of polygon side
radius – circum radius, default is 1
transform – transformation Matrix applied to the ngon
 ezdxf.path.rect(width: float = 1, height: float = 1, transform: Matrix44  None = None) Path ¶
Returns a closed rectangle as a
Path
object, with the center at (0, 0, 0) and the given width and height in drawing units. Parameters:
width – width of the rectangle in drawing units, width > 0
height – height of the rectangle in drawing units, height > 0
transform – transformation Matrix applied to the rectangle
 ezdxf.path.star(count: int, r1: float, r2: float, transform: Matrix44  None = None) Path ¶
Returns a star shape as a
Path
object, with the center at (0, 0, 0).Argument count defines the count of star spikes, r1 defines the radius of the “outer” vertices and r2 defines the radius of the “inner” vertices, but this does not mean that r1 has to be greater than r2. The star shape starts with the first vertex is on the xaxis! The base geometry is created by function
ezdxf.render.forms.star()
. Parameters:
count – spike count >= 3
r1 – radius 1
r2 – radius 2
transform – transformation Matrix applied to the star
 ezdxf.path.unit_circle(start_angle: float = 0, end_angle: float = math.tau, segments: int = 1, transform: Matrix44  None = None) Path ¶
Returns a unit circle as a
Path
object, with the center at (0, 0, 0) and the radius of 1 drawing unit.The arc spans from the start to the end angle in counterclockwise orientation. The end angle has to be greater than the start angle and the angle span has to be greater than 0.
 Parameters:
start_angle – start angle in radians
end_angle – end angle in radians (end_angle > start_angle!)
segments – count of Bèziercurve segments, default is one segment for each arc quarter (π/2)
transform – transformation Matrix applied to the unit circle
 ezdxf.path.wedge(start_angle: float, end_angle: float, segments: int = 1, transform: Matrix44  None = None) Path ¶
Returns a wedge as a
Path
object, with the center at (0, 0, 0) and the radius of 1 drawing unit.The arc spans from the start to the end angle in counterclockwise orientation. The end angle has to be greater than the start angle and the angle span has to be greater than 0.
 Parameters:
start_angle – start angle in radians
end_angle – end angle in radians (end_angle > start_angle!)
segments – count of Bèziercurve segments, default is one segment for each arc quarter (π/2)
transform – transformation Matrix applied to the wedge
The text2path
addon provides additional functions to
create paths from text strings and DXF text entities.
The Path Class¶
 class ezdxf.path.Path¶

 property has_curves: bool¶
Returns
True
if the path has any curve segments.
 property has_lines: bool¶
Returns
True
if the path has any line segments.
 property has_sub_paths: bool¶
Returns
True
if the path is a MultiPath object that contains multiple subpaths.
 property is_closed: bool¶
Returns
True
if the start point is close to the end point.
 property user_data: Any¶
Attach arbitrary user data to a
Path
object. The user data is copied by reference, no deep copy is applied therefore a mutable state is shared between copies.
 append_path(path: Path) None ¶
Append another path to this path. Adds a
self.line_to(path.start)
if the end of this path != the start of appended path.
 approximate(segments: int = 20) Iterator[Vec3] ¶
Approximate path by vertices, segments is the count of approximation segments for each Bézier curve.
Does not yield any vertices for empty paths, where only a start point is present!
Approximation of MultiPath objects is possible, but gaps are indistinguishable from line segments.
 bbox() BoundingBox ¶
Returns the bounding box of all control vertices as
BoundingBox
instance.
 clockwise() Self ¶
Returns new
Path
in clockwise orientation. Raises:
TypeError – can’t detect orientation of a MultiPath object
 close() None ¶
Close path by adding a line segment from the end point to the start point.
 close_sub_path() None ¶
Close last subpath by adding a line segment from the end point to the start point of the last subpath. Behaves like
close()
for SinglePath instances.
 counter_clockwise() Self ¶
Returns new
Path
in counterclockwise orientation. Raises:
TypeError – can’t detect orientation of a MultiPath object
 curve3_to(location: UVec, ctrl: UVec) None ¶
Add a quadratic Bèziercurve from actual path end point to location, ctrl is the control point for the quadratic Bèziercurve.
 curve4_to(location: UVec, ctrl1: UVec, ctrl2: UVec) None ¶
Add a cubic Bèziercurve from actual path end point to location, ctrl1 and ctrl2 are the control points for the cubic Bèziercurve.
 extend_multi_path(path: Path) None ¶
Extend the path by another path. The source path is automatically a MultiPath object, even if the previous end point matches the start point of the appended path. Ignores paths without any commands (empty paths).
 flattening(distance: float, segments: int = 4) Iterator[Vec3] ¶
Approximate path by vertices and use adaptive recursive flattening to approximate Bèzier curves. The argument segments is the minimum count of approximation segments for each curve, if the distance from the center of the approximation segment to the curve is bigger than distance the segment will be subdivided.
Does not yield any vertices for empty paths, where only a start point is present!
Flattening of MultiPath objects is possible, but gaps are indistinguishable from line segments.
 Parameters:
distance – maximum distance from the center of the curve to the center of the line segment between two approximation points to determine if a segment should be subdivided.
segments – minimum segment count per Bézier curve
 has_clockwise_orientation() bool ¶
Returns
True
if 2D path has clockwise orientation, ignores zaxis of all control vertices. Raises:
TypeError – can’t detect orientation of a MultiPath object
 move_to(location: UVec) None ¶
Start a new subpath at location. This creates a gap between the current endpoint and the startpoint of the new subpath. This converts the instance into a MultiPath object.
If the
move_to()
command is the first command, the start point of the path will be reset to location.
 sub_paths() Iterator[Self] ¶
Yield all subpaths as SinglePath objects.
It’s safe to call
sub_paths()
on any pathtype: SinglePath, MultiPath and EmptyPath.