Generic features and parameters

The label layout algorithm stops if the allowed time setting has elapsed. This feature works similarly as in IlvGraphLayout; see Allowed time. If the layout stops early because the allowed time has elapsed, the result code in the layout report is IlvLabelLayoutReport.STOPPED_AND_INVALID.

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

The Random Label Layout uses a random number generator to compute the coordinates. 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.

You can specify a particular value to be used as a seed value. For example, to specify the seed value 10 , call:

layout.setUseSeedValueForRandomGenerator(true);
layout.setSeedValueForRandomGenerator(10);

The label 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 Using named properties to save layout parameters.)

The label layout algorithm stops after cleanup if the method stopImmediately is called. (This method works for the IlvLabelLayout class similarly to the corresponding method in the IlvGraphLayout class. For a description of this method in the IlvGraphLayout class, see Stop immediately. If the layout stops early in this way, the result code in the layout report is IlvLabelLayoutReport.STOPPED_AND_INVALID .

After modifying any label layout parameter, you may want the layout algorithm to use the default values. You select the default values for all parameters by:

layout.setUseDefaultParameters(true);

layout.setUseDefaultParameters(false);