Mewa User's Guide/Using the Node Graph

Understanding the Node GraphEdit

The node graph provides a visual representation of a sequence of operations applied over images.

 
Node graph tab

The node graph is represented by nodes connected to each other by lines. In this node-based workflow each node in the graph performs a specific function.

Node inputs are on the top of the node. Node outputs are on the bottom of the node. The output port of one node is attached to the input port of the next node down in the node graph.

Connections between nodes can only be done between input and output.

Nodes apply image processing operations over the input image and return the processed image in their output port.




As you create a node graph you will need to edit nodes parameters and visualize the output of different nodes. Parameter windows allow you to edit node's parameters while using the output window to inspect the out put of a node.

 
Parameter window

Inside the nodes there are 2 buttons. On the left side, with a rectangular shape is the output button. On the right side, with a circular shape is the parameters button.

To bring up the parameters window just click on the node parameters button. A parameters window pops up showing the node's parameters. Some nodes, like move2D node, have parameters that will be shown on the output window.

The output window as a similar behaviour as the parameters window. To show the output window use the node's button located on the left side of the node.


Using the parameters window to modify one node parameter while visualising the result at a different node is one of the great advantages of using a node graph.


 
Working with images in the node graph

Navigating the Node GraphEdit

PanEdit

The mouse middle button to pans the node graph view.


Editing a Node GraphEdit

Creating NodesEdit

To add nodes to the node graph use the   button to show the list of all available nodes. Just click the node you wish to add and the corresponding node will be added to the Node graph.

 
Node List

Footage nodes are added to the node graph when importing footage. See chapter Import Footage for more information.

Moving NodesEdit

To move a node, select the node and drag it within the Node Graph window.

Connecting NodesEdit

Connections between nodes are drawn as a cubic spline line between 2 nodes. To connect two nodes, with the left mouse button, click and drag from one node input/output releasing over another node output/input.

Note that only connections between inputs and outputs are allowed.

Node inputs/outputs provide information whether a connection is allowed or not. An input/output becomes highlighted when hovering the mouse pointer over it, meaning the connection can be created to the dragging edge. If a connection is not allowed, the destination input/output does not get highlighted.

Disconnecting nodesEdit

To disconnect nodes, drag one end of the connecttion and drop it away from the node.

Parameters windowEdit

 
Parameter window

An animation is created by changing the value of a parameter over time. A parameter can be anything from the position, rotation, scaling, or transparency of an object, to the gamma, gain, or offset in a color correction. Basically, any node parameter can be animated.

Parameters of a node are listed in the node's parameter window. To open the parameters window toggle the parameters button found inside the node, on the right side.

For some nodes enabling the node parameters not only opens the parameters window, it can also show an extra toolbar in the output window. An example of this is the move2D node.

Changing parameters valueEdit

Parameter windows usually show a parameter label and an input box for each parameter, without any traditional controls e.g. sliders.

To change the value of a parameter press inside the input box, and drag. Dragging will increase or decrease the parameter value. The value inside the input box shows the parameter value the it changes.

Controlling a parameter with a curveEdit

Parameters are animated using curves. The curve represents the value of a parameter at different frames.

A curve can be created in two ways:

  • clicking on new curve button   in the curve editor,
  • or pressing the curve button in the parameter input box (see image below)
 
Node Parameter

More information on how to create a new curve using the new curve button   can be found in curve editor.

Creating a curve from the parameter input box is my favorite method because it has the advantage of creating a new curve and associating it with the parameter at the same time.

Any curve can be associated to a parameter and the same curve can be associated to as many parameters as desired.

When a parameter has a curve associated with it two buttons are shown in the parameter input box. Below is a pic of a parameter control with a curve associated with it.

 
Node parameter with curve associated

The parameter input box has two buttons, the first button is a single color button. The color is the color of the curve as seen in the curve editor. Clicking on it will show a drop down list of all available curves. This allows to choose a different curve to be associated with the parameter.

The second button   detaches the curve from the parameter. This means the parameter will have the same value in all frames.

Output windowEdit

The output window is where the output of a node is shown.

Below is a node with it's output button toggled. On the left is the output window showing the node output.

 
Output of a image node

Note that the output window header, at the top of the window, shows the name of the node owning the output window.

Usually node parameters are changed while watching the result at the output window. This ability to choose to view the output of any node while changing parameters from a different node is one of the main benefits of working with a node graph.

Fit in viewEdit

The Fit in view button   scales the output image to be fully visible in the output window.



Back to contents page