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: Prelight Indicator # imgs Normal Pressed Lit

normal Lit pressed

Hover normal

Hover 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 KNOP

INGEDRUKTE KNOP

GEWONE KNOP BIJ

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…

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.

0° 180°

140px

140px

70px

70px

37° 145°

X – AS

Y –

AS

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:

ACHTERGROND SCHUIVER NORMAAL

SCHUIVER INGEDRUKT

MOUSEOVER 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