Obiekt node: Różnice pomiędzy wersjami

Wersja z 10:00, 31 sie 2017

Każdy wpis node zaczyna się od preambuły:

   node max_distance min_distance nazwa typ

max_distance - liczba określająca maksymalną odległość, z jakiej obiekt jest widoczny (-1 oznacza brak ograniczenia widoczności).
min_distance - liczba określająca minimalną odległość, z jakiej obiekt jest widoczny.
nazwa - nazwa obiektu, służy do identyfikacji konkretnego obiektu w scenerii, np. przy wstawianiu składu na tor.
typ - typ obiektu. Dostępne typy opisane są poniżej.

dynamic

Wstawia do scenerii pojazd.

    node -1 0 none dynamic folder tekstura fizyka tor odleglosc obsada predkosc sprzeg ilosc_ladunku ladunek destination miejsce_docelowe enddynamic

folder - ścieżka do katalogu zawierającego model pojazdu do wstawienia, relatywna względem folderu dynamic.
tekstura - plik tekstury z katalogu folder, którym ma być oteksturowany model (bez rozszerzenia).
fizyka - plik charakterystyki z katalogu folder (bez rozszerzenia). Określa jaki model pojazdu zostanie użyty (np. 303E).
tor - tylko jeśli wpis nie jest częścią trainset. Należy wpisać nazwę obiektu node::track, na którym ma stanąć pojazd.
odleglosc - tylko jeśli wpis nie jest częścią trainset. Należy podać odległość pojazdu od punktu 1 obiektu node::track [m].
obsada - stan obsadzenia pojazdu. Dostępne typy:
- headdriver - obsada w kabinie nr 1.
- reardriver - obsada w kabinie nr 2.
- nobody - brak obsady.
- passenger - jazda w wagonie jako pasażer. Uwaga! Nie każdy wagon posiada taką możliwość!
- connected
predkosc - tylko jeśli wpis nie jest częścią trainset. Określa prędkość początkową pojazdu [km/h].
sprzęg - tylko jeśli wpis JEST częścią trainset. Określa flagę sprzęgu łączącego z następnikiem.
- 1 - hak
- 2 - przewód hamulcowy
- 4 - przewód ukrotnienia
- 8 - przewód wysokiego napięcia
- 16 - mostek przejściowy
- 32 - przewód powietrzny 8 atmosfer
- 64 - przewód ogrzewania
- 128 - blokada

Aby otrzymać liczbę reprezentującą określony sposób sprzęgnięcia, należy zsumować liczby symbolizujące podłączenie interesujących nas elementów. Dla przykładu, aby otrzymać liczbę oznaczającą podłączenie haka, przewodu hamulcowego i ogrzewania dodajemy do siebie liczby 1 (podpięty hak), 2 (podpięty przewód hamulcowy) i 64 (podpięty przewód ogrzewania). Daje to liczbę 67.

ilosc_ladunku - ilość ładunku w pojeździe. [jednostka zależna od wpisu w pliku charakterystyki]
ladunek - tylko jeśli ilosc_ladunku > 0. Określa nazwę ładunku.
miejsce_docelowe - dla wagonów jest to stacja docelowa. Informacja taka umożliwi wykonywanie automatycznych manewrów przez AI (łączenie i rozłączanie składów, obsługa górki rozrządowej). Jeśli nie zostanie to wyszczególnione we wpisie, miejsce docelowe zostanie określone po przypisaniu rozkładu jazdy.

eventlauncher

Definiuje wyzwalacz zdarzeń.

    node -1 0 none eventlauncher x y z odleglosc klawisz czas zdarzenie1 zdarzenie2 komorka_pamieci parametry_komorki end

x, y, z współrzędne wyzwalacza w przestrzeni 3D.
odleglosc - maksymalna odległość obserwatora od obiektu, -1 oznacza brak sprawdzania odległości. [m]
klawisz:
- kod klawisza wyzwalającego zdarzenie (tylko litery),
- brak reakcji na klawisze - słowo kluczowe none
czas:
- czas wyzwolenia zdarzenia - godzina w formacie hh:mm.
- okresowość wyzwalania - ilość czasu ze znakiem minus [s].
- brak reakcji czasowej - liczba 0.
zdarzenie1 - zdarzenie wyzwalane przy naciśnięciu klawisza gdy SHIFT nie jest naciśnięty albo gdy upłynął określony czas
zdarzenie2 - Event2: zdarzenie wyzwalane przy naciśnięciu klawisza gdy SHIFT jest naciśnięty opcjonalnie, po słowie condition
komorka_pamieci - nazwa komórki pamięci
parametry_komorki - wartości którym się muszą równać wartości komórki pamięciowej żeby zdarzenia zostały wysłane do kolejkowania.

