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

Z MaSzyna
Skocz do: nawigacja, szukaj
 
(Nie pokazano 110 wersji utworzonych przez 3 użytkowników)
Linia 1: Linia 1:
Definiuje odcinek trajektorii ruchu: drogi, tory, rzeki...  
+
Definiuje odcinek trajektorii ruchu: drogi, tory, rzeki.
Każdy wpis '''node::track''' zaczyna się od tych samych parametrów, kolejne parametry zależą od typu trajektorii.
+
 
{{Szablon:Kod_preambuly_node}} <span style="color:tomato;font-weight:bold">track</span> ''type'' {{Szablon:Pierwsze_parametry_node_track}}
+
== Składnia ==
    ''...''
 
    {| class="wikitable"
 
|+ Opis parametrów
 
! Nazwa parametru
 
! Znaczenie parametru
 
! Typ wartości
 
! Uwagi
 
|-
 
| typ
 
| Typ toru.
 
| Słowo kluczowe
 
|Jedno ze słów kluczowych:
 
  
<span style="color:orange;font-weight:bold">track</span> - tor
+
Definicja zaczyna się od parametrów definiujących podstawowe parametry wizualne i funkcjonalne trajektorii.
 
<span style="color:orange;font-weight:bold">switch</span> - zwrotnica
 
  
<span style="color:orange;font-weight:bold">road</span> - droga
+
Pod tymi parametrami zapisane są parametry krzywych Beziera które opisują geometrię trajektorii.
  
<span style="color:orange;font-weight:bold">cross</span> - skrzyżowanie dróg
+
Pod definicją krzywych znajduje się lista opcjonalnych parametrów.
  
<span style="color:orange;font-weight:bold">river</span> - rzeka
+
{{Szablon:Kod_preambuly_node}} <span style="color:tomato;font-weight:bold">track</span> ''type length width friction soundDistance qualityFlag damageFlag environment visible''
 +
''material1 texLength material2 texHeight texWidth texSlope''
 +
<span style="color:gray;font-style:italic">// definicja krzywej beziera</span>
 +
''p1x p1y p1z roll1''
 +
''cv1x cv1y cv1z''
 +
''cv2x cv2y cv2z''
 +
''p2x p2y p2z roll2''
 +
''radius1''
 +
<span style="color:gray;font-style:italic">// opcjonalna druga krzywa beziera tylko dla skrzyżowań i zwrotnic!</span>
 +
''p3x p3y p3z roll3''
 +
''cv3x cv3y cv3z''
 +
''cv4x cv4y cv4z''
 +
''p4x p4y p4z roll4''
 +
''radius2''
 +
<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">optionalparameter2</span> ''value2''
 +
<span style="color:tomato;font-weight:bold">endtrack</span>
  
<span style="color:orange;font-weight:bold">tributary</span> - skrzyżowanie rzek
+
=== Parametry funkcjonalno-wizualne ===
  
<span style="color:orange;font-weight:bold">turn</span> - obrotnica ([[Obrotnica |zobacz, jak zastosować]])
+
{| class="wikitable"
 +
|+ Opis parametrów
 +
! Nazwa
 +
! Znaczenie
 +
{{Szablon:Wspólne_parametry_node}}
 +
|-
 +
| '''type'''
 +
|Określa typ trajektorii.
  
<span style="color:orange;font-weight:bold">table</span> - obrotnica, przesuwnica, wywrotnica
+
Dostępne typy:
 +
* '''normal''' - tor
 +
* '''switch''' - zwrotnica
 +
* '''road''' - droga
 +
* '''cross''' - skrzyżowanie dróg
 +
* '''river''' - rzeka
 +
* '''tributary''' - skrzyżowanie rzek
 +
* '''turn''' - obrotnica ([[Obrotnica |zobacz, jak zastosować]])
 +
* '''table''' - obrotnica, przesuwnica, wywrotnica (nie działa)
 
|-
 
|-
| dlugosc
+
| '''length'''
| Długość odcinka [m].
+
| Długość toru [m].
| Liczba
+
 
| Parametr nieużywany, edytor RSF w to miejsce wpisuje kilometraż punktu 1
+
Parametr nieużywany, aczkolwiek edytor Rainsted w to miejsce wpisuje kilometraż punktu 1.
 
|-
 
|-
| szerokosc
+
| '''trackWidth'''
| Rozstaw szyn lub szerokość drogi/rzeki [m]
+
|
| Liczba
+
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''')
 
|-
 
|-
| tarcie
+
| '''friction'''
 
| Statyczny współczynnik tarcia.
 
| Statyczny współczynnik tarcia.
| Liczba
 
|
 
 
|-
 
|-
| stukot
+
| '''soundDistance'''
| Co ile metrów odgrywany będzie dźwięk stukotu.
+
| Odległość powtarzania dźwięku stukotu kół na stykach.
| Liczba
+
 
|
+
Dla toru bezstykowego należy podać wartość 0.
 
|-
 
|-
| jakosc
+
| '''qualityFlag'''
 
| Ile ton/oś (?).
 
| Ile ton/oś (?).
| Liczba
 
|
 
 
|-
 
|-
| uszkodzenia
+
| '''damageFlag'''
| Flaga bitowa uszkodzeń.
+
| Poziom uszkodzeń toru w formie maski bitowej.  
| Liczba
+
* 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:
 +
 
 +
{| class="wikitable"
 +
|+ Opis parametrów
 +
! Nazwa
 +
! Znaczenie
 
|-
 
|-
| środowisko
+
| '''material1'''
| Środowisko, w jakim znajduje się tor.
+
| Ścieżka do materiału numer 1.
| Słowo kluczowe
 
| Należy podać słowo kluczowe:
 
  
<span style="color:orange;font-weight:bold">flat</span> - tor na otwartym terenie.
+
Określa [[Materiały - Pliki .mat|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''')
  
<span style="color:orange;font-weight:bold">mountains</span>/<span style="color:orange;font-weight:bold">mountain</span> - tor w górach.
+
Jeśli jako materiał szyn podano '''none''', to szyny staną się niewidoczne.
 +
|-
 +
| '''texLength'''
 +
| 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.
  
<span style="color:orange;font-weight:bold">canyon</span> - tor w wykopie.
+
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]].
 +
