Quelltext der Seite Externe *.ini-Dateien der Modelle

== Externe *.ini-Dateien der Modelle ==

[[<b>1. Sinn und Zweck der externen *.ini-Datei</b>]]

Mit der Publikation von Eisenbahn.exe Professional&reg;&copy; 3.0 wurde ein Lokalisierungssystem f&uuml;r Modelle eingef&uuml;hrt, um EEP mitsamt den offiziellen Add-Ons und den vielf&auml;ltigen Zusatzmodellen auch den ausl&auml;ndischen Interessenten in ihrer jeweiligen Landessprache (englisch, franz&ouml;sisch, polnisch und ungarisch) anbieten zu k&ouml;nnen. Dieses System ist nach wie vor g&uuml;ltig.<br><br>
Die Text-Angaben und numerische Werte, welche in den externen INI-Dateien gespeichert sind, erlauben EEP die Katalogisierung der Modelle in der Modelldatenbank (Models.db) und die landesspezifische Anzeige der Modellnamen in den Auswahllisten. Dar&uuml;ber hinaus erm&ouml;glichen die externen INI-Dateien in EEP die Sortierung der Modelle nach Eisenbahn-Epochen; die Filterung der Modelle nach L&auml;ndern in denen die Vorbilder geschaffen wurden bzw. vorkommen; die Filterung der Modelle nach dem Erbauer des Vorbilds; sowie die Filterung nach dem Autor des Modells. Ferner k&ouml;nnen die externen INI-Dateien kurze Beschreibungstexte, sowie eingebettete Verkn&uuml;pfungen (Links) zu ausf&uuml;hrlichen Anleitungen im PDF-Format beinhalten. Nicht zuletzt dienen die INI-Dateien der Anzeige von Achsennamen, die f&uuml;r jede unterst&uuml;tzte Sprache individuell bestimmt bzw. &uuml;bersetzt werden k&ouml;nnen.<br><br>
<b>2. Bedeutung der externen *.ini-Datei></b><br><br>
Beim Export eines Modells (also einer *.3dm-Datei) durch den Home-Nostruktor 13.0, wird dessen begleitende INI-Datei automatisch generiert, wobei sie auch von EEP erzeugt werden k&ouml;nnte, sollte sie (aus welchen Gr&uuml;nden auch immer) bei einem Modell fehlen. Die Tatsache, dass die externe INI-Datei sowohl vom Home-Nostruktor 13.0, als auch beim Scannvorgang direkt von EEP erstellt werden kann, verdeutlicht die Bedeutsamkeit dieser kleinen Datei, denn ohne die externe INI-Datei kann in EEP kein Modell richtig funktionieren - es wird mangels Angaben nicht einmal in der Modell-Auswahlliste angeboten.
<br><br>
<table>
<tr>
<td>
[[Datei:durchsager.gif]]</td><td><font color="blue"><b>Wichtig, bitte unbedingt beachten!</b><br><br>
Jede *.3dm-Datei eines Modells muss von einer gleichnamigen *.ini-Datei begleitet werden, die sich grunds&auml;tzlich auf der gleichen Ebene (also im gleichen Verzeichnis) zu befindet hat.</font></td></table><br><br>
<b>3. Konventionen bei der externen *.ini-Datei:</b><br><br>
Die externen INI-Dateien der Modelle (auch Initialisierungsdateien genannt) sind Text-Dateien in </span><span style="font-family: Verdana;"><a href="glossar_a.htm#ansi" class="topiclink">ANSI-Codierung</a></span><span style="font-family: Verdana;">, die faktisch mit jedem Text-Editor ge&ouml;ffnet und bearbeitet werden k&ouml;nnen. Eine INI-Datei kann in Abschnitte, sogenannte Sektionen unterteilt werden, deren Namen jeweils am Anfang stehen und mit eckigen Klammern umschlossen sein m&uuml;ssen. Jede Information wird als Paar aus Schl&uuml;ssel und zugeh&ouml;rigem Wert gespeichert bzw. gelesen. Bei der Edition einer INI-Datei sind folgende Regeln zu beachten:</span></p>
<p style="margin: 0px 0px 0px 35px;"><span style="font-family: 'Arial Unicode MS', 'Lucida Sans Unicode', 'Arial';">&#8226;</span><span style="font-family: Verdana;">Jede Sektion darf nur einmal vorkommen.</span></p>
<p style="margin: 0px 0px 0px 35px;"><span style="font-family: 'Arial Unicode MS', 'Lucida Sans Unicode', 'Arial';">&#8226;</span><span style="font-family: Verdana;">Jeder Schl&uuml;ssel darf nur einmal pro Sektion vorkommen.</span></p>
<p style="margin: 0px 0px 0px 35px;"><span style="font-family: 'Arial Unicode MS', 'Lucida Sans Unicode', 'Arial';">&#8226;</span><span style="font-family: Verdana;">Auf Werte wird mittels Sektion und Schl&uuml;ssel zugegriffen.</span></p>
<p style="margin: 0px 0px 0px 35px;"><span style="font-family: 'Arial Unicode MS', 'Lucida Sans Unicode', 'Arial';">&#8226;</span><span style="font-family: Verdana;">Numerische Werte werden ohne Anf&uuml;hrungszeichen geschrieben.</span></p>
<p style="margin: 0px 0px 0px 35px;"><span style="font-family: 'Arial Unicode MS', 'Lucida Sans Unicode', 'Arial';">&#8226;</span><span style="font-family: Verdana;">Alphanumerische Werte als Beschreibung stehen zwischen zwei Anf&uuml;hrungszeichen.</span></p>
<p style="margin: 0px 0px 0px 35px;"><span style="font-family: 'Arial Unicode MS', 'Lucida Sans Unicode', 'Arial';">&#8226;</span><span style="font-family: Verdana;">Kommentare werden mit einem &quot;</span><span style="font-family: Verdana; font-weight: bold;"> ; </span><span style="font-family: Verdana;">&quot; eingeleitet.</span></p>
<p style="margin: 0px 0px 0px 35px;"><span style="font-family: 'Arial Unicode MS', 'Lucida Sans Unicode', 'Arial';">&#8226;</span><span style="font-family: Verdana;">Kommentare d&uuml;rfen nur auf separaten Zeilen (nicht hinter Sektions&uuml;berschriften oder Schl&uuml;sseln) stehen.</span></p>
<p style="margin: 0px 0px 0px 35px;"><span style="font-family: 'Arial Unicode MS', 'Lucida Sans Unicode', 'Arial';">&#8226;</span><span style="font-family: Verdana;">Leerzeichen, Zeilenvorsch&uuml;be und Anf&uuml;hrungszeichen werden von verschiedenen Text-Editoren teilweise unterschiedlich behandelt.
<br><br>

