KnarfTec

Sinds rFactor in 2005 verscheen zijn er al een aantal, min of meer succesvolle
pogingen gedaan om live telemetrie te implementeren. De ene was al
handiger dan de andere en veel initiatieven zijn om één of andere reden
gestrand na de release van de laatste rFactor-patch. Momenteel is er een
tooltje waarvoor je moet betalen, maar deze is niet te customiseren en, tjah,
niet gratis…

Met de KnarfTec wordt het mogelijk om zelf je eigen realtime telemetrie

instrument in elkaar te knutselen. Het enige wat je in nodig hebt is een
grafisch pakket (Photoshop, Gimp, etc…) en een dosis creativiteit. Je
zelfgemaakte tool gebruik je dan op een extra monitor of een PDA ofwel via
een laptop die aangesloten is op het netwerk.

Enige handigheid in een grafisch pakket is aangewezen. Tijdens het

praktische gedeelte van de tutorial zal ik vaak refereren naar Photoshop om
de eenvoudige reden dat ik het zelf gebruik. Normaalgezien zijn de meest
gebruikte functies in andere programma’s ook aanwezig. Sowieso hoeft het
niet zo moeilijk te zijn om een mooi uitziende skin te maken zolang je rekening
houdt met een aantal zaken.
De theorie

Allereerst is het belangrijk om te weten uit

welke onderdelen een skin bestaat. Eerst en
vooral heb je een achtergrond (zie afbeelding)

nodig en in feite is dit niks meer dan een

afbeelding waarop alle informatie staat die
niet dynamisch is (labels, versieringen, etc.).
Hierop plaats je dan, in de skin-editor, de
zogenaamde widgets. Dit zijn de werkende
(dynamische) onderdelen van je skin. Ze
tonen informatie door middel van de key die
aan hen toegewezen wordt. Voorlopig
misschien nog Chinees, maar ’t wordt wel duidelijk na het volgende stukje
waar we alle, in dit geval beschikbare, widgets overlopen.

1. BUTTONS:

Dit zijn de, min of meer obligatoire, knopjes waarmee je het tooltje
bedient. Ga er van uit dat je er minstens twee nodig hebt. Één met als
functie ‘edit’, om in de skin-editor te komen, en één, met als functie
‘start’, om de gegevensverwerking te starten en je tool effectief naar
rFactor te laten luisteren. Er zijn nog andere mogelijkheden, maar in
principe heb je die niet nodig.

Een button bestaat steeds uit een afbeelding. Het voorbeeld toont de
meest eenvoudige knop die er is:

Onderstaande tabel verklaart de verschillende mogelijkheden die je

met buttons hebt.

Opties: Lit Lit Hover Hover

# imgs Normal Pressed
Prelight Indicator normal pressed normal pressed
Nee Nee 2 X X
Ja Nee 3 X X X
Nee Ja 4 X X X X
Ja Ja 6 X X X X X X
 Voorgaand voorbeeld past dus bij de configuratie op de eerste regel:
Het eerste deel van de afbeelding is de gewone knop, het tweede deel
van de afbeelding is de ingedrukte knop. Experimenteer gerust met de
prelight/indicator-optie. Hou wel rekening met de breedte van je
afbeelding en de juiste afstand tussen de opties.

Voorbeelden:

Knop 1 afbeelding (zoals het voorbeeld):

GEWONE KNOP INGEDRUKTE KNOP

Knop 1 afbeelding:

GEWONE
GEWONE INGEDRUKTE
KNOP BIJ
KNOP KNOP
MOUSEOVER

2. NUMBERS:

Met deze widget toon je cijfergegevens. Het belangrijkste hier is

wederom de afbeelding die je toekent want daarin zijn immers alle

numerieke karakters gedefiniëerd:

De afbeelding is verdeeld in ELF stukken waarin de nummers van 0 tot

en met 9 staan. Het laatste deeltje is leeg. Probeer er zoveel mogelijk
voor te zorgen dat de totale breedte van je afbeelding een veelvoud
van elf is zodat de verdeling tot op de pixel klopt want anders gebeurt
het dat je afbeelding niet correct werkt in de skin.

Voorbeeld:

0 1 2 3 4 5 6 7 8 9

