IlvGrapherAdapter Class Reference

An IlvGrapherAdapter encapsulates an IlvGrapher and provides a bridge between the API of the IlvGrapher and the API of the IlvGraphModel. More...

#include <ilviews/layout/gphadapt.h>

Inheritance diagram for IlvGrapherAdapter:

List of all members.

Public Member Functions
	IlvGrapherAdapter (IlvGrapher *grapher)
	Creates a new grapher adapter for a given IlvGrapher.
virtual	~IlvGrapherAdapter ()
	Destructor.
void	addLayer (IlvManagerLayer *layer)
	Adds a manager layer to the list of layers to be used during the layout.
void	boundingBox (IlAny nodeOrLink, IlvRect &rect)
	Updates the rect argument with the bounding box of a node or a link in manager coordinates.
void	ensureReshapeableLinks (IlvGraphLayout *layout)
	Ensures that all the links in the grapher can be reshaped to a polyline shape.
void	ensureStraightLineLinks (IlvGraphLayout *layout)
	Ensures that all the links in the grapher can be reshaped to straight-line links.
IlvLayoutGraphicFilter *	getFilter () const
	Returns the filter (if any). Returns 0 otherwise.
IlvMgrView *	getFirstManagerView () const
	Returns the first manager view attached to the encapsulated IlvGrapher if any, and null otherwise.
IlAny	getFrom (IlAny link)
	Returns the origin node of a link.
IlvGrapher *	getGrapher () const
	Returns the IlvGrapher encapsulated by the adapter.
const IlArray &	getLayers () const
	Returns an enumeration of the manager layers to be taken into account during the layout.
IlvPoint	getLinkPointAt (IlAny link, IlUInt index)
	Returns the point of a link at a specified index.
IlvPoint *	getLinkPoints (IlAny link, IlUInt &count)
	Returns the points that define a link.
IlInt	getLinkPointsCount (IlAny link)
	Returns the number of points of a link.
IlList *	getLinks (IlAny node)
	Returns an enumeration of all the links that have node as their origin or destination.
IlList *	getLinks ()
	Returns an enumeration of the links.
IlUInt	getLinksCountOf (IlAny node)
	Returns the number of links adjacent to node.
IlList *	getLinksFrom (IlAny node)
	Returns an enumeration of all the links that have node as their origin.
IlUInt	getLinksFromCount (IlAny node)
	Returns the number of links that have node as their origin.
IlList *	getLinksTo (IlAny node)
	Returns an enumeration of all the links that have node as their destination.
IlUInt	getLinksToCount (IlAny node)
	Returns the number of links that have node as their origin.
IlUInt	getLinkWidth (IlAny link)
	Returns the width of the link.
virtual const char *	getMessage (const char *message) const
	Returns the message string associated with the message identifier key.
IlList *	getNeighbors (IlAny node)
	Returns an enumeration of all the nodes that are the "neighbors" of node; in other words, the nodes that have a common link with node.
virtual IlList *	getNodes ()
	Returns an enumeration of the nodes.
IlList *	getNodesAndLinks ()
	Returns an enumeration of the nodes and links.
IlAny	getOpposite (IlAny link, IlAny node)
	Returns the opposite node of a link.
IlAny	getProperty (IlAny nodeOrLink, const char *key)
	Returns the value of a property.
IlvTransformer *	getReferenceTransformer ()
	Returns the transformer to be taken into account.
virtual IlvMgrView *	getReferenceView () const
	Returns the specified reference view (if any).
IlAny	getTo (IlAny link)
	Returns the destination node of a link.
IlBoolean	hasProperty (IlAny nodeOrLink, const char *key)
	Returns IlTrue if the property exists and IlFalse otherwise.
IlBoolean	isLink (IlAny obj)
	Returns IlTrue if an object is a valid link and IlFalse otherwise.
IlBoolean	isLinkBetween (IlAny node1, IlAny node2)
	Tests whether a link exists between two nodes.
