Obiekt node::track: Różnice pomiędzy wersjami

Z MaSzyna
Skocz do: nawigacja, szukaj
(Parametry opcjonalne)
 
(Nie pokazano 31 wersji utworzonych przez 2 użytkowników)
Linia 1: Linia 1:
 
Definiuje odcinek trajektorii ruchu: drogi, tory, rzeki.
 
Definiuje odcinek trajektorii ruchu: drogi, tory, rzeki.
  
Każda definicja zaczyna się od parametrów definiujących podstawowe parametry wizualne i funkcjonalne trajektorii.
+
== Składnia ==
 +
 
 +
Definicja zaczyna się od parametrów definiujących podstawowe parametry wizualne i funkcjonalne trajektorii.
  
 
Pod tymi parametrami zapisane są parametry krzywych Beziera które opisują geometrię trajektorii.
 
Pod tymi parametrami zapisane są parametry krzywych Beziera które opisują geometrię trajektorii.
Linia 7: Linia 9:
 
Pod definicją krzywych znajduje się lista opcjonalnych parametrów.
 
Pod definicją krzywych znajduje się lista opcjonalnych parametrów.
  
 
+
  {{Szablon:Kod_preambuly_node}} <span style="color:tomato;font-weight:bold">track</span> ''type length width friction soundDistance qualityFlag damageFlag environment visible''
== Struktura wpisu ==
+
  ''material1 texLength material2 texHeight texWidth texSlope''
 
+
<span style="color:gray;font-style:italic">// definicja krzywej beziera</span>
  {{Szablon:Kod_preambuly_node}} <span style="color:tomato;font-weight:bold">track</span> ''type length width friction clatter_distance quality_flag damage_flag environment visibility''
 
  ''map1 map1_length map2 profile_parameter1 profile_parameter2 profile_parameter3''
 
 
  ''p1x p1y p1z roll1''
 
  ''p1x p1y p1z roll1''
 
  ''cv1x cv1y cv1z''
 
  ''cv1x cv1y cv1z''
Linia 17: Linia 17:
 
  ''p2x p2y p2z roll2''
 
  ''p2x p2y p2z roll2''
 
  ''radius1''
 
  ''radius1''
  <span style="color:gray;font-style:italic">// opcjonalna druga krzywa beziera dla tylko dla skrzyżowań i zwrotnic!</span>
+
  <span style="color:gray;font-style:italic">// opcjonalna druga krzywa beziera tylko dla skrzyżowań i zwrotnic!</span>
 
  ''p3x p3y p3z roll3''
 
  ''p3x p3y p3z roll3''
 
  ''cv3x cv3y cv3z''
 
  ''cv3x cv3y cv3z''
Linia 23: Linia 23:
 
  ''p4x p4y p4z roll4''
 
  ''p4x p4y p4z roll4''
 
  ''radius2''
 
  ''radius2''
  <span style="color:gray;font-style:italic">// opcjonalne parametry w formie klucz-wartość</span>
+
  <span style="color:gray;font-style:italic">// opcjonalne parametry w formie klucz-wartość, może wystąpić ich dowolna ilość</span>
 
  <span style="color:orange;font-weight:bold">optionalparameter1</span> ''value1''
 
  <span style="color:orange;font-weight:bold">optionalparameter1</span> ''value1''
 
  <span style="color:orange;font-weight:bold">optionalparameter2</span> ''value2''
 
  <span style="color:orange;font-weight:bold">optionalparameter2</span> ''value2''
 
  <span style="color:tomato;font-weight:bold">endtrack</span>
 
  <span style="color:tomato;font-weight:bold">endtrack</span>
  
 
+
=== Parametry funkcjonalno-wizualne ===
== Parametry funkcjonalno-wizualne ==
 
  
 
