ilog.views.maps.beans

Class IlvJCompass

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

ilog.views.maps.beans.IlvJCompass

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable

Direct Known Subclasses:

IlvPublicCompass

public class IlvJCompass
extends JComponent

This class defines a swing component representing a compass. The needles can indicate:

• The direction of the geographic north of a map drawn in an IlvManagerView. The geographic north is defined as the tangent to a meridian line passing at the center of the manager view that controls the compass Bean.
• The direction of the cartographic north of a map drawn in an IlvManagerView view. The cartographic north is defined as the vertical when the map is displayed without rotation.

This component is packaged as a Java Bean and is designed to be used very easily in a JAVA development environment supporting visual programming with Beans.

Since:

JViews 5.0

See Also:

Serialized Form

Nested Class Summary

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

Modifier and Type	Field and Description
static int	NEEDLE_STYLE_COMPASS The type for bicolored diamond needles.
static int	NEEDLE_STYLE_COMPASS_ROSE The type for compass-rose style.
static int	NEEDLE_STYLE_CROSS The type for cross-style needles.
static int	NEEDLE_STYLE_SIMPLE The type for simple arrow needles.

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 java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors

Constructor and Description
IlvJCompass() Creates an IlvCompass object.

Method Summary

Modifier and Type	Method and Description
protected void	drawCartographicNorth(Graphics g) Draws the elements of the compass that represent the cartographic north.
protected void	drawDecorations(Graphics g) Draws the background of the compass.
protected void	drawGeographicNorth(Graphics g) Draws the elements to represent the geographic north.
protected void	drawNeedle(int style, double angle, Color foreground, Color background, int xPosition, int yPosition, Graphics g) Draws a needle at the specified angle.
Color	getCartographicBackground() Returns the background color used to draw the needle that shows the direction of the cartographic north.
Color	getCartographicForeground() Returns the foreground color used to draw the needle representing the cartographic north.
int	getCartographicNeedleStyle() Returns the style used to draw the needle representing the cartographic north.
double	getCartographicNorth() Returns the current cartographic north.
Color	getDecorationBackground() Returns the background color used to draw the compass.
Color	getDecorationForeground() Returns the foreground color used to draw the compass.
Color	getGeographicBackground() Returns the background color used to draw the geographic needles.
Color	getGeographicForeground() Returns the foreground color used to draw the geographic needles.
int	getGeographicNeedleStyle() Returns the style used to draw the needle representing the geographic north.
double	getGeographicNorth() Returns the current geographic north.
Dimension	getMinimumSize() Returns the minimum size of the component.
Dimension	getPreferredSize() Returns the preferred size of the component.
IlvManagerView	getView() Returns the view for which the compass displays the north direction.
void	paint(Graphics g) Redraws the compass.
void	setCartographicBackground(Color color) Sets the background color for drawing cartographic needles.
void	setCartographicForeground(Color color) Sets the foreground color used to draw the needle representing the cartographic north.
void	setCartographicNeedleStyle(int style) Sets the style used to draw the needle representing the cartographic north.
void	setDecorationBackground(Color color) Sets the background color used to draw the compass.
void	setDecorationForeground(Color color) Sets the foreground color used to draw the compass.
void	setGeographicBackground(Color color) Sets the background color used to draw the geographic needles.
void	setGeographicForeground(Color color) Sets the foreground color used to draw the geographic north.
void	setGeographicNeedleStyle(int style) Sets the style used to draw the needle representing the geographic north.
void	setView(IlvManagerView view) Sets the IlvManagerView for which the compass will display the north direction.

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, 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, getNextFocusableComponent, getPopupLocation, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getUIClassID, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, paramString, print, printAll, printBorder, printChildren, printComponent, 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, setBackground, 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, updateUI

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, 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, processEvent, 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, getAccessibleContext, getBackground, 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, getPeer, 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, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, 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

Field Detail

NEEDLE_STYLE_SIMPLE

public static final int NEEDLE_STYLE_SIMPLE

The type for simple arrow needles.

See Also:

IlvCompass.setCartographicNeedleStyle(int), IlvCompass.setGeographicNeedleStyle(int), Constant Field Values

NEEDLE_STYLE_COMPASS

public static final int NEEDLE_STYLE_COMPASS

The type for bicolored diamond needles.

See Also:

IlvCompass.setCartographicNeedleStyle(int), IlvCompass.setGeographicNeedleStyle(int), Constant Field Values

NEEDLE_STYLE_CROSS

public static final int NEEDLE_STYLE_CROSS

The type for cross-style needles.

See Also:

IlvCompass.setCartographicNeedleStyle(int), IlvCompass.setGeographicNeedleStyle(int), Constant Field Values

NEEDLE_STYLE_COMPASS_ROSE

public static final int NEEDLE_STYLE_COMPASS_ROSE

The type for compass-rose style.

See Also:

IlvCompass.setCartographicNeedleStyle(int), IlvCompass.setGeographicNeedleStyle(int), Constant Field Values

Constructor Detail

IlvJCompass

public IlvJCompass()

Creates an IlvCompass object. The created instance is not active until it is associated with an IlvManagerView view.

See Also:

IlvCompass.setView(ilog.views.IlvManagerView)

Method Detail

setView

public final void setView(IlvManagerView view)

Sets the IlvManagerView for which the compass will display the north direction. To show the direction of the geographic north in the manager view, the compass must know the projection used to display the map. If the manager of the view has an IlvProjectionProperty, the compass will use the property's projection, otherwise, it will assume that the geographic north is in the same direction as the cartographic north.