:<b>Beispiel:</b><br><br>
:<font color="blue">[Sektion]<br>
:Schuessel_Name1 = 123<br>
:Schuessel_Name2 = &quot;Alphanumerischer Wert&quot;<br>
: ; Kommentar<br><br></font><br><br>
Im Gegensatz zu den strickten Vorgaben f&uuml;r die Benennung der *.3dm-Datien, sind bei den Werten in den externen INI-Dateien auch Sonderzeichen wie: <b> @ &deg; * /</b> sowie alle spracheigenen Buchstaben ausdr&uuml;cklich erlaubt, wie z.B. die deutschen Umlaute: <b>ä, ö, ü</b>, oder das scharfe <b>ß</b>. <br>
Selbstverst&auml;ndlich gilt dieses auch f&uuml;r den franz&ouml;sischen, polnischen und ungarischen Zeichensatz, der jeweils eigene, sprach-typische Buchstaben mit sich bringt.<br><br>
<b>4. Aufruf des Editierfensters der externen *.ini-Datei:</b><br><br>
Das Grundger&uuml;st der externen INI-Datei wird vom Home-Nostruktor 13.0 bei jedem neu angelegten Projekt automatisch erzeugt, wobei die individuellen Werte bzw. Wertangaben, sowie die zus&auml;tzlich vorkommenden Schl&uuml;ssel vom Autor des Modells ausgef&uuml;llt bzw. editiert werden m&uuml;ssen.<br><br>
Der Aufruf f&uuml;r das Editierfenster der externen INI-Datei erfolgt &uuml;ber den Men&uuml;befehl:<b>
Modell --> Globale Modelleinstellungen (SYS-INI)</b>, oder noch schneller, &uuml;ber die Schaltfl&auml;che mit der Abbildung eines Zahnrades.<br><br>
<center>[[Datei:aufruf_der_externen_ini.jpg]]</center><br><br>
Das eingeblendete Fenster zeigt zun&auml;chst die internen Einstellungen und Funktionen des Modells, worauf Sie die Schaltfl&auml;che <b>[Zeige externe Modell-INI]</b>
bet&auml;tigen m&uuml;ssen, um auf die Anzeige der Inhalte der externen INI-Datei umzuschalten.<br><br>
<center>[[Datei:zeige_externe_modell-ini.jpg]]</center><br><br>
Die nachfolgende Abbildung zeigt das bereits angesprochene Grundger&uuml;st der externen INI-Datei, welches es im Bezug auf das Modell und m&ouml;gliche Begleitdateien nun zu editieren gilt.<br><br><center>
[[Datei:externe_ini.jpg]]</center><br><br>
Da Sie &uuml;ber das Wesen und die Struktur einer externen INI-Datei Bescheid wissen, k&ouml;nnen wir uns nun der Edition der Wert-Angaben und dem Hinzuf&uuml;gen g&uuml;ltiger Schl&uuml;ssel widmen. Auf den Nachfolgenden Seiten finden Sie Informationen &uuml;ber:



: - Die [[der angezeigte Modellname|Wahl des in EEP angezeigten Namens]] für Ihr Modell.<br>
: - Die [[Icon-Übersicht|Wahl eines passenden Icons]] für ihr Modell<br>
: - Die [[Eisenbahn Epochen|Bestimmung der Eisenbahn-Epoche]] für ihr Modell<br>
: - Die [[Länder-Zuordnung|Wahl des Ursprungslands]] in dem das Vorbild entwickelt wurde bzw. vorkommt.<br>
: - Die [[Kurzbeschreibung des Modells|Edition von Kurzbeschreibungen]] und die [[PDF-Dokumentation verlinken|Verlinkung von PDF-Anleitungen]].<br>
: - Die Bereitstellungen von [[Namen der Transformationsachsen|Übersetzungen für bewegliche Achsen]] Ihres Modells


[http://wiki.eepshopping.de/index.php?title=Hauptseite_EEP_Wiki&redirect=no Zurück zur Startseite]