# 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 Settings ``` ### Project 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 * password * description {% hint style="danger" %} Password is linked to the project file. It will be needed when the project is opened. Please remember what you have set it to; if not, it is not possible to open the project file again and edit it. {% endhint %} 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. *** ## [Processes](/grid/grid-studio-fundamentals/project/project-settings/processes.md) 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. *** ## [3D Widget](/grid/grid-studio-fundamentals/project/project-settings/3d-widget.md) 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. *** ## [Exposed Parameters](/grid/grid-studio-fundamentals/project/project-settings/exposed-parameters.md) 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. *** ## [Defaults](/grid/grid-studio-fundamentals/project/project-settings/defaults.md) 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. *** ## [Categories](/grid/grid-studio-fundamentals/project/project-settings/categories.md) 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. *** ## [Editor Camera](/grid/grid-studio-fundamentals/project/project-settings/editor-camera.md) 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. *** ## [Sound Card](/grid/grid-studio-fundamentals/project/project-settings/sound-card.md) 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. *** ## [WebServer](/grid/grid-studio-fundamentals/project/project-settings/web-server.md) 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. *** ## [Physics](/grid/grid-studio-fundamentals/project/project-settings/physics.md) 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. *** ## [Watchdog](/grid/grid-studio-fundamentals/project/project-settings/watchdog.md) The **Watchdog** tab contains the options related to the monitoring of Grid Studio in case it freezes or crashes. *** ## 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. *** ## [Scripts](/grid/grid-studio-fundamentals/project/project-settings/scripts.md) 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. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://stage-precision.gitbook.io/grid/grid-studio-fundamentals/project/project-settings.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.