Plik scenerii: Różnice pomiędzy wersjami

Z MaSzyna
Skocz do: nawigacja, szukaj
 
(Nie pokazano 226 wersji utworzonych przez 5 użytkowników)
Linia 1: Linia 1:
Plik scenerii (*.scn) opisuje wygląd i strukturę symulowanego świata.
+
[[Category:Formaty plików symulatora]]
 +
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''.  
  
<P ALIGN=CENTER STYLE="margin-bottom: 0cm"><FONT FACE="Arial Black, sans-serif"><FONT SIZE=5><B>OPIS
+
== Przygotowanie ==
FORMATU PLIKU SCENERII</B></FONT></FONT></P>
+
Scenerię można uruchomić za pomocą startera, wiersza poleceń lub bezpośrednio przez plik wykonywalny symulatora.
<P ALIGN=CENTER STYLE="margin-bottom: 0cm; font-style: normal; font-weight: normal">
+
 
<FONT FACE="Arial Black, sans-serif"><FONT SIZE=2 STYLE="font-size: 10pt">Opracowanie
+
* Komenda wiersza poleceń, uruchamiająca scenerię scene.scn:
na podstawie dokumentu scenery.doc autorstwa</FONT></FONT></P>
+
    eu07.exe –s scenery/scene.scn
<P ALIGN=CENTER STYLE="margin-bottom: 0cm; font-style: normal; font-weight: normal">
+
 
<FONT FACE="Arial Black, sans-serif"><FONT SIZE=2 STYLE="font-size: 10pt">Marcina
+
* Wpis w eu07.ini, powodujący uruchomienie scene.scn przez plik wykonywalny
Woźniaka i Macieja Czapkiewicza</FONT></FONT></P>
+
    sceneryfile scene.scn
<P ALIGN=CENTER STYLE="margin-bottom: 0cm; border-top: none; border-bottom: 1px solid #000000; border-left: none; border-right: none; padding-top: 0cm; padding-bottom: 0.07cm; padding-left: 0cm; padding-right: 0cm; font-style: normal; font-weight: normal">
+
 
<FONT FACE="Arial Black, sans-serif"><FONT SIZE=2 STYLE="font-size: 10pt">Aktualizacja
+
Scenerie używają prawoskrętnego ukłądu współrzędnych:
wg stanu na rok 2015 </FONT></FONT>
+
 
</P>
+
[[Plik:Swspol.png]]
<P ALIGN=CENTER STYLE="margin-bottom: 0cm; border-top: none; border-bottom: 1px solid #000000; border-left: none; border-right: none; padding-top: 0cm; padding-bottom: 0.07cm; padding-left: 0cm; padding-right: 0cm; font-style: normal; font-weight: normal">
+
 
<BR>
+
== Rodzaje plików składowych scenerii ==
</P>
+
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]].
<P ALIGN=CENTER STYLE="margin-bottom: 0cm; font-style: normal; font-weight: normal">
+
* 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.
<BR>
+
* 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...
</P>
+
* CTR - plik ze zdarzeniami tworzącymi scenariusz
<P ALIGN=CENTER STYLE="margin-bottom: 0cm; font-style: normal; font-weight: normal">
+
* [[Plik_INC|INC]] - plik pozwalający na wstawienie parametryzowanego zbioru obiektów scenerii.
<BR>
+
 
</P>
+
== Składnia ==
<P ALIGN=CENTER STYLE="margin-bottom: 0cm; font-style: normal; font-weight: normal">
+
Scenerię konfiguruje się za pomocą dyrektyw i wpisów przedstawionych w poniższym rozdziale:
<FONT FACE="Lucida Console, monospace"><FONT SIZE=2 STYLE="font-size: 10pt">Na
+
 