lines

Definiuje linie.

    node -1 0 none lines kolor grubosc
    px py pz kx ky kz
    ...
    endlines

kolor - 3 liczby z zakresu <0-255> (RGB) opisujące kolor linii.
grubosc - grubość linii [mm].
px py pz kx ky kz - współrzędne początku i końca linii w przestrzeni 3D. Może wystąpić ich dowolna parzysta ilość.

line_strip

Definiuje linię łamaną.

    node -1 0 none line_strip kolor grubosc
    x y z
    ...
    endlines

kolor - 3 liczby z zakresu <0-255> (RGB) opisujące kolor linii.
grubosc - grubość linii [mm].
x y z - współrzędne linii w przestrzeni 3D. Może wystąpić ich dowolna ilość.

line_loop

Definiuje linię łamaną zamkniętą.

    node -1 0 none line_loop kolor grubosc
    x y z
    ...
    endlines

kolor - 3 liczby z zakresu <0-255> (RGB) opisujące kolor linii.
grubosc - grubość linii [mm].
x y z - współrzędne linii w przestrzeni 3D. Może wystąpić ich dowolna ilość.

memcell

Definiuje komórkę pamięci.

model

Wstawia do scenerii model w formacie T3D lub E3D.

   node -1 0 none model x y z rz plik_modelu tekstura_wymienna lights stany_swiatel endmodel

x, y, z - współrzędne modelu w przestrzeni 3D.
rz - rotacja w osi Z.
plik_modelu - ścieżka do modelu w formacie T3D lub E3D, relatywna względem folderu models.
tekstura_wymienna - ścieżka do tekstury, którą ma być oteksturowany submodel ze zdefiniowaną teksturą wymienną. Ścieżka relatywna względem folderu textures.
stany_swiatel - w zależności od ilości zdefiniowanych świateł w modelu, znaleźć tu się muszą liczby opisujące ich stan:
- 0 - zgaszone
- 1 - zapalone
- 2 - pulsujące
- 3 - zapalone tylko w nocy

W przypadku braku zdefiniowanych świateł, należy pominąć słowo kluczowe lights.

track

Definiuje odcinek trajektorii ruchu: drogi, tory, rzeki... Znaczenie niektórych parametrów zmienia się w zależności od typu trajektorii. Obsługiwane typy:

normal - tor
switch - rozjazd
turn - obrotnica
table - obrotnica, przesuwnica, wywrotnica
road - droga
cross - skryżowanie dróg
river - rzeka
tributary - skrzyżowanie rzek

track, road, river, turn, table

    node -1 0 none track typ dlugosc szerokosc tarcie stukot jakosc uszkodzenia srodowisko widocznosc
    tekstura1 powtarzanie_tekstury tekstura2 wysokosc_pods szerokosc_pods szerokosc_pochylenia
    x y z przechylka1
    cv1x cv1y cv1z
    cv2x cv2y cv2z
    x y z przechylka2
    promien
    parametry_opcjonalne
    endtrack

switch

    node -1 0 none track switch dlugosc szerokosc tarcie stukot jakosc uszkodzenia srodowisko widocznosc
    tekstura1 powtarzanie_tekstury tekstura2 wysokosc_pods szerokosc_pods szerokosc_pochylenia
    x y z przechylka1
    cv1x cv1y cv1z
    cv2x cv2y cv2z
    x y z przechylka2
    promien
    parametry_opcjonalne
    endtrack

Przykład skrzyżowania

Parametry opcjonalne

    velocity predkosc
    event0 nazwa_eventu
    event1 nazwa_eventu
    event2 nazwa_eventu
    eventall0 nazwa_eventu
    eventall1 nazwa_eventu
    eventall2 nazwa_eventu
    isolated nazwa_odcinka_izolowanego
    overhead stan_jazdy_bezpradowej
    colides ?
    angle1 kat1
    angle2 kat2
    fouling1 ukres1
    fouling2 ukres2

