Navigating Vuforia Studio > Widgets > 3D > 3D Gauge
  
3D Gauge
What Does This Widget Do?
The 3D Gauge widget combines image and text widget functionality on the 3D canvas of an AR Experience. After dragging and dropping the 3D Gauge widget onto the canvas, a default image and default text is displayed (both of which can be updated). Supported file formats include:
.png
.jpg, .jpeg
.svg
.gif
.bmp
When Should I Use This Widget?
Use a 3D Gauge when you want to display a property from a connected thing in a 3D gauge. For example, if you want to display the engine temperature from a generator, simply bind the EngineTemp property to the gauge.
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
Resource
The image being used for the 3D gauge. By default, this is set to vu_gauge1.svg.
To include a 3D Gauge, you can do one of the following:
Click next to the field to add a new image file.
Enter or copy and paste an image URL directly into the field.
Select an image from the drop-down menu.
Font
Font type. By default, this is set to Arial.
Font Size
Size of the font specified in pixels. By default, this is set to 40px.
Text Attributes
Attributes of the text including:
Fill
Text baseline
Text alignment
Enable State-Based Formatting
Allows you to format the widget based on state definitions that have been defined in ThingWorx.
If the checkbox is selected the following properties appear:
Dependent Field
State Definition
For more information about style and state definitions in ThingWorx, see Style and State Definitions in the ThingWorx Help Center.
X coord of Text w/r/t Canvas
Location of the text on the X-axis with respect to the canvas.
Y coord of Text w/r/t Canvas
Location of the text on the Y-axis with respect to the canvas.
Scale
Scale of the gauge
X Coordinate
Location of the gauge on the x-axis.
Y Coordinate
Location of the gauge on the y-axis.
Z Coordinate
Location of the gauge on the z-axis.
X Rotation
Rotation of the gauge about the x-axis.
Y Rotation
Rotation of the gauge about the y-axis.
Z Rotation
Rotation of the gauge about the z-axis.
X coord of Image w/r/t Canvas
Location of the gauge on the X-axis with respect to the canvas.
Y coord of Image w/r/t Canvas
Location of the gauge on the Y-axis with respect to the canvas.
Canvas Growth Override
Allows you to choose when the canvas size is overridden. Select one of the following options.
Canvas grows with text size
Canvas grows with image Size
Canvas grows with image and text sizes (default)
No Override
Canvas Height
Height of the canvas.
Canvas Width
Width of the canvas.
Billboard
Rotates a widget around its center so it is always facing the viewer. It is aligned with the screen.
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.
Pivot
Determines the pivot point of the image:
Top Left
Top Center
Top Right
Middle Left
Middle Center
Middle Right
Bottom Left
Bottom Center
Bottom Right
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 3D Gauge widget onto the canvas.
2. From the Data pane, search for an entity that has a service with a numeric property.
3. Once the service has been added, drag and drop a numeric property under Current Selected Item onto the widget and select Text on the Select Binding Target window.
* 
From the Data pane, be sure to select Invoke On StartupServices > Configuration.