Logic Editor

Logic in Incari is what allows us to take our 2D/3D Assets and turn them into fully interactive User Interfaces. Traditionally, building this kind of complex system was only achievable by writing a lot of code. However, by utilizing Incari's powerful visual scripting tools, we can build these systems without writing a single line. This section introduces you to some of the core concepts and terminologies of Incari's Logic Editor.

1 - Logic Editor Window

Logic Editor - The main window which contains all things Logic-related. It is compartmentalized into several different sections discussed below.

2 - Toolbar

The Toolbar shows a list of icons that are used to visualize certain features in the Logic Graph. Definitions of the icons are as follows:

3 - Top Panel

The top panel represents Logic Graphs that are implemented for different Incari items, such as the current opened Project, the selected Scene in the Project Outliner, and Functions added to the Logic Editor. Each Logic Graph can be accessed by using the tabs on the top panel.

4 - Left Panel

The left panel contains Nodes that can be added to the Logic Editor and is divided into five sections. These are Explorer, Toolbox, Events, Functions, and Variables.

Each section is described below:

All Nodes and Groups that are added to the Logic Graph will be listed in this section. When an item is picked in this section, the corresponding Node is selected in the Logic Graph.

5 - The Logic Graph / Node Graph

This is the most important section of the Logic Editor. If the Nodes and Variables are the paints and materials at your disposal, then the Logic Graph is the canvas. This is where we build our systems from the ground up and where you will spend most of your time while using Incari.

Fundamentally, it is comprised of a combination of two entities: Nodes and Connections.

Nodes

Nodes are components that each have a specific, singular function. The majority of Nodes evaluate data values based on input parameters, but they can also represent Variables, Events, and Objects.

Sockets

Sockets are like the ports on an electronic device. Along with Connections, they allow us to link Nodes to each other. In Incari, Sockets are either:

  • Input (receiving an instruction or data value). Sockets on the left-hand side of a Node are Input Sockets.

  • Output (sending an instruction or data value). Sockets on the right-hand side of a Node are Output Sockets.

Beyond that, we have Pulse and Data Sockets denoted by white triangles (►) and colored squares (■), respectively. For example, when we refer to an "Input Pulse Socket", we are normally referring to the white triangle in the top-left-hand side of a Node.

The concept of Sockets makes much more sense in the context of Connections.

Connections

Connections are the "wires" that link our components together. This is how we pass data between Nodes and how we determine the execution order of our Logic. Connections come in two categories and are related to the type of Socket they are plugged into. The two categories are Pulse and Data.

Pulse

These Connections do not carry any data between Nodes. What they do is tell Nodes that it is time for them to execute. Once a Node has finished its execution and its purpose has been fulfilled, the next Node connected via the Pulse Connection will then begin its task. Pulse Connections are represented by a white "wire" linking two Pulse Sockets, represented by white triangles (►). Multiple Connections can be plugged into a single Pulse Input Socket, however only one Connection can come out of a Pulse Output Socket. Pulse Connections are also referred to as Pulses.

Data

These Connections pass data values between Nodes. We do this by connecting the Data Output Socket of one Node into a Data Input Socket of another Node. Both the input and output Sockets must be of the same Data Type. Data Sockets are represented by a colored square (⬛), the color of which corresponds to the Data Type. Conversely to Pulse Connections, Data Input Sockets can take only one Input Connection, whereas Data Output Sockets can have multiple Output Connections. Unlike Pulse Connections, Data Connections do not initiate the execution of a Node.

6 & 7 - Node Attribute Editor

The Node Attribute Editor (referred to simply as Editor from here on) is similar to the Attribute Editor, except rather than adjusting the Attributes of Objects, we can adjust the Attributes of Nodes. Node Attributes are specific to that particular Node and are documented in their corresponding entry in the Toolbox section. Oftentimes, Node Attributes are simply an alternative to using Input Connections and can define a default value if there is no Connection attached to that particular Input Socket. There are exceptions, however, where Attributes can be set only in the Editor and there is no equivalent Socket available. These are discussed below in the Node-Specific Attributes section.

General Attributes

Coming under the "Node" heading of the Editor, these Attributes are available on nearly all Nodes and can only be set in the Editor.

All Nodes have the following Attributes:

  • Name - The name of the Node. This isn't editable unless it is a Function.

  • Type - The type of Node. This isn't editable and will often be the same as the name, unless the Node represents something which the user defines, like Functions, Variables, and Objects.

  • Enabled - Allows the entire Node to be ignored by enabling/disabling it. This is useful when you want to test and debug a specific part of your Logic, as you can disable entire Node Trees temporarily. All subsequent Nodes linked via Pulse Connections will not be executed.

Most Nodes also have an additional Attribute:

  • Pulse Pass Through - Similar to the Enabled Attribute above, it disables the evaluation of a Node. The difference with this option, however, is that subsequent Nodes linked via Pulse Connections will be executed. This is useful when you only want to disable part of a Node Tree, rather than the entire thing.

Node-Specific Attributes

As stated above, most Node Attributes are an alternative to Data Input Connections and allow us to set default values, in the absence of such a Connection. There are cases, though, where Attributes can only be set in the Editor, which modifies the way that the Node functions.

Data Types

Some Nodes work with different Data Types. However, these need to be explicitly defined in the Editor, so that the Node knows which Type it will receive (Input) and/or the Type of data it will return (Output). Where multiple Data Types are available, there will be a drop-down Menu in the Editor. Changing the Type will also change the color of the corresponding Socket.

Linked Objects

Some Node Attributes correspond to something outside of the Logic Editor, such as a Scene, Screen, Object, Text Object, or File. In this case, you will see a small square, which will either have a thumbnail, related to that Type of File or Object, or the text "drag here". To assign something to the Attribute, simply drag and drop it onto the square.

Adding Removing Sockets

There are a few Nodes in Incari that allow you to customize the number of Input/Output Sockets. The purpose for this is very specific to that particular Node, but the process of adding/removing parameters is the same.

By clicking the plus button (+) you can add additional elements, which will be added to the bottom of the list.

By clicking the cross button (x) you can remove elements. If you click the cross on the list header, it will remove all of the elements, whereas if you click the cross on a list item, you only remove that single element.

You can also rearrange the order of the elements by clicking and dragging elements using the rearrange button ().

Last updated