Documentation
Objects, shapes & transforms
Objects are the things that appear in your scene. Add them, then move, rotate and scale them into place.
Adding objects with the Add menu
Click Add in the top bar (or right-click the viewport or the Scene Hierarchy) to open the Add menu:
- 3D - built-in shapes: Cube, Sphere, Cylinder, Cone, Plane, Torus. A Plane can also be the Floor that falling objects land on.
- 2D - flat shapes: Rectangle, Circle, Triangle.
- Object from asset - place an image, video, sound or model you have imported.
New objects appear at the centre of the scene and are selected automatically, ready to position. Built-in shapes get a default colour - change it in the Inspector.
Moving, rotating and scaling
Select an object, then pick a tool from the top-left of the viewport and drag the on-screen handles (the gizmo):
- Translate - drag the arrows to slide it along an axis.
- Rotate - drag the rings to turn it.
- Scale - drag the handles to resize it.
You can also type exact numbers into the Inspector on the right. Press Enter to keep a number, or Escape to go back to the one before. The arrow keys step it up or down. To change a number with the mouse, drag its X, Y or Z letter left or right: hold Shift for small steps or Ctrl for big ones. Each drag is one undo step. Right-click a number, or a row such as Position, and choose Copy values to copy all its numbers; Paste values puts them into any field with as many numbers, as one undo step.
Selecting several objects
Select several objects to move or change them together:
- In the 3D view, Shift-click objects to add them. Shift-click a selected object to make it the active one, and Shift-click the active one again to take it out. Ctrl-click (Cmd-click on a Mac) does the same.
- In the Scene Hierarchy, Ctrl-click (Cmd-click on a Mac) a row to add it or take it out. Shift-click a row to select every row between it and the row you last clicked without Shift (or the active object, if you have changed the selection somewhere else since). Ctrl+Shift-click adds those rows to what is already selected.
- Ctrl+A selects every object in the scene that is not hidden in the editor. Escape, or a click on empty space in the 3D view, clears the selection.
- The last object you picked is the active object, with the brightest outline. The Animation panel works on it. Move origin and Edit bounds need just one object selected. UI Overlay elements are selected one at a time.
With two or more selected, the gizmo moves, turns and scales them all together. Press Escape while you drag to put them back. Choose the point they turn and scale around with Pivot, beside the tools:
- Median point: the middle of them all.
- First selected: the first object you picked.
- Last selected: the active object.
- Scene centre: the middle of the target image.
The Inspector shows how many objects are selected, with Visible at start and their Position, Rotation and Scale. Where their values differ, it shows Mixed. Type a number to give them all the same one. Moving several objects never adds keyframes, and while the Animation panel is open, objects a clip animates cannot be moved together.
Tip
The Inspector
The Inspector shows everything about the selected object, from the top down:
- Name - the friendly name you'll see when wiring up logic.
- Visible at start (directly under the Name) - switch it off to keep an object hidden until a Show Object action reveals it.
- Collisions - turn it on to let the object trigger an On Collision event when it touches another collidable object. (World objects only.) While it is on, the four settings below appear too.
- Bounds - the invisible shape that a hand touches and physics uses. See Choose the shape a hand touches.
- Interactive - viewers can touch the object and pick it up with their hand. Turn on Pause animation under it to stop an animated object's animation while a hand holds it. See Hand interaction and physics.
- Physics - the object falls and lands on the Floor or on another object with Collisions. An object that is Interactive and has Physics can be thrown.
- Can be pushed - an open hand in front of the camera pushes the object along: a ball rolls, a box slides until the hand stops. It needs Physics. An object that can be pushed is harder to pick up, so turn it on only where pushing is the point.
- Its Position, Rotation and Scale.
- For a shape: a colour picker, or a material in place of the colour.
- For a Plane: Floor, an invisible floor that objects with Physics land on and that hides anything below it. Each scene uses one Floor.
- For a video: an autoplay toggle. For audio: a loop toggle.
- For a model: per-slot material assignments, and a bin to delete a material when it has more than one.
Move origin (the pivot point)
Every object turns and scales around its origin (its pivot). Sometimes you want that point somewhere else - for example, a door that should swing from its hinge, not its centre.
- Select the object.
- Tick Move origin above the viewport. A live readout shows the origin's coordinates.
- Drag the pivot to the spot you want. The object stays exactly where it is - only the pivot moves, so from now on it rotates and scales around the new point.
Tip
To put the pivot in the middle of the object's shape, right-click the object in the Scene Hierarchy (or in the 3D view) and choose Set pivot to geometry. The object stays where it is, and its animations move with it. A model needs to finish loading first. This is not available while the object's rotation or scale is animated.
The Scene Hierarchy
The Scene Hierarchy (top-left) lists every object in the current scene. Here you can:
- Click a row to select it (kept in sync with the viewport and Inspector).
- Toggle the eye to hide an object in the editor only - handy for decluttering while you build. This never affects the published experience. A group has an eye too: it hides everything in the group, its sub-groups included, or shows it all again.
- Organise objects into groups (create a group, then drag rows into it, or right-click → Move to group). Drag a group onto another to put it inside, or onto the top of the list to take it out. Deleting one keeps what it holds: it moves up one level. Groups are for tidiness only. Drag an object onto another to make it its child: it then moves, turns and scales with it, in AR too. Drag it to the top of the list to take it out. Deleting a parent keeps its children where they are. Click a group's name to select everything in it.
- Right-click a row to Focus, Rename, Duplicate, Copy, Set pivot to geometry, toggle visibility, or Delete.
Note
Break apart
Break apart splits a model into separate objects, so you can move, hide or animate each part on its own. Right-click the model in the 3D view or in the Scene Hierarchy and choose Break apart:
- A model whose file is made of several parts (a car and its wheels, say) splits into those parts.
- A model made of one part splits into its loose parts: pieces that do not touch each other. If the file has parts but loose parts would give more, you can also choose Break apart by loose parts.
The parts go into a new group named after the model, each one exactly where it was, and each part is a new model in Assets. A model inside a tracking image has no group: its parts go straight under the tracking image. The original object is removed, but its model stays in Assets, and one Ctrl+Z brings it back. The parts stay in Assets even then, as they are already stored: delete them there if you do not need them. Wait for the model to load first; while the Animation panel is open, a model a clip animates cannot be broken apart. Break apart first gets the parts ready and shows how much storage they will use: each part has its own copy of its textures, so the parts can need more than the model did. If there is not enough storage left, nothing changes.
Only the 63 largest pieces get their own object. The rest become one object, Other pieces, which you can break apart again.
Note
The UI Overlay: on-screen buttons and labels
Most objects sit in the AR scene, anchored to your target image. The UI Overlay is different: it holds flat elements that stay fixed on the phone screen, like a heads-up display - a score label in a corner, a title along the top, or a “Next” button at the bottom. They don't move as the phone moves.
At the top of the Scene Hierarchy is an AR Scene / UI Overlay toggle. Switch to UI Overlay and the editor dims the scene and shows a phone-shaped frame; anything you Add now - Text, images, videos or 2D shapes - becomes an on-screen element you can drag into place on that frame.
- Position each element with its Layout settings in the Inspector: Anchor (which corner it sticks to), Offset X, Offset Y, Width, Height and opacity.
- A Text element can show a variable live - great for a score that updates as you play.
- Overlay elements are tappable: give one an On Tap node to make a real on-screen button.
Tip