{| class="wikitable"
 
{| class="wikitable"
Linia 35: Linia 34:
 
! Nazwa
 
! Nazwa
 
! Znaczenie
 
! Znaczenie
 +
{{Szablon:Wspólne_parametry_node}}
 
|-
 
|-
| type
+
| '''type'''
 
|Określa typ trajektorii.
 
|Określa typ trajektorii.
  
Linia 49: Linia 49:
 
* '''table''' - obrotnica, przesuwnica, wywrotnica (nie działa)
 
* '''table''' - obrotnica, przesuwnica, wywrotnica (nie działa)
 
|-
 
|-
| length
+
| '''length'''
 
| Długość toru [m].
 
| Długość toru [m].
  
 
Parametr nieużywany, aczkolwiek edytor Rainsted w to miejsce wpisuje kilometraż punktu 1.
 
Parametr nieużywany, aczkolwiek edytor Rainsted w to miejsce wpisuje kilometraż punktu 1.
 
|-
 
|-
| width
+
| '''trackWidth'''
 
|
 
|
 
Definiuje:
 
Definiuje:
Linia 61: Linia 61:
 
* szerokość koryta rzeki (dla typów '''river, tributary''')
 
* szerokość koryta rzeki (dla typów '''river, tributary''')
 
|-
 
|-
| friction
+
| '''friction'''
 
| Statyczny współczynnik tarcia.
 
| Statyczny współczynnik tarcia.
 
|-
 
|-
| clatter_distance
+
| '''soundDistance'''
 
| Odległość powtarzania dźwięku stukotu kół na stykach.
 
| Odległość powtarzania dźwięku stukotu kół na stykach.
  
 
Dla toru bezstykowego należy podać wartość 0.
 
Dla toru bezstykowego należy podać wartość 0.
 
|-
 
|-
| quality_flag
+
| '''qualityFlag'''
 
| Ile ton/oś (?).
 
| Ile ton/oś (?).
 
|-
 
|-
| damage_flag
+
| '''damageFlag'''
 
| Poziom uszkodzeń toru w formie maski bitowej.  
 
| Poziom uszkodzeń toru w formie maski bitowej.  
 
* 0 - tor przejezdny
 
* 0 - tor przejezdny
 
* 128 - tor uszkodzony (po najechaniu nastąpi wykolejenie)
 
* 128 - tor uszkodzony (po najechaniu nastąpi wykolejenie)
 
|-
 
|-
| environment
+
| '''environment'''
 
| Środowisko w jakim znajduje się trajektoria.  
 
| Środowisko w jakim znajduje się trajektoria.  
 
W zależności od środowiska zmienia się echo dźwięków.
 
W zależności od środowiska zmienia się echo dźwięków.
Linia 88: Linia 88:
  
 
|-
 
|-
| visibility
+
| '''visible'''
 
| Widoczność trajektorii.
 
| Widoczność trajektorii.
  
Linia 96: Linia 96:
  
  
Jeśli parametr ''visibility'' określa, że trajektoria jest widoczna, to należy podać kolejny zbiór parametrów. W przypadku gdy trajektoria jest niewidoczna, należy je pominąć:
+
Jeśli parametr ''visibility'' określa, że trajektoria jest widoczna, to we wpisie występuje kolejny zbiór parametrów. W przypadku gdy trajektoria jest niewidoczna, są one pominięte:
  
 
{| class="wikitable"
 
{| class="wikitable"
Linia 103: Linia 103:
 
! Znaczenie
 
! Znaczenie
 
|-
 
|-
| map1
+
| '''material1'''
 
| Ścieżka do materiału numer 1.
 
| Ścieżka do materiału numer 1.
  
Określa materiał:
+
Określa [[Materiały - Pliki .mat|materiał]]:
 
* szyn (dla typów '''normal, turn, table''')
 
* szyn (dla typów '''normal, turn, table''')
 
* szyn toru zasadniczego (dla typu '''switch''')
 
* szyn toru zasadniczego (dla typu '''switch''')
Linia 112: Linia 112:
 
* wody w rzece (dla typów '''river, tributary''')
 
* wody w rzece (dla typów '''river, tributary''')
  
Jeśli jako teksturę szyn podano '''none''', to szyny staną się niewidoczne.
+
Jeśli jako materiał szyn podano '''none''', to szyny staną się niewidoczne.
 
|-
 
|-
| map1_length
+
| '''texLength'''
| Odległość powtarzania mapowania materiałem ''map1'' [m].
+
| Odległość na jakiej ma rozkładać się [[Materiały - Pliki .mat|materiał]] ''material1'', innymi słowy co ile metrów ma nastąpić kafelkowanie materiału.
  
Jeśli [[Materiały - Pliki .mat|materiał]] podany w ''map1'' definiuje parametr ''size'', to wartość z wpisu jest nadpisywana wartością z materiału.
+
Jeśli [[Materiały - Pliki .mat|materiał]] podany w ''material1'' definiuje parametr ''size'', to wartość z wpisu jest nadpisywana wartością z [[Materiały - Pliki .mat|materiału]].
 
|-
 
|-
| map2
+
| '''material2'''
 
| Ścieżka do materiału numer 2.
 
| Ścieżka do materiału numer 2.
  
Określa materiał:
+
Określa [[Materiały - Pliki .mat|materiał]]:
 
* podsypki (dla typów '''normal, turn, table''')
 
* podsypki (dla typów '''normal, turn, table''')
 
* szyn toru zwrotnego (dla typu '''switch''')
 
* szyn toru zwrotnego (dla typu '''switch''')
Linia 130: Linia 130:
 
Jeśli jako teksturę szyn podano '''none''', to szyny staną się niewidoczne
 
Jeśli jako teksturę szyn podano '''none''', to szyny staną się niewidoczne
 
|-
 
|-
| profile_parameter1
+
| '''texHeight'''
 
|  
 
|  
 
* wysokość pryzmy podsypki (dla typów '''normal, turn, table''')
 
* wysokość pryzmy podsypki (dla typów '''normal, turn, table''')
 
* wysokość pobocza drogi/chodnika (dla typów '''road, cross''').  
 
* wysokość pobocza drogi/chodnika (dla typów '''road, cross''').  
 
* wysokość brzegu rzeki (dla typów '''river, tributary''')
 
* wysokość brzegu rzeki (dla typów '''river, tributary''')
 +
 +
Dla typu '''switch''' parametr nie ma znaczenia.
  
 
W przypadku dróg podanie ujemnej wartości włączy generowanie chodników.
 
W przypadku dróg podanie ujemnej wartości włączy generowanie chodników.
 
|-
 
|-
| profile_parameter2
+
| '''texWidth'''
 
|  
 
|  
 
* odległość od szyny do początku skosu podsypki (dla typów '''normal, turn, table''')
 
* odległość od szyny do początku skosu podsypki (dla typów '''normal, turn, table''')
Linia 144: Linia 146:
 
* szerokość chodnika po lewej stronie (dla typów '''road, cross'''), jeśli włączone jest generowanie chodników.  
 
* szerokość chodnika po lewej stronie (dla typów '''road, cross'''), jeśli włączone jest generowanie chodników.  
 
* szerokość lewego brzegu rzeki (dla typów '''river, tributary''')
 
* szerokość lewego brzegu rzeki (dla typów '''river, tributary''')
 +
 +
Dla typu '''switch''' parametr nie ma znaczenia
 
|-
 
|-
| profile_parameter3
+
| '''texSlope'''
 
|  
 
|  
 
* szerokość skosu podsypki (dla typów '''normal, turn, table''')
 
* szerokość skosu podsypki (dla typów '''normal, turn, table''')
Linia 151: Linia 155:
 
* szerokość chodnika po prawej stronie (dla typów '''road, cross'''), jeśli włączone jest generowanie chodników.  
 
* szerokość chodnika po prawej stronie (dla typów '''road, cross'''), jeśli włączone jest generowanie chodników.  
 
* szerokość prawego brzegu rzeki (dla typów '''river, tributary''')
 
* szerokość prawego brzegu rzeki (dla typów '''river, tributary''')
|}
 
  
== Geometria toru ==
+
Dla typu '''switch''' parametr nie ma znaczenia
 +
|}
 +
 
 +
=== Geometria toru ===
 
Geometria toru opisana jest za pomocą krzywej Beziera.
 
Geometria toru opisana jest za pomocą krzywej Beziera.
Proste odcinki trajektorii, niebędące skrzyżowaniami lub zwrotnicami, definiują tylko jedną krzywą.
+
Odcinki trajektorii niebędące skrzyżowaniami lub zwrotnicami definiują tylko jedną krzywą.
  
 
{| class="wikitable"
 
{| class="wikitable"
Linia 162: Linia 168:
 
! Znaczenie
 
! Znaczenie
 
|-
 
|-
| p1x p1y p1z
+
| '''p1x p1y p1z'''
 
| Współrzędne punktu P1.
 
| Współrzędne punktu P1.
 
|-
 
|-
| roll1
+
| '''roll1'''
 
| Kąt przechyłki w punkcie P1
 
| Kąt przechyłki w punkcie P1
 
|-
 
|-
| cv1x cv1y cv1z
+
| '''cv1x cv1y cv1z'''
| Współrzędne punktu kontrolnego CV1.
+
| Współrzędne punktu kontrolnego CV1 (względem P1).
 
|-
 
|-
| cv2x cv2y cv2z
+
| '''cv2x cv2y cv2z'''
| Współrzędne punktu kontrolnego CV2.
+
| Współrzędne punktu kontrolnego CV (względem P2).
 
|-
 
|-
| p2x p2y p2z
+
| '''p2x p2y p2z'''
 
| Współrzędne punktu P2.
 
| Współrzędne punktu P2.
 
|-
 
|-
| roll2
+
| '''roll2'''
 
| Kąt przechyłki w punkcie P2
 
| Kąt przechyłki w punkcie P2
 
|-
 
|-
| radius1
+
| '''radius1'''
 
| Wartość promienia łuku dla pierwszej krzywej - wartość nieużywana.
 
| Wartość promienia łuku dla pierwszej krzywej - wartość nieużywana.
 
|}  
 
|}  
Linia 187: Linia 193:
 
W rozjeździe i skrzyżowaniu trójwlotowym punkt 1 musi mieć takie same współrzędne jak punkt 3.  
 
W rozjeździe i skrzyżowaniu trójwlotowym punkt 1 musi mieć takie same współrzędne jak punkt 3.  
 
W przypadku skrzyżowania czterowlotowego takiego wymogu nie ma.
 
W przypadku skrzyżowania czterowlotowego takiego wymogu nie ma.
 +
 +
W przypadku rozjazdu położenie zasadnicze rozjazdu będzie zawsze prowadziło po pierwszej zdefiniowanej krzywej. Możliwe jest stworzenie zwrotnicy prowadzącej w położeniu zasadniczym "na ostrze" - wówczas tor zwrotny trzeba zdefiniować jako pierwszą krzywą.
  
 
{| class="wikitable"
 
{| class="wikitable"
Linia 193: Linia 201:
 
! Znaczenie
 
! Znaczenie
 
|-
 
|-
| p3x p3y p3z
+
| '''p3x p3y p3z'''
 
| Współrzędne punktu P3.
 
| Współrzędne punktu P3.
 
|-
 
|-
| roll3
+
| '''roll3'''
 
| Kąt przechyłki w punkcie P3
 
| Kąt przechyłki w punkcie P3
 
|-
 
|-
| cv3x cv3y cv3z
+
| '''cv3x cv3y cv3z'''
| Współrzędne punktu kontrolnego CV3.
+
| Współrzędne punktu kontrolnego CV3 (względem P3).
 
|-
 
|-
| cv4x cv4y cv4z
+
| '''cv4x cv4y cv4z'''
| Współrzędne punktu kontrolnego CV4.
+
| Współrzędne punktu kontrolnego CV4 (względem P4).
 
|-
 
|-
| p4x p4y p4z
+
| '''p4x p4y p4z'''
 
| Współrzędne punktu P4.
 
| Współrzędne punktu P4.
 
|-
 
|-
| roll4
+
| '''roll4'''
 
| Kąt przechyłki w punkcie P4
 
| Kąt przechyłki w punkcie P4
 
|-
 
|-
| radius2
+
| '''radius2'''
 
| Wartość promienia łuku dla drugiej krzywej - wartość nieużywana.
 
| Wartość promienia łuku dla drugiej krzywej - wartość nieużywana.
|}  
+
|}
  
== Parametry opcjonalne ==
+
=== Parametry opcjonalne ===
 
Parametry opcjonalne zapisane są na samym końcu wpisu, między definicjami krzywych a słowem kluczowym ''endtrack''.
 
Parametry opcjonalne zapisane są na samym końcu wpisu, między definicjami krzywych a słowem kluczowym ''endtrack''.
 +
Zapisuje się je w postaci klucz-wartość, tak jak w poniższym przykładzie.
  
Klucz i wartość parametru zapisuje się zwyczajowo w jednej linii, a kolejne parametry - w kolejnych liniach.
+
...
 +
<span style="color:orange;font-weight:bold">velocity</span> 40
 +
<span style="color:orange;font-weight:bold">isolated</span> It4
 +
...
  
 
Poniżej znajduje się lista dostępnych kluczy:
 
Poniżej znajduje się lista dostępnych kluczy:
Linia 230: Linia 242:
 
|-
 
|-
 
| '''isolated'''
 
| '''isolated'''
| Określa nazwę odcinka izolowanego, do którego należy tor.
+
| Określa nazwę odcinka izolowanego, do którego należy tor. (parametr może występować wielokrotnie, gdy tor należy do wielu odcinków)
 
|-
 
|-
 
| '''overhead'''
 
| '''overhead'''
Linia 242: Linia 254:
 
|-  
 
|-  
 
|'''trackbed'''
 
|'''trackbed'''
| Nazwa pliku materiału dla automatycznie generowanej podsypki pod rozjazdem.
+
| Nazwa pliku [[Materiały - Pliki .mat|materiału]] dla automatycznie generowanej podsypki pod rozjazdem.
  
Jeśli ten parametr nie zostanie podany, to materiał podsypki zostanie wzięty z któregoś z torów sąsiadujących z rozjazdem.
+
Jeśli ten parametr nie zostanie podany, to materiał podsypki zostanie pobrany z jednego z torów sąsiadujących z rozjazdem.
 
|-
 
|-
 
| '''friction'''
 
| '''friction'''
| Nazwa komórki pamięci modyfikującej parametr tarcia w torze.  
+
| Nazwa [[Obiekt node::memcell|komórki pamięci]] modyfikującej parametr tarcia w torze.  
 
Działa zgodnie z wzorem:  
 
Działa zgodnie z wzorem:  
  tarcie = wartość bazowa * pierwsza wartość liczbowa z komórki pamięci + druga wartość bazowa z komórki pamięci
+
  tarcie = wartość bazowa * pierwsza wartość liczbowa z [[Obiekt node::memcell|komórki pamięci]] + druga wartość bazowa z [[Obiekt node::memcell|komórki pamięci]]
 +
|-
 +
| '''event0'''
 +
| Nazwa [[Obiekt event|eventu]], który zostanie uruchomiony gdy obsadzony pojazd stoi na torze.
 +
|-
 +
| '''event1'''
 +
| Nazwa [[Obiekt event|eventu]], który zostanie uruchomiony gdy obsadzony pojazd wjedzie na tor w kierunku punktu P1. Może służyć do przypisywania eventów, które będą skanowane przez AI. W przypadku przypisywania wskaźników i rezonatorów należy umieścić event w torze przy wskaźniku, a wyjątkowo gdy nie ma takiej możliwości - przy torze sąsiednim.
 +
|-
 +
| '''event2'''
 +
| Nazwa [[Obiekt event|eventu]], który zostanie uruchomiony gdy obsadzony pojazd wjedzie na tor w kierunku punktu P2.Może służyć do przypisywania eventów, które będą skanowane przez AI. W przypadku przypisywania wskaźników i rezonatorów należy umieścić event w torze przy wskaźniku, a wyjątkowo gdy nie ma takiej możliwości - przy torze sąsiednim.
 
|-
 
|-
| <del>'''vradius'''</del>
+
| '''eventall0'''
| Określa informację o promieniu łuku pionowego [m] - nie działa.
+
| Nazwa [[Obiekt event|eventu]], który zostanie uruchomiony gdy jakikolwiek pojazd stoi na torze.
 +
|-
 +
| '''eventall1'''
 +
| Nazwa [[Obiekt event|eventu]], który zostanie uruchomiony gdy jakikolwiek pojazd wjedzie na tor w kierunku punktu P1.
 +
|-
 +
| '''eventall2'''
 +
| Nazwa [[Obiekt event|eventu]], który zostanie uruchomiony gdy jakikolwiek pojazd wjedzie na tor w kierunku punktu P2.
 +
|-
 +
| '''vradius'''
 +
| Określa informację o promieniu łuku pionowego [m]
 
|-
 
|-
 
| <del>'''angle1'''</del>
 
| <del>'''angle1'''</del>
| Kąt ścięcia podsypki/drogi/rzeki w punkcie P1 [deg] - nie działa.
+
| <del>Kąt ścięcia podsypki/drogi/rzeki w punkcie P1 [deg]</del>
 
|-
 
|-
 
| <del>'''angle2'''</del>
 
| <del>'''angle2'''</del>
| Kąt ścięcia podsypki/drogi/rzeki w punkcie P2 [deg] - nie działa.
+
| <del>Kąt ścięcia podsypki/drogi/rzeki w punkcie P2 [deg]</del>
 
|-
 
|-
 
| <del>'''fouling1'''</del>
 
| <del>'''fouling1'''</del>
| Model ukresu w kierunku 1 - nie działa.
+
| <del>Model ukresu w kierunku 1</del>
 
|-
 
|-
 
| <del>'''fouling2'''</del>
 
| <del>'''fouling2'''</del>
| Model ukresu w kierunku 2 - nie działa.
+
| <del>Model ukresu w kierunku 2</del>
 
|}  
 
|}  
 
    <span style="color:orange;font-weight:bold">event0</span> nazwa_eventu <span style="color:gray">// Zdarzenie które zostanie uruchomione gdy obsadzony załogą dynamic stoi na torze.</span>
 
    <span style="color:orange;font-weight:bold">event1</span> nazwa_eventu <span style="color:gray">// Zdarzenie które zostanie uruchomione gdy obsadzony załogą dynamic wjedzie na tor w kierunku punktu 1.</span>
 
    <span style="color:orange;font-weight:bold">event2</span> nazwa_eventu <span style="color:gray">// Zdarzenie które zostanie uruchomione gdy obsadzony załogą dynamic wjedzie na tor w kierunku punktu 2.</span>
 
    <span style="color:orange;font-weight:bold">eventall0</span> nazwa_eventu <span style="color:gray">// Zdarzenie które zostanie uruchomione gdy jakikolwiek dynamic stoi na torze.</span>
 
    <span style="color:orange;font-weight:bold">eventall1</span> nazwa_eventu <span style="color:gray">// Zdarzenie które zostanie uruchomione gdy jakikolwiek dynamic wjedzie na tor w kierunku punktu 1.</span>
 
    <span style="color:orange;font-weight:bold">eventall2</span> nazwa_eventu <span style="color:gray">// Zdarzenie które zostanie uruchomione gdy jakikolwiek dynamic wjedzie na tor w kierunku punktu 2.</span>
 
 
 
 
  
 
