Script
|
Nodes are synonymous with Filter, IO, Move and Group Modules in the Network View. More...
#include <nodeinterface.h>
Public Slots | |
Node Data. | |
String | root () |
returns the name of the Top level in the network, which is "Top". More... | |
bool | isGroup (String &node) |
returns a true or false value indicating if the module is a Group Module. More... | |
String | getName (String &node) |
returns the name of a module More... | |
String | type (String node) |
returns the module type. These are all of the built-in module types available from the Stage Module like: READ, COMPOSITE, PEG, QUADMAP, SHADOW, etc More... | |
int | numberOfSubNodes (String &parent) |
returns an integer that indicates the number of modules contained in a group. More... | |
QScriptValue | subNodes (String &parentGroup) |
return an array of sub nodes. More... | |
String | subNode (String &parent, int iSubNode) |
returns the path of a module in a group. Modules are counted starting with zero More... | |
String | subNodeByName (String &parent, String name) |
This function returns the full path name of a child node belonging to a parent group. This function will validate that the parent group exists and that the child node exists in that parent. This function should be used instead of manually concatenating the full path name of child nodes. More... | |
String | parentNode (String &node) |
returns the path of the parent level of a module contained in a group More... | |
String | noNode () |
returns the null string that is returned by other functions when there is an error. More... | |
bool | equals (String node1, String node2) |
returns true or false to indicate if a node path is equal to another. Used to compare node paths. More... | |
String | getTextAttr (String node, double atFrame, String attrName) |
returns the value(s) of the module's selected attribute(s). More... | |
SCR_AttributeWrapper * | getAttr (String node, double atFrame, String attrName) |
returns a SCR_AttributeWrapper object that represents the module's selected attribute(s). More... | |
QList< SCR_AttributeWrapper * > | getAttrList (String node, double atFrame, String attrName=String::null) |
returns a list of SCR_AttributeWrapper objects in specified module or module complex attribute. More... | |
String | linkedColumn (String node, String attrName) |
returns the name of the column that an attribute is linked to. If the attribute is not linked to a column, the function returns the null string. More... | |
virtual int | coordX (String node) |
returns an integer indicating the X position of a module in the network More... | |
virtual int | coordY (String node) |
returns an integer indicating the Y position of a module in the network More... | |
virtual int | width (String node) |
returns the width of a given node. This width / height parameter is useful for computing the position of nodes in the Network view. It uses the same unit system as the coordX() and coordY() functions. More... | |
virtual int | height (String node) |
returns the height of a given node. This width / height parameter is useful for computing the position of nodes in the Network view. It uses the same unit system as the coordX() and coordY() functions. More... | |
virtual bool | setCoord (String node, int x, int y) |
sets the position of a module in the network. More... | |
int | numberOfInputPorts (String node) |
the number of input ports on the module. More... | |
bool | isLinked (String node, int iPort) |
returns true or false to indicate if a port is connected to another module. More... | |
String | srcNode (String node, int iPort) |
returns the path for the module that the port is linked to. More... | |
String | flatSrcNode (String node, int iPort) |
If the srcNode is a Group Module, this function returns the path of the module inside the Group Module that is the source. If the source is not inside a group, the flatSrcNode function behaves like the srcNode function. More... | |
QScriptValue | srcNodeInfo (String &node, int iPort) |
returns the source node path, the port number and the link ID for this destination node is connected to. More... | |
int | numberOfOutputPorts (String node) |
the number of output ports on a module. More... | |
int | numberOfOutputLinks (String node, int iPort) |
the number of modules actually linked from the output ports. More... | |
String | dstNode (String sourceNode, int iPort, int iLink) |
returns the path of the destination module linked to by the output port on the source module. More... | |
QScriptValue | dstNodeInfo (String &node, int iPort, int iLink) |
return the path and addition information of the destination moduled linked to the source node. More... | |
bool | groupAtNetworkBuilding (String node) |
returns true if the peg's groupAtNetworkBuilding attribute is true. More... | |
bool | addCompositeToGroup (String node) |
returns the value of the "Add Composite To Group" attribute of the peg-module. This method is obsolete. More... | |
Node Editing | |
String | add (String parentGroup, String name, String type, int x, int y, int z) |
adds a module to the network. More... | |
String | getGroupInputModule (String parentGroup, String name, int x, int y, int z) |
Return existing or add a group multi port in module. More... | |
String | getGroupOutputModule (String parentGroup, String name, int x, int y, int z) |
Return existing or add a group multi port out module. More... | |
bool | deleteNode (String name, bool deleteTimedValues=false, bool deleteElements=false) |
Delete a single node. Optionally, delete all columns and element associated to that node. The column and element would only be removed when no other modules refer to them. This function returns true when successful. More... | |
String | createGroup (String nodes, String groupName) |
Create a group from the selection of nodes. The list of nodes is a string where the nodes are separated by commas. The actual name of each node in the list of nodes must include the full path of that node. The function returns the full path of the created group, or an empty string if the creation of the node failed. More... | |
String | moveToGroup (String nodeName, String groupName) |
moves the specified node within the specified group. Similar to performing a drag and drop of a node to a group from the timeline. More... | |
bool | explodeGroup (String groupName) |
Explode a group into its parent group. This function is identical to the "Explode Selected Group" from the Network view. More... | |
bool | rename (String node, String newName) |
changes the name of a module. More... | |
bool | createDynamicAttr (String node, String type, String attrName, String displayName, bool linkable) |
create a new attribute in specified module. More... | |
bool | removeDynamicAttr (String node, String attrName) |
remove a dynamic attribute in specified module. More... | |
bool | setTextAttr (String node, String attrName, int atFrame, String attrValue) |
changes the value of an attribute in a module. More... | |
bool | linkAttr (String node, String attrName, String columnName) |
links an attribute to a function column in the Xsheet View. More... | |
bool | unlinkAttr (String node, String attrName) |
unlinks an attribute from a function column. More... | |
bool | link (String srcNode, int srcPort, String dstNode, int dstPort) |
links a port on a module to a port on another module. More... | |
bool | link (String srcNode, int srcPort, String dstNode, int dstPort, bool mayAddOutputPort, bool mayAddInputPort) |
links a port on a module to a port on another module. Fancy version that allow easier connecting to a group module, or setup the proper connection order. More... | |
bool | unlink (String dstNode, int inPort) |
unlinks a port on one module from the port on another module. More... | |
bool | setEnable (String node, bool flag) |
Setters and getters for the enable/disable property of a node. More... | |
bool | getEnable (String node) |
returns whether a module is enabled or not. More... | |
bool | setLocked (String node, bool lock) |
Setters and getters for the lock/unlock property of a node. More... | |
bool | getLocked (String node) |
returns the lock flag More... | |
bool | setTimelineTag (String node, bool lock) |
sets the timeline tag flag More... | |
bool | getTimelineTag (String node) |
returns the timeline tag flag More... | |
StringList | getTimelineTagList (String node=QNTR("Top"), StringList list=StringList()) |
bool | setColor (String node, ColorRGBA *color) |
sets the node color More... | |
bool | resetColor (String node) |
resets the node color More... | |
ColorRGBA * | getColor (String node) |
returns the node color More... | |
bool | setAsGlobalDisplay (String node) |
This function changes the global display used in the application. The node must be the full path of a display module. More... | |
bool | setGlobalToDisplayAll () |
This function changes the global display used by the application to "Display All" pseudo-display. More... | |
bool | setAsDefaultCamera (String node) |
Setters and getters for the default camera. More... | |
String | getDefaultCamera () |
returns the name of the default camera. More... | |
StringList | getCameras () |
Returns a list of all cameras within the scene. More... | |
int | getMaxVersionNumber (String node) |
int | getVersion (String node) |
void | setVersion (String node, int version) |
StringList | getNodes (StringList &types) |
Returns a collection of node paths for nodes of specified types. More... | |
QObject * | getMatrix (String node, int frame) |
returns the model matrix of a node. More... | |
QObject * | getPivot (String node, int frame) |
returns the pivot of the module More... | |
ColorOverride * | getColorOverride (String node) |
returns the ColorOverride object for the colour override module More... | |
void | explodeElementSymbolsInGroups (String element, bool disableElement, bool clearExposure, String &prefix=String()) |
This function creates a group for each exposure of element elem where there is a symbol and will put the content of the symbol in that group. If disable element is TRUE, will disable the element afterwards. If clearExposure is TRUE, will clear the exposures where there were symbols afterwards. Will use prefix as the prefix for the generated group names. More... | |
Nodes are synonymous with Filter, IO, Move and Group Modules in the Network View.
With Node functions, you can retrieve values from modules in your effects and compositing network. You can also use these functions to add and link modules in your network, and set their attributes.
Because there can be identical module names in the effects network, you must use the full path to identify a module. Similarly, when functions return module names, they often use the full path.
The syntax for module paths is:
Top/Group_Name/Module_Name
You can use it in Script Editor only.
The parentNode function in this script adds the Composite Module in the parent group of the selected modules. The link function, in a loop, connects all selected modules to the new Composite Module. The setCoord function positions the new module in the network.
|
slot |
adds a module to the network.
parent_group_path | The path of the parent node into which you want to add this module |
name | The name of the module you will add. |
type | The type of module you will add. The module types are like: READ, COMPOSITE, PEG, QUADMAP, SHADOW, etc. |
X | : The X position of the module in the Network View. |
Y | : The Y position of the module in the Network View. |
Z | : The Z position of the module in the Network View. This property is important when two modules overlap |
|
slot |
returns the value of the "Add Composite To Group" attribute of the peg-module. This method is obsolete.
node | the path of the module |
|
virtualslot |
returns an integer indicating the X position of a module in the network
node | the path of the module |
|
virtualslot |
returns an integer indicating the Y position of a module in the network
node | the path of the module |
|
slot |
create a new attribute in specified module.
node | the name of the module. |
type | Type of attribute to create. |
attrName | The name of the attribute. |
linkable | Linkable status. |
|
slot |
Create a group from the selection of nodes. The list of nodes is a string where the nodes are separated by commas. The actual name of each node in the list of nodes must include the full path of that node. The function returns the full path of the created group, or an empty string if the creation of the node failed.
The parent of the group is implicitly specified. It will be the same as the parent of the first node in the list.
nodes | This a comma delimited list of names of nodes. ( node0,node1,node2) |
groupName | The name of the group to create. The actual group |
|
slot |
Delete a single node. Optionally, delete all columns and element associated to that node. The column and element would only be removed when no other modules refer to them. This function returns true when successful.
node | the path of the module |
deleteTimedValues | A boolean that indicates if the columns referenced by that node shall be removed if they are no longer in use. |
deleteElements | A boolean that indicates if the element should also be removed, if they are no longer in use. |
|
slot |
returns the path of the destination module linked to by the output port on the source module.
sourceNode | the path of the module |
iPort | The port number on which you want to find the connected module. This value is between 0 and the results of the numberOfOutputPorts function. |
iLink | The link number whose destination module you want to find. This value is between 0 and the results of the numberOfInpuftLinks function. |
|
slot |
return the path and addition information of the destination moduled linked to the source node.
sourceNode | : the path of the source module. |
iPort | the output port number on which you want to find the connected module. This value is between 0 and the results of numberOfOutputPorts(). |
iLink | the link number whose destination module you want to find. This value is between 0 and the results of the numberOfInputLinks() function. |
This function returns an object that contains two attributes node - the path to connected node. port - the port number on which this node is connected to.
|
slot |
returns true or false to indicate if a node path is equal to another. Used to compare node paths.
node1 | the path of the first module |
node2 | the path of the second module |
|
slot |
This function creates a group for each exposure of element elem where there is a symbol and will put the content of the symbol in that group. If disable element is TRUE, will disable the element afterwards. If clearExposure is TRUE, will clear the exposures where there were symbols afterwards. Will use prefix as the prefix for the generated group names.
|
slot |
Explode a group into its parent group. This function is identical to the "Explode Selected Group" from the Network view.
This function returns true if successful.
node | the name of the module |
|
slot |
If the srcNode is a Group Module, this function returns the path of the module inside the Group Module that is the source. If the source is not inside a group, the flatSrcNode function behaves like the srcNode function.
node | the path of the module |
iPort | the port number on the destination module whose source module you want to find. This value is between 0 and the results of the numberOfInputPorts function. |
|
slot |
returns a SCR_AttributeWrapper object that represents the module's selected attribute(s).
node | the path of the module |
atFrame | the frame number from which you want to extract the attribute value. If the value is static, you must still pass a value. You can, for example, pass 1 to take the value at the first frame. |
attrName | The attribute whose value you want. |
|
slot |
returns a list of SCR_AttributeWrapper objects in specified module or module complex attribute.
node | the path of the module |
atFrame | the frame number from which you want to extract the attribute value. If the value is static, you must still pass a value. You can, for example, pass 1 to take the value at the first frame. |
attrName | The container attribute or an empty string if you want all top level attributes. |
|
slot |
Returns a list of all cameras within the scene.
|
slot |
returns the node color
node | the name of the module. |
|
slot |
returns the ColorOverride object for the colour override module
node | the name of the module |
|
slot |
returns the name of the default camera.
|
slot |
returns whether a module is enabled or not.
node | the name of the module |
|
slot |
Return existing or add a group multi port in module.
|
slot |
Return existing or add a group multi port out module.
|
slot |
returns the lock flag
node | the name of the module |
|
slot |
returns the model matrix of a node.
node | the name of the module |
Frame | is the int that specifies the frame number |
|
slot |
Returns the number of versions of the module available.
node | : the name of the module |
|
slot |
returns the name of a module
node | the path of the module |
|
slot |
Returns a collection of node paths for nodes of specified types.
types | list of node types to search for |
Example usage:
|
slot |
returns the pivot of the module
node | the name of the module |
frame | is the int that specified the frame number |
|
slot |
returns the value(s) of the module's selected attribute(s).
node | the path of the module |
atFrame | the frame number from which you want to extract the attribute value. If the value is static, you must still pass a value. You can, for example, pass 1 to take the value at the first frame. |
attrName | The attribute whose value you want. |
Use the attribute PALETTES.NUMBER to return the number of palettes in the colour override module's palette list. Use the attribute PALETTES.x to return the palette at index x from the colour override module's palette list. x is a number between 0 and the number of palettes in the list, minus one. If x is not given (argument is "PALETTES") or x is not valid (< 0 or out of range) then 0 is assumed.
|
slot |
returns the timeline tag flag
node | the name of the module |
|
slot |
|
slot |
Returns the current version of the module. Module may have multiple versions if their rendering output have changed over time.
node | the name of the module |
|
slot |
returns true if the peg's groupAtNetworkBuilding attribute is true.
node | the path of the module |
|
virtualslot |
|
slot |
returns a true or false value indicating if the module is a Group Module.
node | the path of the module |
|
slot |
returns true or false to indicate if a port is connected to another module.
node | the path of the module |
iPort | The number of the port whose link status you want to check. This value is between 0 and the results of the numberOfInputPorts function. |
|
slot |
links a port on a module to a port on another module.
srcNode | : The path of the module whose output port you want to link to a destination module. |
srcPort | The port that you want to link to the input port on the destination module. This value is between 0 and the results of the numberOfOutputPorts function. |
dstNode | The path of the module whose input port you want to link to the source module. |
dstPort | The port on the destination module that you want to link to the output port from the source module. This value is between 0 and the results of the numberOfInputPorts function. |
|
slot |
links a port on a module to a port on another module. Fancy version that allow easier connecting to a group module, or setup the proper connection order.
srcNode | : The path of the module whose output port you want to link to a destination module. |
srcPort | The port that you want to link to the input port on the destination module. This value is between 0 and the results of the numberOfOutputPorts function. |
dstNode | The path of the module whose input port you want to link to the source module. |
dstPort | The port on the destination module that you want to link to the output port from the source module. This value is between 0 and the results of the numberOfInputPorts function. |
mayAddOutputPort | used by group multiport modules - automatically create a new output port for these modules. |
mayAddInputPort | used by group multiport and composite - automatically create input ports for these modules. |
|
slot |
links an attribute to a function column in the Xsheet View.
node | the name of the module |
attrName | The name of the attribute |
columnName | The name of the column that you want to link to the attribute |
|
slot |
returns the name of the column that an attribute is linked to. If the attribute is not linked to a column, the function returns the null string.
node | the path of the module |
attrName | The attribute you want to check to see if it is linked to a column |
|
slot |
moves the specified node within the specified group. Similar to performing a drag and drop of a node to a group from the timeline.
nodeName | the name of the module |
group_path | The path of the group. |
|
slot |
returns the null string that is returned by other functions when there is an error.
|
slot |
the number of input ports on the module.
node | the path of the module |
|
slot |
the number of modules actually linked from the output ports.
node | the path of the module |
iPort | The port number on which you want to locate the module that is connected to it. This value is between 0 and the results of the numberOfInputPorts function. |
|
slot |
the number of output ports on a module.
node | the path of the module |
|
slot |
returns an integer that indicates the number of modules contained in a group.
parent | the path of the parent module |
|
slot |
returns the path of the parent level of a module contained in a group
node | the path of the module |
|
slot |
remove a dynamic attribute in specified module.
node | the name of the module. |
attrName | the name of the attribute. |
|
slot |
changes the name of a module.
node | the name of the module |
newName | The new name for the module. |
|
slot |
resets the node color
node | The name of the module. |
|
slot |
returns the name of the Top level in the network, which is "Top".
|
slot |
Setters and getters for the default camera.
sets the default camera in the scene. Returns whether successful or not.
node | the name of the camera |
|
slot |
This function changes the global display used in the application. The node must be the full path of a display module.
This function returns true if successful. It returns false if the display node was not found or an invalid name was provided.
node | The full path of a display node |
|
slot |
sets the node color
node | The name of the module. |
color | The new color set for the module. |
|
virtualslot |
sets the position of a module in the network.
node | the path of the module |
X | The X position of the module in the Network View |
Y | The Y position of the module in the Network View |
|
slot |
Setters and getters for the enable/disable property of a node.
sets the enable flag of the node.
node | the name of the module |
flag | : true or false |
|
slot |
This function changes the global display used by the application to "Display All" pseudo-display.
This function returns true if successful.
|
slot |
Setters and getters for the lock/unlock property of a node.
sets the lock flag
node | the name of the module |
|
slot |
changes the value of an attribute in a module.
Additions specific to the Colour Override module: Use the attribute PALETTES.CLEAR to clear the palette list in the colour override module. Use the attribute PALETTES.ADD to add a palette to the palette list of the colour override module. Use the attribute PALETTES.REMOVE to remove a palette from the palette list of the colour override module.
node | the name of the module |
attrName | The name of the attribute whose value you want to change. |
atFrame | the frame number at which you set the value. |
attrValue | : new value |
|
slot |
sets the timeline tag flag
node | the name of the module |
tag | : new tag state of the module. |
|
slot |
Set the version of the module to use.
node | the name of the module |
|
slot |
returns the path for the module that the port is linked to.
node | the path of the module |
iPort | he port number on the destination module whose source module you want to find. This value is between 0 and the results of the numberOfInputPorts function. |
|
slot |
returns the source node path, the port number and the link ID for this destination node is connected to.
node | the path to the source node (module). |
iPort | thie port number of which you want to locage the module that is connected to it. This value is between 0 and the result of 'numberOfInputPorts()' function. |
This function is similar to srcNode(), however, it returns an object that contains 3 attribute. node - the path of the source node this destination node is linked to. This is the same value as the value returned by 'srcNode()'. port - this is the output port number in the source node that this destination node is connected to. link - this is the link number in the output port of the source node for this connection.
|
slot |
returns the path of a module in a group. Modules are counted starting with zero
parent | the path of the parent module |
iSubNode | An integer representing the numerical value of the module. This value must be between 0 and the numberOfSubNodes function for that point. |
|
slot |
This function returns the full path name of a child node belonging to a parent group. This function will validate that the parent group exists and that the child node exists in that parent. This function should be used instead of manually concatenating the full path name of child nodes.
parent | Fully qualified path of the parent group. |
name | The actual node name suffix. This one is only the short name, not the full path of the node |
|
slot |
return an array of sub nodes.
parent | the path of the parent module |
|
slot |
returns the module type. These are all of the built-in module types available from the Stage Module like: READ, COMPOSITE, PEG, QUADMAP, SHADOW, etc
node | the path of the module |
|
slot |
unlinks a port on one module from the port on another module.
dstNode | The path of the module whose input port you want to unlink from the source module. |
inPort | The input port that you want to unlink. This value is between 0 and the results of the numberOfInputPorts function. |
|
slot |
unlinks an attribute from a function column.
node | the name of the module |
attrName | The name of the attribute that you want to unlink. |
|
virtualslot |