|-
 +
| '''material2'''
 +
| Ścieżka do materiału numer 2.
  
<span style="color:orange;font-weight:bold">tunnel</span> - tor w tunelu.
+
Określa [[Materiały - Pliki .mat|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''')
  
<span style="color:orange;font-weight:bold">bridge</span> - tor na moście/wiadukcie.
+
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''')
  
<span style="color:orange;font-weight:bold">bank</span> - ?
+
Dla typu '''switch''' parametr nie ma znaczenia.
  
W zależności od środowiska zmienia się echo dźwięków.
+
W przypadku dróg podanie ujemnej wartości włączy generowanie chodników.
 
|-
 
|-
| widocznosc
+
| '''texWidth'''
| Widoczność toru.
+
|  
| Słowo kluczowe
+
* odległość od szyny do początku skosu podsypki (dla typów '''normal, turn, table''')
| Należy podać słowo kluczowe:
+
* 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''')
  
<span style="color:orange;font-weight:bold">unvis</span>/<span style="color:orange;font-weight:bold">novis</span> - tor niewidoczny
+
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''')
  
<span style="color:orange;font-weight:bold">vis</span> - tor widoczny
+
Dla typu '''switch''' parametr nie ma znaczenia
 
|}
 
|}
  
=== track, road, river, turn, table ===
+
=== Geometria toru ===
    <span style="color:green;font-weight:bold;">node</span> -1 0 none <span style="color:tomato;font-weight:bold">track</span> ''typ dlugosc szerokosc tarcie stukot jakosc uszkodzenia srodowisko widocznosc''