Bij deze widget krijg je nog een aantal opties zoals ‘length’ en ‘pad with
zeroes’. Zet je ‘length’ bijvoorbeeld op 3 dan krijg je een veld met een
lengte van drie karakters. Als je daarop ‘pad with zeroes’ aanvinkt dan
wordt dat veld (van drie karakters breed) uitgevuld met nullen.
Experimenteer gerust, je zult de veranderingen onmiddellijk zien...
3. DIALS:

In PDA01 wordt een dial gebruikt om RPM aan te geven. In feite is een
dial een afbeelding van een naald waaraan bepaalde eigenschappen
worden toegekend. Deze widget kan verwarrend zijn omdat ze nogal
wat parameters bevat die correct moeten zijn als je wil dat je wijzer
goed werkt. Even overlopen in PDA01…

angle_begin: Dit is de hoek waaronder het beginpunt van

de naald ligt. Ga er van uit dat het nulpunt
rechts van het centrum ligt. De naald begint
op 145°.

angle_end: Dit is de hoek waaronder het eindpunt van

de naald ligt. In dit geval 37°.

handle_offset_x: Dit is de afstand op de X-as BINNEN de

afbeelding waar het punt ligt waarop de
naald draait.

handle_offset_y: Dit is de afstand op de Y-as BINNEN de

afbeelding waar het punt ligt waarop de
naald draait.

De handle_offset parameters staan in dit geval allebei op 70. Logisch,

want de afbeelding is een perfect vierkant van 140px op 140px en de
naald begint in het midden van de afbeelding. Het punt waarop de
naald draait ligt dus op 70 pixels van de linkerkant en op 70 pixels van
de onderkant van de afbeelding. Easypeasy…

Op de volgende pagina vind je een schets waardoor een en ander

hopelijk nog duidelijker wordt…
 Y – AS 180° 0°

140px
70px

70px
145° 37°

140px

X – AS

Het mag duidelijk zijn dat een naald-afbeelding van 140 op 140 pixels
verre van ideaal is. Beter is om een mooie dunne naald te maken en
dan de handle_offset zodanig te configureren dat het draaipunt zich op
de juiste plaats bevindt. Het is handig om al in je favoriete
tekenprogramma te checken waar precies het draaipunt moet komen
dan is het slechts een kwestie van de juiste coördinaten in te voeren.

De overige opties spreken min of meer voor zich en, zoals gewoonlijk,
experimenteer gerust zelf. Het voordeel van de dial-widget is het feit
dat je hem met de muis al kan bewegen en zodoende kan testen of hij
wel juist werkt.
 4. SLIDERS

Zoals de andere widgets gebruiken sliders ook afbeeldingen.

Afhankelijk van een horizontale of een verticale slider moeten deze
gelijk georiënteerd zijn. Voor een horizontale slider heb je dus een
horizontaal georiënteerde afbeelding nodig en voor een verticale slider
een verticale afbeelding. Hieronder een schematisch overzicht voor
een horizontale slider:

SCHUIVER SCHUIVER MOUSEOVER

ACHTERGROND
NORMAAL INGEDRUKT SCHUIVER

De twee laatste stukjes in de afbeelding zijn enkel van toepassing als

je de opties ‘pressable’ en ‘prelight’ aanvinkt. Ga er gerust van uit dat je
deze niet zult nodig hebben want in principe zul je deze sliders nooit
manueel verschuiven. Ze zorgen enkel voor output van je rFactor
gegevens en leveren geen input.

< Dit is de afbeelding van de brake-slider uit PDA02. Hij is duidelijk

verticaal georiënteerd. De afbeelding is 15px hoog en 11px breed.
‘Vertical’ is aangevinkt en ‘Length’ staat op 10, d.w.z. dat het gedeelte
achtergrond in de afbeelding 10 pixels lang is. Het onderste gedeelte
van de afbeelding (alles onder de 10e pixel van vanboven m.a.w. de
overige 5 pixels) is de slider zelf. Doordat er geen ‘pressable’ of
‘prelight’ aangevinkt zijn is het niet nodig om daarvoor nog extra ruimte
te voorzien. De optie ‘through_length’ duidt op de totale sliderlengte in
je skin en staat op 114px.