zebranych tu informacjach oparte zostały skrypty eksporterów</FONT></FONT></P>
+
=== Dyrektywy scenariusza ===
<P ALIGN=CENTER STYLE="margin-bottom: 0cm; font-style: normal; font-weight: normal">
+
* [[Dyrektywa_atmo|atmo]] - ustawienia mgły.
<FONT FACE="Lucida Console, monospace"><FONT SIZE=2 STYLE="font-size: 10pt">jaki
+
* [[Dyrektywa_sky|sky]] - ustawienie modelu nieba.
i importerów scenerii dla środowiska 3DS Max Studio</FONT></FONT></P>
+
* [[Dyrektywa_time|time]] - ustawienie czasu symulacji.
<P ALIGN=CENTER STYLE="margin-bottom: 0cm; font-style: normal; font-weight: normal">
+
* [[Dyrektywa_FirstInit|FirstInit]] - polecenie inicjalizacji wczytanych obiektów.
<FONT FACE="Lucida Console, monospace"><FONT SIZE=2 STYLE="font-size: 10pt">oraz
+
* [[Dyrektywa_trainset|trainset]] - definicja składu.
parser przetwarzajacy dane z plików scenerii wbudowany</FONT></FONT></P>
+
* [[Obiekt_event|event]] - zdarzenie, np. polecenie zmiany sygnału na semaforze.
<P ALIGN=CENTER STYLE="margin-bottom: 0cm; font-style: normal; font-weight: normal">
+
* [[Dyrektywa_include|include]] - dołączanie zawartości innych plików do pliku scenerii.
<FONT FACE="Lucida Console, monospace"><FONT SIZE=2 STYLE="font-size: 10pt">w
+
* [[Dyrektywa_camera|camera]] - ustawienia predefiniowanych pozycji kamer w trybie ''freefly''.
programie EU07.EXE</FONT></FONT></P>
+
* [[Dyrektywa_config|config]] - ustawienia aplikacji specyficzne dla scenerii.
<P ALIGN=CENTER STYLE="margin-bottom: 0cm; font-style: normal; font-weight: normal">
+
* [[Dyrektywa_lua|lua]] - dołączenie skryptu sterującego scenariuszem w języku LUA.
+
* [[Obiekt_node|node]] - definicja obiektów widocznych: tory, rzeki, modele.
</P>
+
* [[Dyrektywa_origin|origin]] - polecenie przesunięcia obiektów o wektor.
<P ALIGN=CENTER STYLE="margin-bottom: 0cm; font-style: normal; font-weight: normal">
+
* [[Dyrektywa_rotate|rotate]] - polecenie obrotu obiektów o kąty.
<BR>
+
* [[Dyrektywa_group|group]] - grupowanie obiektów
</P>
+
* [[Dyrektywa_isolated|isolated]] - definiowanie odcinków izolowanych
<P STYLE="margin-bottom: 0cm">Domyślny plik trasy powinien nazywać
+
* [[Dyrektywa_area|area]] - grupowanie odcinków izolowanych
się <B>scene.scn</B>, możliwe jest wgranie innego pliku poprzez
+
 
podanie jego nazwy jako parametr w skrócie lub w konsoli polecen, np.
+
Wycofane:
</P>
+
* <s>[[Dyrektywa_description|description]] - opis scenerii na potrzeby starterów.</s>
<P STYLE="margin-bottom: 0cm"><FONT COLOR="#3333ff"><FONT FACE="Courier New, monospace"><SPAN LANG="en-US">eu07.exe
+
* <s>[[Dyrektywa_light|light]] - ustawienie źródła oświetlenia scenerii.</s>  
&ndash;s scenery/testowo.scn</SPAN></FONT><SPAN LANG="en-US">.</SPAN></FONT></P>
+
* <s>[[Dyrektywa_test|test]] - testowanie poprawności dyrektyw.</s>        
<P STYLE="margin-bottom: 0cm"><BR>
+
 
</P>
+
=== Dyrektywy startera ===
<P STYLE="margin-bottom: 0cm">Można również zdefiniować domyślną
+
 