+
Geometria toru opisana jest za pomocą krzywej Beziera.
    ''tekstura1 powtarzanie_tekstury tekstura2 wysokosc_pods szerokosc_pods szerokosc_pochylenia''
+
Odcinki trajektorii niebędące skrzyżowaniami lub zwrotnicami definiują tylko jedną krzywą.
    ''p1x p1y p1z przechylka1''
 
    ''cv1x cv1y cv1z''
 
    ''cv2x cv2y cv2z''
 
    ''p2x p2y p2z przechylka2''
 
    ''promien''
 
    ''parametry_opcjonalne''
 
    <span style="color:tomato;font-weight:bold">endtrack</span>
 
  
 
{| class="wikitable"
 
{| class="wikitable"
 
|+ Opis parametrów
 
|+ Opis parametrów
! Nazwa parametru
+
! Nazwa
! Znaczenie parametru
+
! Znaczenie
! Typ wartości
 
! Uwagi
 
 
|-
 
|-
| tekstura1
+
| '''p1x p1y p1z'''
| Tekstura szyn, nawierzchni drogi lub rzeki
+
| Współrzędne punktu P1.
| Tekst
+
|-
|  
+
| '''roll1'''
 +
| Kąt przechyłki w punkcie P1
 +
|-
 +
| '''cv1x cv1y cv1z'''
 +
| Współrzędne punktu kontrolnego CV1 (względem P1).
 
|-
 
|-
| powtarzanie_tekstury
+
| '''cv2x cv2y cv2z'''
| Odległość powtarzania mapowania teksturą ''tekstura1'' [m]
+
| Współrzędne punktu kontrolnego CV (względem P2).
| Liczba
 
|
 
 
|-
 
|-
| tekstura2
+
| '''p2x p2y p2z'''
| Tekstura podsypki, pobocza drogi lub brzegu rzeki
+
| Współrzędne punktu P2.
| Tekst
 
|
 
 
|-
 
|-
| wysokosc_pods
+
| '''roll2'''
| Wysokość podsypki, pobocza drogi lub brzegów rzeki [m].
+
| Kąt przechyłki w punkcie P2
| Liczba
 
| W przypadku drogi wpisanie ujemnej wartości stworzy chodnik.
 
 
|-
 
|-
| szerokosc_pods
+
| '''radius1'''
| Odległość od szyny do początku obszaru pochylenia podsypki. W przypadku drogi szerokość pobocza [m].
+
| Wartość promienia łuku dla pierwszej krzywej - wartość nieużywana.
| Liczba
+
|}
|
+
 
 +
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ą.
 +
 
 +
{| class="wikitable"
 +
|+ Opis parametrów
 +
! Nazwa
 +
! Znaczenie
 
|-
 
|-
| szerokosc_pochylenia
+
| '''p3x p3y p3z'''
| Szerokość obszaru pochylenia podsypki, pobocza drogi lub brzegu rzeki [m].
+
| Współrzędne punktu P3.
| Liczba
 
|
 
 
|-
 
|-
| p1x, p1y, p1z
+
| '''roll3'''
| Współrzędne punktu 1 toru.
+
| Kąt przechyłki w punkcie P3
| Liczby
 
|
 
 
|-
 
|-
| przechylka1
+
| '''cv3x cv3y cv3z'''
| Przechyłka w punkcie 1 toru [deg].
+
| Współrzędne punktu kontrolnego CV3 (względem P3).
| Liczba
 
|
 
 
|-
 
|-
| cv1x, cv1y, cv1z, cv2x, cv2y, cv2z
+
| '''cv4x cv4y cv4z'''
| Współrzędne punktów kontrolnych
+
| Współrzędne punktu kontrolnego CV4 (względem P4).
| Liczby
 
| Zobacz: [https://pl.wikipedia.org/wiki/Krzywa_B%C3%A9ziera krzywa Beziera]
 
 
|-
 
|-
| p2x, p2y, p2z
+
| '''p4x p4y p4z'''
| Współrzędne punktu 2 toru.
+
| Współrzędne punktu P4.
| Liczby
 
|
 
 
|-
 
|-
| przechylka2
+
| '''roll4'''
| Przechyłka w punkcie 2 toru [deg].
+
| Kąt przechyłki w punkcie P4
| Liczba
 
|
 
 
|-
 
|-
| promien
+
| '''radius2'''
| Promień łuku [m].
+
| Wartość promienia łuku dla drugiej krzywej - wartość nieużywana.
| Liczba
 
| Dla toru prostego = 0
 
 
|}
 
|}
  
=== switch ===
+
=== Parametry opcjonalne ===
    <span style="color:green;font-weight:bold;">node</span> -1 0 none <span style="color:tomato;font-weight:bold">track</span> <span style="color:orange;font-weight:bold">switch</span> ''dlugosc szerokosc tarcie stukot jakosc uszkodzenia srodowisko widocznosc''
+
Parametry opcjonalne zapisane są na samym końcu wpisu, między definicjami krzywych a słowem kluczowym ''endtrack''.
    ''tekstura1 powtarzanie_tekstury tekstura2 odstep_iglicy dlugosc_odbojnicy odleglosc_odbojnicy''
+
Zapisuje się je w postaci klucz-wartość, tak jak w poniższym przykładzie.
    ''p1x p1y p1z przechylka1''
 
    ''cv1x cv1y cv1z''
 
    ''cv2x cv2y cv2z''
 
    ''p2x p2y p2z przechylka2''
 
    ''promien''
 
    ''p3x p3y p3z przechylka3''
 
    ''cv3x cv3y cv3z''
 
    ''cv4x cv4y cv4z''
 
    ''p4x p4y p4z przechylka4''
 
    ''promien''
 
    ''parametry_opcjonalne''
 
    <span style="color:tomato;font-weight:bold">endtrack</span>
 
  
 +
...
 +
<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:
 
{| class="wikitable"
 
{| class="wikitable"
 
|+ Opis parametrów
 
|+ Opis parametrów
! Nazwa parametru
+
! Nazwa
! Znaczenie parametru
+
! Znaczenie
! Typ wartości
 
! Uwagi
 
 
|-
 
|-
| tekstura1
+
| '''velocity'''
| Tekstura szyn toru zasadniczego.
+
| Definiuje maksymalną prędkość [km/h], jakiej pojazd prowadzony przez AI będzie starał się nie przekroczyć.
| Tekst
 
|
 
 
|-
 
|-
| powtarzanie_tekstury
+
| '''isolated'''
| Odległość powtarzania mapowania teksturą ''tekstura1'' [m].
+
| 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)
| Liczba
 
|
 
 
|-
 
|-
| tekstura2
+
| '''overhead'''
| Tekstura szyn toru zwrotnego.
+
| Określa jak ma zachować się AI podczas jazdy pod siecią trakcyjną na tym torze.
| Tekst
+
* 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
 
|-
 
|-
| odstep_iglicy
+
| '''railprofile'''
| Odstęp iglicy od szyny [m].
+
| Nazwa pliku z definicją profilu szyny (relatywna do katalogu ''models'', bez rozszerzenia).
| Liczba
+
|-
|
+
|'''trackbed'''
 +
| 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 pobrany z jednego z torów sąsiadujących z rozjazdem.
 
|-
 
|-
| dlugosc_odbojnicy
+
| '''friction'''
| Długość odbojnicy [m].
+
| Nazwa [[Obiekt node::memcell|komórki pamięci]] modyfikującej parametr tarcia w torze.  
| Liczba
+
Działa zgodnie z wzorem:
|
+
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]]
 
