Plik scenerii

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 

Uwaga: Układ osi w symulatorze różni się od tego używanego na codzień:

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ą.

Można używać komentarzy liniowych:

    // komentarz liniowy

a także komentarzy blokowych:

    
    /* to jest
    komentarz który
    zajmuje dużo
    linii */
    

atmo

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

    atmo kolor_nieba poczatek_mgly koniec_mgly kolor_mgly endatmo

Opis parametrów

Nazwa parametru	Znaczenie parametru	Typ wartości
kolor_nieba	Opisuje kolor nieba.	3 liczby z zakresu <0;255> (RGB)
poczatek_mgly	Odległość początku mgły od kamery [m].	Liczba
koniec_mgly	Odległość końca mgły od kamery [m].	Liczba
kolor_mgly	Opisuje kolor mgły.	3 liczby z zakresu <0;255> (RGB)

camera

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

   camera x y z rx ry rz numer endcamera

Opis parametrów

Nazwa parametru	Znaczenie parametru	Typ wartości
x y z	Współrzędne kamery.	Liczby
rx ry rz	Obrót kamery w trzech osiach.	Liczby
numer	Określa, po kliknięciu jakiego klawisza (numerycznego) ma nastąpić teleportacja do kamery. Jeśli nie zostanie podany, kamera będzie dostępna pod pierwszym niezajętym klawiszem.	Liczba z zakresu <0;9>

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

Opis parametrów

Nazwa parametru	Znaczenie parametru	Typ wartości
opcja	Jedna z opcji eu07.ini.	Tekst
wartosc	Wartość dla opcji.	Zależny od opcji

description

Definiuje opis scenerii. Wpis stworzony z myślą o starterach, ale nie jest przez nie interpretowany. Zobacz, jak opisywać scenerię na potrzeby startera RAINSTED.

    description opis_scenerii enddescription

Opis parametrów

Nazwa parametru	Znaczenie parametru	Typ wartości
opis_scenerii	Opis scenerii.	Tekst

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
   definicje_pojazdow

Opis parametrów

Nazwa parametru	Znaczenie parametru	Typ wartości
definicje_pojazdow	Dowolna ilość definicji pojazdów.	Wpisy trainset lub node::dynamic

include

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

    include plik parametry end

Opis parametrów

Nazwa parametru	Znaczenie parametru	Typ wartości
plik	Ścieżka do pliku, którego zawartość ma być dołączona do scenerii (relatywna względem folderu scenery).	Tekst
parametry	N wartości, które zostaną podstawione w miejsce zmiennych (p1) - (pN) w pliku INC.	Zależny od miejsca występowania zmiennych

light

Definiuje parametry oświetlenia scenerii.

    light x y z ambient diffuse specular endlight

Opis parametrów

Nazwa parametru	Znaczenie parametru	Typ wartości
x y z	Współrzędne światła.	Liczby
ambient	?	3 liczby z zakresu <0;1> (RGB)
diffuse	?	3 liczby z zakresu <0;1> (RGB)
specular	?	3 liczby z zakresu <0;1> (RGB)

lua

Umożliwia dołączenie skryptu LUA sterującego przebiegiem scenariusza. Uwaga! Skrypty LUA są w fazie eksperymentów! Przeczytaj dokumentację API

   lua plik

Opis parametrów

Nazwa parametru	Znaczenie parametru	Typ wartości
plik	Ścieżka do pliku ze skryptem.	Tekst

node

Definiuje obiekty różnych typów. Dowiedz się więcej

origin

Przesuwa obiekty o wektor.

    origin x y z
    wpisy 
    endorigin

Opis parametrów

Nazwa parametru	Znaczenie parametru	Typ wartości
x y z	Współrzędne wektora przesunięcia.	Liczby
wpisy	Wpisy definiujące np. modele, części scenerii, które zostaną przesunięte o podany wektor.	Dowolny typ wpisu.

rotate

Obraca obiekty.

   rotate rx ry rz
   wpisy
   rotate 0 0 0

Opis parametrów

Nazwa parametru	Znaczenie parametru	Typ wartości
rx ry rz	Opisuje rotację w trzech osiach.	Liczby
wpisy	Wpisy definiujące np. modele, części scenerii, które zostaną obrócone.	Dowolny typ wpisu.

sky

Definiuje model nieba w scenerii.

    sky model_nieba endsky

Opis parametrów

Nazwa parametru	Znaczenie parametru	Typ wartości
model_nieba	Ścieżka do pliku modelu nieba (relatywna względem folderu models).	Tekst

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

Opis parametrów

Nazwa parametru	Znaczenie parametru	Typ wartości
wpisy	Wpisy definiujące np. modele, części scenerii, które mają zostać poddane testom.	Dowolny typ wpisu.

time

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

   time czas_na_starce czas_wschodu czas_zachodu endtime

Opis parametrów

Nazwa parametru	Znaczenie parametru	Typ wartości	Uwagi
czas_na_starcie	Czas symulacji w momencie jej startu.	Czas w formacie hh:mm
czas_wschodu	Godzina wschodu słońca.	Czas w formacie hh:mm	Parametr ignorowany
czas_zachodu	Godzina zachodu słońca.	Czas w formacie hh:mm	Parametr ignorowany

trainset

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

   trainset rozklad nazwa_toru odleglosc predkosc 
   wpisy_dynamic
   endtrainset

Opis parametrów

Nazwa parametru	Znaczenie parametru	Typ wartości
rozklad	Ścieżka do pliku z rozkładem (relatywna względem folderu scenery).	Tekst
nazwa_toru	Nazwa obiektu node::track na którym ma stanąć skład.	Tekst
odleglosc	Odległość składu od punktu 1 toru, na którym stoi [m].	Liczba
wpisy_dynamic	Dowolna liczba wpisów definiujących pojazd.	Wpisy node::dynamic