nazwę scenerii w pliku <FONT COLOR="#990000"><FONT FACE="Arial, sans-serif"><FONT SIZE=2><B>eu07.ini
+
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.
</B></FONT></FONT></FONT><FONT COLOR="#000000"><FONT FACE="Times New Roman, serif"><FONT SIZE=3><SPAN STYLE="font-weight: normal">podajac
+
Nie mają wpływu na działanie symulacji!
parametr w kluczu</SPAN></FONT></FONT></FONT></P>
+
 
<P STYLE="margin-bottom: 0cm"><FONT COLOR="#3333ff"><FONT FACE="Times New Roman, serif"><FONT SIZE=3><SPAN STYLE="font-weight: normal">sceneryfile
+
:'''//$n''' – nazwa scenerii:
np.:</SPAN></FONT></FONT></FONT></P>
+
::*Rainsted.exe wyświetlana w głównym oknie wyboru scenerii w polu z żółtym tłem;
<P STYLE="margin-bottom: 0cm"><BR>
+
::*Starter.exe wyświetlana w głównym oknie wyboru scenerii w zakładce ''Opis służby'';
</P>
+
:::''Rozpoznawana przez: Starter.exe, Rainsted.exe''
<P STYLE="margin-bottom: 0cm"><FONT COLOR="#3333ff"><FONT FACE="Times New Roman, serif"><FONT SIZE=3><SPAN STYLE="font-weight: normal">sceneryfile
+
 
testowo.scn</SPAN></FONT></FONT></FONT></P>
+
:'''//$d''' – opis scenerii:
<P ALIGN=CENTER STYLE="margin-bottom: 0cm"><BR>
+
::*Rainsted.exe wyświetlany w głównym oknie wyboru scenerii obok wybranego składu/scenariusza;
</P>
+
::*Starter.exe wyświetlany w głównym oknie wyboru scenerii w zakładce ''Opis służby'';
<P ALIGN=LEFT STYLE="margin-bottom: 0cm"><FONT FACE="Times New Roman, serif"><FONT SIZE=2 STYLE="font-size: 10pt"><SPAN STYLE="font-style: normal"><SPAN STYLE="font-weight: normal">Parametry
+
:::''Rozpoznawana przez: Starter.exe, Rainsted.exe''
obiektów w scenerii mogą być oddzielane spacjami, przecinkami,
+
 
średnikami, tabulatorami lub końcami linii, jednak dla lepszej
+
:'''//$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):
czytelności dla człowieka zaleca się oddzielanie ich wyłącznie
+
::*Rainsted.exe wyświetla do trzech przycisków tego typu w głównym oknie wyboru scenerii;
spacją.</SPAN></SPAN></FONT></FONT></P>
+
::*Starter.exe wyświetla przyciski tego typu w głównym oknie wyboru scenerii w zakładce ''Rozkład jazdy'';
<P ALIGN=CENTER STYLE="margin-bottom: 0cm; font-style: normal; font-weight: normal">
+
:::''Rozpoznawana przez: Starter.exe, Rainsted.exe''
<BR>
+
 
</P>
+
:'''//$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'''.
<P ALIGN=CENTER STYLE="margin-bottom: 0cm; font-style: normal"><FONT FACE="Times New Roman, serif"><FONT SIZE=2 STYLE="font-size: 10pt"><B>Przykłady:</B></FONT></FONT></P>
+
:::''Rozpoznawana przez: Starter.exe, Rainsted.exe''
<P ALIGN=CENTER STYLE="margin-bottom: 0cm; font-style: normal; font-weight: normal">
+
 
<BR>
+
:'''//$i''' – nazwa obrazka wyświetlanego przez dany starter w głównym oknie (miniaturka scenerii)
</P>
+
:::''Rozpoznawana przez: Starter.exe, Rainsted.exe''
<P ALIGN=LEFT STYLE="margin-bottom: 0cm; font-style: normal; font-weight: normal">
+
 
