Sign In |

Gauges

Updated on May 11, 2026

A gauge can be any shape, but is typically circular with a rotating needle. 

Gauges can be used to display any of the available GPS or CAN/input module parameters such as speed (GPS), RPM (CAN/module) etc.  

Image of a Gauge element.


Using a supplied gauge

There are a number of preconfigured gauges which have different ranges and styles which can be inserted into the scene by dragging and dropping.

You then need to configure the parameter which is displayed, and the units using the Gauge Properties section (highlighted).

Screenshot of Video VBOX Setup software with the Elements tab selected, and the Gauge Properties highlighted.


Gauge creation

Creating a new gauge

Select the Elements Tab on the right hand side.

Select  Gauge, then use the New button.  

Screenshot of the Elements tab with Gauge selected as the element type and the New button highlighted. Labels also highlight the Gauge Properties and the Load Background button.

Choosing a background

The background of the gauge is the face of the element, it can be a .bmp, .jpg or .png file. It can contain the numbers for the gauge, or it could be blank, with the numbers being added in afterwards. Examples below.  

Image of an example gauge background.
Image of an example gauge background.
Image of an example gauge background.
Image of an example gauge background.
Image of an example gauge background.
Image of an example gauge background.


Assigning a needle

Once a background has been selected, you can now load a needle. The needle is a simple vertical image of a needle and must not have any spare space or borders around the image.

Screenshot of the Gauge Properties with the Load button highlighted.
Images showing examples of unacceptable and acceptable needle images.
Screenshot of the Gauge Properties with the Load button highlighted.
Images showing examples of unacceptable and acceptable needle images.


Positioning the needle

Images depicting how to position the needle within the gauge using the crosshairs.


Setting the needle direction

Images depicting how to set the needle rotation direction.


Defining the range of the needle

Images depicting how to define the range of the needle.

Multiple Needle Rotations

If multiple rotations of the needle are required, enter the number of full rotations required here. If partial rotations are required, the Set Minimum and Set Maximum function can be used.  

Screenshot of the Needle properties with the Number of Rotations option highlighted.


Speed labels

The most flexible gauge to use is a blank gauge without any numbers. To use this element, just drag and drop this gauge from the Elements tab onto your scene. Then you can add the speed labels around the gauge using the Label element type.

The speed range does not have to start from zero, it can go from 25 to 125 for example, but make sure you set the Min (25) Max (125) range under Background for this element. Note that the needle will always be drawn over the top of any other element.

Image depicting how to add a new speed label to the gauge.


Setting the parameter range

Set the maximum and minimum values to match the face of the gauge. Note you do not have to start at zero.  

Image depicting how to set the parameter range of a gauge element.


Assigning a parameter to the gauge

You can use any logged parameter to display on the gauge, select from the menu under Gauge Properties.  

Screenshot of the Gauge Properties with Parameter settings highlighted.


Changing the units (e.g. from MPH to Km/h)

You can change the units of the parameter using the drop down menu shown below.  

Screenshot of the Gauge Properties with the Parameter units dropdown list of options displayed.


Moving gauges around

By clicking and dragging a selection box around a number of elements you can create a temporary group, which can then be dragged anywhere on the scene as one item. You can also copy and delete multiple items using this method, just right click over the grouped elements to bring up a menu of functions.  

Image depicting how to click and drag to create a temporary group.