Plik scenerii

Z MaSzyna
Skocz do: nawigacja, szukaj

Plik scenerii jest plikiem tekstowym, zawierającym definicje obiektów, zdarzeń, pojazdów znajdujących się w scenerii. Aby plik scenerii mógł zostać uruchomiony przez symulator, należy umieścić go bezpośrednio w folderze scenery. Scenerię można uruchomić za pomocą startera, wiersza poleceń lub bezpośrednio przez plik wykonywalny symulatora.

  • Komenda wiersza poleceń, uruchamiająca scenerię scene.scn:
   eu07.exe –s scenery/scene.scn
  • Wpis w eu07.ini, powodujący uruchomienie scene.scn przez plik wykonywalny
   sceneryfile scene.scn 

Rodzaje plików składowych scenerii

Poniższe rodzaje plików nie różnią się składnią, a jedynie pomagają zachować ład w plikach wchodzących w skład scenerii.

  • SCN - główny plik scenerii, zawiera zazwyczaj definicje składów i polecenia include, dołączające obiekty z innego pliku do scenerii.
  • SCM - plik z elementami składowymi scenerii. Zazwyczaj używa się tych plików do podziału obiektów scenerii na tory, drogi, drzewa, wskaźniki...
  • CTR - plik ze zdarzeniami tworzącymi scenariusz
  • INC - plik pozwalający na wstawienie obiektu z parametrami (tekstura wymienna, rotacja w 3 osiach)

Rodzaje wpisów

Parametry obiektów w scenerii mogą być oddzielane

  • spacjami,
  • przecinkami,
  • średnikami,
  • tabulatorami
  • końcami linii.

Jednak dla lepszej czytelności dla człowieka zaleca się oddzielanie ich wyłącznie spacją.

node

Definiuje obiekty różnych typów. 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.

eventlauncher

Definiuje wyzwalacz zdarzeń.

lines

Definiuje linię.

line_strip

Definiuje linię łamaną.

line_loop

Definiuje linię zamkniętą.

memcell

Definiuje komórkę pamięci.

model

Wstawia do scenerii model w formacie t3d.

track

Definiuje odcinek trajektorii ruchu: drogi, tory, rzeki...

traction

Definiuje odcinek sieci trakcyjnej.

tractionpowersource

Definiuje źródło zasilania sieci trakcyjnej.

triangles

Definiuje trójkąt terenu.

triangle_strip

Definiuje siatkę trójkątów.

triangle_fan

Definiuje siatkę trójkątów.

atmo

Definiuje kolor tła scenerii i parametry mgły.

    atmo kolor_nieba poczatek_mgly koniec_mgly kolor_mgly endatmo
  • kolor_nieba - 3 wartości RGB z zakresu <0;1> określające kolor nieba.
  • poczatek_mgly - odległość początku mgły od kamery [m].
  • koniec_mgly - odległość końca mgły od kamery [m].
  • kolor_mgly - 3 wartości RGB z zakresu <0;1> określające kolor mgły.

camera

Definiuje kamerę, do której można się przemieszczać klawiszami numerycznymi.

   camera x y z rx ry rz numer endcamera
  • x, y, z - współrzędne kamery w przestrzeni 3D.
  • rx, ry, rz - obrót kamery w trzech osiach.
  • numer - po kliknięciu jakiego klawisza (numerycznego) ma nastąpić teleportacja do kamery.

config

Definiuje ustawienia eu07.ini specyficzne dla scenerii. Można ustawić dowolną ilość par opcja-wartość. Uwaga! Nie wszystkie opcje są możliwe do ustawienia za pomocą tego wpisu!

   config opcja wartosc ... endconfig

description

Definiuje opis scenerii. Wpis stworzony z myślą o starterach, ale nie jest przez nie interpretowany.

    description opis_scenerii enddescription
  • opis_scenerii - opis scenerii.

event

Definiuje zdarzenia które służą do sterowania obiektami, np. sygnałem na semaforze lub przełożeniem zwrotnicy.

FirstInit

Słowo kluczowe oznaczające początek sekcji w pliku z definicjami składów.

   FirstInit
   wpisy_trainset
   ...
  • wpisy_trainset - dowolna ilość wpisów trainset.

include

Dołącza do scenerii obiekty z podanego pliku. Może przyjmować opcjonalne parametry.

    include plik parametry end
  • plik - ścieżka do pliku, którego zawartość ma być dołączona. Ścieżka relatywna względem folderu scenery.
  • parametry - opcjonalne N parametrów, których wartości podstawione będą w miejsce zmiennych (p1) - (pN) w pliku.

light

Definiuje parametry oświetlenia scenerii.

    light x y z ambient diffuse specular endlight
  • x, y, z - współrzędne światła w przestrzeni 3D.
  • ambient - 3 wartości RGB z zakresu <0;1>
  • diffuse - 3 wartości RGB z zakresu <0;1>
  • specular - 3 wartości RGB z zakresu <0;1>

origin

Przesuwa obiekty o wektor.

    origin x y z
    wpisy 
    endorigin
  • x, y, z - współrzędne wektora przesunięcia w przestrzeni 3D.
  • wpisy - wpisy definiujące np. modele, części scenerii, które zostaną przesunięte o podany wektor.

rotate

Obraca obiekty.

   rotate rx ry rz
   wpisy
   rotate 0 0 0
  • rx, ry, rz - rotacja w trzech osiach.
  • wpisy - wpisy definiujące np. modele, części scenerii, które zostaną obrócone.

sky

Definiuje model nieba w scenerii.

    sky model_nieba endsky
  • model_nieba - ścieżka do pliku modelu nieba w formacie T3D, relatywna względem folderu models.

test

Służy do testowania poprawności wpisów. Wpisy obiektów otoczone tokenami test i endtest nie będą widoczne w scenerii, ale będą kopiowane do logu.

   test 
   wpisy
   endtest
  • wpisy - dowolne rodzaje wpisów SCN do przetestowania.

time

Ustawia czas rozpoczęcia symulacji oraz czas wschodu i zachodu słońca.

   time czas_na_starce czas_wschodu czas_zachodu endtime
  • czas_na_starcie - czas symulacji w momencie jej startu w formacie hh:mm
  • czas_wschodu - godzina wschodu słońca w formacie hh:mm
  • czas_zachodu - godzina zachodu słońca w formacie hh:mm

trainset

Definiuje skład jako zbiór obiektów node::dynamic.

   trainset rozklad nazwa_toru odleglosc predkosc 
   wpisy_dynamic
   endtrainset
  • rozklad - ścieżka do pliku z rozkładem, relatywna względem folderu scenery.
  • nazwa_toru - nazwa obiektu node::track na którym ma stanąć skład.
  • odległość - odległość składu od punktu 1 toru, na którym stoi [m].
  • predkosc - prędkość początkowa składu [km/h].
  • wpisy_dynamic - dowolna liczba wpisów node::dynamic.