<FONT FACE="Times New Roman, serif"><FONT SIZE=2 STYLE="font-size: 10pt">include;tree.inc;l61_plants/drzewo1024f;-3947.2;-4.0;2401.17;56.0;8.3;4.2;end</FONT></FONT></P>
+
:'''//$it''' – definicja indywidualnego obrazka mini z katalogu scenery/images dla danego składu - deklaracja obrazka - nazwa bez rozszerzenia!
<P ALIGN=LEFT STYLE="margin-bottom: 0cm; font-style: normal; font-weight: normal">
+
:::''Rozpoznawana przez: Starter.exe''
<BR>
+
 
</P>
+
:'''//$it''' – definicja indywidualnego logo startowego dla składu z katalogu textures/logo - deklaracja obrazka - nazwa bez rozszerzenia!
<P ALIGN=LEFT STYLE="margin-bottom: 0cm; font-style: normal; font-weight: normal">
+
:::''Rozpoznawana przez: Starter.exe''
<FONT FACE="Times New Roman, serif"><FONT SIZE=2 STYLE="font-size: 10pt">include,tree.inc,l61_plants/drzewo1024f,-3947.2,-4.0,2401.17,56.0,8.3,4.2,end</FONT></FONT></P>
+
 
<P ALIGN=LEFT STYLE="margin-bottom: 0cm; font-style: normal; font-weight: normal">
+
:'''//$decor''' – pomijanie składów dekoracyjnych tj. nie wykonujących zadań scenariusza.
<BR>
+
:::''Rozpoznawana przez: Starter.exe''
</P>
+
 
<P ALIGN=LEFT STYLE="margin-bottom: 0cm; font-style: normal; font-weight: normal">
+
:'''//$a''' – oznaczenie scenerii jako archiwalna. Nie wyświetla się domyślnie w głównym oknie Startera.
<FONT FACE="Times New Roman, serif"><FONT SIZE=2 STYLE="font-size: 10pt">include
+
:::''Rozpoznawana przez: Starter.exe''
tree.inc l61_plants/drzewo1024f -3947.2 -4.0 2401.17 56.0 8.3 4.2 end</FONT></FONT></P>
+
 
<P ALIGN=LEFT STYLE="margin-bottom: 0cm; font-style: normal; font-weight: normal">
+
:'''//$l''' – kategoria scenerii pozwalająca zwinąć wszystkie scenariusze do jednej grupie.
<BR>
+
:::''Rozpoznawana przez: Starter.exe''
</P>
+
 
<P ALIGN=LEFT STYLE="margin-bottom: 0cm; font-style: normal; font-weight: normal">
+
:'''//$e''' – opis błędu
<BR>
+
:::''Rozpoznawana przez: Rainsted.exe''
</P>
+
 
<P ALIGN=LEFT STYLE="margin-bottom: 0cm; font-style: normal; font-weight: normal">
+
:'''//$g''' – odnośnik do mapy
<FONT FACE="Times New Roman, serif"><FONT SIZE=2 STYLE="font-size: 10pt">W
+
:::''Rozpoznawana przez: Rainsted.exe''
pliku scenerii rozróżniamy 12 typów obiektów, są to: </FONT></FONT>
+
 
</P>
+
:'''//$r''' – plik odniesienia
<P ALIGN=LEFT STYLE="margin-bottom: 0cm; font-style: normal; font-weight: normal">
+
:::''Rozpoznawana przez: Rainsted.exe''
<FONT FACE="Times New Roman, serif"><FONT SIZE=2 STYLE="font-size: 10pt"><B>node</B>,
+
 
<B>event</B>,<B> include</B>, <B>trainset</B>,<B> rotate</B>, <B>orgin</B>,<B>
+
:'''//$t''' – regeneracja plików terenu
description</B>, <B>fog</B>, <B>atmo</B>, <B>light</B>, <B>camera</B>,
+
:::''Rozpoznawana przez: Rainsted.exe''
<B>config</B></FONT></FONT></P>
+
 
