Class TLcdGXYViewJPanel
- All Implemented Interfaces:
ILcdAWTEventSource
,ILcdModelProducerListener
,ILcdPropertyChangeSource
,ILcdRotationCapable
,ILcdStatusSource
,ILcdGXYView
,ILcdGXYViewXYWorldTransformationProvider
,ILcdRotationCapableGXYView
,ILcdLayered
,ILcdTreeLayered
,ILcdView
,ImageObserver
,MenuContainer
,Serializable
,EventListener
,Accessible
- Direct Known Subclasses:
TLcdMapJPanel
ILcdGXYView
interface as a javax.swing.JPanel
.
In addition to the
ILcdGXYView
functionality, TLcdGXYViewJPanel
supports rotation and can
use an ILcdGXYLayerFactory
to automatically create ILcdGXYLayer
objects from models.
It also offers the ability to subscribe to view invalidation events
.
As with all Swing components, once the view has been realized, all code that might affect or depend on the state of that component should be executed in the event-dispatching thread. This includes all methods that can cause the view to repaint implicitly or explicitly.
This
For a ready-to-use implementation to display maps, see TLcdMapJPanel
.
- See Also:
-
Nested Class Summary
Nested classes/interfaces inherited from class javax.swing.JPanel
JPanel.AccessibleJPanel
Nested classes/interfaces inherited from class javax.swing.JComponent
JComponent.AccessibleJComponent
Nested classes/interfaces inherited from class java.awt.Container
Container.AccessibleAWTContainer
Nested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
-
Field Summary
Fields inherited from class javax.swing.JComponent
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
Fields inherited from class java.awt.Component
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
Fields inherited from interface com.luciad.view.gxy.ILcdGXYView
CENTER, LOWERLEFT, LOWERRIGHT, UPPERLEFT, UPPERRIGHT
Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
-
Constructor Summary
ConstructorDescriptionConstructs a new, emptyJPanel
-basedILcdGXYView
.TLcdGXYViewJPanel
(boolean aRegisterInstance) Deprecated.Use the default constructor.TLcdGXYViewJPanel
(ILcdTreeLayeredSupport aTreeLayeredSupport) Constructs a new, emptyJPanel
-basedILcdGXYView
. -
Method Summary
Modifier and TypeMethodDescriptionvoid
addAWTEventListener
(ILcdAWTEventListener aAWTListener) This method registers aILcdAWTEventListener
.boolean
addGXYLayer
(ILcdGXYLayer aLayer) Adds the givenILcdGXYLayer
to thisILcdGXYView
.boolean
addGXYLayer
(ILcdGXYLayer aLayer, boolean aRepaint) Adds the givenILcdGXYLayer
to thisILcdGXYView
, forcing a repaint if desired.void
addLayeredListener
(ILcdLayeredListener aLayeredListener) Registers the givenILcdLayeredListener
to be notified when layers are added, removed or moved in the flat list.void
addLayerSelectionListener
(ILcdSelectionListener aSelectionListener) Registers the givenILcdSelectionListener
to be informed of selection change events from any layer in this view.void
AddsaModel
to be displayed in thisILcdView
.void
addModelListener
(ILcdModelListener aModelListener) Registers the givenILcdModelListener
to be informed ofILcdModel
change events from any layer's model in this view.void
void
addPropertyChangeListener
(PropertyChangeListener aPropertyChangeListener) Registers a listener to be notified of component and view property changes.void
addStatusListener
(ILcdStatusListener aStatusListener) Registers the givenILcdStatusListener
to be notified of view status events.void
addViewInvalidationListener
(ILcdViewInvalidationListener aInvalidationListener) Registers anILcdViewInvalidationListener
to be informed when the view's contents are invalid.Deprecated.Cast the object toILcdGXYView
instead.boolean
containsLayer
(ILcdLayer aLayer) Returns whether the flat list representation of the hierarchical layer structure contains the given layer.Returns the background color of the view.getCornerIcon
(int aPosition) Returns theILcdIcon
to be painted at the given corner of the view.Deprecated.Use the relevant layer's pen instead.Returns the name of the view for display purposes.Returns theILcdGXYController
handling the user interaction of the view.Returns the layer factory used when adding models to the view.Returns the label painting algorithm for this view.Returns the label placer for this view.Returns a validILcdGXYViewXYWorldTransformation
for anILcdGXYView
.getImage()
Returns anImage
of this view.getLayer
(int aIndex) Returns theILcdLayer
with indexaIndex
in the flat list representation of the hierarchical layer structure.double
Returns the maximum zoomed in scale of the view.double
Returns the maximum zoomed out scale of the view.int
Returns the number of layers whose combined representation is cached across repaints.Returns a handler to report paint exceptions.int
Deprecated.This implementation ignores the painting mode setting, always making sure that bodies, labels and selections are painted.Returns the root node of the tree structure.double
Returns the rotation of thisILcdGXYView
.double
getScale()
Returns the scale for which to paint the view contents expressed in toolkit pixels per world unit.Returns the point in AWT pixel coordinates that maps onto the world origin.Returns the point in world coordinates that maps onto the view origin.Returns the view's 2D world coordinate system.boolean
Deprecated.getImage() always returns a valid imageint
Returns the index of the given layeraLayer
in the flat list representation of the hierarchical structure.void
invalidate
(boolean aRepaint, Object aSource, String aMessage) Asks the view to invalidate its content, optionally repainting the content asynchronously.void
invalidateAndWait
(boolean aRepaint, Object aSource, String aMessage) Asks the view to invalidate its content, optionally repainting the content synchronously.void
invalidateGXYLayer
(ILcdGXYLayer aGXYLayer, boolean aRepaint, Object aSource, String aMessage) Asks the view to invalidate the content of the givenILcdGXYLayer
, optionally repainting the content asynchronously.void
invalidateGXYLayerAndWait
(ILcdGXYLayer aGXYLayer, boolean aRepaint, Object aSource, String aMessage) Asks the view to invalidate the content of the givenILcdGXYLayer
, optionally repainting the content synchronously.void
invalidateRegion
(Rectangle aClip, boolean aRepaint, Object aSource, String aMessage) Asks the view to invalidate the content in the given AWT clip, optionally repainting the content asynchronously.void
invalidateRegionAndWait
(Rectangle aClip, boolean aRepaint, Object aSource, String aMessage) Asks the view to invalidate the content in the given AWT clip, optionally repainting the content synchronously.void
invalidateRegionSelection
(Rectangle aClip, boolean aRepaint, Object aSource, String aMessage) Asks the ILcdGXYView to invalidate its selection in the given AWT clip, optionally repainting the content asynchronously.void
invalidateRegionSelectionAndWait
(Rectangle aClip, boolean aRepaint, Object aSource, String aMessage) Asks the ILcdGXYView to invalidate its selection in the given AWT clip, optionally repainting the content synchronously.void
invalidateSelection
(boolean aRepaint, Object aSource, String aMessage) Asks the ILcdGXYView to invalidate its selection, optionally repainting the content asynchronously.void
invalidateSelectionAndWait
(boolean aRepaint, Object aSource, String aMessage) Asks the ILcdGXYView to invalidate its selection, optionally repainting the content synchronously.void
invokeLater
(Runnable aRunnable) Deprecated.boolean
Specifies if anti-aliasing is enabled or not.boolean
Returns whether this view allows asynchronous operations.boolean
Returns whether the view's contents are automatically updated when necessary.boolean
Returns whether the entire view's content is displayed, or only the controller's representation.boolean
Deprecated.This method has been deprecated in favor of the approach provided by theILcdGXYAsynchronousLayerWrapper
interface and its implementations, which is more versatile and which generally offers better thread safety.boolean
Indicates whether smart panning is turned on or off.boolean
Deprecated.This method has been deprecated.boolean
Deprecated.This property is not taken into account anymore.boolean
Returns whether a wait cursor is displayed when theILcdGXYView
is repainting.int
Returns the number of layers in the flat list representation of the hierarchical layer structure.Returns theILcdLayer
of the flat list that contains the givenILcdModel
.layers()
Returns anEnumeration
of all theILcdLayer
s currently in the flat list representation of the hierarchical layer structure, starting from the bottom layer to the top layer.Returns anEnumeration
of all theILcdLayer
s currently in the flat list representation of the hierarchical layer structure, starting from the top layer to the bottom layer.void
modelProduced
(TLcdModelProducerEvent aModelProducerEvent) The produced model is added to the view, provided that a layer factory supporting the model is set.void
moveLayerAt
(int aIndex, ILcdLayer aLayer) Moves the given layer (which is already inILcdLayered
) to the existing index aIndex.protected void
paintComponent
(Graphics aGraphics) Calls paintGXYView( aGraphics ).void
paintGXYView
(Graphics aGraphics) Paints the view on the givenGraphics
.void
pan
(int aDeltaX, int aDeltaY, boolean aRepaint) Changes the view and/or world origin of the view so that the view contents are panned by the specified AWT delta.protected void
printComponent
(Graphics aGraphics) OverridesJComponent.printComponent(java.awt.Graphics)
for unbuffered printing.protected void
void
putCornerIcon
(ILcdIcon aCornerIcon, int aPosition) Sets anILcdIcon
to be painted at the given corner of this view.protected void
Deprecated.TLcdBeanManager
registration is no longer used.void
Remove all the layers from the hierarchical layer structure and the flat list representation.void
removeAWTEventListener
(ILcdAWTEventListener aAWTListener) This method removes a registeredILcdAWTEventListener
, or does nothing if the passed listener wasn't registered.void
removeLayer
(ILcdLayer aLayer) Removes a layer from both the hierarchical layer structure and the flat list representation.void
removeLayeredListener
(ILcdLayeredListener aLayeredListener) Unregisters the givenILcdLayeredListener
from receiving layered events for the flat list.void
removeLayerSelectionListener
(ILcdSelectionListener aSelectionListener) Unregisters the givenILcdSelectionListener
from receiving selection change events from any layer in this view.void
removeModel
(ILcdModel aModel) Removes theILcdGXYLayer
containing the model from the view.void
removeModelListener
(ILcdModelListener aModelListener) Unregisters the givenILcdModelListener
from receivingILcdModel
change events from any layer's model in this view.void
removePropertyChangeListener
(PropertyChangeListener aPropertyChangeListener) Unregisters the givenPropertyChangeListener
from receiving property change events for this view.void
removeStatusListener
(ILcdStatusListener aStatusListener) Unregisters the givenILcdStatusListener
from being notified of view status events.void
removeViewInvalidationListener
(ILcdViewInvalidationListener aInvalidationListener) Unregisters anILcdViewInvalidationListener
so that it is no longer informed of invalidation events for this view.void
setAntiAliased
(boolean aAntiAliased) Changes the anti-aliasing behavior.void
setAsynchronousAllowed
(boolean aAsynchronousAllowed) Sets if asynchronous operation are allowed for this view.void
setAutoUpdate
(boolean aAutoUpdate) Sets whether to update the view's representation automatically to keep it in sync with its state and the state of its models.void
setBackground
(Color aColor) Sets the background color of the view.static void
setClassTraceOn
(boolean aClassTraceOn) Deprecated.This method has been deprecated.void
setDefaultPen
(ILcdGXYPen aDefaultPen) Deprecated.Use the relevant layer's pen instead.void
setDisplayName
(String newDisplayName) Sets the name of the view for display purposes.void
setDrawOffScreenImageOnPaint
(boolean aDrawOffScreenImageOnPaint) Sets whether the entire view's content is displayed, or only the current controller's representation.void
setGXYController
(ILcdGXYController aGXYViewController) Makes the givenILcdGXYController
handle the user interaction of the view.void
setGXYLayerFactory
(ILcdGXYLayerFactory newGXYLayerFactory) Sets the layer factory to use when adding models to the view.void
setGXYViewLabelPainter
(ILcdGXYViewLabelPainter aGXYViewLabelPainter) Sets the label painter algorithm for thisILcdGXYView
.void
setGXYViewLabelPlacer
(ILcdGXYViewLabelPlacer aGXYViewLabelPlacer) This method sets anILcdGXYViewLabelPlacer
to use for global labeling.void
setMaxScale
(double aMaxScale) Limits the maximum zoomed in scale of the view.void
setMinScale
(double aMinScale) Limits the maximum zoomed out scale of the view.void
setNumberOfCachedBackgroundLayers
(int aNumberOfCachedBackgroundLayers) Sets the number of layers whose combined representation is cached across repaints.void
setPaintExceptionHandler
(ILcdPaintExceptionHandler aPaintExceptionHandler) Sets a handler to report paint exceptions.void
setPaintInBackground
(boolean aUpdateInBackground) Deprecated.This method has been deprecated in favor of the approach provided by theILcdGXYAsynchronousLayerWrapper
interface and its implementations, which is more versatile and which generally offers better thread safety.void
setPaintingMode
(int aPaintingMode) Deprecated.This implementation ignores the painting mode setting, always making sure that bodies, labels and selections are painted.void
setRotation
(double aRotation) Sets the rotation of thisILcdGXYView
, updating the view according toILcdView.isAutoUpdate()
.void
setRotation
(double aRotation, boolean aAdjusting) Sets the rotation of thisILcdGXYView
, optionally indicating subsequent property changes.void
setRotation
(double aRotation, boolean aRepaint, boolean aAdjusting) Sets the rotation of thisILcdGXYView
, optionally repainting the view.void
setScale
(double aScale) Sets the scale of this view, repainting the view according toisAutoUpdate
.void
setScale
(double aScale, boolean aRepaint) Sets the scale of this view, optionally repainting the view.void
setScale
(double aScale, boolean aRepaint, boolean aAdjusting) Sets the scale of this view, optionally indicating subsequent property changes.void
setScale
(double aScaleX, double aScaleY, boolean aRepaint, boolean aAdjusting) Sets the scale along the x-axis and y-axis of this view, repainting the view according toisAutoUpdate
.void
setSmartPan
(boolean aSmartPan) Sets whether to reuse existing imagery when panning.void
setTraceOn
(boolean aTraceOn) Deprecated.This method has been deprecated.void
setUpdateLabelsOnSelectionChanged
(boolean aUpdateLabelsOnSelectionChanged) Deprecated.This property is not used.void
setViewOrigin
(Point aViewOrigin) Sets the view origin of the view, repainting the view according toisAutoUpdate
.void
setViewOrigin
(Point aViewOrigin, boolean aRepaint) Sets the view origin of the view, optionally repainting the view.void
setViewOrigin
(Point aViewOrigin, boolean aRepaint, boolean aAdjusting) Sets the view origin of the view, optionally indicating subsequent property changes.void
setWaitCursorOn
(boolean aWaitCursorOn) Sets whether to display a wait cursor when theILcdGXYView
is repainting.void
setWorldOrigin
(ILcdPoint aWorldOrigin) Sets the world origin of the view, repainting the view according toisAutoUpdate
.void
setWorldOrigin
(ILcdPoint aWorldOrigin, boolean aRepaint) Sets the world origin of the view, optionally repainting the view.void
setWorldOrigin
(ILcdPoint aWorldOrigin, boolean aRepaint, boolean aAdjusting) Sets the world origin of the view, optionally indicating subsequent property changes.void
setXYWorldReference
(ILcdXYWorldReference aXYWorldReference) Sets the view's 2D world coordinate system, repainting the view according toisAutoUpdate
.void
setXYWorldReference
(ILcdXYWorldReference aXYWorldReference, boolean aRepaint) Sets the view's 2D world coordinate system, optionally repainting the view.void
setXYWorldReference
(ILcdXYWorldReference aXYWorldReference, boolean aRepaint, boolean aAdjusting) Sets the view's 2D world coordinate system, optionally indicating subsequent property changes.Methods inherited from class javax.swing.JPanel
getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI
Methods inherited from class javax.swing.JComponent
addAncestorListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
Methods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree
Methods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Methods inherited from interface com.luciad.view.gxy.ILcdGXYView
getForeground, getGraphics, getHeight, getLayers, getMapScale, getMapScaleRange, getPreferredSize, getWidth, repaint, repaint, setCursor, setForeground, setMapScale, setMapScaleRange
Methods inherited from interface com.luciad.view.ILcdLayered
addLayeredListener, removeLayeredListener
-
Constructor Details
-
TLcdGXYViewJPanel
public TLcdGXYViewJPanel()Constructs a new, emptyJPanel
-basedILcdGXYView
. Auto-update is activated by default, no background layers are cached, and no default user interaction is provided.After construction, a world coordinate system needs to be set using
setXYWorldReference(com.luciad.view.ILcdXYWorldReference)
. -
TLcdGXYViewJPanel
Constructs a new, empty
JPanel
-basedILcdGXYView
. Auto-update is activated by default, no background layers are cached, and no default user interaction is provided.After construction, a world coordinate system needs to be set using
setXYWorldReference(com.luciad.view.ILcdXYWorldReference)
.- Parameters:
aTreeLayeredSupport
- an instance ofILcdTreeLayeredSupport
used to store the layers
-
TLcdGXYViewJPanel
public TLcdGXYViewJPanel(boolean aRegisterInstance) Deprecated.Use the default constructor.Constructs a new, emptyJPanel
-basedILcdGXYView
.- Parameters:
aRegisterInstance
- if true, registers the view withTLcdBeanManager
- See Also:
-
-
Method Details
-
setClassTraceOn
public static void setClassTraceOn(boolean aClassTraceOn) Deprecated.This method has been deprecated. It is recommended to use the standard Java logging framework directly.Enables tracing for all instances of this class. If the argument istrue
then all log messages are recorded, otherwise only the informative, warning and error messages are recorded.- Parameters:
aClassTraceOn
- if true then all log messages are recorded, otherwise only the informative, warning and error messages are recorded.
-
setTraceOn
public void setTraceOn(boolean aTraceOn) Deprecated.This method has been deprecated. It is recommended to use the standard Java logging framework directly.Enables tracing for this class instance. Calling this method with eithertrue
orfalse
as argument automatically turns off tracing for all other class instances for whichsetTraceOn
has not been called. If the argument isfalse
then only the informative, warning and error log messages are recorded.- Parameters:
aTraceOn
- if true then all log messages are recorded for this instance. If false, then only the informative, warning and error log messages are recorded.
-
isTraceOn
public boolean isTraceOn()Deprecated.This method has been deprecated. It is recommended to use the standard Java logging framework directly.Returnstrue
if tracing is enabled for this class.- Returns:
- true if tracing is enabled for this class, false otherwise.
-
processEvent
- Overrides:
processEvent
in classContainer
-
pan
public void pan(int aDeltaX, int aDeltaY, boolean aRepaint) Changes the view and/or world origin of the view so that the view contents are panned by the specified AWT delta. Implementations of this method are allowed to only repaint newly exposed areas, hence this method is preferred over simply changing the world origin. The repaint behavior is controlled by thesmart pan
feature.- Specified by:
pan
in interfaceILcdGXYView
- Parameters:
aDeltaX
- the shift in the X direction in screen coordinatesaDeltaY
- the shift in the Y direction in screen coordinatesaRepaint
- iftrue
, will trigger a repaint of the view's contents. Depending on the implementation, only the newly exposed areas may be painted. If false, the view is not repainted.- See Also:
-
invokeLater
Deprecated.- Parameters:
aRunnable
- runnable to invoke
-
paintComponent
Calls paintGXYView( aGraphics ).- Overrides:
paintComponent
in classJComponent
- See Also:
-
paintGXYView
Description copied from interface:ILcdGXYView
Paints the view on the givenGraphics
. The painted image contains the following:- a background color;
- the bodies of each contained layer's models. Each layer is asked to paint itself, from bottom to top;
- the labels of each contained layer's models.
Typically labels are painted on top of any bodies.
The labels are painted by the layer itself, or by a
view label painter
, if it is set; - the selected bodies of each contained layer's models. Typically selections are painted on top of bodies and labels.
- the selected labels of each contained layer's models. The labels are painted by the layer itself, or by a view label painter, if it is set;
- corner icons, if any;
- the controller handling user interaction.
invalidate
methods.- Specified by:
paintGXYView
in interfaceILcdGXYView
- Parameters:
aGraphics
- theGraphics
to paint the contents of this view on- See Also:
-
printComponent
OverridesJComponent.printComponent(java.awt.Graphics)
for unbuffered printing.- Overrides:
printComponent
in classJComponent
-
registerInstance
protected void registerInstance()Deprecated.TLcdBeanManager
registration is no longer used.Registers the view withTLcdBeanManager
-
asGXYView
Deprecated.Cast the object toILcdGXYView
instead.Returns the view as a pureILcdGXYView
.- Returns:
- this view
-
setDisplayName
Sets the name of the view for display purposes. The display name can be used to distinguish views.- Parameters:
newDisplayName
- the new name of the view- See Also:
-
getDisplayName
Returns the name of the view for display purposes. The display name can be used to distinguish views.- Returns:
- the name of the view
- See Also:
-
addNotify
public void addNotify()- Overrides:
addNotify
in classJComponent
-
addModel
AddsaModel
to be displayed in thisILcdView
.This method creates an
ILcdGXYLayer
containing the model and adds it to the view. For this to work, a layer factory supporting the given model must be set on the view.- Specified by:
addModel
in interfaceILcdView
- Throws:
IllegalArgumentException
- if the model isnull
, if no layer factory is set, or if the layer factory cannot create a layer for the given model- See Also:
-
removeModel
Removes theILcdGXYLayer
containing the model from the view. Removes a single representation of the specified model from this view, if it is present in the view.- Specified by:
removeModel
in interfaceILcdView
- See Also:
-
addLayeredListener
Registers the givenILcdLayeredListener
to be notified when layers are added, removed or moved in the flat list.- Specified by:
addLayeredListener
in interfaceILcdLayered
- Specified by:
addLayeredListener
in interfaceILcdTreeLayered
- Parameters:
aLayeredListener
- the listener that from now on will be notified of all changes to the flat list.- See Also:
-
removeLayeredListener
Unregisters the givenILcdLayeredListener
from receiving layered events for the flat list.- Specified by:
removeLayeredListener
in interfaceILcdLayered
- Specified by:
removeLayeredListener
in interfaceILcdTreeLayered
- Parameters:
aLayeredListener
- the listener that will no longer be notified of changes in the flat list.- See Also:
-
layerCount
public int layerCount()Description copied from interface:ILcdTreeLayered
Returns the number of layers in the flat list representation of the hierarchical layer structure. This does not include the root node.
- Specified by:
layerCount
in interfaceILcdLayered
- Specified by:
layerCount
in interfaceILcdTreeLayered
- Returns:
- the number of layers in the flat list. Does not include the root node.
-
layers
Description copied from interface:ILcdTreeLayered
Returns an
Enumeration
of all theILcdLayer
s currently in the flat list representation of the hierarchical layer structure, starting from the bottom layer to the top layer. This does not include the root node.- Specified by:
layers
in interfaceILcdLayered
- Specified by:
layers
in interfaceILcdTreeLayered
- Returns:
- an
Enumeration
of all theILcdLayer
s currently in the flat list, starting from the bottom layer to the top layer. Does not include the root node.
-
layersBackwards
Description copied from interface:ILcdTreeLayered
Returns an
Enumeration
of all theILcdLayer
s currently in the flat list representation of the hierarchical layer structure, starting from the top layer to the bottom layer. This does not include the root node.- Specified by:
layersBackwards
in interfaceILcdLayered
- Specified by:
layersBackwards
in interfaceILcdTreeLayered
- Returns:
- an
Enumeration
of all theILcdLayer
s currently in the flat list, starting from the top layer to the bottom layer. Does not include the root node.
-
getLayer
Description copied from interface:ILcdTreeLayered
Returns the
ILcdLayer
with indexaIndex
in the flat list representation of the hierarchical layer structure.- Specified by:
getLayer
in interfaceILcdLayered
- Specified by:
getLayer
in interfaceILcdTreeLayered
- Parameters:
aIndex
- the position of the layer to retrieve in the flat list representation.- Returns:
- the
ILcdLayer
with indexaIndex
in the flat list representation - Throws:
ArrayIndexOutOfBoundsException
- if the given index is invalid
-
layerOf
Returns theILcdLayer
of the flat list that contains the givenILcdModel
. If more than one layer contain the model, the bottommost is returned.- Specified by:
layerOf
in interfaceILcdLayered
- Specified by:
layerOf
in interfaceILcdTreeLayered
- Parameters:
aModel
- the model to check for in the flat list- Returns:
- the
ILcdLayer
of the flat list that contains the givenILcdModel
. - Throws:
NoSuchElementException
- if there is no layer containing the given model
-
indexOf
Description copied from interface:ILcdTreeLayered
Returns the index of the given layer
aLayer
in the flat list representation of the hierarchical structure.- Specified by:
indexOf
in interfaceILcdLayered
- Specified by:
indexOf
in interfaceILcdTreeLayered
- Parameters:
aLayer
- the layer whose index to return- Returns:
- the index of
aLayer
in the flat list representation - Throws:
NoSuchElementException
- ifaLayer
is not in the flat list
-
moveLayerAt
public void moveLayerAt(int aIndex, ILcdLayer aLayer) throws NoSuchElementException, ArrayIndexOutOfBoundsException Description copied from interface:ILcdLayered
Moves the given layer (which is already inILcdLayered
) to the existing index aIndex. When a layer is moved down, all layers in between the previous and future position of the given layer (including the layer at index aIndex) are moved one position up. When a layer is moved up, all layers in between the previous and future position of the given layer (including the layer at index aIndex) are moved one position down.More formally, let previousIndex be the index of
aLayer
before the move. If previousIndex < aIndex, then the index of allILcdLayer
objects in from previousIndex + 1 to aIndex is decremented with 1. If previousIndex > aIndex, then the index of allILcdLayer
objects in from aIndex to previousIndex -1 is incremented with 1.- Specified by:
moveLayerAt
in interfaceILcdLayered
- Parameters:
aIndex
- the index of the position where to move the layer.aLayer
- the layer to move.- Throws:
NoSuchElementException
- ifaLayer
is not in thisILcdLayered
.ArrayIndexOutOfBoundsException
- ifaIndex
is not an index of one of the layers of thisILcdLayered
.
-
removeLayer
Description copied from interface:ILcdTreeLayered
Removes a layer from both the hierarchical layer structure and the flat list representation. When removing an
ILcdLayerTreeNode
all of its children will also be removed. An event will then be generated for every layer that has been removed (one for the node and one for each of its child layers).It is not possible to remove the root node
- Specified by:
removeLayer
in interfaceILcdLayered
- Specified by:
removeLayer
in interfaceILcdTreeLayered
- Parameters:
aLayer
- the layer to remove. If the layer is not in the flat list, this method has no effect.
-
removeAllLayers
public void removeAllLayers()Description copied from interface:ILcdTreeLayered
Remove all the layers from the hierarchical layer structure and the flat list representation. An event will be fired for every layer that has been removed. This will not remove the root node.
- Specified by:
removeAllLayers
in interfaceILcdLayered
- Specified by:
removeAllLayers
in interfaceILcdTreeLayered
-
containsLayer
Description copied from interface:ILcdTreeLayered
Returns whether the flat list representation of the hierarchical layer structure contains the given layer. More formally, returns
true
if and only if the flat list representation contains at least one layerl
such that (aLayer==null ? l==null : aLayer.equals(l)).Calling this method with the root node will return
false
, since the root node is not a part of the flat list representation.- Specified by:
containsLayer
in interfaceILcdLayered
- Specified by:
containsLayer
in interfaceILcdTreeLayered
- Parameters:
aLayer
- the layer to check whether it is in the flat list representation- Returns:
true
when the flat list representation contains the given layer,false
otherwise
-
putCornerIcon
Sets anILcdIcon
to be painted at the given corner of this view. Only the last set icon for the given position is painted.- Specified by:
putCornerIcon
in interfaceILcdGXYView
- Parameters:
aCornerIcon
- theILcdIcon
to be painted at the given corner ornull
to unregister the iconaPosition
- one ofILcdGXYView.UPPERLEFT
,ILcdGXYView.UPPERRIGHT
,ILcdGXYView.LOWERRIGHT
,ILcdGXYView.LOWERLEFT
- See Also:
-
getCornerIcon
Returns theILcdIcon
to be painted at the given corner of the view.- Parameters:
aPosition
- one ofILcdGXYView.UPPERLEFT
,ILcdGXYView.UPPERRIGHT
,ILcdGXYView.LOWERRIGHT
,ILcdGXYView.LOWERLEFT
- Returns:
- the
ILcdIcon
to be painted at the given corner ornull
when no icon has to be painted at the given corner - See Also:
-
addGXYLayer
Description copied from interface:ILcdGXYView
Adds the givenILcdGXYLayer
to thisILcdGXYView
. The layer is normally added to the top of the view's layers, but that is implementation specific. The view will be repainted depending on the result ofisAutoUpdate
. No action is performed if the given layer is already contained in the list.- Specified by:
addGXYLayer
in interfaceILcdGXYView
- Parameters:
aLayer
- the layer to add to this view- Returns:
true
if the layer was added successfully,false
if the view already contained the layer- See Also:
-
addGXYLayer
Description copied from interface:ILcdGXYView
Adds the givenILcdGXYLayer
to thisILcdGXYView
, forcing a repaint if desired. The layer is normally added to the top of the view's layers, but that is implementation specific. No action is performed if the given layer is already contained in the list.- Specified by:
addGXYLayer
in interfaceILcdGXYView
- Parameters:
aLayer
- the layer to add to this viewaRepaint
- if true, the view is repainted. If false, the view is not repainted.- Returns:
true
if the layer was added successfully,false
if the view already contained the layer- See Also:
-
getNumberOfCachedBackgroundLayers
public int getNumberOfCachedBackgroundLayers()Description copied from interface:ILcdGXYView
Returns the number of layers whose combined representation is cached across repaints. The layers are always the bottommost layer objects; they are regarded as background layers.- Specified by:
getNumberOfCachedBackgroundLayers
in interfaceILcdGXYView
- Returns:
- the number of bottommost layers to cache
- See Also:
-
setNumberOfCachedBackgroundLayers
public void setNumberOfCachedBackgroundLayers(int aNumberOfCachedBackgroundLayers) Description copied from interface:ILcdGXYView
Sets the number of layers whose combined representation is cached across repaints. The layers are the bottommost layer objects; they are regarded as background layers.Caching background layers is useful when one upper real-time layer needs to be refreshed often, whereas the contents of the background layers seldom change. When a real-time layer changes and needs to be repainted, the cached representation of the background layers is reused, speeding up the paint process. When a background layer changes, all layers need to be repainted to update the view.
- Specified by:
setNumberOfCachedBackgroundLayers
in interfaceILcdGXYView
- Parameters:
aNumberOfCachedBackgroundLayers
- the number of bottommost layers to cache. This number applies to theflat list
of layers.- See Also:
-
hasValidImage
public boolean hasValidImage()Deprecated.getImage() always returns a valid imageReturnstrue
if the view has a valid image.- Specified by:
hasValidImage
in interfaceILcdGXYView
- Returns:
true
- See Also:
-
getImage
Description copied from interface:ILcdGXYView
Returns anImage
of this view. The image has not been painted on by the controller. This method is guaranteed to return an up-to-date image: if the view has been invalidated in some way (e.g. when a layer has been removed) then this method first updates the view before returning an image. To improve performance and conserve memory, the view is allowed to cache, reuse and overwrite the image in subsequent repaints. NOTE: While using High DPI mode, this method will return an image which is bigger than the view dimensions reported bygetWidth()
andgetHeight()
methods.- Specified by:
getImage
in interfaceILcdGXYView
- Returns:
- an image containing the representation of this view
-
setBackground
Sets the background color of the view. This is the color that appears when no objects are painted on top of it.The default color is the color returned by SystemColor.control. Note that the alpha channel of the Color is not taken into account.
- Specified by:
setBackground
in interfaceILcdGXYView
- Overrides:
setBackground
in classJComponent
- Parameters:
aColor
- the color which appears at a location where no data is painted.- See Also:
-
getBackground
Returns the background color of the view. This is the color that appears when no objects are painted on top of it.The default color is the color returned by SystemColor.control. Note that the alpha channel of the Color is not taken into account.
- Specified by:
getBackground
in interfaceILcdGXYView
- Overrides:
getBackground
in classComponent
- Returns:
- the background color of the view
- See Also:
-
setScale
public void setScale(double aScale) Description copied from interface:ILcdGXYView
Sets the scale of this view, repainting the view according toisAutoUpdate
. The scale corresponds to the number of pixels per world unit, as determined by theILcdXYWorldReference
. Hence, increasing the scale zooms in, and decreasing the scale zooms out.A view displaying geographical data usually employs a scale in pixels per meter. As an example, to fit the world on a view that is 1000 pixels wide, a scale of about 1000 pixels/40.000km, or 1.0/40.000 is needed.
For most use cases, we recommended setting the
unitless map scale
instead.- Specified by:
setScale
in interfaceILcdGXYView
- Parameters:
aScale
- the new scale of the view. The view is scaled using the world origin as center. The scale is limited so that it does not exceed the interval defined by the minimum and maximum scales.- See Also:
-
setScale
public void setScale(double aScale, boolean aRepaint) Description copied from interface:ILcdGXYView
Sets the scale of this view, optionally repainting the view. The scale corresponds to the number of pixels per world unit, as determined by theILcdXYWorldReference
. Hence, increasing the scale zooms in, and decreasing the scale zooms out.A view displaying geographical data usually employs a scale in pixels per meter. As an example, to fit the world on a view that is 1000 pixels wide, a scale of about 1000 pixels/40.000km, or 1.0/40.000 is needed.
For most use cases, we recommended setting the
unitless map scale
instead.- Specified by:
setScale
in interfaceILcdGXYView
- Parameters:
aScale
- the new scale of the view. The view is scaled using the world origin as center. The scale is limited so that it does not exceed the interval defined by the minimum and maximum scales.aRepaint
- iftrue
, the view is repainted. If false, the view is not repainted.- See Also:
-
setScale
public void setScale(double aScale, boolean aRepaint, boolean aAdjusting) Description copied from interface:ILcdGXYView
Sets the scale of this view, optionally indicating subsequent property changes. The scale corresponds to the number of pixels per world unit, as determined by theILcdXYWorldReference
. Hence, increasing the scale zooms in, and decreasing the scale zooms out.A view displaying geographical data usually employs a scale in pixels per meter. As an example, to fit the world on a view that is 1000 pixels wide, a scale of about 1000 pixels/40.000km, or 1.0/40.000 is needed.
For most use cases, we recommended setting the
unitless map scale
instead.- Specified by:
setScale
in interfaceILcdGXYView
- Parameters:
aScale
- the new scale of the view. The view is scaled using the world origin as center. The scale is limited so that it does not exceed the interval defined by the minimum and maximum scales.aRepaint
- iftrue
, the view is repainted. If false, the view is not repainted.aAdjusting
- iftrue
, the caller indicates that he will trigger another property change right after this call. This is reflected in the associated property change event.- See Also:
-
setScale
public void setScale(double aScaleX, double aScaleY, boolean aRepaint, boolean aAdjusting) Description copied from interface:ILcdGXYView
Sets the scale along the x-axis and y-axis of this view, repainting the view according toisAutoUpdate
.The scale corresponds to the number of pixels per world unit, as determined by the
ILcdXYWorldReference
. For example, a view displaying geographical data could use a scale in pixels per meter.The default implementation in this interface sets both scales to the geometric mean of the requested scales. The concrete view implementations do respect the individual scales.
- Specified by:
setScale
in interfaceILcdGXYView
- Parameters:
aScaleX
- the new scale along the x-axis of the view.aScaleY
- the new scale along the y-axis of the view.aRepaint
- iftrue
, the view is repainted. If false, the view is not repainted.aAdjusting
- iftrue
, the caller indicates that he will trigger another property change right after this call. This is reflected in the associated property change event.- See Also:
-
getScale
public double getScale()Description copied from interface:ILcdGXYView
Returns the scale for which to paint the view contents expressed in toolkit pixels per world unit. The world unit is determined by the view's world reference. Increasing the scale zooms in, and decreasing the scale zooms out.For most use cases, we recommended using the
unitless map scale
instead.- Specified by:
getScale
in interfaceILcdGXYView
- Returns:
- the scale of this view
- See Also:
-
setMinScale
public void setMinScale(double aMinScale) Description copied from interface:ILcdGXYView
Limits the maximum zoomed out scale of the view. Subsequent calls ofILcdGXYView.setScale(double)
orILcdGXYView.setMapScale(com.luciad.view.TLcdMapScale, com.luciad.view.TLcdMapScale.ScaleLocation)
will ensure that the scale does not fall below the minimum scale.For most use cases, we recommended using the
unitless map scale
variant instead.- Specified by:
setMinScale
in interfaceILcdGXYView
- Parameters:
aMinScale
- the new minimum scale of this view- See Also:
-
getMinScale
public double getMinScale()Description copied from interface:ILcdGXYView
Returns the maximum zoomed out scale of the view. Subsequent calls ofILcdGXYView.setScale(double)
orILcdGXYView.setMapScale(com.luciad.view.TLcdMapScale, com.luciad.view.TLcdMapScale.ScaleLocation)
will ensure that the scale does not fall below the minimum scale.For most use cases, we recommended using the
unitless map scale
variant instead.- Specified by:
getMinScale
in interfaceILcdGXYView
- Returns:
- the minimum scale of the view
- See Also:
-
setMaxScale
public void setMaxScale(double aMaxScale) Description copied from interface:ILcdGXYView
Limits the maximum zoomed in scale of the view. Subsequent calls ofILcdGXYView.setScale(double)
orILcdGXYView.setMapScale(com.luciad.view.TLcdMapScale, com.luciad.view.TLcdMapScale.ScaleLocation)
will ensure that the scale does not rise above the maximum scale.For most use cases, we recommended using the
unitless map scale
variant instead.- Specified by:
setMaxScale
in interfaceILcdGXYView
- Parameters:
aMaxScale
- the new maximum scale of this view- See Also:
-
getMaxScale
public double getMaxScale()Description copied from interface:ILcdGXYView
Returns the maximum zoomed in scale of the view. Subsequent calls ofILcdGXYView.setScale(double)
orILcdGXYView.setMapScale(com.luciad.view.TLcdMapScale, com.luciad.view.TLcdMapScale.ScaleLocation)
will ensure that the scale does not rise above the maximum scale.For most use cases, we recommended using the
unitless map scale
variant instead.- Specified by:
getMaxScale
in interfaceILcdGXYView
- Returns:
- the maximum scale of the view
- See Also:
-
setWorldOrigin
Description copied from interface:ILcdGXYView
Sets the world origin of the view, repainting the view according toisAutoUpdate
. The world origin is a point in world coordinates that maps onto the view origin.- Specified by:
setWorldOrigin
in interfaceILcdGXYView
- Parameters:
aWorldOrigin
- the new world origin of this view, expressed in world coordinates. Only the XY coordinates are considered.- See Also:
-
setWorldOrigin
Description copied from interface:ILcdGXYView
Sets the world origin of the view, optionally repainting the view. The world origin is a point in world coordinates that maps onto the view origin.- Specified by:
setWorldOrigin
in interfaceILcdGXYView
- Parameters:
aWorldOrigin
- the new world origin of this view, expressed in world coordinates. Only the XY coordinates are considered.aRepaint
- iftrue
, the view is repainted. If false, the view is not repainted.- See Also:
-
setWorldOrigin
Description copied from interface:ILcdGXYView
Sets the world origin of the view, optionally indicating subsequent property changes. The world origin is a point in world coordinates that maps onto the view origin.- Specified by:
setWorldOrigin
in interfaceILcdGXYView
- Parameters:
aWorldOrigin
- the new world origin of this view, expressed in world coordinates. Only the XY coordinates are considered.aRepaint
- iftrue
, the view is repainted. If false, the view is not repainted.aAdjusting
- iftrue
, the caller indicates that he will trigger another property change right after this call. This is reflected in the associated property change event.- See Also:
-
getWorldOrigin
Description copied from interface:ILcdGXYView
Returns the point in world coordinates that maps onto the view origin. Hence, the combination of world origin and view origin determines which part of the world is visible in the view. The points are considered to be 'on top of each other'- Specified by:
getWorldOrigin
in interfaceILcdGXYView
- Returns:
- the world origin of the view, expressed in world coordinates. Only the XY coordinates of the point are relevant.
- See Also:
-
setViewOrigin
Description copied from interface:ILcdGXYView
Sets the view origin of the view, repainting the view according toisAutoUpdate
. The view origin is a point in AWT pixel coordinates that maps onto the world origin.- Specified by:
setViewOrigin
in interfaceILcdGXYView
- Parameters:
aViewOrigin
- the new view origin of this view, expressed in AWT pixel coordinates- See Also:
-
setViewOrigin
Description copied from interface:ILcdGXYView
Sets the view origin of the view, optionally repainting the view. The view origin is a point in AWT pixel coordinates that maps onto the world origin.- Specified by:
setViewOrigin
in interfaceILcdGXYView
- Parameters:
aViewOrigin
- the new view origin of this view, expressed in AWT pixel coordinatesaRepaint
- iftrue
, the view is repainted. If false, the view is not repainted.- See Also:
-
setViewOrigin
Description copied from interface:ILcdGXYView
Sets the view origin of the view, optionally indicating subsequent property changes. The view origin is a point in AWT pixel coordinates that maps onto the world origin.- Specified by:
setViewOrigin
in interfaceILcdGXYView
- Parameters:
aViewOrigin
- the new view origin of this view, expressed in AWT pixel coordinatesaRepaint
- iftrue
, the view is repainted. If false, the view is not repainted.aAdjusting
- iftrue
, the caller indicates that he will trigger another property change right after this call. This is reflected in the associated property change event.- See Also:
-
getViewOrigin
Description copied from interface:ILcdGXYView
Returns the point in AWT pixel coordinates that maps onto the world origin. Hence, the combination of world origin and view origin determines which part of the world is visible in the view. The points are considered to be 'on top of each other'.- Specified by:
getViewOrigin
in interfaceILcdGXYView
- Returns:
- the view origin expressed in AWT pixel coordinates
- See Also:
-
getRotation
public double getRotation()Description copied from interface:ILcdRotationCapableGXYView
Returns the rotation of thisILcdGXYView
. The rotation is expressed in degrees and is positive counter-clockwise. The rotation is applied in the world reference system around the worldOrigin.- Specified by:
getRotation
in interfaceILcdRotationCapable
- Specified by:
getRotation
in interfaceILcdRotationCapableGXYView
- Returns:
- the rotation of this
ILcdGXYView
. The rotation is expressed in degrees and is positive counter-clockwise. - See Also:
-
setRotation
public void setRotation(double aRotation, boolean aRepaint, boolean aAdjusting) Sets the rotation of thisILcdGXYView
, optionally repainting the view. The rotation is expressed in degrees and is positive counter-clockwise. The rotation is applied in the world reference system around the worldOrigin.- Parameters:
aRotation
- the new rotation value expressed in degrees (positive counter-clockwise)aRepaint
- if true, the view is repaintedaAdjusting
- if true, the caller indicates that he will trigger another property change right after this call. This is reflected in the associated property change event.- See Also:
-
setRotation
public void setRotation(double aRotation) Description copied from interface:ILcdRotationCapableGXYView
Sets the rotation of thisILcdGXYView
, updating the view according toILcdView.isAutoUpdate()
. The rotation is expressed in degrees and is positive counter-clockwise. The rotation is applied in the world reference system around the worldOrigin.- Specified by:
setRotation
in interfaceILcdRotationCapable
- Specified by:
setRotation
in interfaceILcdRotationCapableGXYView
- Parameters:
aRotation
- the new rotation value expressed in degrees (positive counter-clockwise).- See Also:
-
setRotation
public void setRotation(double aRotation, boolean aAdjusting) Description copied from interface:ILcdRotationCapableGXYView
Sets the rotation of thisILcdGXYView
, optionally indicating subsequent property changes. The rotation is expressed in degrees and is positive counter-clockwise. The rotation is applied in the world reference system around the worldOrigin.- Specified by:
setRotation
in interfaceILcdRotationCapable
- Specified by:
setRotation
in interfaceILcdRotationCapableGXYView
- Parameters:
aRotation
- the new rotation value expressed in degrees (positive counter-clockwise)aAdjusting
- if true, the caller indicates that he will trigger another property change right after this call. This is reflected in the associated property change event.- See Also:
-
getGXYViewXYWorldTransformation
Description copied from interface:ILcdGXYViewXYWorldTransformationProvider
Returns a validILcdGXYViewXYWorldTransformation
for anILcdGXYView
. Users of the transformation should update their reference when the view'sworld origin
,view origin
,rotation
, orscale
changes.- Specified by:
getGXYViewXYWorldTransformation
in interfaceILcdGXYViewXYWorldTransformationProvider
- Returns:
- a valid
ILcdGXYViewXYWorldTransformation
-
setXYWorldReference
Description copied from interface:ILcdGXYView
Sets the view's 2D world coordinate system, repainting the view according toisAutoUpdate
.- Specified by:
setXYWorldReference
in interfaceILcdGXYView
- Parameters:
aXYWorldReference
- the newILcdXYWorldReference
associated to this view- See Also:
-
setXYWorldReference
Description copied from interface:ILcdGXYView
Sets the view's 2D world coordinate system, optionally repainting the view.- Specified by:
setXYWorldReference
in interfaceILcdGXYView
- Parameters:
aXYWorldReference
- the newILcdXYWorldReference
associated to this viewaRepaint
- iftrue
, the view is repainted. If false, the view is not repainted.- See Also:
-
setXYWorldReference
public void setXYWorldReference(ILcdXYWorldReference aXYWorldReference, boolean aRepaint, boolean aAdjusting) Description copied from interface:ILcdGXYView
Sets the view's 2D world coordinate system, optionally indicating subsequent property changes.- Specified by:
setXYWorldReference
in interfaceILcdGXYView
- Parameters:
aXYWorldReference
- the newILcdXYWorldReference
associated to this viewaRepaint
- iftrue
, the view is repainted. If false, the view is not repainted.aAdjusting
- iftrue
, the caller indicates that he will trigger another property change right after this call. This is reflected in the associated property change event.- See Also:
-
getXYWorldReference
Description copied from interface:ILcdGXYView
Returns the view's 2D world coordinate system.- Specified by:
getXYWorldReference
in interfaceILcdGXYView
- Returns:
- the view's 2D world coordinate system
- See Also:
-
setGXYController
Makes the given
ILcdGXYController
handle the user interaction of the view. The view calls the controller'sstartInteraction
method to make the controller aware of this fact, and calls the previous controller'sterminateInteraction
method, if any.Implementations of this method can direct input events to the controller by checking, for example, if the controller implements AWT input interfaces such as
KeyListener
andMouseListener
.This view implementation recognizes the following listener interfaces, making sure to forward the relevant events:
ComponentListener
KeyListener
MouseListener
MouseMotionListener
MouseWheelListener
ILcdAWTEventListener
. If this is the case, the view dispatch all events usingILcdAWTEventListener
. For example, a mouse drag event is only delivered to the controller'shandleAWTEvent
, not itsmouseDragged
method. The listeners are automatically removed.- Specified by:
setGXYController
in interfaceILcdGXYView
- Parameters:
aGXYViewController
- the new controller of this view, ornull
if no controller is to be used- See Also:
-
getGXYController
Description copied from interface:ILcdGXYView
Returns theILcdGXYController
handling the user interaction of the view.- Specified by:
getGXYController
in interfaceILcdGXYView
- Returns:
- the current controller handling the user interaction, or null if no controller is present
- See Also:
-
getDefaultPen
Deprecated.Use the relevant layer's pen instead.Returns anILcdGXYPen
supporting editing and painting on the view.- Specified by:
getDefaultPen
in interfaceILcdGXYView
- Returns:
- the default
ILcdGXYPen
of this view - See Also:
-
setDefaultPen
Deprecated.Use the relevant layer's pen instead.Sets anILcdGXYPen
supporting editing and painting on the view.- Parameters:
aDefaultPen
- the new defaultILcdGXYPen
of this view- See Also:
-
setPaintingMode
public void setPaintingMode(int aPaintingMode) Deprecated.This implementation ignores the painting mode setting, always making sure that bodies, labels and selections are painted.Sets the type or types of layer content to display in the ILcdGXYView.- Specified by:
setPaintingMode
in interfaceILcdGXYView
- Parameters:
aPaintingMode
- a binary OR of ILcdGXYLayer.BODIES, ILcdGXYLayer.LABELS, ILcdGXYLayer.SELECTION- See Also:
-
getPaintingMode
public int getPaintingMode()Deprecated.This implementation ignores the painting mode setting, always making sure that bodies, labels and selections are painted.Gets the painting mode for this ILcdGXYView.- Specified by:
getPaintingMode
in interfaceILcdGXYView
- Returns:
- a binary OR of ILcdGXYLayer.BODIES, ILcdGXYLayer.LABELS, ILcdGXYLayer.SELECTION
- See Also:
-
invalidate
Description copied from interface:ILcdGXYView
Asks the view to invalidate its content, optionally repainting the content asynchronously. A subsequent repaint will ask (at the least) all layers to draw their bodies, labels and selection. This method is typically called when the entire view needs to be redrawn, for example, after a zoom operation or projection change.- Specified by:
invalidate
in interfaceILcdGXYView
- Specified by:
invalidate
in interfaceILcdView
- Parameters:
aRepaint
- iftrue
, the view is updated immediately, but the method will not wait for the update to finish. If false, the view is updated on the next paint or repaint method call.aSource
- class instance calling the method. For tracing purposes.aMessage
- a message associated to this method call. For tracing purposes.- See Also:
-
invalidateAndWait
Description copied from interface:ILcdGXYView
Asks the view to invalidate its content, optionally repainting the content synchronously. A subsequent repaint will ask (at the least) all layers to draw their bodies, labels and selection. This method is typically called when the entire view needs to be redrawn, for example, after a zoom operation or projection change.- Specified by:
invalidateAndWait
in interfaceILcdGXYView
- Parameters:
aRepaint
- iftrue
the ILcdGXYView will be updated immediately, and the method will block until the update is complete. If false, the view is updated on the next paint or repaint method call.aSource
- class instance calling the method. For tracing purposes.aMessage
- a message associated to this method call. For tracing purposes.- See Also:
-
invalidateRegion
Description copied from interface:ILcdGXYView
Asks the view to invalidate the content in the given AWT clip, optionally repainting the content asynchronously. A subsequent repaint will ask (at the least) all layers to draw their bodies, labels and selection in the given clip, and may reuse earlier generated imagery for the rest of the view. This method is typically called when a small portion of the view needs to be redrawn, for example, when the objects in that area have changed.- Specified by:
invalidateRegion
in interfaceILcdGXYView
- Parameters:
aClip
- the clip to invalidateaRepaint
- iftrue
, the view is updated immediately, but the method will not wait for the update to finish. If false, the view is updated on the next paint or repaint method call.aSource
- class instance calling the method. For tracing purposes.aMessage
- a message associated to this method call. For tracing purposes.- See Also:
-
invalidateRegionAndWait
public void invalidateRegionAndWait(Rectangle aClip, boolean aRepaint, Object aSource, String aMessage) Description copied from interface:ILcdGXYView
Asks the view to invalidate the content in the given AWT clip, optionally repainting the content synchronously. A subsequent repaint will ask (at the least) all layers to draw their bodies, labels and selection in the given clip, and may reuse earlier generated imagery for the rest of the view. This method is typically called when a small portion of the view needs to be redrawn, for example, when the objects in that area have changed.- Specified by:
invalidateRegionAndWait
in interfaceILcdGXYView
- Parameters:
aClip
- the clip to invalidateaRepaint
- iftrue
the ILcdGXYView will be updated immediately, and the method will block until the update is complete. If false, the view is updated on the next paint or repaint method call.aSource
- class instance calling the method. For tracing purposes.aMessage
- a message associated to this method call. For tracing purposes.- See Also:
-
invalidateGXYLayer
public void invalidateGXYLayer(ILcdGXYLayer aGXYLayer, boolean aRepaint, Object aSource, String aMessage) Description copied from interface:ILcdGXYView
Asks the view to invalidate the content of the givenILcdGXYLayer
, optionally repainting the content asynchronously. A subsequent repaint will (at the least) ask the given layer to draw its bodies, labels and selection, and may reuse earlier generated imagery for the other layers. This method is typically called when a single layer needs to be redrawn, for example, when its painter settings change.- Specified by:
invalidateGXYLayer
in interfaceILcdGXYView
- Parameters:
aGXYLayer
- the layer to invalidateaRepaint
- iftrue
, the view is updated immediately, but the method will not wait for the update to finish. If false, the view is updated on the next paint or repaint method call.aSource
- class instance calling the method. For tracing purposes.aMessage
- a message associated to this method call. For tracing purposes.
-
invalidateGXYLayerAndWait
public void invalidateGXYLayerAndWait(ILcdGXYLayer aGXYLayer, boolean aRepaint, Object aSource, String aMessage) Description copied from interface:ILcdGXYView
Asks the view to invalidate the content of the givenILcdGXYLayer
, optionally repainting the content synchronously. A subsequent repaint will (at the least) ask the given layer to draw its bodies, labels and selection, and may reuse earlier generated imagery for the other layers. This method is typically called when a single layer needs to be redrawn, for example, when its painter settings change.- Specified by:
invalidateGXYLayerAndWait
in interfaceILcdGXYView
- Parameters:
aGXYLayer
- the layer to invalidateaRepaint
- iftrue
the ILcdGXYView will be updated immediately, and the method will block until the update is complete. If false, the view is updated on the next paint or repaint method call.aSource
- class instance calling the method. For tracing purposes.aMessage
- a message associated to this method call. For tracing purposes.- See Also:
-
invalidateSelection
Description copied from interface:ILcdGXYView
Asks the ILcdGXYView to invalidate its selection, optionally repainting the content asynchronously. A subsequent repaint will ask (at the least) all layers to draw their selection, and may reuse earlier generated imagery for the bodies and labels. This method is typically called when the selection needs to be redrawn, for example, when changing the selection.- Specified by:
invalidateSelection
in interfaceILcdGXYView
- Parameters:
aRepaint
- iftrue
, the view is updated immediately, but the method will not wait for the update to finish. If false, the view is updated on the next paint or repaint method call.aSource
- class instance calling the method. For tracing purposes.aMessage
- a message associated to this method call. For tracing purposes.- See Also:
-
invalidateSelectionAndWait
Description copied from interface:ILcdGXYView
Asks the ILcdGXYView to invalidate its selection, optionally repainting the content synchronously. A subsequent repaint will ask (at the least) all layers to draw their selection, and may reuse earlier generated imagery for the bodies and labels. This method is typically called when the selection needs to be redrawn, for example, when changing the selection.- Specified by:
invalidateSelectionAndWait
in interfaceILcdGXYView
- Parameters:
aRepaint
- iftrue
the ILcdGXYView will be updated immediately, and the method will block until the update is complete. If false, the view is updated on the next paint or repaint method call.aSource
- class instance calling the method. For tracing purposes.aMessage
- a message associated to this method call. For tracing purposes.- See Also:
-
invalidateRegionSelection
public void invalidateRegionSelection(Rectangle aClip, boolean aRepaint, Object aSource, String aMessage) Description copied from interface:ILcdGXYView
Asks the ILcdGXYView to invalidate its selection in the given AWT clip, optionally repainting the content asynchronously. A subsequent repaint will ask (at the least) all layers to draw their selection in the given clip, and may reuse earlier generated imagery for the bodies, labels, and rest of the view. This method is typically called when the selection of a small portion of the view needs to be redrawn, for example, when changing the selection in that area.- Specified by:
invalidateRegionSelection
in interfaceILcdGXYView
- Parameters:
aClip
- the clip to invalidateaRepaint
- iftrue
, the view is updated immediately, but the method will not wait for the update to finish. If false, the view is updated on the next paint or repaint method call.aSource
- class instance calling the method. For tracing purposes.aMessage
- a message associated to this method call. For tracing purposes.- See Also:
-
invalidateRegionSelectionAndWait
public void invalidateRegionSelectionAndWait(Rectangle aClip, boolean aRepaint, Object aSource, String aMessage) Description copied from interface:ILcdGXYView
Asks the ILcdGXYView to invalidate its selection in the given AWT clip, optionally repainting the content synchronously. A subsequent repaint will ask (at the least) all layers to draw their selection in the given clip, and may reuse earlier generated imagery for the bodies, labels, and rest of the view. This method is typically called when the selection of a small portion of the view needs to be redrawn, for example, when changing the selection in that area.- Specified by:
invalidateRegionSelectionAndWait
in interfaceILcdGXYView
- Parameters:
aClip
- the clip to invalidateaRepaint
- iftrue
the ILcdGXYView will be updated immediately, and the method will block until the update is complete. If false, the view is updated on the next paint or repaint method call.aSource
- class instance calling the method. For tracing purposes.aMessage
- a message associated to this method call. For tracing purposes.- See Also:
-
setAutoUpdate
public void setAutoUpdate(boolean aAutoUpdate) Sets whether to update the view's representation automatically to keep it in sync with its state and the state of its models.When switching the autoUpdate property from
false
totrue
, a repaint will be triggered.- Specified by:
setAutoUpdate
in interfaceILcdView
- Parameters:
aAutoUpdate
- iftrue
, the view automatically updates its representation on reception of any event that might require an update (e.g. when its properties change, when anObject
in a model has changed, or when a model has been added/removed). If false, the view must be repainted manually.- See Also:
-
isAutoUpdate
public boolean isAutoUpdate()Description copied from interface:ILcdView
Returns whether the view's contents are automatically updated when necessary.- Specified by:
isAutoUpdate
in interfaceILcdView
- Returns:
true
if the view automatically updates its representation on reception of any event that might require an update (e.g. when its properties change, when anObject
in a model has changed, or when a model has been added/removed).false
if the view must be repainted manually.- See Also:
-
setSmartPan
public void setSmartPan(boolean aSmartPan) Sets whether to reuse existing imagery when panning.- Parameters:
aSmartPan
- if true, subsequent pan operations will only paint newly exposed areas, reusing the rest of the view content. If false, subsequent pan operations will repaint the entire view. Smart panning may provide better performance for complex painting algorithms, but could cause incorrect renderings, for example, when an painted object's visual representation is larger than its bounds.- See Also:
-
isSmartPan
public boolean isSmartPan()Indicates whether smart panning is turned on or off.- Returns:
- true if pan operations only paint newly exposed areas, reusing the rest of the view content. False if pan operations repaint the entire view.
- See Also:
-
setDrawOffScreenImageOnPaint
public void setDrawOffScreenImageOnPaint(boolean aDrawOffScreenImageOnPaint) Description copied from interface:ILcdGXYView
Sets whether the entire view's content is displayed, or only the current controller's representation. The controller can use this method to temporarily override the view's contents. The effect is visible upon the next repaint.- Specified by:
setDrawOffScreenImageOnPaint
in interfaceILcdGXYView
- Parameters:
aDrawOffScreenImageOnPaint
-true
to make the view paint itself when one of the paint methods is called. False if only the current controller is painted.- See Also:
-
isDrawOffScreenImageOnPaint
public boolean isDrawOffScreenImageOnPaint()Description copied from interface:ILcdGXYView
Returns whether the entire view's content is displayed, or only the controller's representation.- Specified by:
isDrawOffScreenImageOnPaint
in interfaceILcdGXYView
- Returns:
true
if the view paints itself when one of the paint methods is called. False if only the current controller is painted.- See Also:
-
setUpdateLabelsOnSelectionChanged
public void setUpdateLabelsOnSelectionChanged(boolean aUpdateLabelsOnSelectionChanged) Deprecated.This property is not used.Sets whether the labels are forced to be updated if a selection change occurs.- Parameters:
aUpdateLabelsOnSelectionChanged
- whether to force a label update upon selection changes- See Also:
-
isUpdateLabelsOnSelectionChanged
public boolean isUpdateLabelsOnSelectionChanged()Deprecated.This property is not taken into account anymore.Returns whether the labels are forced to be updated if a selection change occurs.- Returns:
- whether to force a label update upon selection changes
- See Also:
-
addPropertyChangeListener
Registers a listener to be notified of component and view property changes.- Specified by:
addPropertyChangeListener
in interfaceILcdPropertyChangeSource
- Overrides:
addPropertyChangeListener
in classContainer
- Parameters:
aPropertyChangeListener
- the listener to notify of changes to this view as a component, and as a view- See Also:
-
removePropertyChangeListener
Unregisters the givenPropertyChangeListener
from receiving property change events for this view.- Specified by:
removePropertyChangeListener
in interfaceILcdPropertyChangeSource
- Overrides:
removePropertyChangeListener
in classComponent
- Parameters:
aPropertyChangeListener
- the listener that should no longer be notified of property changes for the view as a component, nor as a view- See Also:
-
setGXYViewLabelPainter
Sets the label painter algorithm for thisILcdGXYView
. A view label painter handles the labels of all the view's layers. When the view label painter is null, the layers are asked to paint their labels themselves. This will override any configured view label placer.Note that it is recommended to use
setGXYViewLabelPlacer
instead. Label placers offer better decluttering behavior, more algorithm choices, support for asynchronous label placement, and easier customization.- Parameters:
aGXYViewLabelPainter
- the painter handling this view's labels, or null- See Also:
-
getGXYViewLabelPainter
Description copied from interface:ILcdGXYView
Returns the label painting algorithm for this view. A view label painter handles the labels of all the view's layers. Hence, the layers are not asked to paint their labels if the view label painter is not null. The view label painter can be used for decluttering labels across all layers. To do this, it can select the objects that need a label and delegate the actual painting to the relevant layer'sILcdGXYLabelPainter
.- Specified by:
getGXYViewLabelPainter
in interfaceILcdGXYView
- Returns:
- the painter handling this view's labels, or null
- See Also:
-
getGXYViewLabelPlacer
Description copied from interface:ILcdGXYView
Returns the label placer for this view. A view label placer handles the labels of all the view's layers. The layers are only responsible for painting their labels while the label placer declutters the labels.- Specified by:
getGXYViewLabelPlacer
in interfaceILcdGXYView
- Returns:
- the label placer handling this view's labels, or
null
. - See Also:
-
setGXYViewLabelPlacer
Description copied from interface:ILcdGXYView
This method sets anILcdGXYViewLabelPlacer
to use for global labeling.This will override any configured view label painter.
- Specified by:
setGXYViewLabelPlacer
in interfaceILcdGXYView
- Parameters:
aGXYViewLabelPlacer
- a view label placer.- See Also:
-
setGXYLayerFactory
Sets the layer factory to use when adding models to the view. If null, layers can only be added usingaddGXYLayer(com.luciad.view.gxy.ILcdGXYLayer)
.- Parameters:
newGXYLayerFactory
- the layer factory to use when adding models to the view, or null- See Also:
-
getGXYLayerFactory
Returns the layer factory used when adding models to the view. If null, layers can only be added usingaddGXYLayer(com.luciad.view.gxy.ILcdGXYLayer)
.- Returns:
- newGXYLayerFactory the layer factory that is used when adding models to the view
- See Also:
-
addStatusListener
Registers the givenILcdStatusListener
to be notified of view status events. The amount, type and order of the status events is subject to change.- Specified by:
addStatusListener
in interfaceILcdGXYView
- Specified by:
addStatusListener
in interfaceILcdStatusSource
- Parameters:
aStatusListener
- the listener that will be informed of status events- See Also:
-
removeStatusListener
Unregisters the givenILcdStatusListener
from being notified of view status events.- Specified by:
removeStatusListener
in interfaceILcdGXYView
- Specified by:
removeStatusListener
in interfaceILcdStatusSource
- Parameters:
aStatusListener
- the listener that will no longer be informed of status events- See Also:
-
modelProduced
The produced model is added to the view, provided that a layer factory supporting the model is set.- Specified by:
modelProduced
in interfaceILcdModelProducerListener
- Parameters:
aModelProducerEvent
- the event describing the model production- See Also:
-
addModelListener
Description copied from interface:ILcdGXYView
Registers the givenILcdModelListener
to be informed ofILcdModel
change events from any layer's model in this view.- Specified by:
addModelListener
in interfaceILcdGXYView
- Parameters:
aModelListener
- a listener that will be notified ofILcdModel
change events from any layer's model in this view- See Also:
-
removeModelListener
Description copied from interface:ILcdGXYView
Unregisters the givenILcdModelListener
from receivingILcdModel
change events from any layer's model in this view.- Specified by:
removeModelListener
in interfaceILcdGXYView
- Parameters:
aModelListener
- a listener that the view will no longer notify ofILcdModel
change events- See Also:
-
addLayerSelectionListener
Description copied from interface:ILcdGXYView
Registers the givenILcdSelectionListener
to be informed of selection change events from any layer in this view.- Specified by:
addLayerSelectionListener
in interfaceILcdGXYView
- Parameters:
aSelectionListener
- a listener that will be notified of selection change events from any layer in this view. The events will have the relevant layer as source.- See Also:
-
removeLayerSelectionListener
Description copied from interface:ILcdGXYView
Unregisters the givenILcdSelectionListener
from receiving selection change events from any layer in this view.- Specified by:
removeLayerSelectionListener
in interfaceILcdGXYView
- Parameters:
aSelectionListener
- a listener that the view will no longer inform of selection change events- See Also:
-
setWaitCursorOn
public void setWaitCursorOn(boolean aWaitCursorOn) Sets whether to display a wait cursor when theILcdGXYView
is repainting. The default isfalse
.- Parameters:
aWaitCursorOn
- if true, displays a wait cursor while repainting the view- See Also:
-
isWaitCursorOn
public boolean isWaitCursorOn()Returns whether a wait cursor is displayed when theILcdGXYView
is repainting.- Returns:
- true if a wait cursor is displayed while the view is repainting
- See Also:
-
isPaintInBackground
public boolean isPaintInBackground()Deprecated.This method has been deprecated in favor of the approach provided by theILcdGXYAsynchronousLayerWrapper
interface and its implementations, which is more versatile and which generally offers better thread safety.Returns whether the view is painted in a thread other than the event dispatch thread.- Specified by:
isPaintInBackground
in interfaceILcdGXYView
- Returns:
true
if background painting is enabled;false
otherwise
-
setPaintInBackground
public void setPaintInBackground(boolean aUpdateInBackground) Deprecated.This method has been deprecated in favor of the approach provided by theILcdGXYAsynchronousLayerWrapper
interface and its implementations, which is more versatile and which generally offers better thread safety.Enables or disables painting in a thread other than the event dispatch thread. If background painting is not supported by an implementation, this method throws a runtime exception.- Specified by:
setPaintInBackground
in interfaceILcdGXYView
- Parameters:
aUpdateInBackground
-true
to enable painting in the background;false
to disable it
-
getPaintExceptionHandler
Description copied from interface:ILcdGXYView
Returns a handler to report paint exceptions. The view, as well as layers and painters can use this handler if they encounter an exception during painting. Because painting may happen asynchronously, the handler may be called from different threads.- Specified by:
getPaintExceptionHandler
in interfaceILcdGXYView
- Returns:
- a handler to report paint exceptions.
-
setPaintExceptionHandler
Sets a handler to report paint exceptions. Layers and/or painters can use this handler if they encounter a problem during painting. Because painting may happen asynchronously, the handler may be called from different threads.- Specified by:
setPaintExceptionHandler
in interfaceILcdGXYView
- Parameters:
aPaintExceptionHandler
- a handler to report paint exceptions. This handler should never be null.
-
getRootNode
Description copied from interface:ILcdTreeLayered
Returns the root node of the tree structure.
- Specified by:
getRootNode
in interfaceILcdTreeLayered
- Returns:
- the root node of the tree structure
-
addAWTEventListener
This method registers aILcdAWTEventListener
. Dispatching events to the listeners is the responsibility of the implementing class. This view notifies the listeners of the following events:- Specified by:
addAWTEventListener
in interfaceILcdAWTEventSource
- Parameters:
aAWTListener
- the listener to be registered.
-
removeAWTEventListener
Description copied from interface:ILcdAWTEventSource
This method removes a registeredILcdAWTEventListener
, or does nothing if the passed listener wasn't registered.- Specified by:
removeAWTEventListener
in interfaceILcdAWTEventSource
- Parameters:
aAWTListener
- the listener to be unregistered.
-
addViewInvalidationListener
Registers anILcdViewInvalidationListener
to be informed when the view's contents are invalid. This can happen directly (e.g. by callinginvalidateGXYLayer(com.luciad.view.gxy.ILcdGXYLayer, boolean, java.lang.Object, java.lang.String)
) or indirectly (e.g. by callingpan(int, int, boolean)
)- Specified by:
addViewInvalidationListener
in interfaceILcdGXYView
- Parameters:
aInvalidationListener
- the listener to notify when the view has been invalidated- See Also:
-
removeViewInvalidationListener
Unregisters anILcdViewInvalidationListener
so that it is no longer informed of invalidation events for this view.- Specified by:
removeViewInvalidationListener
in interfaceILcdGXYView
- Parameters:
aInvalidationListener
- the listener to no longer notify when the view has been invalidated- See Also:
-
isAsynchronousAllowed
public boolean isAsynchronousAllowed()Description copied from interface:ILcdGXYView
Returns whether this view allows asynchronous operations. Painters, layers or other parts of a view should not perform asynchronous operations when this method returns
false
. If this method returnstrue
, they can decide either way.When asynchronous operations are allowed, intermediate results of time-consuming asynchronous operations are displayed in order to provide an interactive user experience. For non-interactive applications, it is useful to disable asynchronous operations, since they can lead to more unpredictable results. Examples are tests, or server side functionality like the OGC WMS protocol which paints the view and returns it as an image. In these cases, you want the view to be painted completely without having to deal with intermediate results.
- Specified by:
isAsynchronousAllowed
in interfaceILcdGXYView
- Returns:
- whether this view allows asynchronous operations.
-
setAsynchronousAllowed
public void setAsynchronousAllowed(boolean aAsynchronousAllowed) Sets if asynchronous operation are allowed for this view. See
ILcdGXYView.isAsynchronousAllowed()
for more information.This method returns
true
by default.Note: it is advised to only modify this flag at construction time, not at runtime.
- Parameters:
aAsynchronousAllowed
-true
to allow asynchronous operations.- Since:
- 2017.0
-
isAntiAliased
public boolean isAntiAliased()Description copied from interface:ILcdGXYView
Specifies if anti-aliasing is enabled or not. Anti-aliasing makes lines and text appear smoother, but slows down rendering a little bit. If this property isfalse
, it does not mean anti-aliasing is fully disabled. It only means anti-aliasing is not enabled on the view level, various layers and painters may still decide to enable anti-aliasing for what they render.- Specified by:
isAntiAliased
in interfaceILcdGXYView
- Returns:
true
if anti-aliasing is enabled,false
otherwise.
-
setAntiAliased
public void setAntiAliased(boolean aAntiAliased) Changes the anti-aliasing behavior. Please refer toILcdGXYView.isAntiAliased()
for more information.- Parameters:
aAntiAliased
-true
to enable anti-aliasing,false
to let layers and painters decide.- Since:
- 2017.0
-