| Long name (short name) |
Argument types |
Properties |
|
-addBackdrop(-ab)
|
string
|
 
|
|
Add a backdrop into the compound.
|
|
-addIONode(-aio)
|
boolean
|
|
|
Add an input or an output node into the compound.
|
|
-addMetaData(-amd)
|
string string
|
|
|
Add a value to a metatada.
The arguments are, in order, metadata name, metadata value to be added.
|
|
-addNode(-an)
|
string
|
|
|
Add a node into the compound.
|
|
-addStatePorts(-asp)
|
string string string
|
|
|
Add new input and output ports, linked together.
The arguments are, in order, the input port name, the output port name
and the data type to assign to both ports.
|
|
-canResetToFactory(-crf)
|
string
|
|
|
Query if the specified compound can be reset to its initial status.
|
|
-clearMetaData(-cmd)
|
string
|
|
|
Remove all the values of a metatada.
The argument is the metadata name.
|
|
-connectTo(-cot)
|
string
|
|
|
Used with addNode and addIONode, use to connect - when possible,
the newly created node to the given upstream node.
|
|
-connected(-cn)
|
boolean
|
|
|
Used with "listNodes" or "listPorts" to query the nodes
or internal ports that have connections when the argument is true.
If the arguments is false, return all nodes which
have no connection. The other side of the connection could be
another node or port.
|
|
-connectedTo(-ct)
|
string
|
|
|
Used with "listNodes" to query all nodes that
connect to the specified ports.
|
|
-connectedToInput(-cti)
|
|
|
|
Used with "listNodes" to query all nodes which
connect to any input ports.
|
|
-connectedToOutput(-cto)
|
|
|
|
Used with "listNodes" to query all nodes that
connect to any output ports.
|
|
-create(-c)
|
string
|
|
|
Create a sub compound in the specified compound.
The name of the created sub compound cannot be
used before in the specified compound.
|
|
-createInputPort(-cip)
|
string string
|
|
|
Create an input port in the compound. The first
argument is the name of the port. The second argument
is the data type of the port.
|
|
-createOutputPort(-cop)
|
string string
|
|
|
Create an output port in the compound. The first
argument is the name of the port. The second argument is the
data type of the port.
|
|
-deletePort(-dp)
|
string
|
|
|
Delete a input or output port from the compound.
|
|
-explode(-ec)
|
string
|
|
|
Explode a specified compound and move the nodes from it to its parent.
|
|
-hidePort(-hp)
|
string boolean
|
|
|
Hide or display an input port of a compound
|
|
-inputPort(-ip)
|
|
|
|
Used with "listPorts" to query all internal ports which
connect to any input ports in the compound.
|
|
-listNodes(-ln)
|
|
|
|
List all nodes in the compound. Can be used with
other flags, such as "dataType", "connectedToInput" to
query some specified nodes. The returned result is
a list of node names.
|
|
-listPortChildren(-lpc)
|
string
|
|
|
List the children of specified port.
|
|
-listPorts(-lp)
|
|
|
|
List all internal ports in the compound, including
input and output ports.
Can be used with other flags, such as "output",
"connected" to query some specified ports.
|
|
-moveAnnotationIn(-mai)
|
string
|
|
|
When creating a new compound, use this argument once for every annotation to move into the new compound
|
|
-moveNodeIn(-mi)
|
string
|
|
|
When creating a new compound, use this argument once for every node to move into the new compound
|
|
-movePort(-mp)
|
string int
|
|
|
Move a port to the specified index in the compound
|
|
-movePortToIONode(-mpn)
|
string string
|
|
|
Move a port to another i/o node of the compound
|
|
-nodeType(-nt)
|
string
|
|
|
Used with "listNodes" to query all nodes which are
specified node type in the compound.
|
|
-outputPort(-op)
|
|
|
|
Used with "listPorts" to query all nodes which
connect to any output ports in the compound.
|
|
-portFlags(-cpf)
|
uint
|
|
|
Used with "createInputPort" or "createOutputPort" to specify
the flags on the port. See vnnPort command.
|
|
-portOptions(-cpo)
|
string[]
|
|
|
Used with "createInputPort" or "createOutputPort" to specify
a list of options on the created port.
|
|
-portValues(-cpv)
|
string
|
|
|
Used with "createInputPort" or "createOutputPort" to specify the default value of a new port
|
|
-publish(-pub)
|
string string string boolean
|
|
|
Used to publish the compound.
The arguments are, in order, the file path where to save,
the namespace where to store the compound, the name to use for
the nodedef, and a boolean to indicate whether the compound is
overloadable or not.
|
|
-publishGraph(-pbg)
|
string string string string
|
|
|
Used to publish the compound as a graph.
The arguments are, in order, the file path where to save,
the namespace where to store the compound, the name to use for
the nodedef, and a string containing a json property list which
will contain the metadata to be associated with the graph.
The json property list must be a simple set of key value pairs enclosed in
curly braces.
|
|
-queryAnnotationMetaDataValue(-qam)
|
string string
|
|
|
Query the metadata value of a specified annotation.
The first argument is the annotation to query, the second is the type of metadata to query.
|
|
-queryIsImported(-qii)
|
|
|
|
Query if the compound is imported.
|
|
-queryIsReferenced(-qir)
|
|
|
|
Query if the compound is referenced.
|
|
-queryMetaData(-qmd)
|
string
|
|
|
Query the value(s) of a metadata.
|
|
-queryMetaDataAsString(-mas)
|
|
|
|
Gets all metadata as a string. The format is documented with the setMetaDataFromString flag
|
|
-queryMetaDatas(-qms)
|
|
|
|
Query all the available metadatas.
|
|
-queryPortDataType(-qpt)
|
string
|
|
|
Query the data type of a specified port.
|
|
-queryPortDefaultValues(-qpv)
|
string
|
|
|
Query the default value(s) of a specified port.
For ports of scalar data type (ie. float or string),
this will return a single string value,
For ports of structure data type (ie. vector or matrix of floats - float3/float3x3),
this will return an array of string values.
|
|
-queryPortMetaDataValue(-qpm)
|
string string
|
|
|
Query the metadata value of a specified port.
The first argument is the port to query, the second is the type of metadata
to query.
|
|
-removeAnnotation(-rma)
|
string
|
|
|
Remove the specified annotation from the compound.
|
|
-removeMetaData(-rmd)
|
string string
|
|
|
Remove a value from a metatada.
The arguments are, in order, metadata name, metadata value to be removed.
|
|
-removeNode(-rmn)
|
string
|
|
|
Remove the specified node from the compound.
|
|
-renameAnnotation(-ra)
|
string string
|
|
|
Rename an annotation in the compound. The first argument
is the old name of the annotation. The second argument is
the new name.
|
|
-renameNode(-rn)
|
string string
|
|
|
Rename a node in the compound. The first argument
is the old name of the node. The second argument is
the new name.
|
|
-renamePort(-rp)
|
string string
|
|
|
Rename a port of the compound. The first argument
is the old name of the port. The second argument is
the new name.
|
|
-resetPortDefaultValues(-rpv)
|
string
|
|
|
Resets the default value(s) of a compound port
The port cannot be connected.
The argument is the port name.
|
|
-resetToFactory(-rtf)
|
string
|
|
|
Reset the specified compound to its initial status.
The specified compound must be able to be reset.
|
|
-saveAs(-sa)
|
string
|
|
|
Used to export Compound in the Compound menu of the Node Editor.
The argument is the file path to save.
|
|
-setAnnotationMetaDataValue(-sam)
|
string string string
|
|
|
Set the metadata value of a specified compound annotation. The arguments are, in order,
annotation name, metadata name, metadata value to be set.
|
|
-setIsReferenced(-sir)
|
boolean
|
|
|
Change the referenced status of the compound.
If -sir/setIsReferenced is true, the compound will be made public,
else the compound will be made private to its parent compound.
|
|
-setMetaData(-smd)
|
string string[]
|
|
|
Set the value of a metatada.
The arguments are, in order, metadata name, metadata values to be set.
|
|
-setMetaDataFromString(-mfs)
|
string
|
|
|
Set metadata using a string. This allows creating hierarchies of metadata.
The values of keys that already exist will be replaced with the new values.
The format is key=values separated by semi-colons, and braces
to define a sub-list of key/value pairs. Quotes are optional, but strings
using spaces or separators must be quoted. Quotes and backslashes can be escaped
with a backslash. Python-style single quotes are not accepted.
Example of format:
"house=red;car="blue and green"
"house=red,blue,yellow;hat={color=yellow;height="high"};cake={flavor="choco";topping="plenty"}
|
|
-setPortDataType(-spt)
|
string string
|
|
|
Set the data type of a specified compound port.
|
|
-setPortDefaultValues(-spv)
|
string string[]
|
|
|
Set the default value(s) to a specified port
The port cannot be connected.
The arguments are, in order, the port name and the value(s).
The value argument is an array of string that must contain the proper number of
element depending of the data type of the port (ie. 3 elements for a float3 data type).
For scalar data types ((ie. float or string) a single string value can be used.
|
|
-setPortMetaDataValue(-spm)
|
string string string
|
|
|
Set the metadata value of a specified compound port. The arguments are, in order,
port name, metadata name, metadata value to be set.
|
|
-specializedTypeName(-stn)
|
|
|
|
Used to query the specialized implementation class names
such as "Bifrost_DoWhile", or "Compound" for a normal compound
|
|
Flag can appear in Edit mode of command
Flag can appear in Query mode of command