import { ConnectException } from "./exceptions.js";
class RenderGraph {
/**
* Manages the rendering graph.
*/
constructor() {
this.connections = [];
}
/**
* Get a list of nodes which are connected to the output of the passed node.
*
* @param {GraphNode} node - the node to get the outputs for.
* @return {GraphNode[]} An array of the nodes which are connected to the output.
*/
getOutputsForNode(node) {
let results = [];
this.connections.forEach(function(connection) {
if (connection.source === node) {
results.push(connection.destination);
}
});
return results;
}
/**
* Get a list of nodes which are connected, by input name, to the given node. Array contains objects of the form: {"source":sourceNode, "type":"name", "name":inputName, "destination":destinationNode}.
*
* @param {GraphNode} node - the node to get the named inputs for.
* @return {Object[]} An array of objects representing the nodes and connection type, which are connected to the named inputs for the node.
*/
getNamedInputsForNode(node) {
let results = [];
this.connections.forEach(function(connection) {
if (connection.destination === node && connection.type === "name") {
results.push(connection);
}
});
return results;
}
/**
* Get a list of nodes which are connected, by z-index name, to the given node. Array contains objects of the form: {"source":sourceNode, "type":"zIndex", "zIndex":0, "destination":destinationNode}.
*
* @param {GraphNode} node - the node to get the z-index refernced inputs for.
* @return {Object[]} An array of objects representing the nodes and connection type, which are connected by z-Index for the node.
*/
getZIndexInputsForNode(node) {
let results = [];
this.connections.forEach(function(connection) {
if (connection.destination === node && connection.type === "zIndex") {
results.push(connection);
}
});
results.sort(function(a, b) {
return a.zIndex - b.zIndex;
});
return results;
}
/**
* Get a list of nodes which are connected as inputs to the given node. The length of the return array is always equal to the number of inputs for the node, with undefined taking the place of any inputs not connected.
*
* @param {GraphNode} node - the node to get the inputs for.
* @return {GraphNode[]} An array of GraphNodes which are connected to the node.
*/
getInputsForNode(node) {
let inputNames = node.inputNames;
let results = [];
let namedInputs = this.getNamedInputsForNode(node);
let indexedInputs = this.getZIndexInputsForNode(node);
if (node._limitConnections === true) {
for (let i = 0; i < inputNames.length; i++) {
results[i] = undefined;
}
for (let connection of namedInputs) {
let index = inputNames.indexOf(connection.name);
results[index] = connection.source;
}
let indexedInputsIndex = 0;
for (let i = 0; i < results.length; i++) {
if (results[i] === undefined && indexedInputs[indexedInputsIndex] !== undefined) {
* Check if a named input on a node is available to connect too.
* @param {GraphNode} node - the node to check.
* @param {String} inputName - the named input to check.
*/
isInputAvailable(node, inputName) {
if (node._inputNames.indexOf(inputName) === -1) return false;
for (let connection of this.connections) {
if (connection.type === "name") {
if (connection.destination === node && connection.name === inputName) {
return false;
}
}
}
return true;
}
/**
* Register a connection between two nodes.
*
* @param {GraphNode} sourceNode - the node to connect from.
* @param {GraphNode} destinationNode - the node to connect to.
* @param {(String | number)} [target] - the target port of the conenction, this could be a string to specfiy a specific named port, a number to specify a port by index, or undefined, in which case the next available port will be connected to.
* @return {boolean} Will return true if connection succeeds otherwise will throw a ConnectException.