Externe *.ini-Dateien der Modelle: Unterschied zwischen den Versionen

Aus EEP Wiki
Wechseln zu: Navigation, Suche
Zeile 21: Zeile 21:
 
In der Praxis wird der Konstrukteur die vom Home-Nostruktor automatisch angelegte Datei modifizieren. Zu jedem Modell gehört eine externe ini-Datei; sie muss im gleichen verzeichnis wie das Modell selbst liegen und trägt (bis auf die Dateierweiterung) den exakt gleichen Namen.
 
In der Praxis wird der Konstrukteur die vom Home-Nostruktor automatisch angelegte Datei modifizieren. Zu jedem Modell gehört eine externe ini-Datei; sie muss im gleichen verzeichnis wie das Modell selbst liegen und trägt (bis auf die Dateierweiterung) den exakt gleichen Namen.
  
 +
=== Zeichenvorrat ===
 
Die Datei kann mit einem Texteditor bearbeitet werden. Dabei gelten diese Bedingungen:
 
Die Datei kann mit einem Texteditor bearbeitet werden. Dabei gelten diese Bedingungen:
<table>
+
Erlaubte Zeichen
<tr>
+
<pre>
<td>
+
! # $ &pound; € % &amp; ' &deg; @ ( ) * + - _ . : / 0 1 2 3 4 5 6 7 8 9 &lt; &gt; ? ^
[[Datei:durchsager.gif]]</td><td><font color="blue"><b>Wichtig, bitte unbedingt beachten!</b><br><br>
+
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Ä Ö Ü<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>
+
a b c d e f g h i j k l m n o p q r s t u v w x y z à ä ç é è ö ù ü ß
 +
</pre>
 +
 
 +
Nicht erlaubte Zeichen sind
 +
<pre>
 +
" [ ] , ; \ =
 +
</pre>
 +
 
 +
Die nicht erlaubten Zeichen interpretiert EEP als Steuer- bzw. Formatierungszeichen.
 +
 
 +
<pre>
 +
" (Anführung): Beginn und Ende einer Zeichenkette (String), die im Klartext ausgegeben wird
 +
; (Semikolon): Beginn eines Kommentars in dieser Zeile
 +
[ ] (eckige Klammern): Umschließen eine Sektion der ini-Datei
 +
, (Komma): Trennung mehrerer numerischer Werte (die Werte selbst erhalten bei bedarf einen Punkt als Dezimaltrennzeichen)
 +
\ (Rückstrich, Backslash): Reserviert für Pfadangaben
 +
= (Gleichheitszeichen): Wertezuweisung  in einem Ausdruck
 +
</pre>
 +
 
 +
Hinweis: Damit die Sonderzeichen auch in EEP korrekt dargestellt werden, muss die ini-Datei im ANSI-Format gespeichert werden. Viele Texteditoren (nicht jedoch der Editor von Windows) können in das ANSI-Format konvertieren.
 +
 
  
 
== Konventionen bei der externen *.ini-Datei ==
 
== Konventionen bei der externen *.ini-Datei ==

Version vom 17. Oktober 2017, 07:42 Uhr

Grundsätzliches

Während die interne ini-Datei beim Export in die Modelldatei eingekapselt wird, liegt die externe ini-Datei im Klartext in einer separaten Datei vor. Sie kann theoretisch vom Anwender bearbeitet werden. Ihre Einträge sind für die Darstellung der Modelle in der Modellauswahllisten relevant. Einträge in der externen ini-Datei erlauben EEP

  • die Katalogisierung der Modelle in der Modelldatenbank (Models.db),
  • die landesspezifische Anzeige der Modellnamen,
  • die Sortierung der Modelle
    • nach Eisenbahn-Epochen nach...
    • Ländern, in denen die Vorbilder geschaffen wurden bzw. vorkommen,
    • dem Erbauer des Vorbilds sowie nach dem Autor des Modells.
  • die Anzeige kurzer Erläuterungstexte,
  • Verweise (Links) zu ausführlichen Anleitungen im PDF-Format
  • die Anzeige der im Modell verwendeten Achsennamen in den jeweiligen Landessprachen.

Anlegen der Datei

Die interne ini-Datei kann auf mindestens drei Arten angelegt werden:

  • automatisch beim Anlegen eines Projekts im Home-Nostruktor (und durch weitere Einträge aktualisiert beim Modellexport) ,
  • bei deren Fehlen automatisch von EEP beim Modelle-Scannen,
  • per Hand vom Konstrukteur.

In der Praxis wird der Konstrukteur die vom Home-Nostruktor automatisch angelegte Datei modifizieren. Zu jedem Modell gehört eine externe ini-Datei; sie muss im gleichen verzeichnis wie das Modell selbst liegen und trägt (bis auf die Dateierweiterung) den exakt gleichen Namen.

Zeichenvorrat

Die Datei kann mit einem Texteditor bearbeitet werden. Dabei gelten diese Bedingungen: Erlaubte Zeichen

