Generic features and parameters of the RL

The IlvRandomLayout class supports the following generic parameters defined in the IlvGraphLayout class. See Base class parameters and features:
The following sections describe the particular way in which these parameters are used by this subclass.

Allowed time (RL)

The layout algorithm stops if the allowed time setting elapses. See Allowed time.

Layout of connected components (RL)

The layout algorithm can use the generic mechanism to lay out connected components. In this case, each connected component is placed separately. For more information about this mechanism, see Layout of connected components.

Layout region (RL)

The layout algorithm uses 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.

Link clipping (RL)

The layout algorithm can use a link clip interface to clip the end points of a link. See Link clipping. The link clipping parameter is useful when the nodes have a shape other than a rectangle, 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.

Link connection box (RL)

The layout algorithm can use a link connection box interface to calculate the center of a node. See Link connection box. This interface is only used when the link style is straight line.
This interface is used when one or other of the following features is enabled:
  • Connect links to node centers
  • Link clipping
This interface is also used for self-links and multilinks, depending on the mode of the self-link or multilinks.

Percentage of completion calculation (RL)

The layout algorithm calculates the estimated percentage of completion. This value can be obtained from the layout report during the run of the layout. For a detailed description of this feature, see Percentage of completion calculation and Graph layout event listeners.

Preserve fixed links (RL)

The layout algorithm does not reshape the links that are specified as fixed. See Preserve fixed links.

Preserve fixed nodes (RL)

The layout algorithm does not move the nodes that are specified as fixed. See Preserve fixed nodes.

Random generator seed value (RL)

The Random Layout uses a random number generator to compute the coordinates. You can specify a particular value to be used as a seed value. (See Random generator seed value) For the default behavior, the random generator is initialized using the current system clock. Therefore, different layouts are obtained if you perform the layout repeatedly on the same graph.

Save Parameters to Named Properties (RL)

The layout algorithm can 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 (RL)

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_INVALID .