Skip to main content
RACELOGIC Support Centre

HD2 - Range Element - macOS

What is a range element?

A range element can be used to show set text or a specific image when the values received on a channel are within a certain range. This is most commonly used to show information such as an RPM bar-style graph or vehicle gear.

VBOX Video HD2 software comes supplied with a library of range of elements. The user also has the option to create their own using a selection of PNG, JPEG or BMP image files, or written text ranges.

For example, the range element below shows RPM 0-10,000, using 10 different bar images.

VBVS Mac Range View.png

This element will show the following:

VBVS Mac Range RPM0.png

Range = 0 - 1000

VBVS Mac Range RPM1.png

Range = 1000 - 2000

VBVS Mac Range RPM2.png

Range = 2000 - 3000

VBVS Mac Range RPM3.png

Range = 3000 - 4000

VBVS Mac Range RPM4.png

Range = 4000 - 5000


VBVS Mac Range RPM5.png

Range = 5000 - 6000

VBVS Mac Range RPM6.png

Range = 6000 - 7000

VBVS Mac Range RPM7.png

Range = 7000 - 8000

VBVS Mac Range RPM8.png

Range = 8000 - 9000

VBVS Mac Range RPM9.png

Range = 9000 - 10000

Another example is shown below. This element will show gear using set text – this example is picking up gear from a vehicle CAN bus. If the gear is being calculated using Speed ÷ RPM, then these notes will help.

VBVS Mac Range GearN.png

Range = 0.1 – 1.0

VBVS Mac Range Gear1.png

Range = 1.1 – 2.0

VBVS Mac Range Gear2.png

Range = 2.1 – 3.0

VBVS Mac Range Gear3.png

Range = 3.1 – 4.0

VBVS Mac Range Gear4.png

Range = 4.1 – 5.0

VBVS Mac Range Gear5.png

Range = 5.1 – 6.0

VBVS Mac Range Gear6.png

Range = 6.1 – 7.0

VBVS Mac Range Gear7.png

Range = 7.1 – 8.0


Adding a supplied range element

Open the range library by clicking the ‘Range’ icon from the top panel buttons menu.

VBVS Mac Range Button.png

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

Note: Hovering over any of the range thumbnails will cause a larger preview of the bar graph to appear.

VBVS Mac Range Overview.png



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

VBVS Mac Scene Library mph.png

Note: When moving range elements, the background image must be selected, and not one of the set range images. If a range image is selected, this will move around inside the background image instead of moving the whole element.

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

Creating a new range element

When creating a new range element, an image can be used for the range background.

Note: Images can be resized within HD2 software.

Range background image example

Open the range library by clicking the ‘Range’ icon from the top panel buttons menu.

VBVS Mac Range Button.png


Within the Range library, selecting the 'New Range' option will add a new Range element to the scene.

VBVS Mac Range New.png

To upload a background image use the search icon VBVS Mac Search icon.png button within the background settings area.


Range Settings

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

VBVS Mac Range Settings.png

Setting the background

If you are creating a new range rather than using one from the range 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 Range Open.png

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

Defining the range parameter

The data set to display on the range 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 CAN.png

The second drop-down list defines the channel to be shown. In the example above, a CAN input is set to display RPM data.

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


These settings control all ranges which are sent to display ‘Text’, allowing all ranges to be changed easily.

Select the existing font to chose any font installed on the computer. The text size can be changed using the up and down arrows.

VBVS Mac Range Font.png

Set font colour

To change the colour, select the existing colour and choose from the colour wheel. The opacity of the colour can also be changed here.

To set a specific RGB value, click on ‘Color sliders’.

VBVS Mac Range Colour.png

Range Setup

When a new range is created, only the default range will be shown. This image or text will be shown when values are received which do not fall into any set range.

Set an image or write text within the default range.

VBVS Mac Range Image.png

VBVS Mac Range Text.png

Any added ranges will automatically match the type that has been set for the default.

For this example we will show an image range being set up:

Press ‘Add’ to load a new range and then click on the the search icon VBVS Mac Search icon.png button within the individual range settings to browse your computer.

VBVS Mac Range Add.png VBVS Mac Range Image2.png

Choose the desired image for the range.

VBVS Mac Range Open2.png

Move the image to show in the correct location within the range element by clicking and dragging the new image.

Tip: Images will always appear in the top left corner of the range. When using a transparent background, this can help with aligning images perfectly.

VBVS Mac Range Move.png



When the image is loaded, define the values between which this should display.

VBVS Mac Range Min Max.png

Repeat this for all additional ranges to be shown. Use the 'Test' box to check what will be shown when different values are received. 

The settings for any range can be checked by selecting the range of interest from the drop down box.

VBVS Mac Range Select.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?