Plik scenerii: Różnice pomiędzy wersjami

Z MaSzyna
Skocz do: nawigacja, szukaj
(Rodzaje wpisów)
(Składnia)
Linia 21: Linia 21:
 
== Składnia ==
 
== Składnia ==
 
Scenerię konfiguruje się za pomocą dyrektyw:
 
Scenerię konfiguruje się za pomocą dyrektyw:
* [[Dyrektywa_atmo|atmo]] - ustawienia mgły
+
* [[Dyrektywa_atmo|atmo]] - ustawienia mgły.
 
* [[Dyrektywa_camera|camera]] - ustawienia predefiniowanych pozycji kamer w trybie ''freefly''.
 
* [[Dyrektywa_camera|camera]] - ustawienia predefiniowanych pozycji kamer w trybie ''freefly''.
* [[Dyrektywa_config|config]] - ustawienia aplikacji specyficzne dla scenerii
+
* [[Dyrektywa_config|config]] - ustawienia aplikacji specyficzne dla scenerii.
* <s>[[Dyrektywa_description|description]] - opis scenerii na potrzeby starterów</s>
+
* <s>[[Dyrektywa_description|description]] - opis scenerii na potrzeby starterów.</s>
 +
* [[Dyrektywa_event|event]] - zdarzenie, np. polecenie zmiany sygnału na semaforze.
 +
* [[Dyrektywa_FirstInit|FirstInit]] - polecenie inicjalizacji wczytanych obiektów.
 +
* [[Dyrektywa_include|include]] - dołączanie zawartości innych plików do pliku scenerii.
 +
* <s>[[Dyrektywa_light|light]] - ustawienie źródła oświetlenia scenerii.</s>
 +
* [[Dyrektywa_lua|lua]] - dołączenie skryptu sterującego scenariuszem w języku LUA.
 +
* [[Obiekt_node|node]] - definicja obiektów widocznych: tory, rzeki, modele.
 +
* [[Dyrektywa_origin|origin]] - polecenie przesunięcia obiektów o wektor.
 +
* [[Dyrektywa_rotate|rotate]] - polecenie obrotu obiektów o kąty.
 +
* [[Dyrektywa_sky|sky]] - ustawienie modelu nieba.
 +
* <s>[[Dyrektywa_test|test]] - testowanie poprawności dyrektyw.</s>
 +
* [[Dyrektywa_time|time]] - ustawienie czasu symulacji.
 +
* [[Dyrektywa_trainset|trainset]] - definicja składu.         
  
 
Parametry obiektów w scenerii mogą być oddzielane  
 
Parametry obiektów w scenerii mogą być oddzielane  

Wersja z 18:23, 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)

Składnia

Scenerię konfiguruje się za pomocą dyrektyw:

  • atmo - ustawienia mgły.
  • camera - ustawienia predefiniowanych pozycji kamer w trybie freefly.
  • config - ustawienia aplikacji specyficzne dla scenerii.
  • description - opis scenerii na potrzeby starterów.
  • event - zdarzenie, np. polecenie zmiany sygnału na semaforze.
  • FirstInit - polecenie inicjalizacji wczytanych obiektów.
  • include - dołączanie zawartości innych plików do pliku scenerii.
  • light - ustawienie źródła oświetlenia scenerii.
  • lua - dołączenie skryptu sterującego scenariuszem w języku LUA.
  • node - definicja obiektów widocznych: tory, rzeki, modele.
  • origin - polecenie przesunięcia obiektów o wektor.
  • rotate - polecenie obrotu obiektów o kąty.
  • sky - ustawienie modelu nieba.
  • test - testowanie poprawności dyrektyw.
  • time - ustawienie czasu symulacji.
  • trainset - definicja składu.

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