ilog.views.sdm

Class IlvSDMEngine

java.lang.Object

ilog.views.sdm.IlvSDMEngine

All Implemented Interfaces:

ilog.views.util.cssbeans.IlvCSSCompatible, IlvStylable, Serializable

public class IlvSDMEngine
extends Object
implements IlvStylable, ilog.views.util.cssbeans.IlvCSSCompatible, Serializable

IlvSDMEngine is the main class in the Stylable Data Mapper package. An SDM engine controls the process of rendering a set of application objects as a graph in a Perforce JViews grapher.

An SDM engine has two input sources: a data model, and a style sheet. The engine matches the data against the style sheet to produce a graphic view of the data.

Data Model

The SDM is based on the Model/View (or MVC) architecture. Data is sent to the SDM engine through an instance of a class that implements IlvSDMModel. The SDM data model is similar to the JFC/Swing Table, Tree, or List models. It is the interface between the SDM engine and the application data. It contains the methods that let the engine fetch the data objects and retrieve their properties. The data model also allows the application to notify the engine of changes in the data set.

The SDM package contains a predefined implementation of the data model: the class IlvDefaultSDMModel. This simple data model stores data objects in memory. The objects are instances of the classes IlvDefaultSDMNode and IlvDefaultSDMLink.

Instead of using the predefined model, you can implement the IlvSDMModel interface directly to wrap existing data of your application. For this, you can use IlvBasicSDMModel as a base class.

The SDM engine provides support for reading and writing the contents of a data model in XML, through the methods setXMLFile(java.lang.String) and writeXML(String).

Style Sheets

The SDM engine reads information from a style sheet (or a set of cascading style sheets) to determine how it must represent the objects of the data model.

Style sheets conform to the CSS syntax (which is a recommendation of the W3C). The semantics, though, are slightly different from the original use of CSS: instead of styling web documents in a browser, the SDM engine styles a data model in a Perforce JViews grapher.

A style sheet contains a set of style rules. Each rule is formed by a left-hand part (the "selector"), and a right-hand part (the "declarations"). The selector specifies which objects match the rule. The declarations specify the properties of the graphic objects that will represent the matching data objects. Here is a simple example:

   node.activity {
     class : "ilog.views.sdm.graphic.IlvGeneralNode";
     shapeType : "RoundRectangle";
     foreground : "black";
     background : "blue";
   }
 

Node.activity is the selector, the rest of the rule forms the declarations.

Style Sheet Selectors

The selector allows you to filter objects according to the following attributes:

• The object type, which is either "node" if the object is a node, or "link" if the object is a link between two nodes.
• The object tag, which is the symbolic type defined by the data model, and returned by the method getTag.
• The properties of the object, as defined by the data model.
• The object identifier, which lets you customize a particular object of the model.
• The object pseudo-classes, which are similar to style classes, but which are defined on the "rendering" side instead of coming from the data model. Pseudo-classes are a way to modify temporarily the look of an object, for example to show that the object is selected or marked for an editing operation. Pseudo-classes can be set directly by the user, or internally by the SDM engine.
• The object style classes, which are additional types that can optionally be defined by the model.

Examples of selectors:

node	Matches all the nodes.
node.activity	Matches all the nodes whose tag is "activity".
node.activity.style1	Matches all the nodes whose tag is "activity" and whose style class is "style1".
node:selected	Matches all the nodes whose pseudo-class is "selected".
node.activity[implementation="manual"]	Matches all the nodes whose tag is "activity" and whose implementation property has the value "manual".

Style Sheet Declarations

The declaration part of a rule is a set of assignments of the form property : value;. These assignments define a Perforce JViews graphic object that will represent the data object matched by the rule's selector. The class of the graphic object must be specified by the special property class. The other properties specify either the graphic object properties (in the sense of JavaBean properties), or special properties that are interpreted by the SDM engine.

Example:

 node.activity {
      class : "ilog.views.sdm.graphic.IlvGeneralNode";
      icon : "activity.gif";
      label : "@name";
      layer : 10;
 }
 

These declarations tell the SDM engine that the activity nodes must be represented by graphic objects of the class IlvGeneralNode. When the graphic object is created, the engine will set its icon and label properties to the specified values. The "@name" notation means that the label of the node must be set to the value of the name property of the data object. The layer property is a special property, which is interpreted by the SDM engine, and which specifies the manager layer in which the graphic object will be added.

Options

In addition to the rules that define the translation of data to graphics on a per-object basis, the style sheet can also contain rules that define rendering options to apply to all the objects.

These options are defined by an SDM rule, and possibly by additional option rules.

