2. Graph properties

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 editorRendering parametersSize 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 editorRendering parametersarrows 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:

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 EditFind 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 editorProperty, 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 EditFind 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.