Lift a list of primitives to a composite picture.

The order of the list maps to the zorder - the front of the list is drawn at the top.

This function throws an error when supplied the empty list.

Place multiple pictures within the standard affine frame.

This function throws an error when supplied the empty list.

Create a Path from a start point and a list of PathSegments.

Create a straight-line PathSegment.

Create a curved PathSegment.

Convert the list of vertices to a path of straight line segments.

Convert a list of vertices to a path of curve segments. The first point in the list makes the start point, each curve segment thereafter takes 3 points. Spare points at the end are discarded.

Create a open, stroked path (ostroke) or a closed, stroked path (cstroke).

ostroke and cstroke are overloaded to make attributing the path more convenient.

Create an open stoke coloured black.

Create a closed stroke coloured black.

Create a filled path (fill). Fills only have one property - colour. But there are various representations of colour.

fill () will fill with the default colour - black.

Create a filled path coloured black.

Create an ellipse, the ellipse will be filled unless the supplied attributes imply a stroked ellipse, e.g.:

 ellipse (LineWidth 4) zeroPt 40 40 

Note - within Wumpus, ellipses are considered an unfortunate but useful optimization. Drawing good cicles with Beziers needs at least eight curves, but drawing them with PostScript's arc command is a single operation. For drawings with many dots (e.g. scatter plots) it seems sensible to employ this optimaztion.

A deficiency of Wumpus's ellipse is that (non-uniformly) scaling a stroked ellipse also (non-uniformly) scales the pen it is drawn with. Where the ellipse is wider, the pen stroke will be wider too.

Create a black, filled ellipse.

Clip a picture with respect to the supplied path.

Create a text label. The string should not contain newline or tab characters. Use multilabel to create text with multiple lines.

textlabel is overloaded to make attributing the label more convenient.

Unless a FontAttr is specified, the label will use 14pt Courier.

The supplied point is is the bottom left corner.

Create a label where the font is Courier, text size is 14pt and colour is black.

Extend the bounding box of a picture.

The bounding box is both horizontal directions by x and both vertical directions by y. x and y must be positive This function cannot be used to shrink a boundary.

picOver : picture -> picture -> picture

Draw the first picture on top of the second picture - neither picture will be moved.

picMoveBy : picture -> vector -> picture

Move a picture by the supplied vector.

picBeside : picture -> picture -> picture

Move the second picture to sit at the right side of the first picture

Print the syntax tree of a Picture to the console.

illustrateBounds : colour -> picture -> picture

Draw the picture on top of an image of its bounding box. The bounding box image will be drawn in the supplied colour.

illustrateBoundsPrim : colour -> primitive -> picture

Draw the primitive on top of an image of its bounding box. The bounding box image will be drawn in the supplied colour.

The result will be lifted from Primitive to Picture.

Generate the control points illustrating the Bezier curves within a picture.

This has no effect on TextLabels.

Pseudo control points are generated for ellipses, although strictly speaking ellipses do not use Bezier curves - they are implemented with PostScript's arc command.