com.luciad.view.map.mgrs

Defense SymbologyClass TLcdMGRSGridLayer

java.lang.Object

com.luciad.view.map.mgrs.TLcdMGRSGridLayer

All Implemented Interfaces:

ILcdPropertyChangeSource, ILcdSelection<Object>, ILcdGXYLayer, ILcdNotLabelDeconflictableLayer, ILcdLayer, Serializable

public class TLcdMGRSGridLayer
extends Object
implements ILcdGXYLayer, ILcdNotLabelDeconflictableLayer

ILcdGXYLayer implementation that is capable of visualizing MGRS grid data (UTM + UPS). The styling of the MGRS grid and its labels can be done using TLcdMGRSGridStyle. An overlay label can added using TLcdMGRSGridOverlayLabelBuilder.

Since:

2015.1

See Also:

Serialized Form

Field Summary

Fields inherited from interface com.luciad.view.gxy.ILcdGXYLayer

ALL, BODIES, HANDLES, LABELS, SELECTION

Constructor Summary

Constructors

Constructor and Description
TLcdMGRSGridLayer() Constructs a layer depicting a WGS-84 MGRS (UTM + UPS) grid, with "MGRS Grid" as label.
TLcdMGRSGridLayer(String aLabel) Constructs a layer depicting a WGS-84 MGRS (UTM + UPS) grid, with the given label.
TLcdMGRSGridLayer(String aLabel, ILcdGeodeticDatum aGeodeticDatum) Constructs a layer depicting a MGRS (UTM + UPS) grid based on the given geodetic datum, with the given label.

Method Summary

Modifier and Type	Method and Description
void	addOverlayLabel(TLcdMGRSGridOverlayLabelBuilder aOverlayLabelBuilder, TLcdOverlayLayout.Location aLocation) Adds an overlay label that is painted on the view.
void	addPropertyChangeListener(PropertyChangeListener aPropertyChangeListener) Registers the given PropertyChangeListener to be notified when this object's properties change.
void	addSelectionListener(ILcdSelectionListener aSelectionListener) This layer does not support selection.
int	applyOnInteract(ILcdFunction aFunction, Rectangle aBounds, boolean aStrictInteract, ILcdGXYView aGXYView) No interaction is possible with this type of layer.
void	clearSelection(int aDispatchEventMode) This layer does not support selection.
void	fireCollectedSelectionChanges() This layer does not support selection.
ILcdBounds	getBounds(int aMode, ILcdGXYView aGXYView) This method returns the view bounds of this layer, taking into account the XYWorldReference of the given ILcdGXYView aGXYView.
ILcdGXYEditor	getGXYEditor(Object aObject) This layer does not support editing.
ILcdGXYLabelPainter	getGXYLabelPainter(Object aObject) Label painting of this layer is handled by an internal painter.
ILcdGXYPainter	getGXYPainter(Object aObject) Painting of this layer is handled by an internal painter.
ILcdGXYPen	getGXYPen() Grid lines are painted internally.
ILcdIcon	getIcon() Returns the icon to represent this layer.
String	getLabel() Returns the textual representation of this layer.
ILcdInterval	getLabelScaleRange() Returns the toolkit scale range for which to display labels for elements of the model.
TLcdMGRSGridStyle	getMGRSGridStyle() Returns the mgrs grid style to use when painting this layer.
ILcdModel	getModel() Returns a model with an element defining an MGRS grid.
Class	getModelXYWorldTransfoClass() Returns the transformation class that to use to transform points and bounds from model space to world space and back.
ILcdInterval	getScaleRange() Returns the toolkit scale range for which to display elements of the model.
int	getSelectionCount() This layer does not support selection.
boolean	isEditable() This layer does not support editing.
boolean	isEditableSupported() This layer does not support editing.
boolean	isLabeled() Returns whether the grids labels will be painted when the grid is painted.
boolean	isLabeledSupported() This layer supports labels.
boolean	isSelectable() This layer does not support selection.
boolean	isSelectableSupported() This layer does not support selection.
boolean	isSelected(Object aObject) This layer does not support selection.
boolean	isVisible() Whether or not this layer should be rendered.
void	paint(Graphics aGraphics, int aMode, ILcdGXYView aGXYView) Paints the combined representation of the layer's objects for a view, taking into account the mode.
void	removeOverlayLabel(TLcdMGRSGridOverlayLabelBuilder aOverlayLabelBuilder) Removes the overlay label created using the given overlay label builder.
void	removePropertyChangeListener(PropertyChangeListener aPropertyChangeListener) De-registers the given PropertyChangeListener from receiving property change events for this object.
void	removeSelectionListener(ILcdSelectionListener aSelectionListener) This layer does not support selection.
Enumeration	selectedObjects() This layer does not support selection.
void	selectObject(Object aObject, boolean aSelection, int aDispatchEventMode) This layer does not support selection.
void	setEditable(boolean aEditable) This layer does not support editing.
void	setIcon(ILcdIcon aIcon) Sets the icon to represent this layer.
void	setLabel(String aLabel) Sets the textual representation of this layer.
void	setLabeled(boolean aLabeled) Sets whether labels should be painted for the grid or not.
void	setMGRSGridStyle(TLcdMGRSGridStyle aStyle) Sets the mgrs grid style to use when painting this layer.
void	setSelectable(boolean aSelectable) This layer does not support selection.
void	setVisible(boolean aVisible) Sets whether or not the layer's content is painted.
void	stopPainting() Inform the layer that it should terminate the current paint operation.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.luciad.view.gxy.ILcdGXYLayer

