Set Project Display Options

The Project panel’s Settings subpanel includes basic and advanced options to set the the project-wide theme and the display of nodes and edges.

Basic settings

03 01 01 BasicSettings

Basic settings include options to:

  • Click the Theme icon to toggle between the default dark mode and light mode.

    03 01 02 DisplaySettingsTheme
    Use Toggle Theme on the Kineviz logo menu to change the theme in one click.
  • Hide Pin Icon on all nodes. Pin icons can interfere with icon or avatar styling, and since any manual move or automatic layout pins the nodes, it’s often best to hide the icon.

  • Set basic edge display:

    • Show Relationship Name, to display the relationship name on all edges.

      A relationship property value can also be displayed on edges of a specific relationship. Set this in the legend using the relationship style setting dialog.
    • Use Curve Line, to use curved lines instead of straight lines for all edges.

    • Hide Arrow, to hide direction arrowheads on all edges.

  • Use UI Config to show or hide project UI elements including panels, toolbar, and right-click menu options. (LINK TO separate doc for this)

Advanced Settings

In Project > Settings, the Advanced Settings dropdown provides access to many additional project options:

03 01 03 AdvancedSettingsIntro

You can:

  • Show or hide Quick Info on mouse rollover, and the Snapshots and History windows.

  • Fine-tune the display of nodes, edges, icons, and captions

Show Quick Information

  • Click the Quick Info checkbox to display a compact information pane when you roll over a node or edge.

    03 01 04 QuickInfo
    Click the Quick Info icon in the toolbar menu to toggle the quick information pane on and off.

Show Snapshots

During a session in a project, you can create an archive of up to ten Snapshot views of the data on the canvas. This can be useful for recording key results of a multi-step process, or returning to a particular point in an exploration.

  • Click the Show Snapshot checkbox to display the menu bar for the floating Snapshots window. You can:

    • Use icons in the Snapshots menu bar to take a snapshot or export the snapshot archive.

    • Click the dropdown arrow at the upper left to review current snapshots and load one of them to the canvas.

      03 01 05 Snapshots
    • Click the X in the Snapshots title bar to dismiss it from the canvas (and automatically uncheck the checkbox).

    Unlike saved Views, snapshots are deleted when you log out or return to the Projects home page. To save your snapshots, click the download icon in the Snapshot title bar to export a snapshot archive.

Show History

Click the Show History checkbox to display the History window, a selectable list of additions, deletions, or layouts of nodes and edges that you’ve done in the current view.

03 01 06 History

You can:

  • Double-click a History list item to return to an earlier state of the graph without needing multiple Ctrl + Z commands.

  • Click the X in the History title bar to close the window (and automatically uncheck the checkbox).

    Undo / Redo toolbar icons revert (or restore) your most recent operation (but not earlier ones).

Fine-tune display of nodes and edges

Advanced Settings includes options for fine-tuning display of nodes and edges on the project canvas, including:

  • Checkboxes:

    • Set automatic display of an avatar image on nodes, and set automatic caption rendering

    • Set edge styling options

    03 01 07a FineTuneCheckboxes
  • Scaling sliders:

    • Scale project-wide node size, edge width, and caption size

    • Set 3D fog density

    03 01 07b FineTuneSliders
  • Dropdown menus:

    • Set caption positioning for nodes

    • Set an icon display mode

      03 01 07c FineTuneNodePosIcon
Nodes and edges are also styled in the Legend by clicking the brush icon next to a list item to display the Styling Setting dialog. Use this to set node color, icon, and properties used for the avatar, captions, and node size or edge width scaling.

Auto Avatar

In Advanced Settings, click the Auto Avatar checkbox to automatically show images on nodes that have a URL property defined on their Category.

The avatar image appears when you zoom in to a fixed virtual distance from the node. When you zoom out from that point, the category color and icon is displayed instead.

03 01 08 AutoAvatar

An attempt to load an image is made for any property key of _photo, photo, avatar, image_, picture, or icon with a property value starting with http, https, or ftp. Supported image formats are jpg, jpeg, png, gif, bmp.

For faster navigation on the canvas, deselect Auto Avatar. Icons that have been applied are still displayed.

To display avatar images only on nodes of specific categories, set an Avatar Url property in the category legend list and Styling Setting dialog, or in the Project > Category tab.

Auto Captions

In Advanced Settings, click the Auto Caption checkbox to automatically apply a default caption property (caption>label>title>name) for all categories and relationships.

Caption Rendering Options

Caption rendering options can be useful for large amounts of data with many captions. In Advanced Settings checkboxes:

  • Click the Alternate Caption Rendering checkbox to use a more compact rendering of captions which may be more legible.

  • Click the Truncate Caption checkbox to limit the text displayed on captions without affecting the underlying property values.

Edge Rendering Options

In Advanced Settings checkboxes:

  • Click the Blend Edges checkbox to enable additive blending of edge color such that multiple edges stacked on top of one another appear brighter.

  • Click the Dash Line checkbox to display all edges as dashed lines.

    03 01 09 BlendDash

Size and Edge Width Scaling

Sliders below the Advanced Settings checkboxes let you scale the size of nodes and captions and the width of edges.

03 01 10 SizeWidthSliders

The scaling sliders are:

  • Node Size Scale slider. Set a project-wide value for the size scale applied to all nodes. Use this to make all nodes appear larger or smaller on the canvas. This basis is used when a category’s node size is also scaled by one of its property values.

  • Caption Size Scale slider. Set a global value for the size of captions for both nodes and edges.

  • Edge Width Scale slider. Set a global scale value fo the relative width of all edges.

    The sliders present a suggested range of values. However, you can enter an out-of-range value in the text box showing the current value. In the example above, readable captions needed a much larger Caption Size Scale.

Fog Density scaling

Use the Fog Density slider to enhance the 3D experience on the canvas by dimming nodes and edges the further from the viewer they are in the virtual 3D space. A fog density of zero (0) provides crisp rendering of all graph elements.

03 01 11 FogSlider

Node Caption Positioning

In the Node Caption Position dropdown menu, select where the captions are displayed relative to the node.

03 01 12 NodeCaptionPos

Position options are Right, Top (left-aligned or centered), Bottom (left-aligned or centered), and Vertical.

Icon Mode Options

In the Icon Mode dropdown menu, set a display mode for icons overlaid on nodes.

03 01 13 IconMode

Options are:

  • Background Transparent. Removes the node background. Only the icon is colored and the rest of the node circle is transparent.

    03 01 14 DisplayIconBkTransparent
  • Icon Transparent. Makes the icon transparent, and overlays it on the node circle.

    03 01 15 DisplayIconTransparent
  • Mix Color. Automatically selects a lighter, contrasting hue for the icon and overlays it on the node circle.

    03 01 16 DisplayIconMixColor