[[Kategoria:Scenerie]]
 
[[Kategoria:Scenerie]]

Aktualna wersja na dzień 08:37, 20 sie 2022

Definiuje odcinek trajektorii ruchu: drogi, tory, rzeki.

Składnia

Definicja zaczyna się od parametrów definiujących podstawowe parametry wizualne i funkcjonalne trajektorii.

Pod tymi parametrami zapisane są parametry krzywych Beziera które opisują geometrię trajektorii.

Pod definicją krzywych znajduje się lista opcjonalnych parametrów.

node range_max range_min name track type length width friction soundDistance qualityFlag damageFlag environment visible
material1 texLength material2 texHeight texWidth texSlope
// definicja krzywej beziera
p1x p1y p1z roll1
cv1x cv1y cv1z
cv2x cv2y cv2z
p2x p2y p2z roll2
radius1
// opcjonalna druga krzywa beziera tylko dla skrzyżowań i zwrotnic!
p3x p3y p3z roll3
cv3x cv3y cv3z
cv4x cv4y cv4z
p4x p4y p4z roll4
radius2
// opcjonalne parametry w formie klucz-wartość, może wystąpić ich dowolna ilość
optionalparameter1 value1
optionalparameter2 value2
endtrack

Parametry funkcjonalno-wizualne

