API Docs for:
Show:

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 Object

    data from previous serialization [optional]

Methods

add

(
  • node
)

Adds a new node instasnce to this graph

Parameters:

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 String

    configure a graph from a JSON string

  • returns Boolean

    if there was any error parsing

detachCanvas

(
  • graph_canvas
)

Detach Canvas from this graph

Parameters:

  • graph_canvas GraphCanvas

findNodesByClass

(
  • classObject
)
Array

Returns a list of nodes that matches a class

Parameters:

  • classObject Class

    the class itself (not an string)

Returns:

Array:

a list with all the nodes of this type

findNodesByTitle

(
  • name
)
Array

Returns a list of nodes that matches a name

Parameters:

  • name String

    the name of the node to search

Returns:

Array:

a list with all the nodes with this name

findNodesByType

(
  • type
)
Array

Returns a list of nodes that matches a type

Parameters:

  • type String

    the name of the node type

Returns:

Array:

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:

Array:

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:

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:

number of milliseconds the graph has been running

getGroupOnPos

(
  • x
  • y
)
LGraphGroup

Returns the top-most group in that position

Parameters:

  • x Number

    the x coordinate in canvas space

  • y Number

    the y coordinate in canvas space

Returns:

LGraphGroup:

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
)
LGraphNode

Returns the top-most node in this position of the canvas

Parameters:

  • x Number

    the x coordinate in canvas space

  • y Number

    the y coordinate in canvas space

  • nodes_list Array

    a list with all the nodes to search from, by default is all the nodes in the graph

Returns:

LGraphNode:

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:

number of milliseconds the graph has been running

isLive

()

returns if the graph is in live mode

remove

(
  • node
)

Removes a node from the graph

Parameters:

removeInput

(
  • name
  • type
)

Removes a global graph input

Parameters:

  • name String
  • type String

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 Number

    number of steps to run, default is 1

sendEventToAllNodes

(
  • eventname
  • params
)

Sends an event to all the nodes, useful to trigger stuff

Parameters:

  • eventname String

    the name of the event (function to be called)

  • params Array

    parameters in array format

serialize

() Object

Creates a Object containing all the info about this graph, it can be serialized

Returns:

Object:

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 Number

    amount 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.