Plik scenerii: Różnice pomiędzy wersjami
(Wprowadzono wpis o dyrektywach dla starterów symulatora (oczekiwanie na odpowiedź @szczawik)) |
|||
(Nie pokazano 12 wersji utworzonych przez 3 użytkowników) | |||
Linia 1: | Linia 1: | ||
[[Category:Formaty plików symulatora]] | [[Category:Formaty plików symulatora]] | ||
− | 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'' | + | Plik scenerii jest [[Plik_tekstowy|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''. |
== Przygotowanie == | == Przygotowanie == | ||
+ | Scenerię można uruchomić za pomocą startera, wiersza poleceń lub bezpośrednio przez plik wykonywalny symulatora. | ||
+ | |||
* Komenda wiersza poleceń, uruchamiająca scenerię scene.scn: | * Komenda wiersza poleceń, uruchamiająca scenerię scene.scn: | ||
eu07.exe –s scenery/scene.scn | eu07.exe –s scenery/scene.scn | ||
Linia 9: | Linia 11: | ||
sceneryfile scene.scn | sceneryfile scene.scn | ||
− | + | Scenerie używają prawoskrętnego ukłądu współrzędnych: | |
[[Plik:Swspol.png]] | [[Plik:Swspol.png]] | ||
== Rodzaje plików składowych scenerii == | == 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. | + | Poniższe rodzaje plików nie różnią się składnią, a jedynie pomagają zachować ład w plikach wchodzących w skład scenerii. Są one dołączane do głównego pliku scenerii za pomocą dyrektywy [[Dyrektywa_include|include]]. |
* SCN - główny plik scenerii, zawiera zazwyczaj [[Dyrektywa_trainset|definicje składów]] i polecenia [[Dyrektywa_include|include]], dołączające obiekty z innego pliku do scenerii. | * SCN - główny plik scenerii, zawiera zazwyczaj [[Dyrektywa_trainset|definicje składów]] i polecenia [[Dyrektywa_include|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... | * 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 | * CTR - plik ze zdarzeniami tworzącymi scenariusz | ||
− | * [[Plik_INC|INC]] - plik pozwalający na wstawienie parametryzowanego | + | * [[Plik_INC|INC]] - plik pozwalający na wstawienie parametryzowanego zbioru obiektów scenerii. |
== Składnia == | == Składnia == | ||
Linia 37: | Linia 39: | ||
* [[Dyrektywa_origin|origin]] - polecenie przesunięcia obiektów o wektor. | * [[Dyrektywa_origin|origin]] - polecenie przesunięcia obiektów o wektor. | ||
* [[Dyrektywa_rotate|rotate]] - polecenie obrotu obiektów o kąty. | * [[Dyrektywa_rotate|rotate]] - polecenie obrotu obiektów o kąty. | ||
+ | * [[Dyrektywa_group|group]] - grupowanie obiektów | ||
+ | * [[Dyrektywa_isolated|isolated]] - definiowanie odcinków izolowanych | ||
+ | * [[Dyrektywa_area|area]] - grupowanie odcinków izolowanych | ||
Wycofane: | Wycofane: | ||
Linia 42: | Linia 47: | ||
* <s>[[Dyrektywa_light|light]] - ustawienie źródła oświetlenia scenerii.</s> | * <s>[[Dyrektywa_light|light]] - ustawienie źródła oświetlenia scenerii.</s> | ||
* <s>[[Dyrektywa_test|test]] - testowanie poprawności dyrektyw.</s> | * <s>[[Dyrektywa_test|test]] - testowanie poprawności dyrektyw.</s> | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
=== Dyrektywy startera === | === Dyrektywy startera === | ||
Linia 68: | Linia 65: | ||
:'''//$f''' – link do zewnętrznego pliku lub strony internetowej dotyczący scenerii albo pojedynczego scenariusza, możliwy do otwarcia z poziomu startera (wyświetlany jako dedykowany przycisk): | :'''//$f''' – link do zewnętrznego pliku lub strony internetowej dotyczący scenerii albo pojedynczego scenariusza, możliwy do otwarcia z poziomu startera (wyświetlany jako dedykowany przycisk): | ||
::*Rainsted.exe wyświetla do trzech przycisków tego typu w głównym oknie wyboru scenerii; | ::*Rainsted.exe wyświetla do trzech przycisków tego typu w głównym oknie wyboru scenerii; | ||
− | ::*Starter.exe wyświetla przyciski tego typu w głównym oknie wyboru scenerii w zakładce '' | + | ::*Starter.exe wyświetla przyciski tego typu w głównym oknie wyboru scenerii w zakładce ''Rozkład jazdy''; |
:::''Rozpoznawana przez: Starter.exe, Rainsted.exe'' | :::''Rozpoznawana przez: Starter.exe, Rainsted.exe'' | ||
Linia 76: | Linia 73: | ||
:'''//$i''' – nazwa obrazka wyświetlanego przez dany starter w głównym oknie (miniaturka scenerii) | :'''//$i''' – nazwa obrazka wyświetlanego przez dany starter w głównym oknie (miniaturka scenerii) | ||
:::''Rozpoznawana przez: Starter.exe, Rainsted.exe'' | :::''Rozpoznawana przez: Starter.exe, Rainsted.exe'' | ||
+ | |||
+ | :'''//$it''' – definicja indywidualnego obrazka mini z katalogu scenery/images dla danego składu - deklaracja obrazka - nazwa bez rozszerzenia! | ||
+ | :::''Rozpoznawana przez: Starter.exe'' | ||
+ | |||
+ | :'''//$it''' – definicja indywidualnego logo startowego dla składu z katalogu textures/logo - deklaracja obrazka - nazwa bez rozszerzenia! | ||
+ | :::''Rozpoznawana przez: Starter.exe'' | ||
+ | |||
+ | :'''//$decor''' – pomijanie składów dekoracyjnych tj. nie wykonujących zadań scenariusza. | ||
+ | :::''Rozpoznawana przez: Starter.exe'' | ||
+ | |||
+ | :'''//$a''' – oznaczenie scenerii jako archiwalna. Nie wyświetla się domyślnie w głównym oknie Startera. | ||
+ | :::''Rozpoznawana przez: Starter.exe'' | ||
:'''//$l''' – kategoria scenerii pozwalająca zwinąć wszystkie scenariusze do jednej grupie. | :'''//$l''' – kategoria scenerii pozwalająca zwinąć wszystkie scenariusze do jednej grupie. | ||
Linia 103: | Linia 112: | ||
:::''Rozpoznawana przez: Rainsted.exe'' | :::''Rozpoznawana przez: Rainsted.exe'' | ||
− | + | [[Kategoria:Scenerie]] | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− |
Aktualna wersja na dzień 06:55, 6 lip 2022
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.
Spis treści
Przygotowanie
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
Scenerie używają prawoskrętnego ukłądu współrzędnych:
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. Są one dołączane do głównego pliku scenerii za pomocą dyrektywy include.
- 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 parametryzowanego zbioru obiektów scenerii.
Składnia
Scenerię konfiguruje się za pomocą dyrektyw i wpisów przedstawionych w poniższym rozdziale:
Dyrektywy scenariusza
- atmo - ustawienia mgły.
- sky - ustawienie modelu nieba.
- time - ustawienie czasu symulacji.
- FirstInit - polecenie inicjalizacji wczytanych obiektów.
- trainset - definicja składu.
- event - zdarzenie, np. polecenie zmiany sygnału na semaforze.
- include - dołączanie zawartości innych plików do pliku scenerii.
- camera - ustawienia predefiniowanych pozycji kamer w trybie freefly.
- config - ustawienia aplikacji specyficzne dla 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.
- group - grupowanie obiektów
- isolated - definiowanie odcinków izolowanych
- area - grupowanie odcinków izolowanych
Wycofane:
-
description - opis scenerii na potrzeby starterów. -
light - ustawienie źródła oświetlenia scenerii. -
test - testowanie poprawności dyrektyw.
Dyrektywy startera
Dyrektywy startera to zestaw parametrów (według składni komentarzy) pełniących rolę wprowadzenia do danego startera symulatora MaSzyna dodatkowych informacji oraz konfiguracji. Nie mają wpływu na działanie symulacji!
- //$n – nazwa scenerii:
- Rainsted.exe wyświetlana w głównym oknie wyboru scenerii w polu z żółtym tłem;
- Starter.exe wyświetlana w głównym oknie wyboru scenerii w zakładce Opis służby;
- Rozpoznawana przez: Starter.exe, Rainsted.exe
- //$d – opis scenerii:
- Rainsted.exe wyświetlany w głównym oknie wyboru scenerii obok wybranego składu/scenariusza;
- Starter.exe wyświetlany w głównym oknie wyboru scenerii w zakładce Opis służby;
- Rozpoznawana przez: Starter.exe, Rainsted.exe
- //$f – link do zewnętrznego pliku lub strony internetowej dotyczący scenerii albo pojedynczego scenariusza, możliwy do otwarcia z poziomu startera (wyświetlany jako dedykowany przycisk):
- Rainsted.exe wyświetla do trzech przycisków tego typu w głównym oknie wyboru scenerii;
- Starter.exe wyświetla przyciski tego typu w głównym oknie wyboru scenerii w zakładce Rozkład jazdy;
- Rozpoznawana przez: Starter.exe, Rainsted.exe
- //$o – opis składu, pokazywany przez dany starter. Jeśli skład ma być ukryty, przed pierwszym znakiem opisu powinien znaleźć się znak minus -. Dyrektywa ta musi zostać wprowadzona do pliku po dyrektywie scenariusza FirstInit.
- Rozpoznawana przez: Starter.exe, Rainsted.exe
- //$i – nazwa obrazka wyświetlanego przez dany starter w głównym oknie (miniaturka scenerii)
- Rozpoznawana przez: Starter.exe, Rainsted.exe
- //$it – definicja indywidualnego obrazka mini z katalogu scenery/images dla danego składu - deklaracja obrazka - nazwa bez rozszerzenia!
- Rozpoznawana przez: Starter.exe
- //$it – definicja indywidualnego logo startowego dla składu z katalogu textures/logo - deklaracja obrazka - nazwa bez rozszerzenia!
- Rozpoznawana przez: Starter.exe
- //$decor – pomijanie składów dekoracyjnych tj. nie wykonujących zadań scenariusza.
- Rozpoznawana przez: Starter.exe
- //$a – oznaczenie scenerii jako archiwalna. Nie wyświetla się domyślnie w głównym oknie Startera.
- Rozpoznawana przez: Starter.exe
- //$l – kategoria scenerii pozwalająca zwinąć wszystkie scenariusze do jednej grupie.
- Rozpoznawana przez: Starter.exe
- //$e – opis błędu
- Rozpoznawana przez: Rainsted.exe
- //$g – odnośnik do mapy
- Rozpoznawana przez: Rainsted.exe
- //$r – plik odniesienia
- Rozpoznawana przez: Rainsted.exe
- //$t – regeneracja plików terenu
- Rozpoznawana przez: Rainsted.exe
- //$w – parametry składu
- type - Rodzaj pociągu: p - pasażerski, t - towarowy, m - towarowo-osobowy;
- lmax - Maksymalna długość składu;
- vmin - Minimalna prędkość pojazdów w składzie;
- vmax - Maksymalna prędkość, jaką można rozwinąć na trasie przejazdu;
- d - Rozstaw toru. Domyślnie normalny (1435m).
- Rozpoznawana przez: Rainsted.exe
- //$x – wymagana wersja pliku eu07.exe
- Rozpoznawana przez: Rainsted.exe