Obiekt node::track
Definiuje odcinek trajektorii ruchu: drogi, tory, rzeki.
Spis treści
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 clatter_distance quality_flag damage_flag environment visibility map1 map1_length map2 profile_parameter1 profile_parameter2 profile_parameter3 // 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
| Nazwa | Znaczenie |
|---|---|
| type | Określa typ trajektorii.
Dostępne typy:
|
| length | Długość toru [m].
Parametr nieużywany, aczkolwiek edytor Rainsted w to miejsce wpisuje kilometraż punktu 1. |
| width |
Definiuje:
|
| friction | Statyczny współczynnik tarcia. |
| clatter_distance | Odległość powtarzania dźwięku stukotu kół na stykach.
Dla toru bezstykowego należy podać wartość 0. |
| quality_flag | Ile ton/oś (?). |
| damage_flag | Poziom uszkodzeń toru w formie maski bitowej.
|
| environment | Środowisko w jakim znajduje się trajektoria.
W zależności od środowiska zmienia się echo dźwięków.
|
| visibility | Widoczność trajektorii.
|
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ąć:
| Nazwa | Znaczenie |
|---|---|
| map1 | Ścieżka do materiału numer 1.
Określa materiał:
Jeśli jako teksturę szyn podano none, to szyny staną się niewidoczne. |
| map1_length | Odległość na jakiej ma rozkładać się materiał map1, innymi słowy co ile metrów ma nastąpić kafelkowanie materiału.
Jeśli materiał podany w map1 definiuje parametr size, to wartość z wpisu jest nadpisywana wartością z materiału. |
| map2 | Ścieżka do materiału numer 2.
Określa materiał:
Jeśli jako teksturę szyn podano none, to szyny staną się niewidoczne |
| profile_parameter1 |
W przypadku dróg podanie ujemnej wartości włączy generowanie chodników. |
| profile_parameter2 |
|
| profile_parameter3 |
|
Geometria toru
Geometria toru opisana jest za pomocą krzywej Beziera. Odcinki trajektorii niebędące skrzyżowaniami lub zwrotnicami definiują tylko jedną krzywą.
| 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. |
| cv2x cv2y cv2z | Współrzędne punktu kontrolnego CV2. |
| 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.
| 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. |
| cv4x cv4y cv4z | Współrzędne punktu kontrolnego CV4. |
| 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:
| 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. |
| overhead | Określa jak ma zachować się AI podczas jazdy pod siecią trakcyjną na tym torze.
|
| 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. |
| event2 | Nazwa eventu, który zostanie uruchomiony gdy obsadzony pojazd wjedzie na tor w kierunku punktu P2. |
| 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. |
| |
|
| |
|
| |
|
| |
|
| |
|
