Skip to main content
RACELOGIC Support Centre

HD2 - Bar Graph Element - macOS

VBOX Video HD2 software comes supplied with a library of bar graph elements. The user also has the option to create their own bar graph using a PNG, JPEG or BMP image file.

Adding a supplied bar graph element

Open the bar graph library by clicking the ‘Bar’ icon from the top panel buttons menu.

VBVS Mac Bar Button.png


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

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

VBVS Mac Bar Overview.png

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

VBVS Mac Scene Library mph.png

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

The bar graph element can be resized using the icon in the bottom right-hand corner.

VBVS Mac Bar Resize.png

Creating a new bar graph

When creating a new bar graph 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.


Bar graph background image

Open the bar graph library by clicking the ‘Bar’ icon from the top panel buttons menu.

 VBVS Mac Bar Button.png


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

VBVS Mac Bar New.png

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

Bar Graph Settings

When a bar graph is selected, its settings are shown in the right-hand panel. The settings presented are dependent on whether the background or the bar fill is selected.

VBVS Mac Bar Settings1.png

Background settings

VBVS Mac Bar Settings2.png

Bar fill settings


Setting the background

If you are creating a new bar graph 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 when the background is selected.

VBVS Mac Bar New2.png

Bar graph backgrounds can be made transparent by ticking the ‘Transparent’ option within the bar graph background area.

Defining a bar graph parameter

When either the bar background or fill is selected, the data set to display on the bar graph 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 Throttle.png

The second drop-down list defines the channel to be shown. In the example above, a CAN input is set to display Throttle pedal 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

Bar Setup

Set fill area

Move the bar graph fill area to the desired location and re-size it using the icon in the bottom right corner.

VBVS Mac Bar Fill Move.png

Set bar colour

After the bar size and location has been set, choose the colour the bar will fill with. 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 Bar Colour.png

Fill direction

Set the direction in which the bar graph will fill.

VBVS Mac Bar Fill Direction.png

VBVS Mac Bar Fill Example1.png

Left to Right

VBVS Mac Bar Fill Example2.png

Right to left

VBVS Mac Bar Fill Example6.png

Bottom to Top

VBVS Mac Bar Fill Example5.png

Top to Bottom

Minimum position

The minimum position setting will automatically move depending on fill direction. For most cases, the user will not need to change this.

VBVS Mac Bar Minimum Pos.png

If configuring a bar graph for a negative value, the minimum position may need to be changed.

For example:

VBVS Mac Bar Fill Example3.png

VBVS Mac Bar Fill Example4.png



As the left hand bar graph is showing negative values, it will need to be set as shown below.

VBVS Mac Bar Reverse.png

Bar Range

The last step is to define the minimum and maximum values of the bar graph within the fill settings. Use the 'Test Value' box within the background settings to check what will be shown when different values are received.

VBVS Mac Bar Range.png


Using multiple bars

Multiple bars can be added into a single bar graph element. When using multiple bars, the process above must be followed for each bar individually.

Additional bars are added into a bar graph element using the ‘Add’ button within the background settings.

VBVS Mac Bar Add.png

To set up each bar, click on it so it is highlighted. The settings within the right hand panel will apply to the selected bar.

VBVS Mac Bar Multiple.png

Each bar can have its range, colour and fill direction defined individually.

Note: Only one parameter can be set to a bar graph element.

VBVS Mac Bar Multiple1.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?