Opis parametrów
Nazwa Znaczenie
range_max Maksymalna odległość, z jakiej obiekt jest widoczny [m].

Wartość -1 oznacza brak ograniczenia widoczności.

range_min Minimalna odległość, z jakiej obiekt jest widoczny [m].
name Nazwa obiektu.
type Określa typ trajektorii.

Dostępne typy:

  • normal - tor
  • switch - zwrotnica
  • road - droga
  • cross - skrzyżowanie dróg
  • river - rzeka
  • tributary - skrzyżowanie rzek
  • turn - obrotnica (zobacz, jak zastosować)
  • table - obrotnica, przesuwnica, wywrotnica (nie działa)
length Długość toru [m].

Parametr nieużywany, aczkolwiek edytor Rainsted w to miejsce wpisuje kilometraż punktu 1.

trackWidth

Definiuje:

  • rozstaw szyn (dla typów normal, switch, turn, table)
  • szerokość jezdni (dla typów road, cross)
  • szerokość koryta rzeki (dla typów river, tributary)
friction Statyczny współczynnik tarcia.
soundDistance Odległość powtarzania dźwięku stukotu kół na stykach.

Dla toru bezstykowego należy podać wartość 0.

qualityFlag Ile ton/oś (?).
damageFlag Poziom uszkodzeń toru w formie maski bitowej.
  • 0 - tor przejezdny
  • 128 - tor uszkodzony (po najechaniu nastąpi wykolejenie)