getLabelMapScaleRange, getMapScaleRange

Methods inherited from interface com.luciad.util.ILcdSelection

getSelectedObjects

Constructor Detail

TLcdMGRSGridLayer

public TLcdMGRSGridLayer()

Constructs a layer depicting a WGS-84 MGRS (UTM + UPS) grid, with "MGRS Grid" as label.

TLcdMGRSGridLayer

public TLcdMGRSGridLayer(String aLabel)

Constructs a layer depicting a WGS-84 MGRS (UTM + UPS) grid, with the given label.

Parameters:

aLabel - the textual representation of this layer.

TLcdMGRSGridLayer

public TLcdMGRSGridLayer(String aLabel,
                         ILcdGeodeticDatum aGeodeticDatum)

Constructs a layer depicting a MGRS (UTM + UPS) grid based on the given geodetic datum, with the given label.

Parameters:

aLabel - the textual representation of this layer.

aGeodeticDatum - the datum on which the MGRS grid is located.

Method Detail

getGXYPainter

public ILcdGXYPainter getGXYPainter(Object aObject)

Painting of this layer is handled by an internal painter. This method will always return null.

Specified by:

getGXYPainter in interface ILcdGXYLayer

Parameters:

aObject - the object to find a painter for.

Returns:

null.

getGXYLabelPainter

public ILcdGXYLabelPainter getGXYLabelPainter(Object aObject)

Label painting of this layer is handled by an internal painter. This method will always return null.

Specified by:

getGXYLabelPainter in interface ILcdGXYLayer

Parameters:

aObject - the object to find a label painter for.

Returns:

null.

getGXYEditor

public ILcdGXYEditor getGXYEditor(Object aObject)

This layer does not support editing. No editors will be returned.

Specified by:

getGXYEditor in interface ILcdGXYLayer

Parameters:

aObject - the object to find an editor for.

Returns:

Always returns null.

applyOnInteract

public int applyOnInteract(ILcdFunction aFunction,
                           Rectangle aBounds,
                           boolean aStrictInteract,
                           ILcdGXYView aGXYView)

No interaction is possible with this type of layer.

Specified by:

applyOnInteract in interface ILcdGXYLayer

Parameters:

aFunction - the function to apply. When the function returns false, no more objects should be passed to the function.

aBounds - all objects who lie partially or completely in this area in the view are candidates to be passed to the function.

aStrictInteract - if true, the ILcdFunction shall be applied only to the objects interacting with the given bounds. When false is passed, other objects may be taken into account too. When applying the function to an object consumes less time than checking whether an objects representation interacts with the bounds, non-strict interaction is generally faster.

aGXYView - the view in whose bounds the objects representations should be in order to be passed to the function.

Returns:

Always returns 0.

getIcon

public ILcdIcon getIcon()

Returns the icon to represent this layer. By default the icon is null.

Specified by:

getIcon in interface ILcdLayer

Returns:

the icon to represent this layer.

See Also:

setIcon(com.luciad.gui.ILcdIcon)

setIcon

public void setIcon(ILcdIcon aIcon)

Sets the icon to represent this layer. By default the icon is null.

Specified by:

setIcon in interface ILcdLayer

Parameters:

aIcon - the icon to represent this layer.

See Also:

getIcon()

getGXYPen

public ILcdGXYPen getGXYPen()

Grid lines are painted internally. This method always returns null.

Specified by:

getGXYPen in interface ILcdGXYLayer

Returns:

null

setMGRSGridStyle

public void setMGRSGridStyle(TLcdMGRSGridStyle aStyle)

