Plik scenerii

Z MaSzyna
Skocz do: nawigacja, szukaj

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ń:

Swspol.png

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