IlBoolean	isNode (IlAny obj)
	Returns IlTrue if an object is a valid node and IlFalse otherwise.
void	moveNode (IlAny node, IlInt x, IlInt y, IlBoolean reDraw)
	Changes the position of the specified node. The x and y coordinates correspond to the top-left corner of the rectangle that defines the node.
IlBoolean	removeAllLayers ()
	Removes all manager layers from the list of layers to be used during the layout.
IlBoolean	removeLayer (IlvManagerLayer *layer)
	Removes a manager layer from the list of layers to be used during the layout.
void	reshapeLink (IlAny link, IlvPoint fromPoint, IlvPoint *points, IlUInt startIndex, IlUInt length, IlvPoint toPoints, IlBoolean reDraw)
	Reshapes all the points of a link, including the connection points on the origin and destination nodes.
void	setFilter (IlvLayoutGraphicFilter *filter)
	Allows you to specify a filter on the nodes and links.
void	setProperty (IlAny nodeOrLink, const char *key, IlAny value)
	Sets the value of a property for a node or a link.
void	setReferenceTransformer (IlvTransformer *t)
	Allows you to specify the reference transformer.
virtual void	setReferenceView (IlvMgrView *view=0)
	Allows you to specify the reference manager view.
Protected Member Functions
void	afterAnimationStep ()
	Notifies the grapher adapter that a layout animation step has finished.
void	afterLayout (IlvGraphLayout *layout, IlvGraphLayoutReport *layoutReport, IlBoolean reDraw)
	Notifies the grapher adapter that a layout session has finished.
void	beforeAnimationStep ()
	Notifies the grapher adapter that a layout animation step has been started.
void	beforeLayout (IlvGraphLayout *layout, IlBoolean redraw)
	Notifies the grapher adapter that a layout session has been started.

---

Detailed Description

An IlvGrapherAdapter encapsulates an IlvGrapher and provides a bridge between the API of the IlvGrapher and the API of the IlvGraphModel.

Library: ilvlayout

IlvGrapherAdapter is a concrete subclass of IlvGraphModel that allows an IlvGrapher to be laid out using the layout algorithms provided in Rogue Wave Views. It provides an implementation for all the abstract methods of IlvGraphModel. It also provides overridden implementations of some non-abstract methods of IlvGraphModel in order to improve the efficiency by taking advantage of the particularities of the IlvGrapher.

If an application uses the class IlvGrapher, the grapher can be attached directly to the layout instance without explicitly using a graph model (see the method IlvGraphLayout::attach(IlvGrapher*)). In this case, an IlvGrapherAdapter will be internally created. This adapter can be retrieved using the method IlvGraphLayout::getGraphModel(), which will return an instance of IlvGrapherAdapter.

---

Constructor & Destructor Documentation

IlvGrapherAdapter::IlvGrapherAdapter

(

IlvGrapher *

grapher

)

Creates a new grapher adapter for a given IlvGrapher.

Parameters:

grapher

The Rogue Wave Views grapher.

---

Member Function Documentation

void IlvGrapherAdapter::addLayer

(

IlvManagerLayer *

layer

)

Adds a manager layer to the list of layers to be used during the layout.

If you do not call this method, all the layers of the grapher are taken into account. Note that, in this case, getLayers() returns an empty array.

Parameters:

layer

The layer to be added.

See also:

removeLayer

removeAllLayers

getLayers

Returns:

IlTrue if the layer is in the list of layers to be used; IlFalse if the layer is not in the list of layers or if the list of layers is empty.

void IlvGrapherAdapter::afterAnimationStep

(

)

[protected, virtual]

Notifies the grapher adapter that a layout animation step has finished.

If appropriate, this method is called by the layout algorithm after each animation step. The method redraws all the views of the grapher.

See also:

beforeAnimationStep

Reimplemented from IlvGraphModel.

