Working with Widgets > 3D > Model Target
  
Model Target
* 
For information about best practices and troubleshooting for Model Targets, see the following topics:
What Does This Widget Do?
The Model Target widget allows you to use 3D models to track physical objects in an experience.
* 
In order for the model target to track properly, the scale size of the model in Vuforia Studio must match the actual size of the physical object. If the imported 3D model does not match the physical size of the object, use the Scale property on the Model widget to adjust it.
When Should I Use This Widget?
At runtime, a Model Target can be used to recognize a physical object by comparing it with its 3D representation, and display 3D augmentations without requiring any physical markers on the product.
Are There Any Special Properties, Services, Events, or Actions?
To view a list of common widget properties, services, and events, see Common Widget Properties, Services, and Events.
If you are running Vuforia Studio and Experience Service 9.13.0 or greater, the following tables list read-only properties, services, and events that are specific to this widget. For information about JavaScript properties and API, see Model Target Web API.
* 
If you are unsure about which version of the Experience Service you are running, contact your administrator.
Property Name
Description
Configure Model Target
Allows you to configure the Model Target. For more information, see Configure a Model Target.
Model Target Type
Once you have configured a Model Target, the type of Model Target is displayed here.
Standard—best for objects that must be recognized from a single angle
Advanced—best for objects that can be recognized from any angle (360 degrees)
* 
Advanced Model Targets are only available to PTC customers who have requested that Advanced Model Targets be enabled for their Experience Service. If you are a PTC Cloud customer and would like to create the request, open a support case, select Vuforia Studio from the Product field, and then select Yes – Request an activity (refresh,build,access,upgrade etc) or information on PTC Cloud Environment from the Do you want to open a case with PTC Cloud Services? drop-down menu. If you are an on-premises customer, see Request Advanced Model Target Generation.
For more information about Standard and Advanced Model Targets, see Standard and Advanced Model Targets.
Optimize Tracking for
Once you have configured a Model Target, the type of optimization you selected is displayed here.
Either Default or Low Feature Object will be displayed.
Appearance
Once you have configured a Model Target, the type of appearance you selected is displayed here.
Geometry Simplification
Once you have configured a Model Target, whether or not you have simplified your model is displayed here.
Tracked
Is enabled when the camera recognizes the target.
Model Widget ID
ID of the related model.
Event
JavaScript
Description
Tracking Acquired
trackingacquired
Triggered when tracking is initiated.
Tracking Lost
trackinglost
Triggered when tracking is lost.
If you are running Vuforia Studio and Experience Service 9.12.0 and below, the following tables list properties, services, and events that are specific to this widget.
* 
If you are unsure about which version of the Experience Service you are running, contact your administrator.
Property Name
JavaScript
Type
Description
Initial Tracking Position
detectionPosition
json
Allows you to set the initial tracking position of the model.
Model Target Type
modelTargetType
string
Once you have configured a Model Target, the type of Model Target is displayed here.
Standard—best for objects that must be recognized from a single angle
Advanced—best for objects that can be recognized from any angle (360 degrees)
* 
Advanced Model Targets are only available to PTC customers who have requested that Advanced Model Targets be enabled for their Experience Service.
If you are a PTC Cloud customer and would like to create the request, open a support case, select Vuforia Studio from the Product field, and then select Yes – Request an activity (refresh,build,access,upgrade etc) or information on PTC Cloud Environment from the Do you want to open a case with PTC Cloud Services? drop-down menu.
If you are an on-premises customer, see Request Advanced Model Target Generation.
For more information about Standard and Advanced Model Targets, see Standard and Advanced Model Targets.
Object is static
* 
This property is not available in 3D eyewear projects.
staticModeStr
boolean
Select this checkbox if the physical object in your experience is stationary and does not move. For example, cars and large machinery.
When both this setting and the Object has a shiny surface setting are enabled, tracking is enhanced for larger objects with reflective surfaces, and AI powered tracking technology is enabled, which greatly improves tracking quality and robustness as long as the object is not moving.
Object has shiny surface
carModeStr
boolean
Select this checkbox when the physical model in your experience is a car exterior or a similar highly reflective large object. Enabling this property optimizes the tracking performance to reduce drift in certain situations at the cost of higher CPU load.
Tracked
istracked
boolean
Is enabled when the camera recognizes the target.
Model Widget ID
model
string
ID of the related model.
Event
JavaScript
Description
Tracking Acquired
trackingacquired
Triggered when tracking is established. The parameter passed is the widget ID.
Tracking Lost
trackinglost
Triggered when tracking is lost. The parameter passed is the widget ID.