Martin McBride, 2020-10-27
Tags geometry path
Categories generativepy generative art

generativepy has moved to the website, and this page might not be up to date. Please visit the new location.

The Path class creates a shape based on a path object.

A path object can be obtained using the path method of any Shape object - a Rectangle, Circle, or even a Text objetc can be used to create a path.

See the paths tutorial for examples.

Path class methods

The Path class inherits add, fill, stroke, fill_stroke, path, clip and other methods from Shape.

It has additional methods:

  • of


Creates a shape based on an existing path.

Parameter Type Description
path Pycairo path object A path

A path object is usually obtained by calling the path method another shape. A Path object recreates the shape and allows it to be filled.

Here is an example:

p = Rectangle(ctx).of_corner_size((0.5, 0.5), 1, 3).path()


The first line creates a rectangle, but doesn't draw it, instead it obtains a path object p.

At some point later in the code, you can draw the shape by passing p into a Path object and filling or stroking it.

This is useful if you want to reuse a path, drawing it multiple times, or if you need to create a path is one part of your code but store it for use somewhere else. Paths also have advanced applications such as drawing text along a curve.

Copyright (c) Axlesoft Ltd 2021