Inserting a node with the Marionette tool

Mode

Tool

Tool set

Insert

Marionette

Basic

The Marionette tool places nodes, and also enables a special Debug mode for troubleshooting.

Mode

Description

Current Node list

Opens the Resource Selector to select a node for placement; double-click a node resource to activate it

Insert

Enables the selection and placement of nodes from the Current Node list

Debug

Allows for troubleshooting and debugging networks, including the networks inside of wrapper and object nodes; see Debugging a Marionette script for more information

Preferences

Opens the Marionette Preferences dialog box.

● Cache last run in debug mode caches data from the latest run of the network. Select this option to display the values that flowed through each wire without re-running the script. See Debugging a Marionette script.

● Leave current node selected after run leaves the current node (the node used to run the script) selected after the script executes. Deselect this option to select the objects created by the script instead. See Running a Marionette script.

● Content provides links to helpful resources.

Marionette nodes are page-based objects, displaying on the screen plane and scaling to the page dimensions. They should be worked with in Top/Plan view.

Nodes are color coded and categorized by function. A node reference is available online at developer.vectorworks.net/index.php/Marionette.

The nodes’ input and output ports have prefixes denoting the type of data that can pass through them.

Prefix

Data type

Boolean

Handle

Integer

item

Item (any object type)

list

List (any object type)

Matrix

Number/Dimension

Point

String

Vector

To insert a node:

1. Click the tool and mode.

2.Click Current Node on the Tool bar to select a resource from the Resource Selector.

In the Resource Selector, a description of each node displays as the cursor hovers over the node.

3.Click in the drawing to place the node.

The node properties can be accessed from the Object Info palette.

Parameter	Description
Edit	For basic nodes, opens the Script Editor dialog box to change the functionality of the node; for object or wrapper nodes, accesses an editing mode. For more information, see Creating and editing nodes.
Description (basic nodes only)	Gives a brief description of the purpose of the node and relevant inputs and outputs
Edit Description (wrapper nodes only)	Opens the Wrap Marionette Network dialog box to edit the node name or description. For more information, see Marionette Wrapper nodes.
Run	Executes the node; if the node is part of a network, it executes the network
Name	Enter a name for the selected node. If a name is assigned, it displays at the top of the node. For more information, see Naming nodes.
Parameters	Specifies the parameter values to be passed to the associated node
Type	Displays the type of node
Criteria Configuration	For Objects by Criteria (Objs by Crit) nodes, opens the Criteria dialog box to set criteria, similar to Creating custom selection scripts
Settings	For chart nodes, opens the Chart Configuration dialog box to configure the chart; see Creating Marionette charts

~~~~~~~~~~~~~~~~~~~~~~~~~