jET

Pomoc

Dokument zawiera podręcznik użytkownika dla programu jET w wersji 1.0beta1. Pomoc jest niepełna.

Czym jest jET?

Program jET jest alternatywnym edytorem tras dla symulatora lokomotywy elektrycznej EU07, MaSzyna.

Program jET jest samodzielną aplikacją pracującą w graficznym interfejsie użytkownika. Aplikacja została napisana w języku Java.

Program jest objęty licencją GNU General Public License. Oznacza to, że wraz z plikami wykonywalnymi dostarczane są źródła programu. Program może być usprawniany, modyfikowany zgodnie z zasadami wolnego oprogramowania.

Własności

Program ma następujące własności:

• wyświetla układy torowe scenerii jako rzut równoległy na powierzchnię ekranu.
• odczytuje dane o torach (tylko) z plików scenerii w formacie z dnia 22/07/2003,
• zapisuje układy torowe (tylko) do plików scenerii zachowując format z dnia 22/07/2003,
• nie potrafi rekursywnie przetwarzać plików scenerii (przechodzić między plikami przy zastosowaniu słów kluczowych include i origin),
• jest aplikacją MDI (multiple document interface),
• jest internacjonalizowany,
• pozwala dowolnie powiększać / pomniejszać scenerie,
• pozwala zaznaczać tory i rozjazdy oraz uzyskiwać własności torów,
• umożliwia przeglądanie nazwanych torów / rozjadów,
• pozwala dodawać, edytować, przeglądać, usuwać opisy scenerii,
• odczytuje informacje o torach/rozjazdach bez danych o zdarzeniach i maksymalnej prędkości
• pozwala dodawać nowe tory/rozjazdy
• pozwala edytować właściwości istniejących torów/rozjazdów,
• pozwala usuwać zaznaczone tory/rozjazdy,
• umożliwia wstawianie predefiniowanych torów/rozjazdów do scenerii w dowolny sposób z palety,
• umożliwia dodawanie, edycję, usuwanie predefiniowanych torów/rozjazdów przez edycję skryptu.

Wymagania

Do uruchomienia aplikacji potrzebne będą:

• środowisko uruchomieniowe Java (Java Runtime Enviroment / Java Virtual Machine) w wersji conajmniej 1.4.1, za darmo do pobrania ze strony firmy Sun Microsystems, http://java.sun.com/.
  Najlepiej pobrać Java 2 Standard Editon (J2SE) Software Development Kit (SDK) 1.4.1+.
• biblioteka Java 3D API w wersji conajmniej 1.3.1, za darmo do pobrania ze strony http://java.sun.com/products/java-media/3D/.

Instalacja / deinstalacja

Aby zainstalować aplikację, rozpakuj pobrane z Internetu archiwum do dowolnego katalogu.

Aby zdeinstalować aplikację, usuń katalog z plikami programu.

Uruchomianie

Aby uruchomić program należy uruchomić plik jet.bat (środowisko Windows) lub jet.sh (środowisko UNIX).

Zmiany

Zmiany dokonywane w kolejnych oficjalnych wersjach programu:

0.1 alpha 4

wersja alfa programu

0.1 alpha 5

wersja alfa programu

Okno aplikacji

Skróty klawiaturowe

Skrót	Opis
ESC	Odznaczenie zaznaczonego obiektu w edytorze.
F3	Wyświetlenie okna własności zaznaczonego obiektu w edytorze.
Ctrl+G	Przejście do punktu w scenerii o zadanych współrzędnych.
Ctrl+N	Utworzenie nowej scenerii.
Ctrl+O	Otwarcie istniejącego pliku scenerii.
Ctrl+S	Zapisanie scenerii do pliku.
Ctrl+B	Zmiana punktu bazowego
szary +	Powięszanie widoku scenerii
szary -	Pomniejszanie widoku scenerii
Del	Usunięcie zaznaczonego toru/rozjazdu

Tworzenie torów

Program nie dodaje tekstur i zdarzeń dla wstawianych rozjazdów. Dlatego podczas uruchamiania scenerii w symulatorze, rozjazdy są tylko torami i nie widać podtorza i podkładów. Program definiuje własny zestaw gotowych rozjazdów. Rozjazdy w zestawie są zgodne z typami rozjazdów stosowanych na liniach PKP ale nie są zgodne z rozjazdami w symulatorze. Przykład: w symulatorze stosowany jest rozjazd o długości 34 m, natomiast w programie o długości 33,23 m. Podobnie rzecz się ma w przypadku rozjazdów krzyżowych. W symulatorze dostępna jest tekstura dla rozjazdów krzyżowych o promieniu 180 m, podczas gdy w programie rozjazd krzyżowy ma promień 190 m.

Na początek proponuję zapoznać się z podstawowymi zasadami układania torów, obowiązującymi w symulatorze MaSzyna.

1. Nie wolno łączyć bezpośrednio dwóch rozjazdów ze sobą. Symulator zgłasza wtedy błąd Null track i powoduje zakończenie. Aby ominąć ten problem, należy wstawiać między rozjazdy krótkie odcinki toru prostego lub flex.

Łączenie torów / rozjazdów za pomocą gumy

Aby połączyć ze sobą dwa tory / rozjazdy, należy przycisnąć na palecie przycisk gumy (ang. flex). Następnie zaznaczyć w edytorze pierwszy tor / rozjazd, kliknąć na uchwycie, do którego chcemy podpiąć nowy odcinek toru. Potem zaznaczyć drugi tor i również kliknąć na żądanym uchwycie. Na końcu zaś, odznaczyć na palecie przycisk gumy.

Tworzenie rozjazdów dla torów bocznych

Na PKP na torach bocznych stosuje się rozjazdy o małym promieniu 190 m i skosie 1:9. Rozjazd taki ma prosta krzyżownicę. Aby dodać rozjazd w programie należy połączyć ze sobą predefiniowany rozjazd o długości 27,14 m, skosie 1:9 i promieniu 190 m z odcinkiem prostym o długości 6 m.

Tworzenie rozjazdów krzyżowych

Aby uzyskać rozjazd krzyżowy trzeba połączyć odpowiednio 4 rozjazdy, zachowując przy tym warunek układania torów w symulatorze. Na PKP sotsuje się rozjazd krzyżowy o długości 33,23 m i promieniu 190 m.

W programie rozjazd trzeba zbudować z 12 elementów:

• 4 torów prostych o długości 3 m dla każego z końców rozjazdu krzyżowego,
• 4 rozjazdów prostych o długości 10,42 m,
• 2 krótkich odcinków toru prostego o długości 0,2 m, które łączą parami tory proste rozjazdów,
• 1 krótkiego łuku o długości 0,2 m i promieniu 190 m, który łączy jedną parę torów zbocznych rozjazdów,
• 1 toru flex, który łączy drugą parę torów zbocznych.

A tak wygląda wynik pracy:

Wspracie

Autorem programu jest Adam Domański

Oficjalna strona programu: http://af186.internetdsl.tpnet.pl/doman/jet/

Kontakt z autorem: domdion@poczta.onet.pl

Adam Domański, 29/06/2004