environment Środowisko w jakim znajduje się trajektoria.

W zależności od środowiska zmienia się echo dźwięków.

  • flat - tor na otwartym terenie.
  • mountains/mountain - tor w górach.
  • canyon - tor w wykopie.
  • tunnel - tor w tunelu.
  • bridge - tor na moście/wiadukcie.
  • bank - ?
visible Widoczność trajektorii.
  • unvis/novis - niewidoczna
  • vis - widoczna


Jeśli parametr visibility określa, że trajektoria jest widoczna, to we wpisie występuje kolejny zbiór parametrów. W przypadku gdy trajektoria jest niewidoczna, są one pominięte:

Opis parametrów
Nazwa Znaczenie
material1 Ścieżka do materiału numer 1.

Określa materiał:

  • szyn (dla typów normal, turn, table)
  • szyn toru zasadniczego (dla typu switch)
  • nawierzchni drogi (dla typów road, cross)
  • wody w rzece (dla typów river, tributary)

Jeśli jako materiał szyn podano none, to szyny staną się niewidoczne.

texLength Odległość na jakiej ma rozkładać się materiał material1, innymi słowy co ile metrów ma nastąpić kafelkowanie materiału.

Jeśli materiał podany w material1 definiuje parametr size, to wartość z wpisu jest nadpisywana wartością z materiału.

