Plik scenerii: Różnice pomiędzy wersjami

Z MaSzyna
Skocz do: nawigacja, szukaj
(light)
Linia 38: Linia 38:
 
     </span>
 
     </span>
  
=== include ===
 
Dołącza do scenerii obiekty z podanego pliku. Może przyjmować opcjonalne parametry.
 
    <span style="color:tomato;font-weight:bold">include</span> ''plik parametry'' <span style="color:tomato;font-weight:bold">end</span>
 
  
{| class="wikitable"
 
|+ 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) - (p''N'') w pliku INC.
 
| Zależny od miejsca występowania zmiennych
 
|}
 
  
=== lua ===
+
 
Umożliwia dołączenie skryptu LUA sterującego przebiegiem scenariusza.
 
Uwaga! Skrypty LUA są w fazie eksperymentów!
 
[[Luascenery|Przeczytaj dokumentację API]]
 
    <span style="color:tomato;font-weight:bold">lua</span> plik
 
{| class="wikitable"
 
|+ Opis parametrów
 
! Nazwa parametru
 
! Znaczenie parametru
 
! Typ wartości
 
|-
 
| plik
 
| Ścieżka do pliku ze skryptem.
 
| Tekst
 
|}
 
  
 
=== node ===
 
=== node ===

Wersja z 16:27, 28 gru 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:

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



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