Parameters:

view - The view. A null value can be used to deactivate the compass.

See Also:

IlvProjectionProperty

getView

public final IlvManagerView getView()

Returns the view for which the compass displays the north direction.

Returns:

The attached view or null if there is none.

paint

public void paint(Graphics g)

Redraws the compass.

Redraw is performed by calling the following methods:

• drawDecorations(): draws all the decorations.
• drawCartographicNorth(): draws the cartographic north.
• drawGeographicNorth(): draws the geographic north.

It is possible to subtype any of this protected method to change the way the different items are displayed.

Overrides:

paint in class JComponent

drawDecorations

protected void drawDecorations(Graphics g)

Draws the background of the compass.

drawCartographicNorth

protected void drawCartographicNorth(Graphics g)

Draws the elements of the compass that represent the cartographic north. The cartographic north is defined as the vertical when the map is displayed without rotation.

drawGeographicNorth

protected void drawGeographicNorth(Graphics g)

Draws the elements to represent the geographic north. The geographic north is defined as the tangent to a meridian line passing at the center of the manager view that controls the compass Bean.

drawNeedle

protected void drawNeedle(int style,
                          double angle,
                          Color foreground,
                          Color background,
                          int xPosition,
                          int yPosition,
                          Graphics g)

Draws a needle at the specified angle. The angle is specified in radians, positive values clockwise, with 0 at 12 o'clock.

Parameters:

style - The needle style.

angle - Orientation in radians.

foreground - Foreground color of needle.

background - Background color of needle.

xPosition - Center position of needle.

yPosition - Center position of needle.

g - The graphics for drawing.

getMinimumSize

public Dimension getMinimumSize()

Returns the minimum size of the component.

Overrides:

getMinimumSize in class JComponent

getPreferredSize

public Dimension getPreferredSize()

Returns the preferred size of the component.

Overrides:

getPreferredSize in class JComponent

getCartographicNorth

public double getCartographicNorth()

Returns the current cartographic north. The cartographic north is computed using the transformer of the current view. The cartographic north is expressed in radians, counter-clockwise, with 0 at 12 o'clock.

getGeographicNorth

public double getGeographicNorth()

Returns the current geographic north. The geographic north is computed using the current transformer and current projection of the view. The geographic north is expressed in radians, counter-clockwise, relative to the cartographic north.

setDecorationForeground

public void setDecorationForeground(Color color)

Sets the foreground color used to draw the compass.

getDecorationForeground

public Color getDecorationForeground()

Returns the foreground color used to draw the compass.

setDecorationBackground

public void setDecorationBackground(Color color)

Sets the background color used to draw the compass.

getDecorationBackground

public Color getDecorationBackground()

Returns the background color used to draw the compass.

setCartographicForeground

public void setCartographicForeground(Color color)

Sets the foreground color used to draw the needle representing the cartographic north.

getCartographicForeground

public Color getCartographicForeground()

Returns the foreground color used to draw the needle representing the cartographic north.

setCartographicBackground

public void setCartographicBackground(Color color)

Sets the background color for drawing cartographic needles. Background color is used as an alternate color for multicolored needles.

getCartographicBackground

public Color getCartographicBackground()

Returns the background color used to draw the needle that shows the direction of the cartographic north.

setGeographicForeground

public void setGeographicForeground(Color color)

Sets the foreground color used to draw the geographic north.

getGeographicForeground

public Color getGeographicForeground()

Returns the foreground color used to draw the geographic needles.

setGeographicBackground

public void setGeographicBackground(Color color)

Sets the background color used to draw the geographic needles. Background color is used as an alternate color for multicolored needles.

getGeographicBackground

public Color getGeographicBackground()

Returns the background color used to draw the geographic needles.

setCartographicNeedleStyle

public final void setCartographicNeedleStyle(int style)

Sets the style used to draw the needle representing the cartographic north.

See Also:

IlvCompass.NEEDLE_STYLE_SIMPLE, IlvCompass.NEEDLE_STYLE_COMPASS, IlvCompass.NEEDLE_STYLE_CROSS, IlvCompass.NEEDLE_STYLE_COMPASS_ROSE

getCartographicNeedleStyle

public final int getCartographicNeedleStyle()

Returns the style used to draw the needle representing the cartographic north.

See Also:

IlvCompass.NEEDLE_STYLE_SIMPLE, IlvCompass.NEEDLE_STYLE_COMPASS, IlvCompass.NEEDLE_STYLE_CROSS, IlvCompass.NEEDLE_STYLE_COMPASS_ROSE

setGeographicNeedleStyle

public final void setGeographicNeedleStyle(int style)

Sets the style used to draw the needle representing the geographic north.

See Also:

IlvCompass.NEEDLE_STYLE_SIMPLE, IlvCompass.NEEDLE_STYLE_COMPASS, IlvCompass.NEEDLE_STYLE_CROSS, IlvCompass.NEEDLE_STYLE_COMPASS_ROSE

getGeographicNeedleStyle

public final int getGeographicNeedleStyle()

Returns the style used to draw the needle representing the geographic north.

See Also:

IlvCompass.NEEDLE_STYLE_SIMPLE, IlvCompass.NEEDLE_STYLE_COMPASS, IlvCompass.NEEDLE_STYLE_CROSS, IlvCompass.NEEDLE_STYLE_COMPASS_ROSE