void IlvGrapherAdapter::afterLayout	(	IlvGraphLayout *	layout,
		IlvGraphLayoutReport *	layoutReport,
		IlBoolean	reDraw
	)			[protected, virtual]

Notifies the grapher adapter that a layout session has finished.

This method is always called by IlvGraphLayout::performLayout after the method IlvGraphLayout::layout has finished.

Warning:

[note] You can detect if the layout was performed successfully using the test layoutReport->getCode() == IlvGraphLayoutReport::LayoutDone.

The method IlvGrapher::reDraw() is called on the encapsulated grapher if the argument reDraw is IlTrue.

Parameters:

	layout	The layout instance origin of the notification.
	layoutReport	The layout report.
	reDraw	If IlTrue, all the views of the encapsulated grapher are redrawn.

See also:

beforeLayout

Reimplemented from IlvGraphModel.

void IlvGrapherAdapter::beforeAnimationStep

(

)

[protected, virtual]

Notifies the grapher adapter that a layout animation step has been started.

If appropriate, this method is called by the layout algorithm before each animation step.

See also:

afterAnimationStep

Reimplemented from IlvGraphModel.

void IlvGrapherAdapter::beforeLayout	(	IlvGraphLayout *	layout,
		IlBoolean	redraw
	)			[protected, virtual]

Notifies the grapher adapter that a layout session has been started.

This method is always called by IlvGraphLayout::performLayout before the call to the method IlvGraphLayout::layout.

The default implementation of the method does nothing.

Parameters:

	layout	The layout instance origin of the notification.
	reDraw	If IlTrue, the layout algorithm will call, after the layout, the method afterLayout with the reDraw argument at IlTrue.

See also:

afterLayout

Reimplemented from IlvGraphModel.

void IlvGrapherAdapter::boundingBox	(	IlAny	nodeOrLink,
		IlvRect &	rect
	)			[virtual]

Updates the rect argument with the bounding box of a node or a link in manager coordinates.

If the object is zoomable, it returns the bounding box in manager coordinates by calling IlvGraphic::boundingBox(IlvRect&). For nonzoomable objects, it computes the bounding box according to the current transformer (see the method getReferenceTransformer) and returns a rectangle obtained by applying the inverse transformation to the rectangle.

Parameters:

	nodeOrLink	The node or link for which we want the bounding box.
	rect	The rectangle that will be updated.

Implements IlvGraphModel.

void IlvGrapherAdapter::ensureReshapeableLinks

(

IlvGraphLayout *

layout

)

[virtual]

Ensures that all the links in the grapher can be reshaped to a polyline shape.

This method is called by layout algorithms that need to reshape the links. See also the method IlvGraphLayout::isLinkReplacementAllowed.

The method replaces all the links of the grapher that cannot be reshaped to a polyline shape with a new link of type IlvPolylineLinkImage, without any intermediate points. The following link classes are replaced:

• IlvLinkImage,
• IlvOneLinkImage (and all subclasses),
• IlvDoubleLinkImage (and all subclasses).

If a link is replaced, the following attributes of the old link are copied to the new link:

• orientation,
• foreground color,
• line width,
• line join,
• maximum line width,
• end cap,
• line style.

Parameters:

layout

The layout algorithm that needs reshapeable links.

See also:

ensureStraightLineLinks

IlvGraphLayout::isLinkReplacementAllowed

IlvGraphLayout::isLinkConnectorReplacementAllowed

Reimplemented from IlvGraphModel.

void IlvGrapherAdapter::ensureStraightLineLinks

(

IlvGraphLayout *

layout

)

[virtual]

Ensures that all the links in the grapher can be reshaped to straight-line links.

This method is called by layout algorithms that need straight-line links. See also the method IlvGraphLayout::isLinkReplacementAllowed.

The method replaces all the links of the grapher that cannot be reshaped to a straight-line shape with new links of type IlvPolylineLinkImage without any intermediate points. The following link classes are replaced:

• IlvOneLinkImage (and all subclasses),
• IlvDoubleLinkImage (and all subclasses).

