The Vuforia Target Manager is a web-based tool that enables you to create and manage target databases online. You can also manage the assignment of databases to license keys using the Target Manager.
Use the Target Manager to:
- Create Device, VuMark, and Cloud Databases
- Assign databases to license keys
- Add targets to databases
- Edit and remove targets
- Manage databases
- Download Device Databases
The Target Manager supports both image based targets and VuMarks. Target images for Image Targets, Multi-Targets, and Cylinder Targets must be either 8 or 24 bit PNG or JPG files. JPG files must be RGB or greyscale. The maximum image file size is 2.25 MB.
VuMarks must be SVG files created using the VuMark Designer tool in Adobe Illustrator.
See: Designing a VuMark in Adobe Illustrator
The Target Manager also supports Object Data (*.od) files produced by the Vuforia Object Scanner. Object Data files are used for Object Recognition
Working with the Target Manager
To begin working with the Target Manager, you’ll need a Vuforia Engine Developer account.
How To Register as a Vuforia Engine Developer.
All Databases created in the Target Manager must be associated with an license key.
How To Create an App License
How To add a License Key to your Vuforia Engine App
Once you have a license key defined in the License Manager, you can:
- Create a database
- Add targets
- Download your database and add it to your Vuforia Engine project
- Update and manage your databases and targets throughout the life of your app
Device, VuMark, and Cloud Databases
Vuforia Engine supports three database types for storing targets.
- Device Databases are local databases of image or object targets that are stored on the user's device
- VuMark Databases are local databases of VuMarks that are stored on the user's device
- Cloud Databases are databases of Image Targets stored online and queried over the internet.
Use a Device Database when you need to the fastest possible recognition of Image, Cylinder or Multi-Targets targets and won't need to change the target set for your app very frequently. You should also use a Device Database when using Object Targets for Object Recognition.
Use a VuMark Database when you need to recognize, decode and/or track a VuMark.
Use Cloud Databases when you need to detect from up to 1 million Image Targets or want the convenience of being able to actively manage your target set online. Cloud Databases do not support Cylinder Targets or Multi-Targets.
There are also performance differences between Device and Cloud Database.
- Query times for Device Databases are faster than for Cloud Databases
- Device Databases support tracking of multiple targets simultaneously, while Cloud Databases support tracking of one target at a time.
- Large Device Databases can take a few seconds to load, while Cloud Databases can be queried as soon as your app starts.
Troubleshooting Errors from the Target Manager
The Target Manager lets you create device and cloud databases and upload targets onto your databases (image targets, multi-targets, cloud targets, etc.). If you run into these problems, please try the solutions listed.
You get an error message while using the Target Manager to create or upload a new target.
Check the following conditions:
Your image is in one of the supported formats, PNG or JPEG
Your image is either grayscale or RGB-24 bit. This means that 32-bit images with an alpha channel (RGB + Alpha) are not allowed.
Your image size does not exceed 2 MB
When creating a multi-target (cube or cuboid), the aspect ratio of each image must precisely match the aspect ratio of the corresponding face on your cube or cuboid.
The aspect ratio is computed as the ratio image_width / image_height. The following table lists examples of image resolutions and their aspect ratio.
|A resolution of 1024 x 512 pixels||1024 / 512 = 2|
|A cube (all dimensions are equal)||ALL faces are always 1.|
|A cuboid with dimensions W (width) x H (height) x L (depth) top and bottom face images||W / L|
|front and back face images||W / H|
|left and right face image||L / H|
IMAGE TARGET RATING
A target is not detected by Vuforia Engine
Image targets are assigned a star rating, depending on the quality of the target. The star rating influences the robustness of the target with respect to detection and tracking. The star rating can vary between 0 and 5 stars. A higher rating is better, because the image target provides easier detection and more stable tracking.
Note that a target can be detected by Vuforia Engine only if it is rated at least 1 star. Any zero-star targets cannot be used. If your database contains any zero-star targets, you should not select them when downloading your database.
For more information on how to create high quality (and high rating) targets, see:
Natural Features and Image Ratings
Recommendations for Improving Target Detection and Tracking Stability