Misschien is het nog steeds allemaal Chinees, maar geen nood, in het
volgende hoofdstuk overlopen we alles nog eens praktisch in een echte
voorbeeldskin.
De Praktijk

Waar ik altijd mee begin is het kopiëren van een bestaande skin naar een
nieuwe map die ik dan een andere naam geef. In volgend voorbeeld beginnen
we met de map Tutorial.

1. Start het programma

2. Selecteer ‘skins/Tutorial’

3. Save settings en Quit

4. Herstart het programma

Als je van skin verandert moet je het programmaatje dus eerst afsluiten en
opnieuw opstarten. Wanneer je dat hebt gedaan krijg je dus de Tutorial-skin te
zien. Het mag duidelijk zijn dat ze leeg is op de twee grote knoppen na. Zoals
reeds vermeldt zijn dit de twee noodzakelijke knoppen voor elke skin. Net
daarom begin ik altijd met een kopie van een bestaande skin, omdat deze
twee knoppen dan meestal al aanwezig zijn. De belangrijkste is in feite de
‘edit’-button want deze geeft ons toegang tot de skin-editor. Bij afwezigheid
van deze knop is het dus onmogelijk om de skin te bewerken. In extremis kan
je hem manueel invoegen via het skindata bestand.

Als je op ‘Edit’ klikt opent zich de skin-editor waarin je de achtergrond al ziet

staan. In het lijstje onderaan het venster zie je ook de twee knopjes. ‘key’
bepaalt de functie en ‘type’ staat voor, wel, het type widget…
In het rechtergedeelte is ongeveer alles grijs behalve ‘default size’. Ga er van
uit dat je skin altijd vaste afmetingen zal hebben. Je kan de tool niet efficiënt
resizen. ‘Default-size’ stel je dus over het algemeen in op de afmetingen van
je ‘background’. Deze skin is op maat van een doorsnee PDA.

Laten we er even een mooie gear-indicator van maken…

1. klik op ‘add…’

2. Je krijgt een scherm te zien met daarop onderstaande tabbladen.

Dit zijn ALLE verschillende widgets. Enkel de reeds voorgenoemde
kunnen gekoppeld worden aan een key.

3. Kik op het tabblad “number”

Bij ‘key’ kan je dus de ingang selecteren. Dit bepaalt welke gegevens getoond
worden door de widget die je momenteel aan het invoegen bent, een gear-
indicator dus…
1. Klik op het pijltje bij ‘Key’.

2. Selecteer ‘gear’ uit de lijst.

3. Bij ‘image’ typ je het pad naar de afbeelding die je voor je numerieke
gegevens wil gebruiken. In dit geval: skins/Tutorial/geardigits.png
Als alles goed is krijg je de afbeelding te zien in het vak eronder.

4. klik op ‘add’, onder de het afbeeldingvak.

5. Sluit het ‘Add widget’-venster.

Als alles goed is ben je nu terug in de skin editor en zie je de widget die je net
hebt ingevoegd. In de lijst onderaan staat hij nu ook. Gefeliciteerd, je hebt
zonet een gear-indicator gebouwd.
VERGEET NIET OM RECHTS ONDERAAN OP SAVE TE KLIKKEN!

1. Sluit de Skineditor

2. Start rFactor

3. Start een sessie

4. Alt-Tab naar de tool

5. druk op de startknop

6. Alt-Tab naar rFactor

7. Rij een rondje en kijk vol bewondering hoe je “gears” “geïndiceerd”

worden op het tooltje.

8. Ga naar de koelkast en trakteer jezelf op een pintje…

REFERENCE

Numbers: 0 tot 9
Rpm ...................................................... toeren per minuut
Water .................................................... watertemperatuur
Oil.......................................................... olietemperatuur
Fuel....................................................... resterende brandstof
Speed_kph ........................................... snelheid in kmh
Speed_mph .......................................... snelheid in mph
Lap ........................................................ # van huidige ronde
Throttle.................................................. % gas
Brake .................................................... % rem
Clutch.................................................... % koppeling
Steer ..................................................... % sturen (-100=links; 100=rechts)
Pos........................................................ positie
Numvehicles ......................................... aantal voertuigen
Totallaps ............................................... totaal aantal rondes