The SDM rule must have the selector SDM (or #SDM). It defines the options for the SDM engine. The declarations of the SDM rule can either affect the properties of the SDM engine (in the sense of JavaBean properties), or they can be special properties interpreted internally by the SDM engine.

Example:

 SDM {
      baseURL : "file:/home/user/mydata/";
      Map : "usa.ivl"
      LinkLayout : true;
 }
 

In this example, the baseURL declaration calls the method setBaseURL of the SDM engine. On the other hand, the Map and LinkLayout declarations are interpreted internally by the SDM engine. The Map option tells the SDM engine that it must display a background map, and that the objects must be placed on the map according to their latitude and longitude properties. The LinkLayout options tells the engine to apply an automatic layout algorithm to reshape the links orthogonally and to avoid crossings.

Some options can be further customized through additional rules. For example, the LinkLayout option has additional parameters that can be configured as follows:

 LinkLayout {
      linkOffset : 5;
 }
 

The SDM engine provides many other predefined rendering options. Here is a list of the available options:

Animation	Shows an animation during the rendering process.
Coloring	Allocates colors to objects automatically.
Decoration	Adds decoration objects to the grapher.
ExpandCollapse	Allows you to expand and collapse subgraphs.
HalfZooming	Prevents the nodes from zooming past a given level.
InfoBalloon	Opens an info balloon showing some property values of the objects.
Legend	Displays a legend for the graphic objects.
DrillDown	Shows more and more objects when zooming in.
Map	Displays a background map and places objects in a geo-referenced way.
GraphLayout	Applies a layout algorithm to the nodes.
LinkLayout	Applies a layout algorithm to the links.
LabelLayout	Minimizes the overlap of labels attached to nodes and links.
StyleSheet	Allows you to customize the style sheet engine.

Each rendering option is managed by an instance of a subclass of IlvSDMRenderer. The renderers attached to an SDM engine form a chained list. It is possible to create and configure the renderers by code (see the method setRenderer, but the preferred way is by setting options in the style sheet as explained above.

Read the user documentation for a more detailed description of each renderer and its parameters.

Complete Example

Here is an example XML data file, a style sheet, and the code needed to setup the SDM engine:

The XML data file simply contains two nodes of tag "activity" connected by a link of tag "transition":

 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE SDM>
 <SDM>
   <activity id="1">
     <property name="label">Activity 1</property>
     <property name="x">291.125</property>
     <property name="y">56.375</property>
   </activity>
   <activity id="2">
     <property name="label">Activity 2</property>
     <property name="x">195.33594</property>
     <property name="y">87.375</property>
   </acivity>
   <transition id="3" islink="true" from="1" to="2" />
 </SDM>
 

Here is an example of a style sheet file:

 SDM {
      LinkLayout : true;
 }

 node.activity {
        class : "ilog.views.sdm.graphic.IlvGeneralNode";
        shapeType : RoundRectangle;
        icon : "activity.gif";
        label : "@label";
      fillColor1 : brown;
 }

 link.transition {
        class : "ilog.views.sdm.graphic.IlvGeneralLink";
        mode : "MODE_GRADIENT";
        foreground : orange;
        oriented : true;
 }

 node:selected {
        fillColor1 : red;
 }

 link:selected {
        foreground : red;
        mode : "MODE_NEON";
 }
 

Finally, here is the code needed to set up the engine:

   // Create the SDM engine:
   IlvSDMEngine engine = new IlvSDMEngine();
   // Set up a manager view:
   IlvManagerView view = new IlvManagerView(engine.getGrapher());
   // ... create GUI around the manager view...
   // Set style sheet and XML data file:
   try {
     engine.setStyleSheets(new String[] { "file:example.css" });
     engine.setXMLFile("file:example.xml");
   } catch(IOException ex){
     ex.printStackTrace();
   } catch(IlvSDMException ex){
     ex.printStackTrace();
   }
 

To make things even simpler, rather than creating an IlvSDMEngine, you can create an IlvSDMView that will create an instance of IlvSDMEngine internally.

Since:

JViews 4.0

See Also:

IlvSDMModel, IlvSDMView, IlvGeneralNode, IlvGeneralLink, Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static int	ALWAYS Used as a parameter to setRenderingDoneMode(int), specifies that the IlvSDMRenderer.renderingDone(ilog.views.sdm.IlvSDMEngine) method must always be called on selection or property changes.
static String	HIGH_CONTRAST The pseudoclass "high-contrast" that indicates a high contrast theme.
static String	HIGH_DETAIL_LEVEL The pseudoclass "high-detail-level" that indicates a high level of detail.
static int	IF_BBOX_CHANGED Used as a parameter to setRenderingDoneMode(int), specifies that the IlvSDMRenderer.renderingDone(ilog.views.sdm.IlvSDMEngine) method must called on selection or property changes only when the bounding box of a graphic object has changed.
static String	LOW_DETAIL_LEVEL The pseudoclass "low-detail-level" that indicates a low level of detail.
static String	MEDIUM_DETAIL_LEVEL The pseudoclass "medium-detail-level" that indicates a medium level of detail.
static int	NEVER Used as a parameter to setRenderingDoneMode(int), specifies that the IlvSDMRenderer.renderingDone(ilog.views.sdm.IlvSDMEngine) method must never be called on selection or property changes.
static String	NORMAL_CONTRAST The pseudoclass "normal-contrast" that indicates a normal contrast theme.

Fields inherited from interface ilog.views.util.styling.IlvStylable

APPLIED_RULE_MASK, BAD_CLASS_MASK, BAD_PROP_MASK, BAD_PROP_WITH_STACK_MASK, CREATED_MASK, DECL_MASK, DECL_VALUE_MASK, FAILED_CONVERSIONS_MASK, TIME_REPORT_MASK, WARNING_PROP_MASK

Constructor Summary

Constructors

Constructor and Description
IlvSDMEngine() Creates an SDM engine for a new grapher with a default data model, which is an instance of the class IlvDefaultSDMModel.
IlvSDMEngine(IlvGrapher grapher, IlvSDMModel model) Creates an SDM engine with a specified grapher and data model.

Method Summary

Modifier and Type	Method and Description
void	addPropertyChangeListener(PropertyChangeListener listener) Adds a listener on property modification.
void	addPseudoClass(Object object, String pseudoClass) Adds a pseudo-class to the specified data object.
void	addSDMEngineDataLoadingListener(SDMEngineDataLoadingListener listener) Adds an SDMEngineDataLoadingListener to this SDM engine.
void	addSDMEngineSelectionListener(SDMEngineSelectionListener listener) Adds an SDMEngineSelectionListener to this SDM engine.
void	addSDMEngineStyleSheetListener(SDMEngineStyleSheetListener listener) Adds an SDMEngineStyleSheetListener to this SDM engine.
Object	applyStyle(Object bean, Object nodeOrLink, String[] pseudoClasses) Applies the current style sheet(s) of this SDM engine to a bean.
Object	applyStyle(Object bean, String ruleName, String[] pseudoClasses) Applies the current style sheet(s) of this SDM engine to a bean.
boolean	canPaste() Returns true if data has been copied to the clipboard through the cut() or copy() methods.
void	clearAdjusting() Stops an editing sequence and prevents JViews Diagrammer from performing any computation regarding the changes.
void	copy() Copies the selected objects of the data model to the system clipboard.
void	customizeAllObjects() Recustomizes all the graphic objects corresponding to the data objects returned by the SDM model.
void	cut() Copies the selected objects of the data model to the system clipboard, and removes them from the data model.
void	delete() Removes the selected objects.
void	deselectAllObjects() Deselects all the graphic objects that represent objects of the data model.
void	duplicate() Duplicates the selected data objects.
Enumeration<?>	getAllObjects() Returns an enumeration of all the objects of the model (including all descendants of the top-level objects) in pre-order (that is, a parent is returned before its children).
int	getBaseTextDirection() Return default base text direction of engine.
String	getBaseURL() Returns the base URL used by this SDM engine to find its resources, such as the map files or the bitmap files.
ComponentOrientation	getComponentOrientation(IlvSDMModel model, Object obj, ComponentOrientation fallBackComponentOrientation) Returns the component orientation for a model object, from the subgrapher that will contain the graphic object or from the context.
String	getContrastAccessibilityTheme() Returns the pseudoclass that represents the current contrast theme.
ilog.views.util.css.IlvCSSDebugHandler	getCSSDebugHandler() Returns the current css debugger.
Object	getCSSInternal() This method is for internal use; you should not call it directly.
String	getDetailLevel() Returns the pseudoclass that represents the current level of detail.
IlvGrapher	getGrapher() Returns the grapher associated with this SDM engine.
ilog.views.sdm.internal.IlvGrapherCleanerHandler	getGrapherCleanerHandler() Returns the current grapher cleaner handler.
IlvGraphic	getGraphic(Object object, boolean createIfNeeded) Returns the JViews graphic object associated with an application object.
String	getID(Object obj) Returns the identifier of a data object.
IlvLabelLayoutRenderer	getLabelLayoutRenderer() Returns the graph layout renderer that is responsible for the layout of labels.
IlvGraphLayoutRenderer	getLinkLayoutRenderer() Returns the graph layout renderer that is responsible for the layout of links.
IlvSDMModel	getModel() Returns the current data model.
IlvGraphLayoutRenderer	getNodeLayoutRenderer() Returns the graph layout renderer that is responsible for the layout of nodes.
Object	getObject(IlvGraphic graphic) Returns the data object (that is, the object returned by the SDM model) associated with a graphic object, or null if the specified graphic object does not represent an object of the data model.
Object	getObject(IlvPoint p, IlvManagerView view) Returns the data object associated with the graphic object at a specified point in a manager view.
Object	getObject(IlvPoint p, IlvManagerView view, boolean traverse) Returns the data object associated with the graphic object at a specified point in a manager view.
Object	getObject(String id) Looks up the data model for an object with the specified identifier.
Enumeration<?>	getObjectsWithPseudoClass(String pseudoClass) Returns all the objects of the model that have a given pseudo-class.
Object	getParent(IlvManagerView view, double x, double y, boolean managerCoordinates) Returns the parent object located at the specified coordinates in the view.
String[]	getPseudoClasses() Returns the pseudoclasses associated with all data objects.
String[]	getPseudoClasses(Object object) Returns the pseudo-classes associated with the specified data object.
IlvManagerView	getReferenceView() Returns the reference view of this SDM engine.
double	getReferenceZoom() Returns the reference zoom factor.
IlvSDMRenderer	getRenderer() Returns the root of the renderer chain.
int	getRenderingDoneMode() Returns the flag that determines the way the IlvSDMRenderer.renderingDone(ilog.views.sdm.IlvSDMEngine) method is called on selection or property changes.
static IlvSDMEngine	getSDMEngine(IlvGrapher grapher) Returns the SDM engine associated with the specified grapher, or null if no SDM engine is associated with the specified grapher.
static IlvSDMEngine	getSDMEngine(IlvGraphic graphic) Returns the SDM engine associated with the grapher in which the specified graphic object is contained, or null if the graphic is not contained in a grapher or if the grapher has no associated SDM engine.
Enumeration<?>	getSelectedObjects() Returns an enumeration containing the data objects represented by the graphic objects currently selected in the grapher.
String	getSelectionPseudoClass() Returns the pseudo-class used to style selected objects.
String	getStringFromClipboard() For internal use only.
int	getStyleSheetDebugMask() Returns the debug level of the current configuration style sheet.
String[]	getStyleSheets() Returns the style sheet(s) used by this SDM engine to map the data model to Perforce JViews graphic objects.
String	getStyleSheets(int index) Returns one of the style sheets used by this SDM engine to map the data model to Perforce JViews graphic objects.
com.ibm.icu.util.ULocale	getULocale(IlvSDMModel model, Object obj, com.ibm.icu.util.ULocale fallBackLocale) Returns the locale for a model object, from the subgrapher that will contain the graphic object or from the context.
IlvXMLConnector	getXMLConnector() Returns the IlvXMLConnector object used to read and write the contents of the SDM data model from/to XML files.
String	getXMLFile() Returns the URL of the XML file currently being displayed by the SDM engine.
String	getXMLProcessingInstructionProperty(String property) Returns a property to be saved in the XML processing instruction for SDM.
void	group(Object parent) Groups the selected objects.
boolean	hasPseudoClass(Object object, String pseudoClass) Returns true if and only if the specified object has the specified pseudo-class.
boolean	isAdjusting() Returns true if and only if the SDM engine is currently in an editing sequence.
boolean	isCompiledSymbolAutoLoad() Returns true if compiled symbols are loaded if available.
boolean	isDropToGroupEnabled() Returns true if dropping or duplicating a node in an existing subgraph will make the node a child of this subgraph, or false otherwise.
boolean	isEmptySubgraphAllowed() Returns true if empty subgraphs are allowed.
boolean	isHighlightingSelection() Returns true if "selection by highlighting" is enabled, or false if the usual selection handles are used to show selected objects.
boolean	isJavaColorNamesFirst() Returns true if Java color names are to be used instead of SVG color names when there is a conflict.
boolean	isLabelLayoutEnabled() Returns the enabled state of the automatic layout algorithm for labels.
boolean	isLayoutRunning() Returns the flag indicating that a layout algorithm is running.
boolean	isLinkLayoutEnabled() Returns the enabled state of the automatic layout algorithm for links.
boolean	isLinkLayoutEnabledWhileMoving() Returns true if the automatic link layout is enabled while moving a node.
boolean	isLinkNodeVisibilityCoupled() Returns true if the links are visible (if and only if origin and destination nodes are visible).
boolean	isManagerListenerPlugged() Returns true if SDM reacts to manager content changes.
boolean	isMetadataEnabled() Returns true if metadata are enabled.
boolean	isModelListenerPlugged() Returns true if SDM reacts to model changes.
boolean	isNodeLayoutEnabled() Returns the enabled state of the automatic layout algorithm for nodes.
boolean	isOpaqueMove() Returns the Opaque Move mode of the select interactor attached to the views of this SDM engine.
boolean	isResizingAllowed() Returns true if the user is allowed to resize nodes interactively.
boolean	isSelected(Object object) Returns true if and only if the graphic representation of the specified object is selected.
boolean	isSelectionListenerPlugged() Returns true if SDM reacts to selection changes.
boolean	isUseBaseTextDirectionFromStyleSheetRenderer() Returns whether the base text direction specified in the style sheet renderer, or specified in CSS in the StyleSheet section, it taken into account.
boolean	isViewListenerPlugged() Returns true if SDM reacts to View changes.
void	loadData() Loads the data described by the current model using the current renderer.
void	moveObject(Object object, double x, double y, IlvTransformer t, int alignment, boolean redraw) Deprecated. Beginning with JViews 2002, this method is deprecated because it does not work properly when the object is contained in a subgraph. Use the method moveObject(java.lang.Object,ilog.views.IlvManagerView,double,double,boolean,int,boolean) instead.
void	moveObject(Object object, IlvManagerView view, double x, double y, boolean translate, int alignment, boolean redraw) Moves or translates an object to a specified view position.
void	paste() Reads the data objects currently contained in the system clipboard (as an XML string) and adds them to the data model.
void	performLabelLayout() Performs a graph layout algorithm on the labels of the graph.
void	performLinkLayout() Performs a layout algorithm on the links of the graph.
void	performNodeLayout() Performs a layout algorithm on the nodes of the graph.
void	plugAllListeners(boolean on) Installs or uninstalls all SDM engine listeners at once.
void	plugManagerListener(boolean on) Installs or uninstalls listener on Manager.
void	plugModelListener(boolean on) Installs or uninstalls listener on model.
void	plugSelectionListener(boolean on) Installs or uninstalls listener on manager selection.
void	plugViewListener(boolean on) Installs or uninstalls listener on View.
boolean	processServerAction(int x, int y, IlvManagerView view) This method can be called when the SDM engine is used on the server-side of a web application, to process an action sent by the client-side.
protected void	processXMLProcessingInstructionProperty(String property, String value, String url, boolean insert) Processes a property read from the SDM processing instruction in an XML file.
void	putStringToClipboard(String data) For internal use only.
void	readDOM(Document document) Reads an SDM data model from a DOM document.
void	readDOM(Document document, boolean add) Reads an SDM data model from a DOM document.
void	readXML(InputStream stream) Reads an XML description of an SDM data model from an input stream.
void	readXML(InputStream stream, boolean add) Reads an XML description of an SDM data model from an input stream.
void	readXML(Reader reader) Reads an XML description of an SDM data model from a Reader.
void	readXML(Reader reader, boolean add) Reads an XML description of an SDM data model from a Reader.
void	readXML(String url) Reads an XML description of an SDM data model from a URL.
void	readXML(String url, boolean add) Reads an XML description of an SDM data model from a URL.
IlvGraphic	recreateObject(Object object, boolean redraw, boolean oneLevel) Re-creates a graphic representation of a model object.
void	removePropertyChangeListener(PropertyChangeListener listener) Removes a listener on property modification.
void	removePseudoClass(Object object, String pseudoClass) Removes a pseudo-class from the specified data object.
void	removeSDMEngineDataLoadingListener(SDMEngineDataLoadingListener listener) Removes an SDMEngineDataLoadingListener from this SDM engine.
void	removeSDMEngineSelectionListener(SDMEngineSelectionListener listener) Removes an SDMEngineSelectionListener from this SDM engine.
void	removeSDMEngineStyleSheetListener(SDMEngineStyleSheetListener listener) Removes an SDMEngineStyleSheetListener from this SDM engine.
void	renderingDone() This method calls the renderingDone method of the renderer.
void	scrollToObject(Object object) Makes sure that an object is visible in the reference view of this SDM engine.
void	selectAllObjects() Selects all the graphic objects that represent objects of the data model.
void	setAdjusting(boolean adjusting) Starts or stops an editing sequence.
void	setAllSelectedObjects(Collection<?> objects) Selects the graphic objects that represent the model objects given as arguments, and deselects all other graphic objects that represent objects of the data model.
void	setBaseTextDirection(int baseTextDirection) Set default base text direction of engine.
void	setBaseTextDirection(int baseTextDirection, boolean draw) Set default base text direction of engine.
void	setBaseURL(String url) Sets the base URL used by this SDM engine to find its resources, such as the map files or the bitmap files.
void	setCompiledSymbolAutoLoad(boolean on) Controls whether compiled symbols should be loaded (if available), instead of interpreted CSS version when a class declaration involving symbol is found.
void	setContrastAccessibilityTheme(String theme) Sets the current contrast theme.
void	setCSSDebugHandler(ilog.views.util.css.IlvCSSDebugHandler handler) Sets the css debugger handler, or null if no debugger is activated.
void	setDetailLevel(String level) Sets the current level of detail.
void	setDropToGroupEnabled(boolean enabled) Specifies whether or not dropping or duplicating a node in an existing subgraph will make the node a child of this subgraph.
void	setEmptySubgraphAllowed(boolean allowed) Allows or disallows empty subgraphs.
void	setGrapher(IlvGrapher grapher) Sets the grapher associated with this SDM engine.
void	setGrapherCleanerHandler(ilog.views.sdm.internal.IlvGrapherCleanerHandler handler) Sets the grapher cleaner handler, which is called when SDM wants to remove its objects.
void	setHighlightingSelection(boolean yes) Enables "selection by highlighting".
void	setJavaColorNamesFirst(boolean val) Specifies whether to use Java color names or SVG color names when there is a conflict.
void	setLabelLayoutEnabled(boolean enabled) Enables or disables the automatic layout of labels.
void	setLayoutRunning(boolean running) Sets the flag indicating that a layout algorithm is running.
void	setLinkLayoutEnabled(boolean enabled) Enables or disables the automatic layout of links.
void	setLinkLayoutEnabledWhileMoving(boolean enabled) Enables or disables the automatic link layout while moving nodes.
void	setLinkNodeVisibilityCoupled(boolean coupled) Sets whether link visibility is coupled to node visibility.
void	setMetadataEnabled(boolean on) Controls whether metadata are enabled or not.
void	setModel(IlvSDMModel model) Changes the data model used by this SDM engine.
void	setModel(IlvSDMModel model, boolean reload) Changes the data model used by this SDM engine.
void	setNodeLayoutEnabled(boolean enabled) Enables or disables the automatic layout of nodes.
void	setOpaqueMove(boolean opaque) Sets the Opaque Move mode of the select interactor attached to the views of this SDM engine.
void	setPseudoClasses(String[] classes) Sets the pseudoclasses associated with all data objects.
void	setReferenceView(IlvManagerView view) Sets the reference view of this SDM engine.
void	setReferenceZoom(double zoom) Sets the initial zoom factor that is used as a reference to compute zoom-related behavior.
void	setRenderer(IlvSDMRenderer renderer) Changes the root of the renderer chain.
void	setRenderingDoneMode(int renderingDoneMode) Determines the way the IlvSDMRenderer.renderingDone(ilog.views.sdm.IlvSDMEngine) method is called on selection or property changes.
void	setResizingAllowed(boolean allowed) Allows or forbids the user to resize nodes interactively.
static void	setSDMEngine(IlvGrapher grapher, IlvSDMEngine engine) Associates an SDM engine with the specified grapher.
void	setSelected(Object[] objects, boolean selected) Selects or deselects the graphic objects representing the specified array of data objects.
void	setSelected(Object object, boolean selected) Selects or deselects the graphic object representing a specified data object.
void	setSelectionPseudoClass(String selectionPseudoClass) Changes the pseudo-class used to style selected objects.
void	setStyleSheetDebugMask(int v) Sets the debug flag while parsing the configuration style sheet.
void	setStyleSheets(int index, String css) Changes one of the cascading style sheets.
void	setStyleSheets(int index, String css, boolean reload) Same as setStyleSheets(int, String), with the possibility to not recreate the diagram.
void	setStyleSheets(String[] css) Sets the style sheet(s) used by this SDM engine to map the data model to Perforce JViews graphic objects.
void	setStyleSheets(String[] css, boolean reload, boolean recreate) Sets the style sheet(s) used by this SDM engine to map the data model to Perforce JViews graphic objects.
void	setUseBaseTextDirectionFromStyleSheetRenderer(boolean use) Sets whether the base text direction specified in the style sheet renderer, or specified in CSS in the StyleSheet section, it taken into account.
void	setXMLConnector(IlvXMLConnector connector) Sets the IlvXMLConnector object used to read and write the contents of the SDM data model from/to XML files.
void	setXMLFile(String xmlFile) Sets the XML file containing the data to display.
void	setXMLProcessingInstructionProperty(String property, String value) Sets a property to be saved in the XML processing instruction for SDM.
void	ungroup() Ungroups the selected objects.
void	updateNodePositions() Saves the positions of all the nodes in the data.
void	updateNodePositions(Iterator<Object> nodes) Saves the positions of nodes in the data.
void	updateObjectProperties(Object object, String property, Object value, String[] pseudoClasses) This method calls IlvSDMRenderer.updateObjectProperties(ilog.views.sdm.IlvSDMEngine, java.lang.Object, java.lang.String, java.lang.Object, java.lang.String[]) on the root renderer of the SDM engine.
void	writeDOM(Document document) Writes the data contained in the current data model to a DOM document.
void	writeXML(OutputStream stream) Writes the data contained in the current data model to a stream.
void	writeXML(String filename) Writes the data contained in the current data model to an XML file.
void	writeXML(Writer writer) Writes the data contained in the current data model to a Writer.

Methods inherited from class java.lang.Object

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

Field Detail

HIGH_DETAIL_LEVEL

public static final String HIGH_DETAIL_LEVEL

The pseudoclass "high-detail-level" that indicates a high level of detail.

Since:

JViews 8.0

See Also:

Constant Field Values

MEDIUM_DETAIL_LEVEL

public static final String MEDIUM_DETAIL_LEVEL

The pseudoclass "medium-detail-level" that indicates a medium level of detail.

Since:

JViews 8.0

See Also:

Constant Field Values

LOW_DETAIL_LEVEL

public static final String LOW_DETAIL_LEVEL

The pseudoclass "low-detail-level" that indicates a low level of detail.

Since:

JViews 8.0

See Also:

Constant Field Values

HIGH_CONTRAST

public static final String HIGH_CONTRAST

The pseudoclass "high-contrast" that indicates a high contrast theme.

Since:

JViews 8.8

See Also:

Constant Field Values

NORMAL_CONTRAST

public static final String NORMAL_CONTRAST

The pseudoclass "normal-contrast" that indicates a normal contrast theme.

Since:

JViews 8.8

See Also:

Constant Field Values

IF_BBOX_CHANGED

public static final int IF_BBOX_CHANGED

Used as a parameter to setRenderingDoneMode(int), specifies that the IlvSDMRenderer.renderingDone(ilog.views.sdm.IlvSDMEngine) method must called on selection or property changes only when the bounding box of a graphic object has changed.

Since:

JViews 6.0

See Also:

Constant Field Values

NEVER

public static final int NEVER

Used as a parameter to setRenderingDoneMode(int), specifies that the IlvSDMRenderer.renderingDone(ilog.views.sdm.IlvSDMEngine) method must never be called on selection or property changes.

Since:

JViews 6.0

See Also:

Constant Field Values

ALWAYS

public static final int ALWAYS

Used as a parameter to setRenderingDoneMode(int), specifies that the IlvSDMRenderer.renderingDone(ilog.views.sdm.IlvSDMEngine) method must always be called on selection or property changes.

Since:

JViews 6.0

See Also:

Constant Field Values

Constructor Detail

IlvSDMEngine

public IlvSDMEngine(IlvGrapher grapher,
                    IlvSDMModel model)

Creates an SDM engine with a specified grapher and data model.

Parameters:

grapher - The grapher.

model - The data model.

IlvSDMEngine

public IlvSDMEngine()

Creates an SDM engine for a new grapher with a default data model, which is an instance of the class IlvDefaultSDMModel. The default model is initially empty.

See Also:

IlvDefaultSDMModel, IlvStyleSheetRenderer

Method Detail

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

Adds a listener on property modification.

Specified by:

addPropertyChangeListener in interface IlvStylable

Parameters:

listener - The listener to add.

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)

Removes a listener on property modification.

Specified by:

removePropertyChangeListener in interface IlvStylable

Parameters:

listener - The listener to remove.

setStyleSheets

public void setStyleSheets(String[] css)
                    throws IlvSDMException

Sets the style sheet(s) used by this SDM engine to map the data model to Perforce JViews graphic objects.

The CSS documents in the css array are concatenated. The style sheets with a higher index in the array have a higher priority.

This call will re-create the SDM renderers and all the graphic objects. See also the variant setStyleSheets(java.lang.String[],boolean,boolean) that lets you control how the style sheets are applied.

See the class description for an explanation of the contents of the style sheet files.

Specified by:

setStyleSheets in interface IlvStylable

Parameters:

css - An array of strings containing the URLs or the file names of CSS files (usually with a .css suffix). A direct String representing the CSS document itself is allowed, too.

Throws:

IlvSDMException

See Also:

setStyleSheets(int,java.lang.String), setStyleSheets(java.lang.String[],boolean,boolean)

setStyleSheets

public void setStyleSheets(String[] css,
                           boolean reload,
                           boolean recreate)
                    throws IlvSDMException

Sets the style sheet(s) used by this SDM engine to map the data model to Perforce JViews graphic objects.

This method is similar to setStyleSheets(java.lang.String[]) but provides two additional parameters, reload and recreate, that control how the new style sheets are applied.

The reload parameter specifies whether or not the graphic objects representing the SDM data model will be updated.

The recreate parameter specifies whether the graphic objects representing the SDM data model will be re-created or if the new style sheets will simply be applied to the existing graphic objects. This also applies to the SDM renderers: if recreate is true, the renderers defined in the style sheet are re-created; otherwise their properties are simply set according to the new style sheets.

Setting recreate to false lets you update the display much more quickly, but there are some limitations:

• You cannot add or remove renderers. The exact same set of renderers will be used. Only the properties of the renderers or of the SDM engine itself will be modified.
• You cannot change the class of a graphic object, since the objects are not re-created. Note, however, that the objects used as property values (using the "@#" construct) will be re-created as usual.

Parameters:

css - An array of strings representing the CSS document (usually with a file or URL with .css suffix).

reload - If this parameter is true, the graphic objects representing the current SDM data model are updated according to the new style sheets. If this parameter is false, the graphic objects are not updated. They can be updated later by calling loadData() or customizeAllObjects(). The way the graphic objects are updated depends on the recreate parameter.

recreate - If this parameter is true, all the graphic objects and the SDM renderers are re-created according to the new style sheets. If this parameter is false, the graphic objects and the SDM renderers are not re-created. Instead, their properties are set according to the new style sheets.

Throws:

IlvSDMException - if an SDM exception occurs

Since:

JViews 5.5

setStyleSheets

public void setStyleSheets(int index,
                           String css)
                    throws IlvSDMException

Changes one of the cascading style sheets. A style sheet can be a URL, a filename, or the style sheet string directly. This method is an alternative to setStyleSheets(java.lang.String[]). It lets you change one particular style sheet file, instead of setting the whole style sheet array.

This call will reload the data model and re-create all the graphic objects. Warning, this method will override the current renderers.

This is a bound property. It means the implementation should fire a PropertyChange event to all registered PropertyChangeListeners after setting the new value. The old and new value arguments of the event represent the whole array.

Specified by:

setStyleSheets in interface IlvStylable

Parameters:

index - The index of the style sheet to replace.

css - A String representing the CSS document (usually a file name or URL with .css suffix).

Throws:

IlvSDMException - if there is a problem with the specified CSS.

See Also:

setStyleSheets(java.lang.String[])

setStyleSheets

public void setStyleSheets(int index,
                           String css,
                           boolean reload)
                    throws IlvSDMException

Same as setStyleSheets(int, String), with the possibility to not recreate the diagram.

Parameters:

index - The index of the style sheet to replace.

css - A String representing the CSS document (usually a filename or a URL with the .css suffix).

reload - If false, do not recreate the diagram.

Throws:

IlvSDMException - if there is a problem with the specified CSS.

Since:

JViews 8.0

getStyleSheets

public String getStyleSheets(int index)

Returns one of the style sheets used by this SDM engine to map the data model to Perforce JViews graphic objects.

Specified by:

getStyleSheets in interface IlvStylable

Parameters:

index - The position of the style sheet.

Returns:

The URL or file name of the index-th style sheet.

See Also:

setStyleSheets(java.lang.String[]), getStyleSheets()

getStyleSheets

public String[] getStyleSheets()

Returns the style sheet(s) used by this SDM engine to map the data model to Perforce JViews graphic objects.

Specified by:

getStyleSheets in interface IlvStylable

Returns:

An array containing the URLs or file names of the style sheets.

See Also:

setStyleSheets(java.lang.String[]), getStyleSheets(int)

setStyleSheetDebugMask

public void setStyleSheetDebugMask(int v)

Sets the debug flag while parsing the configuration style sheet. Set this property before calling setStyleSheets to debug problems during configuration. The default value traces bad class names and "set" methods that raise an exception.

Specified by:

setStyleSheetDebugMask in interface IlvStylable

Parameters:

v - The debug mask, as defined in IlvStyleSheetRenderer.

Since:

JViews 5.0

See Also:

IlvStyleSheetRenderer.setDebugMask(int), setStyleSheets(String[]), getStyleSheetDebugMask()

getStyleSheetDebugMask

public int getStyleSheetDebugMask()

Returns the debug level of the current configuration style sheet.

Specified by:

getStyleSheetDebugMask in interface IlvStylable

Since:

JViews 5.0

See Also:

setStyleSheetDebugMask(int)

setCSSDebugHandler

public void setCSSDebugHandler(ilog.views.util.css.IlvCSSDebugHandler handler)

Sets the css debugger handler, or null if no debugger is activated.

Parameters:

handler -

Since:

JViews 8.5

Internal: do not use!

getCSSDebugHandler

public ilog.views.util.css.IlvCSSDebugHandler getCSSDebugHandler()

Returns the current css debugger.

Returns:

current css debugger

Since:

JViews 8.5

Internal: do not use!

applyStyle

public Object applyStyle(Object bean,
                         String ruleName,
                         String[] pseudoClasses)

Applies the current style sheet(s) of this SDM engine to a bean.

This method gives direct access to the styling engine and is useful to style any JavaBean of an application.

This variant styles a bean independently of the SDM data model, that is, a bean that is not associated with any node or link of the graph. The rule that is used to style the bean is specified by the ruleName parameter. See also the other variant applyStyle(java.lang.Object,java.lang.Object,java.lang.String[]) that styles a bean using a node or link rule.

Example

Here is how you could style a JTree of your GUI:

     IlvSDMEngine engine = ...
     JTree tree = new JTree();
     engine.applyStyle(tree, "JTree", null);
 

And here is a rule that could be used in the style sheet:

 JTree {
     editable : "true";     // calls tree.setEditable(true);
     rootVisible : "false"; // calls tree.setRootVisible(false);
 }
 

Parameters:

bean - The JavaBean to which the style sheets will be applied. If this parameter is null, and if the rule contains a declaration for the "class" property, an instance of this class will be created and returned by this method.

ruleName - The name of the style rule that will be applied.

pseudoClasses - The pseudo-classes used to select the style rule to apply. This parameter can be null.

Returns:

The bean parameter, or the new bean created if the bean parameter was null and rule contained a declaration for the "class" property.

Since:

JViews 6.0

applyStyle

public Object applyStyle(Object bean,
                         Object nodeOrLink,
                         String[] pseudoClasses)

Applies the current style sheet(s) of this SDM engine to a bean.

This method gives direct access to the styling engine and is useful to style any JavaBean of an application.

This variant styles a bean associated with a node or a link of the graph. The style rule that is used to style the bean is the rule that matches the specified node or link. See also the other variant applyStyle(java.lang.Object,java.lang.String,java.lang.String[]) that styles a bean using a fixed rule name.

Example

Here is how you could style the cell renderer of a JList displaying the nodes and links of the SDM model:

   final IlvSDMEngine engine = new IlvSDMEngine();
   DefaultListModel listModel = new DefaultListModel();
   Enumeration en = engine.getAllObjects();
   while(en.hasMoreElements()) listModel.addElement(en.nextElement());
   JList list = new JList(listModel);
   list.setCellRenderer(new DefaultListCellRenderer(){
     public Component getListCellRendererComponent(JList list,
                                                   Object nodeOrLink,
                                                   int index,
                                                   boolean isSelected,
                                                   boolean cellHasFocus)
     {
       Component c = super.getListCellRendererComponent(list,
                                                        nodeOrLink,
                                                        index,
                                                        isSelected,
                                                        cellHasFocus);
       String[] pseudoClasses;
       if(isSelected)
         pseudoClasses = new String[]{ "listCellRenderer",
                                       "selected" };
       else
         pseudoClasses = new String[]{ "listCellRenderer" };

       engine.applyStyle(c, nodeOrLink, pseudoClasses);

       return c;
     }
   });
 

And here are the rules that could be used in the style sheet:

 node:listCellRenderer {
    background : "white";    // calls c.setBackground(Color.white);
    foreground : "black";    // calls c.setForeground(Color.black);
 }
 node:listCellRenderer:selected {
    background : "lightblue"; // calls c.setBackground([lightblue]);
 }
 

Note the use of the pseudo-classes to style the list cell differently according to the list selection.

Parameters:

bean - The JavaBean to which the style sheets will be applied. This parameter must not be null.

nodeOrLink - The object of the SDM data model that is used to select the style rule to apply to the bean.

pseudoClasses - The pseudo-classes used to select the style rules to apply. This parameter can be null.

Returns:

The bean parameter.

Since:

JViews 6.0

setJavaColorNamesFirst

public void setJavaColorNamesFirst(boolean val)

Specifies whether to use Java color names or SVG color names when there is a conflict.

A global Color property editor which understands both Java color names and SVG color names (see SVG color keywords). is registered by default to handle properties of type Color. Unfortunately, there are some name clashes between Java and SVG. For example, the color name "green" means #00FF00 for Java, but #008000 for SVG. Therefore a choice must be made.

If the specified Boolean value is true, the Java value will be used, for example, the "green" color set in the style sheet will be the value #00FF00.

The default Boolean value is false, which specifies the use of SVG color names.

Parameters:

val - The Boolean value. If true, use Java color names. If false, use SVG color names.

Since:

JViews 6.0

isJavaColorNamesFirst

public boolean isJavaColorNamesFirst()

Returns true if Java color names are to be used instead of SVG color names when there is a conflict.

Returns:

true if java color are first

Since:

JViews 6.0

plugAllListeners

public void plugAllListeners(boolean on)

Installs or uninstalls all SDM engine listeners at once. Use it to unplug SDM, allowing then direct management of graphic objects without getting SDM in the way. The listeners are automatically installed when the engine is initialized and loaded.

Parameters:

on - true to install (automatically done) or false to uninstall

Since:

JViews 8.5

See Also:

plugModelListener(boolean), plugViewListener(boolean), plugSelectionListener(boolean), plugManagerListener(boolean)

plugModelListener

public void plugModelListener(boolean on)

Installs or uninstalls listener on model. Use this family of methods to unplug SDM, allowing then direct management of graphic objects without getting SDM in the way. The listener is automatically installed when the model is set or loaded the first time.

Parameters:

on - true to install (automatically done) or false to uninstall

Since:

JViews 8.5

isModelListenerPlugged

public boolean isModelListenerPlugged()

Returns true if SDM reacts to model changes.

Returns:

true if SDM reacts to model changes

Since:

JViews 8.5

See Also:

plugModelListener(boolean)

plugViewListener

public void plugViewListener(boolean on)

Installs or uninstalls listener on View. Use this family of methods to unplug SDM, allowing then direct management of graphic objects without getting SDM in the way. The listener is automatically installed when the manager is set.

Parameters:

on - true to install (automatically done) or false to uninstall

Since:

JViews 8.5

isViewListenerPlugged

public boolean isViewListenerPlugged()

Returns true if SDM reacts to View changes.

Returns:

true if SDM reacts to View changes

Since:

JViews 8.5

See Also:

plugViewListener(boolean)

plugSelectionListener

public void plugSelectionListener(boolean on)

Installs or uninstalls listener on manager selection. Use this family of methods to unplug SDM, allowing then direct management of graphic objects without getting SDM in the way. The listener is automatically installed when the manager is set.

Parameters:

on - true to install (automatically done) or false to uninstall

Since:

JViews 8.5

isSelectionListenerPlugged

public boolean isSelectionListenerPlugged()

Returns true if SDM reacts to selection changes.

Returns:

true if SDM reacts to selection changes

Since:

JViews 8.5

See Also:

plugSelectionListener(boolean)

plugManagerListener

public void plugManagerListener(boolean on)

Installs or uninstalls listener on Manager. Use this family of methods to unplug SDM, allowing then direct management of graphic objects without getting SDM in the way. The listener is automatically installed when the manager is set.

Parameters:

on - true to install (automatically done) or false to uninstall

Since:

JViews 8.5

isManagerListenerPlugged

public boolean isManagerListenerPlugged()

Returns true if SDM reacts to manager content changes.

Returns:

true if SDM reacts to selection changes

Since:

JViews 8.5

See Also:

plugManagerListener(boolean)

setGrapher

public void setGrapher(IlvGrapher grapher)

Sets the grapher associated with this SDM engine.

Parameters:

grapher - The new grapher in which this SDM engine will render its data model.

getGrapher

public IlvGrapher getGrapher()

Returns the grapher associated with this SDM engine.

Returns:

current grapher

getULocale

public com.ibm.icu.util.ULocale getULocale(IlvSDMModel model,
                                           Object obj,
                                           com.ibm.icu.util.ULocale fallBackLocale)

Returns the locale for a model object, from the subgrapher that will contain the graphic object or from the context.

This method is for internal use; you should not call it directly.

Parameters:

model - A model.

obj - An object in this model.

fallBackLocale - This locale is returned if the object does not correspond to a graphic object or is not contained in any grapher.

Since:

JViews 8.8

Internal: do not use!

getComponentOrientation

public ComponentOrientation getComponentOrientation(IlvSDMModel model,
                                                    Object obj,
                                                    ComponentOrientation fallBackComponentOrientation)

Returns the component orientation for a model object, from the subgrapher that will contain the graphic object or from the context.

This method is for internal use; you should not call it directly.

Parameters:

model - A model.

obj - An object in this model.

fallBackComponentOrientation - This component orientation is returned if the object does not correspond to a graphic object or is not contained in any grapher.

Since:

JViews 8.8

Internal: do not use!

setBaseTextDirection

public void setBaseTextDirection(int baseTextDirection)

Set default base text direction of engine. The possible choices are:

• IlvBidiUtil.COMPONENT_DIRECTION: the base text direction is calculated from the component orientation.
• IlvBidiUtil.LEFT_TO_RIGHT: the base text direction is left-to-right.
• IlvBidiUtil.RIGHT_TO_LEFT: the base text direction is right-to-left.
• IlvBidiUtil.CONTEXTUAL_DIRECTION: the base test direction is determined from the text that is displayed according to the standard Bidi algorithm, if the text contains at least one character with a strong left-to-right or right-to-left direction. If the text doesn't contain any character with a strong direction, the real text direction is determined from the current component orientation of the object.

If you call this method explicitely, you should also call setUseBaseTextDirectionFromStyleSheetRenderer(boolean) with a false argument to disable that the base text direction of the renderer is taken into account.

Parameters:

baseTextDirection - The base text direction

Since:

JViews 8.8

setBaseTextDirection

public void setBaseTextDirection(int baseTextDirection,
                                 boolean draw)

Set default base text direction of engine. The possible choices are:

• IlvBidiUtil.COMPONENT_DIRECTION: the base text direction is calculated from the component orientation.
• IlvBidiUtil.LEFT_TO_RIGHT: the base text direction is left-to-right.
• IlvBidiUtil.RIGHT_TO_LEFT: the base text direction is right-to-left.
• IlvBidiUtil.CONTEXTUAL_DIRECTION: the base test direction is determined from the text that is displayed according to the standard Bidi algorithm, if the text contains at least one character with a strong left-to-right or right-to-left direction. If the text doesn't contain any character with a strong direction, the real text direction is determined from the current component orientation of the object.

If you call this method explicitely, you should also call setUseBaseTextDirectionFromStyleSheetRenderer(boolean) with a false argument to disable that the base text direction of the renderer is taken into account.

Parameters:

baseTextDirection - The base text direction

draw - Whether to draw the manager.

Since:

JViews 8.8

getBaseTextDirection

public int getBaseTextDirection()

Return default base text direction of engine.

Returns:

int Default base text direction

Since:

JViews 8.8

setUseBaseTextDirectionFromStyleSheetRenderer

public void setUseBaseTextDirectionFromStyleSheetRenderer(boolean use)

Sets whether the base text direction specified in the style sheet renderer, or specified in CSS in the StyleSheet section, it taken into account. If this option is set to true, specifying the base text direction via setBaseTextDirection(int) on the SDM Engine has only an intermediate effect, since the next full styling will override it with the setting in the style sheet renderer. If the option is set to false, the CSS specification StyleSheet { baseTextDirection: ...; } has no effect anymore.

Parameters:

use - Whether the setting at the style sheet renderer is used.

Since:

JViews 8.8

isUseBaseTextDirectionFromStyleSheetRenderer

public boolean isUseBaseTextDirectionFromStyleSheetRenderer()

Returns whether the base text direction specified in the style sheet renderer, or specified in CSS in the StyleSheet section, it taken into account.

Since:

JViews 8.8

setSDMEngine

public static void setSDMEngine(IlvGrapher grapher,
                                IlvSDMEngine engine)

Associates an SDM engine with the specified grapher. You should never call this method directly.

Parameters:

grapher - The grapher whose associated SDM engine is requested.

engine - The SDM engine.

getSDMEngine

public static IlvSDMEngine getSDMEngine(IlvGrapher grapher)

Returns the SDM engine associated with the specified grapher, or null if no SDM engine is associated with the specified grapher.

Parameters:

grapher - The grapher whose associated SDM engine is requested.

Returns:

engine which manages given grapher

getSDMEngine

public static IlvSDMEngine getSDMEngine(IlvGraphic graphic)

Returns the SDM engine associated with the grapher in which the specified graphic object is contained, or null if the graphic is not contained in a grapher or if the grapher has no associated SDM engine.

Parameters:

graphic - The graphic object whose associated SDM engine is requested.

Returns:

engine which manages given graphic

setCompiledSymbolAutoLoad

public void setCompiledSymbolAutoLoad(boolean on)

Controls whether compiled symbols should be loaded (if available), instead of interpreted CSS version when a class declaration involving symbol is found. Default is false. Setting this flag to true is equivalent to change in the CSS the class declaration of a symbol to its compiled version. example:

 class : '@|symbolResource(ilog/views/palettes/CompileTest/symbols/RoundOrange.css,Symbol,Symbols.RoundOrange,ilog/views/palettes/CompileTest/palette.xml,file:/E:/My Documents/CompileTest.jar';
 
 is interpreted as 
 
 class : 'ilog.views.palettes.CompileTest.RoundOrange';
 

Remember to have the compiled symbol in the classpath.

Since:

JViews 8.5

isCompiledSymbolAutoLoad

public boolean isCompiledSymbolAutoLoad()

Returns true if compiled symbols are loaded if available.

Returns:

true if compiled symbols are loaded if available.

Since:

JViews 8.5

getModel

public IlvSDMModel getModel()

Returns the current data model.

Returns:

The current data model.

setModel

public void setModel(IlvSDMModel model)

Changes the data model used by this SDM engine.

This call causes the data model to be loaded and rendered by the engine.

Parameters:

model - The new data model to use.

See Also:

setModel(ilog.views.sdm.IlvSDMModel, boolean)

setModel

public void setModel(IlvSDMModel model,
                     boolean reload)

Changes the data model used by this SDM engine.

This call causes the data model to be loaded and rendered only if the reload parameter is true

Parameters:

model - The new data model to use.

reload - If true, causes the data to be reloaded by the SDM engine.

See Also:

setModel(ilog.views.sdm.IlvSDMModel)

setXMLFile

public void setXMLFile(String xmlFile)
                throws IlvSDMException,
                       IOException,
                       MalformedURLException

Sets the XML file containing the data to display.

The XML file is parsed, and its contents are rendered graphically by the SDM engine.

If the XML file contains a processing instruction of the form:

 <?sdm stylesheet="example.css"?>
 

then the specified style sheet is used to display the data. Warning: This will override the current renderer.

Otherwise, the current style sheet is used.

Parameters:

xmlFile - The URL of the XML file.

Throws:

IlvSDMException - if an error occurred while opening or reading the XML file.

IOException - if an I/O error occurred while opening or reading the XML file.

MalformedURLException - if xmlFile is not an URL

See Also:

IlvXMLConnector

getXMLFile

public String getXMLFile()

Returns the URL of the XML file currently being displayed by the SDM engine.

Returns:

A URL (as a string), or null if the current model does not support XML or if no XML file is currently displayed.

readXML

public void readXML(String url)
             throws IlvSDMException,
                    IOException,
                    MalformedURLException

Reads an XML description of an SDM data model from a URL.

Parameters:

url - The URL to read the XML description from.

Throws:

IlvSDMException - if a SDM exception occurs

IOException - if an IOException occurs

MalformedURLException - if url is malformed

See Also:

readXML(java.lang.String,boolean), readXML(java.io.Reader,boolean)

readXML

public void readXML(String url,
                    boolean add)
             throws IlvSDMException,
                    IOException,
                    MalformedURLException

Reads an XML description of an SDM data model from a URL.

This method is similar to readXML(java.lang.String), except that it has an additional add parameter that allows you to add the contents of the XML file to the current data model.

Parameters:

url - The URL to read the XML description from.

add - If this parameter is false, the SDM data model is cleared before reading the XML file. If this parameter is true, the contents of the XML file are added to the SDM data model.

Throws:

IlvSDMException - if a SDM exception occurs

IOException - if an IOException occurs

MalformedURLException - if url is malformed

Since:

JViews 5.0

readXML

public void readXML(InputStream stream)
             throws IlvSDMException,
                    IOException

Reads an XML description of an SDM data model from an input stream.

Parameters:

stream - The XML formatted input stream.

Throws:

IlvSDMException - if a SDM exception occurs

IOException - if an IOException occurs

See Also:

readXML(java.io.InputStream,boolean), readXML(java.io.Reader,boolean)

readXML

public void readXML(Reader reader,
                    boolean add)
             throws IlvSDMException,
                    IOException

Reads an XML description of an SDM data model from a Reader.

This method is similar to readXML(java.io.Reader), except that it has an additional add parameter that allows you to add the contents of the XML file to the current data model.

Parameters:

reader - The XML-formatted reader.

add - If this parameter is false, the SDM data model is cleared before reading the XML file. If this parameter is true, the contents of the XML file are added to the SDM data model.

Throws:

IlvSDMException - if a SDM exception occurs

IOException - if an IOException occurs

Since:

JViews 6.0

See Also:

readXML(java.io.InputStream,boolean)

readXML

public void readXML(Reader reader)
             throws IlvSDMException,
                    IOException

Reads an XML description of an SDM data model from a Reader.

Parameters:

reader - The XML-formatted reader.

Throws:

IlvSDMException - if a SDM exception occurs

IOException - if an IOException occurs

Since:

JViews 6.0

See Also:

readXML(java.io.Reader,boolean), readXML(java.io.InputStream,boolean)

readXML

public void readXML(InputStream stream,
                    boolean add)
             throws IlvSDMException,
                    IOException

Reads an XML description of an SDM data model from an input stream.

This method is similar to readXML(java.io.InputStream), except that it has an additional add parameter that allows you to add the contents of the XML stream to the current data model.

Parameters:

stream - The XML-formatted input stream.

add - If this parameter is false, the SDM data model is cleared before reading the XML stream. If this parameter is true, the contents of the XML stream are added to the SDM data model.

Throws:

IlvSDMException - if a SDM exception occurs

IOException - if an IOException occurs

Since:

JViews 5.0

readDOM

public void readDOM(Document document)
             throws IlvSDMException,
                    IOException

Reads an SDM data model from a DOM document. The effect is equivalent to saving the document to a file and reading it back through readXML(java.io.InputStream), but the parsing is done entirely in memory: no temporary file is used.

This method is useful to create an SDM model from an existing DOM document. For example, you might have an existing DOM document that does not have the right format for SDM. You can process this document through an XSLT engine and pass the output document to the SDM engine using this method.

Parameters:

document - The DOM document containing the description of the SDM data model.

Throws:

IlvSDMException - if a SDM exception occurs

IOException - if an IOException occurs

See Also:

readDOM(org.w3c.dom.Document,boolean)

readDOM

public void readDOM(Document document,
                    boolean add)
             throws IlvSDMException,
                    IOException

Reads an SDM data model from a DOM document.

This method is similar to readDOM(org.w3c.dom.Document), except that it has an additional add parameter that allows you to add the contents of the DOM document to the current data model.

Parameters:

document - The DOM document containing the description of the SDM data model.

add - If this parameter is false, the SDM data model is cleared before reading the document. If this parameter is true, the contents of the document are added to the SDM data model.

Throws:

IlvSDMException - if a SDM exception occurs

IOException - if an IOException occurs

Since:

JViews 5.0

writeXML

public void writeXML(String filename)
              throws IOException

Writes the data contained in the current data model to an XML file.

Parameters:

filename - The path of the XML file.

Throws:

IOException - if an error occurred while opening the file or writing the data.

writeXML

public void writeXML(OutputStream stream)
              throws IOException

Writes the data contained in the current data model to a stream.

Parameters:

stream - The output stream to write the data to.

Throws:

IOException - if an error occurred while writing the data.

See Also:

writeXML(java.io.Writer)

writeXML

public void writeXML(Writer writer)
              throws IOException

Writes the data contained in the current data model to a Writer.

Parameters:

writer - The Writer to write the data to.

Throws:

IOException - if an error occurred while writing the data.

Since:

JViews 6.0

See Also:

writeXML(java.io.OutputStream)

writeDOM

public void writeDOM(Document document)

Writes the data contained in the current data model to a DOM document.

This method is useful when you want to process the SDM data, for example, using an XSLT engine.

Parameters:

document - The DOM document to write the SDM data to.

setXMLConnector

public void setXMLConnector(IlvXMLConnector connector)

Sets the IlvXMLConnector object used to read and write the contents of the SDM data model from/to XML files.

By default, the contents of an SDM model are read and written by an instance of the class IlvXMLConnector, which defines its own XML format as explained in the class description. If you want to read and write XML files in another format, you can subclass IlvXMLConnector and set the SDM engine's XML connector to an instance of your subclass.

Parameters:

connector - The new IlvXMLConnector object.

getXMLConnector

public IlvXMLConnector getXMLConnector()

Returns the IlvXMLConnector object used to read and write the contents of the SDM data model from/to XML files.

If no custom XML connector has been specified, an instance of the class IlvXMLConnector is returned.

Returns:

XML connector

See Also:

setXMLConnector(ilog.views.sdm.util.IlvXMLConnector)

setXMLProcessingInstructionProperty

public void setXMLProcessingInstructionProperty(String property,
                                                String value)

Sets a property to be saved in the XML processing instruction for SDM. The SDM processing instruction has the form:

   <?sdm property1="value1" property2="value2" ... ?>
 

When an XML file is read, each property found in the processing instruction is interpreted by the method processXMLProcessingInstructionProperty(java.lang.String, java.lang.String, java.lang.String, boolean).

By default, only the property "stylesheet" is understood.

Parameters:

property - The name of the processing instruction property.

value - The value of the processing instruction property.

Since:

JViews 5.5

getXMLProcessingInstructionProperty

public String getXMLProcessingInstructionProperty(String property)

Returns a property to be saved in the XML processing instruction for SDM.

Parameters:

property - The name of the processing instruction property.

Returns:

property value

Since:

JViews 5.5

See Also:

setXMLProcessingInstructionProperty(java.lang.String, java.lang.String)

processXMLProcessingInstructionProperty

protected void processXMLProcessingInstructionProperty(String property,
                                                       String value,
                                                       String url,
                                                       boolean insert)
                                                throws IlvSDMException

Processes a property read from the SDM processing instruction in an XML file.

By default, only the property "stylesheet" is understood. When this property is present in the XML file, it causes the specified style sheets to be applied to the XML data. The value of the "stylesheet" property is a list of comma-separated URLs. The list can contain a '+' character: in that case, the current style sheets of the SDM engine are inserted at the specified position. Duplicate style sheets are removed during this process.

Examples: The following processing instruction applies the style sheets a.css and b.css to the data objects read from the XML files.

   <?sdm stylesheet="a.css,b.css" ?>
 

The following processing instruction cascades the style sheets a.css and b.css after the current style sheet(s) of the SDM engine:

   <?sdm stylesheet="+,a.css,b.css" ?>
 

Parameters:

property - The name of the processing instruction property. The default implementation handles the property "stylesheet", and ignores any other property.

value - The value of the processing instruction property.

url - The URL from which the XML data was read.

insert - This parameter is true if the XML file has been inserted in the current SDM data model. It is false if the XML file has replaced the current contents of the data model.

Throws:

IlvSDMException - if an SDM exception occurs

Since:

JViews 5.5

getRenderer

public IlvSDMRenderer getRenderer()

Returns the root of the renderer chain.

Returns:

The root SDM renderer.

See Also:

getRenderer()

setRenderer

public void setRenderer(IlvSDMRenderer renderer)

Changes the root of the renderer chain.

The renderers attached to an SDM engine form a chained list. This method is used to set the first element of this list. All but the last element of the list are instances of IlvFilterSDMRenderer. The next element in the list is defined by the method setFilteredRenderer. The last element of the list is usually an instance of IlvStyleSheetRenderer.

Note that the preferred way to customize the renderers attached to an SDM engine is through the style sheet, by setting options (for example: LinkLayout : "true";, and so on). Calling this method will completely replace the renderers configured in the style sheet. Inversely, when a new style sheet is loaded, the current renderer list will be completely replaced by the renderers declared in the style sheet.

When this method is called, the data model is reloaded and the graph is rebuilt.

Parameters:

renderer - The new root SDM renderer.

setBaseURL

public void setBaseURL(String url)

Sets the base URL used by this SDM engine to find its resources, such as the map files or the bitmap files.

The base URL is set automatically when you call the setStyleSheets(java.lang.String[]) method.

Parameters:

url - The new base URL.

getBaseURL

public String getBaseURL()

Returns the base URL used by this SDM engine to find its resources, such as the map files or the bitmap files.

Returns:

base URL

setReferenceZoom

public void setReferenceZoom(double zoom)

Sets the initial zoom factor that is used as a reference to compute zoom-related behavior.

Parameters:

zoom - The reference zoom factor.

getReferenceZoom

public double getReferenceZoom()

Returns the reference zoom factor.

Returns:

reference zoom

getID

public String getID(Object obj)

Returns the identifier of a data object.

Parameters:

obj - The data object (an object returned by the data model attached to this engine) whose identifier is requested.

Returns:

object ID

getObject

public Object getObject(String id)

Looks up the data model for an object with the specified identifier.

Parameters:

id - The identifier of the requested object.

Returns:

The object with the specified identifier, or null if it does not exist.

getPseudoClasses

public String[] getPseudoClasses(Object object)

Returns the pseudo-classes associated with the specified data object. Pseudo-classes are used to modify the appearance of an object depending on some state information managed by SDM, such as whether the object is selected, expanded, and so on.

Parameters:

object - The data object whose pseudo-classes are queried.

Returns:

An array of strings that identify the pseudo-classes associated with the data object, merged with global pseudo classes defined with setPseudoClasses(String[]).

setPseudoClasses

public void setPseudoClasses(String[] classes)

Sets the pseudoclasses associated with all data objects. Pseudoclasses are used to modify the appearance of objects depending on some state information managed by SDM, such as the current level of detail.

The pseudoclasses defined here are merged with object pseudoclasses set in addPseudoClass(Object, String).

Warning: Changing the pseudoclasses does not refresh automatically the diagram.

Parameters:

classes - An array of strings that identify the pseudoclasses to associate with all the data objects.

Since:

JViews 8.0

getPseudoClasses

public String[] getPseudoClasses()

Returns the pseudoclasses associated with all data objects. Pseudoclasses are used to modify the appearance of an object depending on some state information managed by SDM, such as the current level of detail.

Returns:

An array of strings that identify the pseudoclasses associated with all data objects.

Since:

JViews 8.0

addPseudoClass

public void addPseudoClass(Object object,
                           String pseudoClass)

Adds a pseudo-class to the specified data object. Pseudo-classes are used to modify the appearance of an object depending on some state information managed by SDM, such as whether the object is selected, expanded, and so on.

Parameters:

object - The data object.

pseudoClass - A string that identifies a pseudo-class to add to the classes already associated with the data object.

removePseudoClass

public void removePseudoClass(Object object,
                              String pseudoClass)

Removes a pseudo-class from the specified data object. Pseudo-classes are used to modify the appearance of an object depending on some state information managed by SDM, such as whether the object is selected, expanded, and so on.

Parameters:

object - The data object.

pseudoClass - A string that identifies a pseudo-class to remove from the classes associated with the data object.

hasPseudoClass

public boolean hasPseudoClass(Object object,
                              String pseudoClass)

Returns true if and only if the specified object has the specified pseudo-class.

Parameters:

object - The data object.

pseudoClass - The pseudo-class.

Returns:

true if has the pseudo class

getObjectsWithPseudoClass

public Enumeration<?> getObjectsWithPseudoClass(String pseudoClass)

Returns all the objects of the model that have a given pseudo-class.

Parameters:

pseudoClass - The pseudo-class.

Returns:

enumeration of objects with given pseudo class

getDetailLevel

public String getDetailLevel()

Returns the pseudoclass that represents the current level of detail.

Returns:

One of HIGH_DETAIL_LEVEL, MEDIUM_DETAIL_LEVEL, or LOW_DETAIL_LEVEL (respectively, "high-detail-level", "medium-detail-level", or "low-detail-level").

Since:

JViews 8.0

setDetailLevel

public void setDetailLevel(String level)

Sets the current level of detail.

Nodes and links can be rendered differently depending on the level of detail. In the CSS rules, the pseudoclasses "high-detail-level", "medium-detail-level", and "low-detail-level" are used to specify the rendering. For instance:

 node {
   ... settings that affect all detail levels ...
 }

 node:high-detail-level {
   ... settings that affect only the high detail level ...
 }

 node:medium-detail-level {
   ... settings that affect only the medium detail level ...
 }

 node:low-detail-level {
   ... settings that affect only the low detail level ...
 }
 

Note: it is the callers responsibility to update the graphic objects that are impacted by the level change. This can be done by calling loadData() to trigger a restyling.

Parameters:

level - Set to one of the following:

• HIGH_DETAIL_LEVEL - high-detail-level (the default)
• MEDIUM_DETAIL_LEVEL - medium-detail-level
• LOW_DETAIL_LEVEL - low-detail-level

Since:

JViews 8.0

getContrastAccessibilityTheme

public String getContrastAccessibilityTheme()

Returns the pseudoclass that represents the current contrast theme.

Returns:

NORMAL_CONTRAST or HIGH_CONTRAST (respectively, "normal-contrast", or "high-contrast").

Since:

JViews 8.8

setContrastAccessibilityTheme

public void setContrastAccessibilityTheme(String theme)

Sets the current contrast theme. To support people with low vision, applications can provide two CSS declarations: one for normal vision, and a high contrast setting for people with low vision. The high contrast theme should use colors with high contrast and larger fonts.

Nodes and links can be rendered differently depending on the contrast theme. In the CSS rules, the pseudoclasses "high-contrast" and "normal-contrast" are used to specify the rendering. For instance:

 node {
   ... settings that are independent from the contrast theme ...
 }

 node:high-contrast {
   ... settings that affect only the high contrast theme ...
 }

 node:normal-contrast {
   ... settings that affect only the normal contrast theme ...
 }

 

Note: On Windows, the high contrast theme can be choosen by the operating system. In this case, the engine is initialized with high contrast theme, otherwise it is initialized with normal contrast theme. The initial setting can be changed through this API. In this case, it is the callers responsibility to update the graphic objects that are impacted by the theme change. This can be done by calling loadData() to trigger a restyling.

Parameters:

theme - Set to one of the following:

• HIGH_CONTRAST - high-contrast
• NORMAL_CONTRAST - normal-contrast

Since:

JViews 8.8

recreateObject

public IlvGraphic recreateObject(Object object,
                                 boolean redraw,
                                 boolean oneLevel)

Re-creates a graphic representation of a model object.

Parameters:

object - The model object.

redraw - If true, the object will be redisplayed.

oneLevel - If false, the child objects are also re-created.

Returns:

The newly created object(s).

Since:

JViews 6.0

loadData

public void loadData()

Loads the data described by the current model using the current renderer.

This method is called automatically when the model fires a dataChanged event, but it can also be called explicitly to load or reload the data.

This method removes all the graphic objects from the grapher before loading the new data.

getGrapherCleanerHandler

public ilog.views.sdm.internal.IlvGrapherCleanerHandler getGrapherCleanerHandler()

Returns the current grapher cleaner handler. Default value is null, which means that SDM remove all grapher objects.

Returns:

current grapher cleaner handler

Since:

JViews 8.1

Internal: do not use!

setGrapherCleanerHandler

public void setGrapherCleanerHandler(ilog.views.sdm.internal.IlvGrapherCleanerHandler handler)

Sets the grapher cleaner handler, which is called when SDM wants to remove its objects.

Parameters:

handler - the new handler

Since:

JViews 8.1

Internal: do not use!

customizeAllObjects

public void customizeAllObjects()

Recustomizes all the graphic objects corresponding to the data objects returned by the SDM model.

This method can be used instead of loadData() to update the display more quickly. As opposed to loadData(), the graphic objects are not re-created. Instead, the current style sheets are reapplied to the existing graphic objects.

This method is called by setStyleSheets(java.lang.String[],boolean,boolean) when the reload parameter is true and the recreate parameter is false.

Note that you do not usually need to call this method, since the SDM display is updated automatically when the data model or the style sheets are modified.

Since:

JViews 5.5

renderingDone

public void renderingDone()

This method calls the renderingDone method of the renderer.

getGraphic

public IlvGraphic getGraphic(Object object,
                             boolean createIfNeeded)

Returns the JViews graphic object associated with an application object. If the graphic object does not exist yet, and if createIfNeeded is true, then the graphic object is created.

Parameters:

object - The application object to translate into an IlvGraphic.

createIfNeeded - Specifies whether the graphic object should be created if it does not exist yet.

Returns:

graphic representation of object

getObject

public Object getObject(IlvGraphic graphic)

Returns the data object (that is, the object returned by the SDM model) associated with a graphic object, or null if the specified graphic object does not represent an object of the data model.

Parameters:

graphic - The graphic object.

Returns:

object represented by graphic

getObject

public Object getObject(IlvPoint p,
                        IlvManagerView view)

Returns the data object associated with the graphic object at a specified point in a manager view.

Parameters:

p - The location of the point in view coordinates.

view - The manager view.

Returns:

A data object (node or link) represented by the graphic object located at the specified point. If no object is represented at this location, the method returns null.

getObject

public Object getObject(IlvPoint p,
                        IlvManagerView view,
                        boolean traverse)

Returns the data object associated with the graphic object at a specified point in a manager view.

Parameters:

p - The location of the point in view coordinates.

view - The manager view.

traverse - If true, this method will recursively traverse the subgraphs to find the graphic object located at the specified point.

Returns:

A data object (node or link) represented by the graphic object located at the specified point. If no object is represented at this location, the method returns null.

Since:

JViews 5.5

setReferenceView

public void setReferenceView(IlvManagerView view)

Sets the reference view of this SDM engine.

Parameters:

view - The manager view.

getReferenceView

public IlvManagerView getReferenceView()

Returns the reference view of this SDM engine. If a reference view has been set using setReferenceView(ilog.views.IlvManagerView), this view is returned. Otherwise, the first view associated with the engine's grapher is returned. If the grapher has no view, the method returns null.

Returns:

reference view

getAllObjects

public Enumeration<?> getAllObjects()

Returns an enumeration of all the objects of the model (including all descendants of the top-level objects) in pre-order (that is, a parent is returned before its children).

Returns:

enumeration of all objects

isLinkNodeVisibilityCoupled

public boolean isLinkNodeVisibilityCoupled()

Returns true if the links are visible (if and only if origin and destination nodes are visible). Returns false if the links can be made visible or invisible independently of the visibility of their end nodes.

Returns:

true if link visibility is coupled with node visibility.

Since:

JViews 7.5

See Also:

setLinkNodeVisibilityCoupled(boolean)

setLinkNodeVisibilityCoupled

public void setLinkNodeVisibilityCoupled(boolean coupled)

Sets whether link visibility is coupled to node visibility.

If coupled, links are visible if and only if origin and destination nodes are visible. In this case, specifying the visibility of a link in CSS has no effect.

If uncoupled, links can be made visible or invisible independently from the visibility of their end nodes. In this case, it is possible to specify the visibility of links in CSS.

It is recommended to change this option only when the grapher of the engine is still empty.

Parameters:

coupled - If true, links are visible if and only if origin and destination nodes are visible.

Since:

JViews 7.5

See Also:

setLinkNodeVisibilityCoupled(boolean)

setHighlightingSelection

public void setHighlightingSelection(boolean yes)

Enables "selection by highlighting".

When selection by highlighting is enabled, the selected graphic objects are not shown using the usual square handles. Instead, the SDM engine fetches the properties to set on the graphic objects from the style sheet. The highlighting properties are fetched using the selected pseudo-class.

For example, the style sheet could contain the following rules:

 node:selected {
   foreground : "yellow";
 }

 link:selected {
   mode : "MODE_NEON";
 }
 

With these rules, the selected nodes will be yellow, and the selected links will be displayed with a neon-like gradient.

Parameters:

yes - If true, selected objects are highlighted. Otherwise, the usual JViews selection handles are used.

isHighlightingSelection

public boolean isHighlightingSelection()

Returns true if "selection by highlighting" is enabled, or false if the usual selection handles are used to show selected objects.

Returns:

true if highlighting selection is enabled

isResizingAllowed

public boolean isResizingAllowed()

Returns true if the user is allowed to resize nodes interactively.

Returns:

true if resizing is allowed

Since:

JViews 6.0

See Also:

setResizingAllowed(boolean)

setResizingAllowed

public void setResizingAllowed(boolean allowed)

Allows or forbids the user to resize nodes interactively.

Parameters:

allowed - If true, selected nodes have "handles" that the user can drag to resize them. If false, selected nodes have no handles, and the user can only move them.

Since:

JViews 6.0

updateObjectProperties

public void updateObjectProperties(Object object,
                                   String property,
                                   Object value,
                                   String[] pseudoClasses)

This method calls IlvSDMRenderer.updateObjectProperties(ilog.views.sdm.IlvSDMEngine, java.lang.Object, java.lang.String, java.lang.Object, java.lang.String[]) on the root renderer of the SDM engine.

Parameters:

object - The data object.

property - The name of the rendering property.

value - The new value of the property.

pseudoClasses - The pseudo classes of the object. This parameter can be null.

Since:

JViews 6.0

See Also:

IlvSDMRenderer.updateObjectProperties(ilog.views.sdm.IlvSDMEngine, java.lang.Object, java.lang.String, java.lang.Object, java.lang.String[])

setOpaqueMove

public void setOpaqueMove(boolean opaque)

Sets the Opaque Move mode of the select interactor attached to the views of this SDM engine.

Parameters:

opaque - The new Opaque Move mode.

Since:

JViews 5.0

See Also:

IlvSelectInteractor.setOpaqueMove(boolean)

isOpaqueMove

public boolean isOpaqueMove()

Returns the Opaque Move mode of the select interactor attached to the views of this SDM engine.

Returns:

true if move is opaque

Since:

JViews 5.0

See Also:

setOpaqueMove(boolean)

setLinkLayoutEnabledWhileMoving

public void setLinkLayoutEnabledWhileMoving(boolean enabled)

Enables or disables the automatic link layout while moving nodes. By default, the link layout is disabled while moving nodes. The link layout is performed only at the end of the move operation.

Parameters:

enabled - new value

Since:

JViews 6.0

See Also:

setLinkLayoutEnabled(boolean)

isLinkLayoutEnabledWhileMoving

public boolean isLinkLayoutEnabledWhileMoving()

Returns true if the automatic link layout is enabled while moving a node.

Returns:

true if link layout is enabled while moving

Since:

JViews 6.0

See Also:

setLinkLayoutEnabledWhileMoving(boolean), setLinkLayoutEnabled(boolean)

getRenderingDoneMode

public int getRenderingDoneMode()

Returns the flag that determines the way the IlvSDMRenderer.renderingDone(ilog.views.sdm.IlvSDMEngine) method is called on selection or property changes.

Returns:

rendering done mode

Since:

JViews 6.0

See Also:

setRenderingDoneMode(int)

setRenderingDoneMode

public void setRenderingDoneMode(int renderingDoneMode)

Determines the way the IlvSDMRenderer.renderingDone(ilog.views.sdm.IlvSDMEngine) method is called on selection or property changes.

The IlvSDMRenderer.renderingDone(ilog.views.sdm.IlvSDMEngine) method is always called when a graph is loaded, or when objects are created, deleted or moved by a user interaction. The IlvSDMRenderer.renderingDone(ilog.views.sdm.IlvSDMEngine) method is also always called at the end of an adjustment sequence (see setAdjusting(boolean)). Calling IlvSDMRenderer.renderingDone(ilog.views.sdm.IlvSDMEngine) will typically perform a graph or a link layout.

It may be necessary, though, to call this method also when an object is selected or deselected, or when a single property of a data object is changed. This flag determines whether IlvSDMRenderer.renderingDone(ilog.views.sdm.IlvSDMEngine) will be called in these cases or not.

• If renderingMode is IF_BBOX_CHANGED, the IlvSDMRenderer.renderingDone(ilog.views.sdm.IlvSDMEngine) method will be called on selection or property changes only if the bounding box of a graphic object has changed. This mode is the default, and is suitable for most cases, because the graph or link layout generally depends only on the position and size of the objects.
• If renderingMode is ALWAYS, the IlvSDMRenderer.renderingDone(ilog.views.sdm.IlvSDMEngine) method will be called on every selection or property change, even if no bounding boxes have changed. This mode can be used if the style sheet contains advanced settings such that the layout depends on the selected state or on a particular property value.
• If renderingMode is NEVER, the IlvSDMRenderer.renderingDone(ilog.views.sdm.IlvSDMEngine) method will never be called on selection or property changes. This mode can be used to get better performances, but you should use it only if you are sure that no relayout is necessary when an object is selected or when a property is changed.

Parameters:

renderingDoneMode - One of IF_BBOX_CHANGED, ALWAYS or NEVER.

Since:

JViews 6.0

See Also:

getRenderingDoneMode()

updateNodePositions

public void updateNodePositions()

Saves the positions of all the nodes in the data.

This is particularly useful if you use an automatic graphic layout algorithm (through the IlvGraphLayoutRenderer) to save the positions computed by the layout algorithm in the data model.

See Also:

IlvGraphLayoutRenderer.setSavingNodePositions(boolean)

updateNodePositions

public void updateNodePositions(Iterator<Object> nodes)

Saves the positions of nodes in the data.

This is particularly useful if you use an automatic graphic layout algorithm (through the IlvGraphLayoutRenderer) to save the positions computed by the layout algorithm in the data model.

Parameters:

nodes - The SDM model nodes to be handled.

Since:

JViews 8.8

See Also:

IlvGraphLayoutRenderer.setSavingNodePositions(boolean)

moveObject

public void moveObject(Object object,
                       IlvManagerView view,
                       double x,
                       double y,
                       boolean translate,
                       int alignment,
                       boolean redraw)

Moves or translates an object to a specified view position. The properties of the object are modified in the data model so that the graphic representation of the object appears at the new position. The position is specified in view coordinates.

If the object does not have a graphic representation, this method does nothing.

Parameters:

object - The data object to modify.

view - The manager view in which the object is moved. If view is non-null, the x and y coordinates are relative to that view. If view is null, the coordinates are relative to the top-level grapher.

x - The new horizontal position, in view coordinates.

y - The new vertical position, in view coordinates.

translate - If true, the object is just translated. In that case, the x and y parameters are the offsets by which the object is to be translated.

alignment - The alignment of the new bounding box of the object with respect to the point. This can be one of IlvDirection.Center, IlvDirection.Top, IlvDirection.Bottom, IlvDirection.Left, IlvDirection.Right, IlvDirection.TopLeft, IlvDirection.BottomLeft, IlvDirection.TopRight, or IlvDirection.BottomRight. If translate is true, this argument is ignored.

redraw - If true, the regions covered by the old and new positions of the object are refreshed.

Since:

JViews 5.5

moveObject

@Deprecated
public void moveObject(Object object,
                                   double x,
                                   double y,
                                   IlvTransformer t,
                                   int alignment,
                                   boolean redraw)

Deprecated. Beginning with JViews 2002, this method is deprecated because it does not work properly when the object is contained in a subgraph. Use the method moveObject(java.lang.Object,ilog.views.IlvManagerView,double,double,boolean,int,boolean) instead.

Moves an object to a specified view position. The properties of the object are modified in the data model so that the graphic representation of the object appears at the new position. The position is specified in view coordinates.

If the object does not have a graphic representation, this method does nothing.

Parameters:

object - The data object to modify.

x - The new horizontal position, in view coordinates.

y - The new vertical position, in view coordinates.

t - The transformer of the view.

alignment - The alignment of the new bounding box of the object with respect to the point. This can be one of IlvDirection.Center, IlvDirection.Top, IlvDirection.Bottom, IlvDirection.Left, IlvDirection.Right, IlvDirection.TopLeft, IlvDirection.BottomLeft, IlvDirection.TopRight, or IlvDirection.BottomRight.

redraw - If true, the regions covered by the old and new positions of the object are refreshed.

getSelectedObjects

public Enumeration<?> getSelectedObjects()

Returns an enumeration containing the data objects represented by the graphic objects currently selected in the grapher.

Returns:

selected object enumeration

See Also:

setAllSelectedObjects(Collection)

setSelected

public void setSelected(Object object,
                        boolean selected)

Selects or deselects the graphic object representing a specified data object.

Parameters:

object - The data object whose graphic representation must be selected or deselected.

selected - Specifies if the object must be selected or deselected.

setSelected

public void setSelected(Object[] objects,
                        boolean selected)

Selects or deselects the graphic objects representing the specified array of data objects.

Parameters:

objects - The data objects whose graphic representations must be selected or deselected.

selected - Specifies whether the objects must be selected or deselected.

Since:

JViews 8.0

See Also:

setAllSelectedObjects(Collection)

isSelected

public boolean isSelected(Object object)

Returns true if and only if the graphic representation of the specified object is selected.

Parameters:

object - The data object whose graphic representation's selected state is queried.

Returns:

true if object is selected

selectAllObjects

public void selectAllObjects()

Selects all the graphic objects that represent objects of the data model.

deselectAllObjects

public void deselectAllObjects()

Deselects all the graphic objects that represent objects of the data model.

setAllSelectedObjects

public void setAllSelectedObjects(Collection<?> objects)

Selects the graphic objects that represent the model objects given as arguments, and deselects all other graphic objects that represent objects of the data model.

Parameters:

objects - A set of data model objects.

Since:

JViews 8.5

See Also:

getSelectedObjects()

scrollToObject

public void scrollToObject(Object object)

Makes sure that an object is visible in the reference view of this SDM engine. If necessary, the reference view is scrolled so that the specified object is visible.

Parameters:

object - The object of the SDM data model that must be made visible.

Since:

JViews 6.0

getSelectionPseudoClass

public String getSelectionPseudoClass()

Returns the pseudo-class used to style selected objects. Default is "selected"

Returns:

pseudo-class for selection

Since:

JViews 6.0

See Also:

setSelectionPseudoClass(java.lang.String)

setSelectionPseudoClass

public void setSelectionPseudoClass(String selectionPseudoClass)

Changes the pseudo-class used to style selected objects.

The default selection pseudo-class is "selected", so selected objects can be styled differently from non-selected objects by adding rules like this in the style sheet:

 node:selected {
     foreground : "red";
 }
 

You do not usually need to change the selection pseudo-class; this method is reserved for advanced uses.

Parameters:

selectionPseudoClass - The new pseudo-class used to style selected objects. If this parameter is null, the default pseudo-class ("selected") is restored.

Since:

JViews 6.0

setDropToGroupEnabled

public void setDropToGroupEnabled(boolean enabled)

Specifies whether or not dropping or duplicating a node in an existing subgraph will make the node a child of this subgraph. This option affects:

• The creation of nodes by the IlvMakeSDMNodeInteractor and IlvSDMDropTarget classes,
• The duplication of nodes by the paste() and duplicate() methods.

Parameters:

enabled - If true, dropping or duplicating a node in an existing subgraph will make the node a child of this subgraph. Otherwise, the node is added at the top level of the graph.

Since:

JViews 5.5

isDropToGroupEnabled

public boolean isDropToGroupEnabled()

Returns true if dropping or duplicating a node in an existing subgraph will make the node a child of this subgraph, or false otherwise.

Returns:

true if drop to group is enabled

Since:

JViews 5.5

See Also:

setDropToGroupEnabled(boolean)

getParent

public Object getParent(IlvManagerView view,
                        double x,
                        double y,
                        boolean managerCoordinates)

Returns the parent object located at the specified coordinates in the view. This method is called when isDropToGroupEnabled() returns true, to find the parent group in which a new node is created.

Parameters:

view - The manager view.

x - The X-coordinate of the point where the new object is dropped.

y - The Y-coordinate of the point where the new object is dropped.

managerCoordinates - If this parameter is true, the x and y parameters are considered as manager coordinates. Otherwise, they are considered as view coordinates.

Returns:

parent object

Since:

JViews 5.5

setAdjusting

public void setAdjusting(boolean adjusting)

Starts or stops an editing sequence.

This method is used to tell the SDM engine that a sequence of modifications of the data model should be considered as a whole. The SDM engine will then be able to optimize its internal updating mechanism, and will render the changes more efficiently at the end of the editing sequence.

Editing sequences can be nested. For example, consider the following calls:

    engine.setAdjusting(true);
    // edit data model...
    engine.setAdjusting(true);
    // more edits of the data model...
    engine.setAdjusting(false);
    engine.setAdjusting(false);
 

The engine will update the display only on the last setAdjusting(false) call.

Calls to setAdjusting(true) and setAdjusting(false) must be balanced.

Parameters:

adjusting - If true, and if the engine was not already in an editing sequence, a new sequence is started. If false, and if this call matches the first setAdjusting(true), then the editing sequence ends, and the engine updates the display.

clearAdjusting

public void clearAdjusting()

Stops an editing sequence and prevents JViews Diagrammer from performing any computation regarding the changes.

Use this method instead of setAdjusting(false) to validate model changes without spending time refreshing the modified objects. For example, call this method when the changes do not impact the graphical representations.

Since:

JViews 8.1

See Also:

setAdjusting(boolean)

isAdjusting

public boolean isAdjusting()

Returns true if and only if the SDM engine is currently in an editing sequence.

Returns:

true if adjusting

See Also:

setAdjusting(boolean)

copy

public void copy()

Copies the selected objects of the data model to the system clipboard. The objects are saved to the clipboard as an XML string.

cut

public void cut()

Copies the selected objects of the data model to the system clipboard, and removes them from the data model.

paste

public void paste()

Reads the data objects currently contained in the system clipboard (as an XML string) and adds them to the data model.

If isDropToGroupEnabled() returns true, and if only one subgraph is selected, the pasted objects are created as children of the selected subgraph. If isDropToGroupEnabled() returns true, and several objects are selected, the pasted objects are created as children of the common ancestor of the selected objects. If isDropToGroupEnabled() returns false, or if no objects are selected, the pasted objects are created at the top level of the graph.

The graphic representations of the new objects are selected and translated down and to the right by 20 pixels.

duplicate

public void duplicate()

Duplicates the selected data objects.

If isDropToGroupEnabled() returns true, the duplicated objects are created as children of the common ancestor of the selected objects. If isDropToGroupEnabled() returns false, or if no objects are selected, the duplicated objects are created at the top level of the graph.

The graphic representations of the new objects are selected and translated down and to the right by 20 pixels.

setEmptySubgraphAllowed

public void setEmptySubgraphAllowed(boolean allowed)

Allows or disallows empty subgraphs. If empty subgraphs are not allowed, when deleting selected objects, the IlvSDMEngine also removes their empty parent subgraphs. This is the default behavior.

Since:

JViews 8.7

See Also:

isEmptySubgraphAllowed()

isEmptySubgraphAllowed

public boolean isEmptySubgraphAllowed()

Returns true if empty subgraphs are allowed.

Returns:

true if empty subgraphs are allowed.

Since:

JViews 8.7

See Also:

setEmptySubgraphAllowed(boolean)

delete

public void delete()

Removes the selected objects. When removing objects in a subgraph, if empty subgraphs are not allowed, this function also remove the parents subgraph of the deleted objects if they become empty.

group

public void group(Object parent)

Groups the selected objects.

This method makes the selected objects children of the specified parent object.

Parameters:

parent - The object that will become the parent of the new group. Note: The parent must not have already been added to the data model. This method will add it itself.

ungroup

public void ungroup()

Ungroups the selected objects.

The children of each selected object(s) are removed from the data model, and added back at the top level of the model (that is, with a null parent).

Note that the parent objects are removed from the data model.

getStringFromClipboard

public String getStringFromClipboard()

For internal use only.

Returns:

clipboard

Internal: do not use!

putStringToClipboard

public void putStringToClipboard(String data)

For internal use only.

Parameters:

data -

Internal: do not use!

canPaste

public boolean canPaste()

Returns true if data has been copied to the clipboard through the cut() or copy() methods.

Returns:

true if can paste

Since:

JViews 6.0

getNodeLayoutRenderer

public IlvGraphLayoutRenderer getNodeLayoutRenderer()

Returns the graph layout renderer that is responsible for the layout of nodes.

Returns:

The node layout renderer, or null if no node layout renderer is attached to this SDM engine.

Since:

JViews 5.5

setNodeLayoutEnabled

public void setNodeLayoutEnabled(boolean enabled)

Enables or disables the automatic layout of nodes. If the current style sheet does not specify a layout algorithm for nodes, this method does nothing.

Parameters:

enabled - If true, the node layout algorithm will be enabled; otherwise it will be disabled.

isNodeLayoutEnabled

public boolean isNodeLayoutEnabled()

Returns the enabled state of the automatic layout algorithm for nodes. If the current style sheet does not specify a layout algorithm for nodes, this method returns false.

Returns:

true if node layout is enabled

performNodeLayout

public void performNodeLayout()

Performs a layout algorithm on the nodes of the graph.

This method is useful to perform a "one-shot" layout on the nodes of the graph. It is useful only if the SDM style sheet specifies a node layout algorithm.

Note: In versions prior to JViews 5.5, this method performed an incremental layout if some nodes were selected and the layout algorithm was a hierarchical layout. This is no longer true beginning with JViews 5.5.

getLinkLayoutRenderer

public IlvGraphLayoutRenderer getLinkLayoutRenderer()

Returns the graph layout renderer that is responsible for the layout of links.

Returns:

The link layout renderer, or null if no link layout renderer is attached to this engine.

Since:

JViews 5.5

setLinkLayoutEnabled

public void setLinkLayoutEnabled(boolean enabled)

Enables or disables the automatic layout of links. If the current style sheet does not specify a layout algorithm for links, this method does nothing.

Parameters:

enabled - If true, the link layout algorithm will be enabled; otherwise it will be disabled.

isLinkLayoutEnabled

public boolean isLinkLayoutEnabled()

Returns the enabled state of the automatic layout algorithm for links. If the current style sheet does not specify a layout algorithm for links, this method returns false.

Returns:

true if link layout is enabled

performLinkLayout

public void performLinkLayout()

Performs a layout algorithm on the links of the graph.

This method is useful to perform a "one-shot" layout on the links of the graph. It is useful only if the SDM style sheet specifies a link layout algorithm, and if the link layout is not enabled by default.

getLabelLayoutRenderer

public IlvLabelLayoutRenderer getLabelLayoutRenderer()

Returns the graph layout renderer that is responsible for the layout of labels.

Returns:

The label layout renderer, or null if no label layout renderer is attached to this engine.

Since:

JViews 5.5

setLabelLayoutEnabled

public void setLabelLayoutEnabled(boolean enabled)

Enables or disables the automatic layout of labels. If the current style sheet does not specify a graph layout algorithm for labels, this method does nothing.

Parameters:

enabled - If true, the label layout algorithm will be enabled; otherwise it will be disabled.

Since:

JViews 5.0

isLabelLayoutEnabled

public boolean isLabelLayoutEnabled()

Returns the enabled state of the automatic layout algorithm for labels. If the current style sheet does not specify a layout algorithm for labels, this method returns false.

Returns:

true if label layout is enabled

Since:

JViews 5.0

performLabelLayout

public void performLabelLayout()

Performs a graph layout algorithm on the labels of the graph.

This method is useful to perform a "one-shot" layout on the labels of the graph. It is useful only if the SDM style sheet specifies a label layout algorithm, and if the label layout is not enabled by default.

Since:

JViews 5.0

setLayoutRunning

public void setLayoutRunning(boolean running)

Sets the flag indicating that a layout algorithm is running. This method is for internal use; you should not call it directly.

Parameters:

running - The new value of the flag.

Since:

JViews 5.5

isLayoutRunning

public boolean isLayoutRunning()

Returns the flag indicating that a layout algorithm is running.

Returns:

true if layout is in progress

Since:

JViews 5.5

setMetadataEnabled

public void setMetadataEnabled(boolean on)

Controls whether metadata are enabled or not. If the argument is true, an IlvRDFSDMModel is added to the model pipeline to handle metadata. Metadata are identified as namespaced property names (for example "sdm:x"). Note that metadata are automatically enabled if an XML file is loaded and it contains RDF descriptions. WARNING: This method should be called before the model is indeed loaded, because metadata are dispatched to a special SDM model. Also, when turned off during a session, the loaded metadata are no longer reachable.

Parameters:

on - Enables metadata if true, and disables metadata if false.

Since:

JViews 5.5

See Also:

IlvRDFSDMModel, isMetadataEnabled()

isMetadataEnabled

public boolean isMetadataEnabled()

Returns true if metadata are enabled.

Returns:

true if using metadata

Since:

JViews 5.5

See Also:

setMetadataEnabled(boolean)

addSDMEngineDataLoadingListener

public void addSDMEngineDataLoadingListener(SDMEngineDataLoadingListener listener)

Adds an SDMEngineDataLoadingListener to this SDM engine.

Parameters:

listener - The listener to add.

removeSDMEngineDataLoadingListener

public void removeSDMEngineDataLoadingListener(SDMEngineDataLoadingListener listener)

Removes an SDMEngineDataLoadingListener from this SDM engine.

Parameters:

listener - The listener to remove.

addSDMEngineStyleSheetListener

public void addSDMEngineStyleSheetListener(SDMEngineStyleSheetListener listener)

Adds an SDMEngineStyleSheetListener to this SDM engine.

Parameters:

listener - The listener to add.

removeSDMEngineStyleSheetListener

public void removeSDMEngineStyleSheetListener(SDMEngineStyleSheetListener listener)

Removes an SDMEngineStyleSheetListener from this SDM engine.

Parameters:

listener - The listener to remove.

addSDMEngineSelectionListener

public void addSDMEngineSelectionListener(SDMEngineSelectionListener listener)

Adds an SDMEngineSelectionListener to this SDM engine.

Parameters:

listener - The listener to add.

Since:

JViews 6.0

removeSDMEngineSelectionListener

public void removeSDMEngineSelectionListener(SDMEngineSelectionListener listener)

Removes an SDMEngineSelectionListener from this SDM engine.

Parameters:

listener - The listener to remove.

Since:

JViews 6.0

processServerAction

public boolean processServerAction(int x,
                                   int y,
                                   IlvManagerView view)

This method can be called when the SDM engine is used on the server-side of a web application, to process an action sent by the client-side. Typically, this method is called by the Java Server Faces Diagrammer component when the user clicks on the generated image of the graph in his web browser.

The SDM engine will call the IlvSDMRenderer.processServerAction(int, int, ilog.views.IlvManagerView) method of the renderer chain. Each renderer will decide if and how it wishes to process the action.

Parameters:

x - The X coordinate of the point where the user clicked on the client-side, in view coordinates.

y - The y coordinate of the point where the user clicked on the client-side, in view coordinates.

view - The view used to render the graph image.

Returns:

true if the action was processed, false if the action was not processed.

Since:

JViews 6.5

getCSSInternal

public Object getCSSInternal()

This method is for internal use; you should not call it directly.

Specified by:

getCSSInternal in interface ilog.views.util.cssbeans.IlvCSSCompatible

Since:

JViews 7.5

Internal: do not use!