If a link is replaced, the following attributes of the old link are copied to the new link:

• orientation,
• foreground color,
• line width,
• line join,
• maximum line width,
• end cap,
• line style.

The method also removes any link connectors of type IlvGrapherPin from the nodes.

Parameters:

layout

The layout algorithm that needs straight-line links.

See also:

ensureReshapeableLinks

IlvGraphLayout::isLinkReplacementAllowed

IlvGraphLayout::isLinkConnectorReplacementAllowed

Reimplemented from IlvGraphModel.

IlvLayoutGraphicFilter* IlvGrapherAdapter::getFilter

(

)

const

Returns the filter (if any). Returns 0 otherwise.

See also:

setFilter(IlvLayoutGraphicFilter*)

IlAny IlvGrapherAdapter::getFrom

(

IlAny

link

)

[virtual]

Returns the origin node of a link.

See also:

getTo(IlAny)

Implements IlvGraphModel.

const IlArray& IlvGrapherAdapter::getLayers

(

)

const

Returns an enumeration of the manager layers to be taken into account during the layout.

If you do not specify any layers using the method addLayer(IlvManagerLayer*), all layers in the encapsulated IlvGrapher are used. In this case, this method returns an empty array.

See also:

addLayer

removeLayer

removeAllLayers

Returns:

An enumeration of the manager layers (IlvManagerLayer instances) to be taken into account during the layout. Returns an empty array if the list of layers to be used is empty.

IlvPoint IlvGrapherAdapter::getLinkPointAt	(	IlAny	link,
		IlUInt	index
	)			[virtual]

Returns the point of a link at a specified index.

Parameters:

	link	The link.
	index	The index in the points array.

Reimplemented from IlvGraphModel.

IlvPoint* IlvGrapherAdapter::getLinkPoints	(	IlAny	link,
		IlUInt &	count
	)			[virtual]

Returns the points that define a link.

Parameters:

	link	The link.
	count	The number of points is set in this argument.

Implements IlvGraphModel.

IlInt IlvGrapherAdapter::getLinkPointsCount

(

IlAny

link

)

[virtual]

Returns the number of points of a link.

Parameters:

link

The link for which we want to know the number of points.

Implements IlvGraphModel.

IlList* IlvGrapherAdapter::getLinks

(

IlAny

node

)

[virtual]

Returns an enumeration of all the links that have node as their origin or destination.

Parameters:

node

The node.

Warning:

[note] You have to destroy the returned list.

Reimplemented from IlvGraphModel.

IlList* IlvGrapherAdapter::getLinks

(

)

[virtual]

Returns an enumeration of the links.

It calls the method IlvGrapher::getObjects() on the encapsulated grapher and skips all the elements that are not links.

Note that, because the nodes and the links are not stored separately in the IlvGrapher, browsing all elements returned by this method is no more efficient than browsing them using the enumeration returned by the method getNodesAndLinks.

Warning:

[note] You have to destroy the returned list.

Implements IlvGraphModel.

IlUInt IlvGrapherAdapter::getLinksCountOf

(

IlAny

node

)

[virtual]

Returns the number of links adjacent to node.

Parameters:

node

The node.

See also:

getLinks(IlAny)

getLinksFromCount

getLinksToCount

Reimplemented from IlvGraphModel.

IlList* IlvGrapherAdapter::getLinksFrom

(

IlAny

node

)

[virtual]

Returns an enumeration of all the links that have node as their origin.

Parameters:

node

The node.

Warning:

[note] You have to destroy the returned list.

Implements IlvGraphModel.

IlUInt IlvGrapherAdapter::getLinksFromCount

(

IlAny

node

)

[virtual]

Returns the number of links that have node as their origin.

Parameters:

node

The node.

Reimplemented from IlvGraphModel.

IlList* IlvGrapherAdapter::getLinksTo

(

IlAny

node

)

[virtual]

Returns an enumeration of all the links that have node as their destination.