Flrideheight........................................... Front-Left rijhoogte in mm

Frrideheight .......................................... Front-Right
Rlrideheight .......................................... Rear-Left
Rrrideheight .......................................... Rear-Right

Flbraketemp.......................................... Front-Left remtemperatuur

Frbraketemp ......................................... Front-Right
Rlbraketemp ......................................... Rear-Left
Rrbraketemp......................................... Rear-Right

Fltirepressure........................................ Front-Left bandendruk

Frtirepressure ....................................... Front-Right
Rltirepressure ....................................... Rear-Left
Rrtirepressure....................................... Rear-Right

Fltiretempl ............................................. Front-Left temp. aan linkerkant van de band

Frtiretempl ............................................ Front-Right
Rltiretempl ............................................ Rear-Left
Rrtiretempl ............................................ Rear-Right

Fltiretempc ............................................ Front-Left temp. in het midden van de band

Frtiretempc ........................................... Front-Right
Rltiretempc ........................................... Rear-Left
Rrtiretempc ........................................... Rear-Right

Fltiretempr ............................................ Front-Left temp. aan rechterkant van de band

Frtiretempr ............................................ Front-Right
Rltiretempr ............................................ Rear-Left
Rrtiretempr............................................ Rear-Right

Flwear ................................................... Front-Left Bandenkwaliteit 100% = Geen slijtage

Frwear................................................... Front-Right
Rlwear................................................... Rear-Left
Rrwear .................................................. Rear-Right
bests1minutes ...................................... Aantal minuten beste tijd SECTOR 1
bests1seconds...................................... Aantal seconden beste tijd SECTOR 1
bests1thousands .................................. Aantal duizenden beste tijd SECTOR 1

bests2minutes ...................................... Aantal minuten beste tijd SECTOR 2

bests2seconds...................................... Aantal seconden beste tijd SECTOR 2
bests2thousands .................................. Aantal duizenden beste tijd SECTOR 2

bestlapminutes ..................................... Aantal duizenden beste rondetijd

bestlapseconds..................................... Aantal duizenden beste rondetijd
bestlapthousands ................................. Aantal duizenden beste rondetijd

lasts1minutes........................................ Aantal minuten laatste tijd SECTOR 1

lasts1seconds....................................... Aantal seconden laatse tijd SECTOR 1
lasts1thousands.................................... Aantal duizenden laatse tijd SECTOR 1

lasts2minutes........................................ Aantal minuten laatse tijd SECTOR 2

lasts2seconds....................................... Aantal seconden laatste tijd SECTOR 2
lasts2thousands.................................... Aantal duizenden laatste tijd SECTOR 2

lastlapminutes....................................... Aantal duizenden laatste rondetijd

lastlapseconds...................................... Aantal duizenden laatste rondetijd
lastlapthousands................................... Aantal duizenden laatste rondetijd

Numbers: 1 of 0
Rpm_5 .................................................. Toerental is hoger of gelijk aan 5% (0 of 1)
Rpm_10 ................................................ Toerental is hoger of gelijk aan 10% (0 of 1)
Rpm_15 ................................................ Toerental is hoger of gelijk aan 15% (0 of 1)
Rpm_20 ................................................ Toerental is hoger of gelijk aan 20% (0 of 1)
Rpm_25 ................................................ Toerental is hoger of gelijk aan 25% (0 of 1)
Rpm_30 ................................................ Toerental is hoger of gelijk aan 30% (0 of 1)
Etc…

Overheating .......................................... Wagen oververhit (0 of 1)

Hotwater ............................................... Maximum watertemperatuur overschreden (0 of 1)
Hotoil..................................................... Maximum olietemperatuur overschreden (0 of 1)

Fldetached ............................................ Front-Left Wiel afgebroken (0 of 1)

Frdetached ........................................... Front-Right
Rldetached ........................................... Rear-Left
Rrdetached ........................................... Rear-Right

Flflat ...................................................... Front-Left Lekke band (0 of 1)

Frflat...................................................... Front-Right
Rlflat...................................................... Rear-Left
Rrflat ..................................................... Rear-Right

Flbottomed............................................ Front-Left Rijhoogte=0 (0 of 1)

