How to Create a Model Target

Model Targets are created with the Model Target Generator (MTG) app. This article provides a step-by-step introduction to the app. For general information about the MTG, refer to the Model Target Generator User Guide.

Installing the MTG

Refer to the Model Target Generator User Guide for installation instructions.

Launching the MTG

  1. Open the Model Target Generator from the location where you installed it or via the shortcut.
  2. A login dialog opens where you must enter your Vuforia Developer account credentials.
Vuforia Image

Creating a Model Target

The MTG package includes the NASA Viking Lander as a 3D model.

  1. Click the Create New Model Target button (or select Open Model Target to open a previously created project).
Vuforia Image
  1. Click the Select... button.
    Ensure the Location field is not set to an unmapped network path.
Vuforia Image
  1. Open VuforiaMars_ModelTarget.pvz, located at:
    \resources\sampledata\VuforiaMars_ModelTarget
    The Model Target Name is given the same name as the CAD model file. The name of the model target can be changed in the Model Target Name field.
  2. Click the Create Model Target button.
    The model displays in the 3D view pane.
  3. In the 3D view pane, use the Rotate, Zoom, and Pan icons to navigate around the model to inspect for missing parts or incorrect normals. Refer to the Model Targets Supported Objects & CAD Model Best Practices article for more information.
Vuforia Image

Verifying Model Fit

The size of the Model Target needs to match the size of the object in the physical world. In the 3D view pane, the current size will be displayed, showing the bounding-box size along all three axes. The steps below ensure the model corresponds to the physical size of the object.

  1. In the right pane, select Model Attributes.
  2. In the File Units dropdown, select the proper unit for your model. For example, select centimeters for a toy car and meters for an actual car.
  3. NOTE: The unit selected does not re-scale the 3D model. Instead, the unit specifies how a unit of one is interpreted. Rescaling the model is not supported in the MTG because it's designed to be a 3D model viewer, not a mesh editor. You may need to change the size of the CAD model using its creation tool. Alternatively, try a different model file format. Some file formats, such as obj, are unit agnostic. Also, be attentive to the model scale when importing the Model Target database into Unity. This ensures that the sizing is consistent. More information on scaling Model Targets can be found in the Best Practices for Scaling Model Targets.

Vuforia Image
  1. In the Up Vector dropdown, select the orientation that places your model correctly.
  2. In the Motion Hint dropdown, select either STATIC or ADAPTIVE. If the object is stationary, select STATIC. If the object is likely to be moved, select ADAPTIVE. The selected value is stored in the generated .xml file and can be overridden later in native or Unity. Additionally, a Tracking Mode can be set to improve tracking perfomance. For more information, refer to the Optimizing Model Target Tracking article.

Adding Guide Views

  1. In the 3D view pane, select the HoloLens, Landscape, or Portrait icons to change 'masks'.
    Depending on your selection, the dotted line in the 3D view pane adjusts the screen rendering area of the app.
  2. In the right pane, select Create Guide View. This creates a Guide View from the exact position of the ‘mask’.
  3. Use the View icons or your mouse to change the position and optionally, create additional Guide Views.

NOTE: The other button lets you create Advanced Views which are Guide Views with a defined recognition range. Using Advanced Guide Views on your model require that you train your Model Targets as an Advanced Model Target database. For more information, visit Advanced Model Target Databases and Model Target Guide View.  

  1. When you create Guide Views, a preview of the Guide View is displayed in the right pane.
Vuforia Image
  1. On top of the Guide View preview, you will find three icons;  to edit recognition ranges,  to reposition the Guide View,  to delete the Guide View.
    The Recognition Range pane is particularly for Advanced Views. Use it to also change the Target Extent of your Guide View. Refer to the Model Target Guide View for more information on adjusting these values.
  2. Rename the Guide View (e.g., front, back, above, below, close-up, advanced 90 degree view) and click Save.

Generate Model Target

  1. In the right bottom pane, click the Generate Model Target button.

NOTE: The Generate Model Target dialog opens and displays the number of targets remaining. Every Model Target database created using the MTG counts against your target quota. Re-generation of the same model with a different Guide View also counts as new. Additionally, every training session counts against the training quota. For specific quota options associated with any license, refer to the pricing page.

Vuforia Image
  1. In the dialog, click Continue to generate a Model Target database of your model and the configured Guide Views. The PNG images for each of your Guide Views are saved to the project directory.

NOTE: These images can be used as a starting point to create custom Guide View images to present to the user instead of the Vuforia Engine provided default image.

  1. In the Model Targets window, click the menu (...) icon and select Open Destination Folder.
    The destination of the newly generated Model Target database opens in the project folder.
Vuforia Image

If you haven’t already done so, repeat the steps with your own CAD model and/or head over to the Model Target Test App User Guide to test your newly generated Model Target. If you wish to create Advanced Model Targets, refer to the Advanced Model Target Databases article.

Learn More

Model Targets overview

Model Target Generator User Guide

Model Target Guide View

Advanced Model Target Databases