(1) Allgemein
Das Programm JimsViewer ist ein Hilfsprogramm zum Transport-Simulations-Spiel simutrans.
Weitere Infos zu diesem Spiel wie auch Informationen zu den Urheberrechten dieses Programm finden Sie unter http://www.simutrans-forum.de.


(2) Programmstart
JimsViewer liest die pak-Dateien von Simutrans ein und stellt die wesentlichen Daten in Listenform dar. Nach dem ersten Start wird die Meldung "Keine alte Sitzung gefunden - Bitte whlen Sie ein pak-Verzeichnis aus". 
Nachdem zum ersten Mal ein pak-Verzeichnis eingeladen wurde, erscheint diese Meldung nicht mehr.


(3) Einlesen der pak-Dateien
Ein pak-Verzeichnis knnen Sie mit der Menfunktion "Datei -> ffnen" einlesen. Dort whlen Sie ein beliebiges Verzeichnis aus. Nach Besttigung durch OK wird dieses Verzeichnis sowie alle Unterverzeichnisse nach allen Dateien mit der Endung *.pak durchsucht. Diese Dateien werden anschlieend eingelesen und so aufbereitet, dass die Daten in Listenform dargestellt werden knnen.


(4) Zu JimsViewer gehrende Dateien
Zu JimsViewer gehren folgende Dateien: 
  JimsViewer.exe	   Programm
  JimsViewer.cfg           Konfigurationsdatei
  JVDE.txt                 Texttabelle zur Untersttzung anderer Sprachen
  readme.txt               diese Datei
Vom Programm werden bei Bedarf folgende Dateien erzeugt:
  JimViewer.log            Protokolldatei
  paklist.txt              Liste der bearbeiteten pak-Dateien


(5) Konfigurationsdatei
Die Konfigurationsdatei kann mit jedem beliebigem ASCII-Editor bearbeitet werden (z.B. Notepad). Sie muss folgende Parameter beinhalten, die fr den Programmablauf bentigt werden. Die Reihenfolge der Parameter ist irrelevant.
  WRKFILENAME              Datei, in der die zu bearbeitenden pak-Dateien gelistet sind
                           Wird eine neue Liste erstellt - durch Aufruf von "Datei -> ffnen" - erhlt die neue Liste den Namen "paklist.txt"
  LOGFILENAME              Protokolldatei, die whrend der Aufbereitung der pak-Dateien geschrieben wird.
  LOGFILEMSG               Gibt an, ob Dateifehler protokolliert werden sollen (=1) oder nicht(=0).
  LOGPARSEMSG              Gibt an, ob protokolliert werden soll (=1) oder nicht(=0), welche pak-Dateien eingelesen wurden.
  LOGOBJECTMSG             Gibt an, ob protokolliert werden soll (=1) oder nicht(=0), wenn unbekannte Objekt-Typen gefunden wurden. Diese Meldung wird auch erzeugt, wenn eine korrupte Datei vorliegt. 
  LOGVERSIONMSG            Gibt an, ob protokolliert werden soll (=1) oder nicht(=0), wenn unbekannte Objekt-Versionen gefunden wurden. Diese Daten knnen nicht in den Listen angezeigt werden, da das Objektformat unbekannt ist.
  TXTFILENAME              Datei, in der Systemtexte individuell bersetzt werden knnen. Durch einfache bersetzung der angegebenen Texte (nach dem Gleichheitszeichen) kann sich jeder JimsViewer auf seine Bedrfnisse anpassen oder in eine andere Sprache bertragen.

Die Standardwerte fr jimsviewer.cfg lauten:
  WRKFILENAME = paklist.txt
  LOGFILENAME = jimsviewer.log
  TXTFILENAME = jvde.txt
  LOGFILEMSG  = 1
  LOGPARSEMSG = 1
  LOGOBJECTMSG= 1
  LOGVERSIONMSG=1


(6) Versionsstand / Updates
Der vorliegende Versionsstand 0.8.0.1 vom 04.04.2009 entspricht dem Simutrans-Release 99.17 Eine Angleichung an das Release 102.0 erfolgt in Krze. Weitere Infos sind unter http://www.simutrans-forum.de/forum zu erhalten. 


(7) Rckmeldung
Rckmeldungen, Kritiken usw. sind erwnscht und knnen im entsprechenden Thread von http://www.simutrans-forum.de/forum vorgebracht werden. Ebenso ist natrlich Kontaktaufnahme per PN mglich.



Jim Knopf
im April 2009
