Skip to main content
RACELOGIC Support Centre

HD2 - Gauge Element - macOS

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.

Adding a supplied gauge element

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

VBVS Mac Gauge Button.png

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.

Note: Hovering over any of the gauge thumbnails will cause a larger preview of the image to appear.

VBVS Mac Gauge Overview.png

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

VBVS Mac Scene Library mph.png

Gauges within the library will have pre-defined settings. These settings can be changed as shown here.


Creating a new gauge

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:

Speed dial.png

Gauge background image

Speed dial needle.png

Gauge needle image

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

 VBVS Mac Gauge Button.png


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

VBVS Mac Gauge New.png

To upload background and needle images use the search icon VBVS Mac Search icon.png  buttons within the background and needle settings area.


Gauge Settings

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

VBVS Mac Gauge Settings.png


Setting the background

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 VBVS Mac Search icon.png.

VBVS Mac Gauge New Background.png

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

Defining a gauge parameter

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 OBD.

Note: CAN and OBD options will only appear if they have been set up by the user.

VBVS Mac Parameter.png

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 VBVS Mac Channel Settings.png 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.

Changing the units

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

Needle Setup

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

VBVS Mac Gauge New Needle.png

Setting the crosshair

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

VBVS Mac Gauge Crosshair.png

Note: Depending on the needle image size, the red dot may need to sit slightly off centre.

Centering the needle image

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

VBVS Mac Gauge Centre.png

Defining the needle range

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

VBVS Mac Gauge Minimum.png

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

VBVS Mac Gauge Maximum.png

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

Setting needle direction

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

VBVS Mac Gauge Needle Direction.png

Setting the gauge range

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.

VBVS Mac Gauge Range.png


Multiple Gauge Rotations

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.

VBVS Mac Gauge Wheel.png

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).

VBVS Mac Copy.png VBVS Mac Paste.png

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.

VBVS Mac Delete.png


  • Was this article helpful?