2. Graph properties
Prev | Chapter 4. Functionalities | Next

## 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 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.

Prev | Up | Next
Chapter 4. Functionalities | Home | 3. Hierarchy