|
Radio Node System |
The Radio Node System is a combination of custom nodes for the Nodegraph and Menu actions interacting
with these Nodes.
The purpose of the System is to provide the option to hide connection lines between nodes in order to have
a cleaner Nodegraph with less intersecting lines.
Hiding and unhiding a connection to a radio node using Right Mouse Click / Misc / Toggle Radio Nodes.
In addition to directly connecting a Radio Node to another Node you can also expose nodes anywhere in the graph via a Radio Transmitter Node.
Radio Transmitter Nodes allow you to connect a selected Radio Node via the Right Mouse Click / Misc/ Connect to Transmitter Option
to a Transmitter anywhere in the Graph.
Connecting a selected Radio Node to a previously created Radio Transmitter Node via the Right Mouse Click / Misc / Connect to Transmitter Dialog
An additional function of the Radio Node System is to automatically reconnect imported Node Networks to specified Transmitter Nodes.
Example of Automatic Connection on Import
If you import a Node Network into your Nodegraph - either via Session Scripts or the Right Mouse Click / Edit / Import Nodes Function -
any radio node of that imported network that does not have a connection will try to reconnect to a Transmitter Node with the same Name that was connected
to the Radio Node before it was exported.
This functionality works across projects allowing you for example to expose commonly used information such as Occlusion, Curvature, Material ID maps etc.
via Transmitters and creating and exporting Node Network Templates that can automatically detect these Outputs in any Project you import the templates into.
- Where to find it: (This Node is available in the Nodegraph only)
NodeGraph / Right Mouse Click / Add Nodes / Misc / Extension Pack /
- Shotcut (Nodegraph Only): R
The Radio Node is a custom node with its only purpose being to act as a 'dot' or 'connection' that can hide its input line.
You can connect its Output to another Node just like any other Nodegraph Node..
..and feed another node into its Input. The Radio Node does no processing.
It's only purpose is to pass through incoming information
|
|
Naming Radio Nodes will auto inherit the name of the Node they are connected to, unless manually renamed. The Auto inheriting of Node Names ignored content in Square Brackets. Example: A Node MyColor [Transmitter] is connected to a Radio Node. The Auto Naming of the Radio Node will Name the Radio Radio Node [MyColor] |
- Where to find it: (This Node is available in the Nodegraph only)
- NodeGraph / Right Mouse Click / Add Nodes / Misc / Extension Pack /
- Shotcut (Nodegraph Only): T
The Radio Transmitter Node is a custom node that can be called by a Radio Node from anywhere inside your current Nodegraph via the Connect To Transmitter Menu Option.
It can can be left either without an output connection or can be utilized as part of a network chain
Radio Transmitter Nodes contain a checkbox (on by default) to determine if they are accepted nodes for the Automatic Reconnection of Radio Nodes on Import
|
|
Naming Radio Transmitters will auto inherit the name of the Node they are connected to, unless manually renamed. The Auto inheriting of Node Names ignored content in Square Brackets. Example: A Node MyColor [Tiled] is connected to a Radio Transmitter. The Auto Naming of the Transmitter will Name the Transmitter MyColor [Transmitter] |
- Where to find it:
- NodeGraph / Right Mouse Click / Misc /
- Main Window / Extension Pack / Nodegraph / Radio Nodes /
- Shotcut (Nodegraph Only): Ctrl + Shift + R
Toggle Radio Nodes allows you to hide and show connections on a Radio Node.
If your Node selection in the currently open Graph Tab includes Radio Nodes the selected Radio Nodes will be switched to their opposite state -
visible connections will become invisible, invisible connections will become visible
If your Node selection in the currently open Graph Tab includes Radio Transmitter Nodes, the Radio Nodes connected to the Transmitter will be switched to their opposite state -
visible connections will become invisible, invisible connections will become visible
If your Selection is empty or does not include Radio Nodes or Radio Transmitter Nodes, all Radio Nodes in the currently open Graph Tab will be switched to invisible on the
first command execution, then to visible on the second.
When Radio Node Lines are hidden, the Radio Name will be appended with the Name of the Node connected to the hidden connection.
- Where to find it:
- NodeGraph / Right Mouse Click / Misc /
- Main Window / Extension Pack / Nodegraph / Radio Nodes /
- Shotcut (Nodegraph Only): Shift + T
With one or multiple Radio Nodes selected, executing the Connect To Transmitter Menu Option will display a list of all available Radio Transmitter Nodes
in your current Nodegraph. By selecting one of the Radio Transmitter Nodes, the selected Radio Node(s) will automatically connect to the chosen Transmitter.
- The last created Radio Transmitter will always appear at the top of the List
- Filtering for Radio Transmitters allows Name Narrowing or Comma Separation of multiple Keywords
- Navigate the List using your mouse or arrow keys. Confirm by double clicking or pressing RETURN
- Radio Nodes can be connected to a different Transmitter at any time
- Radio Nodes Connections after choosing a Transmitter will be hidden by default. This can be adjusted via a prefernce in the Mari/Edit/Preferences/Nodegraph Section.
Using a combination of Radio Nodes and Transmitters allows for a high degree of automated workflows through the use of Automatic
Connection Building when importing Node Networks through the Right Mouse Click / Edit / Import Nodes or File / Session / Options in Mari.
If your imported Node Network contain one or multiple Radio Nodes that
- do not have a connection (hidden or invisible)
- contain a Node Name Identifier in Brackets [ ]
your current Nodegraph will be searched for a Radio Transmitter Node matching the Name in the Radio Node's Square [ ] Brackets
If ...
- a Transmitter matching the name specified within the radio node [ ] exists
- if the transmitter has its 'Allow Automatic Reconnect on Node Import' Option in the Node Properties turned on
- if 'Allow Automatic Reconnect on Node Import' is turned on in the Mari Preferences / Nodegraph Tab
... the imported Radio Nodes will be automatically connected to the Transmitter after import.
|
|
Naming Both Radio Nodes and Automatic Reconnect on Node Import will ignore any characters that are encompassed in square brackets [ ] . Example: A Radio Node connected to a Radio Transmitter named MyRadioTransmitter [Transmitter] will be called Radio Node [MyRadioTransmitter] after the connection has been made invisible. |
This workflow is recommended for templated nodegraphs, gizmos etc. that always need to access per-project information such as Occlusion, Curvature etc.
This automatic connection behavior can be deactivated via a Preference under Mari / Edit / Preferences / Nodegraph Section
|
|
Additional Actions The actions below are not embedded into the Mari interface but can be found under the Scripts Menu and are available for Hotkey assignments in the Hotkey Editor |
- Where to find it:
- Main Window / Extension Pack / Nodegraph / Radio Nodes /
- Shortcut: (unassigned, use "Edit / Shortcuts" to assign)
Jump to Radio Node Connection will jump the Nodegraph view to a connection associated with a Radio Node.
- If a Node is selected that has its Output linked to a Radio Node, the view will jump to that Radio Node.
Executing the command a second time will jump back to the original Node
- If a Radio Node is selected, the view will jump to the Node associated with the Radio Node.
Executing the command a second time will jump back to the original Radio Node.
- Where to find it:
- Main Window / Extension Pack / Nodegraph / Radio Nodes /
- Shortcut: (unassigned, use "Edit / Shortcuts" to assign)
Toggle Selected Radio Nodes is nearly identical to Toggle Radio Nodes however it only works on selected radio and radio transmitter nodes
and will not hide/unhide all connections in the currently open graph tab, when no radio nodes are selected
- Where to find it:
- Main Window / Extension Pack / Nodegraph / Radio Nodes /
- Shortcut: (unassigned, use "Edit / Shortcuts" to assign)
Expand all Radio Nodes will set all Radio Node connections in the currently open Graph Tab to visible
- Where to find it:
- Main Window / Extension Pack / Nodegraph / Radio Nodes /
- Shortcut: (unassigned, use "Edit / Shortcuts" to assign)
Collapse all Radio Nodes will set all Radio Node connections in the currently open Graph Tab to invisible
- Where to find it:
- Main Window / Edit /Preferences / Nodegraph Tab /
A small number of preferences exist to better configure Radio Node behavior to your needs.
When On, a Radio Node Connection will be automatically toggled hidden when a connection is made to a Transmitter via the Connect to Transmitter Tool
Turns off the functionality to automatically reconnect imported Radio Nodes without a Connection to a Transmitter matching
the [ NODENAME ] (in Square Brackets) on the imported Radio Node.
