CLEAR

Plane Tracker

Use the plane tracker to place objects in people's environments.

A plane tracker will find a horizontal plane in the real world, like a floor to table. You can then place an object on the plane, and add interactivity and animation to it if you want to.

You can add targets to a plane tracker, to trigger effects when the camera is pointed at a specific thing in the world - like a movie poster.

You can only add one plane tracker in a scene, but you can place multiple objects on the plane.

To insert a plane tracker:

  1. Click Insert.
  2. Select Plane Tracker.
  3. Click Insert.

When you've added a plane tracker to a project:

  • Any video you were using will no longer be visible.
  • The video in the Simulator will be replaced by a video showing the world, rather than a person.
  • The camera will switch to Back mode, and focus on the plane that's being tracked in the scene.

Your Viewport should look like this:

Plane Tracker Properties

When you've selected the plane tracker in the Scene tab, you'll see its properties in the Inspector panel.

Visible

Uncheck this box to stop the plane tracker and any children from being rendered in the scene.

Auto start

Check this box to find a plane in world space as soon as your effect is opened.

Transformations

You can't change the transformations for a plane tracker, because it isn't an object.

Targets

Add a texture that'll trigger your effect when the camera is pointed at it in real life.

Enable For

This sets camera-specific visibility. For the plane tracker, Enable For is set to Back Camera automatically and can't be changed. This means that the plane tracker will only be visible in the back camera of a mobile device.

Using Plane Tracking

To build a simple plane effect:

  1. Insert a plane tracker.
  2. Right-click on the plane tracker in the Scene tab, select Insert and import a 3D Object.

This will place your object on a plane in the world. To add interactivity and animation, you'll need to use scripting.

Target Tracking

You can create effects that are triggered when the camera is pointed at a target texture. For example, you could craft an effect to be triggered only when someone points the camera a poster for a movie.

To track a texture:

  1. Insert a plane tracker.
  2. Go to Targets in the Inspector panel, click + and then select Target.
  3. Click Choose File... next to Texture.
  4. Select the texture file that you want to target from your computer. You should see the texture appear in the scene.
  5. Add your effect's animation or object as a child object of the plane tracker.

You can use scripting or the patch editor to create effects that are triggered by the target texture.

You can use this sample content to try out target tracking. If you point the camera at the image of a slice of pizza, a pizza slice will hover above it.