Navigating Vuforia Studio > Widgets > 3D > Model Item
  
Model Item
What Does This Widget Do?
The Model Item widget allows you to select an individual model item on the already loaded CAD model and apply properties directly to that item without applying the changes to any other part of the model.
When Should I Use This Widget?
Use the Model Item widget when you want to change the properties for an item on the model without change the properties on the model itself. For example, if you want to change the color of an item on the model.
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 table is a list of properties that are specific to this widget.
Property
Description
Model Widget ID
ID of the related model.
Component Occurrence
Path to the component.
Scale
Size of the model item.
X Coordinate
Location of the model item on the x-axis.
Y Coordinate
Location of the model item on the y-axis.
Z Coordinate
Location of the model item on the z-axis.
X Rotation
Rotation of the model item about the x-axis.
Y Rotation
Rotation of the model item about the y-axis.
Z Rotation
Rotation of the model item about the z-axis.
Occluding
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 item is drawn as a transparent shell (the default), or is entirely see-through.
Item Translucence
Makes the item translucent.
Color
Color of the model item.
* 
To override all other visibility settings and hide the model item and all items related to it, bind one of the following widget properties to the model item, and select Force Hide on the Select Binding Target window:
2D Widget
Property
Checkbox
Value
Toggle
Value
Toggle Button
Pressed
Not Pressed
This also overrides any visibility as set by the selected sequence.
Service
Description
Forward
Moves a sequence forward one step.
Play
Plays a step in a sequence.
Play All
Plays all steps in a sequence.
Reset
Resets a sequence back to the beginning.
Rewind
Moves a sequence back one step.
Stop
Stops the playing of a sequence.
Event
Description
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
Property
Checkbox
Value
Toggle
Value
Toggle Button
Pressed
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 Item widget onto a part on the model.
2. Set the properties you wish to change on that item of the model. For this example, we’ve changed the color of the top of the pump to green.