Navigating Vuforia Studio > Widgets > 3D > Model
Because model files are bundled within each experience and may contain confidential information, it is highly recommended that you ensure that the bundled files do not expose IP information that should otherwise be protected.
What Does This Widget Do?
The Model widget allows you to add models to your experience.
When Should I Use This Widget?
Use a Model when you want to include a 3D model in your experience.
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.
The following tables list properties, services, and events that are specific to this widget.
Resource being used for the model.
Scale of the model.
X Coordinate
Location of the model on the x-axis.
Y Coordinate
Location of the model on the y-axis.
Z Coordinate
Location of the model on the z-axis.
X Rotation
Rotation of the model about the x-axis.
Y Rotation
Rotation of the model about the y-axis.
Z Rotation
Rotation of the model about the z-axis.
If set to true, the geometry of a widget is invisible, but at the same time hides any other augmentations behind it in the 3D scene.
Therefore, the background or camera feed appears where the occluded widget should be. This can be used to emphasize some augmentations by hiding surrounding 3D geometry.
Always on top
Overlays the widgets geometry on any other augmentations in the scene regardless of its depth in the 3D scene. If set to Yes, it is never hidden by other augmentations. Typically this can be used for labels or sensors that must always remain visible.
Opacity (1 Opaque - 0 Transparent)
A number between 0 and 1 that controls the level of transparency of the object. 0=completely transparent and 1=completely opaque. If set to semi-opaque (for example, opacity is set to <1), this will control whether the model it is drawn as a transparent shell (the default), or is entirely see-through.
Current Step
The current step of the active sequence if any have been specified for the model.
The step number playing in a sequence.
Sequence List
When bound to a widget, (for example, a Repeater, List, or Select widget) you can easily change the sequence for a model that has multiple sequences.
Used for animation of the model. Select from resources that have been added to the AR project to display an sequence option in your experience. This drop-down list is automatically populated with available .pvi files when a .pvz file is selected for the Resource property. Two sequences should not be run at the same time.
Sequences created with Creo Illustrate 8.0 or below are supported.
Apply sequence at design time
When this is checkbox is checked, and a sequence selected, the initial step of the sequence is applied directly in the design view.
Total number of steps in a sequence.
Moves a sequence forward one step.
Plays a step in a sequence.
Play All
Plays all steps in a sequence.
Resets a sequence back to the beginning.
Moves a sequence back one step.
Stops the playing of a sequence.
Play Started
Triggered when a step in the sequence is being played.
Play Stopped
Triggered when a step in the sequence ends.
Model Loaded
Triggered when the model is loaded.
Acknowledge Requested
Triggered when an acknowledgement is requested during a sequence.
Use the JS expression box to create custom interactions for the acknowledgement.
To override all other visibility settings and hide the model and all items related to it, bind one of the following widget properties to the model, and select Force Hide on the Select Binding Target window:
2D Widget
Toggle Button
Not Pressed
This also overrides any visibility as set by the selected sequence.
The Widget in Action
Here’s an example of what your widget might look like!
Minimum Steps Required for Use
What It Looks Like
1. Drag and drop a Model widget onto the canvas.
2. In the Resource field, select an existing CAD file, add a new one, or enter the URL to the file you want to display.
3. Position the model on the canvas as you want.