Sets the mgrs grid style to use when painting this layer. This style makes it for example possible to define the line color, scale levels, label formatting, ...

By default, this method returns a default mgrs style.

Parameters:

aStyle - the mgrs grid style to use when painting this layer.

See Also:

getMGRSGridStyle()

getMGRSGridStyle

public TLcdMGRSGridStyle getMGRSGridStyle()

Returns the mgrs grid style to use when painting this layer.

Returns:

the mgrs grid style to use when painting this layer.

See Also:

setMGRSGridStyle(com.luciad.view.map.mgrs.TLcdMGRSGridStyle)

addOverlayLabel

public void addOverlayLabel(TLcdMGRSGridOverlayLabelBuilder aOverlayLabelBuilder,
                            TLcdOverlayLayout.Location aLocation)

Adds an overlay label that is painted on the view.

The location parameter should not be equal to FULL_EXTENT or NO_LAYOUT. In that case an IllegalArgumentException is thrown.

It is not possible to pass the same overlay label builder instance twice to this method. In that case, an IllegalArgumentException is thrown.

In order to remove the overlay label again, the removeOverlayLabel should be called with the same instance as the one given in this method.

Parameters:

aOverlayLabelBuilder - a builder for overlay labels. Should not be null.

aLocation - the location at which this label is painted

removeOverlayLabel

public void removeOverlayLabel(TLcdMGRSGridOverlayLabelBuilder aOverlayLabelBuilder)

Removes the overlay label created using the given overlay label builder. This method only has effect when the same overlay label builder instance was previously passed to the addOverlayLabel method.

Parameters:

aOverlayLabelBuilder - the overlay label builder to remove.

getScaleRange

public ILcdInterval getScaleRange()

Returns the toolkit scale range for which to display elements of the model.

In other words, the paint method will not render any objects in a view when:
view.getScale() < getScaleRange().getMin() or view.getScale() >= getScaleRange().getMax().

This does not imply that all objects in the model should be painted when the scale is inside this range as other restrictions may apply. For example, a layer may have a filter which defines which objects should be painted.

For most use cases, we recommended using the unitless map scale range instead. This property is mutually exclusive with the map scale range: only one of them has a non-null value.

The scale range can be configured using setMGRSGridStyle(TLcdMGRSGridStyle)

Specified by:

getScaleRange in interface ILcdGXYLayer

Returns:

an ILcdInterval containing the minimum and maximum value of view scales for which objects should be rendered, excluding the maximum. null if the scale constraints are determined by ILcdGXYLayer.getMapScaleRange(). The scales are expressed in toolkit pixels/world unit.

See Also:

ILcdGXYLayer.getMapScaleRange()

getLabelScaleRange

public ILcdInterval getLabelScaleRange()

Returns the toolkit scale range for which to display labels for elements of the model.

In other words, the paint method will not render any labels for objects in a view when:
view.getScale() < getLabelScaleRange().getMin() or view.getScale() >= getLabelScaleRange().getMax().

This does not imply that labels for all objects in the model should be painted when the scale is inside this range as other restrictions may apply. For example, a layer may decide not to paint any labels for objects whose body is not painted.

For most use cases, we recommended using the unitless map scale range instead. This property is mutually exclusive with the label map scale range: only one of them has a non-null value.

The scale range can be configured using setMGRSGridStyle(TLcdMGRSGridStyle)

Specified by:

getLabelScaleRange in interface ILcdGXYLayer

Returns:

an ILcdInterval containing the minimum and maximum value of view scales for which labels should be rendered, excluding the maximum. null if the scale constraints are determined by ILcdGXYLayer.getLabelMapScaleRange() The scales are expressed in toolkit pixels/world unit.

See Also:

ILcdGXYLayer.getLabelMapScaleRange()

getBounds

public ILcdBounds getBounds(int aMode,
                            ILcdGXYView aGXYView)

This method returns the view bounds of this layer, taking into account the XYWorldReference of the given ILcdGXYView aGXYView.

Specified by:

getBounds in interface ILcdGXYLayer

Parameters:

aMode - a bitwise combination of ALL or SELECTION and one or more of BODIES and HANDLES. The ILcdGXYLayer.LABELS mode is not supported.

aGXYView - the view in which the layer could be placed. This enables taking into account the views settings, for example the scale.

Returns:

a bounds (in view coordinates, pixels) that encompasses the representation of all objects that are rendered in a view.

paint

public void paint(Graphics aGraphics,
                  int aMode,
                  ILcdGXYView aGXYView)

