public class ALspDiscreteLabelingAlgorithmWrapper extends ALspDiscreteLabelingAlgorithm
This class can be used to create a labeling algorithm wrapper based on the
ALspDiscreteLabelingAlgorithm abstract algorithm.
When using this wrapper, the 'create' methods should be implemented by creating an
iterator or evaluator using the delegate algorithm, and returning a wrapped iterator of
evaluator.
ILspLabelingAlgorithm.LabelContextCONSECUTIVE_LABEL_CONFLICT_FAIL_COUNT_KEY, CONSECUTIVE_LABEL_FAIL_COUNT_KEY, LABEL_ATTEMPT_COUNT_KEY, LABEL_CONFLICT_FAIL_COUNT_KEY, LABEL_FAIL_COUNT_KEY, LABEL_PLACED_COUNT_KEY, TOTAL_LABEL_COUNT_KEY| Constructor and Description |
|---|
ALspDiscreteLabelingAlgorithmWrapper(ALspDiscreteLabelingAlgorithm aDelegate)
Creates a new algorithm wrapper wrapping the given discrete labeling algorithm.
|
| Modifier and Type | Method and Description |
|---|---|
protected Iterator<TLspLabelID> |
createLabelIterator(List<TLspLabelID> aLabels,
ILspLabelingAlgorithm.LabelContext aLabelContext,
ILspLabelConflictChecker aConflictChecker,
ILspView aView)
Creates a new
Iterator that iterates over the TLspLabelIDs. |
protected ILspLabelPlacementEvaluator |
createLabelPlacementEvaluator(List<TLspLabelID> aLabels,
ILspLabelingAlgorithm.LabelContext aLabelContext,
ILspLabelConflictChecker aConflictChecker,
ILspView aView)
Creates a new
ILspLabelPlacementEvaluator using the given parameters. |
protected Iterator<TLspLabelPlacement> |
createLabelPlacementIterator(TLspLabelID aLabel,
ALspLabelLocations aCurrentLabelLocations,
ILspLabelingAlgorithm.LabelContext aLabelContext,
ILspLabelConflictChecker aConflictChecker,
ILspView aView)
Creates a new
Iterator that iterates over the TLspLabelPlacements for
the given label. |
ALspDiscreteLabelingAlgorithm |
getDelegate()
Returns the wrapped algorithm.
|
double |
getQuality()
Returns the quality setting.
|
void |
setQuality(double aQuality)
Sets the quality.
|
clone, placeLabelspublic ALspDiscreteLabelingAlgorithmWrapper(ALspDiscreteLabelingAlgorithm aDelegate)
aDelegate - a delegate labeling algorithm.public ALspDiscreteLabelingAlgorithm getDelegate()
public void setQuality(double aQuality)
ALspDiscreteLabelingAlgorithmSets the quality. If the quality setting is high, the algorithm will try to place more
labels. If it is low, the algorithm will only try to place a small portion of the labels,
making label placement faster. Setting the quality to e.g. 0.5 can dramatically
improve the label placement performance in some cases.
E.g. it is possible that due to the quality setting, this algorithm will only try to place 10% of the labels. This may still result in high quality results, but this depends on the used data. In general, using a lower quality setting will still work well when the data (and its labels) are distributed uniformly over the screen.
By default, the quality is set to 1.0.
setQuality in class ALspDiscreteLabelingAlgorithmaQuality - the new quality. This is a number in [0, 1].ALspDiscreteLabelingAlgorithm.getQuality()public double getQuality()
ALspDiscreteLabelingAlgorithmgetQuality in class ALspDiscreteLabelingAlgorithmALspDiscreteLabelingAlgorithm.setQuality(double)protected Iterator<TLspLabelID> createLabelIterator(List<TLspLabelID> aLabels, ILspLabelingAlgorithm.LabelContext aLabelContext, ILspLabelConflictChecker aConflictChecker, ILspView aView)
ALspDiscreteLabelingAlgorithmIterator that iterates over the TLspLabelIDs. The abstract algorithm will continue
iterating over TLspLabelIDs as long as Iterator.hasNext()
returns true. When it returns false, no more label placements will be
tried, and placeLabels returns. Iterator.hasNext() should always be called before
calling Iterator.next(), and if it returns true, Iterator.next() should never return null. The implementation of
this method should be as independent as possible. It should not rely on createLabelPlacementIterator or createLabelPlacementEvaluator. Not respecting this might result
in unexpected behaviour when wrapping or extending this class.
Override this method to provide a custom implementation.
createLabelIterator in class ALspDiscreteLabelingAlgorithmaLabels - a list of labels that need to be placed.aLabelContext - the label info object.aConflictChecker - the conflict checker to be used when evaluating placements.aView - the view.Iterator that iterates over TLspLabelIDs.protected Iterator<TLspLabelPlacement> createLabelPlacementIterator(TLspLabelID aLabel, ALspLabelLocations aCurrentLabelLocations, ILspLabelingAlgorithm.LabelContext aLabelContext, ILspLabelConflictChecker aConflictChecker, ILspView aView)
ALspDiscreteLabelingAlgorithmIterator that iterates over the TLspLabelPlacements for
the given label. The abstract algorithm will continue iterating over
TLspLabelPlacements as long as Iterator.hasNext() returns
true. When it returns false, a new label will be tried. Iterator.hasNext() should always be called before calling Iterator.next(), and if it
returns true, Iterator.next() should never return null.
The implementation of this method should be as independent as possible. It should not rely on
createLabelIterator or createLabelPlacementEvaluator. Not respecting this might result in unexpected behaviour when
wrapping or extending this class.
The returned TLspLabelPlacement should be
correctly initialized, that is it should at least be able to return a valid label location,
bounds rectangle and bounds rotation. It should also reference its corresponding
TLspLabelID.
Override this method to provide a custom implementation.
createLabelPlacementIterator in class ALspDiscreteLabelingAlgorithmaLabel - the identifier for which an iterator should be created.aCurrentLabelLocations - an ALspLabelLocations object containing locations for the
currently placed labels.aLabelContext - the label info object.aConflictChecker - the conflict checker to be used when evaluating placements.aView - the view.Iterator that iterates over TLspLabelPlacements.protected ILspLabelPlacementEvaluator createLabelPlacementEvaluator(List<TLspLabelID> aLabels, ILspLabelingAlgorithm.LabelContext aLabelContext, ILspLabelConflictChecker aConflictChecker, ILspView aView)
ALspDiscreteLabelingAlgorithmILspLabelPlacementEvaluator using the given parameters. It evaluates
the placements returned by createLabelPlacementIterator,
and returns a PlacementResult to denote if the placement should be used for its
label or not. The following actions are undertaken for the following placement results :
PlacementResult.SUCCESS :
the given placement will be used for its label, it will be added to the list of placed
representations, and it will be added to the given ILspLabelConflictChecker. After
that, ILspLabelPlacementEvaluator.placementApplied
will be called and no more placements are tried for the label.PlacementResult.FALLBACK : the abstract
algorithm will try to find an other placements which returns PlacementResult.SUCCESS. When no such
placement is found, this placement will be added to the list of placed labels, and it will be
added to the given ILspLabelConflictChecker. After that, ILspLabelPlacementEvaluator.placementApplied will
be called.PlacementResult.TRY_NEW_PLACEMENT : the abstract algorithm will try to find an other placement
which returns PlacementResult.SUCCESS or PlacementResult.FALLBACK. When no such placement is found, ILspLabelPlacementEvaluator.noPlacementApplied
is called.PlacementResult.FAILED : the abstract algorithm will immediately call ILspLabelPlacementEvaluator.noPlacementApplied
and will not try to find other placements for the label.Override this method to provide a custom implementation.
createLabelPlacementEvaluator in class ALspDiscreteLabelingAlgorithmaLabels - a list of labels.aLabelContext - the label info object.aConflictChecker - the conflict checker to be used when evaluating placements.aView - the viewILspLabelPlacementEvaluator.ILspLabelPlacementEvaluator