Working with Objects

Overview

Objects are the primary building blocks of a Grid Studio project.

They represent system components such as devices, sensors, cameras, logic containers, or data processing elements. Objects can contain parameters, data connections, workflows, modifiers, and other functionality.

Understanding how to create and manage objects is essential when building and organizing a project.


Creating Objects

Objects can be created directly within the Project Tree.

circle-info

For a detailed explanation of the object creation interface, see: Project Tree → Managing Project Structure

To create a new object:

  1. Open the Project Tree

  2. Click the Add Object (+) button in the header

  3. Select the desired object type from the list

The creation menu contains:

  • native Grid Studio objects

  • devices and protocol integrations

  • sensors and tracking systems

  • extensions installed from the Library

circle-exclamation

Searching Object Types

The object creation menu includes a search field to quickly locate specific object types.

Selecting an object from the list will create it inside the project.

circle-info

For a detailed explanation of the object creation interface, see: Project Tree → Managing Project Structure Search


Organizing Objects

Objects can be organized hierarchically within the Project Tree.

To create a hierarchy, drag one object onto another. The dragged object becomes a child of the target object.

Hierarchies are commonly used to:

  • group related objects

  • create spatial relationships

  • define transformation hierarchies

  • organize complex systems

Child objects inherit certain transformations or states from their parent.


Selecting Objects

Objects can be selected in multiple ways:

  • directly in the Project Tree

  • inside the Viewport (if the object has a mesh representation)

  • through other views that reference the object

Selecting an object updates dynamic views such as:

  • Inspector

  • Artboard

  • Node Editor

  • Timeline

  • Flow Chart

This allows users to quickly inspect and modify objects.


Renaming Objects

Objects can be renamed in several ways within the Grid Studio interface.

Project Tree

Objects can be renamed directly inside the Project Tree.

Two methods are available:

  • Double-click the object name and type a new name

  • Press F2 to open the rename dialog

Inspector

Objects can also be renamed in the Inspector.

To rename an object there, simply double-click the object name in the Inspector header and enter the new name.

Application Menu

Objects can also be renamed using the Application Menu.

Select the object and choose the rename option from the menu to open the rename dialog.


Enabling and Disabling Objects

Objects can be enabled or disabled using the toggle icon in the Project Tree.

When an object is disabled:

  • it stops processing

  • it no longer sends or receives data

  • its internal systems are inactive

Disabling an object also affects its internal functionality such as workflows, modifiers, or data mappings.


Object Hierarchies

Objects can exist within parent-child hierarchies.

This structure is commonly used to:

  • organize systems

  • create logical groupings

  • control spatial relationships

  • define transformation chains

For example, when working with 3D objects, child objects inherit the transformation of their parent.


Object Status

Some objects display status indicators next to their name in the Project Tree.

These indicators provide quick visual feedback about the object's internal state.

The meaning of the colors depends on the specific object type.


Best Practices

When working with objects in larger projects, it is recommended to:

  • organize objects into logical hierarchies

  • use clear and descriptive names

  • disable objects that are not currently needed

  • group related systems together

These practices make complex projects easier to manage and debug.


  • Objects – Understanding the role of objects in a project

  • Project Tree – Navigating and organizing project structures

  • Inspector – Editing object parameters and properties

Last updated