> For the complete documentation index, see [llms.txt](https://docs.icraft.design/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.icraft.design/editor-features/subscene.md).

# Subscene

In complex scene construction, a single scene often contains a large number of models, structures, and logical relationships. To improve clarity, maintainability, and reusability, **iCraft** provides the *Subscene* feature.

A Subscene allows you to create an independent, nested scene within a specific element. This nested scene has full editing capabilities—just like a regular main scene—and can be reused, managed, and presented as a whole.

This capability is especially valuable in complex engineering scenarios such as architectural design, industrial equipment modeling, digital twins, and process systems.

***

## What is a Subscene?

A Subscene is an independent scene space attached to a specific element:

* A complete 3D editing environment
* Contains its own models, lighting, animations, interactions, and logic
* Can be nested within the main scene as a whole
* Appears as a single “element” in the main scene

You can think of it as:\
\&#xNAN;**“a scene within a scene”**, or a **“nestable micro-project.”**

***

## How to Create and Edit a Subscene?

{% stepper %}
{% step %}

#### Entry Point

* In the main scene, select any object (such as a cube, a building model, or a specific icon).
* In the floating toolbar on the right, locate the "**Subscene"** icon.
  {% endstep %}

{% step %}

#### Enter Editing Mode

* Click the "**Subscene"** icon. The main scene will temporarily fade out, and the view will switch to an empty space inside the selected object.
* You can now freely build and edit details within this nested space.
  {% endstep %}

{% step %}

#### Return to the Main Scene

* Use the top navigation bar and click the **"Go Back"** icon at any time to return to the main scene.

![](/files/dQwySArphQSxqYZYb1Yp)
{% endstep %}
{% endstepper %}

***

## Advantages of Subscenes

* **Optimized Performance, Smooth Experience**\
  The editor only renders objects at the current level in real time, significantly reducing GPU memory usage in large-scale projects.
* **Modular Design, Clear Structure**\
  Break down complex scenes into multiple submodules. Each module is represented as a Subscene, making the hierarchy easy to understand.
* **Enhanced Interaction, Engaging Experience**\
  Provides end users with a progressive, layered exploration experience that aligns with natural spatial cognition.
* **Independent Editing, No Interference**\
  Each Subscene supports full editing capabilities, including lighting, camera control, animation setup, and independent model management.

***

## Typical Use Cases

#### Scenario 1: Campus and Interior Switching

* **Approach:**\
  The main scene represents a full view of a technology campus. Each building is assigned its own Subscene.
* **Result:**\
  Users can smoothly navigate the campus. When clicking on a building, they can “enter” it to explore offices, workstations, and asset layouts.

#### Scenario 2: Complex Equipment Decomposition

* **Approach:**\
  The main scene contains a complete server rack model. A Subscene is created for the rack.
* **Result:**\
  Inside the Subscene, detailed elements such as server boards and cable connections can be modeled without increasing the rendering load of the main scene.

#### Scenario 3: Logical Group Management

* **Approach:**\
  Components are grouped into different Subscenes based on business logic (e.g., power systems, cooling systems).
* **Result:**\
  Greatly improves collaboration efficiency, allowing team members to focus on their respective Subscenes independently.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://docs.icraft.design/editor-features/subscene.md?ask=<question>
```

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.