Direct Link Between Two Nodes illustrates a straight link connecting two nodes:

An IlvLinkImage instance is a graphic object that represents the connection between two nodes. By default, it is drawn as a straight line joining the two nodes. The constructor of the IlvLinkImage class is as follows:

The from parameter is an object of type IlvGraphic that represents the start node of the link. The to parameter is an object of type IlvGraphic object that represents its end node. The oriented parameter specifies whether the link ends with an arrow-head.

Several member functions, prefixed by set and get, let you access these properties. For example, the end node can be accessed with the IlvLinkImage::getTo and IlvLinkImage::setTo methods. Similarly, you can change the oriented mode of the link with the IlvLinkImage::setOriented method.

Besides storing these properties, the purpose of the IlvLinkImage class is to:

Subclassing IlvLinkImage is useful when you want to create a link with a different behavior and/or drawing aspect. To change the behavior, overload the IlvLinkImage::getLinkPoints method:

The returned array should not be deleted by the caller. You need to allocate this array on a common memory pool by using the IlvPointPool class. In this method, you can query the geometry of the start and end nodes to determine the points defining the shape of the link. There are two categories of such points:

The IlvLinkImage class uses the IlvLinkImage::computePoints method to compute the location of the end points of the link:

The default implementation first checks whether the link is associated with a connection pin on the nodes. (See section Connection Pin Management ClassConnection Pin Management Class for more information.) If no connection pin is defined, the intersection of the link with the bounding boxes of the start and end nodes is computed. This is illustrated in End point Location When No Connection Pin is Defined: