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 ILcdLOSCoverageMatrix
es.
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()
ILspPainter
getRequiredOpenGLProfile
in interface ILspPainter
TLspGLProfile
public TLspPaintProgress paintObjects(ILcdGLDrawable aGLDrawable, List<TLspPaintGroup> aPaintGroups, TLspPaintPass aPass, TLspContext aContext)
ILspPainter
Paints the specified groups of objects into a view. The objects are partitioned into
TLspPaintGroup
s, 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 ILspPainter
aGLDrawable
- 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)
ILspPainter
query
in interface ILspPainter
aPaintGroups
- 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)
ILspPaintGroupsChangeListener
ILspPaintGroupsChangeListener.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 ILspPaintGroupsChangeListener
aEvents
- the changesaEventId
- the event id or null
aCallback
- the callback or null
public void commitChanges(Object aEventId)
ILspPaintGroupsChangeListener
commitChanges
in interface ILspPaintGroupsChangeListener
aEventId
- the event idpublic void styleChanged(TLspStyleChangeEvent aEvent)
ILspStyleChangeListener
styleChanged
in interface ILspStyleChangeListener
aEvent
- describes the change that occurredpublic ILspStyler getStyler(TLspPaintState aPaintState)
ILspPainter
PaintState
. Can return null
in case the painter does not use or expose a styler.getStyler
in interface ILspPainter
aPaintState
- the paint state for which a styler is requestedpublic void setStyler(TLspPaintState aPaintState, ILspStyler aStyler)
ILspEditableStyledPainter
PaintState
.setStyler
in interface ILspEditableStyledPainter
aPaintState
- the paint state for which to set a styleraStyler
- the new styler for the painterpublic void registerLayer(ILspInteractivePaintableLayer aLayer, TLspPaintRepresentation aPaintRepresentation)
ILspPainter
ILspPainter.unregisterLayer(ILspInteractivePaintableLayer, com.luciad.view.lightspeed.layer.TLspPaintRepresentation)
.registerLayer
in interface ILspPainter
aLayer
- 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)
ILspPainter
ILspPainter.registerLayer(ILspInteractivePaintableLayer, com.luciad.view.lightspeed.layer.TLspPaintRepresentation)
.unregisterLayer
in interface ILspPainter
aLayer
- A layer that needs to be unregisteredaPaintRepresentation
- The paint representation for which this painter was used with
aLayerpublic void addPropertyChangeListener(PropertyChangeListener listener)
ILspPainter
PropertyChangeListener
to the list of listeners that must be notified when
any of the properties of this ILspPainter
changes.addPropertyChangeListener
in interface ILspPainter
listener
- the listener that from now on will be notified of all changes
to
properties of this painterpublic void removePropertyChangeListener(PropertyChangeListener listener)
ILspPainter
PropertyChangeListener
from the list of listeners.
This listener will no longer be notified of any changes to the properties
of this ILspPainter
removePropertyChangeListener
in interface ILspPainter
listener
- the listener that no longer will be notified of any changes to
properties of this painter