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 jest następujący:

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 */
    

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_starcie 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