Edytor/Eksport/MaSzyna

Głównym przeznaczeniem scenerii tworzonych w Rainsted był Symulator MaSzyna. Jednak nie była to jedyna możliwość. W 2010 roku do Advanced Tram Simulator przygotowane zostały tory tramwajowe GOP. Podejmowane były też próby eksportu do Virtual Bus i dostosowania edytora do potrzeb formatów Midtown Madness 2. Również możliwy był eksport w formacie edytora UTR.

Uruchomienie eksportowania

Eksportowanie do MaSzyny jest wykonywane z osobnego okna, otwieranego z menu Plik albo skrótem klawiszowym (domyślnie [Ctrl]+[E]). Przy pierwszym uruchomieniu okna eksportu do RSF jest dodawany obiekt o kodzie 0x2000, zawierający nazwę pliku oraz ustawienia zaptaszeń (eksport poszczególnych warstw oraz ustawienia pomocnicze). Domyślna nazwa pliku eksportowania jest tworzona z nazwy pliku RSF.

Eksportowanie do pliku uruchamia się przyciskiem [Eksportuj scenerię] (albo podobnym). Po zapisaniu wszystkich obiektów do pliku (wg ustawień warstw oraz dodatkowej konfiguracji), okno eksportowania zostanie zamknięte. Ponieważ w roku 2022 robione są zmiany w zakresie eksportu, opis może nie do końca być spójny z aktualną wersją.

Eksport wersja 1

Pierwotna wersja eksportowania, używana do 2022 roku, obecnie pod przyciskiem [v1]. Nie obsługuje przesunięcia środka dla komórki, ale obsługuje ograniczenie do wybranych 3 komórek. Prawdopodobnie pozostanie jako mały przycisk w celach testowych, aby można było uruchomić eksport w razie awarii innych mechanizmów.

Eksport wersja 2

Od wersji 157 Rainsted podstawowym mechanizmem eksportowania jest wersja druga (v2). Obsługuje ona przesunięcie obiektów o wektor będący wielokrotnością 1km, co pozwala wyśrodkować komórki. Jeśli w parametrach pliku nie jest wpisane przesunięcie, wykonywany jest zwykły eksport w wersji pierwszej (v1). Przesunięcie może być wykonane w zakresie ±127 kilometrów od ustawionego środka scenerii. Przesunięcie obiektów jest realizowane poprzez utworzenie w pamięci kopii pliku RSF, która to kopia jest w całości przeliczana do nowego środka (wykorzystany jest mechanizmem łączenia plików RSF). Być może sensowniejszym rozwiązaniem byłoby dodawanie wektora do poszczególnych eksportowanych obiektów, jednak taka modyfikacja kodu eksportowania mogłaby spowodować dodatkowe błędy, a przeliczanie całego pliku było już opracowane wcześniej i nadaje się również do tego celu.

Eksport ten ujawnił kilka błędów, które nie były obecne w wersji 1:

• Brak obsługi grupy ("Tylko dodane do grupy") — naprawione w 159.
• Mieszanie izolacji torów — naprawione w 159.
• Mieszanie powiązania sygnalizatorów — naprawione w 159.
• Pomijanie drugiego rekordu słupa podwójnego — naprawione w 160.
• Usuwanie zasilania sieci o nazwie dłuższej niż 19 znaków — naprawione w 164.
• Ustawianie domyślnych tekstur w rozjazdach — naprawione w 164.
• Zepsute szycia profili poprzecznych — naprawione w 164.

Eksport wersja 3

Przycisk ma uruchamiać algorytm, który wyeksportuje obiekty do wielu plików — posiadających zaptaszenie po lewej stronie na liście plików. Domyślnie zaptaszenia są zapisywane bezpośrednio do konfiguracji plików i będą zachowane po zapisaniu pliku RSF. Docelowo będzie można tworzyć własne konfiguracje eksportowania (zapisywane w RSF), wybierające inny zestaw plików oraz wymuszające pewne ustawienia, które nie są zaznaczone dla poszczególnych plików. Na przykład będzie można utworzyć konfigurację, która doda kozły i ograniczenia albo wyeksportuje dodatkowo inne obiekty.

Eksport wersja 4

W trakcie prac jest ulepszony sposób eksportowania — przycisk [Eksport v4 - testowy]. Wg stanu na kwiecień 2022 ten eksport nic nie wnosi i nie należy go używać (jest kopią kodu eksportującego ze wcześniejszych wersji Rainsted). Został wydzielony jako kopia do wprowadzania zmian, jednak zmiany te zostały umieszczone w głównym kodzie eksportowania. Zmiany planowane w eksporcie mają polegać na tym, że zamiast generować plik, pojedyncze obiekty z RSF będą dawać pojedyncze wpisy, które następnie będą mogły być również wklejone do istniejącego pliku SCM (otwartego edytorem SCM), a nie tylko do nowego. Prawdopodobnie w najbliższym czasie (rok 2022) pozostanie jako kopia wcześniejszej wersji eksportu i ewentualnie będzie służył jako rezerwa w razie powstania błędu w głównym kodzie eksportowania.

