LGraph Class
LGraph is the class that contain a full graph. We instantiate one and add nodes to it, and then we can run the execution loop.
Constructor
LGraph
-
o
Parameters:
-
o
Objectdata from previous serialization [optional]
Item Index
Methods
- add
- addGlobalInput
- addOutput
- arrange
- attachCanvas
- changeInputType
- changeOutputType
- clear
- clearTriggeredSlots
- configure
- detachCanvas
- findNodesByClass
- findNodesByTitle
- findNodesByType
- getAncestors
- getElapsedTime
- getFixedTime
- getGroupOnPos
- getInputData
- getNodeById
- getNodeOnPos
- getOutputData
- getTime
- isLive
- remove
- removeInput
- removeLink
- removeOutput
- renameInput
- renameOutput
- runStep
- sendEventToAllNodes
- serialize
- setGlobalInputData
- setOutputData
- start
- stop execution
- updateExecutionOrder
Methods
add
-
node
Adds a new node instasnce to this graph
Parameters:
-
node
LGraphNodethe instance of the node
addGlobalInput
-
name
-
type
-
value
Tell this graph it has a global graph input of this type
Parameters:
-
name
String -
type
String -
value
[optional]
addOutput
-
name
-
type
-
value
Creates a global graph output
Parameters:
-
name
String -
type
String -
value
arrange
()
Positions every node in a more readable manner
attachCanvas
-
graph_canvas
Attach Canvas to this graph
Parameters:
-
graph_canvas
GraphCanvas
changeInputType
-
name
-
type
Changes the type of a global graph input
Parameters:
-
name
String -
type
String
changeOutputType
-
name
-
type
Changes the type of a global graph output
Parameters:
-
name
String -
type
String
clear
()
Removes all nodes from this graph
clearTriggeredSlots
()
clears the triggered slot animation in all links (stop visual animation)
configure
-
str
-
returns
Configure a graph from a JSON string
Parameters:
-
str
Stringconfigure a graph from a JSON string
-
returns
Booleanif there was any error parsing
detachCanvas
-
graph_canvas
Detach Canvas from this graph
Parameters:
-
graph_canvas
GraphCanvas
findNodesByClass
-
classObject
Returns a list of nodes that matches a class
Parameters:
-
classObject
Classthe class itself (not an string)
Returns:
a list with all the nodes of this type
findNodesByTitle
-
name
Returns a list of nodes that matches a name
Parameters:
-
name
Stringthe name of the node to search
Returns:
a list with all the nodes with this name
findNodesByType
-
type
Returns a list of nodes that matches a type
Parameters:
-
type
Stringthe name of the node type
Returns:
a list with all the nodes of this type
getAncestors
()
Array
Returns all the nodes that could affect this one (ancestors) by crawling all the inputs recursively. It doesnt include the node itself
Returns:
an array with all the LGraphNodes that affect this node, in order of execution
getElapsedTime
()
Number
Returns the amount of time it took to compute the latest iteration. Take into account that this number could be not correct if the nodes are using graphical actions
Returns:
number of milliseconds it took the last cycle
getFixedTime
()
Number
Returns the amount of time accumulated using the fixedtime_lapse var. This is used in context where the time increments should be constant
Returns:
number of milliseconds the graph has been running
getGroupOnPos
-
x
-
y
Returns the top-most group in that position
Parameters:
-
x
Numberthe x coordinate in canvas space
-
y
Numberthe y coordinate in canvas space
Returns:
the group or null
getInputData
-
name
Returns the current value of a global graph input
Parameters:
-
name
String
Returns:
the data
getNodeById
-
id
Returns a node by its id.
Parameters:
-
id
Number
getNodeOnPos
-
x
-
y
-
nodes_list
Returns the top-most node in this position of the canvas
Parameters:
-
x
Numberthe x coordinate in canvas space
-
y
Numberthe y coordinate in canvas space
-
nodes_list
Arraya list with all the nodes to search from, by default is all the nodes in the graph
Returns:
the node at this position or null
getOutputData
-
name
Returns the current value of a global graph output
Parameters:
-
name
String
Returns:
the data
getTime
()
Number
Returns the amount of time the graph has been running in milliseconds
Returns:
number of milliseconds the graph has been running
isLive
()
returns if the graph is in live mode
removeInput
-
name
-
type
Removes a global graph input
Parameters:
-
name
String -
type
String
removeLink
-
link_id
Destroys a link
Parameters:
-
link_id
Number
removeOutput
-
name
Removes a global graph output
Parameters:
-
name
String
renameInput
-
old_name
-
new_name
Changes the name of a global graph input
Parameters:
-
old_name
String -
new_name
String
renameOutput
-
old_name
-
new_name
Renames a global graph output
Parameters:
-
old_name
String -
new_name
String
runStep
-
num
Run N steps (cycles) of the graph
Parameters:
-
num
Numbernumber of steps to run, default is 1
sendEventToAllNodes
-
eventname
-
params
Sends an event to all the nodes, useful to trigger stuff
Parameters:
-
eventname
Stringthe name of the event (function to be called)
-
params
Arrayparameters in array format
serialize
()
Object
Creates a Object containing all the info about this graph, it can be serialized
Returns:
value of the node
setGlobalInputData
-
name
-
data
Assign a data to the global graph input
Parameters:
-
name
String -
data
setOutputData
-
name
-
value
Assign a data to the global output
Parameters:
-
name
String -
value
String
start
-
interval
Starts running this graph every interval milliseconds.
Parameters:
-
interval
Numberamount of milliseconds between executions, if 0 then it renders to the monitor refresh rate
stop execution
()
Stops the execution loop of the graph
updateExecutionOrder
()
Updates the graph execution order according to relevance of the nodes (nodes with only outputs have more relevance than nodes with only inputs.