generativepy.shape2d module

The shape2d module provide support for abstract shapes.

The module provides a Points object that stores a list of points that can be used to represent a polygon. The list of points that can be manipulated before being drawn.

The module doesn't have any drawing capability of its own, but a Points object can be passed into a Polygon object's of_points method to draw the polygon.

A Points object can be created from a list of coordinates, or via static methods. Currently there is one stati method, to create a regaular polygon.

Future versions of this class will contain other methods for manipulating shapes.

Points

A Points object is a wrapper around a list of Vector objects that each represent one vertex of a polygon.

Points objects are immutable.

staticmethod regular_polygon

Returns a Points object representing a regular polygon

regular_polygon(sides, centre=(0, 0), radius=1, flat_base=True)

Create a Points object representing a regular polygon.

sides is the number of sides - 3 for an equilateral triangle, 4 for a square, etc.

centre is the centre of the polygon.

The radius is the radius of a circle that tightly encloses the polygon.

If flat_base is true the points will be arranged so that the polygon base is horizontal. If it is false the points will be arranged so that the first vertex is on the x-axis.

To obtain other orientations, use the rotate method.

Constructor

Creates a Points object.

Points(points)
Vector(seq)

points is a iterable containing a list of point values. It can be a list, a tuple, another Points object, or any other iterable with at least 3 values.

Each value within the points parameter must be a sequence of two numbers. It can be a list, a tuple, a Vector or similar.

transform

    transform(m)

Creates a Points that is the result of multiplying every point is this Points object by m.

scale

    scale(scale_x, scale_y=None)

Creates a Points that is the result of scaling every point is this Points object by scale_x in the x-direction and scale_y in the y-direction.

If scale_y is None, the points will be scaled by scale_x in both directions.

translate

    translate(x, y)

Creates a Points that is the result of translating every point is this Points object by (x, y).

rotate

    rotate(angle)

Creates a Points that is the result of rotating every point is this Points object by angle radians counterclockwise about the origin.

Standard operators

The Vector class supports a number of operators and built-in functions.

Variables used inn the examples:

• m ia a Matrix objects.
• p is a Points object.
• n is a number (int or float).

Operator examples:

m * p      # Multiply matrix by points object (is transfrom the object using m).
u == v     # Test for equality, uses the `is_close` function on each corresponding pair of elements.
u[n]       # nth element of u. n must be an integer between 0 and 1 inclusive.

Built-in function examples:

len(p)     # Number of elements in p
iter(p)    # Return an iterator that iterates over the values in p then stops.
str(p)     # String representation of p

See also

• generativepy.analytics module
• generativepy.bitmap module
• generativepy.color module
• generativepy.drawing module
• generativepy.drawing3d module
• generativepy.formulas module
• generativepy.geometry module
• generativepy.geometry3d module
• generativepy.gif module
• generativepy.graph module
• generativepy.math module
• generativepy.movie module
• generativepy.nparray module
• generativepy.table module
• generativepy.tween module
• generativepy.utils module