Externe *.ini-Dateien der Modelle: Unterschied zwischen den Versionen
HW1 (Diskussion | Beiträge) |
HW1 (Diskussion | Beiträge) |
||
(52 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt) | |||
Zeile 1: | Zeile 1: | ||
− | 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. | + | Während die [[Interne_Ini-Datei_der_Modelle|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 | Einträge in der externen ini-Datei erlauben EEP | ||
* die Katalogisierung der Modelle in der Modelldatenbank (Models.db), | * die Katalogisierung der Modelle in der Modelldatenbank (Models.db), | ||
* die landesspezifische Anzeige der Modellnamen, | * die landesspezifische Anzeige der Modellnamen, | ||
− | * die Sortierung der Modelle | + | * die Sortierung der Modelle... |
− | ** nach Eisenbahn-Epochen | + | ** nach Eisenbahn-Epochen |
− | ** Ländern, in denen die Vorbilder geschaffen wurden bzw. vorkommen, | + | ** nach Ländern, in denen die Vorbilder geschaffen wurden bzw. vorkommen, |
− | ** dem Erbauer des Vorbilds sowie nach dem Autor des Modells. | + | ** nach dem Erbauer des Vorbilds sowie nach dem Autor des Modells. |
* die Anzeige kurzer Erläuterungstexte, | * die Anzeige kurzer Erläuterungstexte, | ||
− | * Verweise (Links) zu ausführlichen [[ | + | * Verweise (Links) zu ausführlichen [[PDF-Dokumentation_schreiben_und_verlinken|Dokumentationen]] , |
− | * die Anzeige der im Modell verwendeten Achsennamen in den jeweiligen Landessprachen. | + | * die Anzeige der im Modell verwendeten Achsennamen und weitere Modellbeschriftungen in den jeweiligen Landessprachen, |
− | + | * die fallweise Festlegung von Rastpunkten (SnapPoints). | |
+ | <br/> | ||
= Anlegen der Datei = | = Anlegen der Datei = | ||
− | Die interne ini-Datei kann auf | + | Die interne ini-Datei kann auf verschiedene Weisen angelegt werden: |
− | * automatisch beim Anlegen eines Projekts im Home-Nostruktor (und durch weitere Einträge aktualisiert beim Modellexport) , | + | * 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, | * bei deren Fehlen automatisch von EEP beim Modelle-Scannen, | ||
* per Hand vom Konstrukteur. | * 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 | + | 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 == | + | == Zeichenvorrat für den Dateinamen == |
Die Datei kann mit einem Texteditor bearbeitet werden. Dabei gelten diese Bedingungen: | Die Datei kann mit einem Texteditor bearbeitet werden. Dabei gelten diese Bedingungen: | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | Erlaubte und nicht erlaubte Zeichen sind in den [[Modellbaurichtlinien#Pr.C3.BCfung_der_Dateikonformit.C3.A4t|Modellbaurichtlinien]] aufgeführt. | |
− | |||
− | |||
− | |||
− | + | Manche nicht erlaubte Zeichen interpretiert EEP als Steuer- bzw. Formatierungszeichen. | |
<pre> | <pre> | ||
" (Anführung): Beginn und Ende einer Zeichenkette (String), die im Klartext ausgegeben wird | " (Anführung): Beginn und Ende einer Zeichenkette (String), die im Klartext ausgegeben wird | ||
; (Semikolon): Beginn eines Kommentars in dieser Zeile | ; (Semikolon): Beginn eines Kommentars in dieser Zeile | ||
− | |||
, (Komma): Trennung mehrerer numerischer Werte (die Werte selbst erhalten bei bedarf einen Punkt als Dezimaltrennzeichen) | , (Komma): Trennung mehrerer numerischer Werte (die Werte selbst erhalten bei bedarf einen Punkt als Dezimaltrennzeichen) | ||
\ (Rückstrich, Backslash): Reserviert für Pfadangaben | \ (Rückstrich, Backslash): Reserviert für Pfadangaben | ||
= (Gleichheitszeichen): Wertezuweisung in einem Ausdruck | = (Gleichheitszeichen): Wertezuweisung in einem Ausdruck | ||
</pre> | </pre> | ||
+ | |||
+ | [ ] (eckige Klammern) umschließen eine Sektion der ini-Datei. Innerhalb einer Zeichenkette gelten sie als Formatierungszeichen: | ||
+ | |||
+ | [e]: Zeilenumbruch | ||
+ | |||
+ | [x22]: Anführungszeichen innerhalb einer Zeichenkette | ||
+ | |||
+ | |||
+ | Diese Steuerzeichen sind zulässig: | ||
+ | |||
+ | <tt>[e]</tt> : Zeilenumbruch | ||
+ | |||
+ | <tt>[x22]</tt> : Anführungszeichen innerhalb des alphanumerischen Wertes | ||
+ | |||
+ | <pre>Description_GER = "Das ist die erste Zeile[e][x22]und hier die zweite in Anführungszeichen[x22]"</pre> | ||
+ | [[Datei:test_modellbeschreibung.jpg]] | ||
+ | |||
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. | 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. | ||
Zeile 50: | Zeile 58: | ||
== Weitere Konventionen == | == Weitere Konventionen == | ||
− | Jeder Eintrag wird in einer der Sektionen als Paar aus Schlüssel und zugehörigem Wert gespeichert bzw. gelesen. | + | [[Datei:signal_gelb.png|60px]] Jeder Eintrag wird in einer der Sektionen als Paar aus Schlüssel und zugehörigem Wert gespeichert bzw. gelesen. |
* Jede Sektion darf nur einmal vorkommen. | * Jede Sektion darf nur einmal vorkommen. | ||
* Jeder Schlüssel darf nur einmal pro Sektion vorkommen. | * Jeder Schlüssel darf nur einmal pro Sektion vorkommen. | ||
− | * Der Lesezugriff erfolgt via Sektion und | + | * Der Lesezugriff erfolgt via Sektion und Schlüssel. |
* Numerische Werte werden ohne Anführungszeichen notiert. | * Numerische Werte werden ohne Anführungszeichen notiert. | ||
* Alphanumerische Werte (Strings) stehen zwischen zwei Anführungen. | * Alphanumerische Werte (Strings) stehen zwischen zwei Anführungen. | ||
Zeile 83: | Zeile 91: | ||
</pre> | </pre> | ||
− | = | + | = Modellname = |
<pre> | <pre> | ||
− | Name_ENG = Angezeigter Name des Modells in der englischen Version von EEP | + | Name_ENG = Angezeigter Name des Modells in der englischen Version von EEP |
− | Name_GER = Angezeigter Name des Modells in der deutschen Version von EEP | + | Name_GER = Angezeigter Name des Modells in der deutschen Version von EEP |
− | Name_FRA = Angezeigter Name des Modells in der französischen Version von EEP | + | Name_FRA = Angezeigter Name des Modells in der französischen Version von EEP |
Name_POL = "Angezeigter Name des Modells in der polnischen Version von EEP | Name_POL = "Angezeigter Name des Modells in der polnischen Version von EEP | ||
</pre> | </pre> | ||
Zeile 103: | Zeile 111: | ||
== Weitere Empfehlungen == | == Weitere Empfehlungen == | ||
+ | |||
+ | [[Datei:signal_gruen.png|60px]] | ||
* Zusätze im Modellnamen, die sich auf die Versionsnummer von EEP beziehen ‒ <tt>Südbahnhof (Version14)</tt> ‒, haben sich nicht bewährt. | * Zusätze im Modellnamen, die sich auf die Versionsnummer von EEP beziehen ‒ <tt>Südbahnhof (Version14)</tt> ‒, haben sich nicht bewährt. | ||
Zeile 117: | Zeile 127: | ||
In der Praxis wurden die Felder von den Konstrukteuren beiweitem nicht immer im Sinne der ursprünglichen Idee ausgefüllt; das gilt auch für Modelle, die zum Lieferumfang von EEP selbst gehören (Grundbestand). Dennoch ist es sinnvoll, solchen Modellen, deren Vorbilder eine klar umrissenene Einsatzzeit hatten oder haben, die entsprechenden Eigenschaften in der externen ini-Datei zuzuweisen. | In der Praxis wurden die Felder von den Konstrukteuren beiweitem nicht immer im Sinne der ursprünglichen Idee ausgefüllt; das gilt auch für Modelle, die zum Lieferumfang von EEP selbst gehören (Grundbestand). Dennoch ist es sinnvoll, solchen Modellen, deren Vorbilder eine klar umrissenene Einsatzzeit hatten oder haben, die entsprechenden Eigenschaften in der externen ini-Datei zuzuweisen. | ||
− | + | = Eisenbahn-Epochen = | |
<pre> | <pre> | ||
Generation = 3 | Generation = 3 | ||
Zeile 146: | Zeile 156: | ||
|} | |} | ||
− | + | = Einsatzbeginn und -ende = | |
<pre> | <pre> | ||
Deployment_Start = 1910 | Deployment_Start = 1910 | ||
Zeile 165: | Zeile 175: | ||
[[Datei:landauswahl_eep8.jpg]] | [[Datei:landauswahl_eep8.jpg]] | ||
− | Mit der Zuordnung | + | Mit der Zuordnung mittels Länderkennzeichnung kann der Anwender seinen Modellbestand in den Auswahllisten nach Ursprungsländern filtern. |
Hinweis: Als Wert für den Schlüssel <tt>Country</tt> darf nur eines der unten aufgeführten Länderkürzel verwendet werden. Der Filtermechanismus von EEP kennt nur die vordefinierten Werte. Ist das Ursprungsland für das Vorbild des Modells nicht in der Liste enthalten, so wird der Wert <tt>Country = "Others"</tt> eingetragen. | Hinweis: Als Wert für den Schlüssel <tt>Country</tt> darf nur eines der unten aufgeführten Länderkürzel verwendet werden. Der Filtermechanismus von EEP kennt nur die vordefinierten Werte. Ist das Ursprungsland für das Vorbild des Modells nicht in der Liste enthalten, so wird der Wert <tt>Country = "Others"</tt> eingetragen. | ||
− | |||
− | |||
+ | {| class="wikitable" style="float:left; margin-right:1em; margin-top:1em;" | ||
+ | ! style="width:10%"|Flagge !! style="width:5%"|Wert !! style="width:15%"|Name in den vier von EEP unterstützten Sprachen !!style="width:5%"| Wert | ||
|- | |- | ||
| Keine Zuordnung möglich || Others || Das Ursprungsland ist in der Tabelle nicht vertreten. || Country = "Others" | | Keine Zuordnung möglich || Others || Das Ursprungsland ist in der Tabelle nicht vertreten. || Country = "Others" | ||
− | |||
|- | |- | ||
|[[Datei:at.png]] || A || Austria <br/> Österreich <br/> Autriche <br/> Austria || Country = "A" | |[[Datei:at.png]] || A || Austria <br/> Österreich <br/> Autriche <br/> Austria || Country = "A" | ||
− | |||
|- | |- | ||
|[[Datei:au.png]] || AUS || Australia <br/> Australien <br/> Australie <br/> Australia || Country = "AUS" | |[[Datei:au.png]] || AUS || Australia <br/> Australien <br/> Australie <br/> Australia || Country = "AUS" | ||
Zeile 183: | Zeile 191: | ||
|[[Datei:be.png]] || B || Belgium <br/> Belgien <br/> Belgique <br/> Belgia || Country = "B" | |[[Datei:be.png]] || B || Belgium <br/> Belgien <br/> Belgique <br/> Belgia || Country = "B" | ||
|- | |- | ||
− | |[[Datei: | + | |[[Datei:bg.png]] || BG || Bulgaria <br/> Bulgarien <br/> Bulgarie <br/> Bulgaria|| Country = "BG" |
|- | |- | ||
+ | |[[Datei:ba.png]] || BIH || Bosnia and Herzegovina <br/> Bosnien und Herzegowina<br/> Bosnie-Herzégovine <br/>Bosnia i Hercegowina|| Country = "BIH" | ||
+ | |- | ||
+ | |[[Datei:br.png]] || BR || Brazil <br/> Brasilien<br/> Brésil<br/>Brazylia|| Country = "BR" | ||
+ | |- | ||
+ | |[[Datei:ca.png]] || CND || Canada<br/> Canada<br/> Canada<br/>Canada|| Country = "CND" | ||
+ | |- | ||
+ | |[[Datei:ch.png]] || CH || Switzerland<br/> Schweiz<br/> Suisse<br/>Szwajcaria|| Country = "CH" | ||
|- | |- | ||
− | |[[Datei: | + | |[[Datei:cz.png]] || CZ || Czechoslovakia<br/> Tchechoslowakai<br/> Tchécoslovaquie<br/>Czechoslowacja <br>Die Teilung in Tschechische und Slowakische Republik siehe weiter unten.|| Country = "CZ" |
+ | |- | ||
+ | |[[Datei:cy.png]] || CY || Cyprus<br/> Zypern <br/> Chypre<br/>Cypr|| Country = "CY" | ||
+ | |- | ||
+ | |[[Datei:cz.png]] || CZ || Czech Republic<br/> Tschechien<br/> République tchèque<br/>Czechy || Country = "CZ" | ||
+ | |- | ||
+ | |[[Datei:de.png]] || D || Germany<br/> Deutschland<br/> Allemagne<br/>Niemcy|| Country = "D" | ||
+ | |- | ||
+ | |[[Datei:dk.png]] || DK || Denmark<br/> Dänemark<br/> Danemark<br/>Dania|| Country = "DK" | ||
+ | |- | ||
+ | |[[Datei:ee.png]] || E || Spain<br/> Spanien<br/> Espagne<br/>Hiszpania|| Country = "E" | ||
+ | |- | ||
+ | |[[Datei:es.png]] || EST || Estonia<br/> Estland<br/> Estonie<br/>Estonia|| Country = "EST" | ||
+ | |- | ||
+ | |[[Datei:fr.png]] || ES || France<br/> Frankreich<br/> France<br/>Francja|| Country = "F" | ||
+ | |- | ||
+ | |[[Datei:fi.png]] || FIN || Finland<br/> Finnland<br/> Finlande<br/>Finlandia|| Country = "FIN" | ||
+ | |- | ||
+ | |[[Datei:li.png]] || FL || Liechtenstein<br/> Liechtenstein<br/> le Liechtenstein<br/>Liechtenstein|| Country = "FL" | ||
+ | |- | ||
+ | |[[Datei:gb.png]] || FL || United Kingdom<br/> Großbritannien<br/> Royaume-Uni<br/>Wielka Brytania|| Country = "GB" | ||
+ | |- | ||
+ | |[[Datei:gr.png]] || GR || Greece<br/> Griechenland<br/> Grèce<br/>Grecja|| Country = "GR" | ||
+ | |- | ||
+ | |[[Datei:hu.png]] || H || Hungary<br/> Ungarn<br/> Grèce<br/>Wegry|| Country = "H" | ||
+ | |- | ||
+ | |[[Datei:hr.png]] || HR || Croatia<br/> Kroatien<br/> Croatie<br/>Chorwacja|| Country = "HR" | ||
+ | |- | ||
+ | |[[Datei:it.png]] || I || Italy<br/> Italien<br/> Italie<br/>Wlochy|| Country = "I" | ||
+ | |- | ||
+ | |[[Datei:in.png]] || IND || India<br/> Indien<br/> Inde<br/>India|| Country = "IND" | ||
|- | |- | ||
+ | |[[Datei:ie.png]] || IRL || Ireland<br/> Irland<br/> Irlande<br/>Irlandia|| Country = "IRL" | ||
+ | |- | ||
+ | |[[Datei:jp.png]] || J || Japan<br/> Japan<br/> Japon<br/>Japonia|| Country = "J" | ||
+ | |- | ||
+ | |[[Datei:lu.png]] || L || Luxembourg<br/> Luxemburg<br/> Luxembourg<br/>Luksemburg|| Country = "L" | ||
|- | |- | ||
− | |[[Datei: | + | |[[Datei:lt.png]] || LT || Lithuania<br/> Litauen<br/> Lituanie<br/>Litwa|| Country = "LT" |
|- | |- | ||
− | |- | + | |[[Datei:lv.png]] || LV || Latvia<br/> Lettland<br/> Lettonie<br/>Lotwa|| Country = "LV" |
− | |[[Datei: | + | |- |
+ | |[[Datei:mt.png]] || M || Malta<br/> Malta<br/> Malta<br/>Malta|| Country = "M" | ||
+ | |- | ||
+ | |[[Datei:mx.png]] || MEX || Mexico<br/> Mexiko<br/> Mexique<br/>Meksyk|| Country = "MEX" | ||
+ | |- | ||
+ | |[[Datei:nl.png]] || NL || Netherlands<br/> Niederlande<br/> Pays-Bas<br/>Holandia|| Country = "NL" | ||
+ | |- | ||
+ | |[[Datei:pt.png]] || P || Portugal<br/> Portugal<br/> Portugal<br/>Portugalia|| Country = "P" | ||
+ | |- | ||
+ | |[[Datei:nl.png]] || PL || Poland<br/> Polen<br/> Pologne<br/>Polska|| Country = "PL" | ||
+ | |- | ||
+ | |[[Datei:cn.png]] || RC || China<br/> China<br/> Chine<br/>Chiny|| Country = "RC" | ||
+ | |- | ||
+ | |[[Datei:ro.png]] || RO || Romania<br/> Rumänien<br/> Roumanie<br/>Rumunia|| Country = "RO" | ||
+ | |- | ||
+ | |[[Datei:ru.png]] || RUS || Russia<br/> Russland<br/> Russie<br/>Rosja|| Country = "RUS" | ||
|- | |- | ||
− | + | |[[Datei:se.png]] || S || Sweden<br/> Schweden<br/> Suède<br/>Szwecja|| Country = "S" | |
− | |[[Datei: | ||
|- | |- | ||
− | + | |[[Datei:si.png]] || SLO || Slovenia<br/> Slowenien<br/> Slovénie<br/>Slowenia|| Country = "SLO" | |
− | |[[Datei: | ||
|- | |- | ||
− | + | |[[Datei:rs.png]] || SRB || Serbia<br/> Serbien<br/> Serbie<br/>Serbia|| Country = "SRB" | |
− | |[[Datei: | ||
|- | |- | ||
− | + | |[[Datei:tr.png]] || TR || Turkey<br/> Türkei<br/> Turquie<br/>Turcja|| Country = "TR" | |
− | |[[Datei: | ||
|- | |- | ||
− | + | |[[Datei:ua.png]] || UA || Ukraine<br/> Ukraine<br/> Ukraine<br/>Ukraina|| Country = "UA" | |
− | |[[Datei: | ||
|- | |- | ||
− | + | |[[Datei:us.png]] || USA || U.S.<br/> USA<br/> Etats-Unis<br/>Stany Zjednoczone|| Country = "USA" | |
− | |[[Datei: | ||
|- | |- | ||
− | } | + | |} |
+ | |||
+ | <div style="clear:both"></div> | ||
− | + | = Namen des Erbauers und des Vorbildes = | |
− | + | <pre> | |
− | + | Creator_Model = "XY?" | |
− | + | Creator_Original = "Others" | |
− | + | </pre> | |
− | + | ||
− | + | Die Angabe des Konstrukteursnamens hilft bei der Modellsuche, wenn sie der Anwender entsprechend filtert. EEP versteht nur die dreistellige Zeichenkette einer einzigen Konstrukteursangabe. Der Konstrukteursname muss zudem in einer internen Liste abgelegt sein. Diese Liste sieht der Anwender als Checkbox-Liste. | |
− | + | ||
− | + | Im Feld <tt>Original</tt> kann jede Zeichenkette eingetragen werden; auf Anwenderseite ist hier eine Freitexteingabe möglich. Entsprechend gering ist dementsprechend die Trefferquote. | |
− | + | ||
− | + | = Modell-Icon = | |
− | + | ||
− | + | <pre> | |
− | + | Icon = n | |
− | + | </pre> | |
− | + | n: ganzzahlige Zahl | |
− | + | ||
− | + | == Für Anlagenbauer: Modell-Icons aus Anwendersicht == | |
− | + | <div> | |
− | + | <div style="float:left"> | |
− | + | [[Datei:modellauswahl_icons.jpg|left|200px|Auswahldialog]] | |
− | + | ||
− | + | <p>Die Abbildung zeigt die Modellauflistung aus Anwendersicht. Jede Zeile beginnt mit einem Icon, gefolgt von der Modellbezeichnung.</p> | |
− | + | <p>Die Modell-Icons versinnbildlichen den Typus eines Modells. Sie verdeutlichen dem Anwender das Wesen bzw. die Eignung des Modells, ohne dass er die Modellbezeichnung lesen muss - zumal diese nicht immer Aufschluss über die Art des Modells gibt wie z.B. <tt>KVS1510 TA</tt> oder <tt>QS_6Gl_4m0</tt>.</p> | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | < | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | < | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | < | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | < | ||
− | |||
− | < | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | < | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | < | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
</div> | </div> | ||
+ | </div> | ||
+ | |||
+ | <div style="clear:both"></div> | ||
+ | |||
+ | == Für Konstrukteure: Modell-Icons aus Entwicklersicht == | ||
+ | Jedes Icon hat eine unverwechselbare Nummer (ID). Der Konstrukteur gibt sie in der [[Externe *.ini-Dateien der Modelle|externen ini-Datei]] des Modells an: | ||
+ | <pre> | ||
+ | [FileInfo]<br /> | ||
+ | Name_ENG = "Cathedral"<br /> | ||
+ | Name_GER = "Dom"<br /> | ||
+ | Name_FRA = "Cathédrale"<br /> | ||
+ | Name_POL = "Kościół"<br /> | ||
+ | ... | ||
+ | Icon = 65 | ||
+ | ... | ||
+ | </pre> | ||
+ | |||
+ | Die Zahl 65 weist dem Modell bei der Installation das Icon für Sakralbauten zu. | ||
+ | |||
+ | Die [[Modellicons|Liste]] aller Modell-Icons samt ihren numerischen Entsprechungen. | ||
+ | |||
+ | == Icons wirken im Verborgenen == | ||
+ | [[Datei:signal_gelb.png|60px]] | ||
+ | |||
+ | Zu den Altlasten von eep gehört die Inkompatibilität der Ordnerstruktur, in der die Modelle abgelegt sind, mit der [[Scan-Mechanismus_und_Installationspfade_in_EEP|Kategorienstruktur (''Categories'')]], in der die Modelle dem Anwender erscheinen. In diesem Zusammenhang hilft das Icon, ein Modell in der richtigen Kategorie erscheinen zu lassen, obwohl es in einem Sammelordner mit Modellen aus anderen Kategorien abgelegt ist. | ||
+ | |||
+ | Beispiel: | ||
+ | Eine Dampflok wird im gleichen Ordner <tt>Resourcen\Rollmaterial\Schiene\Lokomotiven\..</tt> abgelegt wie eine Diesellok oder eine E-Lok. Nicht einmal die Spurweite spielt eine Rolle. | ||
+ | |||
+ | Der Anwender sieht aber diese fein ausdifferenzierte Struktur: | ||
+ | |||
+ | [[Datei:Modellauswahl_Rollmaterial.png]] | ||
+ | |||
+ | Die richtige Zuordnung der Dampfloks in diesem Bild geschieht durch die Icon-Zuweisung in der [[Externe *.ini-Dateien der Modelle|externen ini-Datei]] des Modells. | ||
+ | <pre> | ||
+ | Icon = 10 | ||
+ | </pre> | ||
+ | |||
+ | Eine Diesellok würde durch ihr <tt>Icon = 32</tt> in den gleichen Ordner installiert, jedoch für den Anwender in der Kategorie für Diesellokomotiven erscheinen. | ||
+ | |||
+ | = Achsennamen = | ||
+ | |||
+ | Damit der Anwender im Modell verbaute Achsen ansprechen kann (per Schieberegler, Kontaktpunkte, LUA), muss er klar verständliche Achsenbezeichnungen vorfinden: | ||
+ | <pre> | ||
+ | |||
+ | MovAxis?_ENG = "Displayed name of the Axis" | ||
+ | MovAxis?_GER = "Angezeigter Name der Achse" | ||
+ | MovAxis?_FRA = "Nom de l’ axe affiché" | ||
+ | MovAxis?_POL = "Wyswietlona nazwa osi" | ||
+ | </pre> | ||
+ | |||
+ | Der Konstrukteur unternimmt | ||
+ | * die Vergabe eines gültigen Namens für eine Transformationsachse im Dialogfenster der [[Achsenschachtelung]] des Home-Nostruktors. Dabei berücksichtigt er die [[Reservierte_Achsennamen|Richtlinien für reservierte System-Achsennamen]]. | ||
+ | * die Vergabe des in EEP angezeigten Namens dieser Achse in den vier von EEP unterstützten Landessprachen. | ||
+ | |||
+ | [[Datei:signal_weiss.png|60px]] | ||
+ | Klartextangaben für den Anwender sollten erst am Ende der Modellentwicklung vergeben werden. Der Home-Nostruktor nummeriert die Achsen während der Konstruktionsphase unter Umständen unterschiedlich. Die Nummer resultiert aus dem Platz, den die Achse innerhalb des Diagramms der Achsenschachtelung einnimmt und kann sich bei Löschvorgängen oder der Umplatzierung von Achsen ändern. Die Nummer bildet die logische Verknüpfung der Achse zum Klartextnamen. Sie darf vom Konstrukteur nicht verändert werden. | ||
+ | |||
+ | Hier wurde die Achse <tt>Kling-Klang</tt> erzeugt. | ||
+ | |||
+ | [[Datei:Achsennamen_vergeben_01.jpg]] | ||
+ | |||
+ | Der Home-Nostruktor hat die Achse nummeriert. | ||
+ | |||
+ | |||
+ | == Achsennamen im Steuerdialog == | ||
+ | |||
+ | Wie Achsen definiert und gekreuzt werden, schildert das Kapitel zum [[Achsenschachtelung|Achsendialog]]. Der Home-Nostruktor nummeriert alle Achsen im Projekt und versieht deren Namen mit der Nummer in dieser Schreibkonvention: | ||
+ | |||
+ | <pre> | ||
+ | Kling-klang_01 | ||
+ | </pre> | ||
+ | |||
+ | Obwohl die Achsennummer zweistellig erscheint, wird sie in der externen ini-Datei einstellig notiert: | ||
+ | |||
+ | <pre> | ||
+ | ... | ||
+ | MovAxis1_GER = "Läuten" | ||
+ | ... | ||
+ | </pre> | ||
+ | |||
+ | == Achsennamen im Klartext == | ||
+ | Der Klartextname einer Transformationsachse soll in den Sprachen Englisch, Deutsch, Französisch und Polnisch angegeben werden. Die Angaben sind auch dann erforderlich, wenn der anzuzeigende Name in den vier Sprachen identisch ist oder absichtlich so angezeigt werden soll. | ||
+ | |||
+ | <pre> | ||
+ | MovAxis1_ENG = "Ring" | ||
+ | MovAxis1_GER = "Läuten" | ||
+ | MovAxis1_FRA = "Sonner" | ||
+ | MovAxis1_POL = "Dzwonić" | ||
+ | </pre> | ||
+ | |||
+ | |||
+ | Bis auf die 25 Namen der [[Reservierte_Achsennamen|reservierten System-Achsen]] kann der Konstrukteur die Achsennamen frei wählen. Weil seitens des Trend Verlages hier nie Konventionen erarbeitet und als verbindlich deklariert worden sind, hat sich im Lauf der Zeit ein Wildwuchs an Achsenbezeichnungen ergeben. Nebeneinander existieren für die gleiche Achse z.B. "Tür rechts", "Tuer rechts", Tür_rechts", Tuer_rechts, Tuer-rechts" u.v.m. Nur die erste Form ist korrekt; sie bildet jedoch in EEP die Ausnahme. Ähnlich gelagerte Fälle betreffen Zugzielanzeigen, einstellbare Gütern in Güterwagen, Tore, Stromabnehmer, Bühnen, Kräne, Haken etc. | ||
+ | |||
+ | == Empfehlungen zur Benennung == | ||
+ | Die Notation von Achsen erlaubt die Nutzung von Wort-Filtern, was die Anzahl der benötigten Kontaktpunkte in den EEP-Anlagen verringert. Nach dem anführenden Namen folgt ein Leerzeichen, wenn weitere Namen z.B. der Beladung ("Ladung Sand", "Ladung Kohlen") benötigt werden. Diese optionalen Zusätze sind in der folgenden Auflistung durch ? markiert. | ||
+ | |||
+ | Hinweis: Eine Ausnahme davon bilden lediglich die Stromabnehmer, deren Nummer ohne Leerzeichen angefügt wird. Der vordere Stromabnehmer erhält <tt>1</tt>.<br><br> | ||
+ | |||
+ | |||
+ | <b>Arm</b> (z.B. bei Baukränen) | ||
+ | <pre> | ||
+ | MovAxis?_ENG = "Arm ?" | ||
+ | MovAxis?_GER = "Arm ?" | ||
+ | MovAxis?_FRA = "Bras ?" | ||
+ | MovAxis?_POL = "Wasiegnik ?" | ||
+ | </pre> | ||
+ | |||
+ | <b>Aufzug</b> | ||
+ | <pre> | ||
+ | MovAxis?_ENG = "Elevator ?" | ||
+ | MovAxis?_GER = "Aufzug ?" | ||
+ | MovAxis?_FRA = "Ascenseur ?" | ||
+ | MovAxis?_POL = "Winda ?" | ||
+ | </pre> | ||
+ | <b>Bühne</b> (z.B. bei Arbeitsbühnen, Schiebebühnen, Drehscheiben) | ||
+ | <pre> | ||
+ | MovAxis?_ENG = "Stage ?" | ||
+ | MovAxis?_GER = "Bühne ?" | ||
+ | MovAxis?_FRA = "Scène ?" | ||
+ | MovAxis?_POL = "Podest ?" | ||
+ | </pre> | ||
+ | |||
+ | <b>Drehen</b> | ||
+ | <pre> | ||
+ | MovAxis?_ENG = "Turn ?" | ||
+ | MovAxis?_GER = "Drehen ?" | ||
+ | MovAxis?_FRA = "Tourner ?" | ||
+ | MovAxis?_POL = "Obracanie ?" | ||
+ | </pre> | ||
+ | |||
+ | <b>Haken</b> | ||
+ | <pre> | ||
+ | MovAxis?_ENG = "Hook ?" | ||
+ | MovAxis?_GER = "Haken ?" | ||
+ | MovAxis?_FRA = "Crochet ?" | ||
+ | MovAxis?_POL = "Hak ?" | ||
+ | </pre> | ||
+ | |||
+ | <b>Heben</b> | ||
+ | <pre> | ||
+ | MovAxis?_ENG = "Lift ?" | ||
+ | MovAxis?_GER = "Heben ?" | ||
+ | MovAxis?_FRA = "Lever ?" | ||
+ | MovAxis?_POL = "Podnoszenie ?" | ||
+ | </pre> | ||
+ | |||
+ | <b>Kohle</b> (z.B. in Tendern oder Kohlebansen) | ||
+ | <pre> | ||
+ | MovAxis?_ENG = "Coal" | ||
+ | MovAxis?_GER = "Kohle" | ||
+ | MovAxis?_FRA = "Charbon" | ||
+ | MovAxis?_POL = "Wegiel" | ||
+ | </pre> | ||
+ | |||
+ | <b>Ladung</b> (alle Arten von Ladungen, die mit dem zweiten Wort spezifiziert werden) | ||
+ | <pre> | ||
+ | MovAxis?_ENG = "Freight ?" | ||
+ | MovAxis?_GER = "Ladung ?" | ||
+ | MovAxis?_FRA = "Cargaison ?" | ||
+ | MovAxis?_POL = "Ladunek ?" | ||
+ | </pre> | ||
+ | |||
+ | <b>Lokführer</b> (soweit nicht über System-Achsen: "_DriveDirF" und "_DriveDirR" gesteuert) | ||
+ | <pre> | ||
+ | MovAxis?_ENG = "Engineer ?" | ||
+ | MovAxis?_GER = "Lokführer ?" | ||
+ | MovAxis?_FRA = "Ingenieur ?" | ||
+ | MovAxis?_POL = "Maszynista ?" | ||
+ | </pre> | ||
+ | |||
+ | <b>Senken</b> | ||
+ | <pre> | ||
+ | MovAxis?_ENG = "Lower ?" | ||
+ | MovAxis?_GER = "Senken ?" | ||
+ | MovAxis?_FRA = "Baiser ?" | ||
+ | MovAxis?_POL = "Opuszczanie ?" | ||
+ | </pre> | ||
+ | |||
+ | <b>Stromabnehmer1</b> (oder Stromabnehmer2, Stromabnehmer3, Stromabnehmer4) | ||
+ | <pre> | ||
+ | MovAxis?_ENG = "Pantograph1(2,3,4)" | ||
+ | MovAxis?_GER = "Stromabnehmer1(2,3,4)" | ||
+ | MovAxis?_FRA = "Pantographe1(2,3,4)" | ||
+ | MovAxis?_POL = "Pantograf1(2,3,4)" | ||
+ | </pre> | ||
+ | |||
+ | <b>Tor</b> | ||
+ | <pre> | ||
+ | MovAxis?_ENG = "Gate ?" | ||
+ | MovAxis?_GER = "Tor ?" | ||
+ | MovAxis?_FRA = "Portail ?" | ||
+ | MovAxis?_POL = "Brama ?" | ||
+ | </pre> | ||
+ | |||
+ | <b>Tür</b> | ||
+ | <pre> | ||
+ | MovAxis?_ENG = "Door ?" | ||
+ | MovAxis?_GER = "Tür ?" | ||
+ | MovAxis?_FRA = "Porte ?" | ||
+ | MovAxis?_POL = "Drzwi ?" | ||
+ | </pre> | ||
+ | |||
+ | <b>Ziel</b> (z.B. bei Anzeigen auf dem Bahnsteig) | ||
+ | <pre> | ||
+ | MovAxis?_ENG = "Destination ?" | ||
+ | MovAxis?_GER = "Ziel ?" | ||
+ | MovAxis?_FRA = "Destination ?" | ||
+ | MovAxis?_POL = "Cel ?" | ||
+ | </pre> | ||
+ | |||
+ | <b>Zugende</b> (z.B. als Zugschlussscheiben oder Zugschlusslichter) | ||
+ | <pre> | ||
+ | MovAxis?_ENG = "End of train ?" | ||
+ | MovAxis?_GER = "Zugende ?" | ||
+ | MovAxis?_FRA = "Fin du train ?" | ||
+ | MovAxis?_POL = "Koniec pociagu ?" | ||
+ | </pre> | ||
+ | |||
+ | <b>Zugzielanzeige</b> (im Lokomotiven, Waggons usw.) | ||
+ | <pre> | ||
+ | MovAxis?_ENG = "Destination sign ?" | ||
+ | MovAxis?_GER = "Zugzielanzeige ?" | ||
+ | MovAxis?_FRA = "Destination du train ?" | ||
+ | MovAxis?_POL = "Stacja docelowa ?" | ||
+ | </pre> | ||
+ | |||
+ | = Modell-Beschreibung und Dokumentation = | ||
+ | == Modellbeschreibung == | ||
+ | |||
+ | [[Datei:modellauswahl_meigenschften.jpg]] | ||
+ | |||
+ | Das Dialogfenster <tt>Modelleigenschaften</tt> zeigt dem EEP-Anwender weitere Informationen zum Modell, die er wegen der Kürze des angezeigten Modellnamens sonst nicht kennt. | ||
+ | Dabei sollen in knapper Form Merkmale und Besonderheiten des Modells erwähnt werden. Ausführlichere Informationen, etwa zur Funktionsweise des Modells, gehören dagegen in die [[PDF-Dokumentation_schreiben_und_verlinken|Dokumentation]]. | ||
+ | |||
+ | Die Beschreibung kann in den vier von EEP unterstützten Sprachen verfasst werden: | ||
+ | <pre> | ||
+ | Description_ENG = "Description of the model in the selected language"<br> | ||
+ | Description_GER = "Beschreibung des Modells in der jeweiligen Sprache"<br> | ||
+ | Description_FRA = "Description du modele dans la langue respective"<br> | ||
+ | Description_POL = "Opis modelu w wybranym jezyku"<br> | ||
+ | </pre> | ||
+ | |||
+ | Die Beschreibung darf maximal 480 Zeichen lang sein. Längere Zeichenketten werden abgeschnitten. | ||
+ | |||
+ | == Dokumentation == | ||
+ | Dieser Abschnitt betrifft nur [[Regelwerke_und_Hinweise_für_offizielle_Konstrukteure#Doku_verfassen|offizielle Konstrukteure]] mit Vertrag. | ||
+ | |||
+ | |||
+ | = Beispiele = | ||
+ | == Straßenbahn == | ||
+ | |||
+ | <pre> | ||
+ | [FileInfo] | ||
+ | Name_ENG = "KSW TW neutral (HW1)" | ||
+ | Name_GER = "KSW TW neutral (HW1)" | ||
+ | Name_FRA = "KSW TW neutral (HW1)" | ||
+ | Name_POL = "KSW TW neutral (HW1)" | ||
+ | Description_ENG = "KSW TW neutral (HW1)" | ||
+ | Description_GER = "KSW TW in neutraler Ausführung ohne Volltauschtextur (HW1)" | ||
+ | Description_FRA = "KSW TW neutral (HW1)" | ||
+ | Description_POL = "KSW TW neutral (HW1)" | ||
+ | PdfDoc_ENG = "" | ||
+ | PdfDoc_GER = "KSW_neutral_HW1.pdf" | ||
+ | PdfDoc_FRA = "" | ||
+ | PdfDoc_POL = "" | ||
+ | Country = "D" | ||
+ | Creator_Model = "HW1" | ||
+ | Creator_Original = "Fuchs (Heidelberg)" | ||
+ | Generation = 3 | ||
+ | Deployment_Start = 1947 | ||
+ | Deployment_End = 1975 | ||
+ | Icon = 13 | ||
+ | MovAxis7_ENG = "Pantograph" | ||
+ | MovAxis7_GER = "Stromabnehmer" | ||
+ | MovAxis7_FRA = "Pantographe" | ||
+ | MovAxis7_POL = "Pantograf" | ||
+ | MovAxis12_ENG = "Track gauge" | ||
+ | MovAxis12_GER = "Spurweite" | ||
+ | MovAxis12_FRA = "Écartement des rails" | ||
+ | MovAxis12_POL = "Rozstaw szyn" | ||
+ | MovAxis20_ENG = "Destination Top" | ||
+ | MovAxis20_GER = "Linienschild Dach" | ||
+ | MovAxis20_FRA = "Terminus toit" | ||
+ | MovAxis20_POL = "Stacja koncowa dach" | ||
+ | MovAxis21_ENG = "Driver" | ||
+ | MovAxis21_GER = "Fahrer" | ||
+ | MovAxis21_FRA = "Chauffeur" | ||
+ | MovAxis21_POL = "Motorniczy" | ||
+ | MovAxis22_ENG = "Destination" | ||
+ | MovAxis22_GER = "Fahrtziel" | ||
+ | MovAxis22_FRA = "Terminus" | ||
+ | MovAxis22_POL = "Stacja koncowa" | ||
+ | MovAxis23_ENG = "Doors right side" | ||
+ | MovAxis23_GER = "Türen rechts" | ||
+ | MovAxis23_FRA = "Drzwi pojazdu na prawo" | ||
+ | MovAxis23_POL = "Türen rechts" | ||
+ | MovAxis25_ENG = "Doors left side" | ||
+ | MovAxis25_GER = "Türen links" | ||
+ | MovAxis25_FRA = "Portes à gauche" | ||
+ | MovAxis25_POL = "Drzwi pojazdu na lewo" | ||
+ | MovAxis28_ENG = "Passengers" | ||
+ | MovAxis28_GER = "Fahrgäste" | ||
+ | MovAxis28_FRA = "Passageres" | ||
+ | MovAxis28_POL = "Pasazer" | ||
+ | |||
+ | </pre> | ||
+ | [[Datei:externe_ini_Datei_Bsp_01.jpg]]<br><br> | ||
[http://wiki.eepshopping.de/index.php?title=Hauptseite_EEP_Wiki&redirect=no Zurück zur Startseite] | [http://wiki.eepshopping.de/index.php?title=Hauptseite_EEP_Wiki&redirect=no Zurück zur Startseite] |
Aktuelle Version vom 19. Mai 2021, 09:13 Uhr
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,
- nach dem Erbauer des Vorbilds sowie nach dem Autor des Modells.
- die Anzeige kurzer Erläuterungstexte,
- Verweise (Links) zu ausführlichen Dokumentationen ,
- die Anzeige der im Modell verwendeten Achsennamen und weitere Modellbeschriftungen in den jeweiligen Landessprachen,
- die fallweise Festlegung von Rastpunkten (SnapPoints).
Inhaltsverzeichnis
Anlegen der Datei
Die interne ini-Datei kann auf verschiedene Weisen 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 für den Dateinamen
Die Datei kann mit einem Texteditor bearbeitet werden. Dabei gelten diese Bedingungen:
Erlaubte und nicht erlaubte Zeichen sind in den Modellbaurichtlinien aufgeführt.
Manche nicht erlaubte 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 , (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
[ ] (eckige Klammern) umschließen eine Sektion der ini-Datei. Innerhalb einer Zeichenkette gelten sie als Formatierungszeichen:
[e]: Zeilenumbruch
[x22]: Anführungszeichen innerhalb einer Zeichenkette
Diese Steuerzeichen sind zulässig:
[e] : Zeilenumbruch
[x22] : Anführungszeichen innerhalb des alphanumerischen Wertes
Description_GER = "Das ist die erste Zeile[e][x22]und hier die zweite in Anführungszeichen[x22]"
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.
Weitere Konventionen
Jeder Eintrag wird in einer der Sektionen als Paar aus Schlüssel und zugehörigem Wert gespeichert bzw. gelesen.
- Jede Sektion darf nur einmal vorkommen.
- Jeder Schlüssel darf nur einmal pro Sektion vorkommen.
- Der Lesezugriff erfolgt via Sektion und Schlüssel.
- Numerische Werte werden ohne Anführungszeichen notiert.
- Alphanumerische Werte (Strings) stehen zwischen zwei Anführungen.
- Kommentare werden mit einem Semikolon (;) am Zeilenbeginn eingeleitet. Sie müssen einzeilig sein und dürfen nicht hinter Einträgen, sondern in einer separaten Zeile notiert werden..
Aufruf des Editierfensters der externen *.ini-Datei
Sie rufen die externe ini-Datei entweder in einem Texteditor oder im Editierfenster des Home-Nostruktors auf. Unbearbeitet sieht sie so aus:
[FileInfo] Name_ENG = "Neues_Projekt" Name_GER = "Neues_Projekt" Name_FRA = "Neues_Projekt" Name_POL = "Neues_Projekt" Icon = 23 Generation = 0 Deployment_Start = 1900 Deployment_End = 2014 Country = "D" Creator_Model = "Others" Creator_Original = "Others" Description_ENG = "" Description_GER = "" Description_FRA = "" Description_POL = ""
Modellname
Name_ENG = Angezeigter Name des Modells in der englischen Version von EEP Name_GER = Angezeigter Name des Modells in der deutschen Version von EEP Name_FRA = Angezeigter Name des Modells in der französischen Version von EEP Name_POL = "Angezeigter Name des Modells in der polnischen Version von EEP
Der Modellname, den der Anwender in der Modellauswahlliste von EEP sieht, ist nicht der Name der *.3dm-Datei; er wird vielmehr aus den Namenseinträgen in der externen *.ini-Datei des Modells ausgelesen. Auf diese Weise kann er auch sprachenspezifisch unterschiedlich lauten: Es gibt Felder für Englisch, Deutsch, Französisch und Polnisch. Das vorgefertigte Grundgerüst der Datei umfasst die vier Schlüssel:Name_ENG, Name_GER, Name_FRA und Name_POL. Die Werte tragen automatisch den Namen des aktuellen Projektes.
Wahl des Modellnamens
Gegenüber der Wahl des Dateinamens, bei der die Betriebssystem-üblichen Konventionen für die Festlegung von Dateinamen gelten, gilt für die Modellnamen der Grundsatz der guten Verständlichkeit und Plausibilität für den Anwender. Für gute Lesbarkeit soll von den erlaubten Sonderzeichen (s.o.) Gebrauch gemacht werden. Die Länge des Modellnamens ist nicht wie beim Dateinamen auf 31 Zeichen begrenzt. Sie soll so bemessen sein, dass der Anwender sie ohne zu rollen (scrollen) im Auswahlfenster lesen kann. Beispiel: Der Modellname zur Datei Tnfhs_32_XY1.3dm des Konstrukteurs XY1 kann Kühlwagen weiß (XY1) benannt werden. Es sind also Leerzeichen, Umlaute, runde Klammern (auch weitere Sonderzeichen wie diakritische Zeichen) erlaubt.
Weitere Empfehlungen
- Zusätze im Modellnamen, die sich auf die Versionsnummer von EEP beziehen ‒ Südbahnhof (Version14) ‒, haben sich nicht bewährt.
- Die Angabe des Konstrukteurskürzels im Modellnamen ‒ Südbahnhof (XY1) ‒ ist war überflüssig, weil der Anwender nach Modellen bestimmter Konstrukteure gezielt suchen kann. Als Gütesiegel ist sie jedoch berechtigt. Vor allem bei Modellen aus ähnlich konstruierten Gruppen (Flora, Fauna) ist er aus Sicht des Anwenders für die einheitliche Gestaltung einer Szenerie wünschenswert.
- Da die Modellnamen für alle vier unterstützten Sprachen eingetragen werden müssen, kann versucht werden, sie mit üblichen Online-Hilfen zu übersetzen. Eine Rückfrage bei fremdsprachigen EEP-Nutzern im Forum bewahrt u.U. vor unfreiwilligen Stilblüten. Eine gute Hilfe stellt das Nachschlagen in der deutschen Wikipedia mit anschließendem Wechsel der Wikipedia-Sprachversion dar.
Nicht vorhandene Modelle und die Online-Modellsuche
In den EEP-Anlagen werden die Modelle mit ihren *.3dm-Dateinamen, nicht jedoch mit dem angezeigten Modellnamen gespeichert. Sollten in einer Anlage Modelle fehlen, so erstellt EEP automatisch eine Fehlteilliste, die als Online-Suchanfrage an den EEP-Shop gesendet werden kann. Die Ergebnisse der Suchanfragen verweisen auf die jeweilige Bezugsquelle, wobei nicht nur kostenpflichtige Shop-Artikel, sondern auch Free-Modelle der jeweiligen Anbieter ausgewertet werden. Die Fehlteillisten im HTML-Format werden in der jeweiligen EEP-Programmversion im Ordner \Resourcen\MissingModels\ gespeichert und tragen den Namen der Anlage, bei der noch nicht installierte Modelle festgestellt wurden.
Zeitliche Einordnung des Modells / des Vorbilds
Zu den guten Vorsätzen in der Geschichte von EEP gehört die Zuordnung der Modelle zu "Epochen" (Feld Generation) oder frei zu bestimmenden Zeitabschnitten (Feld Deployment_....
In der Praxis wurden die Felder von den Konstrukteuren beiweitem nicht immer im Sinne der ursprünglichen Idee ausgefüllt; das gilt auch für Modelle, die zum Lieferumfang von EEP selbst gehören (Grundbestand). Dennoch ist es sinnvoll, solchen Modellen, deren Vorbilder eine klar umrissenene Einsatzzeit hatten oder haben, die entsprechenden Eigenschaften in der externen ini-Datei zuzuweisen.
Eisenbahn-Epochen
Generation = 3
Bei der Filterung der Modelle nach einer bestimmten Eisenbahn-Epoche sieht der Anwender die Modelle, die dem eingestellten Epochen-Filter entsprechen, sowie diejenigen Modelle, die keinem spezifischen Zeitraum zuzuordnen sind, (Landschaftselemente, oder diverse Gebäude). Auch oder weil der Konstrukteur die entsprechenden Einträge versäumt hat.
In Anlehnung an die NEM 800 unterstützt der Epochenfilter sieben Abschnitte, wobei eine weitere Unterteilung in Perioden nicht stattfindet. Perioden können jedoch vom Konstrukteur im Feld Description_... aufgeführt werden.
Bezeichner | Modell erscheint erstmals in Epoche... |
---|---|
Generation = 0 | ... kann in allen sechs Eisenbahn-Epochen vorkommen (Vorgabewert) |
Generation = 1 | I |
Generation = 2 | II |
Generation = 3 | III |
Generation = 4 | IV |
Generation = 5 | V |
Generation = 6 | VI |
Einsatzbeginn und -ende
Deployment_Start = 1910 Deployment_End = 1990
Tragen Sie hier Angaben zum Beginn des Einsatzes bzw. dessen Ende (etwa der Ausmusterung) ein. Liegt das Ende des Einsatzes in der Zukunft oder ist es unbekannt unbekannt, so ist hier als Einheitswert das Jahr 2100 einzutragen. Die Felder können leer bleiben, wenn die Einträge unerheblich sind (Landschaftselemente etc.). Wünschenswert sind sie bei Rollmaterial und Bauten.
Details zur Epochen-Zuordnung siehe |Die Eisenbahnepochen gemäß NEM 806 D
Räumliche Einordnung des Modells / des Vorbilds
Zuordnung des Ursprungslandes
Country = "D"
Mit der Zuordnung mittels Länderkennzeichnung kann der Anwender seinen Modellbestand in den Auswahllisten nach Ursprungsländern filtern. Hinweis: Als Wert für den Schlüssel Country darf nur eines der unten aufgeführten Länderkürzel verwendet werden. Der Filtermechanismus von EEP kennt nur die vordefinierten Werte. Ist das Ursprungsland für das Vorbild des Modells nicht in der Liste enthalten, so wird der Wert Country = "Others" eingetragen.
Namen des Erbauers und des VorbildesCreator_Model = "XY?" Creator_Original = "Others" Die Angabe des Konstrukteursnamens hilft bei der Modellsuche, wenn sie der Anwender entsprechend filtert. EEP versteht nur die dreistellige Zeichenkette einer einzigen Konstrukteursangabe. Der Konstrukteursname muss zudem in einer internen Liste abgelegt sein. Diese Liste sieht der Anwender als Checkbox-Liste. Im Feld Original kann jede Zeichenkette eingetragen werden; auf Anwenderseite ist hier eine Freitexteingabe möglich. Entsprechend gering ist dementsprechend die Trefferquote. Modell-IconIcon = n n: ganzzahlige Zahl Für Anlagenbauer: Modell-Icons aus AnwendersichtDie Abbildung zeigt die Modellauflistung aus Anwendersicht. Jede Zeile beginnt mit einem Icon, gefolgt von der Modellbezeichnung. Die Modell-Icons versinnbildlichen den Typus eines Modells. Sie verdeutlichen dem Anwender das Wesen bzw. die Eignung des Modells, ohne dass er die Modellbezeichnung lesen muss - zumal diese nicht immer Aufschluss über die Art des Modells gibt wie z.B. KVS1510 TA oder QS_6Gl_4m0. Für Konstrukteure: Modell-Icons aus EntwicklersichtJedes Icon hat eine unverwechselbare Nummer (ID). Der Konstrukteur gibt sie in der externen ini-Datei des Modells an: [FileInfo]<br /> Name_ENG = "Cathedral"<br /> Name_GER = "Dom"<br /> Name_FRA = "Cathédrale"<br /> Name_POL = "Kościół"<br /> ... Icon = 65 ... Die Zahl 65 weist dem Modell bei der Installation das Icon für Sakralbauten zu. Die Liste aller Modell-Icons samt ihren numerischen Entsprechungen. Icons wirken im VerborgenenFehler beim Erstellen des Vorschaubildes: Datei fehlt
Zu den Altlasten von eep gehört die Inkompatibilität der Ordnerstruktur, in der die Modelle abgelegt sind, mit der Kategorienstruktur (Categories), in der die Modelle dem Anwender erscheinen. In diesem Zusammenhang hilft das Icon, ein Modell in der richtigen Kategorie erscheinen zu lassen, obwohl es in einem Sammelordner mit Modellen aus anderen Kategorien abgelegt ist. Beispiel: Eine Dampflok wird im gleichen Ordner Resourcen\Rollmaterial\Schiene\Lokomotiven\.. abgelegt wie eine Diesellok oder eine E-Lok. Nicht einmal die Spurweite spielt eine Rolle. Der Anwender sieht aber diese fein ausdifferenzierte Struktur: Die richtige Zuordnung der Dampfloks in diesem Bild geschieht durch die Icon-Zuweisung in der externen ini-Datei des Modells. Icon = 10 Eine Diesellok würde durch ihr Icon = 32 in den gleichen Ordner installiert, jedoch für den Anwender in der Kategorie für Diesellokomotiven erscheinen. AchsennamenDamit der Anwender im Modell verbaute Achsen ansprechen kann (per Schieberegler, Kontaktpunkte, LUA), muss er klar verständliche Achsenbezeichnungen vorfinden: MovAxis?_ENG = "Displayed name of the Axis" MovAxis?_GER = "Angezeigter Name der Achse" MovAxis?_FRA = "Nom de l’ axe affiché" MovAxis?_POL = "Wyswietlona nazwa osi" Der Konstrukteur unternimmt
Fehler beim Erstellen des Vorschaubildes: Datei fehlt
Klartextangaben für den Anwender sollten erst am Ende der Modellentwicklung vergeben werden. Der Home-Nostruktor nummeriert die Achsen während der Konstruktionsphase unter Umständen unterschiedlich. Die Nummer resultiert aus dem Platz, den die Achse innerhalb des Diagramms der Achsenschachtelung einnimmt und kann sich bei Löschvorgängen oder der Umplatzierung von Achsen ändern. Die Nummer bildet die logische Verknüpfung der Achse zum Klartextnamen. Sie darf vom Konstrukteur nicht verändert werden. Hier wurde die Achse Kling-Klang erzeugt. Der Home-Nostruktor hat die Achse nummeriert.
Achsennamen im SteuerdialogWie Achsen definiert und gekreuzt werden, schildert das Kapitel zum Achsendialog. Der Home-Nostruktor nummeriert alle Achsen im Projekt und versieht deren Namen mit der Nummer in dieser Schreibkonvention: Kling-klang_01 Obwohl die Achsennummer zweistellig erscheint, wird sie in der externen ini-Datei einstellig notiert: ... MovAxis1_GER = "Läuten" ... Achsennamen im KlartextDer Klartextname einer Transformationsachse soll in den Sprachen Englisch, Deutsch, Französisch und Polnisch angegeben werden. Die Angaben sind auch dann erforderlich, wenn der anzuzeigende Name in den vier Sprachen identisch ist oder absichtlich so angezeigt werden soll. MovAxis1_ENG = "Ring" MovAxis1_GER = "Läuten" MovAxis1_FRA = "Sonner" MovAxis1_POL = "Dzwonić"
Empfehlungen zur BenennungDie Notation von Achsen erlaubt die Nutzung von Wort-Filtern, was die Anzahl der benötigten Kontaktpunkte in den EEP-Anlagen verringert. Nach dem anführenden Namen folgt ein Leerzeichen, wenn weitere Namen z.B. der Beladung ("Ladung Sand", "Ladung Kohlen") benötigt werden. Diese optionalen Zusätze sind in der folgenden Auflistung durch ? markiert. Hinweis: Eine Ausnahme davon bilden lediglich die Stromabnehmer, deren Nummer ohne Leerzeichen angefügt wird. Der vordere Stromabnehmer erhält 1.
MovAxis?_ENG = "Arm ?" MovAxis?_GER = "Arm ?" MovAxis?_FRA = "Bras ?" MovAxis?_POL = "Wasiegnik ?" Aufzug MovAxis?_ENG = "Elevator ?" MovAxis?_GER = "Aufzug ?" MovAxis?_FRA = "Ascenseur ?" MovAxis?_POL = "Winda ?" Bühne (z.B. bei Arbeitsbühnen, Schiebebühnen, Drehscheiben) MovAxis?_ENG = "Stage ?" MovAxis?_GER = "Bühne ?" MovAxis?_FRA = "Scène ?" MovAxis?_POL = "Podest ?" Drehen MovAxis?_ENG = "Turn ?" MovAxis?_GER = "Drehen ?" MovAxis?_FRA = "Tourner ?" MovAxis?_POL = "Obracanie ?" Haken MovAxis?_ENG = "Hook ?" MovAxis?_GER = "Haken ?" MovAxis?_FRA = "Crochet ?" MovAxis?_POL = "Hak ?" Heben MovAxis?_ENG = "Lift ?" MovAxis?_GER = "Heben ?" MovAxis?_FRA = "Lever ?" MovAxis?_POL = "Podnoszenie ?" Kohle (z.B. in Tendern oder Kohlebansen) MovAxis?_ENG = "Coal" MovAxis?_GER = "Kohle" MovAxis?_FRA = "Charbon" MovAxis?_POL = "Wegiel" Ladung (alle Arten von Ladungen, die mit dem zweiten Wort spezifiziert werden) MovAxis?_ENG = "Freight ?" MovAxis?_GER = "Ladung ?" MovAxis?_FRA = "Cargaison ?" MovAxis?_POL = "Ladunek ?" Lokführer (soweit nicht über System-Achsen: "_DriveDirF" und "_DriveDirR" gesteuert) MovAxis?_ENG = "Engineer ?" MovAxis?_GER = "Lokführer ?" MovAxis?_FRA = "Ingenieur ?" MovAxis?_POL = "Maszynista ?" Senken MovAxis?_ENG = "Lower ?" MovAxis?_GER = "Senken ?" MovAxis?_FRA = "Baiser ?" MovAxis?_POL = "Opuszczanie ?" Stromabnehmer1 (oder Stromabnehmer2, Stromabnehmer3, Stromabnehmer4) MovAxis?_ENG = "Pantograph1(2,3,4)" MovAxis?_GER = "Stromabnehmer1(2,3,4)" MovAxis?_FRA = "Pantographe1(2,3,4)" MovAxis?_POL = "Pantograf1(2,3,4)" Tor MovAxis?_ENG = "Gate ?" MovAxis?_GER = "Tor ?" MovAxis?_FRA = "Portail ?" MovAxis?_POL = "Brama ?" Tür MovAxis?_ENG = "Door ?" MovAxis?_GER = "Tür ?" MovAxis?_FRA = "Porte ?" MovAxis?_POL = "Drzwi ?" Ziel (z.B. bei Anzeigen auf dem Bahnsteig) MovAxis?_ENG = "Destination ?" MovAxis?_GER = "Ziel ?" MovAxis?_FRA = "Destination ?" MovAxis?_POL = "Cel ?" Zugende (z.B. als Zugschlussscheiben oder Zugschlusslichter) MovAxis?_ENG = "End of train ?" MovAxis?_GER = "Zugende ?" MovAxis?_FRA = "Fin du train ?" MovAxis?_POL = "Koniec pociagu ?" Zugzielanzeige (im Lokomotiven, Waggons usw.) MovAxis?_ENG = "Destination sign ?" MovAxis?_GER = "Zugzielanzeige ?" MovAxis?_FRA = "Destination du train ?" MovAxis?_POL = "Stacja docelowa ?" Modell-Beschreibung und DokumentationModellbeschreibungDas Dialogfenster Modelleigenschaften zeigt dem EEP-Anwender weitere Informationen zum Modell, die er wegen der Kürze des angezeigten Modellnamens sonst nicht kennt. Dabei sollen in knapper Form Merkmale und Besonderheiten des Modells erwähnt werden. Ausführlichere Informationen, etwa zur Funktionsweise des Modells, gehören dagegen in die Dokumentation. Die Beschreibung kann in den vier von EEP unterstützten Sprachen verfasst werden: Description_ENG = "Description of the model in the selected language"<br> Description_GER = "Beschreibung des Modells in der jeweiligen Sprache"<br> Description_FRA = "Description du modele dans la langue respective"<br> Description_POL = "Opis modelu w wybranym jezyku"<br> Die Beschreibung darf maximal 480 Zeichen lang sein. Längere Zeichenketten werden abgeschnitten. DokumentationDieser Abschnitt betrifft nur offizielle Konstrukteure mit Vertrag.
BeispieleStraßenbahn[FileInfo] Name_ENG = "KSW TW neutral (HW1)" Name_GER = "KSW TW neutral (HW1)" Name_FRA = "KSW TW neutral (HW1)" Name_POL = "KSW TW neutral (HW1)" Description_ENG = "KSW TW neutral (HW1)" Description_GER = "KSW TW in neutraler Ausführung ohne Volltauschtextur (HW1)" Description_FRA = "KSW TW neutral (HW1)" Description_POL = "KSW TW neutral (HW1)" PdfDoc_ENG = "" PdfDoc_GER = "KSW_neutral_HW1.pdf" PdfDoc_FRA = "" PdfDoc_POL = "" Country = "D" Creator_Model = "HW1" Creator_Original = "Fuchs (Heidelberg)" Generation = 3 Deployment_Start = 1947 Deployment_End = 1975 Icon = 13 MovAxis7_ENG = "Pantograph" MovAxis7_GER = "Stromabnehmer" MovAxis7_FRA = "Pantographe" MovAxis7_POL = "Pantograf" MovAxis12_ENG = "Track gauge" MovAxis12_GER = "Spurweite" MovAxis12_FRA = "Écartement des rails" MovAxis12_POL = "Rozstaw szyn" MovAxis20_ENG = "Destination Top" MovAxis20_GER = "Linienschild Dach" MovAxis20_FRA = "Terminus toit" MovAxis20_POL = "Stacja koncowa dach" MovAxis21_ENG = "Driver" MovAxis21_GER = "Fahrer" MovAxis21_FRA = "Chauffeur" MovAxis21_POL = "Motorniczy" MovAxis22_ENG = "Destination" MovAxis22_GER = "Fahrtziel" MovAxis22_FRA = "Terminus" MovAxis22_POL = "Stacja koncowa" MovAxis23_ENG = "Doors right side" MovAxis23_GER = "Türen rechts" MovAxis23_FRA = "Drzwi pojazdu na prawo" MovAxis23_POL = "Türen rechts" MovAxis25_ENG = "Doors left side" MovAxis25_GER = "Türen links" MovAxis25_FRA = "Portes à gauche" MovAxis25_POL = "Drzwi pojazdu na lewo" MovAxis28_ENG = "Passengers" MovAxis28_GER = "Fahrgäste" MovAxis28_FRA = "Passageres" MovAxis28_POL = "Pasazer" |