y.layout
Class CompositeLayouter

java.lang.Object
  y.layout.CompositeLayouter

All Implemented Interfaces:

Layouter

public class CompositeLayouter
extends java.lang.Object
implements Layouter

A CompositeLayouter allows for wrapping a core layout algorithm with multiple LayoutStages.

The LayoutStages are organized in a pipeline where additional LayoutStages can be prepended or appended.

Each LayoutStage in the pipeline executes its pre-processing code before calling its successor LayoutStage. Then, after all subsequent LayoutStages have finished, it will execute its post-processing code.

Note that the pipeline only works when all LayoutStages call their core layout algorithm which is the next LayoutStage in the pipeline.

Field Summary

Fields inherited from interface y.layout.Layouter

EDGE_ID_DPKEY, NODE_ID_DPKEY, NODE_TYPE_DPKEY, SELECTED_EDGES, SELECTED_NODES

Constructor Summary

CompositeLayouter(LayoutStage stage, Layouter coreLayouter)
Creates a new CompositeLayouter instance that prepends the specified LayoutStage to the given layout algorithm.

Method Summary

void	appendStage(LayoutStage stage) Appends a LayoutStage to the previously added LayoutStages.
boolean	canLayout(LayoutGraph graph) Accepts all graphs that are accepted by the complete pipeline of LayoutStages.
void	doLayout(LayoutGraph graph) Executes the pipeline of LayoutStage and the core layout algorithm which apply the layout to the graph.
java.util.List	getLayoutStages() Returns the complete pipeline of LayoutStages that were added to this CompositeLayouter.
void	prependStage(LayoutStage stage) Prepends a LayoutStage to the previously added LayoutStages.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

CompositeLayouter

public CompositeLayouter(LayoutStage stage,
                         Layouter coreLayouter)

Creates a new CompositeLayouter instance that prepends the specified LayoutStage to the given layout algorithm.

Parameters:

stage - the stage to prepend to the core algorithm

coreLayouter - the core layout algorithm

Method Detail

prependStage

public void prependStage(LayoutStage stage)

Prepends a LayoutStage to the previously added LayoutStages. The added LayoutStage will be invoked before any other LayoutStage. Its pre-processing code will be executed before the already added LayoutStages' pre-processing code while its post-processing code will be executed after the post-processing code of all the other LayoutStages.

Parameters:

stage - the stage to prepend

getLayoutStages

public java.util.List getLayoutStages()

Returns the complete pipeline of LayoutStages that were added to this CompositeLayouter.

Returns:

a list of all LayoutStages in the pipeline

appendStage

public void appendStage(LayoutStage stage)

Appends a LayoutStage to the previously added LayoutStages. The added LayoutStage will be invoked just before the core layout algorithm will be invoked. Its pre-processing code will be executed after the already added LayoutStages' pre-processing code while its post-processing code will be executed before the post-processing code of all the other LayoutStages.

Parameters:

stage - the stage to append

canLayout

public boolean canLayout(LayoutGraph graph)

Accepts all graphs that are accepted by the complete pipeline of LayoutStages.

Specified by:

canLayout in interface Layouter

Parameters:

graph - the input graph

Returns:

true if all LayoutStages and the core layout algorithm can handle the graph

See Also:

Layouter.doLayout(LayoutGraph)

doLayout

public void doLayout(LayoutGraph graph)

Executes the pipeline of LayoutStage and the core layout algorithm which apply the layout to the graph.

Specified by:

doLayout in interface Layouter

Parameters:

graph - the input graph

See Also:

Layouter.canLayout(LayoutGraph)