ilog.views.sdm.renderer

Class IlvDrillDownRenderer

java.lang.Object

ilog.views.sdm.renderer.IlvSDMRenderer

ilog.views.sdm.renderer.IlvFilterSDMRenderer

ilog.views.sdm.renderer.IlvDrillDownRenderer

All Implemented Interfaces:

Serializable

public class IlvDrillDownRenderer
extends IlvFilterSDMRenderer

The class IlvDrillDownRenderer is a filtering renderer that makes more and more objects appear as the user zooms in the view. To do this, the renderer dispatches the objects in different manager layers with visibility filters.

The drill-down renderer looks at the property "DrillDownZoom" for each object. All the objects with the same drill-down zoom are placed in a manager layer that will be visible only when the view's zoom level is greater than the drill-down zoom. A drill-down zoom means that the object is always visible.

For example, assume that the links of the data model have a property "distance", and that the style sheet contains the following rules:

 SDM {
   DrillDown : "true";
 }
 link[distance>="1000"] {
        DrillDownZoom : "0";
 }
 link[distance<"1000"] {
        DrillDownZoom : "2";
 }
 link[distance<"100"] {
        DrillDownZoom : "4";
 }
 link[distance<"10"] {
        DrillDownZoom : "8";
 }
 

• Links with a distance greater than 1000 have a drill-down zoom of 0; they are always visible.
• Links that have a distance less than 1000 and greater than 100 have a drill-down zoom of 2; they will become visible only when the view is zoomed in by a factor of 2.
• Links that have a distance less than 100 and greater than 10 have a drill-down zoom of 4; they will become visible only when the view is zoomed in by a factor of 4.
• Links that have a distance less than 10 have a drill-down zoom of 8; they will become visible only when the view is zoomed in by a factor of 8.

Since:

JViews 4.0

See Also:

Serialized Form

Field Summary

Fields inherited from class ilog.views.sdm.renderer.IlvFilterSDMRenderer

_renderer

Fields inherited from class ilog.views.sdm.renderer.IlvSDMRenderer

PSEUDOCLASS_PREFIX

Constructor Summary

Constructors

Constructor and Description
IlvDrillDownRenderer() Creates a new drill-down renderer with a null filtered renderer.
IlvDrillDownRenderer(IlvSDMRenderer renderer) Creates a new drill-down renderer for a specified filtered renderer.

Method Summary

Modifier and Type	Method and Description
void	addLinkGraphic(IlvSDMEngine engine, Object link, IlvGraphic graphic, boolean redraw) Adds the graphic link in a layer that depends on the value of the rendering property DrillDownZoom.
void	addNodeGraphic(IlvSDMEngine engine, Object node, IlvGraphic graphic, boolean redraw) Adds the graphic node in a layer that depends on the value of the rendering property DrillDownZoom.
boolean	isShowingIndicator() Returns the flag that specifies whether an icon should be displayed in the top-left corner of the view to alert the user that some objects are not visible at the current zoom level.
void	removeAll(IlvSDMEngine engine) Removes the layers added during the previous rendering phase.
void	renderingDone(IlvSDMEngine engine) Adds the drill-down indicator icon, if requested.
void	setShowingIndicator(boolean showing) Sets the flag that specifies whether an icon should be displayed in the top-left corner of the view to alert the user that some objects are not visible at the current zoom level.

Methods inherited from class ilog.views.sdm.renderer.IlvFilterSDMRenderer

computeBBox, createLinkGraphic, createNodeGraphic, customize, getEncapsulatedGraphic, getFilteredRenderer, getGraphicProperty, getLinkConnectionRectangle, linkGraphicAdded, moveResizeNodeGraphic, nodeGraphicAdded, nodeGraphicBBoxChanged, prepareRendering, processServerAction, propertiesChanged, removeLinkGraphic, removeNodeGraphic, setFilteredRenderer, updateObjectProperties

Methods inherited from class ilog.views.sdm.renderer.IlvSDMRenderer

addViewListeners, callMoveResizeNodeGraphic, convert, convert, getAlias, getAuxiliaryBean, getAuxiliaryBeans, getEngine, getLinkConnectionRectangle, getLocation, getParameter, needsViewListeners, propertyChanged, removeViewListeners, setAlias, setEngine, setLayerName, setParameter

Methods inherited from class java.lang.Object

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

Constructor Detail

IlvDrillDownRenderer

public IlvDrillDownRenderer(IlvSDMRenderer renderer)

Creates a new drill-down renderer for a specified filtered renderer.

Parameters:

renderer - The filtered renderer.

IlvDrillDownRenderer

public IlvDrillDownRenderer()

Creates a new drill-down renderer with a null filtered renderer.

Method Detail

setShowingIndicator

public void setShowingIndicator(boolean showing)

Sets the flag that specifies whether an icon should be displayed in the top-left corner of the view to alert the user that some objects are not visible at the current zoom level. The indicator disappears when the user zooms in enough to make all objects visible.

Note: Enabling the indicator icon will slow down the panning of the view because the icon must stay at a fixed position, which is not compatible with the "optimized translation" mode of the manager view.

Parameters:

showing - If true, an icon will appear in the top-left corner of the view when some objects are not visible at the current zoom level. The icon will disappear when the view is zoomed in enough for all the objects to be visible.

isShowingIndicator

public boolean isShowingIndicator()

Returns the flag that specifies whether an icon should be displayed in the top-left corner of the view to alert the user that some objects are not visible at the current zoom level.

addNodeGraphic

public void addNodeGraphic(IlvSDMEngine engine,
                           Object node,
                           IlvGraphic graphic,
                           boolean redraw)

Adds the graphic node in a layer that depends on the value of the rendering property DrillDownZoom. Each layer has a visibility filter that makes it visible only when the view's transformer has a zoom level greater than the drill-down zoom. graphic object must be redrawn.

Overrides:

addNodeGraphic in class IlvFilterSDMRenderer

Parameters:

engine - The SDM engine associated with the grapher in which the graphic object will be added.

node - The node that is being translated into an IlvGraphic.

graphic - The graphic object returned by createNodeGraphic.

redraw - If true, the region covered by the new graphic object must be redrawn.

addLinkGraphic

public void addLinkGraphic(IlvSDMEngine engine,
                           Object link,
                           IlvGraphic graphic,
                           boolean redraw)

Adds the graphic link in a layer that depends on the value of the rendering property DrillDownZoom. Each layer has a visibility filter that makes it visible only when the view's transformer has a zoom level greater than the drill-down zoom.

Overrides:

addLinkGraphic in class IlvFilterSDMRenderer

Parameters:

engine - The SDM engine associated with the grapher in which the graphic object will be added.

link - The link that is being translated into an IlvGraphic.

graphic - The graphic object returned by createLinkGraphic.

redraw - If true, the region covered by the new graphic object must be redrawn.

removeAll

public void removeAll(IlvSDMEngine engine)

Removes the layers added during the previous rendering phase.

Overrides:

removeAll in class IlvFilterSDMRenderer

Parameters:

engine - The SDM engine.

renderingDone

public void renderingDone(IlvSDMEngine engine)

Adds the drill-down indicator icon, if requested.

Overrides:

renderingDone in class IlvFilterSDMRenderer

Parameters:

engine - The SDM engine.