The method may return an empty list if there are no links.

Parameters:

node

The node.

Warning:

[note] You have to destroy the returned list.

Implements IlvGraphModel.

IlUInt IlvGrapherAdapter::getLinksToCount

(

IlAny

node

)

[virtual]

Returns the number of links that have node as their origin.

Parameters:

node

The node.

Reimplemented from IlvGraphModel.

IlUInt IlvGrapherAdapter::getLinkWidth

(

IlAny

link

)

[virtual]

Returns the width of the link.

Parameters:

link

The link for which we want to know the width.

Reimplemented from IlvGraphModel.

virtual const char* IlvGrapherAdapter::getMessage

(

const char *

message

)

const [virtual]

Returns the message string associated with the message identifier key.

Parameters:

key

The message identifier searched for.

Implements IlvGraphModel.

IlList* IlvGrapherAdapter::getNeighbors

(

IlAny

node

)

[virtual]

Returns an enumeration of all the nodes that are the "neighbors" of node; in other words, the nodes that have a common link with node.

Parameters:

node

The node.

Note that a neighbor node will be contained in the enumeration the same number of times as the number of links between node and this neighbor.

Warning:

[note] You have to destroy the returned list.

Reimplemented from IlvGraphModel.

virtual IlList* IlvGrapherAdapter::getNodes

(

)

[virtual]

Returns an enumeration of the nodes.

It calls the method IlvGrapher::getObjects() on the encapsulated grapher and skips all the elements that are not nodes.

Note that, because the nodes and the links are not stored separately in the IlvGrapher, browsing all elements returned by this method is no more efficient than browsing them using the enumeration returned by the method getNodesAndLinks.

Warning:

[note] You have to destroy the returned list.

Implements IlvGraphModel.

IlList* IlvGrapherAdapter::getNodesAndLinks

(

)

[virtual]

Returns an enumeration of the nodes and links.

See also:

getNodes

getLinks

Note that graphic objects that are stored by the encapsulated grapher but are not nodes or links are not skipped by this enumeration. Use the methods isNode(IlAny) and isLink(IlAny) to skip them.

Warning:

[note] You have to destroy the returned list.

Reimplemented from IlvGraphModel.

IlAny IlvGrapherAdapter::getProperty	(	IlAny	nodeOrLink,
		const char *	key
	)			[virtual]

Returns the value of a property.

The method returns 0 if the property does not exist.

Parameters:

	nodeOrLink	The node or link for which the property is to be set
	key	The key string for the property

See also:

setProperty

Reimplemented from IlvGraphModel.

IlvTransformer* IlvGrapherAdapter::getReferenceTransformer

(

)

Returns the transformer to be taken into account.

This method returns the transformer specified using setReferenceTransformer(IlvTransformer*) if this transformer is not equal to 0.
Otherwise, it returns the current transformer of the manager view specified using setReferenceView(IlvMgrView*) (if any).
Otherwise, it returns the current transformer of the first manager view attached to the grapher (as returned by the method IlvManager::getViews()).
Otherwise, it returns an identity transformer.

See also:

setReferenceTransformer(IlvTransformer*)

getReferenceView

Warning:

[note] You should not modify the transformer returned by this method.

virtual IlvMgrView* IlvGrapherAdapter::getReferenceView

(

)

const [virtual]

Returns the specified reference view (if any).

See also:

setReferenceView

setReferenceTransformer(IlvTransformer*)

IlAny IlvGrapherAdapter::getTo

(

IlAny

link

)

[virtual]

Returns the destination node of a link.

See also:

getFrom(IlAny)

Implements IlvGraphModel.

IlBoolean IlvGrapherAdapter::hasProperty	(	IlAny	nodeOrLink,
		const char *	key
	)			[virtual]

Returns IlTrue if the property exists and IlFalse otherwise.

Parameters:

	nodeOrLink	The node or link for which the property is to be set.
	key	The key string for the property.

See also:

