Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Table of Contents
maxLevel2
minLevel2
exclude|Overview|In this Topic

1. Menu Bar

File

Option

Description

New

Opens an empty Flow Graph. (Preferred method is to create flowgraphs directly on entities placed in the world) If you use this method, you must " Save All External Graphs" as * .xml format.

New AI Action...

Create a new AI Action (Saved to the correct folder)

New UI Action...

Create a new UI Action (Saved to the correct folder)

New Custom Action...

 

New FG Module...

  • Global creates a new, global Flow Graph module. Can be shared between levels
  • Level creates a new, level-based Flow Graph module. Can only be seen / used by the current level

New MaterialFX Graph...

 

Save All External Graphs

 

Import...

Imports a Flow Graph. (*.xml)

Export...

Exports a Flow Graph. (*.xml)

Edit

Option

Description

Undo

Undoes the last action.

Redo

Redoes a previously undone action.

Cut

Cuts selected node(s).

Copy

Copies selected node(s).

Paste

Pastes selected node(s) to the location under the cursor. This does not include any connected links.

Paste with Links

Pastes the nodes from the clipboard, including all the connecting links, to the location under the cursor.

Delete

Deletes the selected node(s).

Find

Makes the cursor jump to the Search window (see below).

...

For obvious reasons, the Main Window cannot be hidden. Under the components section, you can choose to display all types of Flow Graph node. 

Tools

Option

Description

Edit Graph Tokens...

Lets you create and edit Flow Graph Tokens. For more information on Flow Graph Tokens, click here.

Edit Module...

Lets you edit a Flow Graph Module. For more information on Flow Graph Modules, click here.

Debug

Option

Description

Enable Debugging

Turns on Debugging mode. This highlights the logic flow with the graphs. This is represented by the yellow highlights on the links.

Erase Debug Information

This clears the information (yellow trails) from the debugging info to start afresh, next time you jump in-game.

Ignore Flow Graph Type

Ignores the type of the Flow Graph when debugging. (Used to filter what the debugging is run on.) Can all be left on as default.

...

Under the Menu Bar we have the quick access toolbar.

Button

Description

Start Flow Graph Update

Resumes the game after a breakpoint has been hit in Debugging mode.

Undo

Undoes the user's last action.

Redo

Redoes the user's last action.

Previous

Goes back to the previous Flow Graph.

Next

Goes forward to the next Flow Graph.

Toggle Visual Flow Graph Debugging

Turns on Debugging mode. This highlights the logic flow with the graphs. This is represented by the yellow highlights on the links.

Erase Flow Graph Debugging Results

This clears the information (yellow trails) from the debugging info to start afresh, next time you jump in-game.

...

Nodes can belong to different categories. Which nodes are visible in the component list can be configured in the View -> Components menu. There are six node categories:

Category

Description

Approved

Approved nodes mostly have basic, easy to use functionality and are safe to use.

Advanced

Advanced nodes feature more complex functionality and are advised to be enabled for the more experienced users.

Debug

Nodes mainly made for debugging purpose.

Legacy

Old node, still working but not advised to use. Will be removed in future releases to be possibly replaced by a new/other node.

WorkInProgress

The functionality and usage of these nodes might change in the future.

No Category

Uncategorized nodes that belong to none of the above categories.

...

  • Click on the + next to Entities to expand the list. (The + sign is only available if there are child graphs to the folder.)
  • This list shows you all the available entities with Flow Graphs attached (if present in the level)
  • Simply clicking on the different items in the list will display the Flow Graphs information attached to that entity
  • Right-click on a list item to bring up the context-menu, which offers different options depending on the graph:


 

Option

Description

Disable/Enable

Disables or enables a Flow Graph. By default all Flow Graphs are enabled. A disabled Flow Graph will not be executed. (helpful for debugging)

Change Folder

A Flow Graph can be placed in a sub-folder. If a new folder name is entered a new folder will be created. This is the only context menu option available for AIAction graphs.

Select Entity

Selects the entity in the 3d viewport that the flowgraph is attached to.

Remove Graph

Completely removes the Flow Graph.

Info

In addition to the normal entity Flow Graphs, all AIAction graphs are listed in this window. An AIAction graph is a special type of graph which is executed by a Smart Object rule.

5. Main Window

This is the main window, where all the editing takes place. Nodes can be added, deleted, moved, and linked here. This window needs a lot of screen space to work effectively.

Tip

The best way to work with it is to place it on the second monitor (if available) and keep it open all the time because it may be necessary to switch between the game window and the Flow Graph often.

  • Navigation: The main editing pane is not limited and can be extended in any direction. To navigate, click and hold the right mouse button to pan around the graph. The scrollbars of the window can also be used. The mouse wheel is used to zoom in and out.
  • Selection: Nodes can be selected with the left mouse button and deselected by clicking somewhere in the background pane. Multiple nodes can be selected by clicking in the background pane with the left mouse button and drawing a drag box around the nodes that need to be selected. Double-clicking a node will select the assigned entity in the level.
  • Context menu: When you right-click the background pane, the context menu will be displayed.

Option

Description

Add Node

Adds a node to the graph. Similar to dragging and dropping a node from the components window into the main editing pane.

Add Selected Entity

Adds the entity that is currently selected in the 3D viewport to the Flow Graph. A new node will be created for this entity and inserted at the position of the cursor.

Add Graph Default Entity

The container entity of the currently active Flow Graph will be added as a new node.

Add Comment

This opens up a sub-menu where you can select from:

  1. Simple Comment: lets you write some text directly into the Flow Graph. (The text doesn't auto adjust size to Flow Graph zoom level).
  2. Comment Box: can be used to group together key elements inside a Flow Graph for easier reading. (The text on top of the comment box does re-size depending on the Flow Graph zoom level).
  3. Black Box: used when nodes are selected and assigned to a Black Box, they will be hidden from the main Flow Graph view, to help clear up the Viewport window.

Add Track Event Node

This is a shortcut to quickly access the often used Track Event Node (which is used by Trackview).

Add Start Node

This is a shortcut to the most commonly used Start Node.

Cut

Cuts the selected node(s) to the clipboard and removes it from the main editing pane.

Copy

Copies the selected node(s) to the clipboard.

Paste

Inserts one or more nodes from the clipboard into the Flow Graph at the cursor position. Links are not copied.

Paste with Links

Inserts one or more nodes from the clipboard in the Flow Graph at the cursor position, copying all links the nodes were connected with.

Delete

Deletes the selected nodes.

Selection (only shows when a node is selected)

Opens a sub-menu where you can select from:

  1. Export Selected Nodes: outputs the selected nodes to an *.xml sheet to be imported into another flow graph.
  2. Select Assigned Entity: selects and highlights the entity in the main Viewport window.
  3. Select and Goto Assigned Entity which will do as above, but also move the camera to the node.

Import

Imports an external Flow Graph from an *.xml file.

Show Spline Arrows

Selects whether links are drawn as curved splines or straight links.

Fit Graph to View

Automatically zooms the current Flow Graph to the graph's extent.

Info

The usual windows shortcuts Ctrl-C, Ctrl-V, etc. can also be used while editing in the Flow Graph. Additionally Ctrl-Shift-V pastes the nodes from the clipboard including all links.

6. Properties

The Properties panel is specific to the node currently selected. All node parameters can be edited here.

...

The Look in drop-down list defines which graphs will be searched:

Option

Description

Current

Only the currently opened graph will be searched.

AIActions

Only action graphs will be searched.

Entities

Only entity based graphs will be searched.

All Flowgraphs

Both entity and action graphs will be searched.

...