IlvLevelRangeConstraint (Perforce JViews 10.0 API)

java.lang.Object
- ilog.views.graphlayout.hierarchical.IlvHierarchicalConstraint
- - ilog.views.graphlayout.hierarchical.IlvLevelRangeConstraint

All Implemented Interfaces:

IlvPersistentObject, Serializable
```
public class IlvLevelRangeConstraint
extends IlvHierarchicalConstraint
```
The class IlvLevelRangeConstraint is a constraint that forces the node to be placed at a level with index within the specified range.
Nodes are organized in horizontal or vertical levels numbered from 0 to "n". If the link flow direction is from top to bottom, the nodes with level index 0 are placed in the topmost level, and the nodes with higher level indexes are placed in the levels below. If the link flow direction is from left to right, the nodes with level index 0 are placed in the leftmost level, and the nodes with higher level indexes are placed in the levels farther to the right.
For instance, a level range constraint with minimum index 5 and maximum index 7 causes the node to be placed at level with index 5, 6, or 7. A level range with minimum index 6 and maximum index 6 causes the node to be placed exactly at level 6. This has the same effect as specifying the node level index 6 by IlvHierarchicalLayout.setSpecNodeLevelIndex(Object, int).
The constraint is evaluated, if the incremental mode is disabled. If the incremental mode is enabled, the constraint is only evaluated if the constraint node is marked for incremental recalculation, because otherwise, the incremental positions of the nodes are dominant.
This kind of constraint is dominated by same level constraints and group spread constraints, that is, two nodes cannot have different level ranges while being forced to the same level. The constraint has higher priority than any relative level constraints.
The automatic conflict resolution can handle conflicting constraints. However, to speedup the layout, it is recommended to specify constraints in a way such that there are no conflicts.
Note that empty levels are invisible after layout. For instance a node with level range constraint to be placed at level 2 may appear to be placed in the topmost level, if level 0 and 1 don't contain any other nodes.
In recursive layout mode (see IlvHierarchicalLayout.setRecursiveLayoutMode(boolean)), all nodes of the group of a level spread constraint must belong to the same subgraph, and the constraint must be installed at the layout instance that is attached to this subgraph. It is not possible to have a level spread constraint containing a group of nodes of different subgraphs.

Since:

JViews 5.0

See Also:

IlvHierarchicalLayout.addConstraint(IlvHierarchicalConstraint), IlvHierarchicalLayout.setIncrementalMode(boolean), IlvHierarchicalLayout.markForIncremental(Object), Serialized Form

Constructor Summary

Constructors
Constructor and Description
`IlvLevelRangeConstraint(IlvInputStream stream)` Creates a new `IlvLevelRangeConstraint` from an `IlvInputStream`.
`IlvLevelRangeConstraint(IlvLevelRangeConstraint source)` Creates a new `IlvLevelRangeConstraint` by copying an existing one.
`IlvLevelRangeConstraint(Object nodeOrGroup, int minLevel, int maxLevel)` Creates a new `IlvLevelRangeConstraint` .

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`IlvHierarchicalConstraint`	`copy()` Copies the constraint.
`int`	`getMaxLevel()` Returns the maximum level index suitable for the subject of this constraint (that is, for the node or the group of nodes).
`int`	`getMinLevel()` Returns the minimum level index suitable for the subject of this constraint (that is, for the node or the group of nodes).
`Object`	`getSubject()` Returns the subject of this constraint.
`void`	`setLevelRange(int minLevel, int maxLevel)` Sets the level range suitable for the subject of this constraint (that is, for the node or the group of nodes).
`void`	`setMaxLevel(int maxLevel)` Sets the maximum level index suitable for the subject of this constraint, that is, for the node or the group of nodes.
`void`	`setMinLevel(int minLevel)` Sets the minimum level index suitable for the subject of this constraint, that is, for the node or the group of nodes.
`void`	`write(IlvOutputStream stream)` Writes the constraint to the output stream.

Methods inherited from class ilog.views.graphlayout.hierarchical.IlvHierarchicalConstraint
getPriority, setPriority

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - IlvLevelRangeConstraint
```
public IlvLevelRangeConstraint(Object nodeOrGroup,
                               int minLevel,
                               int maxLevel)
```
    Creates a new IlvLevelRangeConstraint .
    The following examples show how to use the constraint:
