Project Settings
Overview
Project Settings contain configuration options that affect the entire Grid Studio project.
Unlike object parameters, which only affect individual objects, Project Settings define global behavior such as system performance, viewport configuration, default values, scripting environment settings, and external services.
These settings apply to the whole project and influence how different systems within Grid Studio operate and interact.
Project Settings can be accessed in two ways:
Application Menu
File → Project SettingsProject Tree
Click the project name at the top of the Project Tree, located next to the credit indicator.
Both methods open the same Project Settings window.
Structure of Project Settings
Project Settings are organized into several tabs, each focusing on a specific part of the system.
This structure separates global configuration into functional areas such as system performance, viewport configuration, networking, scripting, and editor behavior.
The following sections provide a brief overview of each tab.
Project
The Project tab contains general information about the project.
This includes metadata such as:
project name
author
version
description
These fields are primarily used for project identification and documentation.
The tab also includes a history section, which can be used to store notes or version history related to the project.
The Processes tab controls system update rates and timing behavior.
These settings influence how frequently different parts of the system update, including:
the main processing loop
GUI refresh rate
viewport update behavior
The tab also contains configuration related to timeline display and playback timing.
These settings can influence overall system responsiveness and performance.
The 3D Widget tab controls visual aspects of the 3D Viewport environment.
This includes configuration for:
grid size and spacing
grid and background colors
axis visibility
labels and helper overlays
viewport navigation settings
These settings affect how the scene is displayed and navigated inside the Viewport editor.
The Exposed Parameters tab allows users to define parameters that should be globally exposed.
These parameters can then be accessed externally, for example by Grid Runtime.
This mechanism makes it possible to publish selected project parameters for external control interfaces, dashboards, or runtime environments.
The Defaults tab defines default values used when creating certain objects or elements in the project.
Examples include default settings for:
timeline blocks
categories
device selection
These defaults help streamline workflows by automatically applying predefined values when creating new elements.
The Categories tab allows users to define and manage custom categories within the project.
Categories can be used to organize elements such as objects, timeline layers, or other project components.
The Editor Camera tab configures the camera used inside the Viewport editor.
These settings control properties such as:
projection mode
field of view
clipping distances
visualization settings for the editor camera
This allows users to customize how the 3D scene is viewed while editing.
The Sound Card tab defines the default audio configuration used by the project.
These settings configure the audio hardware used for input and output, including monitoring and analysis parameters.
In addition to audio processing, the sound card can also be used to improve the internal timing precision of the system, since the CPU clock alone may not provide sufficient accuracy for certain timing tasks.
The WebServer tab configures the internal web server used by Grid Studio.
This server enables features such as:
remote control interfaces
REST API access
browser-based viewers
controller interfaces
Settings include network configuration, port selection, authentication, and module activation.
The Physics tab contains configuration options related to the internal physics simulation system.
These settings influence how physics-based systems behave and can affect simulation accuracy and performance.
Object Grid
The Object Grid tab controls the grid used for object placement and alignment inside the editor.
This grid helps users position objects precisely when working with spatial scenes.
The Scripts tab manages the global Python scripting environment for the project.
This includes:
global imports used across scripts
plugin reload functionality
Python logging tools
These settings allow users to configure and manage scripting behavior at the project level.
Last updated