<P ALIGN=LEFT STYLE="margin-bottom: 0cm; font-style: normal; font-weight: normal">
+
:'''//$w''' – parametry składu
<BR>
+
:::'''type''' - Rodzaj pociągu: p - pasażerski, t - towarowy, m - towarowo-osobowy;
</P>
+
:::'''lmax''' - Maksymalna długość składu;
<P ALIGN=LEFT STYLE="margin-bottom: 0cm; font-style: normal; font-weight: normal">
+
:::'''vmin''' - Minimalna prędkość pojazdów w składzie;
<FONT FACE="Times New Roman, serif"><FONT SIZE=2 STYLE="font-size: 10pt">Dwa
+
:::'''vmax''' - Maksymalna prędkość, jaką można rozwinąć na trasie przejazdu;
z wymienionych typow, tj. <B>node</B> i <B>event</B> dziela się na
+
:::'''d''' - Rozstaw toru. Domyślnie normalny (1435m).
podtypy. Wpis typu <B>node</B> posiada 12 podtypów</FONT></FONT></P>
+
:::''Rozpoznawana przez: Rainsted.exe''
<P ALIGN=LEFT STYLE="margin-bottom: 0cm; font-style: normal; font-weight: normal">
+
 
<FONT FACE="Times New Roman, serif"><FONT SIZE=2 STYLE="font-size: 10pt">zaś
+
:'''//$x''' – wymagana wersja pliku eu07.exe
wpis <B>event</B> 8.</FONT></FONT></P>
+
:::''Rozpoznawana przez: Rainsted.exe''
<P ALIGN=LEFT STYLE="margin-bottom: 0cm; font-style: normal; font-weight: normal">
+
 
<BR>
+
[[Kategoria:Scenerie]]
</P>
 
<P ALIGN=LEFT STYLE="margin-bottom: 0cm; font-style: normal; font-weight: normal">
 
<BR>
 
</P>
 
<P ALIGN=LEFT STYLE="margin-bottom: 0cm; font-style: normal; font-weight: normal">
 
<FONT FACE="Times New Roman, serif"><FONT SIZE=2 STYLE="font-size: 10pt">1
 
Wpis node </FONT></FONT>
 
</P>
 
<P ALIGN=LEFT STYLE="margin-bottom: 0cm; font-style: normal; font-weight: normal">
 
<BR>
 
</P>
 
<P ALIGN=LEFT STYLE="margin-bottom: 0cm; font-style: normal; font-weight: normal">
 
<FONT FACE="Times New Roman, serif"><FONT SIZE=2 STYLE="font-size: 10pt">Typ
 
<B>NODE</B> definiuje obiekty widoczne (a ogólniej: obiekty które
 
bierze pod uwagę funkcja Render).</FONT></FONT></P>
 
<P ALIGN=LEFT STYLE="margin-bottom: 0cm; font-weight: normal"><FONT FACE="Times New Roman, serif"><FONT SIZE=2 STYLE="font-size: 10pt"><SPAN STYLE="font-style: normal">Obiekty
 
tego typu mogą być rysowalne lub niewidoczne. Parametry podstawowe
 
wspólne dla wszystkich podtypów to: </SPAN></FONT></FONT>
 
</P>
 
<P ALIGN=LEFT STYLE="margin-bottom: 0cm; font-weight: normal"><BR>
 
</P>
 
<UL>
 
<LI><P STYLE="margin-bottom: 0cm"><FONT FACE="Arial, sans-serif">MaxDistance</FONT>
 
&ndash; maksymalna odległość z jakiej obiekt będzie widoczny</P>
 
<LI><P STYLE="margin-bottom: 0cm"><FONT FACE="Arial, sans-serif">MinDistance</FONT>
 
&ndash; minimalna odległość z jakiej obiekt będzie widoczny</P>
 