traction

Definiuje odcinek drutu sieci trakcyjnej.

    node -1 0 none traction zrodlo_zasilania napiecie prąd_max opor material grubosc uszkodzenia
    p1x p1y p1z
    p2x p2y p2z
    p3x p3y p3z
    p4x p4y p4z
    wysokosc_min odstep_wieszakow ilosc_przewodow odstep_przewodow widocznosc
    zdarzenie
    endtraction

zrodlo_zasilania - nazwa obiektu node::tractionpowersource, który ma zasilać ten odcinek sieci.
napiecie - napięcie sieci trakcyjnej bez obciążenia [V].
prąd_max - prąd przy którym napięcie w sieci spadłoby o połowę [V].
opor - rezystancja styku ślizgacz-przewód [Ω].
material - materiał, z jakiego wykonany jest drut:
- Cu - miedź
- Al - aluminium
grubosc - grubość drutu [mm].
uszkodzenia - flaga bitowa uszkodzeń:
- 1 - patyna
- 128 - zerwanie
p1x, p1y, p1z - współrzędne punktu będącego początkiem przewodu jezdnego.
p2x, p2y, p2z - współrzędne punktu będącego końcem przewodu jezdnego.
p3x, p3y, p3z - współrzędne punktu będącego początkiem przewodu nośnego.
p4x, p4y, p4z - współrzędne punktu będącego końcem przewodu nośnego.
wysokosc_min - najniższa wysokość górnego przewodu nad dolnym [m].
odstep_wieszakow - odstęp pomiędzy kolejnymi wieszakami [m].
ilosc_przewodow - ilość przewodów (0-jezdny, 1-jezdny+nośny, 2-2 jezdne+nośny, 3-2 jezdne+2 nośne; może się błędnie wyświetlać).
odstep_przewodow - odstęp między przewodami jezdnymi gdy ilosc_przewodow = 3 [m].
widocznosc - widoczność trakcji:
- unvis/novis - niewidoczna
- vis - widoczna
zdarzenie - opcjonalne zdarzenie event, które zostanie uruchomione gdy node::dynamic pobiera prąd z sieci.

tractionpowersource

Definiuje źródło zasilania sieci trakcyjnej.

    node -1 0 none tractionpowersource x y z napiecie czestotliwosc opor napiecie_max czas_restartu1 ilosc_prob_restartu czas_restartu2 rekuperacja end

x, y, z – położenie źródła prądu w przestrzeni 3D.
napiecie – napięcie w sieci trakcyjnej bez obciążenia.
czestotliwosc – częstotliwość prądu.
opor – rezystancja wewnętrzna podstacji.
napiecie_max – prąd przy którym uruchamia się bezpiecznik nadmiarowy szybki.
czas_restartu1 – czas po którym obwód się uruchamia ponownie po przeciążeniu.
ilosc_prob_restaru – ilość prób wznowienia pracy obwodu.
czas_restartu2 – czas po jakim zostanie uruchomiony obwód jeśli zostanie przekroczona ilość wznowień (załączeń bezpiecznika szybkiego).
rekuperacja – czy jest odzysk prądu z sieci:
- recuperation - tak
- norecuperation - nie

triangles

Definiuje trójkąt terenu.

    node -1 0 none triangles material ambient: ambient diffuse: diffuse specular: specular endmaterial tekstura
    x y z nx ny nz u v end
    ...
    endtri

ambient - 3 wartości RGB z zakresu <0;255>, określające kolor materiału.
diffuse - 3 wartości RGB z zakresu <0;255>
specular - 3 wartości RGB z zakresu <0;255>, określające siłę odbłyskiwania światła na trójkącie.
tekstura - ścieżka do pliku tekstury (bez rozszerzenia) relatywna względem folderu textures.
x, y, z - współrzędnie wierzchołka w przestrzeni 3D.
nx, ny, nz - współrzędne wektora normalnego.
u, v - współrzędnie wierzchołka UV w przestrzeni 2D. Określają układ tekstury.

Ilość wierzchołków w tym obiekcie jest nieograniczona, ale musi być wielokrotnością liczby 3.

triangle_strip

Definiuje siatkę trójkątów. Rzadko spotykany, częściej w jego miejsce używany jest lepiej zoptymalizowany node::triangles

triangle_fan