This module provides classes for connecting two
lines, arcs or curves. All constructors of the following connector-classes take
box-instances as the two first arguments. They return a
connecting path from the first to the second box. The overall geometry of the
path is such that is starts/ends at the boxes’ centers. It is then cut by the
boxes’ outlines. The resulting
connector will additionally be shortened
by lengths given in the boxdists (a list of two lengths,
Angle keywords can be either absolute or relative. The absolute angles refer to the angle between x-axis and the running tangent of the connector, while the relative angles are between the direct connecting line of the box-centers and the running tangent (see figure. The angle-parameters of the connector.arc (left panel) and the connector.curve (right panel) classes.).
The bulge-keywords parameterize the deviation of the connector from the connecting line. It has different meanings for different connectors (see figure. The angle-parameters of the connector.arc (left panel) and the connector.curve (right panel) classes.).
The constructor of the
line class accepts only boxes and the
The constructor takes either the relangle or a combination
of relbulge and absbulge. The “bulge” is meant to be a
hint for the greatest distance between the connecting arc and the straight
connection between the box-centers. (Default:
Note that the bulge-keywords override the angle-keyword.
If both relbulge and absbulge are given, they will be added.
The constructor takes both angle- and bulge-keywords. Here, the bulges are used as distances between the control points of the cubic Beziér-curve. For the signs of the angle- and bulge-keywords refer to figure The angle-parameters of the connector.arc (left panel) and the connector.curve (right panel) classes..
absangle1 or relangle1 — absangle2 or
relangle2, where the absolute angle overrides the relative if both
are given. (Default:
absbulge and relbulge, where they will be added if both
are given. — (Default:
relbulge=0.39; these default
values produce output similar to the defaults of
This class returns two connected straight lines. There is a vast variety of combinations for angle- and length-keywords. The user has to make sure to provide a non-ambiguous set of keywords:
absangle1 or relangle1 for the first angle, —
relangleM for the middle angle and — absangle2 or
relangle2 for the ending angle. Again, the absolute angle overrides
the relative if both are given. (Default: all five angles are
length1 and length2 for the lengths of the connecting