Managing Project Structure

Creating Objects

New objects can be added to the project using the Add Object (+) button located in the Project Tree header.

Clicking this button opens a list of available object types.

This list includes:

  • 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 also includes a search field, allowing users to quickly locate specific object types.

Selecting an object type from the list will create the object in the project.

Drag and Drop Creation

Objects can also be created using drag and drop from the object list.

Dragging an object type into the Project Tree allows users to place it directly within the desired hierarchy.

If an object type is simply clicked, it will be created at the root level of the project.

Context Menu Creation

Objects can also be created by right-clicking inside the Project Tree.

When clicking in an empty area below the existing objects, the same object creation menu will appear.


Organizing Objects

Objects can be reorganized within the Project Tree using drag and drop.

Dragging an object onto another object will place it as a child object within the hierarchy.

This allows users to structure their project logically and group related objects together.


Expanding and Collapsing Hierarchies

Objects that contain child elements display a small arrow icon on the left side.

Clicking this arrow expands or collapses the hierarchy, allowing users to show or hide child objects.

This helps keep the Project Tree organized when working with deeply nested structures.


Object Controls

When hovering the mouse over an object in the Project Tree, several quick-access controls appear on the right side.

These controls allow users to quickly modify object behavior.

Enable / Disable

Enables or disables the object within the project.

Disabled objects stop processing and no longer participate in system behavior.

Visibility

Controls whether the object is visible in the 3D Viewport.

If a parent object is hidden, all of its child objects become hidden as well.

Lock

Locks the object in the 3D Viewport, preventing it from being moved using transform controls or pivot tools.

This is useful for preventing accidental movement of objects during editing.


Status Indicators

Some objects display a status indicator next to their name.

This indicator appears as a colored circle and reflects the current status of the object.

The color and meaning of the indicator depend on the object type and its internal state.

Status indicators provide a quick visual overview of object conditions within the project.


Credits

The Project Tree also displays the credit usage of objects within the project.

Credits indicate how system resources are allocated across different objects. This information helps users understand how resources are distributed and identify objects that contribute to overall credit usage.

More detailed information about how the credit system works can be found in the Credits section.

Last updated