Frbottomed ........................................... Front-Right
Rlbottomed ........................................... Rear-Left
Rrbottomed........................................... Rear-Right
Sliders
Sliderrpm .............................................. toeren per minuut
Sliderwater............................................ watertemperatuur
Slideroil ................................................. olietemperatuur
Sliderfuel............................................... resterende brandstof
Sliderspeedkph..................................... snelheid in kmh
Sliderspeedmph.................................... snelheid in mph
Sliderthrottle ......................................... % gas
Sliderbrake ........................................... % rem
Sliderclutch ........................................... % koppeling

Sliderflrideheight................................... Front-Left rijhoogte in mm

Sliderfrrideheight .................................. Front-Right
Sliderrlrideheight................................... Rear-Left
Sliderrrrideheight .................................. Rear-Right

Sliderflbraketemp.................................. Front-Left remtemperatuur

Sliderfrbraketemp ................................. Front-Right
Sliderrlbraketemp ................................. Rear-Left
Sliderrrbraketemp ................................. Rear-Right

Sliderfltirepressure ............................... Front-Left bandendruk

Sliderfrtirepressure ............................... Front-Right
Sliderrltirepressure ............................... Rear-Left
Sliderrrtirepressure............................... Rear-Right

Sliderfltiretempl..................................... Front-Left temp. aan linkerkant van de band

Sliderfrtiretempl .................................... Front-Right
Sliderrltiretempl..................................... Rear-Left
Sliderrrtiretempl .................................... Rear-Right

Sliderfltiretempc.................................... Front-Left temp. in het midden van de band

Sliderfrtiretempc ................................... Front-Right
Sliderrltiretempc.................................... Rear-Left
Sliderrrtiretempc ................................... Rear-Right

Sliderfltiretempr .................................... Front-Left temp. aan rechterkant van de band

Sliderfrtiretempr .................................... Front-Right
Sliderrltiretempr .................................... Rear-Left
Sliderrrtiretempr.................................... Rear-Right

Sliderflwear........................................... Front-Left Bandenkwaliteit 100% = Geen slijtage

Sliderfrwear .......................................... Front-Right
Sliderrlwear........................................... Rear-Left
Sliderrrwear .......................................... Rear-Right
Dials
Dialrpm ................................................. toeren per minuut
Dialwater............................................... watertemperatuur
Dialoil .................................................... olietemperatuur
Dialfuel.................................................. resterende brandstof
Dialspeedkph........................................ snelheid in kmh
Dialspeedmph....................................... snelheid in mph
Dialthrottle ............................................ % gas
Dialbrake............................................... % rem
Dialclutch .............................................. % koppeling

Dialflrideheight...................................... Front-Left rijhoogte in mm

Dialfrrideheight ..................................... Front-Right
Dialrlrideheight...................................... Rear-Left
Dialrrrideheight ..................................... Rear-Right

Dialflbraketemp..................................... Front-Left remtemperatuur

Dialfrbraketemp .................................... Front-Right
Dialrlbraketemp .................................... Rear-Left
Dialrrbraketemp .................................... Rear-Right

Dialfltirepressure................................... Front-Left bandendruk

Dialfrtirepressure .................................. Front-Right
Dialrltirepressure .................................. Rear-Left
Dialrrtirepressure .................................. Rear-Right

Dialfltiretempl........................................ Front-Left temp. aan linkerkant van de band

Dialfrtiretempl ....................................... Front-Right
Dialrltiretempl........................................ Rear-Left
Dialrrtiretempl ....................................... Rear-Right

Dialfltiretempc....................................... Front-Left temp. in het midden van de band

Dialfrtiretempc ...................................... Front-Right
Dialrltiretempc....................................... Rear-Left
Dialrrtiretempc ...................................... Rear-Right

Dialfltiretempr ....................................... Front-Left temp. aan rechterkant van de band

Dialfrtiretempr ....................................... Front-Right
Dialrltiretempr ....................................... Rear-Left
Dialrrtiretempr....................................... Rear-Right

Dialflwear .............................................. Front-Left Bandenkwaliteit 100% = Geen slijtage

Dialfrwear.............................................. Front-Right
Dialrlwear.............................................. Rear-Left
Dialrrwear ............................................. Rear-Right