material2 Ścieżka do materiału numer 2.

Określa materiał:

  • podsypki (dla typów normal, turn, table)
  • szyn toru zwrotnego (dla typu switch)
  • pobocza drogi/chodnika (dla typów road, cross)
  • brzegów rzeki (dla typów river, tributary)

Jeśli jako teksturę szyn podano none, to szyny staną się niewidoczne

texHeight
  • wysokość pryzmy podsypki (dla typów normal, turn, table)
  • wysokość pobocza drogi/chodnika (dla typów road, cross).
  • wysokość brzegu rzeki (dla typów river, tributary)

Dla typu switch parametr nie ma znaczenia.

W przypadku dróg podanie ujemnej wartości włączy generowanie chodników.

texWidth
  • odległość od szyny do początku skosu podsypki (dla typów normal, turn, table)
  • szerokość pobocza dla drogi (dla typów road, cross).
  • szerokość chodnika po lewej stronie (dla typów road, cross), jeśli włączone jest generowanie chodników.
  • szerokość lewego brzegu rzeki (dla typów river, tributary)

Dla typu switch parametr nie ma znaczenia

texSlope
  • szerokość skosu podsypki (dla typów normal, turn, table)
  • szerokość skosu pobocza drogi (dla typów road, cross).
  • szerokość chodnika po prawej stronie (dla typów road, cross), jeśli włączone jest generowanie chodników.
  • szerokość prawego brzegu rzeki (dla typów river, tributary)

