ilog.views.maps

Class IlvMagnifySymbolsInteractor

java.lang.Object

ilog.views.IlvManagerViewInteractor

ilog.views.interactor.IlvMagnifyInteractor

ilog.views.maps.IlvMagnifySymbolsInteractor

All Implemented Interfaces:

IlvPermanentInteractorInterface, Serializable

public class IlvMagnifySymbolsInteractor
extends IlvMagnifyInteractor

An interactor designed to unclutter the symbols displayed on a part of the view by dragging the mouse over it. This interactor acts as a magnifying glass that displaces all the graphics related to the current SDM model displayed in the view when it is moved over it.
You can set the interactor on the view using, for example, the following code:

 
 IlvMagnifySymbolsInteractor magInteractor=new IlvMagnifySymbolsInteractor();
 view.setInteractor(magInteractor); 

When a symbol needs to be displaced because it overlaps with another one, the interactor draws a connecting line and places a marker at the true position. You can change the default markers and lines using code such as the following:

 
  IlvArrowLine lineTemplate = new IlvArrowLine();
  lineTemplate.setForeground(Color.red);
  lineTemplate.setLineWidth(2);
  lineTemplate.setArrowPosition(1);

or, to set up a specific marker:

 
  IlvMarker markerTemplate = new IlvMarker();   
  markerTemplate.setType(IlvMarker.IlvMarkerFilledCircle);
  markerTemplate.setForeground(Color.orange);
  markerTemplate.setSize(2);
  magInteractor.setTargetMarkerTemplate(markerTemplate);

The displacement is done through an IlvAnnealingLabelLayout that you can configure. For example, if you want all the symbols to move, even when not necessary, you can call:

 
  magInteractor.getAnnealingLabelLayout().setLabelMovementPolicy(null);

Since:

JViews 8.0

See Also:

Serialized Form

Field Summary

Fields inherited from class ilog.views.interactor.IlvMagnifyInteractor

CIRCULAR, LENS, RECTANGULAR

Constructor Summary

Constructors

Constructor and Description
IlvMagnifySymbolsInteractor() Creates a new IlvMagnifySymbolsInteractor.

Method Summary

Modifier and Type	Method and Description
protected void	drawMagnifier(Graphics g) Draws the magnifier.
IlvAnnealingLabelLayout	getAnnealingLabelLayout() Returns the layout used to remove the symbol clutter.
IlvLine	getConnectingLineTemplate() Returns the graphical object used to draw the connecting line.
double	getSymbolFactor() Returns the scale factor to be used to display symbols inside the interactor view.
IlvMarker	getTargetMarkerTemplate() Returns the graphical object used to draw the target point.
void	setAnnealingLabelLayout(IlvAnnealingLabelLayout annealingLabelLayout) Sets a different annealing label layout to remove the symbol clutter.
void	setConnectingLineTemplate(IlvLine connectingLineTemplate) Sets a customized line for drawing the connecting line.
void	setSymbolFactor(double symbolFactor) Sets the scale factor to be used to display symbols inside the interactor view.
void	setTargetMarkerTemplate(IlvMarker targetMarkerTemplate) Sets a customized marker for drawing the target point.
protected void	update() Called by IlvMagnifyInteractor.handleExpose(Graphics) when it becomes necessary to update the magnified view.

Methods inherited from class ilog.views.interactor.IlvMagnifyInteractor

attach, detach, getDrawingRect, getFactor, getFrameColor, getMode, getSize, handleExpose, isPermanent, processMouseEvent, processMouseMotionEvent, setFactor, setFrameColor, setMode, setPermanent, setSize

Methods inherited from class ilog.views.IlvManagerViewInteractor

addFocusListener, addKeyListener, addMouseListener, addMouseMotionListener, allowEnsureVisible, allowEnsureVisible, disableEvents, drawGhost, drawGhost, enableEvents, ensureVisible, ensureVisible, getManager, getManagerView, getTransformer, isXORGhost, processEvent, processFocusEvent, processKeyEvent, removeFocusListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, setXORGhost

Methods inherited from class java.lang.Object

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

Constructor Detail

IlvMagnifySymbolsInteractor

public IlvMagnifySymbolsInteractor()

Creates a new IlvMagnifySymbolsInteractor. By default, the zoom factor is 1, the symbol factor 0.8, and the size 256 pixels.

Method Detail

getSymbolFactor

public double getSymbolFactor()

Returns the scale factor to be used to display symbols inside the interactor view.

Returns:

Returns the scale factor to be used to display symbols inside the interactor view.

setSymbolFactor

public void setSymbolFactor(double symbolFactor)

Sets the scale factor to be used to display symbols inside the interactor view. A value of 1 shows symbols with the same size as the outside view. A value of 0.75 shows smaller symbols.

Parameters:

symbolFactor - The scale factor.

update

protected void update()

Called by IlvMagnifyInteractor.handleExpose(Graphics) when it becomes necessary to update the magnified view.

Overrides:

update in class IlvMagnifyInteractor

See Also:

IlvMagnifyInteractor.update()

drawMagnifier

protected void drawMagnifier(Graphics g)

Draws the magnifier. If you redefine this method to add additional drawings, you must also redefine the IlvMagnifyInteractor.getDrawingRect() method to return a rectangle containing the additional drawings.

Overrides:

drawMagnifier in class IlvMagnifyInteractor

Parameters:

g - The view graphics.

See Also:

IlvMagnifyInteractor.drawMagnifier(java.awt.Graphics)

getConnectingLineTemplate

public IlvLine getConnectingLineTemplate()

Returns the graphical object used to draw the connecting line.

Returns:

Returns the graphical object used to draw the connecting line.

setConnectingLineTemplate

public void setConnectingLineTemplate(IlvLine connectingLineTemplate)

Sets a customized line for drawing the connecting line.

Parameters:

connectingLineTemplate - The line template to use.

getTargetMarkerTemplate

public IlvMarker getTargetMarkerTemplate()

Returns the graphical object used to draw the target point.

Returns:

Returns the graphical object used to draw the target point.

setTargetMarkerTemplate

public void setTargetMarkerTemplate(IlvMarker targetMarkerTemplate)

Sets a customized marker for drawing the target point.

Parameters:

targetMarkerTemplate - The marker to use.

getAnnealingLabelLayout

public IlvAnnealingLabelLayout getAnnealingLabelLayout()

Returns the layout used to remove the symbol clutter.

Returns:

The annealingLabelLayout.

setAnnealingLabelLayout

public void setAnnealingLabelLayout(IlvAnnealingLabelLayout annealingLabelLayout)

Sets a different annealing label layout to remove the symbol clutter.

Parameters:

annealingLabelLayout - The layout to set.