Opcje eksportowania

FirstInit + pojazdy

Jeśli eksportowany ma być plik SCN, można od razu wstawić pojazdy w RSF.

Kody komórek

Jeśli kody komórek nie są dodane do obiektów w pliku RSF, można je dodać podczas eksportowania. Z założenia kody komórek nie są dodawane do nazw rozpoczynanych wielką literą (wyższy poziom dbałości: rozjazdy, tory do wstawiania taboru) ani do nazw, które mają podkreślenie jako trzeci albo czwarty znak (kod komórki już przypisany — nie zostanie podmieniony podczas eksportu, takową podmianę można wykonać operacją z menu edytora).

Kozły w Point2

Umożliwia nieznaczne poprawienie jakości scenerii na wstępnym etapie prac, poprzez wygenerowanie kozłów na wszystkich zakończonych ślepo torach. Co do zasady, zakończenie toru końcem 1 na zewnątrz jest zakończeniem bez kozła (urwaniem szyn), a zakończenie końcem 2 ma spowodować zderzenie pojazdu z blokadą.

Dekle peronów

Obecny sposób rysowania peronów w MaSzynie nie obejmuje pionowych płaszczyzn na końcach odcinków. Aby nie było "dziur" można wygenerować dodatkowe elementy, które "zasłonią dziurę" docelowo należałoby ulepszyć sposób rysowania peronów o generowanie zakończeń z użyciem wskazanej tekstury...

Podsypki torów

Możliwe jest wyłączenie podsypek dla torów, co głównie było przydatne przed optymalizacją wyświetlania torów. Wyłączenie podsypek oraz otoczenia pomagało w testowaniu względnie dużych scenerii na słabym sprzęcie. Tory bez podsypek można również udostępnić innym użytkownikom jako wersje robocze, np. w celu przetestowania ruchu pociągów przed ukończeniem scenerii.

Podsypki rozjazdów

Ustawienie to miało znaczenie w początkach rozwoju edytora, gdy symulacja miała ogromne problemy z wydajnością przy większych sceneriach (2010 rok). Wyłączenie podsypek rozjazdów zmniejszało nieznacznie liczbę trójkątów do narysowania. Podsypki rozjazdów obejmują także dodatkowe elementy 3D, takie jak kierownice oraz "koziołki pod iglicami". Napęd rozjazdu jest osobnym elementem, ponieważ nie jest związany z typem (długością) rozjazdu (wydzielenie napędów dla MaSzyny zostało przygotowane w 2017 roku).

Ograniczenie na łukach

Na podstawie promienia łuku wyliczana jest maksymalna prędkość wg wzoru wziętego z przepisów kolejowych. Opcja przydatna do testowania scenerii w trybie nietestowym, gdy pociąg prowadzony przez komputer może się wykoleić na łuku o małym promieniu, jeśli nie zostanie wstawione ograniczenie. Na odcinkach o błędnej geometrii ("B:") wstawiane jest ograniczenie do 9km/h.

Słupy

Jeśli słupy zostaną wyłączone, eksportowane będą jedynie przęsła sieci trakcyjnej bez wstawiania konstrukcji wsporczych. Opcja do testowania na słabym sprzęcie bądź udostępnienia innym do testów.

Wszystko vis

Ustawienie testowe, mające na celu jawne ukazanie obiektów, które z jakichś powodów zostały ukryte. Przykładem może być niewidoczna sieć trakcyjna (np. do zasilania metra), albo zlikwidowane tory, po których mimo wszystko przejazd będzie możliwy.

Sortowanie warstw

W maju 2022 dodana została opcja grupowania obiektów wg typu. Dotychczas eksport zapisywał obiekty w takiej kolejności, w jakiej były w pliku RSF. Obecnie można włączyć sortowanie wg warstw, czyli eksportowane są kolejno trójkąty, tory, następnie drogi, rzeki, słupki hektometrowe i przekroje, słupy sieci elektrycznych, sygnalizacja i na koniec inne obiekty punktowe. Sortowanie obiektów wg warstw ma ułatwić np. śledzenie zmian przez SVN — można pominąć eksportowanie sieci trakcyjnej i uzupełnić ją jako jeden blok z kopii wysłanej do SVN, podczas gdy bez sortowania sieć trakcyjna może być wymieszana z torami i jej przywracanie wymaga obsługi wielu bloków tekstu.

Sieć trakcyjna 1mm