Dla typu switch parametr nie ma znaczenia

Geometria toru

Geometria toru opisana jest za pomocą krzywej Beziera. Odcinki trajektorii niebędące skrzyżowaniami lub zwrotnicami definiują tylko jedną krzywą.

Opis parametrów
Nazwa Znaczenie
p1x p1y p1z Współrzędne punktu P1.
roll1 Kąt przechyłki w punkcie P1
cv1x cv1y cv1z Współrzędne punktu kontrolnego CV1 (względem P1).
cv2x cv2y cv2z Współrzędne punktu kontrolnego CV (względem P2).
p2x p2y p2z Współrzędne punktu P2.
roll2 Kąt przechyłki w punkcie P2
radius1 Wartość promienia łuku dla pierwszej krzywej - wartość nieużywana.

W przypadku rozjazdów i skrzyżowań należy dodatkowo zdefiniować drugą krzywą. W rozjeździe i skrzyżowaniu trójwlotowym punkt 1 musi mieć takie same współrzędne jak punkt 3. W przypadku skrzyżowania czterowlotowego takiego wymogu nie ma.

W przypadku rozjazdu położenie zasadnicze rozjazdu będzie zawsze prowadziło po pierwszej zdefiniowanej krzywej. Możliwe jest stworzenie zwrotnicy prowadzącej w położeniu zasadniczym "na ostrze" - wówczas tor zwrotny trzeba zdefiniować jako pierwszą krzywą.

