How to Create a Model Target

Model Targets are created using the Model Target Generator app. For more general information about the Model Target Generator, including installation instructions, see the Model Target Generator User Guide.

  1. Launch the Model Target Generator by navigating to the folder you unzipped the Model Target Generator to, and double-clicking the Model_Target_Generator executable.
  2. Log on to Vuforia Engine using your Vuforia Developer account credentials:
Vuforia Image
  1. Click Create New Model (you can also open previously created projects by selecting Open Model).
Vuforia Image

Make sure the Location is not set to an unmapped network path. 

Vuforia Image
  1. Enter a name for the Model Target, such as "Viking Lander", in the Model Target Name field.
  1. Click the Select button next the CAD Model field and navigate to the VuforiaMars_ModelTarget.pvz file from the prepackaged VuforiaMars_ModelTarget folder:
Vuforia Image
  1. Click Import. It may take a few moments to load your mode.
Vuforia Image
  1. Your model will appear in the view:
Vuforia Image
  1. The size of the Model Target needs to match the size of the object in real life. To ensure this is the case, select the unit that your model is defined in using the File Units menu (for example, a real car is a couple of m, a toy car is tens of cm), so that the size matches the real world size of your object.

    In some cases, you might need to go back to the tool you used to create/edit the CAD model and change the size there. Alternatively, try a different model file format: some file formats, such as .obj, are unit agnostic.

    Note
    that you may need to pay attention to the scale of your model when you import the Model Target dataset into Unity as well, to ensure that the sizing is consistent.
Vuforia Image
  1. If your model is not correctly oriented, for example, if it appears tipped over on its side or on its back, as in the following image:
Vuforia Image

then, you will need to change the "up" axis for your model using the Up Vector menu:

Vuforia Image
  1. Now, you need to add one more Guide View to your Model Target.

    First, select Detection Position from the top of the window:
Vuforia Image

Drag to move the viewpoint. Use the navigation buttons on the left side of the window to change the movement mode. When you have a suitable Guide View for your object, click Add Single View. A preview of your Guide View will appear on the right.

Vuforia Image

Refer to Model Target Guide View for advice on choosing a good Guide View position.

You can add multiple Guide Views for your object by repeatedly moving the viewpoint and clicking Add Single View. Alternatively, click Add Multiple Views and the Model Target Generator will automatically create several Guide Views around the object at a suitable default distance with suitable default settings.

Note that if you want your app to be able to automatically switch between objects and/or Guide Views, be careful when selecting and configuring your Guide Views. Refer to Model Target Guide View for more information.

  1. Optionally, you can also set the Target Recognition Range for each Guide View. Refer to Model Target Guide View for details.
  1. Press Generate Target on the top button bar, which will show the following dialog:
Vuforia Image

Click Continue to generate a Model Target dataset using your model and the configured Guide Views. You will see a progress counter, indicating that the dataset is being generated.

During this process, PNG images for each of your Guide Views will be saved to the project directory. For an indication of how these images are typically used within a Model Target application, see Introduction to Model Targets in Unity and the Model Target Test App User Guide. If you like, you can use this image as a guide to create a custom Guide View image to present to the user instead of the Vuforia Engine-provided default image.

Note the "You have 10 of 10 targets remaining" text in the screenshot above. Every device database created using the Model Target Generator counts against your allowance. Note that regeneration of the same model with a different Guide View also counts as new. Every training triggered will also count against the allowance.

  1. You will find your newly generated target dataset in the dataset folder under the project location previously set, within a [project-name]/dataset path.
Vuforia Image

Learn More

Model Targets overview

Model Target Generator User Guide

Model Target Guide View

Trained Model Target Datasets