<LI><P STYLE="margin-bottom: 0cm"><FONT FACE="Arial, sans-serif">Name</FONT>
 
&ndash; nazwa obiektu, jeśli nie potrzebujemy należy wpisać <B>none</B></P>
 
<LI><P ALIGN=LEFT STYLE="margin-bottom: 0cm; font-style: normal; font-weight: normal">
 
<FONT FACE="Times New Roman, serif"><FONT SIZE=2 STYLE="font-size: 10pt"><FONT FACE="Arial, sans-serif">Type</FONT>
 
- rodzaj obiektu</FONT></FONT></P>
 
</UL>
 
<P ALIGN=LEFT STYLE="margin-bottom: 0cm; font-style: normal; font-weight: normal">
 
<BR>
 
</P>
 
<P ALIGN=LEFT STYLE="margin-bottom: 0cm; font-style: normal; font-weight: normal">
 
<FONT FACE="Times New Roman, serif"><FONT SIZE=2 STYLE="font-size: 10pt">Ponizej
 
tabela opisująca poszczególne podtypy wpisu NODE</FONT></FONT></P>
 
<P ALIGN=LEFT STYLE="margin-bottom: 0cm; font-style: normal; font-weight: normal">
 
<BR>
 
</P>
 
<TABLE WIDTH=691 BORDER=1 BORDERCOLOR="#000000" CELLPADDING=4 CELLSPACING=0>
 
<COL WIDTH=89>
 
<COL WIDTH=638>
 
<COL WIDTH=38>
 
<TR VALIGN=TOP>
 
<TH WIDTH=89 BGCOLOR="#dddddd">
 
<P ALIGN=LEFT><FONT COLOR="#000000"><FONT FACE="Times New Roman, serif"><FONT SIZE=2 STYLE="font-size: 10pt">track</FONT></FONT></FONT></P>
 
</TH>
 
<TH WIDTH=538>
 
<P STYLE="font-weight: normal"><FONT FACE="Times New Roman, serif"><FONT SIZE=1 STYLE="font-size: 8pt">Definiuje
 
trajektorię, po której może poruszać się obiekt dynamic. Kształt
 
trajektorii definiujemy za pomocą krzywej Beziera </FONT></FONT>
 
</P>
 
</TH>
 
<TH WIDTH=38>
 
<P><BR>
 
</P>
 
</TH>
 
</TR>
 
<TR VALIGN=TOP>
 
<TD WIDTH=89 BGCOLOR="#dddddd">
 
<P ALIGN=LEFT><FONT COLOR="#000000"><FONT FACE="Times New Roman, serif"><FONT SIZE=2 STYLE="font-size: 10pt">traction</FONT></FONT></FONT></P>
 
</TD>
 
<TD WIDTH=538>
 
<P ALIGN=LEFT><FONT COLOR="#333333"><FONT FACE="Times New Roman, serif"><FONT SIZE=2 STYLE="font-size: 9pt">Definiuje
 
obiekt odcinka drutu sieci trakcyjnej</FONT></FONT></FONT></P>
 
</TD>
 
<TD WIDTH=38>
 
<P ALIGN=LEFT><BR>
 
</P>
 
</TD>
 
</TR>
 
<TR VALIGN=TOP>
 
<TD WIDTH=89 BGCOLOR="#dddddd">
 
<P ALIGN=LEFT><FONT COLOR="#000000"><FONT FACE="Times New Roman, serif"><FONT SIZE=2 STYLE="font-size: 10pt">dynamic</FONT></FONT></FONT></P>
 
</TD>
 
<TD WIDTH=538>
 
<P ALIGN=LEFT><FONT COLOR="#333333"><FONT FACE="Times New Roman, serif"><FONT SIZE=2 STYLE="font-size: 9pt">Definiuje
 
obiekt poruszający się po ścieżkach typu <B>track</B> lub<B> road</B></FONT></FONT></FONT></P>
 
</TD>
 
