Generic features and parameters of the ULEL

Overview (ULEL)

The IlvUniformLengthEdgesLayout class supports the following generic parameters defined in the IlvGraphLayout class (see Base class parameters and features):
The following subsections describe the particular way in which these parameters are used by this subclass.

Allowed time (ULEL)

The layout algorithm stops if the allowed time setting has elapsed. (See Allowed time.)

Animation (ULEL)

If animation is specified, a redraw is automatically performed after each step of the layout algorithm. (See Animation.)

Layout of connected components (ULEL)

The layout algorithm can use the generic mechanism to lay out connected components. (For more information about this mechanism; see Layout of connected components.)

Layout region (ULEL)

The layout algorithm can use the layout region setting (either your own or the default setting) to control the size and the position of the graph drawing. All three ways to specify the layout region are available for this subclass. (See Layout region.)
By default, the Uniform Length Edges Layout algorithm does not use the layout region. (For details see also Force fit to layout region (ULEL).)
Remember that if you are using the default settings, the visible area of the manager view (an instance of IlvManagerView) attached to the grapher is used as a layout region. If several manager views are attached, the first attached view is used. If no manager view is attached, the layout region is automatically estimated on the basis of the number and size of the nodes.

Link clipping (ULEL)

The layout algorithm can use a link clip interface to clip the end points of a link. (See Link clipping.)
This is useful if the nodes have a nonrectangular shape such as a triangle, rhombus, or circle. If no link clip interface is used, the links are normally connected to the bounding boxes of the nodes, not to the border of the node shapes. See Using a link clipping interface with ULEL for details of the link clipping mechanism.

Link connection box (ULEL)

The layout algorithm can use a link connection box interface to calculate the center of a node. See Link connection box.
It is used when the option to connect links to node centers or link clipping is enabled.
It is only used if the link style is straight line. It is also used for self-links and multilinks, depending on the self-link or multilink mode.

Preserve fixed links (ULEL)

The layout algorithm does not reshape the links that are specified as fixed. (See Preserve fixed links and Link style (ULEL).)

Preserve fixed nodes (ULEL)

The layout algorithm does not move the nodes that are specified as fixed. Moreover, the algorithm takes into account the fixed nodes when computing the position of the nonfixed nodes. (See Preserve fixed nodes.)

Save parameters to named properties (ULEL)

The layout algorithm is able to save its layout parameters into named properties. This can be used to save layout parameters to .ivl files. (For a detailed description of this feature, see Save parameters to named properties and Saving layout parameters and preferred layouts).

Stop immediately (ULEL)

The layout algorithm stops after cleanup if the method stopImmediately is called. (For a description of this method in the IlvGraphLayout class, see Stop immediately.) If the layout stops early because the allowed time has elapsed, the result code in the layout report is IlvGraphLayoutReport.STOPPED_AND_VALID .