Tekst źródłowy strony Plik multimediów (mmd)

== Funkcje czytające ==
Sekcje <tt>models</tt> i <tt>sounds</tt> oraz definicje kabin są czytane w <tt>TDynamicObject::LoadMMediaFile(AnsiString BaseDir, AnsiString TypeName,AnsiString ReplacableSkin)</tt><br/>
Sekcja <tt>internaldata</tt> oprócz definicji kabin czytana jest w <tt>TTrain::LoadMMediaFile(AnsiString asFileName)</tt><br/>
Definicja kabin czytana jst w <tt>TTrain::InitializeCab(int NewCabNo, AnsiString asFileName)</tt>

== Sekcja models: ==
Kończy się słowem endmodels
{| class="wikitable"
!Własność	!!Parametry po typie	!!Opis	!!Uwagi
|-
|models	||string	||Nazwa pliku modelu *.t3d	||Jeśli na końcu nazwy znajduje się # to ma więcej wymiennych tekstur definiowanych we wpisie w scenerii
|-
|animations  ||  || ||Spis kończy się wartością -1 po ostatniej definicji liczby animacji. Wartości w kolejności wpisanej do tabelki
|-	
| ||int	||Liczba osi	
|-
| ||int	||Liczba drzwi	
|-
| ||int	||Liczba wahaczy (rot)	
|-
| ||int	||Liczba zderzaków (mov)
|-
| ||int	||Liczba wózków	
|-
| ||int	||Liczba pantografów	
|-
| ||int	||Liczba wiązarów	
|-
| ||int	||Liczba ruchomych schodków do drzwi	
|-
| ||int	||Liczba ruchomych lusterek	
|-
|lowpolyinterior:	||string	||Nazwa pliku modelu uproszczonej kabiny	
|-
|brakemode:	||string	||Gałka nastawy hamulca	
|-
|loadmode: 	||string	||Gałka nastawy ładowny / próżny
|-	
|animwheelprefix:	||string	||Prefix dla wszystkich kręcących się kół	||Do nazwy będą dodawane kolejne cyfry w liczbie podanej w animations
|-
|animpantprefix:	||string	||'''Porzucone'''
|-
|Animpantrd1prefix:	||string	||Nazwa ramienia dolnego pantografów 1	||Do nazwy będą dodawane kolejne cyfry w liczbie podanej w animations
|-
|Animpantrd2prefix:	||string	||Nazwa ramienia dolnego pantografów 2	||Do nazwy będą dodawane kolejne cyfry w liczbie podanej w animations
|-
|Animpantrg1prefix:	||string	||Nazwa ramienia górnego pantografów 1	||Do nazwy będą dodawane kolejne cyfry w liczbie podanej w animations
|-
|Animpantrg2prefix:	||string	||Nazwa ramienia górnego pantografów 2	||Do nazwy będą dodawane kolejne cyfry w liczbie podanej w animations
|-
|animpantslprefix:	||string	||Nazwa ślizgaczy	||Do nazwy będą dodawane kolejne cyfry w liczbie podanej w animations
|-
|pantfactors	||Float	||Pozycja w osi x pantografów 1	
|-
|	||Float	||Pozycja w osi x pantografów 2	
|-
|	||Float	||Wysokość ślizgacza pantografów 1
|-	
|	||float	||Wysokość ślizgacza pantografów 2	
|-
|animpistonprefix:	||string	||Nazwa tłoków w cylindrach	||'''Nie używane'''
|-
|animconrodprefix: 	||string	||Nazwa korbowodów	||'''Nie używane'''
|-
|pistonfactors: 		||Parametry napędu	||'''Nie używane'''
|-
|animreturnprefix:	 ||string	||Nazwa drążka mimośrodowego	||'''Nie używane'''
|-
|animexplinkprefix:	 |String	||Nazwa jarzma	||'''Nie używane'''
|-
|animpendulumprefix: 	||string	||Nazwa wahaczy	
|-
|pendulumamplitude:	 ||float	||Amplituda drgań	||Wymagane jeśli <tt>animpendulumprefix</tt>
|-
|engineer:	||string	||Nazwa modelu mechanika ||'''Porzucone'''
|-	
|animdoorprefix:	||string	||Nazwa drzwi	
|-
|animstepprefix:	||string	||Nazwa modelu ruchomych schodków do drzwi ||-
|-
|animmirrorprefix:	||string	||Nazwa modelu ruchomych lusterek ||-
|}
Jeśli wykryje typ <tt>dt_EZT</tt> to automatycznie ładowany jest model z pliku <tt>przedsionki.t3d</tt>. Trzeba to zmienić na wpis żeby mógł sobie wybrać ten model sam, albo najlepiej usunąć i definiować w samym modelu.

== Sekcja sounds: ==

Kończy się słowem <tt>endsounds</tt>. 

Istnieje możliwość zdefiniowania grupy kilku plików dźwiękowych dla danego string'a, zamiast dotychczasowego jednego, poprzez użycie formatu: 

 [ pierwszawersja.wav drugawersja.wav trzeciawersja.wav ]

Symulator wtedy wybiera na chybił trafił jeden z wpisanych plików.


=== Nowy sposób ===

Nowy sposób wpisywania dźwięków, dostępny od wersji 171207 wzwyż, posiada składnie:

 identyfikator: { atrybut: wartość atrybut: wartość atrybut: wartość itp }

Lista dostępnych identyfikatorów na końcu. Dostępne atrybuty to:

====Lista atrybutów====

