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 

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 name type

• node - słowo kluczowe.
• 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.
• name - nazwa obiektu, służy do identyfikacji konkretnego obiektu w scenerii, np. przy wstawianiu składu na tor.
• type - 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 parametr 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

• opcja - jedna z opcji eu07.ini.
• wartosc - wartość dla opcji.

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 (trainset).

   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.

origin

Przesuwa obiekty o wektor.

rotate

Obraca obiekty.

sky

Definiuje model nieba w scenerii.

test

Służy do testowania poprawności wpisów.

time

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

trainset

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