|-
 
|-
| odleglosc_odbojnicy
+
| '''event0'''
| Odległość środka odbojnicy od końca rozjazdu [m].
+
| Nazwa [[Obiekt event|eventu]], który zostanie uruchomiony gdy obsadzony pojazd stoi na torze.
| Liczba
 
|
 
 
|-
 
|-
| p1x, p1y, p1z
+
| '''event1'''
| Współrzędne punktu 1 toru zasadniczego.
+
| 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.
| Liczby
 
|
 
 
|-
 
|-
| przechylka1
+
| '''event2'''
| Przechyłka w punkcie 1 toru zasadniczego [deg].
+
| 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.
| Liczba
 
|
 
 
|-
 
|-
| cv1x, cv1y, cv1z, cv2x, cv2y, cv2z
+
| '''eventall0'''
| Współrzędne punktów kontrolnych toru zasadniczego.
+
| Nazwa [[Obiekt event|eventu]], który zostanie uruchomiony gdy jakikolwiek pojazd stoi na torze.
| Liczby
 
| Zobacz: [https://pl.wikipedia.org/wiki/Krzywa_B%C3%A9ziera krzywa Beziera]
 
 
|-
 
|-
| p2x, p2y, p2z
+
| '''eventall1'''
| Współrzędne punktu 2 toru zasadniczego.
+
| Nazwa [[Obiekt event|eventu]], który zostanie uruchomiony gdy jakikolwiek pojazd wjedzie na tor w kierunku punktu P1.
| Liczby
 
|
 
 
|-
 
|-
| przechylka2
+
| '''eventall2'''
| Przechyłka w punkcie 2 toru zasadniczego [deg].
+
| Nazwa [[Obiekt event|eventu]], który zostanie uruchomiony gdy jakikolwiek pojazd wjedzie na tor w kierunku punktu P2.
| Liczba
 
|
 
|-
 
| promien
 
| Promień łuku toru zasadniczego[m].
 
| Liczba
 
| Dla toru prostego = 0.
 
|-
 
| p3x, p3y, p3z
 
| Współrzędne punktu 3 (początek toru zwrotnego).
 
| Liczby
 
|
 
 
|-
 
|-
| przechylka1
+
| '''vradius'''
| Przechyłka w punkcie 3 toru (na początku toru zwrotnego) [deg].
+
| Określa informację o promieniu łuku pionowego [m]
| Liczba
 
|
 
 
|-
 
|-
| cv3x, cv3y, cv3z, cv4x, cv4y, cv4z
+
| <del>'''angle1'''</del>
| Współrzędne punktów kontrolnych toru zwrotnego.
+
| <del>Kąt ścięcia podsypki/drogi/rzeki w punkcie P1 [deg]</del>
| Liczby
 
| Zobacz: [https://pl.wikipedia.org/wiki/Krzywa_B%C3%A9ziera krzywa Beziera]
 
 
|-
 
|-
| p4x, p4y, p4z
+
| <del>'''angle2'''</del>
| Współrzędne punktu 4 (końca toru zwrotnego).
+
| <del>Kąt ścięcia podsypki/drogi/rzeki w punkcie P2 [deg]</del>
| Liczby
 
|
 
 
|-
 
|-
| przechylka2
+
| <del>'''fouling1'''</del>
| Przechyłka w punkcie 4 (na końcu toru zwrotnego) [deg].
+
| <del>Model ukresu w kierunku 1</del>
| Liczba
 
|
 
 
|-
 
|-
| promien
+
| <del>'''fouling2'''</del>
| Promień łuku toru zwrotnego [m].
+
| <del>Model ukresu w kierunku 2</del>
| Liczba
+
|}  
|  
 
|}
 
  
=== cross, tributary ===
+
[[Kategoria:Scenerie]]
    <span style="color:green;font-weight:bold;">node</span> -1 0 none <span style="color:tomato;font-weight:bold">track</span> ''typ dlugosc szerokosc tarcie stukot jakosc uszkodzenia srodowisko widocznosc''
 
    ''tekstura1 powtarzanie_tekstury tekstura2 wysokosc_pods szerokosc_pods szerokosc_pochylenia''
 
    ''p1x p1y p1z przechylka1''
 
    ''cv1x cv1y cv1z''
 
    ''cv2x cv2y cv2z''
 
    ''p2x p2y p2z przechylka2''
 
    ''promien''
 
    ''p3x p3y p3z przechylka3''
 
    ''cv3x cv3y cv3z''
 
    ''cv4x cv4y cv4z''
 
    ''p4x p4y p4z przechylka4''
 
    ''promien''
 
    ''parametry_opcjonalne''
 
    <span style="color:tomato;font-weight:bold">endtrack</span>
 
 
 
