HD2 - G-Ball Element - macOS
VBOX Video HD2 software comes supplied with a library of g-ball elements. The user also has the option to create their own G-Ball using PNG, JPEG or BMP image files.
Adding a supplied G-Ball element
Open the image library by clicking the ‘G-Ball’ icon from the top panel buttons menu.
A G-Ball library will then appear in the settings panel to the right. Clicking on a chosen G-Ball 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 G-Ball thumbnails will cause a larger preview of the image to appear.
You can toggle between G-Balls using mph or km/h units by using the buttons at the bottom of the library.
G-Balls within the library will have pre-defined settings. These settings can be changed as shown here.
The G-Ball element can be resized using the icon in the bottom right hand corner.
Creating a new G-Ball
When creating a new G-Ball element, an image can be used for the G-Ball background. A recommended size for a G-Ball image is 170 x 170 pixels – however, do note that images can be resized within HD2 software. A G-Ball marker image can also be uploaded, although a default marker is provided.
Example images are shown below:
G-Ball background image |
G-Ball marker image |
Open the G-Ball library by clicking the ‘G-Ball’ icon from the top panel buttons menu.
Within the G-Ball library, selecting the 'New G-Ball' option will add a new G-Ball element to the scene.
To upload background and marker images use the search icon buttons within the background and marker settings area.
G-Ball Settings
When a G-Ball is selected, its settings are shown in the right-hand panel.
Setting the background
If you are creating a new G-Ball rather than using one from the G-Ball library, or wanting to change the image, the background can be set by clicking on the search icon .
G-Ball backgrounds can be made transparent by ticking the ‘Transparent’ option within the G-Ball background area.
Changing the G-Ball marker
Size
The size of the G-Ball marker can be adjusted using the size slider.
Colour
All G-Ball elements from the library include a red marker image. 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’.
User image
Custom user images can be loaded by ticking the ‘User image’ box and then clicking on the search icon .
Defining the X and Y axis parameters
Although the standard use of G-Ball elements is to show lateral and longitudinal acceleration, the X and Y data set to display on the G-Ball can be changed using the two drop down menus within the 'Axis' sections.
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.
![]() |
![]() |
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 button opens up a Channel Settings window where you can configure CAN and OBD channels.
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
Setting the G-Ball range
The values set here will define the minimum and maximum values to be shown on the G-Ball element.
The default settings of library G-Balls is +/- 1.5 g in either direction. To test what will be shown on the G-Ball, adjust the enter ‘Test value’ slider.
Longitudinal g value = 0 g |
Longitudinal g value = 0.75 g |
Longitudinal g value = 1.5 g |
Lateral g value = 0 g |
Lateral g value = 0.75 g |
Lateral g value = 1.5 g |