public class TLspLOSCoveragePainter extends Object implements ILspEditableStyledPainter, ILspStyleChangeListener
A painter that paints ILcdLOSCoverageMatrix instances, which is the result of
LOS calculations.
This painter can be used in a lightspeed view to paint any ILcdLOSCoverageMatrix.
This painter will use its styler
to style the ILcdLOSCoverageMatrix instances. Each coverage matrix needs to be styled
using a LOS coverage style in
order to be painted.
LOS coverage matrix instances that don't have a matching TLspLOSCoverageStyle will
not be painted, and the painter will log a warning if this occurs.
It is possible to use an
ALspStyleTargetProvider to convert any
domain object into an ILcdLOSCoverageMatrix, but the painter assumes that only one
coverage matrix is painted per domain object.
This painter handles style changes and object changes in a synchronous way.
This painter takes a read lock on the model containing the ILcdLOSCoverageMatrix instances while
painting the ILcdLOSCoverageMatrixes.
Users of this painter should take care to write lock
this model while updating the LOS coverage matrix instances it contains.
ILspPaintGroupsChangeListener.Callback| Constructor and Description |
|---|
TLspLOSCoveragePainter() |
| Modifier and Type | Method and Description |
|---|---|
void |
addPropertyChangeListener(PropertyChangeListener listener)
Adds a
PropertyChangeListener
to the list of listeners that must be notified when
any of the properties of this ILspPainter changes. |
void |
commitChanges(Object aEventId)
Called when the changes for a specified event should be committed.
|
TLspOpenGLProfile |
getRequiredOpenGLProfile()
Returns the minimum required OpenGL profile that a view must support in
order to be compatible with this painter.
|
ILspStyler |
getStyler(TLspPaintState aPaintState)
Returns the styler used by this painter for the given
PaintState. |
TLspPaintProgress |
paintObjects(ILcdGLDrawable aGLDrawable,
List<TLspPaintGroup> aPaintGroups,
TLspPaintPass aPass,
TLspContext aContext)
Paints the specified groups of objects into a view.
|
void |
prepareChanges(List<TLspPaintGroupsChangedEvent> aEvents,
Object aEventId,
ILspPaintGroupsChangeListener.Callback aCallback)
Called when the paint groups will change.
|
<T> boolean |
query(List<TLspPaintGroup> aPaintGroups,
ALspPaintQuery<T> aQuery,
TLspPaintRepresentationState aPaintRepresentationState,
TLspContext aContext)
Retrieves a set of domain objects and data based on the parameters given by the query.
|
void |
registerLayer(ILspInteractivePaintableLayer aLayer,
TLspPaintRepresentation aPaintRepresentation)
Registers a layer with this painter.
|
void |
removePropertyChangeListener(PropertyChangeListener listener)
Removes a
PropertyChangeListener from the list of listeners. |
void |
setStyler(TLspPaintState aPaintState,
ILspStyler aStyler)
Sets the styler used by this object for the given
PaintState. |
void |
styleChanged(TLspStyleChangeEvent aEvent)
Called by the styler when a change in style occurs.
|
void |
unregisterLayer(ILspInteractivePaintableLayer aLayer,
TLspPaintRepresentation aPaintRepresentation)
Unregisters a layer from this painter.
|
public TLspOpenGLProfile getRequiredOpenGLProfile()
ILspPaintergetRequiredOpenGLProfile in interface ILspPainterTLspGLProfilepublic TLspPaintProgress paintObjects(ILcdGLDrawable aGLDrawable, List<TLspPaintGroup> aPaintGroups, TLspPaintPass aPass, TLspContext aContext)
ILspPainterPaints the specified groups of objects into a view. The objects are partitioned into
TLspPaintGroups, which are created by the layer which invoked this painter.
Painters are advised to also implement ILspPaintGroupsChangeListener,
which allows them to keep track of changes to the supplied list of paint groups. This
way, the painter can exploit temporal coherence and perform its work in the most optimal
way.
This method returns a TLspPaintProgress which describes the completeness of the
paint operation. If the painter scheduled one or more tasks to be executed asynchronously,
it may return from its paintObjects() method before having rendered all the objects
it was given. In this case, the returned progress object can describe the amount of work that
has been done and the work that is still remaining.
paintObjects in interface ILspPainteraGLDrawable - the ILcdGLDrawable in which the objects are to be paintedaPaintGroups - the objects to be paintedaPass - the current paint passaContext - provides context information to the painterTLspPaintProgress object describing the completeness of the paint operationpublic <T> boolean query(List<TLspPaintGroup> aPaintGroups, ALspPaintQuery<T> aQuery, TLspPaintRepresentationState aPaintRepresentationState, TLspContext aContext)
ILspPainterquery in interface ILspPainteraPaintGroups - the paint groupsaQuery - the queryaPaintRepresentationState - the paint representation state for which the query should be
performedaContext - the contexttrue if the query completed, false if it was aborted.public void prepareChanges(List<TLspPaintGroupsChangedEvent> aEvents, Object aEventId, ILspPaintGroupsChangeListener.Callback aCallback)
ILspPaintGroupsChangeListenerILspPaintGroupsChangeListener.Callback.changesReady(java.lang.Object) method must be invoked when the listener is
ready to commit the changes.
If aEventId is null then the changes may be committed immediately. In this case
there will be no call to ILspPaintGroupsChangeListener.commitChanges(Object).
Note that it is not mandatory to do this two-phased commit cycle. You may commit or apply the changes immediately, but you still must invoke the callback.
prepareChanges in interface ILspPaintGroupsChangeListeneraEvents - the changesaEventId - the event id or nullaCallback - the callback or nullpublic void commitChanges(Object aEventId)
ILspPaintGroupsChangeListenercommitChanges in interface ILspPaintGroupsChangeListeneraEventId - the event idpublic void styleChanged(TLspStyleChangeEvent aEvent)
ILspStyleChangeListenerstyleChanged in interface ILspStyleChangeListeneraEvent - describes the change that occurredpublic ILspStyler getStyler(TLspPaintState aPaintState)
ILspPainterPaintState. Can return null
in case the painter does not use or expose a styler.getStyler in interface ILspPainteraPaintState - the paint state for which a styler is requestedpublic void setStyler(TLspPaintState aPaintState, ILspStyler aStyler)
ILspEditableStyledPainterPaintState.setStyler in interface ILspEditableStyledPainteraPaintState - the paint state for which to set a styleraStyler - the new styler for the painterpublic void registerLayer(ILspInteractivePaintableLayer aLayer, TLspPaintRepresentation aPaintRepresentation)
ILspPainterILspPainter.unregisterLayer(ILspInteractivePaintableLayer, com.luciad.view.lightspeed.layer.TLspPaintRepresentation).registerLayer in interface ILspPainteraLayer - A layer with which this painter will be used.aPaintRepresentation - The paint representation for which this painter will be used.public void unregisterLayer(ILspInteractivePaintableLayer aLayer, TLspPaintRepresentation aPaintRepresentation)
ILspPainterILspPainter.registerLayer(ILspInteractivePaintableLayer, com.luciad.view.lightspeed.layer.TLspPaintRepresentation).unregisterLayer in interface ILspPainteraLayer - A layer that needs to be unregisteredaPaintRepresentation - The paint representation for which this painter was used with
aLayerpublic void addPropertyChangeListener(PropertyChangeListener listener)
ILspPainterPropertyChangeListener
to the list of listeners that must be notified when
any of the properties of this ILspPainter changes.addPropertyChangeListener in interface ILspPainterlistener - the listener that from now on will be notified of all changes
to
properties of this painterpublic void removePropertyChangeListener(PropertyChangeListener listener)
ILspPainterPropertyChangeListener from the list of listeners.
This listener will no longer be notified of any changes to the properties
of this ILspPainterremovePropertyChangeListener in interface ILspPainterlistener - the listener that no longer will be notified of any changes to
properties of this painter