com.luciad.view.lightspeed.layer.integration.gxy

LuciadLightspeedClass TLspGXYLayerAdapter

java.lang.Object

com.luciad.view.lightspeed.layer.ALspLayer

com.luciad.view.lightspeed.layer.integration.gxy.TLspGXYLayerAdapter

All Implemented Interfaces:

ILcdPropertyChangeSource, ILcdSelection<Object>, ILcdLayer, ILspSnappable, ILspInteractivePaintableLayer, ILspLayer, ILspPaintableLayer, ILspStyledLayer, Serializable

Direct Known Subclasses:

TLspGXYLayerTreeNodeAdapter

Deprecated.

GXY integration in Lightspeed views is no longer supported. Instead, either stick to a GXY view, or use Lightspeed layers.

public class TLspGXYLayerAdapter
extends ALspLayer
implements ILspInteractivePaintableLayer, ILspSnappable

A class that wraps around an ILcdGXYLayer and presents it as an ILspLayer. To this effect, the ILcdGXYLayer is painted onto an offscreen image which can then in turn be painted in the ILspView.

The painting of the ILcdGXYLayer happens on an anonymous (pooled) thread. To ensure thread-safety, this class offers invocation methods (e.g. invokeAndWaitOnGXYLayer). It is advised that any modification that may interfere with painting, is executed through these invocation methods. For example, modifications to the styling of the ILcdGXYLayer have an effect on the painting, so these must be wrapped in a ILcdGXYAsynchronousLayerRunnable and passed to an appropriate invocation method.

This class has the following limitations:

• the correct rendering requires a paint order compatible with that of an ILcdGXYView. In practice, a default Lightspeed view (using TLspPaintingOrder) will do.
• creation of shapes is not supported
• selection and editing is not supported in 3D
• the PaintState.EDITED state is not supported in the setVisible method
• the BODY paint representation is not supported in the setVisible method
• label decluttering does not take into account labels of other layers and only occurs in 2D projections
• labeling in general is not recommended in 3D projections: because of the tile-based visualization, labels can get cut off
• for 3D rendering, the 2D content is rendered onto small image tiles which are combined together and draped onto the world. Because of this, view-dependent content, such as labels, may be cut off at the tile boundaries.

Since:

2012.0

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface com.luciad.view.lightspeed.layer.ILspLayer

ILspLayer.LayerType

Constructor Summary

Constructors

Constructor and Description
TLspGXYLayerAdapter(ILcdGXYLayer aGXYLayer) Deprecated. Creates a new adapter for the given ILcdGXYLayer.
TLspGXYLayerAdapter(ILcdGXYLayer aGXYLayer, ILspLayer.LayerType aLayerType) Deprecated. Creates a new adapter for the given ILcdGXYLayer.

Method Summary