Description copied from interface: ILcdGXYLayer

Paints the combined representation of the layer's objects for a view, taking into account the mode.

The mode indicates what objects of the model should be taken into account and what representation should be provided. The objects to be taken into account shall be one of:

• ALL: all the objects in the layer's model, or
• SELECTION: all the objects in the layer's selection.

Note that the combined representation may contain less than the representation of all objects that were taken into account, as some objects may be disregarded for various reasons (filters, scale, ... ). When the views scale is outside the scale range (BODIES or HANDLES mode) or the label scale range (LABELS mode) nothing shall be painted.

The representations provided shall be one or more of:

• BODIES: the combination of geometric representations of the objects,
• HANDLES: the handles for the objects. These are the parts of the objects representation on which user interaction can be applied. For example, for a circle this can be the center point, allowing to move the circle.
• LABELS: the combination of the textual representations of the objects.

The mode supplied shall be a bitwise or combination of a constant of the first group and one or more of the second group. When painting in BODIES or HANDLES mode, painting of an object shall be delegated to the painter for that object, when the LABELS mode is passed, painting shall be delegated to the labelpainter for that object.

The view is passed to provide contextual information: some of the objects may have a different representation depending on the view, or depending on a property of the view, for example, the scale of the view.

The combined representation of the objects has to be painted on the Graphics supplied, as these may be different from the Graphics provided by the view (due to double buffering, for example).

When stopPainting is called, the current painting operation should be aborted.

Specified by:

paint in interface ILcdGXYLayer

Parameters:

aGraphics - the Graphics to paint on.

aMode - indicates what should be painted and how it should be painted.

aGXYView - the view to paint for.

See Also:

ILcdGXYLayer.getGXYPainter(Object), ILcdGXYLayer.getGXYLabelPainter(Object), ILcdGXYLayer.getScaleRange(), ILcdGXYLayer.getLabelScaleRange(), ILcdGXYLayer.stopPainting()

stopPainting

public void stopPainting()

Description copied from interface: ILcdGXYLayer

Inform the layer that it should terminate the current paint operation. This method can be useful when the paint method is executed in a specific Thread and needs to be stopped in a safe state from another Thread.

Specified by:

stopPainting in interface ILcdGXYLayer

See Also:

paint

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener aPropertyChangeListener)

Description copied from interface: ILcdPropertyChangeSource

Registers the given PropertyChangeListener to be notified when this object's properties change.

In case you need to register a listener which keeps a reference to an object with a shorter life-time than this change source, you can use a ALcdWeakPropertyChangeListener instance as property change listener.

Specified by:

addPropertyChangeListener in interface ILcdPropertyChangeSource

Parameters:

aPropertyChangeListener - The listener to be notified

See Also:

ALcdWeakPropertyChangeListener, ILcdPropertyChangeSource.removePropertyChangeListener(java.beans.PropertyChangeListener)

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener aPropertyChangeListener)

Description copied from interface: ILcdPropertyChangeSource

De-registers the given PropertyChangeListener from receiving property change events for this object.

If the listener was added more than once, it will be notified one less time after being removed. If the listener is null, or was never added, no exception is thrown and no action is taken.

Specified by:

removePropertyChangeListener in interface ILcdPropertyChangeSource

Parameters:

aPropertyChangeListener - the listener that should no longer be notified of changes of this object's properties

See Also:

ILcdPropertyChangeSource.addPropertyChangeListener(java.beans.PropertyChangeListener)

getModel

public ILcdModel getModel()

Returns a model with an element defining an MGRS grid. The model reference of the returned model is always a geodetic reference using the geodetic datum specified in the constructor of this class.

Specified by:

getModel in interface ILcdLayer

Returns:

the ILcdModel associated to this ILcdLayer

setVisible

public void setVisible(boolean aVisible)

Description copied from interface: ILcdLayer

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

Specified by:

setVisible in interface ILcdLayer

Parameters:

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

See Also:

ILcdLayer.isVisible()

isVisible

public boolean isVisible()

Whether or not this layer should be rendered. Default value is true.

Specified by:

isVisible in interface ILcdLayer

Returns:

true to render this layer, false to not render anything.

See Also:

ILcdLayer.setVisible(boolean)

isEditableSupported

public boolean isEditableSupported()

This layer does not support editing. This method always returns false.

Specified by:

isEditableSupported in interface ILcdLayer

Returns:

Always false.

See Also:

ILcdLayer.setEditable(boolean)

isEditable

public boolean isEditable()

This layer does not support editing. This method always returns false.

Specified by:

isEditable in interface ILcdLayer

