Sign In |

Gauge Element

Updated on May 9, 2026

VBOX Video HD2 software comes with a supplied library of gauge elements. You also have the option to create your own gauges using PNG, JPEG or BMP image files.


Open the image library by clicking the ‘Gauge’ icon from the top panel buttons menu.

Screenshot of the Elements buttons with Gauge highlighted.

A gauge library will then appear in the settings panel to the right. Clicking on a chosen gauge will load it into the scene. Once a gauge has been added to the scene, it can be clicked and dragged to the desired location. 

Screenshot of the software with the Gauge Settings pane highlighted on the right hand side.

You can toggle between gauges using mph or km/h units by using the buttons at the bottom of the library.  

Image showing the speed options within the Scene Library with MPH selected.

Gauges within the library will have pre-defined settings.


When creating a new gauge element, an image can be used for the gauge background. A recommended size for a gauge image is 365 x 365 pixels – however do note that images can be resized within HD2 software. A gauge needle image can also be uploaded, although a default needle is provided.


Example images are shown below:

Image of a Speed Dial background image.
Gauge background image
Image of a speed dial needle.
Gauge needle image

Open the gauge library by clicking the ‘Gauge’ icon from the top panel buttons menu.  

Screenshot of the Elements buttons with Gauge highlighted.

Within the gauge library, selecting the 'New Gauge' option will add a new gauge element into the scene.  

Images depicting how to add a new gauge element.

To upload background and needle images use the search icon   buttons within the background and needle settings area.


When a gauge is selected, its settings are shown in the right hand panel.  

Screenshot of a new gauge added to the canvas with the settings pane highlighted on the right hand side.

If you are creating a new gauge rather than using one from the gauge library, or wanting to change the image, the background can be set by clicking on the search icon.

Images depicting selecting a new background image for the gauge element.

Gauge backgrounds can be made transparent by ticking the ‘Transparent’ option within the gauge background area.

The data set to display on the gauge can be changed using the two drop-down menus within the 'Parameter' section.

The first drop-down menu defines the source. Select either GPS, CAN or O 

Screenshot of the parameter settings with GPS, Speed and km/h selected.

The second drop-down list defines the channel to be shown. In the example above, GPS Speed is set to display in km/h.

Selecting the Channel Settings button opens up a Channel Settings window where you can configure CAN and OBD channels.

A number of GPS parameters are available to choose from, such as the following:

  • Satellites
  • UTC time
  • Latitude
  • Longitude
  • Speed
  • Heading
  • Height
  • Longitudinal acceleration
  • Lateral acceleration
  • Combined acceleration
  • Vertical speed
  • Local time
  • Day of month
  • Month
  • Year
  • Distance since power-up
  • Distance since stationary
  • Time stationary
  • Time moving
  • Radius of turn
  • Gradient (%)
  • Solution type

More information on the parameters can be found here.

Within the parameter section, speed, acceleration or distance channels can be set to display in different units.

The options available are:

  • Speed – km/h, mph, kts, m/s, ft/s
  • Acceleration – g, m/s², ft/s²
  • Distance – m, ft, km, mi, nmi

If you want to change the needle image, it can be set by clicking on the search icon.

Images depicting how to select a new image for the gauge needle.

Set the needle rotation point by clicking and dragging the needle crosshair.  

Images depicting how to move the gauge needle crosshair.

Click the ‘Centre’ button to move the crosshair to the centre of the gauge background.  

Images depicting how to set the crosshair of the needle to the centre of the gauge.

Move the slider so the needle sits at the minimum position. Click ‘Set minimum’ to save.  

Images depicting how to set the needle so it sits at the minimum range position.

Move the slider so the needle shows the maximum position. Click ‘Set maximum’ to save.  

Images depicting how to set the needle so it sits at the maximum range position.

To clear all minimum and maximum position settings, press the ‘Reset’ button.

Needle direction can be set to clockwise or anti-clockwise. The default setting is clockwise, as shown in the example below.  

Images depicting how to set the needle direction to clockwise.

The values set here must match the numbers on the gauge image. To test what will be shown on the gauge, enter a value into the ‘Test value’ box.  

Images depicting the range minimum and maximum values of 0 and 180.

The number of 360° rotations between the maximum and minimum points can be increased using this setting.

This is useful when using a transparent background and a steering wheel image needle.  

Images depicting setting the number of rotations that the gauge needle can make to 4.

Elements and their associated settings can be duplicated within a scene by either right-clicking on the element, selecting 'Copy' from the dropdown then right-clicking in an empty area and selecting 'Paste' from the dropdown, or by using keyboard shortcuts 'Command + C' (Copy) and 'Command + V' (Paste).

Screenshot of the Elements menu with Copy highlighted.
Screenshot of the Elements menu with Paste highlighted.
Screenshot of the Elements menu with Copy highlighted.
Screenshot of the Elements menu with Paste highlighted.

Elements can be removed from the scene in two ways; either by right-clicking on the element, selecting 'Delete' from the dropdown and confirming the prompt, or by pressing the 'Backspace' key on a keyboard, and again, confirming the prompt.

Screenshot of the Elements menu with Delete highlighted.