Camera Navigation
All navigation happens directly in the 3D viewport.
| Left-drag | Orbit — rotate the camera around the scene |
| Right-drag / Middle-drag | Pan — slide the camera up, down, left, right |
| Scroll wheel | Zoom in / out |
| F | Frame selected — snap the camera to focus on the selected object |
Tips
- Hold Shift while dragging to constrain pan to horizontal or vertical.
- After placing a new object, press F to immediately zoom to it.
- The viewport background can be toggled between solid and gradient in the View menu.
Creating Objects
All primitives live in the Primitives panel on the left.
Drag to place
Drag any shape thumbnail from the panel into the viewport to start creation. Release to drop.
Multi-phase creation (volume shapes)
- Phase 1 — drag to define the base footprint (width & depth).
- Phase 2 — move the mouse up/down to set height. Click to confirm.
- Press Escape at any point to cancel.
Available primitives
| Box | Rectangular cuboid with independent W/H/D sliders |
| Sphere | UV sphere with adjustable segment count |
| IcoSphere | Icosahedron-based sphere, great for uniform topology |
| Cone | Tapered cone with polygon count control |
| Cylinder | Capped cylinder with polygon count control |
| Capsule | Cylinder with hemispherical caps |
| Torus | Ring / donut shape |
| Plane | Flat single-sided quad |
| Text | 3D extruded text — edit the string in the Properties panel |
| Spline | Click to place control points, double-click to finish the curve |
Selecting Objects
| Click object | Select it (deselects everything else) |
| Ctrl+Click | Add or remove from the current multi-selection |
| Click empty space | Deselect all |
| H | Open the Select by Name dialog |
Select by Name dialog
- Use the sidebar filter pills to show only Models, Containers, Lights, etc.
- Type in the search bar to filter by name in real time.
- Click any item to toggle its selection; highlighted items (green) are pending.
- Double-click an item to select it immediately and close the dialog.
- Select All selects everything currently visible (respects active filters and search).
- Select None clears the pending selection.
- Models and Lights can be selected together in the same confirmation.
- Click ▶ next to a Container to expand and see its child objects.
Lights
Add lights from the Lights panel on the left or via the Add Light menu.
| Directional (☀) | Sun-like light with parallel rays — simulates distant sunlight; has direction but no position attenuation |
| Point / Omni (○) | Radiates light in all directions from a single point in space — attenuation by range |
| Spot (◎) | Cone-shaped beam — has position, direction, and an adjustable cone angle |
Working with lights
- Click the light icon in the viewport to select it; the translate gizmo appears.
- Directional and Spot lights show a direction indicator line — drag the gizmo to repoint it.
- In the Properties panel: set color (color picker), intensity, range (Point/Spot), and cone angle (Spot).
- Toggle Enabled to turn a light on or off without deleting it.
- Toggle Shadow to enable shadow casting (requires WebGL2 renderer).
- Multi-select lights with Ctrl+click or Select by Name to move several at once.
Containers (Groups)
Containers let you group models together so they can be transformed as a single unit.
Creating a container
- Go to Scene > Add Container (or right-click in the scene list).
- Select the container, then click Pick Object to Add… in the Properties panel.
- Click any model in the viewport or use the pick-by-name dialog to add it.
Working with containers
- Selecting a container selects all its children for collective transforms.
- Individual child objects can still be selected and transformed independently.
- In Select by Name (H), click ▶ next to a container to expand its children.
- Remove objects from a container by selecting the child and clicking Remove from Container.
- Deleting a container removes the grouping but does not delete the child objects.
Particle Emitters
Emitters add dynamic particle effects to your scene. Add them from the Emitters panel on the left.
| Smoke | Soft rising grey-white particles that expand and fade |
| Rain | Fast-falling streaks, great for atmospheric scenes |
| Bubbles | Slow-rising translucent spheres |
| Fire | Orange-red upward burst with heat shimmer feel |
Controlling emitters
- Select an emitter in the Emitters panel or click its icon in the viewport.
- Use the translate gizmo (W) to reposition the emitter origin.
- Properties panel: adjust emission rate, particle size, speed, and lifetime.
- Toggle Enabled to pause or resume emission without deleting.
File Operations
| Ctrl+N / File > New | Clear the scene and start fresh (prompts for confirmation) |
| Ctrl+O / File > Open | Load a previously saved .json scene file |
| Ctrl+S / File > Save | Save the entire scene to a .json file |
| File > Import JSON | Merge objects from another scene JSON into the current scene |
| File > Import OBJ | Import a 3D model from a .obj file |
| File > Export JSON | Export only the current scene geometry and settings |
Scene JSON format
Scene files are plain JSON — fully human-readable and easy to version-control. They store all meshes, lights, cameras, containers, emitters, and their transforms.
Keyboard Shortcuts
| Key | Action |
| W | Translate gizmo |
| E | Rotate gizmo |
| R | Scale gizmo |
| F | Frame selected object in view |
| H | Select by Name dialog |
| Delete / Backspace | Delete selected object(s) |
| Ctrl+Z | Undo |
| Ctrl+Shift+Z | Redo |
| Ctrl+S | Save scene |
| Ctrl+O | Open scene |
| Ctrl+D | Duplicate selected object(s) |
| Ctrl+Click | Add / remove from multi-selection |
| Escape | Cancel creation / deselect / close dialog |