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)

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

• model_nieba - ścieżka do pliku modelu nieba, relatywna względem folderu models.

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

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

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

• czas_na_starcie - czas symulacji w momencie jej startu w formacie hh:mm
• czas_wschodu - godzina wschodu słońca w formacie hh:mm (nieobsługiwane przez symulator)
• czas_zachodu - godzina zachodu słońca w formacie hh:mm (nieobsługiwane przez symulator)

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.