Manual
Manual
The Scene view
The Scene view is your view of the scene, through the editor's own camera rather than the game's. This page covers moving around it, picking what is in it, moving, turning and resizing what is picked with handles and the Rect tool, snapping, the draw modes and the grid, the 2D view, the orientation gizmo, and dropping files into the scene. Open it with Window ▸ Scene (Ctrl+1).
On a Mac, Cmd takes the place of Ctrl in every shortcut on this page.
The row of tools
A row along the top of the panel holds the tools and how the scene is drawn. Resting the pointer on a button says what a click will do.
| Button | Key | What it does |
|---|---|---|
| Move | W | Moves what is picked, by arrows and squares |
| Rotate | E | Turns what is picked, by circles |
| Scale | R | Resizes what is picked, by axes ending in cubes |
| Rect | T | Moves, turns and resizes by a rectangle round what is picked; see The Rect tool |
| Center or Pivot | Z | Puts the handle at the middle of what is picked, or at the entity picked last |
| Local or Global | X | Turns the handle as the entity picked last is turned, or as the world is |
| The magnet | Snaps without Ctrl; see Snapping | |
| The arrow beside the magnet | Opens the steps the handles snap to | |
| 2D Lights | Lights the scene by its 2D lights, as the game draws it, or shows its art unlit | |
| Grid | Draws the world's grid, or hides it | |
| Bones | Draws every skin's bones over the scene | |
| 2D | 2 | Switches the 2D view on or off; see The 2D view |
| Wireframe, Shaded Wireframe, Shaded | How the scene is drawn; see Draw modes |
While exactly one entity with a Tilemap is picked, the tools for painting it come after Rect: Select (S), Paint (B), Rectangle (U), Fill (G), Erase (D) and Pick (I). See Tilemaps.
The tool keys work wherever the keyboard is, except while you type, while the camera flies, or while the playing game has the keyboard. They go by where the key is on the keyboard, so they work with any keyboard layout. The editor keeps the draw mode, 2D Lights, Grid, Bones, the 2D view and the magnet as you left them.
Move around
| Do this in the Scene view | To |
|---|---|
| Hold the right mouse button | Fly: the mouse turns the camera, W, A, S and D move it, E goes up and Q down |
| Alt and drag with the left button | Orbit round the pivot |
| Drag with the middle button | Pan, four times faster with Shift |
| Alt and drag with the right button | Zoom in and out |
| Turn the wheel | Zoom toward the pivot, or toward the pointer with Alt |
| Arrow keys | Move the camera, while the Scene view has the keyboard |
| F, or a double-click on a row in the Hierarchy | Frame what is picked |
| Keypad 5 | Switch between perspective and orthographic |
Flying. A move starts at 9 meters a second and goes 1.8 times faster for every second it goes on. Shift makes it five times faster. The wheel, while you fly, sets the speed, from 0.01 to 2 times; the speed is shown in the middle of the view for a moment, such as 0.50x. The pointer is hidden while you fly and comes back where it was. Escape stops flying. In an orthographic view, the right button orbits instead of flying.
Framing. F moves the pivot to the middle of what is picked and what is under it, and backs the camera off until all of it is in view, keeping the way the camera faces. The camera eases there in half a second; any move of your own stops it.
Orthographic. The camera narrows its field of view as it switches, and draws orthographic once the view is nearly flat. Zooming an orthographic view changes how much it shows.
Each scene is looked at from where you left it, in 2D or 3D as it was. The editor keeps this in your game's cache/scene-views.json, which version control leaves out, so a scene renamed or moved keeps it.
Pick what is in the scene
Click something to pick it. The Hierarchy opens to it and scrolls to it.
- Click again at the same spot to go further: the first click picks the outermost instance of a prefab under the pointer, the next the entity itself, then each one under it in turn, back to the first.
- Shift+click adds to what is picked.
- Ctrl+click adds or takes away.
- Click on nothing lets go of everything.
What can be picked is what is drawn: nothing hidden, switched off or on a layer the camera leaves out, and not the back of a one-sided surface. A sprite is picked where its image shows, not in its clear corners. A light's or a camera's icon is picked before what is behind it.
Pick with a rectangle
Drag from empty space to draw a rectangle. As you drag, it picks everything with a part showing inside it: an instance of a prefab whole, and the light and camera icons it touches, but nothing hidden behind something else.
- Shift adds what it covers to what was picked.
- Ctrl takes it away.
- Escape puts back what was picked before.
Keys
While the Scene view has the keyboard, these act on what is picked, as in the Hierarchy: Delete (Cmd+Backspace on a Mac), Ctrl+D to duplicate, Ctrl+X, Ctrl+C and Ctrl+V to cut, copy and paste, Ctrl+Shift+V to paste as a child, and Ctrl+A to pick everything. See The Hierarchy.
Move, rotate and scale
The handle of the Move, Rotate or Scale tool is drawn on what is picked, the same size on the screen however far away it is. X is red, Y green and Z blue. The part under the pointer is drawn stronger, and the part you hold turns yellow. An axis that points nearly straight at the camera fades out and cannot be held.
| Tool | Its handle | Drag |
|---|---|---|
| Move | An arrow along each axis, and a square across each pair of axes | An arrow moves along its axis, a square across its two. With Shift held, a square in the middle moves across the view. |
| Rotate | A circle about each axis, an outer circle, and the space inside | A circle turns about its axis, the outer circle about the way the view faces, and the inside freely. |
| Scale | An axis ending in a cube for each axis, and a cube in the middle | An axis scales along itself, and the middle cube scales evenly. |
Dragging changes everything picked: each entity moves from its own parent, and one under another picked entity goes with it. With Pivot, each entity turns and scales about itself; with Center, about the middle of them all.
A drag is one Ctrl+Z. Escape, while you hold the drag, puts everything back as it was.
There is no handle on the top entity of a prefab open on its own, since each instance places it, nor on a model's prefab, nor while you edit a component's shape or paint a Tilemap.
Snapping
Hold Ctrl while you drag a handle to snap it to steps, the same at every zoom:
| Tool | Step, to begin with |
|---|---|
| Move | A quarter of a meter along each axis it moves along |
| Rotate | 15 degrees about the circle's axis |
| Scale | A tenth; scaled evenly, the largest axis lands on it |
A move lands the entity picked first on a multiple of the step, in its Position as the Inspector shows it, so a child lands in its parent's units. Along an arrow that lies along none of its parent's axes, it moves by whole steps instead. Everything else picked moves with the first. Let go of Ctrl during the drag and it goes free. The inside of the Rotate circles never snaps.
The magnet snaps without Ctrl, and Ctrl then lets a drag go free. The arrow beside it opens the steps: Move in meters, Rotate in degrees and Scale, each a number to drag or type. The project keeps them in settings/snapping.json, for everyone working on it, and a built game never carries the file.
The Rect tool
The Rect tool (T) draws a rectangle round what is picked: across a sprite's own X and Y, and across the two axes of anything else that the camera sees most of. Several picked share one rectangle. The rectangle fades as it turns edge on.
| Drag | What it does |
|---|---|
| A corner | Resizes from the opposite corner |
| A side | Resizes one way |
| Just outside a corner | Turns about the pivot |
| The inside | Moves, once the pointer has gone three pixels; a shorter press picks what is under it |
| The pivot's circle | On one sprite, moves its Pivot, the image staying where it is; on anything else, moves where the tool turns and resizes about |
Hold keys while you drag to change what it does:
- Shift keeps the proportions as you resize, turns by 15 degrees, and moves along one side.
- Alt resizes about the pivot.
- Space resizes a sprite by its scale instead of its Size.
A sprite is resized by its Size, whatever it is drawn as, and keeps its scale. What follows a sprite's size, such as a 2D collider on it, follows. Anything else is resized by its scale. A sprite's pivot keeps to the nine places of its rectangle, the corners, the sides' middles and the center, when it is near one.
The Rect tool's move and turn snap as the handles do, a snapped turn landing on the Rotate step in place of Shift's 15 degrees. Its resize does not snap. A drag is one Ctrl+Z, and Escape while you hold it puts it back.
Dots on shapes
A picked light, camera and some other components draw their shape, with dots on it to drag:
| Picked | Its dots set |
|---|---|
| Point light | Its range |
| Spot light | Its range, by the dot in the middle of its end, and its angle, by the four round it |
| Camera | Its field of view, or the size of an orthographic one |
| Audio Source | Its min and max distances |
| Particle Emitter | The numbers of its shape, such as its radius or angle |
| Point Light 2D | Its range, inner range and angle |
| Camera Bounds 2D | Its width and height |
The shape follows the dot as you drag it. A drag is one Ctrl+Z, and Escape puts it back.
Edit a component's shape
Some components have a button at the top of their section in the Inspector to edit them in the Scene view, such as Edit Collider on a physics collider, Edit Joint on a joint, Edit Points on a Line, and Edit Link and Edit Volume in the Navigation package. While it is on, the tools' handles are hidden and the component's dots are drawn instead:
- Drag a dot to move it.
- Click a line between dots to add one there, and drag it on.
- Hold Ctrl to show which dots can go, in red, and click one to delete it.
- Points such as a joint's anchors get a Move handle of their own, which snaps as the Move tool does.
The button again, Escape in the Scene view, picking a tool or picking something else stops it. Each drag is one Ctrl+Z.
Draw modes
The three buttons at the right end of the row draw the scene Shaded, the default, as a Wireframe, every edge of every triangle in white, or Shaded Wireframe, the edges faint over the shading. They change the Scene view alone: the Game view draws as the game does. Where the graphics card draws no lines, the two wireframes are grayed and say why.
The grid
Grid draws lines across the ground a unit apart, every tenth stronger, fading out round the camera and hidden behind what stands on them. Close to the ground they are a tenth of a unit apart, and ten or a hundred units far from it. In the 2D view the grid stands on the XY plane. It is the Scene view's alone, never a game's.
Icons, outlines and shapes
Each light has an icon in its own color, each camera a gray one, and audio sources, particle effects and camera bounds have icons of their own, the same size however far away. Click an icon to pick what it stands for.
What is picked is outlined in orange round the shape it makes on the screen, through whatever is in front of it, and what is under it in blue-gray. A picked light shows its reach, a sphere, a cone or a sun's rays, and a picked camera shows what it sees.
Bones draws the bones of every skinned mesh over the scene, a dot at each joint. Click a bone or a dot to pick its joint.
The 2D view
Press 2, or click 2D, to look at the XY plane from the front: orthographic and without turning, +Y up. In the 2D view:
- the right button, and Alt with the left, pan;
- the wheel zooms toward the pointer, or toward the pivot with Alt;
- the Up and Down arrows move the view up and down;
- the orientation gizmo is hidden.
Press 2 again to go back to the 3D view it left. A scene made from the 2D template opens in the 2D view (see Make, open and save scenes).
2D Lights switches between the scene lit by its 2D lights, as the game draws it, and its art unlit, to see it while you work. See 2D lights.
The orientation gizmo
The gizmo in the top-right corner shows which way the view faces: a cube with a cone on each side, the +X, +Y and +Z cones red, green and blue. The word under it names the side you look from, such as Top or Front, or says Persp or Iso when the view is not straight along an axis.
| Do this | To |
|---|---|
| Click a cone | Look at the scene from that side |
| Shift+click or middle-click a cone | Look from that side, orthographic |
| Click the cube or the word | Switch between perspective and orthographic |
| Shift+click or middle-click the cube | Look from a little above, in perspective |
| Double-click the cube | Frame what is picked |
| Right-click the gizmo | Pick Free, Right, Top, Front, Left, Bottom, Back or Perspective from a menu |
| Click the padlock | Lock the view's turning, so the right button and Alt pan it; click again to unlock |
Drop files into the scene
Drag a file from the Project panel into the Scene view:
| File | What happens |
|---|---|
| A prefab or a model | An instance is placed on what is drawn under the pointer, or on the ground where nothing is; in the 2D view, on the XY plane |
| An image, or one slice of an image | A sprite that draws it is made, on the XY plane under the pointer in the 2D view, or at the camera's pivot in 3D |
| Several images or slices together | A sprite that plays them as frames is made; see Sprites |
| A material | It is given to the mesh under the pointer |
Inside a prefab open on its own, what you drop goes under its top entity. Where a drop cannot happen, the pointer says why. See Make a prefab and place instances.
Drawing from your code
Lines your game draws for whoever edits it appear in the Scene view, not in the Game view or a built game. A system in a plugin marked [EditorOnly] draws with context.Gizmos and reads what is picked from context.Selection; a game's Rust draws with Bevy's Gizmos. See Plugins and Rust in a game.
While a picked Particle Emitter plays as the scene is edited, a small overlay in the bottom-right corner has a button to play or pause it, Restart and Stop, with its Playback Time and how many Particles it has. See Particle Emitter.
In the Scripting API
- Gizmos and EditorSelection: lines drawn in the Scene view, and what is picked.
- Schedule.EditInScene, SceneEditHandles and SceneEdit: dots of your own on a component's shape.
- World.DrawInScene: triangles and lines worked out in the editor, drawn until forgotten; World.DrawInScene2D the same flat, over a game's 2D.
