The scene view
Editor docs
The Scene panel shows the world in edit mode: scripts do not run, rendering does. Select entities in it, move them with gizmos, drop assets onto it, and choose what it draws from its strip and the View menu. The editor is a preview.
Preview: Box Select and the View menu's Show Collider Outlines and Show Handles shipped on 15 November 2026 and have not yet been through an end-to-end test pass or tried in a running editor. Box Select also needs engine 0.20.0 in the project (below).
Select and move#
Click an entity to select it; the Hierarchy and the Inspector follow. The strip above the view holds the gizmo's Move, Rotate and Scale modes, its axes, Snap, and Frame selection and Frame all. A gizmo drag is one undo step. Drop a model, mesh, sprite atlas or prefab from the Assets panel onto the view to place it.
Box Select#
With engine 0.20.0. Box Select in the strip's Selection group turns on a tool that selects every entity inside a rectangle you drag over the view:
- Left to right selects what the box contains entirely; right to left selects what it touches.
- The box replaces the selection. Shift adds to it; Ctrl (
⌘on macOS) toggles each entity in the box. - A press that moves less than 4 pixels is a click, which selects one entity as usual.
- Escape cancels a drag.
- One box selects at most 2,000 entities; past that, the strip shows a warning.
Click Box Select again to turn it off. View → Box Select (Shift+Ctrl+M, ⇧⌘M on macOS)
is the same switch. It is off each time a project opens.
The tool asks the project's @ignifx/editor-host for the entities in the box, which ignifx 0.19.0
cannot answer (the request is pickRect). The button shows only for a project whose editor host
can, that is a project on ignifx 0.20.0 or later. The box leaves out what a click cannot pick
either: disabled sprites and tilemaps, those on inactive entities, and meshes with pickable off.
While Box Select is on#
- The view's own camera and gizmo input stop. The tool covers the view to catch the drag, so the mouse wheel, orbiting and gizmo handles do not reach the scene until you turn it off.
- Dragging a panel's tab over the scene view does not dock it there while the tool is on.
- It has no key and no menu item, only the strip's button.
The View menu#
| Item | What it does |
|---|---|
| View → Animate Materials | Animates shader materials in the scene view, or holds them still. Also Animate materials in the strip. |
View → Grid (Ctrl+G) | Shows or hides the grid. The strip picks the grid's spacing, 0.1 to 10 m. |
| View → Grid Options → Draw Over Scene | Draws the grid over the scene, so a floor does not hide it (Over scene in the strip). |
| View → Grid Options → Height n m | Moves the grid's plane to that height. |
| View → Show Collider Outlines | Draws the selected entities' collider outlines. On by default. |
| View → Show Handles | Draws the 2D collider handles you drag to resize a collider. On by default. |
View → Box Select (Shift+Ctrl+M) | Turns the Box Select tool on or off, as the strip's button does. Off each time a project opens; not remembered. |
The editor remembers the others per project, in its own data, never in the project. Agents set
the grid and material animation with ignifx_set_view (see Agents and
MCP); the outline and handle switches are menu-only.
On macOS, ⌘G replaces Ctrl+G.
Known limitations#
- The outline and handle switches are in the View menu only; the strip has none.
- Box Select has not run against a real engine host: no engine release carries the request it makes yet.
- An entity deleted while a box request is in flight can stay selected until the next change to the selection.
- The Scene panel cannot be closed from its tab's button; see Window and layout.