<TD WIDTH=38>
 
<P ALIGN=LEFT><BR>
 
</P>
 
</TD>
 
</TR>
 
<TR VALIGN=TOP>
 
<TD WIDTH=89 BGCOLOR="#dddddd">
 
<P ALIGN=LEFT><FONT COLOR="#000000"><FONT FACE="Times New Roman, serif"><FONT SIZE=2 STYLE="font-size: 10pt">model</FONT></FONT></FONT></P>
 
</TD>
 
<TD WIDTH=538>
 
<P ALIGN=LEFT><FONT COLOR="#333333"><FONT FACE="Times New Roman, serif"><FONT SIZE=2 STYLE="font-size: 9pt">Wstawia
 
obiekt modelu 3d statyczny lub z możliwością animacji</FONT></FONT></FONT></P>
 
</TD>
 
<TD WIDTH=38>
 
<P ALIGN=LEFT><BR>
 
</P>
 
</TD>
 
</TR>
 
<TR VALIGN=TOP>
 
<TD WIDTH=89 BGCOLOR="#dddddd">
 
<P ALIGN=LEFT><FONT COLOR="#000000"><FONT FACE="Times New Roman, serif"><FONT SIZE=2 STYLE="font-size: 10pt">triangles</FONT></FONT></FONT></P>
 
</TD>
 
<TD WIDTH=538>
 
<P ALIGN=LEFT><FONT COLOR="#333333"><FONT FACE="Times New Roman, serif"><FONT SIZE=2 STYLE="font-size: 9pt">Definiuje
 
jeden trójkąt składajacy się z trzech wierzchołków jako element
 
składowy terenu</FONT></FONT></FONT></P>
 
</TD>
 
<TD WIDTH=38>
 
<P ALIGN=LEFT><BR>
 
</P>
 
</TD>
 
</TR>
 
<TR VALIGN=TOP>
 
<TD WIDTH=89 BGCOLOR="#dddddd">
 
<P ALIGN=LEFT STYLE="font-style: normal; font-weight: normal"><FONT COLOR="#000000"><FONT FACE="Times New Roman, serif"><FONT SIZE=2 STYLE="font-size: 10pt">riangle_strip</FONT></FONT></FONT></P>
 
</TD>
 
<TD WIDTH=538>
 
<P ALIGN=LEFT><FONT COLOR="#333333"><FONT FACE="Times New Roman, serif"><FONT SIZE=2 STYLE="font-size: 9pt">Definiuje
 
wielokąt jako element składowy terenu</FONT></FONT></FONT></P>
 
</TD>
 
<TD WIDTH=38>
 
<P ALIGN=LEFT><BR>
 
</P>
 
</TD>
 
</TR>
 
<TR VALIGN=TOP>
 
<TD WIDTH=89 BGCOLOR="#dddddd">
 
<P ALIGN=LEFT STYLE="font-style: normal; font-weight: normal"><FONT COLOR="#000000"><FONT FACE="Times New Roman, serif"><FONT SIZE=2 STYLE="font-size: 10pt">triangle_fan</FONT></FONT></FONT></P>
 
</TD>
 
<TD WIDTH=538>
 
<P ALIGN=LEFT><BR>
 
</P>
 
</TD>
 
<TD WIDTH=38>
 
<P ALIGN=LEFT><BR>
 
</P>
 
</TD>
 
</TR>
 
<TR VALIGN=TOP>
 
<TD WIDTH=89 BGCOLOR="#dddddd">
 
<P ALIGN=LEFT STYLE="font-style: normal; font-weight: normal"><FONT COLOR="#000000"><FONT FACE="Times New Roman, serif"><FONT SIZE=2 STYLE="font-size: 10pt">lines</FONT></FONT></FONT></P>
 
</TD>
 
<TD WIDTH=538>
 
<P ALIGN=LEFT><FONT COLOR="#333333"><FONT FACE="Times New Roman, serif"><FONT SIZE=2 STYLE="font-size: 9pt">Definiuje
 