setProperty(IlAny, const char*, IlAny)

getProperty(IlAny, const char*)

Reimplemented from IlvGraphModel.

IlBoolean IlvGrapherAdapter::isLink

(

IlAny

obj

)

[virtual]

Returns IlTrue if an object is a valid link and IlFalse otherwise.

An object is not valid in one of the following cases:

• It is not a link that belongs to the encapsulated grapher.
• It is rejected by the filter (if any).
• It is not on a specified layer (if any).

Parameters:

obj

The object to test.

Implements IlvGraphModel.

IlBoolean IlvGrapherAdapter::isNode

(

IlAny

obj

)

[virtual]

Returns IlTrue if an object is a valid node and IlFalse otherwise.

An object is not valid in one of the following cases:

• It is not a node that belongs to the encapsulated grapher.
• It is rejected by the filter (if any).
• It is not on a specified layer (if any).

Parameters:

obj

The object to test.

Implements IlvGraphModel.

void IlvGrapherAdapter::moveNode	(	IlAny	node,
		IlInt	x,
		IlInt	y,
		IlBoolean	reDraw
	)			[virtual]

Changes the position of the specified node. The x and y coordinates correspond to the top-left corner of the rectangle that defines the node.

Parameters:

	node	The node.
	x	The new x-position.
	y	The new y-position.
	reDraw	If IlTrue, the node is redrawn.

See also:

boundingBox(IlAny, IlvRect&)

Implements IlvGraphModel.

IlBoolean IlvGrapherAdapter::removeAllLayers

(

)

Removes all manager layers from the list of layers to be used during the layout.

All layers will be taken into account. Note that, in this case, getLayers() returns an empty array.

See also:

addLayer

removeLayer

getLayers

Returns:

IlFalse if there are no layers to be removed and IlTrue otherwise.

IlBoolean IlvGrapherAdapter::removeLayer

(

IlvManagerLayer *

layer

)

Removes a manager layer from the list of layers to be used during the layout.

Parameters:

layer

The layer to be removed.

See also:

addLayer

removeAllLayers

getLayers

Returns:

IlTrue if the layer is in the list of layers to be used; IlFalse if the layer is not in the list of layers or if the list of layers is empty.

void IlvGrapherAdapter::reshapeLink	(	IlAny	link,
		IlvPoint	fromPoint,
		IlvPoint *	points,
		IlUInt	startIndex,
		IlUInt	length,
		IlvPoint	toPoints,
		IlBoolean	reDraw
	)			[virtual]

Reshapes all the points of a link, including the connection points on the origin and destination nodes.

If the new shape of the link must be a straight line, without any intermediate points, call the method with 0 for the points argument. In this case, the values of the arguments startIndex and length are ignored.

Note that the effect of this method depends on the type of the link. For the following link types the reshaping of the intermediate points has no effect:

• IlvLinkImage,
• IlvOneLinkImage,
• IlvDoubleLinkImage,
• IlvOneSplineLinkImage,
• IlvDoubleSplineLinkImage.

Parameters:

	link	The link to be reshaped
	fromPoint	The connection point of the link on the origin node. If 0, the connection point is not moved.
	points	The intermediate points of the link (ordered from origin node to destination node). If 0, all the intermediate points of the link are removed.
	startIndex	The start position in the array of points.
	length	The number of intermediate points.
	toPoint	The connection point of the link on the destination node. If 0, the connection point is not moved.
	reDraw	If IlTrue, the link is redrawn.

See also:

ensureStraightLineLinks

ensureReshapeableLinks

Implements IlvGraphModel.

void IlvGrapherAdapter::setFilter

(

IlvLayoutGraphicFilter *

filter

)

Allows you to specify a filter on the nodes and links.

Using a filter allows you to perform the layout on a part of a grapher. To do this, methods such as getNodes, getLinks, getNeighbors, and so on return enumerations of only the nodes or links that are accepted by the filter (if any).

To remove the filter, call this method with an argument equal to 0.