O ile do eksportowania torów wskazane jest użycie maksymalnej dostępnej dokładności współrzędnych, to w przypadku sieci trakcyjnej można zaokrąglić je do całkowitych milimetrów. Może to również dotyczyć słupów, o ile ich punkt wstawienia znajduje się na końcach przęseł. Trzy cyfry dziesiętne dla współrzędnych przęseł również zmniejszają liczbę potencjalnych zmian, pokazywanych przez SVN, ponieważ przy drobnych korektach torów (krzywe przejściowe, łuki pionowe) mogą się nieznacznie zmieniać współrzędne sieci trakcyjnej. Zalecane jest zaokrąglenie do 1mm, a dokładność 0.1mm jest pozostawiona pod kątem uzyskania większej zgodności podczas przenoszenia obiektów z formatu SCM do RSF.

Railprofile

Pierwotnym pomysłem na dodanie modelu przekroju szyny było zamieszczenie tej informacji po dwukropku za nazwą tekstury szyny, np. Rail_screw_used:UIC60, co należy wpisać w obiekcie nazwy tekstury. Ponieważ jednak podawanie modelu zostało rozwiązane w inny sposób, zaznaczenie tej opcji przeniesie ciąg tekstowy po dwukropku do osobnego parametru we wpisie toru.

Pomijanie komórek

Na potrzeby wydzielenia Kępna z LK181 wprowadzone zostało pomijanie komórek przy eksportowaniu. Dzięki temu można wyeksportować osobno Kępno i osobno pozostałą część trasy, bez dzielenia jej na komórki (wyjdzie ich około 9). Można w ten sposób pominąć do 3 komórek. Należy zwrócić uwagę na wcześniej ustawione konfiguracje eksportu i odhaczyć tę opcję. Pomijanie nie działa na komórkę AAA.

Obiekty w osobnych plikach

Obecnie można dodać kolejny plik eksportowania przyciskiem [+] na górze listy plików. Zmiana nazwy pliku poniżej powoduje od razu zmianę na liście (nie ma osobnej operacji zapisu). Wybranie pozycji z listy zmienia nazwę pliku eksportowania oraz ustawienia zaptaszeń. Na każdy plik tworzony jest osobny obiekt o kodzie 0x2000. Zbędne pozycje można usunąć poprzez zmianę nazwy na pustą i ponowne otwarcie okna eksportowania.

Zalecany podział scenerii na pliki:

• Infrastruktura — obiekty niezbędne do prawidłowego działania symulacji oraz budowle zintegrowane z infrastrukturą (wiadukty, mosty, nastawnie). Zalecane podanie roku w nazwie pliku dla scenerii realistycznych, dla fikcyjnych rok jest opcjonalny.
• Teren wraz ze ścianami lasu (o ile łączą się krawędziami z terenem).
• Zieleń — drzewa i krzaki oraz ściany lasu ustawiane na trójkątach terenu.
• Modele ozdobne w otoczeniu — głównie budynki i budowle, których obecność nie jest konieczna do oceny prawidłowości infrastruktury.
• CityGML — bryły budynków generowane półautomatycznie z danych geodezyjnych.

Eksport do wielu plików

Planowane jest dodanie automatów, które wykonają eksport wielu plików jednocześnie (po kolei). Eksportowanie będzie dotyczyć tych plików z listy, które będą mieć ptaszek po jej lewej stronie. Do listy można też dodać tę samą nazwę pliku z różnym zakresem eksportu. Dzięki temu na potrzeby testów można ograniczyć zakres obiektów. W przypadku powielenia nazwy, zaptaszona będzie tylko jedna z powtórzonych nazw.

Zakres eksportowanych plików będzie można określić poprzez dodanie konfiguracji eksportowania. Jeśli w pliku RSF nie będzie żadnej konfiguracji eksportowania, będzie można jedynie wybrać, czy dany plik ma być eksportowany podczas eksportu wielu plików, czy nie. Poprzez dodanie konfiguracji eksportowania będzie można wybrać inny zestaw plików, a także wymusić pewne ustawienia poprzez dodanie (sumowanie) zaptaszeń konfiguracji oraz pliku.

Ograniczenie obszaru eksportowania

Obecnie działa ograniczenie zakresu geograficznego do wybranej komórki oraz przesuwanie eksportowanych obiektów o wektor. Można wybrać od jednej do trzech komórek albo wszystkie (niezależnie od przydziału obiektu do komórki). Lista dostępnych komórek pokazuje tylko te komórki, w których są wykryte obiekty, umieszczone w RSF.

Eksport porównawczy

Na potrzeby porównania zmian pomiędzy kolejnymi plikami RSF albo oceny zmian wykonanych przez inną osobę, planowane jest uruchomienie eksportu "porównawczego". Eksport taki będzie miał zaokrąglone współrzędne, aby drobne zmiany w pozycji obiektów nie powodowały ogromu modyfikacji pliku (widocznych np. na SVN). Przykładowo, współrzędne w planie mogą być zaokrąglone do całkowitych metrów, a wysokości do 0.1m.

---