Returns:

Always false.

See Also:

ILcdLayer.setEditable(boolean)

setEditable

public void setEditable(boolean aEditable)

This layer does not support editing. This method has an empty implementation.

Specified by:

setEditable in interface ILcdLayer

Parameters:

aEditable - true if the layer content can be edited

See Also:

ILcdLayer.isEditableSupported(), ILcdLayer.isEditable()

isSelectableSupported

public boolean isSelectableSupported()

This layer does not support selection. This method always returns false.

Specified by:

isSelectableSupported in interface ILcdLayer

Returns:

Always false.

See Also:

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

isSelectable

public boolean isSelectable()

This layer does not support selection. This method always returns false.

Specified by:

isSelectable in interface ILcdLayer

Returns:

Always false.

See Also:

ILcdSelection, ILcdLayer.setSelectable(boolean)

setSelectable

public void setSelectable(boolean aSelectable)

This layer does not support selection. This method has an empty implementation.

Specified by:

setSelectable in interface ILcdLayer

Parameters:

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

See Also:

ILcdLayer.isSelectable(), ILcdLayer.isSelectableSupported()

isLabeledSupported

public boolean isLabeledSupported()

This layer supports labels.

Specified by:

isLabeledSupported in interface ILcdGXYLayer

Returns:

Always true.

isLabeled

public boolean isLabeled()

Returns whether the grids labels will be painted when the grid is painted.

Specified by:

isLabeled in interface ILcdGXYLayer

Returns:

whether the grids labels will be painted when the grid is painted.

See Also:

ILcdGXYLayer.isLabeledSupported()

setLabeled

public void setLabeled(boolean aLabeled)

Sets whether labels should be painted for the grid or not.

Specified by:

setLabeled in interface ILcdGXYLayer

Parameters:

aLabeled - true to make sure labels should be painted, and false otherwise.

See Also:

isLabeled()

getLabel

public String getLabel()

Returns the textual representation of this layer.

Specified by:

getLabel in interface ILcdLayer

Returns:

the textual representation of this layer.

See Also:

setLabel(String)

setLabel

public void setLabel(String aLabel)

Sets the textual representation of this layer.

Specified by:

setLabel in interface ILcdLayer

Parameters:

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

See Also:

getLabel()

getSelectionCount

public int getSelectionCount()

This layer does not support selection. This method always returns 0.

Specified by:

getSelectionCount in interface ILcdSelection<Object>

Returns:

Always 0.

selectedObjects

public Enumeration selectedObjects()

This layer does not support selection. This method always returns an empty enumeration.

Specified by:

selectedObjects in interface ILcdSelection<Object>

Returns:

TLcdEmptyEnumeration.getInstance().

isSelected

public boolean isSelected(Object aObject)

This layer does not support selection. This method always returns false.

Specified by:

isSelected in interface ILcdSelection<Object>

Parameters:

aObject - the Object to be checked.

Returns:

false.

selectObject

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

This layer does not support selection. This method has an empty implementation.

Specified by:

selectObject in interface ILcdLayer

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:

ILcdFireEventMode

fireCollectedSelectionChanges

public void fireCollectedSelectionChanges()

This layer does not support selection. This method has an empty implementation.

Specified by:

fireCollectedSelectionChanges in interface ILcdLayer

clearSelection

public void clearSelection(int aDispatchEventMode)

This layer does not support selection. This method has an empty implementation.

Specified by:

clearSelection in interface ILcdLayer

Parameters:

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

See Also:

ILcdFireEventMode

addSelectionListener

public void addSelectionListener(ILcdSelectionListener aSelectionListener)

This layer does not support selection. This method has an empty implementation.

Specified by:

addSelectionListener in interface ILcdSelection<Object>

Parameters:

aSelectionListener - the ILcdSelectionListener to be added.

removeSelectionListener

public void removeSelectionListener(ILcdSelectionListener aSelectionListener)

This layer does not support selection. This method has an empty implementation.

Specified by:

removeSelectionListener in interface ILcdSelection<Object>

Parameters:

aSelectionListener - the ILcdSelectionListener to be removed.

getModelXYWorldTransfoClass

public Class getModelXYWorldTransfoClass()

Description copied from interface: ILcdGXYLayer

Returns the transformation class that to use to transform points and bounds from model space to world space and back. This class has to be conform with the reference of the model of this layer and the reference of the view this layer is part of.

Specified by:

getModelXYWorldTransfoClass in interface ILcdGXYLayer

Returns:

the transformation class that to use to transform points and bounds from model space to world space and back.