```
 layout.addConstraint(new IlvLevelRangeConstraint(node1, 5, 7));
 layout.addConstraint(new IlvLevelRangeConstraint(node2,
                             5, IlvHierarchicalLayout.UNSPECIFIED));
 layout.addConstraint(new IlvLevelRangeConstraint(node3,
                             IlvHierarchicalLayout.UNSPECIFIED, 7)); 
```
    This forces node1 to be in level 5, 6, or 7, and node2 to be in a level with index greater or equal to 5, and node3 to be in a level with index smaller or equal to 7.
    Parameters:
    
    nodeOrGroup - A node, or a group of type IlvNodeGroup, that should be placed in the specified level range.
    
    minLevel - The lower bound of the level range, or IlvHierarchicalLayout.UNSPECIFIED if no lower bound is needed.
    
    maxLevel - The upper bound of the level range, or IlvHierarchicalLayout.UNSPECIFIED if no upper bound is needed.
    
    See Also:
    
    setLevelRange(int, int), IlvHierarchicalLayout.addConstraint(IlvHierarchicalConstraint)
  - IlvLevelRangeConstraint
```
public IlvLevelRangeConstraint(IlvLevelRangeConstraint source)
```
    Creates a new IlvLevelRangeConstraint by copying an existing one.
    
    Parameters:
    
    source - The origin of the copy.
  - IlvLevelRangeConstraint
```
public IlvLevelRangeConstraint(IlvInputStream stream)
                        throws IOException,
                               IlvReadFileException
```
    Creates a new IlvLevelRangeConstraint from an IlvInputStream.
    
    Parameters:
    
    stream - The input stream from which the property must be read.
    
    Throws:
    
    IlvReadFileException - if an error occurs while reading.
    
    IOException
- Method Detail
  - copy
```
public IlvHierarchicalConstraint copy()
```
    Copies the constraint.
    
    Specified by:
    
    copy in class IlvHierarchicalConstraint
  - write
```
public void write(IlvOutputStream stream)
           throws IOException
```
    Writes the constraint to the output stream.
    
    Specified by:
    
    write in interface IlvPersistentObject
    
    Overrides:
    
    write in class IlvHierarchicalConstraint
    
    Parameters:
    
    stream - The output stream.
    
    Throws:
    
    IOException - standard IO error.
  - getSubject
```
public final Object getSubject()
```
    Returns the subject of this constraint. This is either the constraint node, or the instance of IlvNodeGroup that describes a group of nodes.
  - getMinLevel
```
public final int getMinLevel()
```
    Returns the minimum level index suitable for the subject of this constraint (that is, for the node or the group of nodes).
    
    See Also:
    
    setLevelRange(int, int)
  - setMinLevel
```
public final void setMinLevel(int minLevel)
```
    Sets the minimum level index suitable for the subject of this constraint, that is, for the node or the group of nodes.
    
    Parameters:
    
    minLevel - The minimum level index suitable for the subject of this constraint.
    
    Since:
    
    JViews 8.1
    
    See Also:
    
    setLevelRange(int, int)
  - getMaxLevel
```
public final int getMaxLevel()
```
    Returns the maximum level index suitable for the subject of this constraint (that is, for the node or the group of nodes).
    
    See Also:
    
    setLevelRange(int, int)
  - setMaxLevel
```
public final void setMaxLevel(int maxLevel)
```
    Sets the maximum level index suitable for the subject of this constraint, that is, for the node or the group of nodes.
    
    Parameters:
    
    maxLevel - The maximum level index suitable for the subject of this constraint.
    
    Since:
    
    JViews 8.1
    
    See Also:
    
    setLevelRange(int, int)
  - setLevelRange
```
public final void setLevelRange(int minLevel,
                                int maxLevel)
```
    Sets the level range suitable for the subject of this constraint (that is, for the node or the group of nodes). Examples:
```
 
 constraint1.setLevelRange(5, 7);
 constraint2.setLevelRange(5, IlvHierarchicalLayout.UNSPECIFIED);
 constraint3.setLevelRange(IlvHierarchicalLayout.UNSPECIFIED, 7); 
 
```
    The first statement forces the node or node group to be level 5, 6, or 7. The second statement forces the node or node group to be in a level with index greater or equal to 5. The third statement forces the node or node group to be in a level with index smaller or equal to 7.
    Parameters:
    
    minLevel - The lower bound of the level range, or IlvHierarchicalLayout.UNSPECIFIED if no lower bound is needed.
    
    maxLevel - The upper bound of the level range, or IlvHierarchicalLayout.UNSPECIFIED if no upper bound is needed.
    
    See Also:
    
    getMinLevel(), getMaxLevel()

Class IlvLevelRangeConstraint

Constructor Summary

Method Summary

Methods inherited from class ilog.views.graphlayout.hierarchical.IlvHierarchicalConstraint

Methods inherited from class java.lang.Object

Constructor Detail

IlvLevelRangeConstraint

IlvLevelRangeConstraint

IlvLevelRangeConstraint

Method Detail

copy

write

getSubject

getMinLevel

setMinLevel

getMaxLevel

setMaxLevel

setLevelRange