2. Graph properties

2. Graph properties
Prev	Chapter 4. Functionalities	Next

Each node and edge has a set of associated properties. The properties used by the renderer begin with the “view” prefix, by convention: viewColor, viewLabel, viewLayout... It is possible to define an unlimited number of additional properties to store information.

Rendering Properties

Here is the list of rendering properties:

viewBorderColor: border Color of an edge or a node.
viewBorderWidth
viewColor
viewFont: Font path used to render the label
viewFontSize
viewLabel
viewLabelColor
viewLabelPosition
viewLayout: Position (x,y,z) of a node, or vector of the bends positions of an edge.
viewMetric: Result of the last measure (the section called “Measure”) algorithm applied.
viewRotation: Rotation (0 to 360) of a node or edge
viewSelection: true if the element is selected, false if not.
viewShape
viewSize: For a node: (height, width, depth). For an edge: (width at source, width at end, arrow size). For edge size to take effect, View editor → Rendering parameters → Size interpolation must be unchecked.
viewSrcAnchorShape: Shape of the source anchor (i.e. shape at one end) of an edge. For this setting to take effect, View editor → Rendering parameters → arrows must be checked. Used only for edges.
viewSrcAnchorSize: Size (along the x, y, z axis) of this source anchor. Used only for edges.
viewTexture: Texture to replace the color background of the node.
viewTgtAnchorShape Like viewSrcAnchorShape, on opposite end of the edge.
viewTgtAnchorSize: idem.

Management

There are several ways to update properties:

through algorithms (as explained in Section 1, “Algorithms”)
Import CSV Data allows (through a wizard) to import properties from a CSV file (see Section 4, “Importing CSV data”).
through Graph Editor → Property (see the section called “Property”), as we now explain.

To modify the properties of just one element:

In the bottom part, select the property to update.
In the upper part, double-click the cell to update, edit it and click OK.
Press Enter to update the drawing.

To modify the properties of several elements:

Select elements (for instance with the tool).
Select the property to modify, here viewLabel.
Click selected only: the table above displays only the selected elements. (if this is not checked, all nodes will be modified).
Click Set all, write some text: “Hello world!” and click OK.
Press enter to update the view.

Likewise, the Edges tab allows to modify edge properties.

Click To labels to set as labels the values of the selected property.

To remove a property, select it first, then click Remove. When deleting properties used by the renderer, those properties will be temporary removed from the list but still continue to exist. Note that it is not possible to remove inherited properties.

To find a property more easily, you can enter the first letters of the property name in the text box just above the list of properties.

Find

Menu Edit → Find allows to run a simple request on the database of elements. For instance,

open a graph with several nodes and select som of them with the selection tool .
Go to Graph editor → Property, click Selected only. You should see only the selected nodes in the upper part of the Graph editor subwindow.
Click the property viewRotation, then Set all, enter 20, click OK. We now have some nodes with a rotation of 0 degree and some other rotated 20.
Unselect all nodes (Menu Edit or Ctrl+Shift+a).

We can now demonstrate the Find tool:

click Menu Edit → Find or Ctrl+Shift+F,
choose viewRotation as input property
choose = and 0 as filter
Under options, select Replace and on nodes.
Press enter.

All the non-rotated nodes should now be selected.

For textual fields, the filter supports regular expressions.