rF-SkinHud

WARNING: This program doens't work on Windows Vista for the moment. If running rFactor under Vista you can however network an XP pc and run this tool on the XP pc.

Preface

rF-SkinHud is a program that shows realtime data (speed, rpm, position, gear, damage, ....) from rFactor in an external program. The program is completely skinnable (graphical skin-editor included) and can be run on a networked pc or on the main rF-pc. Using sidewindow you can also display the HUD on a PDA (Windows Mobile). Below you see an example of 2 skins.

Installation

Download and install Java6 runtime (if not allready installed) (http://java.sun.com/javase/downloads/index.jsp)
Download and install GTK2.0 (http://downloads.sourceforge.net/gimp-win/gtk%2B-2.10.13-setup.exe)
IMPORTANT !!!! : Navigate using Windows-Explorer to the path where GTK+ 2 was installed. Default this is c:\Program Files\Common Files\GTK\2.0\bin. Rename the file libpng12.dll to libpng.dll.
Download rfskinhud.zip and unzip it somewhere on your system.
Copy Plugins\rfSkinHud.dll to your rFactor\Plugins directory. and place it in your rFactor folder (where rFactor.exe is). I
Create a file DashSettings.ini and place it in your rFactor folder (where rFactor.exe is). In this file you have to enter the IP of the PC on which you are going to run rF-SkinHud. Note that when you run rFSkinHud on the same PC as rFactor 127.0.0.1 won't do. You have to enter the complete IP of the PC.

Usage

Run the program by doubleclicking on rfsh.jar

A GUI pops-up in which you can choose which configuration the program needs to use. Once you have chosen a configuration the configuration window and the main gui shows up

In the configuration window you can change the specified parameters. You can always save your changes by overwriting an existing configuration or creating a new configuration. This way you can create seperate configurations for each type of car for example.

In the main interface you will always see a START or GO button. Press this button. This causes the program to start listening to rFactor.

Run rFactor and start driving...

Extra skins

Visit http://users.pandora.be/riptor/rfsh/skins.

Available fields

When creating/modifying skins you can use the following fields:

Numbers
- rpm
- rpm_5 (0 or 1 ; 1 when the current rpm is equal or higher than 5% of the maximum rpm of the car. These can be used to build a rev-meter using leds)
- rpm_10
- rpm_15
- rpm_20
- rpm_25
- rpm_30
- rpm_35
- rpm_40
- rpm_45
- rpm_50
- rpm_55
- rpm_60
- rpm_65
- rpm_70
- rpm_75
- rpm_80
- rpm_85
- rpm_90
- rpm_95
- rpm_100
- water (watertemp)
- oil (oiltemp)
- overheating (0 or 1 ; 1 when car is overheating)
- hotWater (0 or 1 ; 1 when watertemp is higher then what you specified in the configuration)
- hotOil (0 or 1 ; 1 when oiltemp is higher then what you specified in the configuration)
- fuel (amount of litres left)
- speed_kph
- speed_mph
- lap (current lapnumber)
- throttle (% of throttle pushed)
- brake
- clutch
- steer (% of steering ; -100% is completely left ; +100% is completely right)
- fldetached, frdetached, rldetached, rrdetached (0 or 1 ; 1 when wheel is broken of the car)
- flflat, frflat, rlflat, rrflat (0 or 1 ; 1 when tyre has a puncture)
- flrideheight, frrideheight, rlrideheight, rrrideheight (in mm)
- flbraketemp, frbraketemp, rlbraketemp, rrbraketemp
- fltirepressure, frtirepressure, rltirepressure, rrtirepressure
- fltiretempl, frtiretempl, rltiretempl, rrtiretempl (tiretemp at the left side of the tire)
- fltiretempc, frtiretempc, rltiretempc, rrtiretempc (tiretemp at the center of the tire)
- fltiretempr, frtiretempr, rltiretempr, rrtiretempr (tiretemp at the right side of the tire)
- flwear, frwear, rlwear, rrwear (wear of each tire in % ; 100 is new tire)
- fltiretemppercl, frtiretemppercl, rltiretemppercl, rrtiretemppercl, fltiretemppercc, frtiretemppercc, rltiretemppercc, rrtiretemppercc, fltiretemppercr, frtiretemppercr, rltiretemppercr, rrtiretemppercr (a number between 0 and 9 showing the percent of tiretems ; 0 = 0%, 1 = 10% and so on)
- flwearperc, frwearperc, rlwearperc, rrwearperc (a number between 0 and 9 showing the percent of wear of each tire ; 0 = 0%, 1 = 10% and so on)
- flbottomed, frbottomed, rlbottomed, rrbottomed (0 or 1 ; 1 when rideheight is 0)
- numvehicles
- numvehicles
- totallaps
- bests1minutes
- bests2minutes
- bestlapminutes
- bests1seconds
- bests2seconds
- bestlapseconds
- bests1thousands
- bests2thousands
- bestlapthousands
- currentminutes : currentlaptime. This isn't correct for the first lap as time starts running as soon as race sessions starts
- currentseconds : currentlaptime. This isn't correct for the first lap as time starts running as soon as race sessions starts
- currentthousands : currentlaptime. This isn't correct for the first lap as time starts running as soon as race sessions starts
- lasts1minutes
- lasts2minutes
- lastlapminutes
- lasts1seconds
- lasts2seconds
- lastlapseconds
- lasts1thousands
- lasts2thousands
- lastlapthousands
- gamephase
- yellowsectorflag0 (1 if there is a yellow flag situation in sector 1)
- yellowsectorflag1 (1 if there is a yellow flag situation in sector 2)
- yellowsectorflag2 (1 if there is a yellow flag situation in sector 2)
- redlight1 (the first red lights that go up when the starting sequence commences)
- redlight2 (the second red lights that go up when the starting sequence commences)
- redlight3 (the last red lights that go up when the starting sequence commences)
- greenlight
Sliders
- sliderrpm
- sliderwater (watertemp)
- slideroil (oiltemp)
- sliderfuel (amount of litres left)
- sliderspeedkph
- sliderspeedmph
- sliderthrottle (% of throttle pushed)
- sliderbrake
- sliderclutch
- sliderflbraketemp, sliderfrbraketemp, sliderrlbraketemp, sliderrrbraketemp
- sliderfltirepressure, sliderfrtirepressure, sliderrltirepressure, sliderrrtirepressure
- sliderfltiretempl, sliderfrtiretempl, sliderrltiretempl, sliderrrtiretempl (tiretemp at the left side of the tire)
- sliderfltiretempc, sliderfrtiretempc, sliderrltiretempc, sliderrrtiretempc (tiretemp at the center of the tire)
- sliderfltiretempr, sliderfrtiretempr, sliderrltiretempr, sliderrrtiretempr (tiretemp at the right side of the tire)
- sliderflwear, sliderfrwear, sliderrlwear, sliderrrwear (wear of each tire in % ; 100 is new tire)
Dials
- dialrpm
- dialwater (watertemp)
- dialoil (oiltemp)
- dialfuel (amount of litres left)
- dialspeedkph
- dialspeedmph
- dialthrottle (% of throttle pushed)
- dialbrake
- dialclutch
- dialflbraketemp, dialfrbraketemp, dialrlbraketemp, dialrrbraketemp
- dialfltirepressure, dialfrtirepressure, dialrltirepressure, dialrrtirepressure
- dialfltiretempl, dialfrtiretempl, dialrltiretempl, dialrrtiretempl (tiretemp at the left side of the tire)
- dialfltiretempc, dialfrtiretempc, dialrltiretempc, dialrrtiretempc (tiretemp at the center of the tire)
- dialfltiretempr, dialfrtiretempr, dialrltiretempr, dialrrtiretempr (tiretemp at the right side of the tire)
- dialflwear, dialfrwear, dialrlwear, dialrrwear (wear of each tire in % ; 100 is new tire)

Creating a new skin

Just copy an existing skin and start editing
When your skin is complete please email it to frank.wynants@gmail.com. This way we can add your skin to the package so the whole world can enjoy it.

Edit skins

Skins can be edited using the skin-editor or by 'hand' using a text-editor.

Using the skin-editor
- Launch rFSkinHud
- Push on the red edit-button in the skin. The skineditor pops up.
- Use the right mouse button to select items, drag items, ...
- Save the skin and close rFSkinHud. After restarting the changes are effective.
By hand
- Go to the skins directory in your rFSkinHud directory.
- Open the skindata file with your default texteditor.
- The skins are defined in the SLIK language. Extra information about SLIK can be found here : SKIN-SPECS.

I want MPH instead of KPH (or vice-versa)

I you found a skin you like but it shows MPH instead of KPH or KPH instead of MPH you can easily change this yourself in 5 minutes.

Launch rF-SkinHud
Hit the red button in the skin to start the skin-editor
Right click on the field you wish to change
Change speed_mph to speed_kph or vice-versa
Save the skin (save button is in bottom right corner)
Close and restart rF-SkinHud

Complete skinning tutorial

http://docs.google.com/Doc?id=dg7q6wp8_14tf9mhtct

I want my HUD on my PDA

For this you can use a tool called SideWindow (use google to find it). With this tool you can specify your PDA as a second monitor for your PC. Just drag rF-SkinHud to the PDA.

Contact

If you encounter bugs, or you are want to see some data added (like car damage) you can always send an email to frank.wynants@gmail.com.

Authors

GUI programming: Frank Wynants
JNI SLIK bridge programming: Vladimir Silva
rFSkinHud.dll programming: Marcel Offermans
Default skins: Robin de Grootte