linię &ndash; pojedynczy odcinek od punktu A do punktu B</FONT></FONT></FONT></P>
 
</TD>
 
<TD WIDTH=38>
 
<P ALIGN=LEFT><BR>
 
</P>
 
</TD>
 
</TR>
 
<TR VALIGN=TOP>
 
<TD WIDTH=89 BGCOLOR="#dddddd">
 
<P ALIGN=LEFT STYLE="font-style: normal; font-weight: normal"><FONT COLOR="#000000"><FONT FACE="Times New Roman, serif"><FONT SIZE=2 STYLE="font-size: 10pt">line_strip</FONT></FONT></FONT></P>
 
</TD>
 
<TD WIDTH=538>
 
<P ALIGN=LEFT><BR>
 
</P>
 
</TD>
 
<TD WIDTH=38>
 
<P ALIGN=LEFT><BR>
 
</P>
 
</TD>
 
</TR>
 
<TR VALIGN=TOP>
 
<TD WIDTH=89 BGCOLOR="#dddddd">
 
<P ALIGN=LEFT STYLE="font-style: normal; font-weight: normal"><FONT COLOR="#000000"><FONT FACE="Times New Roman, serif"><FONT SIZE=2 STYLE="font-size: 10pt">line_loop</FONT></FONT></FONT></P>
 
</TD>
 
<TD WIDTH=538>
 
<P ALIGN=LEFT><BR>
 
</P>
 
</TD>
 
<TD WIDTH=38>
 
<P ALIGN=LEFT><BR>
 
</P>
 
</TD>
 
</TR>
 
<TR VALIGN=TOP>
 
<TD WIDTH=89 BGCOLOR="#dddddd">
 
<P ALIGN=LEFT STYLE="font-style: normal; font-weight: normal"><FONT COLOR="#000000"><FONT FACE="Times New Roman, serif"><FONT SIZE=2 STYLE="font-size: 10pt">memcell</FONT></FONT></FONT></P>
 
</TD>
 
<TD WIDTH=538>
 
<P ALIGN=LEFT><FONT COLOR="#333333"><FONT FACE="Times New Roman, serif"><FONT SIZE=1 STYLE="font-size: 8pt">Komórka
 
pamięci, nie jest rysowana ale ma współrzędne X, Y, Z, które np.
 
są przekazywane do AI jako pozycja semafora. </FONT></FONT></FONT>
 
</P>
 
</TD>
 
<TD WIDTH=38>
 
<P ALIGN=LEFT><BR>
 
</P>
 
</TD>
 
</TR>
 
<TR VALIGN=TOP>
 
<TD WIDTH=89 BGCOLOR="#dddddd">
 
<P ALIGN=LEFT STYLE="font-style: normal; font-weight: normal"><FONT COLOR="#000000"><FONT FACE="Times New Roman, serif"><FONT SIZE=2 STYLE="font-size: 10pt">eventlauncher</FONT></FONT></FONT></P>
 
</TD>
 
<TD WIDTH=538>
 
<P ALIGN=LEFT><FONT COLOR="#333333"><FONT FACE="Times New Roman, serif"><FONT SIZE=2 STYLE="font-size: 9pt">Obiekt
 
wyzwalany naciśnięciem klawisza albo o określonej godzinie lub raz
 
na jakiś czas. Nie jest rysowany ale ma współrzędne X, Y, Z,
 
istotne przy wyzwalaniu klawiszem. </FONT></FONT></FONT>
 
</P>
 
</TD>
 
<TD WIDTH=38>
 
<P ALIGN=LEFT><BR>
 
</P>
 
</TD>
 
</TR>
 
</TABLE>
 
<P ALIGN=LEFT STYLE="margin-bottom: 0cm; font-style: normal; font-weight: normal">
 
<BR>
 
</P>
 
</BODY>
 
</HTML>
 

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.

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:

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