How to Create a Model Target

Model Targets are created using the Model Target Generator app. This page gives a step-by-step walkthrough of the tool.

For more general information about the Model Target Generator, including installation instructions, see the Model Target Generator User Guide.

Launching the MTG

  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

Creating a Model Target

  1. Click Create New Model Target (you can also open previously created projects by selecting Open Model). The MTG package includes the NASA Viking Lander as a 3D model which can be used with the Model Target Generator.
Vuforia Image

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

Vuforia Image
  1. Click the Select button next to the CAD Model field and navigate to the file VuforiaMars_ModelTarget.pvz from the prepackaged VuforiaMars_ModelTarget folder. Select the model and the Model Target Name will be filled in automatically. Optionally, you may change the name for the Model Target in the Model Target Name field. In most cases, the directory folder can be found here: C:\Users...\resources\sampledata\VuforiaMars_ModelTarget
Vuforia Image
  1. Click Import. It may take a few moments to load your mode.
Vuforia Image
  1. Your model will appear in the model view. You may use the buttons in the left side of the window to navigate around the model to inspect it for any missing parts or incorrect normals. See Model Targets Supported Objects & CAD Model Best Practices for more information.
Vuforia Image

Verifiying Model Fit

  1. The size of the Model Target needs to match the size of the object in real life. The currently used size is displayed as measurements in the 3D view, showing the bounding-box size along all three axis.

    To ensure the model corresponds to the physical size of the object, navigate to Model Attributes in the right side of the window and select the unit that your model is defined in, by using the File Units menu (for example, a real car is a couple of m, a toy car is tens of cm).

NOTE: the unit in the File Units does not re-scale the 3D model - it only specifies how a unit of 1 is supposed to be interpreted. Rescaling the model is not supported in the MTG as it is only designed to be a 3D model viewer and not a mesh editor.

Vuforia Image

    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:
    you may need to pay attention to the scale of your model when you import the Model Target database into Unity as well, to ensure that the sizing is consistent.

  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 that is available in the Model Attributes. The correct orientation for the NASA Viking Lander model is the Up Vector: Y.

Adding Guide Views

  1. Now, you need to add one or more Guide View to your Model Target.
    A dotted line in the 3D-viewport represents the screen/rendering-area of your app. You can choose between different 'masks' for landscape, portrait, or HoloLens to get the best feeling during placement.

    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 Create 1 Guide 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.

    When training an Advanced Model Target, you can add multiple Guide Views for your object by repeatedly moving the viewpoint and clicking Create 1 Guide View. Alternatively, choose among 1 and up to 6 views to instantly create several Guide Views around the object at a default distance and angle with default settings.

    Advanced Model Targets 360 require creating a single 360° Guide View.

  1. For any type of Advanced Model Targets, you can also change the Target Recognition Range for each Guide View by clicking on the 3D cube icon above the created Guide View. Refer to Model Target Guide View for details. Finish the Guide View preparations by naming each Guide View such as front, back, above, below, etc.
Vuforia Image

Generate Model Target

  1. Press Generate Model Target on the top bottom bar, which will show the following dialogue:
Vuforia Image

    Click Continue to generate a Model Target database using your model and the configured Guide Views. You will see a progress counter, indicating that the database 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 creating a custom Guide View image to present to the user instead of the Vuforia Engine-provided default image.

    NOTE: the "You have # of 20 targets remaining" text in the screenshot above. Every Model Target database created using the Model Target Generator counts against your target quota. Note that regeneration of the same model with a different Guide View also counts as new. Every training session will also count against the training quota.

    For specific quota options associated with any license please refer to the pricing page.

  1. You will find your newly generated target database in the <target-name>\dataset folder under the project location previously set. You can also find the project folder of the Model Target by clicking the menu next to the overview and select Open Destination Folder.
Vuforia Image

Creating an Advanced Model Target database is covered in the following articles: Advanced Model Target Databases And Getting Started with Advanced Model Target 360.

Learn More

Model Targets overview

Model Target Generator User Guide

Model Target Guide View

Advanced Model Target Databases

Getting Started with Advanced Model Target 360.