! # $ £ € % & ' ° @ ( ) * + - _ . : / 0 1 2 3 4 5 6 7 8 9 < > ? ^
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Ä Ö Ü<br>
a b c d e f g h i j k l m n o p q r s t u v w x y z à ä ç é è ö ù ü ß

Nicht erlaubte Zeichen sind

" [ ] , ; \ =

Die nicht erlaubten Zeichen interpretiert EEP als Steuer- bzw. Formatierungszeichen.

" (Anführung): Beginn und Ende einer Zeichenkette (String), die im Klartext ausgegeben wird
; (Semikolon): Beginn eines Kommentars in dieser Zeile
[ ] (eckige Klammern): Umschließen eine Sektion der ini-Datei
, (Komma): Trennung mehrerer numerischer Werte (die Werte selbst erhalten bei bedarf einen Punkt als Dezimaltrennzeichen)
\ (Rückstrich, Backslash): Reserviert für Pfadangaben
= (Gleichheitszeichen): Wertezuweisung  in einem Ausdruck

Hinweis: Damit die Sonderzeichen auch in EEP korrekt dargestellt werden, muss die ini-Datei im ANSI-Format gespeichert werden. Viele Texteditoren (nicht jedoch der Editor von Windows) können in das ANSI-Format konvertieren.


Konventionen bei der externen *.ini-Datei

Die externen INI-Dateien der Modelle (auch Initialisierungsdateien genannt) sind Text-Dateien in <a href="glossar_a.htm#ansi" class="topiclink">ANSI-Codierung</a>, die faktisch mit jedem Text-Editor geöffnet und bearbeitet werden können. Eine INI-Datei kann in Abschnitte, sogenannte Sektionen unterteilt werden, deren Namen jeweils am Anfang stehen und mit eckigen Klammern umschlossen sein müssen. Jede Information wird als Paar aus Schlüssel und zugehörigem Wert gespeichert bzw. gelesen. Bei der Edition einer INI-Datei sind folgende Regeln zu beachten:

Jede Sektion darf nur einmal vorkommen.

Jeder Schlüssel darf nur einmal pro Sektion vorkommen.

Auf Werte wird mittels Sektion und Schlüssel zugegriffen.

Numerische Werte werden ohne Anführungszeichen geschrieben.

Alphanumerische Werte als Beschreibung stehen zwischen zwei Anführungszeichen.

Kommentare werden mit einem " ; " eingeleitet.

Kommentare dürfen nur auf separaten Zeilen (nicht hinter Sektionsüberschriften oder Schlüsseln) stehen.

Leerzeichen, Zeilenvorschübe und Anführungszeichen werden von verschiedenen Text-Editoren teilweise unterschiedlich behandelt.

Beispiel:

[Sektion]
Schuessel_Name1 = 123
Schuessel_Name2 = "Alphanumerischer Wert"
 ; Kommentar



Im Gegensatz zu den strickten Vorgaben für die Benennung der *.3dm-Datien, sind bei den Werten in den externen INI-Dateien auch Sonderzeichen wie: @ ° * / sowie alle spracheigenen Buchstaben ausdrücklich erlaubt, wie z.B. die deutschen Umlaute: ä, ö, ü, oder das scharfe ß.
Selbstverständlich gilt dieses auch für den französischen, polnischen und ungarischen Zeichensatz, der jeweils eigene, sprach-typische Buchstaben mit sich bringt.

Aufruf des Editierfensters der externen *.ini-Datei

Das Grundgerü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ätzlich vorkommenden Schlüssel vom Autor des Modells ausgefüllt bzw. editiert werden müssen.

Der Aufruf für das Editierfenster der externen INI-Datei erfolgt über den Menübefehl: Modell --> Globale Modelleinstellungen (SYS-INI), oder noch schneller, über die Schaltfläche mit der Abbildung eines Zahnrades.

Aufruf der externen ini.jpg



Das eingeblendete Fenster zeigt zunächst die internen Einstellungen und Funktionen des Modells, worauf Sie die Schaltfläche [Zeige externe Modell-INI] betätigen müssen, um auf die Anzeige der Inhalte der externen INI-Datei umzuschalten.

Zeige externe modell-ini.jpg



Die nachfolgende Abbildung zeigt das bereits angesprochene Grundgerüst der externen INI-Datei, welches es im Bezug auf das Modell und mögliche Begleitdateien nun zu editieren gilt.

Externe ini.jpg



Da Sie über das Wesen und die Struktur einer externen INI-Datei Bescheid wissen, können wir uns nun der Edition der Wert-Angaben und dem Hinzufügen gültiger Schlüssel widmen. Auf den Nachfolgenden Seiten finden Sie Informationen über:


- Die Wahl des in EEP angezeigten Namens für Ihr Modell.
- Die Wahl eines passenden Icons für ihr Modell
- Die Bestimmung der Eisenbahn-Epoche für ihr Modell
- Die Wahl des Ursprungslands in dem das Vorbild entwickelt wurde bzw. vorkommt.
- Die Edition von Kurzbeschreibungen und die Verlinkung von PDF-Anleitungen.
- Die Bereitstellungen von Übersetzungen für bewegliche Achsen Ihres Modells


Zurück zur Startseite