:'''soundset:''' (zestaw dźwięków, atrybut ten docelowo zastępuje soundbegin, soundmain oraz soundend, w sytuacjach kiedy chcemy wylosować cały zestaw dźwięków, np kilka różnych sygnałów dźwiękowych. Można użyć spacji, lub | do separacji wartości, oraz używamy [] do wstawienia kilku plików, oraz używamy 'wartości_grupa1' do separacji grup, wewnątrz [], czyli przykład: ''(wpis dostępny od wersji 171208 wzwyż)''

 soundset: ['rp1_start.wav|rp1_main.wav|rp1_end.wav', 'husarz_niski_start.wav|husarz_niski_main.wav|husarz_niski_end.wav']

:'''soundbegin:''' (dźwięk początkowy. wartość to nazwa pliku dźwiękowego, lub zbiór plików zamknięty w nawiasach [ ] dla dźwięku wybieranego losowo)
:'''soundmain:''' (dźwięk główny. wartość j.w.)
:'''soundend:''' (dźwięk końcowy. wartość j.w)

:'''placement:''' (pomieszczenie, w którym znajduje się dźwięk. parametr ten decyduje kiedy siła dźwięku jest tłumiona. dopuszczalne wartości to:
:: ''internal'' (dźwięk umieszczony jest w kabinie pojazdu)
:: ''engine'' (dźwięk umieszczony jest w przedziale silnikowym)
:: ''external'' (dźwięk umieszczony jest 'na zewnątrz', np. syrena lub przetwornica w EN57)
:: ''general'' (dźwięk słyszalny jest tak samo w kabinie i na zewnątrz, zazwyczaj są to drzwi itp)

:'''offset:''' ( położenie dźwięku względem punktu centralnego pojazdu lub scenerii. wartość to lokacja 3d podana w postaci [ X, Y, Z ] Dla pojazdów +X położona jest po ich lewej stronie, +Y wskazuje gore, a +Z przód pojazdu)
:'''range:''' (nominalny zasięg dźwięku, w metrach - wartość -1 wyłącza pozycjonowanie przestrzenne, przez co dźwięk brzmi tak samo w każdym punkcie, w każdym kanale jednakowo)
:'''frequencyfactor:''' (mnożnik częstotliwości, wartość to liczba zmiennoprzecinkowa)
:'''frequencyoffset:''' (dodawana do częstotliwości, wartość j.w.)
:'''amplitudefactor:''' (mnożnik amplitudy, wartość j.w.)
:'''amplitudeoffset:''' (dodawana do częstotliwości, wartość j.w.)
:'''soundX:''' dźwięk.wav - Dźwięk do odtwarzania po przekroczeniu X procent wartości, lub po przekroczeniu wartości X, np rpm silnika
:'''pitchX:''' wartość_liczbowa - Względna częstotliwość dźwięku na wartości X, lub na procencie X
:'''crossfade:''' wartość_między_1_a_100 //100- miksowanie od samego początku, 50- po przekroczeniu 50% różnicy

Wpis który będzie odgrywany gdy wartość zmiennej powiązanej z dźwiękiem przekroczy X% wartości maksymalnej dla tej zmiennej. (zarówno frequencymoddifier i frequencyoffset dalej modyfikują dźwięk) Tzn: 
 outernoise: { sound10: ep09_outernoise_16kmh.wav sound50: ep09_outernoise_80kmh.wav sound100: ep09_outernoise_160kmh.wav }

'''!!!''' Jeśli są zdefiniowane zarówno dźwięki składane, jak i ''soundmain'', to używany jest tylko soundmain
: '''ALE''' można łączyć ''soundbegin'' i ''soundend'' z dźwiękami składanymi

==== Lista Identyfikatorów ====

:'''engine:''' - Silnik spalinowy
:'''tractionmotor:''' - Silniki trakcyjne
:'''converter:''' - Przetwornica
:'''wheel_clatter:''' - Stukot kół
:'''wheelflat:''' - Podkucie koła
:'''ventilator:''' - Wentylatory
:'''inverter:''' - Falownik
:'''transmission:''' - Przekładnia
:'''brake:''' - Pisk podczas hamowania
:'''brakeacc:''' - Wdrażanie hamowania na zaworze rozrządczym
:'''unbrake:''' - Luzowanie hamulców
:'''derail:''' - Wykolejenie
:'''dieselinc:''' - Wchodzenie na obroty silnika spalinowego
:'''curve:''' - Pisk kół na łukach
:'''horn1:''' - Syrena niskotonowa
:'''horn2:''' - Syrena wysokotonowa
:'''horn3:''' - Obie syreny, lub gwizdek
:'''departuresignal:''' - Buczek zamykania drzwi
:'''pantographup:''' - Podnoszenie pantografu
:'''pantographdown:''' - Opuszczanie pantografu
:'''compressor:''' - Sprężarki
:'''turbo:''' - Turbo
:'''small-compressor:''' - Sprężarka pomocnicza
:'''dooropen:''' - Otwieranie drzwi
:'''doorclose:''' - Zamykanie drzwi
:'''sand:''' - Piaskowanie
:'''releaser:''' - Odluźniacz
:'''outernoise:''' - Hałas podczas jazdy z zewnątrz
:'''unloading:''' - Dźwięk odtwarzany podczas rozładunku
:'''loading:''' - Dźwięk odtwarzany podczas ładowania
:'''doorstepopen:''' - Rozkładanie stopnia drzwi
:'''doorstepclose:''' - Składanie stopnia drzwi
:'''brakecylinderinc:''' - Dźwięk towarzyszący zwiększeniu ciśnienia w cylindrze hamulcowym
:'''brakecylinderdec:''' - Dźwięk towarzyszący zmniejszeniu ciśnienia w cylindrze hamulcowym

=== Stary sposób ===

Składnia wpisu poniżej:

 Własność: wartość_1 wartość_2 [ wartość_3a wartość_3b ] itd...

Wartości nr 1, 2 itd z wpisu powyżej, są wartośćiami branymi z tabelki poniżej:

{| class="wikitable"
!Własność	!!Parametry po typie	!!Opis	!!Uwagi
|-
|wheel_clatter	||float	||Tłumienie dźwięku
|-	
|	||float	||Pozycja osi w stosunku do środka pojazdu	||Pozycje powtarzające się tyle razy ile jest osi, na końcu słowo <tt>end</tt>
|-
|	||string	||Nazwa dźwięku	
|-
|engine	||string	||Nazwa dźwięku silnika	
|-
|	||float	||Tłumienie dźwięku	
|-
|	||float	||Mnożnik amplitudy	||normalizacja: am/(pwr,nmax)
|-
|	||float	||Offset amplitudy
|-	
|	||float	||Mnożnik częstotliwości
|-
|	||float	||Offset częstotliwości	
|-
|tractionmotor:	||string	||Nazwa dźwięku silników trakcyjnych	
|-
|	||float	||Tłumienie dźwięku	
|-
|	||float	||Mnożnik amplitudy	||normalizacja: am/(pwr,nmax)
|-
|	||float	||Offset amplitudy
|-	
|	||float	||Mnożnik częstotliwości
|-
|	||float	||Offset częstotliwości	
|-
|ventilator	||string	||Nazwa dźwięku wentylatorów	
|-
|	||float	||Tłumienie dźwięku	
|-
|	||float	||Mnożnik amplitudy	||normalizacja: am/rVentnmax
|-
|	||float	||Offset amplitudy
|-	
|	||float	||Mnożnik częstotliwości	||normalizacja: fm/rVentnmax
|-
|	||float	||Offset częstotliwości	
|-
|inverter	||string	||Nazwa dźwięku falownika	
|-
|	||float	||Tłumienie dźwięku	
|-
|	||float	||Mnożnik amplitudy	||normalizacja: am/rVentnmax
|-
|	||float	||Offset amplitudy
|-	
|	||float	||Mnożnik częstotliwości	||normalizacja: fm/rVentnmax
|-
|	||float	||Offset częstotliwości	
|-
|transmission	||string	||Nazwa dźwięku przekładni	
|-
|	||float	||Tłumienie dźwięku
|-	
|brake	||string	||Nazwa dźwięku pisku hamulca	
|-
|	||float	||Tłumienie dźwięku	
|-
|	||float	||Mnożnik amplitudy	
|-
|	||float	||Offset amplitudy
|-	
|brakeacc	||string	||plik z przyspieszaczem (upust po zlapaniu hamowania)
|-	
|unbrake	||string	||Plik z końcem hamowania
|-	
|	||float	||Tłumienie dźwięku	
|-
|derail	||string	||Plik z dźwiękiem wykolejenia	
|-
|	||float	||Tłumienie dźwięku	
|-
|dieselinc	||string	||Plik z dźwiękiem wchodzenia na obroty	
|-
|	||float	||Tłumienie dźwięku	
|-	
|curve	||string	||Plik z dźwiękiem pisków na łukach	
|-
|	||float	||Tłumienie dźwięku	
|-	
|horn1	||string	||Dźwięk rozpoczęcia	||Syrena niska
|-
|	||String	||Dźwięk trwania
|-	
|	||String	||Dźwięk zakończenia	
|-
|	||float	||Odległość tłumienia	
|-	
|horn2	||string	||Dźwięk rozpoczęcia	||Syrena wysoka
|-
|	||String	||Dźwięk trwania
|-	
|	||String	||Dźwięk zakończenia	
|-
|	||float	||Odległość tłumienia	
|-		
|horn3	||string	||Dźwięk rozpoczęcia	||Gwizdek lub obie syreny
|-
|	||String	||Dźwięk trwania
|-	
|	||String	||Dźwięk zakończenia	
|-
|	||float	||Odległość tłumienia	
|-		

|departuresignal	||string	||Dźwięk rozpoczęcia	||Sygnał odjazdu / zamykania drzwi
|-
|	||String	||Dźwięk trwania
|-	
|	||String	||Dźwięk zakończenia	
|-
|	||float	||Odległość tłumienia	
|-		
|pantographup	||String	||Nazwa dźwięku	||Podnoszenie pantografu
|-
|pantographdown	||string	||Nazwa pliku	||Opuszczanie pantografu
|-
|compressor	||string	||Dźwięk rozpoczęcia	||Sprężarka
|-
|	||String	||Dźwięk trwania
|-	
|	||String	||Dźwięk zakończenia	
|-
|	||float	||Odległość tłumienia	
|-	
|converter	||string	||Dźwięk rozpoczęcia	||Przetwornica
|-
|	||String	||Dźwięk trwania
|-	
|	||String	||Dźwięk zakończenia	
|-
|	||float	||Odległość tłumienia	
|-		
|turbo	||string	||Dźwięk rozpoczęcia	||Praca turbo
|-
|	||String	||Dźwięk trwania
|-	
|	||String	||Dźwięk zakończenia	
|-
|	||float	||Odległość tłumienia	
|-		
|small-compressor	||string	||Dźwięk rozpoczęcia	||Sprężarka pomocnicza
|-
|	||String	||Dźwięk trwania
|-	
|	||String	||Dźwięk zakończenia	
|-
|	||float	||Odległość tłumienia	
|-		
|dooropen	||string	||Nazwa dźwięku	||Otwieranie drzwi
|-
|doorclose	||string	||Nazwa dźwięku	||Zamykanie drzwi
|-
|sand	||string	||Dźwięk rozpoczęcia	||Piasecznica
|-
|	||String	||Dźwięk trwania
|-	
|	||String	||Dźwięk zakończenia	
|-
|	||float	||Odległość tłumienia	
|-		
|releaser	||string	||Dźwięk rozpoczęcia	||Odluźniacz
|-
|	||String	||Dźwięk trwania
|-	
|	||String	||Dźwięk zakończenia	
|-
|	||float	||Odległość tłumienia
|-
|outernoise	||String	||Nazwa pliku	||Hałas podczas jazdy z zewnątrz
|-
|	||Float	||Mnożnik amplitudy	||Normalizacja: AM/Vmax
|-
|	||Float	||Offset amplitudy	
|-
|	||float	||Mnożnik częstotliwości	||Normalizacja: FM/Vmax
|-
|	||float	||Offset częstotliwości	
|}

== Sekcja locations: ==

x to dystans od środka pojazdu, w metrach, - kierunek do przodu, + kierunek do tyłu

:'''doors x y x y end''' Pozycja i kierunek drzwi
::y (left, right, both) to strona drzwi 
:'''tractionmotors -x x end''' Silniki trakcyjne, ''zaleca się stosować jedno źródło na wózek, zamiast wpisywać każdy silnik osobno.''
:'''bogies -x x end''' Wózki, jeden x m do przodu, drugi x m do tyłu

:'''endlocations''' Wpis zamykający tą sekcje.

== Sekcja internaldata: ==
Musi '''koniecznie być na końcu pliku''', gdyż nie ma słowa zakończenia
{| class="wikitable"
!Własność	!!Parametry po typie	!!Opis	!!Uwagi
|-
|brakesound	||String	||Nazwa pliku	||Dźwięk Odgłos hamulca
|-
|	||Float	||Mnożnik amplitudy	||Normalizacja: am/mbf
|-
|	||Float	||Offset amplitudy	
|-
|	||float	||Mnożnik częstotliwości	||Normalizacja: fm/Vmax
|-
|	||float	||Offset częstotliwości	
|-
|slipperysound	||String	||Nazwa pliku	||Dźwięk Poślizg
|-
|	||Float	||Mnożnik amplitudy	||Normalizacja: am/Vmax
|-
|	||Float	||Offset amplitudy	
|-	
|airsound	||String	||Nazwa pliku	||Dźwięk Syk kranu
|-
|	||Float	||Mnożnik amplitudy	
|-
|	||Float	||Offset amplitudy	
|-	
|Airsound2	||String	||Nazwa pliku	||Dźwięk Syk kranu
|-
|	||Float	||Mnożnik amplitudy	
|-
|	||Float	||Offset amplitudy	
|-	
|Airsound3	||String	||Nazwa pliku	||Dźwięk Syk kranu
|-
|	||Float	||Mnożnik amplitudy	
|-
|	||Float	||Offset amplitudy	
|-	
|Airsound4	||String	||Nazwa pliku	||Dźwięk Syk kranu
|-
|	||Float	||Mnożnik amplitudy	
|-
|	||Float	||Offset amplitudy	
|-	
|Airsound5	||String	||Nazwa pliku	||Dźwięk Syk kranu
|-
|	||Float	||Mnożnik amplitudy	
|-
|	||Float	||Offset amplitudy	
|-	
|fadesound	||string	||Nazwa pliku	||Dźwięk tła
|-
|localbrakesound	||String	||Nazwa pliku	||Dźwięk luzowania kranu pomocniczego
|-
|	||Float	||Mnożnik amplitudy	
|-
|	||Float	||Offset amplitudy	
|-	
|localbrakesound2	||String	||Nazwa pliku	||Dźwięk zaciągania kranu pomocniczego
|-
|	||Float	||Mnożnik amplitudy	
|-
|	||Float	||Offset amplitudy	
|-	
|runningnoise	||String	||Nazwa pliku	||Dźwięk Stukot podczas jazdy
|-
|	||Float	||Mnożnik amplitudy	||Normalizacja: AM/Vmax
|-
|	||Float	||Offset amplitudy	
|-
|	||float	||Mnożnik częstotliwości	||Normalizacja: FM/Vmax
|-
|	||float	||Offset częstotliwości	
|-
|engageslippery	||String	||Nazwa pliku	||Dźwięk Tarcie sprzęgła 
|-
|	||Float	||Mnożnik amplitudy	||Normalizacja: fm/nmax
|-
|	||Float	||Offset amplitudy	
|-
|	||float	||Mnożnik częstotliwości	
|-
|	||float	||Offset częstotliwości	
|}
Jeśli wykryje wpis <tt>relay</tt> to ładuje bez pytania pliki <tt>wejscie_na_bezoporow.wav</tt> i <tt>wejscie_na_drugi_uklad.wav</tt> możliwe do nadpisania.<br/>
Dźwięki <tt>couplerattach.wav</tt>, <tt>en57_couplerstretch.wav</tt>, <tt>couplerdetach.wav</tt>, <tt>en57_bufferclamp.wav</tt> są ładowane jako domyślne przy braku deklaracji.

[**] Oznacza że można zdefiniować osobne dźwięki dla poszczególnych pozycji, tzn, można użyć "nowego sposobu", powyżej.

:'''ctrl:''' Dźwięk nastawnika

:'''ctrlscnd:''' Dźwięk bocznika

:'''reverserkey:''' Dźwięk nawrotnika

:'''buzzer:''' Dźwięk buczka CA/SHP

:'''slipalarm:''' Dźwięk wykrycia poślizgu

:'''tachoclock:''' Dźwięk tykania Haslera

:'''switch:''' Dźwięk przełącznika

:'''pneumaticswitch:''' Dźwięk przełącznika elektropneumatycznego

:'''wejscie_na_bezoporow:''' Dźwięk wejścia na pozycję bezoporową

:'''wejscie_na_drugi_uklad:''' Dźwięk wejścia na drugi układ

:'''relay:''' Dźwięk stycznika [**]

:'''shuntfield:''' Dźwięk załącznia stycznika [**]

:'''pneumaticrelay:''' Dźwięk stycznika pneumatycznego

:'''couplerattach:''' Dźwięk podłączenia sprzęgu

:'''couplerdetach:''' Dźwięk rozłączenia sprzęgu

:'''ignition:''' Dźwięk zapłonu, w pojazdach z silnikiem spalinowym

:'''radiostop:''' Dźwięk radiostopu 

:'''pantographup:''' Dźwięk podnoszenia pantografu

:'''pantographdown:''' Dźwięk opuszczania pantografu

:'''oilpump:''' Dźwięk pompy paliwowej

:'''doorclose:''' Dźwięk zamykania drzwi

:'''dooropen:''' Dźwięk otwierania drzwi

:'''couplerstretch:''' Dźwięk naciągania sprzęgu

:'''bufferclamp:''' Dźwięk odbijania się buforów

:'''mechspring:''' Bujanie kamerą w kabinie (Wszystkie poniższe wartości są jako float
::Spring constant - Sprężystość
::Spring damping - Tłumienie
::Spring x - Bujanie na boki
::Spring y - Bujanie góra/dół
::Spring z - Bujanie przód/tył
::Max spring	
::Roll - Przechył na boki
::Pitch	- Przechył przód/tył

:'''enginespring:''' [2.0 1.5 0.3 10.0 0.5] Parametry rzucania kamerą w pojazdach spalinowych, spowodowanych wibracją silnika spal.
::Modyfikator siły rzucania
::Początek efektu rzucania pojazdem, w obr/min
::Prędkość narastania siły rzucania
::Początek zaniku rzucania, w obr/min
::Prędkość wygasania efektu

:'''huntingspring:''' Parametry wężykowania (na razie tylko rzuca kamerą)
::Mnożnik siły - mnożnik domyślnej siły z jaka rzucana jest kamera (nie należny tutaj specjalnie przesadzać, wartości na poziomie 5-6 to górna rozsądna granica)
::Mnożnik częstotliwości - mnożnik domyślnej częstotliwości z jaka rzucana jest kamera (częstotliwość do pewnego stopnia zależny od kształtu i stopnia zużycia zestawów kołowych)
::Prędkość początkowa, w km/h. Przy tej prędkości, wężykowanie zaczyna działać.
::Prędkość pełna, w km/h. Przy tej prędkości, wężykowanie następuje z pełną siłą

== Opis kabin ==

=== Cabdefinition ===

Po słowie kluczowym <tt>cab<x>definition1</tt> gdzie <tt><x></tt> oznacza numer opisywanej kabiny:	
{| class="wikitable"
!Własność	!!Parametry po typie	!!Opis	!!Uwagi
|-
|cablight	||float	||Ciemny R	||Parametr cablitght jest opcjonalny ale koniecznie musi być jako pierwszy parametr po cab(x)definition, inaczej będziemy mieli crash-a
|-
|	||float	||Ciemny G	
|-
|	||float	||Ciemny B	
|-
|	||float	||Jasny R	
|-
|	||float	||Jasny G	
|-
|	||float	||Jasny B	
|-
|	||float	||Przyciemniony R	
|-
|	||float	||Przyciemniony G	
|-
|	||float	||Przyciemniony B	
|-
|	||float	||X	||W kodzie opisane jako CabPos1, w plikach jako wymiar kabin
|-
|	||float	||Y	
|-
|	||float	||Z	
|-
|	||float	||X	||W kodzie opisane jako CabPos2, w plikach jako wymiar kabin
|-
|	||float	||Y	
|-
|	||float	||Z	
|-
|driver1pos	||float	||X	||Pozycja początkowa maszynisty
|-
|	||float	||Y	
|-
|	||float	||Z	
|-
|driver1sitpos	||float	||X	||Pozycja siedząca maszynisty. Jeśli nie ma wpisu to przyjmowany jest driver1pos
|-
|	||float	||Y	
|-
|	||float	||Z	
|-
|cab1model	||string	||Nazwa pliku	||Model kabiny, może być none
|}

=== Gałki, mierniki, krany ===
Następnie definicja wszelakich gałek, kranów, mierników. Wszystkie elementy mają takie same parametry:

{| class="wikitable"
!Parametry po typie	!!Opis	!!Uwagi
|-
|string	||Nazwa submodelu
|-
|string	||Rodzaj animacji	||rot, mov, wip, dgt, rotvar, movvar
|-
|float	||Par animacji 1	||Mnożnik przesuniecia [m] lub obrotu [%] na jednostkę miary
|-
|float	||Par animacji 2	||Offset zera
|-
|float	||Par animacji 3	||Hamowanie przy zbliżaniu się do wartości zadanej
|}
Dostępne są:
{| class="wikitable"
!klucz !!opis
|-
|mainctrl	||	Główny nastawnik
|-
|mainctrlact	||		Ząbek pozycji aktualnej
|-
|scndctrl	||		Bocznik
|-
|dirkey		||	Nastawnik kierunku
|-
|brakectrl		||	Kran główny
|-
|localbrake		||	Kran pomocniczy
|-
|manualbrake		||	Hamulec ręczny
|-
|alarmchain     || Klapa Ackermana (0 wył 1 zał)
|-
|shuntmodepower	    ||	Pokrętło wzbudzenia prądnicy/mocy/prędkości w jeździe manewrowej
|-
|brakeprofile_sw	||		Przełącznik tow/osob/posp
|-
|brakeprofileg_sw		||	Przełącznik tow/osob
|-
|brakeprofiler_sw		||	Przełącznik osob/posp
|-
|olipump_sw		||	Przełącznik stanu pompy olejowej
|-
|waterpump_sw		||	Przełącznik stanu pompy obiegu wodnego
|-
|waterpumpbreakerpump_sw		||	Wyłącznik samoczynny pompy wody w szafie NN
|-
|waterheater_sw		||	Przełącznik stanu podgrzewacza wody
|-
|waterheaterbreaker_sw		||	Wyłącznik samoczynny podgrzewacza wody w szafie NN
|-
|watercircuitslink_sw		||	Zawór łączący obiegi wody
|-
|maxcurrent_sw		||	Rozruch wysoki / niski lub tryb manewrowy w lokomotywach spalinowych
|-
|main_sw		||	Wyłącznik szybki
|-
|main_off_bt		||	Wyłączenie wyłącznika szybkiego(jeśli dwa rożne przyciski)
|-
|main_on_bt		||	Włączenie (j.w.)
|-
|fuelpump_sw     || Pompa paliwowa
|-
|security_reset_bt	||	Przycisk czuwaka / SHP
|-
|releaser_bt		||	Odluźniacz
|-
|antislip_bt		||	Hamulec przeciwpoślizgowy
|-
|sand_bt		||	Piasecznica
|-
|horn_bt		||	Syrena dwutonowa
|-
|hornlow_bt		||	Syrena ton niski
|-
|hornhigh_bt		||	Syrena ton wysoki
|-
|whistle_bt		||	Gwizdawka
|-
|fuse_bt		||	Przekaźnik nadmiarowy silników trakcyjnych
|-
|converterfuse_bt	||	Przekaźnik nadmiarowy przetwornicy i ogrzewania
|-
|stlinoff_bt		||	Styczniki liniowe
|-
|door_left_sw		||	Drzwi lewe
|-
|door_right_sw		||	Drzwi prawe
|-
|departure_signal_bt	||	Sygnał odjazdu
|-
|upperlight_sw		||	Światło białe przednie górne
|-
|leftlight_sw		||	Światło białe przednie lewe
|-
|rightlight_sw		||	Światło białe przednie prawe
|-
|leftend_sw		||	Światło czerwone przednie lewe
|-
|rightend_sw		||	Światło czerwone przednie prawe
|-
|rearupperlight_sw	||	Światło białe tylne górne
|-
|rearleftlight_sw	||	Światło białe tylne lewe
|-
|rearrightlight_sw	||	Światło białe tylne prawe
|-
|rearleftend_sw		||	Światło czerwone tylne lewe
|-
|rearrightend_sw 	||	Światło czerwone tylne prawe
|-
|dimheadlights_sw 	||	Przyciemnienie reflektorów
|-
|compressor_sw		||	Sprężarka
|-
|compressorlocal_sw	||	Wyłącznik sprężarki w danym członie (ET42 itp)
|-
|converter_sw		||	Przetwornica
|-
|converterlocal_sw	||	Wyłącznik przetwornicy w danym członie (ET42 itp)
|-
|converteroff_sw 	||	Wyłącznik przetwornicy
|-
|radio_sw 		||	Radio: Włącznik/wyłącznik
|-
|radiochannel_sw 	||	Radio: 10-cio pozycyjne pokrętło wyboru kanału
|-
|radiochannelprev_sw 	||	Radio: Przycisk poprzedniego kanału
|-
|radiochannelnext_sw 	||	Radio: Przycisk następnego kanału
|-
|radiotest_sw 		||	Radio: Przycisk testowania Radiostopu || Działa tylko kiedy radiochannel_sw jest na kanale 10
|-
|radiostop_sw 		||	Radio: Przycisk aktywacji Radiostopu
|-
|pantfront_sw 		||	Pantograf przedni
|-
|pantrear_sw 		||	Pantograf tylni
|-
|pantfrontoff_sw	||	Pantograf przedni w dół
|-
|pantrearoff_sw		||	Pantograf tylni w dół
|-
|pantalloff_sw		||	Oba pantografy w dół
|-
|pantselected_sw 	||	Pantograf wybrany selektorem
|-
|pantselectedoff_sw	||	Pantograf wybrany selektorem, w dół
|-
|pantcompressor_sw	||	Sprężarka zbiornika pantografów
|-
|pantcompressorvalve_sw	||	Kurek trój drogowy pantografów (Łączenie zbiornika pantografów ze zbiornikiem głównym)
|-
|trainheating_sw	||	Ogrzewanie składu
|-
|signalling_sw 		||	Sygnalizacja hamowania
|-
|door_signalling_sw	||	Sygnalizacja blokady drzwi
|-
|nextcurrent_sw 	||	Grzanie składu
|-
|cablight_sw 		||	Oświetlenie kabiny pełne
|-
|cablightdim_sw		||	Oświetlenie kabiny przyciemnione
|-
|battery_sw		||	Bateria
|-
|instrumentlight_sw	||	Podświetlenie mierników
|-
|universal0		||
|-
|universal1		||	
|-
|universal2		||	
|-
|universal3		||	
|-
|universal4		||	
|-
|universal5		||
|-
|universal6		||
|-
|universal7		||
|-
|universal8		||
|-
|universal9		||
|-
|tachometer ||
|-
|tachometerb		||	Prędkościomierz z szarpaniem
|-
|tachometern		||	Prędkościomierz bez szarpania
|-
|tachometerd		||	Prędkościomierz cyfrowy
|-
|hvcurrent1 ||
|-
|hvcurrent1b		||	Amperomierz 1
|-
|hvcurrent2 ||
|-
|hvcurrent2b		||	Amperomierz 2
|-
|hvcurrent3b ||
|-
|hvcurrent3b		||	Amperomierz 3
|-
|hvcurrent ||
|-
|hvcurrentb		||	Amperomierz sumujący
|-
|brakepress ||
|-
|brakepressb		||	Manometr cylindrów
|-
|pipepress ||
|-
|pipepressb		||	Manometr przewodu głównego
|-
|limpipepress		||	Manometr zbiornika sterującego zaworu maszynisty
|-
|cntrlpress		||	Manometr zbiornika rozrządu
|-
|oilpress		||	Manometr ciśnienia oleju 
|-
|oilpressb		||	Manometr ciśnienia oleju, w pojeździe ukrotnionym
|-
|oiltemp		||	Manometr temperatury oleju 
|-
|water1temp		||	Wskaźnik temperatury wody w obiegu głównym 
|-
|water1tempb		||	Wskaźnik temperatury wody w obiegu głównym pojazdu ukrotnionego
|-
|water2temp		||	Wskaźnik temperatury wody w obiegu pomocniczym
|-
|compressor 		||	?
|-
|compressorb		||	Manometr sprężarki / zbiornika głównego
|-
|hvbcurrent1		||	Amperomierz 1 drugiego członu
|-
|hvbcurrent2		||	Amperomierz 2 drugiego członu
|-
|hvbcurrent3		||	Amperomierz 3 drugiego członu
|-
|hvbcurrent		||	Amperomierz sumujący drugiego członu
|-
|clock4	||	Opcjonalnie słowo "analog"	Zegarek
|-
|evoltage		||	Woltomierz silników
|-
|hvoltage		||	Woltomierz napięcia w sieci
|-
|lvoltage		||	Woltomierz napięcia za przetwornicą
|-
|enrot1m		||	Obrotomierz 1 [obr/s]
|-
|enrot2m		||	Obrotomierz 2 [obr/s]
|-
|enrot3m		||	Obrotomierz 3 [obr/s]
|-
|engageratio		||	Ciśnienie sterownika sprzęgła [część docisku maksymalnego 0-1]
|-
|maingearstatus		||	Ciśnienie sterownika skrzyni biegów [część docisku maksymalnego 0-1]
|-
|ignitionkey		||	Włącznik zapłonu
|-
|distcounter		||	Licznik kilometrów
|}

Od niedawna, na wersji eksperymentalnej EXE od @Tmj, można przypisać więcej dźwięków do przełączników oraz kontrolek. Nowa składnia wygląda następująco:<br />
<br />
mainctrl: { nastawnikpodst rot -0.02 0.0 0.15 soundinc: nastawnikdoprzodu.wav, sounddec: nastawnikdotylu.wav, sound17: nastawnikpozycja17.wav }<br />
<br />
parametry dźwięku podawane sa w formacie klucz: nazwadzwieku.wav<br />
rozpoznawane klucze to:<br />
- soundinc: dźwięk odgrywany gdy urządzenie przestawiane jest na pozycje 'nastepna' czyli np przestawienie nastawnika do przodu, załączenie przycisku, otwarcie szafki, załączenie kontrolki itp<<br />
- sounddec: dźwięk odgrywany gdy urządzenie przestawiane jest na pozycje 'poprzednia' czyli np przestawienie nastawnika do tylu, puszczenie grzyba, zamkniecie okna, wyłączenie kontrolki itp.<br />
- soundX: dźwięk odgrywany gdy urządzenie ustawione jest na konkretna pozycje X większość przycisków ma tylko dwie pozycje, "0" i "1" ale np nastawniki maja tyle pozycji, ile pozycji ma nastawnik. Ilość wpisów soundX dla danego elementu jest w zasadzie dowolna. NIE działa dla kontrolek, tylko dla przełączników!!!<br />

=== Lampki ===

string	Nazwa submodelu lampki	
*i-maxft5:	Maksymalna siła pociągowa
*i-maxftt:			Przekroczenie maksymalnej siły pociągowej
*i-malfunction:			Kontrolka awarii
*i-malfunctionb:		Kontrolka awarii dla lokomotywy sterowanej, w ukrotnieniu
*i-radio:			Radio: włączone
*i-radiostop:			Radio: 	Otrzymanie sygnału Radiostop
*i-manual_brake:			Działanie hamulca ręcznego
*i-door_blocked:			Blokada drzwi
*i-slippery:			Sygnalizacja poślizgu
*i-contactors:			Działanie styczników liniowych
*i-conv_ovld:			Zadziałanie przekaźnika nadmiarowego przetwornicy
*i-converter:			Przetwornica załączona
*i-converteroff:			Przetwornica wyłączona
*i-converterboff:		(odpowiednik i-converteroff: w członie B)
*i-diff_relay:			Zadziałanie przekaźnika różnicowo-prądowego
*i-diff_relay2:			Zadziałanie przekaźnika różnicowo-prądowego pomocniczego
*i-motor_ovld:			Zadziałanie przekaźnika nadmiarowego silników
*i-motorblowers:			Kontrolka pracy wentylatorów motorów trakcyjnych
*i-train_controll:			Tabor w ukrotnieniu
*i-brake_delay_r:			Hamulec ustawiony na pospieszny
*i-mainbreaker:			Wyłącznik szybki załączony
*i-mainbreakeroff:		Wyłącznik szybki wyłączony
*i-mainbreakerboff: 		(odpowiednik i-mainbreakeroff: w czlonie B)
*i-vent_ovld:			Zadziałanie przekaźnika nadmiarowego wentylatorów
*i-comp_ovld:			Przekaźnik nadmiarowy sprężarki
*i-resistors:			Jazda na oporach
*i-no_resistors:			Jazda bez oporów
*i-no_resistors_b:			Jazda bez oporów B
*i-highcurrent:			Ustawiony wysoki rozruch
*i-vent_trim:			Żaluzje silników
*i-trainheating:			Ogrzewanie składu
*i-security_aware:			Lampka czuwaka
*i-security_cabsignal:			Lampka SHP
*i-door_left:			Otwarte drzwi lewe
*i-door_right:			Otwarte drzwi prawe
*i-departure_signal:			Działanie sygnału odjazdu
*i-reserve:			Rezerwa
*i-scnd:			Lampka działania boczników
*i-scnd1:			Bocznik 1
*i-scnd2:			Bocznik 2
*i-scnd3:			Bocznik 3
*i-scnd4:			Bocznik 4
*i-braking:			Hamowanie aktywne
*i-brakingoff: 			Hamowanie nie aktywne (ciśnienie hamulca pojazdu jest poniżej 10 kPa)
*i-braking-ezt:			Hamowanie zespolone
*i-braking-ezt2:			Hamowanie zespolone 2
*i-brakeprofileg:		Nastawa hamowania towarowego
*i-brakeprofilep:		Nastawa hamowania pasażerska
*i-brakeprofiler:		Nastawa hamowania pospieszna, "Rapid"
*i-compressor:			Sprężarka główna pracuje
*i-compressorb:			Sprężarka pomocnicza pracuje
*i-compressoroff: 		Sprężarka nie pracuje
*i-compressorboff: 		Sprężarka w członie B nie pracuje
*i-voltbrake:			Lampka napięcia nastawy hamulca
*i-mainbreakerb:			Wyłącznik szybki B
*i-resistorsb:			Jazda na oporach B
*i-contactorsb:			Styczniki liniowe B
*i-conv_ovldb:			Przekaźnik nadmiarowy przetwornicy B
*i-converterb:			Przetwornica B
*i-forward:			Jazda do przodu
*i-backward:			Jazda do tyłu
*i-cablight:			Oświetlenie kabiny
*i-dynamicbrake:			Działanie hamulca elektrodynamicznego
*i-instrumentlight:		Podświetlenie mierników załączone
*i-upperlight:			Reflektor górny, przy kabinie A
*i-leftlight:			Reflektor lewy biały, przy kabinie A
*i-rightlight:			Reflektor prawy biały, przy kabinie A
*i-leftend:			Reflektor lewy czerwony, przy kabinie A
*i-rightend:			Reflektor prawy czerwony, przy kabinie A
*i-rearupperlight:		Reflektor tylny górny, przy kabinie B
*i-rearleftlight:		Reflektor tylny lewy biały, przy kabinie B
*i-rearrightlight:		Reflektor tylny prawy biały, przy kabinie B
*i-rearleftend:			Reflektor tylny czerwony lewy, przy kabinie B
*i-rearrightend:		Reflektor tylny czerwony prawy, przy kabinie B
*i-fuelpumpoff:			Pompa paliwa wyłączona

1. cab1definition tak naprawdę jest cab(x)definition wraz z wszystkimi potomnymi. Kabiny dostępne od 0 do 2, przy czym 0 jest korytarzem a 1 i 2 kabinami odpowiednio A (headdriver) i B (reardriver).
2. od mainctrl do distcounter wszystkie pozostałe parametry są te same. Podane tylko w mainctrl a w reszcie tylko jako odnośniki do poszczególnych gałek
3. Rodzaje animacji: rot (domyślny), mov, wip, dgt, rotvar, movvar
4. Po słowie kluczowym analog są ładowane submodele z modelu kabiny o nazwach: ClockShand ClockMhand ClockHhand odpowiednio dla ramion sekund, minut i godzin
5. Dla lampek do nazwy submodelu dodawane są słowa "_on" i "_off" dla stanu zapalonego i zgaszonego.

== Uwagi ==
W specyfikacji znajdują się wszystkie jawnie zdefiniowane przełączniki, przyciski i lampki. Nie ma tutaj żadnych danych na podstawie, których można robić ekrany LCD. Te dane znajdują się w [[Python|osobnym pliku]].

<!-- Dowiedzieć się kaj to dokłanie wciepnąć

-->