Opis parametrów
Nazwa Znaczenie
p3x p3y p3z Współrzędne punktu P3.
roll3 Kąt przechyłki w punkcie P3
cv3x cv3y cv3z Współrzędne punktu kontrolnego CV3 (względem P3).
cv4x cv4y cv4z Współrzędne punktu kontrolnego CV4 (względem P4).
p4x p4y p4z Współrzędne punktu P4.
roll4 Kąt przechyłki w punkcie P4
radius2 Wartość promienia łuku dla drugiej krzywej - wartość nieużywana.

Parametry opcjonalne

Parametry opcjonalne zapisane są na samym końcu wpisu, między definicjami krzywych a słowem kluczowym endtrack. Zapisuje się je w postaci klucz-wartość, tak jak w poniższym przykładzie.

...
velocity 40
isolated It4
...

Poniżej znajduje się lista dostępnych kluczy:

Opis parametrów
Nazwa Znaczenie
velocity Definiuje maksymalną prędkość [km/h], jakiej pojazd prowadzony przez AI będzie starał się nie przekroczyć.
isolated Określa nazwę odcinka izolowanego, do którego należy tor. (parametr może występować wielokrotnie, gdy tor należy do wielu odcinków)
overhead Określa jak ma zachować się AI podczas jazdy pod siecią trakcyjną na tym torze.
  • brak parametru - jazda pod prądem
  • 0 - jazda bezprądowa
  • wartości większe od 0 - dodatkowe ograniczenie prędkości [km/h] podczas jazdy bezprądowej
railprofile Nazwa pliku z definicją profilu szyny (relatywna do katalogu models, bez rozszerzenia).
trackbed Nazwa pliku materiału dla automatycznie generowanej podsypki pod rozjazdem.

Jeśli ten parametr nie zostanie podany, to materiał podsypki zostanie pobrany z jednego z torów sąsiadujących z rozjazdem.

friction Nazwa komórki pamięci modyfikującej parametr tarcia w torze.

Działa zgodnie z wzorem:

tarcie = wartość bazowa * pierwsza wartość liczbowa z komórki pamięci + druga wartość bazowa z komórki pamięci
event0 Nazwa eventu, który zostanie uruchomiony gdy obsadzony pojazd stoi na torze.
event1 Nazwa eventu, który zostanie uruchomiony gdy obsadzony pojazd wjedzie na tor w kierunku punktu P1. Może służyć do przypisywania eventów, które będą skanowane przez AI. W przypadku przypisywania wskaźników i rezonatorów należy umieścić event w torze przy wskaźniku, a wyjątkowo gdy nie ma takiej możliwości - przy torze sąsiednim.
event2 Nazwa eventu, który zostanie uruchomiony gdy obsadzony pojazd wjedzie na tor w kierunku punktu P2.Może służyć do przypisywania eventów, które będą skanowane przez AI. W przypadku przypisywania wskaźników i rezonatorów należy umieścić event w torze przy wskaźniku, a wyjątkowo gdy nie ma takiej możliwości - przy torze sąsiednim.
eventall0 Nazwa eventu, który zostanie uruchomiony gdy jakikolwiek pojazd stoi na torze.
eventall1 Nazwa eventu, który zostanie uruchomiony gdy jakikolwiek pojazd wjedzie na tor w kierunku punktu P1.
eventall2 Nazwa eventu, który zostanie uruchomiony gdy jakikolwiek pojazd wjedzie na tor w kierunku punktu P2.
vradius Określa informację o promieniu łuku pionowego [m]
angle1 Kąt ścięcia podsypki/drogi/rzeki w punkcie P1 [deg]
angle2 Kąt ścięcia podsypki/drogi/rzeki w punkcie P2 [deg]
fouling1 Model ukresu w kierunku 1
fouling2 Model ukresu w kierunku 2