Modifier and Type	Method and Description
void	addEditingStateListener(ILspEditingStateListener aListener) Deprecated. /** Adds an ILspEditingStateListener to this ILspInteractivePaintableLayer.
void	addSelectionListener(ILcdSelectionListener<Object> aSelectionListener) Deprecated. Adds a listener to this selection.
void	clearSelection(int aDispatchEventMode) Deprecated. Deselect all the Objects in this ILcdLayer, i.e., the selection of this ILcdLayer is empty afterward.
void	editedObjectChanged(Object aObject) Deprecated. This method should be called when an object that is being edited has changed significantly.
void	editedObjectsChanged(Collection<Object> aObjectList) Deprecated. This method should be called when a group of objects that is being edited has changed significantly.
void	fireCollectedSelectionChanges() Deprecated. Fires a TLcdSelectionChangedEvent that contains all the selection changes appended by successively calling selectObject(Object, boolean, ILcdFireEventMode.FIRE_LATER).
void	fireStatusEvent(TLcdStatusEvent<ILspLayer> aStatusEvent) Deprecated. Fires a status event.
ILspEditor	getEditor(TLspPaintRepresentation aPaintRepresentation) Deprecated. Returns the editor currently associated with the given paint representation, or null if no editor is associated.
ILcdDynamicFilter	getFilter() Deprecated. Returns the current ILcdDynamicFilter that filters the objects on this layer.
ILcdGXYLayer	getGXYLayer() Deprecated. Returns the GXY layer contained in this adapter.
ILcdGXYLabelingAlgorithm	getGXYLayerLabelingAlgorithm() Deprecated. Method to retrieve an ILcdGXYLabelingAlgorithm used to place the labels of the internal GXY layer.
ILcdIcon	getIcon() Deprecated. Returns a visual indication of the contents of this layer.
String	getLabel() Deprecated. A short textual representation of this ILcdLayer.
ILspLayer.LayerType	getLayerType() Deprecated. Returns the layer type set via this layer's constructor.
TLcdDimensionInterval<TLcdMapScale>	getMapScaleRange(TLspPaintRepresentation aPaintRepresentation) Deprecated. Returns the scale range of a TLspPaintRepresentation of this layer in unitless map scale ratios.
ILcdModel	getModel() Deprecated. Gets the ILcdModel currently associated to this layer.
ILcdModelXYZWorldTransformation	getModelXYZWorldTransformation(ILspView aView) Deprecated. Returns the transformation that will be used to transform coordinates of the objects in the model to world coordinates of the given view.
ILcdCollection<Object>	getObjectsWithPaintState(TLspPaintState aState) Deprecated. Returns the objects in the specified paint state.
ILspPainter	getPainter(TLspPaintRepresentation aPaintRepresentation) Deprecated. Returns the painter currently associated with the specified paint representation, or null if no painter is associated.
Collection<TLspPaintRepresentation>	getPaintRepresentations() Deprecated. The GXY layer adapter only supports the TLspPaintRepresentation.BODY and TLspPaintRepresentation.LABEL paint representations.
TLspOpenGLProfile	getRequiredOpenGLProfile() Deprecated. Returns the minimum required OpenGL profile that a view must support in order to be compatible with this layer.
int	getSelectionCount() Deprecated. Returns the number of objects in this selection.
ILspStyler	getStyler(TLspPaintRepresentationState aPaintRepresentationState) Deprecated. Returns null, because LuciadLightspeed styles are not used by the GXY layer adapter.
void	invokeAndWaitOnGXYLayer(ILcdGXYAsynchronousLayerRunnable aRunnable) Deprecated. Executes the given layer runnable so that it does not interfere with the painting.
void	invokeLaterOnGXYLayer(ILcdGXYAsynchronousLayerRunnable aRunnable) Deprecated. Executes the given layer runnable so that it does not interfere with the painting.
boolean	isEditable() Deprecated. Returns whether the layer allows editing the content that it visualizes.
boolean	isEditable(TLspPaintRepresentation aPaintRepresentation) Deprecated. Returns whether the specified PaintRepresentation is editable or not.
boolean	isEditableSupported() Deprecated. Returns true if the layer supports editing its objects.
boolean	isSelectable() Deprecated. Returns whether the layer's objects can be selected, for example, by clicking on them.
boolean	isSelectableSupported() Deprecated. Returns true if this layer supports selecting objects, false otherwise.
boolean	isSelected(Object aObject) Deprecated. Checks whether the given Object is currently in the set of selected objects.
boolean	isSnapTarget() Deprecated. Determines whether this object should be regarded as a source for snapping points.
boolean	isVisible() Deprecated. Returns whether or not the layer's content is painted.
boolean	isVisible(TLspPaintRepresentation aPaintRepresentation) Deprecated. Returns whether one of the TLspPaintRepresentationStates of the the specified TLspPaintRepresentation is enabled.
boolean	isVisible(TLspPaintRepresentationState aPaintRepresentationState) Deprecated. Returns whether the specified PaintRepresentationState is enabled or not.
TLspPaintProgress	paint(ILcdGLDrawable aGLDrawable, TLspPaintPhase aPhase, TLspPaintRepresentationState aPaintRepresentationState, ILspView aView) Deprecated. Renders the specified paint representation of this layer into a view.
<T> T	query(ALspPaintQuery<T> aQuery, TLspContext aContext) Deprecated. Retrieves a set of domain objects and data based on the parameters given by the query.
void	removeEditingStateListener(ILspEditingStateListener aListener) Deprecated. Removes an ILspEditingStateListener from this ILspInteractivePaintableLayer.
void	removeSelectionListener(ILcdSelectionListener<Object> aSelectionListener) Deprecated. Removes an ILcdSelectionListener from this ILcdSelection.
Enumeration<Object>	selectedObjects() Deprecated. Returns the objects in this selection.
void	selectObject(Object aObject, boolean aSelection, int aDispatchEventMode) Deprecated. Changes the selection state of any element contained in the ILcdModel this ILcdLayer refers to.
void	selectObjects(Collection<Object> aObjects, boolean aSelection, int aDispatchEventMode) Deprecated. Changes the selection state for the given collection of objects contained in the ILcdModel this layer refers to.
void	setEditable(boolean aEditable) Deprecated. Sets whether the layer should allow editing the content that it visualizes.
void	setEditable(TLspPaintRepresentation aPaintRepresentation, boolean aEditable) Deprecated. Enables or disables the editable property of a paint representation.
void	setFilter(ILcdDynamicFilter aFilter) Deprecated. Sets the ILcdDynamicFilter to filter the objects on this layer.
void	setGXYLayerLabelingAlgorithm(ILcdGXYLabelingAlgorithm aLabelingAlgorithm) Deprecated. Assigns a label algorithm which will be used to place the labels of the internal GXY layer.
void	setIcon(ILcdIcon aIcon) Deprecated. Sets a visual indication of the contents of this layer.
void	setLabel(String aLabel) Deprecated. Sets the textual representation of this ILcdLayer.
void	setMapScaleRange(TLspPaintRepresentation aPaintRepresentation, TLcdDimensionInterval<TLcdMapScale> aMapScaleRange) Deprecated. Sets the scale range of this layer to the given unitless map scale ratio range.
void	setModel(ILcdModel aModel) Deprecated. Sets the ILcdModel to this layer.
void	setSelectable(boolean aSelectable) Deprecated. Sets the Selectable property of this ILcdLayer.
void	setSnapTarget(boolean aSnapTarget) Deprecated. Sets whether this object should be regarded as a source for snapping points.
void	setVisible(boolean aVisible) Deprecated. Sets whether or not the layer's content is painted.
void	setVisible(TLspPaintRepresentation aPaintRepresentation, boolean aVisible) Deprecated. Enables or disables all TLspPaintRepresentationStates of the specified TLspPaintRepresentation.
void	setVisible(TLspPaintRepresentationState aPaintRepresentationState, boolean aVisible) Deprecated. Enables or disables the a paint representation state.
String	toString() Deprecated.

Methods inherited from class com.luciad.view.lightspeed.layer.ALspLayer

addLayerStateListener, addPaintRepresentation, addPropertyChangeListener, addStatusListener, createModelXYZWorldTransformation, fireLayerStateChange, fireLayerStateChange, fireLayerStateChange, fireLayerStateChange, firePropertyChange, getBounds, getCurrentViews, getLayerStyle, invalidate, isSynchronous, registerView, removeLayerStateListener, removePaintRepresentation, removePropertyChangeListener, removeStatusListener, setLayerStyle, setSynchronous, unregisterView

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.luciad.view.lightspeed.layer.ILspLayer

addLayerStateListener, addStatusListener, getBounds, getCurrentViews, getLayerStyle, getMapScaleProvider, invalidate, registerView, removeLayerStateListener, removeStatusListener, setLayerStyle, unregisterView

Methods inherited from interface com.luciad.util.ILcdSelection

getSelectedObjects

Methods inherited from interface com.luciad.util.ILcdPropertyChangeSource

addPropertyChangeListener, removePropertyChangeListener

Methods inherited from interface com.luciad.view.lightspeed.editor.snapping.ILspSnappable

addPropertyChangeListener, removePropertyChangeListener

Constructor Detail

TLspGXYLayerAdapter

public TLspGXYLayerAdapter(ILcdGXYLayer aGXYLayer,
                           ILspLayer.LayerType aLayerType)

Deprecated.

Creates a new adapter for the given ILcdGXYLayer.

For thread safety, the given layer should operate synchronously. Hence, no ILcdGXYAsynchronousLayerWrapper instance should be passed.

In case aGXYLayer is a TLcdLayer, it may only have a null filter or a non-null ILcdDynamicFilter. It is also not allowed to set a filter which is not a ILcdDynamicFilter instance on aGXYLayer as long as aGXYLayer is contained in a TLspGXYLayerAdapter.

Parameters:

aGXYLayer - a synchronous layer to visualize and interact with

aLayerType - the LayerType of the new layer

TLspGXYLayerAdapter

public TLspGXYLayerAdapter(ILcdGXYLayer aGXYLayer)

Deprecated.

Creates a new adapter for the given ILcdGXYLayer. For thread safety, the given layer should operate synchronously. Hence, no ILcdGXYAsynchronousLayerWrapper instance should be passed.

Parameters:

aGXYLayer - a synchronous layer to visualize and interact with

Method Detail

setGXYLayerLabelingAlgorithm

public void setGXYLayerLabelingAlgorithm(ILcdGXYLabelingAlgorithm aLabelingAlgorithm)

Deprecated.

Assigns a label algorithm which will be used to place the labels of the internal GXY layer. The algorithm is only used in 2D world references.

Parameters:

aLabelingAlgorithm - A label algorithm which will be used to declutter the labels of the internal GXY layer. If null the currently installed label algorithm will be removed

getGXYLayerLabelingAlgorithm

public ILcdGXYLabelingAlgorithm getGXYLayerLabelingAlgorithm()

Deprecated.

Method to retrieve an ILcdGXYLabelingAlgorithm used to place the labels of the internal GXY layer. In case no labeling algorithm is installed, this method returns null.

Returns:

An ILcdGXYLabelingAlgorithm used to declutter the labels of the internal GXY layer. null in case no labeling algorithm is installed.

getLayerType

public ILspLayer.LayerType getLayerType()

Deprecated.

Returns the layer type set via this layer's constructor. If a constructor without a LayerType argument is used, the default value is ILspLayer.LayerType.EDITABLE.

Specified by:

getLayerType in interface ILspLayer

Overrides:

getLayerType in class ALspLayer

Returns:

this layer's LayerType

See Also:

ILspLayer.LayerType

toString

public String toString()

Deprecated.

Overrides:

toString in class Object

getGXYLayer

public ILcdGXYLayer getGXYLayer()

Deprecated.

Returns the GXY layer contained in this adapter. Note that changes to this layer should be performed using the invokeAndWaitOnGXYLayer(ILcdGXYAsynchronousLayerRunnable aRunnable) method to make sure no synchronization issues occur.

Returns:

the GXY layer contained in this adapter

See Also:

invokeAndWaitOnGXYLayer(ILcdGXYAsynchronousLayerRunnable aRunnable)

isSnapTarget

public boolean isSnapTarget()

Deprecated.

Description copied from interface: ILspSnappable

Determines whether this object should be regarded as a source for snapping points.

Specified by:

isSnapTarget in interface ILspSnappable

Returns:

true if this object should be regarded as a source for snapping points; false otherwise.

setSnapTarget

public void setSnapTarget(boolean aSnapTarget)

Deprecated.

Description copied from interface: ILspSnappable

Sets whether this object should be regarded as a source for snapping points.

Specified by:

setSnapTarget in interface ILspSnappable

Parameters:

aSnapTarget - if true, this object should be regarded as a source for snapping points, i.e. it should be possible to snap to this object; if false, this object should not produce snapping candidates.

fireStatusEvent

public void fireStatusEvent(TLcdStatusEvent<ILspLayer> aStatusEvent)

Deprecated.

Description copied from class: ALspLayer

Fires a status event.

Overrides:

fireStatusEvent in class ALspLayer

Parameters:

aStatusEvent - the status event

getPainter

public ILspPainter getPainter(TLspPaintRepresentation aPaintRepresentation)

Deprecated.

Description copied from interface: ILspInteractivePaintableLayer

Returns the painter currently associated with the specified paint representation, or null if no painter is associated.

Specified by:

getPainter in interface ILspInteractivePaintableLayer

Parameters:

aPaintRepresentation - the paint representation for which to obtain a painter

Returns:

the associated painter if it exists, or null otherwise

getEditor

public ILspEditor getEditor(TLspPaintRepresentation aPaintRepresentation)

Deprecated.

Description copied from interface: ILspInteractivePaintableLayer

Returns the editor currently associated with the given paint representation, or null if no editor is associated.

Specified by:

getEditor in interface ILspInteractivePaintableLayer

Parameters:

aPaintRepresentation - the paint representation for which to retrieve an editor

Returns:

the associated editor if it exists, or null otherwise

isVisible

public boolean isVisible(TLspPaintRepresentation aPaintRepresentation)

Deprecated.

Description copied from interface: ILspLayer

Returns whether one of the TLspPaintRepresentationStates of the the specified TLspPaintRepresentation is enabled.

Specified by:

isVisible in interface ILspLayer

Overrides:

isVisible in class ALspLayer

Parameters:

aPaintRepresentation - the paint representation to check

Returns:

whether the specified PaintRepresentation is enabled or not

See Also:

ILspLayer.setVisible(TLspPaintRepresentation, boolean)

setVisible

public void setVisible(boolean aVisible)

Deprecated.

Description copied from class: ALspLayer

Sets whether or not the layer's content is painted.

This method is not thread safe, it is recommended to synchronize on the layer instance if needed.

Specified by:

setVisible in interface ILcdLayer

Specified by:

setVisible in interface ILspLayer

Overrides:

setVisible in class ALspLayer

Parameters:

aVisible - true if the layer should be visible, false otherwise.

See Also:

ILspLayer.setVisible(TLspPaintRepresentationState, boolean)

isVisible

public boolean isVisible()

Deprecated.

Description copied from interface: ILcdLayer

Returns whether or not the layer's content is painted.

Specified by:

isVisible in interface ILcdLayer

Overrides:

isVisible in class ALspLayer

Returns:

true if the layer is visible, false otherwise.

See Also:

ILcdLayer.setVisible(boolean)

setVisible

public void setVisible(TLspPaintRepresentationState aPaintRepresentationState,
                       boolean aVisible)

Deprecated.

Description copied from interface: ILspLayer

Enables or disables the a paint representation state.

This can be used to quickly switch representations (e.g. labels) on and off without having to remove its related properties (ex. a painter).

Note that this method is independent of the layer visibility. So a paint representation state will only be visible when this method and the ILcdLayer.isVisible() method return true.

Specified by:

setVisible in interface ILspLayer

Overrides:

setVisible in class ALspLayer

Parameters:

aPaintRepresentationState - the representations to enable or disable

aVisible - true to enable the representations or false to disable it

See Also:

ILspLayer.setVisible(boolean)

isVisible

public boolean isVisible(TLspPaintRepresentationState aPaintRepresentationState)

Deprecated.

Description copied from interface: ILspLayer

Returns whether the specified PaintRepresentationState is enabled or not.

Specified by:

isVisible in interface ILspLayer

Overrides:

isVisible in class ALspLayer

Parameters:

aPaintRepresentationState - the paint representation to check

Returns:

whether the specified PaintRepresentationState is enabled or not

See Also:

ILspLayer.setVisible(TLspPaintRepresentationState, boolean)

setVisible

public void setVisible(TLspPaintRepresentation aPaintRepresentation,
                       boolean aVisible)

Deprecated.

Description copied from interface: ILspLayer

Enables or disables all TLspPaintRepresentationStates of the specified TLspPaintRepresentation.

This can be used to quickly switch representations (e.g. labels) on and off without having to remove its related properties (ex. a painter).

Specified by:

setVisible in interface ILspLayer

Overrides:

setVisible in class ALspLayer

Parameters:

aPaintRepresentation - the representation to enable or disable

aVisible - true to enable the representations or false to disable it

See Also:

ILspLayer.setVisible(TLspPaintRepresentationState, boolean)

setEditable

public void setEditable(TLspPaintRepresentation aPaintRepresentation,
                        boolean aEditable)

Deprecated.

Description copied from interface: ILspLayer

Enables or disables the editable property of a paint representation.

This can be used to quickly switch editing for representations (e.g. labels) on and off without having to remove its related properties (ex. a painter).

Note that this method is independent of the layer editability. So paint representation will only be editable when both the layer and the paint representation are editable and editing is supported.

Specified by:

setEditable in interface ILspLayer

Overrides:

setEditable in class ALspLayer

Parameters:

aPaintRepresentation - the representation to enable or disable

aEditable - true to enable the representations or false to disable it

See Also:

ILspLayer.setEditable(boolean), ILcdLayer.isEditableSupported()

isEditable

public boolean isEditable(TLspPaintRepresentation aPaintRepresentation)

Deprecated.

Description copied from interface: ILspLayer

Returns whether the specified PaintRepresentation is editable or not.

Specified by:

isEditable in interface ILspLayer

Overrides:

isEditable in class ALspLayer

Parameters:

aPaintRepresentation - the paint representation to check

Returns:

whether the specified PaintRepresentation is editable or not

See Also:

ILspLayer.setEditable(TLspPaintRepresentation, boolean)

setFilter

public void setFilter(ILcdDynamicFilter aFilter)

Deprecated.

Sets the ILcdDynamicFilter to filter the objects on this layer. Operations on this layer will only be applied to objects of the model that pass the filter. This includes painting, labeling, selection, editing, ...

Setting a null filter, lets all objects pass for rendering. By default the filter is null.

This method is not thread safe, it is recommended to synchronize on the layer instance if needed.

This method should only be used if the inner GXY layer supports filtering, which is only the case for TLcdLayer instances. An UnsupportedOperationException will be thrown when the inner layer is not a TLcdLayer.

Overrides:

setFilter in class ALspLayer

Parameters:

aFilter - the filter that accepts only those objects that should be taken into account

See Also:

ALspLayer.getFilter()

getFilter

public ILcdDynamicFilter getFilter()

Deprecated.

Returns the current ILcdDynamicFilter that filters the objects on this layer.

Returns the adapter layer's filter if it extends TLcdLayer, or null otherwise.

Overrides:

getFilter in class ALspLayer

Returns:

the filter that accepts only those objects that should be taken into account or null

See Also:

ALspLayer.setFilter(com.luciad.util.ILcdDynamicFilter)

getRequiredOpenGLProfile

public TLspOpenGLProfile getRequiredOpenGLProfile()

Deprecated.

Description copied from interface: ILspPaintableLayer

Returns the minimum required OpenGL profile that a view must support in order to be compatible with this layer.

Specified by:

getRequiredOpenGLProfile in interface ILspPaintableLayer

Returns:

a TLspGLProfile

paint

public TLspPaintProgress paint(ILcdGLDrawable aGLDrawable,
                               TLspPaintPhase aPhase,
                               TLspPaintRepresentationState aPaintRepresentationState,
                               ILspView aView)

Deprecated.

Description copied from interface: ILspPaintableLayer

Renders the specified paint representation of this layer into a view. The view invokes this method for each enabled paint representation and supplies an ILcdGLDrawable as an access point to the OpenGL API. In addition to rendering the individual paint representations, views may also perform multiple rendering passes to support things such as transparency rendering or terrain of data on a 3D terrain. To this effect, the layer must honor the supplied TLspPaintPhase.

This method returns a TLspPaintProgress object to indicate whether the repaint was entirely finished or not. This might not be the case if the paint() method scheduled some asynchronous processing task, whose result is needed to complete the paint operation. For instance, if the layer loads data in the background on demand, it may return early rather than letting the paint() method block until the data is available. In this case the view is left incomplete, but additional repaints of the view will incrementally become more up-to-date, and the progress objects retrieved after each new repaint can be used to provide progress information to the user.

Specified by:

paint in interface ILspPaintableLayer

Parameters:

aGLDrawable - the access point to OpenGL

aPhase - describes the phase that the view repaint process is currently in

aPaintRepresentationState - identifies which paint representation state the layer should render into the view

aView - the view into which the layer is being rendered

Returns:

progress information describing the painting operation

getObjectsWithPaintState

public ILcdCollection<Object> getObjectsWithPaintState(TLspPaintState aState)

Deprecated.

Description copied from interface: ILspInteractivePaintableLayer

Returns the objects in the specified paint state.

The paint state must not be TLspPaintState.REGULAR, you can use ILspInteractivePaintableLayer.query(com.luciad.view.lightspeed.query.ALspPaintQuery<T>, com.luciad.view.lightspeed.TLspContext) instead to get the current regular objects in the view.

The state of objects can be modified by adding/removing them from the returned collection. You can be informed when the objects in a certain state change by adding a listener to the returned collection.

Specified by:

getObjectsWithPaintState in interface ILspInteractivePaintableLayer

Parameters:

aState - a paint state

Returns:

the objects

editedObjectChanged

public void editedObjectChanged(Object aObject)

Deprecated.

Description copied from interface: ILspInteractivePaintableLayer

This method should be called when an object that is being edited has changed significantly. As a result all editing listeners will be informed of this.

Specified by:

editedObjectChanged in interface ILspInteractivePaintableLayer

Parameters:

aObject - the object

See Also:

TLspEditingStateEvent.ChangeType.EDITING_CHANGE, ILspInteractivePaintableLayer.addEditingStateListener(com.luciad.view.lightspeed.editor.operation.ILspEditingStateListener)

editedObjectsChanged

public void editedObjectsChanged(Collection<Object> aObjectList)

Deprecated.

Description copied from interface: ILspInteractivePaintableLayer

This method should be called when a group of objects that is being edited has changed significantly. As a result, all editing listeners will be informed of this change.

Specified by:

editedObjectsChanged in interface ILspInteractivePaintableLayer

Parameters:

aObjectList - A list of domain objects (in this layer) that have changed significantly. Never null.

See Also:

TLspEditingStateEvent.ChangeType.EDITING_CHANGE, ILspInteractivePaintableLayer.addEditingStateListener(com.luciad.view.lightspeed.editor.operation.ILspEditingStateListener)

addEditingStateListener

public void addEditingStateListener(ILspEditingStateListener aListener)

Deprecated.

Description copied from interface: ILspInteractivePaintableLayer

/** Adds an ILspEditingStateListener to this ILspInteractivePaintableLayer.

Specified by:

addEditingStateListener in interface ILspInteractivePaintableLayer

Parameters:

aListener - the ILspEditingStateListener to be added.

removeEditingStateListener

public void removeEditingStateListener(ILspEditingStateListener aListener)

Deprecated.

Description copied from interface: ILspInteractivePaintableLayer

Removes an ILspEditingStateListener from this ILspInteractivePaintableLayer.

Specified by:

removeEditingStateListener in interface ILspInteractivePaintableLayer

Parameters:

aListener - the ILspEditingStateListener to be removed.

invokeAndWaitOnGXYLayer

public void invokeAndWaitOnGXYLayer(ILcdGXYAsynchronousLayerRunnable aRunnable)

Deprecated.

Executes the given layer runnable so that it does not interfere with the painting. The invocation will pass the wrapped gxy layer as argument. The runnable is executed in the caller's thread. The method waits until the runnable's invocation has stopped.

Parameters:

aRunnable - the runnable to execute. The wrapped gxy layer will be used as argument for the runnable's execution.

invokeLaterOnGXYLayer

public void invokeLaterOnGXYLayer(ILcdGXYAsynchronousLayerRunnable aRunnable)

Deprecated.

Executes the given layer runnable so that it does not interfere with the painting. The invocation will pass the wrapped gxy layer as argument. The runnable is executed in an anonymous (pooled) thread. The method always returns immediately.

Parameters:

aRunnable - the runnable to execute. The invocation will pass the wrapped gxy layer as argument

getPaintRepresentations

public Collection<TLspPaintRepresentation> getPaintRepresentations()

Deprecated.

The GXY layer adapter only supports the TLspPaintRepresentation.BODY and TLspPaintRepresentation.LABEL paint representations.

Specified by:

getPaintRepresentations in interface ILspLayer

Overrides:

getPaintRepresentations in class ALspLayer

Returns:

a collection of PaintRepresentations, never null

getModelXYZWorldTransformation

public ILcdModelXYZWorldTransformation getModelXYZWorldTransformation(ILspView aView)

Deprecated.

Description copied from class: ALspLayer

Returns the transformation that will be used to transform coordinates of the objects in the model to world coordinates of the given view.

In order for this method to be thread-safe, the model-world transformation should not be modified after it is returned by this method. In practice this means that this method and its callers should treat the model-world transformation as an immutable object. So it shouldn't reuse the same ILcdModelXYZWorldTransformation for different ILcdModelReferences or ILcdXYZWorldReference.

By default this method calls createModelXYZWorldTransformation to create a new transformation instance.

Specified by:

getModelXYZWorldTransformation in interface ILspLayer

Overrides:

getModelXYZWorldTransformation in class ALspLayer

Parameters:

aView - the view

Returns:

the transformation that will be used to transform coordinates of the objects in the model to world coordinates of the given view

isSelectable

public boolean isSelectable()

Deprecated.

Description copied from interface: ILcdLayer

Returns whether the layer's objects can be selected, for example, by clicking on them.

Specified by:

isSelectable in interface ILcdLayer

Overrides:

isSelectable in class ALspLayer

Returns:

true if the layer allows selection, false otherwise.

See Also:

ILcdSelection, ILcdLayer.setSelectable(boolean)

setSelectable

public void setSelectable(boolean aSelectable)

Deprecated.

Description copied from interface: ILcdLayer

Sets the Selectable property of this ILcdLayer. Check isSelectableSupported to see if the layer supports selection.

Specified by:

setSelectable in interface ILcdLayer

Overrides:

setSelectable in class ALspLayer

Parameters:

aSelectable - true if the layer allows selection, false otherwise.

See Also:

ILcdLayer.isSelectable(), ILcdLayer.isSelectableSupported()

isSelectableSupported

public boolean isSelectableSupported()

Deprecated.

Description copied from interface: ILcdLayer

Returns true if this layer supports selecting objects, false otherwise.

Specified by:

isSelectableSupported in interface ILcdLayer

Overrides:

isSelectableSupported in class ALspLayer

Returns:

true

See Also:

ILcdLayer.setSelectable(boolean), ILcdLayer.selectObject(java.lang.Object, boolean, int)

addSelectionListener

public void addSelectionListener(ILcdSelectionListener<Object> aSelectionListener)

Deprecated.

Description copied from interface: ILcdSelection

Adds a listener to this selection. In case you need to register a listener which keeps a reference to an object with a shorter life-time than this ILcdSelection, you can use a ALcdWeakSelectionListener instance as selection listener.

Specified by:

addSelectionListener in interface ILcdSelection<Object>

Overrides:

addSelectionListener in class ALspLayer

Parameters:

aSelectionListener - the ILcdSelectionListener to be added.

removeSelectionListener

public void removeSelectionListener(ILcdSelectionListener<Object> aSelectionListener)

Deprecated.

Description copied from interface: ILcdSelection

Removes an ILcdSelectionListener from this ILcdSelection.

Specified by:

removeSelectionListener in interface ILcdSelection<Object>

Overrides:

removeSelectionListener in class ALspLayer

Parameters:

aSelectionListener - the ILcdSelectionListener to be removed.

clearSelection

public void clearSelection(int aDispatchEventMode)

Deprecated.

Description copied from interface: ILcdLayer

Deselect all the Objects in this ILcdLayer, i.e., the selection of this ILcdLayer is empty afterward.

Specified by:

clearSelection in interface ILcdLayer

Overrides:

clearSelection in class ALspLayer

Parameters:

aDispatchEventMode - shall be one among ILcdFireEventMode.FIRE_NOW, ILcdFireEventMode.FIRE_LATER, ILcdFireEventMode.NO_EVENT

See Also:

ILcdFireEventMode

fireCollectedSelectionChanges

public void fireCollectedSelectionChanges()

Deprecated.

Description copied from interface: ILcdLayer

Fires a TLcdSelectionChangedEvent that contains all the selection changes appended by successively calling selectObject(Object, boolean, ILcdFireEventMode.FIRE_LATER).

Specified by:

fireCollectedSelectionChanges in interface ILcdLayer

Overrides:

fireCollectedSelectionChanges in class ALspLayer

selectObjects

public void selectObjects(Collection<Object> aObjects,
                          boolean aSelection,
                          int aDispatchEventMode)

Deprecated.

Description copied from class: ALspLayer

Changes the selection state for the given collection of objects contained in the ILcdModel this layer refers to. This method shall have an effect only if ALspLayer.isSelectableSupported() and ALspLayer.isSelectable() return true.

Overrides:

selectObjects in class ALspLayer

Parameters:

aObjects - the collection of objects to select or deselect

aSelection - the selection state, true to select, false to deselect

aDispatchEventMode - shall be one among ILcdFireEventMode.FIRE_NOW, ILcdFireEventMode.FIRE_LATER, ILcdFireEventMode.NO_EVENT

See Also:

ILcdFireEventMode

selectObject

public void selectObject(Object aObject,
                         boolean aSelection,
                         int aDispatchEventMode)

Deprecated.

Description copied from interface: ILcdLayer

Changes the selection state of any element contained in the ILcdModel this ILcdLayer refers to. This method shall have an effect only if isSelectableSupported and isSelectable return true.

Specified by:

selectObject in interface ILcdLayer

Overrides:

selectObject in class ALspLayer

Parameters:

aObject - the Object to select or deselect. The object should be in the model of this layer. The implementation of this method is not responsible for checking this.

aSelection - the selection state, true to select, false to deselect.

aDispatchEventMode - shall be one among ILcdFireEventMode.FIRE_NOW, ILcdFireEventMode.FIRE_LATER, ILcdFireEventMode.NO_EVENT

See Also:

ALspLayer.selectObjects(java.util.Collection, boolean, int)

isSelected

public boolean isSelected(Object aObject)
                   throws IllegalArgumentException

Deprecated.

Description copied from interface: ILcdSelection

Checks whether the given Object is currently in the set of selected objects.

Specified by:

isSelected in interface ILcdSelection<Object>

Overrides:

isSelected in class ALspLayer

Parameters:

aObject - the Object to be checked.

Returns:

true if the Object is in this ILcdSelection, false otherwise.

Throws:

IllegalArgumentException

getSelectionCount

public int getSelectionCount()

Deprecated.

Description copied from interface: ILcdSelection

Returns the number of objects in this selection.

Specified by:

getSelectionCount in interface ILcdSelection<Object>

Overrides:

getSelectionCount in class ALspLayer

Returns:

the number of objects in this ILcdSelection.

selectedObjects

public Enumeration<Object> selectedObjects()

Deprecated.

Description copied from interface: ILcdSelection

Returns the objects in this selection.

Specified by:

selectedObjects in interface ILcdSelection<Object>

Overrides:

selectedObjects in class ALspLayer

Returns:

the objects currently in this ILcdSelection.

getModel

public ILcdModel getModel()

Deprecated.

Description copied from class: ALspLayer

Gets the ILcdModel currently associated to this layer.

Specified by:

getModel in interface ILcdLayer

Overrides:

getModel in class ALspLayer

Returns:

the ILcdModel associated to this ILcdLayer

setModel

public void setModel(ILcdModel aModel)

Deprecated.

Description copied from class: ALspLayer

Sets the ILcdModel to this layer.

This method is not thread safe, it is recommended to synchronize on the layer instance if needed.

Overrides:

setModel in class ALspLayer

Parameters:

aModel - the model that contains the objects that should be displayed in this layer.

isEditableSupported

public boolean isEditableSupported()

Deprecated.

Description copied from interface: ILcdLayer

Returns true if the layer supports editing its objects.

Specified by:

isEditableSupported in interface ILcdLayer

Overrides:

isEditableSupported in class ALspLayer

Returns:

true

See Also:

ILcdLayer.setEditable(boolean)

setEditable

public void setEditable(boolean aEditable)

Deprecated.

Description copied from interface: ILcdLayer

Sets whether the layer should allow editing the content that it visualizes. Check isEditableSupported to see if the layer supports editing.

Specified by:

setEditable in interface ILcdLayer

Specified by:

setEditable in interface ILspLayer

Overrides:

setEditable in class ALspLayer

Parameters:

aEditable - true if the layer content can be edited

See Also:

ILspLayer.setEditable(TLspPaintRepresentation, boolean), ILcdLayer.isEditableSupported()

isEditable

public boolean isEditable()

Deprecated.

Description copied from interface: ILcdLayer

Returns whether the layer allows editing the content that it visualizes.

Specified by:

isEditable in interface ILcdLayer

Overrides:

isEditable in class ALspLayer

Returns:

true if this ILcdLayer is editable, false otherwise

See Also:

ILcdLayer.setEditable(boolean)

getLabel

public String getLabel()

Deprecated.

Description copied from interface: ILcdLayer

A short textual representation of this ILcdLayer.

Specified by:

getLabel in interface ILcdLayer

Overrides:

getLabel in class ALspLayer

Returns:

a short textual representation of this ILcdLayer

setLabel

public void setLabel(String aLabel)

Deprecated.

Description copied from class: ALspLayer

Sets the textual representation of this ILcdLayer.

This method is not thread safe, it is recommended to synchronize on the layer instance if needed.

Specified by:

setLabel in interface ILcdLayer

Overrides:

setLabel in class ALspLayer

Parameters:

aLabel - the the textual representation to use for this ILcdLayer.

getIcon

public ILcdIcon getIcon()

Deprecated.

Description copied from interface: ILcdLayer

Returns a visual indication of the contents of this layer. For example, for a grid layer, an icon containing a grid could be used.

Specified by:

getIcon in interface ILcdLayer

Overrides:

getIcon in class ALspLayer

Returns:

a visual indication of the contents of this layer.

setIcon

public void setIcon(ILcdIcon aIcon)

Deprecated.

Description copied from interface: ILcdLayer

Sets a visual indication of the contents of this layer.

Specified by:

setIcon in interface ILcdLayer

Overrides:

setIcon in class ALspLayer

Parameters:

aIcon - a visual indication of the contents of this layer.

See Also:

ILcdLayer.getIcon()

getStyler

public ILspStyler getStyler(TLspPaintRepresentationState aPaintRepresentationState)

Deprecated.

Returns null, because LuciadLightspeed styles are not used by the GXY layer adapter.

Specified by:

getStyler in interface ILspStyledLayer

Parameters:

aPaintRepresentationState - the paint representation state for which the styler should be retrieved

Returns:

the styler used for the given paint representation state

query

public <T> T query(ALspPaintQuery<T> aQuery,
                   TLspContext aContext)

Deprecated.

Description copied from interface: ILspInteractivePaintableLayer

Retrieves a set of domain objects and data based on the parameters given by the query.

Specified by:

query in interface ILspInteractivePaintableLayer

Type Parameters:

T - the type of the return value of ALspPaintQuery.getResult()

Parameters:

aQuery - the query

aContext - the context

Returns:

the value returned by ALspPaintQuery.getResult() after processing is finished

getMapScaleRange

public TLcdDimensionInterval<TLcdMapScale> getMapScaleRange(TLspPaintRepresentation aPaintRepresentation)

Deprecated.

Returns the scale range of a TLspPaintRepresentation of this layer in unitless map scale ratios. If configured, the layer contents are only shown if and when the view's map scale is larger than the interval's minimum and smaller than the interval's maximum.

Map scale ranges are unsupported for TLspGXYLayerAdapter, so this method will always return null.

Overrides:

getMapScaleRange in class ALspLayer

Parameters:

aPaintRepresentation - the paint representation for which to return the scale range

Returns:

the scale range

See Also:

ALspLayer.setMapScaleRange(com.luciad.view.lightspeed.layer.TLspPaintRepresentation, com.luciad.multidimensional.TLcdDimensionInterval<com.luciad.view.TLcdMapScale>)

setMapScaleRange

public void setMapScaleRange(TLspPaintRepresentation aPaintRepresentation,
                             TLcdDimensionInterval<TLcdMapScale> aMapScaleRange)

Deprecated.

Sets the scale range of this layer to the given unitless map scale ratio range. If configured, the layer contents are only shown if and when the view's map scale is larger than the interval's minimum and smaller than the interval's maximum.

Map scale ranges are unsupported for TLspGXYLayerAdapter, this method will throw an UnsupportedOperationException.

Overrides:

setMapScaleRange in class ALspLayer

Parameters:

aPaintRepresentation - the paint representation

aMapScaleRange - the new scale range of this layer, or null to deactivate any scale restriction

Throws:

UnsupportedOperationException - always

See Also:

TLspLayer.setMapScaleRange(TLspPaintRepresentation, TLcdDimensionInterval), TLcdMapScale.createScaleRange(TLcdMapScale, TLcdMapScale)