Skip to main content
RACELOGIC Support Centre

HD2 - Range Element - Windows


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


This element will show the following:


Range = 0 - 1000


Range = 1000 - 2000


Range = 2000 - 3000


Range = 3000 - 4000


Range = 4000 - 5000


Range = 5000 - 6000


Range = 6000 - 7000


Range = 7000 - 8000


Range = 8000 - 9000


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.


Range = 0.1 – 1.0


Range = 1.1 – 2.0


Range = 2.1 – 3.0


Range = 3.1 – 4.0


Range = 4.1 – 5.0


Range = 5.1 – 6.0


Range = 6.1 – 7.0


Range = 7.1 – 8.0

Adding a supplied range element

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


A drop down menu will then appear, allowing a range to be selected from the library. Clicking on a chosen range will load it into the scene.
Note: Hovering over any of the range thumbnails will cause a larger preview of the bar graph to appear.

Range Add.png

Selecting the 'Filter' drop-down on the left enables you to filter the Ranges shown between default and custom created.


Once a range element is added to the scene, it can be clicked and dragged to the desired location.

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.

Range elements within the library will have pre-defined settings, which will need to be changed by the user. These settings can be changed as shown here.


Creating a new range element

When creating a new range element, an image for the background is required, unless using a transparent background, in which case tick the ‘Transparent’ option. An example image is shown below.

Note: Images can be resized within HD2 software.


Range background image example

To create a new range, click the ‘Range’ icon from the top menu.


Within the drop-down menu, selecting the ‘New’ option will add a new bar graph element to the scene. 

Range New.png

Double click on the new range to load a background image.

43 (1).png

Alternatively, tick the ‘Transparent’ box within the background area.

7 (1).png

Now the background image has been set, the settings of the range can be defined.

Range Settings

When an element is selected, its settings are shown in the right hand panel.

Range Settings.png

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 CAN, GPS, Heart rate monitor (if being used with a heart rate element), Maths Channels or OBD.

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

27 (1).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.

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 set to display ‘text’, allowing all ranges to be changed easily.

Use the top drop-down box to select any font installed on the PC in use.

29 (1).png

Set font colour

To set a specific RGB colour, click ‘Advanced’.

44 (1).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.

31 (1).png

32 (1).png

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

E.G - If a default image has been sent, a window will appear prompting the user to load an image for range 1. If a default text string has been entered, range 1 will prompt the user to enter text.

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

Press ‘Add’ to load a new range.

35 (1).png

Choose the desired image for the range.

36 (1).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.

45 (1).png

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

37 (1).png

Repeat this for all additional ranges to be shown. Use the 'Test value' 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.

38 (1).png

Loading a new range background image

Range background images can be changed by clicking the search icon46.pngnext to the currently loaded image.

Note that backgrounds can be made transparent by ticking the ‘Transparent’ option.

28 (1).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 'Ctrl + C' (Copy) and 'Ctrl + V' (Paste).

Element Copy.png Element 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 'Delete' key on a keyboard, and again, confirming the prompt.

Element Delete.png

  • Was this article helpful?