Parameters:

filter

The new filter.

See also:

getFilter

Warning:

[note] Using a filter may not be the most efficient way to lay out a small part of a large graph. You may prefer to build a new graph corresponding to this small part on the fly and perform the layout on the new graph.

void IlvGrapherAdapter::setProperty	(	IlAny	nodeOrLink,
		const char *	key,
		IlAny	value
	)			[virtual]

Sets the value of a property for a node or a link.

If value is equal to 0, the property is removed. Otherwise, the property value is set to value.

Parameters:

	nodeOrLink	The node or link for which the property is to be set.
	key	The key string for the property.
	value	The new value of the property.

See also:

getProperty

Reimplemented from IlvGraphModel.

void IlvGrapherAdapter::setReferenceTransformer

(

IlvTransformer *

t

)

Allows you to specify the reference transformer.

The reference transformer is the transformer (see the class IlvTransformer) that is taken into account by the IlvGrapherAdapter when computing the geometry of the graph.

If the encapsulated grapher contains only zoomable nodes and links (see IlvGraphic::zoomable), you never need to call this method. In this case, the layout computes the geometry of the graph on the basis of the bounding boxes of the objects in manager coordinates. The geometry will stay valid for any transformer.

If the encapsulated grapher contains at least one nonzoomable object, the geometry of the graph becomes dependent on the transformer that is used to draw the graph. Therefore, you need to specify the transformer with which you want the layout to be performed. Usually, this transformer is the current transformer used to display the result of the layout.

In most cases, it is not necessary to call this method because the transformer to be taken into account is chosen using a set of default rules (see getReferenceTransformer()). If it is called, the transformer specified using this method is returned by the method getReferenceTransformer(), overriding the default rules for choosing the transformer.

The only cases when you may need to call this method are the following:

• The IlvGrapher contains nonzoomable objects and more than one manager view is attached to the grapher.
• The IlvGrapher contains nonzoomable objects and no manager view is attached to the grapher.

In both cases, because of the nonzoomable objects, the layout cannot be correctly computed independently of the transformer used for drawing the graph. Also, the default rule for choosing the current transformer of the first manager view as the reference transformer cannot be applied.

If a grapher containing nonzoomable objects is displayed simultaneously in several views, you can use the method setReferenceView(IlvMgrView*) to indicate the view for which you want the layout to correspond exactly to the geometry of the graph.

If you specified a transformer but want to reset this setting and go back to the default behavior, call the method with an argument equal to 0.

See also:

getReferenceTransformer

setReferenceView(IlvMgrView*)

Parameters:

t

The transformer that becomes the reference.

Note that if this method is overridden, you must call setReferenceTransformer(IlvTransformer*) of the super class in order to notify the grapher adapter that the reference transformer has changed.

Note also that a call to the method setReferenceView(IlvMgrView*) overrides the effect of a call to the method setReferenceTransformer(IlvTransformer*). Similarly, a call to the method setReferenceTransformer(IlvTransformer*) overrides the effect of a call to the method setReferenceView(IlvMgrView*).

Warning:

[note] This method make a copy of the transformer passed as argument.

virtual void IlvGrapherAdapter::setReferenceView

(

IlvMgrView *

view = 0

)

[virtual]

Allows you to specify the reference manager view.

The reference view is the view connected to the manager whose current transformer is used as a reference transformer (see method getReferenceTransformer).

Usually, the view argument is the manager view that is used for displaying the graph, but this is not mandatory.

Call this method with an argument equal to 0 to reset the setting.

Parameters:

view

The view set as the reference.

See also:

getReferenceView

setReferenceTransformer(IlvTransformer*)

Warning:

[note] A call to the method setReferenceTransformer(IlvTransformer*) overrides the effect of a call to the method setReferenceView(IlvMgrView*). Similarly, a call to the method setReferenceView(IlvMgrView*) overrides the effect of a call to the method setReferenceTransformer(IlvTransformer*).