Plik scenerii: Różnice pomiędzy wersjami

Wersja z 12:45, 2 wrz 2017

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

atmo

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

    atmo kolor_nieba poczatek_mgly koniec_mgly kolor_mgly endatmo

camera

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

   camera x y z rx ry rz numer endcamera

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. Zobacz, jak opisywać scenerię na potrzeby startera RAINSTED.

    description opis_scenerii enddescription

event

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

FirstInit

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

   FirstInit
   definicje_pojazdow

include

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

    include plik parametry end

light

Definiuje parametry oświetlenia scenerii.

    light x y z ambient diffuse specular endlight

lua

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

   lua plik

node

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

origin

Przesuwa obiekty o wektor.

    origin x y z
    wpisy 
    endorigin

rotate

Obraca obiekty.

   rotate rx ry rz
   wpisy
   rotate 0 0 0

sky

Definiuje model nieba w scenerii.

    sky model_nieba endsky

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

time

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

   time czas_na_starcie czas_wschodu czas_zachodu endtime

trainset

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

   trainset rozklad nazwa_toru odleglosc predkosc 
   wpisy_dynamic
   endtrainset