* '''tekstura1''' - tekstura drogi.
 
* '''powtarzanie_tekstury''' - co ile metrów powtarzać mapowanie teksturą ''tekstura1''.
 
* '''tekstura2''' - tekstura pobocza drogi.
 
* '''wysokosc_pods''' - wysokość rysowanej drogi [m]. Wpisanie ujemnej wartości stworzy chodnik o takiej wysokości.
 
* '''szerokosc_pods''' - ?
 
* '''szerokosc_pochylenia''' - szerokość rysowanej podsypki, drogi, rzeki w obszarze pochylenia [m].
 
* '''p1x, p1y, p1z''' - współrzędne punktu 1 skrzyżowania w przestrzeni 3D.
 
* '''przechylka1''' - przechyłka w punkcie 1 skrzyżowania [deg].
 
* '''cv1x, cv1y, cv1z, cv2x, cv2y, cv2z''' - współrzędne punktów kontrolnych w przestrzeni 3D (zobacz: [https://pl.wikipedia.org/wiki/Krzywa_B%C3%A9ziera krzywa Beziera])
 
* '''p2x, p2y, p2z''' - współrzędne punktu 2 skrzyżowania w przestrzeni 3D.
 
* '''przechylka2''' - przechyłka w punkcie 2 skrzyżowania [deg].
 
* '''promien''' - promień łuku [m]. Dla drogi prostej = 0.
 
* '''p3x, p3y, p3z''' - współrzędne punktu 3 skrzyżowania w przestrzeni 3D.
 
* '''przechylka3''' - przechyłka w punkcie 3 skrzyżowania [deg].
 
* '''cv3x, cv3y, cv3z, cv4x, cv4y, cv4z''' - współrzędne punktów kontrolnych w przestrzeni 3D (zobacz: [https://pl.wikipedia.org/wiki/Krzywa_B%C3%A9ziera krzywa Beziera])
 
* '''p4x, p4y, p4z''' - współrzędne punktu 4 skrzyżowania w przestrzeni 3D.
 
* '''przechylka4''' - przechyłka w punkcie 4 skrzyżowania [deg].
 
* '''promien''' - promień łuku [m]. Dla drogi prostej = 0.
 
 
 
Skrzyżowanie może łączyć trzy drogi zamiast czterech (gdy punkt 3 == punkt 1). '''Uwaga! Skrzyżowania nie są jeszcze w pełni funkcjonalne - samochody mają problem z ich pokonywaniem.'''
 
 
 
=== Parametry opcjonalne ===
 
    <span style="color:orange;font-weight:bold">velocity</span> predkosc <span style="color:gray">// Maksymalna prędkość, z jaką AI przejedzie po tym torze.</span>
 
    <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 od strony 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 od strony 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 od strony 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 od strony punktu 2.</span>
 
    <span style="color:orange;font-weight:bold">isolated</span> nazwa_odcinka_izolowanego <span style="color:gray">//</span>
 
    <span style="color:orange;font-weight:bold">overhead</span> stan_jazdy_bezpradowej <span style="color:gray">//</span>
 
    <span style="color:orange;font-weight:bold">colides</span> ? <span style="color:gray">//</span>
 
    <span style="color:orange;font-weight:bold">angle1</span> kat1 <span style="color:gray">//</span>
 
    <span style="color:orange;font-weight:bold">angle2</span> kat2 <span style="color:gray">//</span>
 
    <span style="color:orange;font-weight:bold">fouling1</span> ukres1 <span style="color:gray">//</span>
 
    <span style="color:orange;font-weight:bold">fouling2</span> ukres2 <span style="color:gray">//</span>
 

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