Ergänzungen zu den XML-Dateiformaten - Versionsgeschichte

Johannes: /* Einheiten */ Überhöhung

2025-04-26T15:41:24Z

Einheiten: Überhöhung

← Nächstältere Version		Version vom 26. April 2025, 17:41 Uhr
Zeile 22:		Zeile 22:
	* Winkel: in der XML-Datei im Bogenmaß gespeichert, in der Programmoberfläche in Grad angezeigt.		* Winkel: in der XML-Datei im Bogenmaß gespeichert, in der Programmoberfläche in Grad angezeigt.
	* Krümmung von Streckenelementen: in der XML-Datei in 1/m gespeichert, im 3D-Editor in 1/km angezeigt.		* Krümmung von Streckenelementen: in der XML-Datei in 1/m gespeichert, im 3D-Editor in 1/km angezeigt.
	* Überhöhung von Streckenelementen: in der XML-Datei als Winkel im Bogenmaß gespeichert, im Gleisplaneditor und 3D-Editor in Grad und in mm (gemäß eingestelltem Oberbau) angezeigt.		* Überhöhung von Streckenelementen: in der XML-Datei als Winkel im Bogenmaß gespeichert, im Gleisplaneditor und 3D-Editor in Grad und in mm (gemäß eingestelltem Oberbau) angezeigt. Positive Werte bedeuten Rechtsneigung (bei Blick vom Elementanfang zum Elementende).

	== Gleisplan (.st2) ==		== Gleisplan (.st2) ==

Johannes: /* Gleisplan (.st2) */

2024-06-06T07:21:41Z

Gleisplan (.st2)

← Nächstältere Version		Version vom 6. Juni 2024, 09:21 Uhr
Zeile 30:		Zeile 30:
	* <code><Kreisbogen></code>: Die beiden <code><PunktWinkel></code>-Elemente können leer bleiben (aber nicht weggelassen werden). Nur das dritte Element (<code><Punkt></code>, der Kreismittelpunkt) ist relevant.		* <code><Kreisbogen></code>: Die beiden <code><PunktWinkel></code>-Elemente können leer bleiben (aber nicht weggelassen werden). Nur das dritte Element (<code><Punkt></code>, der Kreismittelpunkt) ist relevant.
	* <code><Klothoide></code>: Das zweite <code><PunktWinkel></code>-Element kann leer bleiben (aber nicht weggelassen werden). Nur das erste Element ist relevant. Es gibt immer den Anfangspunkt der gesamten Klothoide, also den Punkt mit Krümmung 0, an. Bei Klothoidensektoren (<code>KrAnf</code> != 0) entspricht das einem fiktiven Anfangspunkt, der außerhalb des Klothoidensektors liegt.		* <code><Klothoide></code>: Das zweite <code><PunktWinkel></code>-Element kann leer bleiben (aber nicht weggelassen werden). Nur das erste Element ist relevant. Es gibt immer den Anfangspunkt der gesamten Klothoide, also den Punkt mit Krümmung 0, an. Bei Klothoidensektoren (<code>KrAnf</code> != 0) entspricht das einem fiktiven Anfangspunkt, der außerhalb des Klothoidensektors liegt.
			* <code><Weiche></code>: Attribut <code>BiegeWinkel</code> der <code><Biegung></code>-Elemente

	== Strecke (.st3) ==		== Strecke (.st3) ==

Johannes: /* Einheiten */

2024-05-28T20:06:44Z

Einheiten

← Nächstältere Version		Version vom 28. Mai 2024, 22:06 Uhr
Zeile 22:		Zeile 22:
	* Winkel: in der XML-Datei im Bogenmaß gespeichert, in der Programmoberfläche in Grad angezeigt.		* Winkel: in der XML-Datei im Bogenmaß gespeichert, in der Programmoberfläche in Grad angezeigt.
	* Krümmung von Streckenelementen: in der XML-Datei in 1/m gespeichert, im 3D-Editor in 1/km angezeigt.		* Krümmung von Streckenelementen: in der XML-Datei in 1/m gespeichert, im 3D-Editor in 1/km angezeigt.
	* Überhöhung von Streckenelementen: in der XML-Datei als Winkel im Bogenmaß gespeichert, im 3D-Editor in Grad und in mm (gemäß eingestelltem Oberbau) angezeigt.		* Überhöhung von Streckenelementen: in der XML-Datei als Winkel im Bogenmaß gespeichert, im Gleisplaneditor und 3D-Editor in Grad und in mm (gemäß eingestelltem Oberbau) angezeigt.

	== Gleisplan (.st2) ==		== Gleisplan (.st2) ==

Johannes: /* Gleisplan (.st2) */

2024-05-09T18:47:41Z

Gleisplan (.st2)

← Nächstältere Version		Version vom 9. Mai 2024, 20:47 Uhr
Zeile 29:		Zeile 29:
	* <code><Gerade></code>: Attribut <code>W</code> beider <code><PunktWinkel></code>-Elemente		* <code><Gerade></code>: Attribut <code>W</code> beider <code><PunktWinkel></code>-Elemente
	* <code><Kreisbogen></code>: Die beiden <code><PunktWinkel></code>-Elemente können leer bleiben (aber nicht weggelassen werden). Nur das dritte Element (<code><Punkt></code>, der Kreismittelpunkt) ist relevant.		* <code><Kreisbogen></code>: Die beiden <code><PunktWinkel></code>-Elemente können leer bleiben (aber nicht weggelassen werden). Nur das dritte Element (<code><Punkt></code>, der Kreismittelpunkt) ist relevant.
	* <code><Klothoide></code>: Das zweite <code><PunktWinkel></code>-Element kann leer bleiben (aber nicht weggelassen werden). Nur das erste Element ist relevant. Bei Klothoidensektoren (<code>KrAnf</code> != 0) ~~gibt es den~~ fiktiven Anfangspunkt der ~~gesamten Klothoide, also den Punkt mit Krümmung 0, an~~.		* <code><Klothoide></code>: Das zweite <code><PunktWinkel></code>-Element kann leer bleiben (aber nicht weggelassen werden). Nur das erste Element ist relevant. Es gibt immer den Anfangspunkt der gesamten Klothoide, also den Punkt mit Krümmung 0, an. Bei Klothoidensektoren (<code>KrAnf</code> != 0) entspricht das einem fiktiven Anfangspunkt, der außerhalb des Klothoidensektors liegt.

	== Strecke (.st3) ==		== Strecke (.st3) ==

Johannes: /* Gleisplan (.st2) */

2024-05-09T18:45:53Z

Gleisplan (.st2)

← Nächstältere Version		Version vom 9. Mai 2024, 20:45 Uhr
Zeile 28:		Zeile 28:
	Das Format ist sehr redundant, daher braucht man einige Werte nicht eintragen; sie werden vom Gleisplaneditor ignoriert und selbst berechnet:		Das Format ist sehr redundant, daher braucht man einige Werte nicht eintragen; sie werden vom Gleisplaneditor ignoriert und selbst berechnet:
	* <code><Gerade></code>: Attribut <code>W</code> beider <code><PunktWinkel></code>-Elemente		* <code><Gerade></code>: Attribut <code>W</code> beider <code><PunktWinkel></code>-Elemente
	* <code><Kreisbogen></code>: ~~die~~ beiden <code><PunktWinkel></code>-Elemente können leer bleiben (aber nicht weggelassen werden). Nur das dritte Element (<code><Punkt></code>, der Kreismittelpunkt) ist relevant.		* <code><Kreisbogen></code>: Die beiden <code><PunktWinkel></code>-Elemente können leer bleiben (aber nicht weggelassen werden). Nur das dritte Element (<code><Punkt></code>, der Kreismittelpunkt) ist relevant.
	* <code><Klothoide></code>: ~~Attribut~~ <code>W</code> ~~des zweiten~~ <code>~~<PunktWinkel>~~</code>~~-Elements~~		* <code><Klothoide></code>: Das zweite <code><PunktWinkel></code>-Element kann leer bleiben (aber nicht weggelassen werden). Nur das erste Element ist relevant. Bei Klothoidensektoren (<code>KrAnf</code> != 0) gibt es den fiktiven Anfangspunkt der gesamten Klothoide, also den Punkt mit Krümmung 0, an.

	== Strecke (.st3) ==		== Strecke (.st3) ==

Johannes: /* Gleisplan (.st2) */

2023-10-25T18:50:12Z

Gleisplan (.st2)

← Nächstältere Version		Version vom 25. Oktober 2023, 20:50 Uhr
Zeile 28:		Zeile 28:
	Das Format ist sehr redundant, daher braucht man einige Werte nicht eintragen; sie werden vom Gleisplaneditor ignoriert und selbst berechnet:		Das Format ist sehr redundant, daher braucht man einige Werte nicht eintragen; sie werden vom Gleisplaneditor ignoriert und selbst berechnet:
	* <code><Gerade></code>: Attribut <code>W</code> beider <code><PunktWinkel></code>-Elemente		* <code><Gerade></code>: Attribut <code>W</code> beider <code><PunktWinkel></code>-Elemente
	* <code><Kreisbogen></code>: die beiden <code><PunktWinkel></code>-Elemente. Nur das dritte Element (<code><Punkt></code>, der Kreismittelpunkt) ist relevant.		* <code><Kreisbogen></code>: die beiden <code><PunktWinkel></code>-Elemente können leer bleiben (aber nicht weggelassen werden). Nur das dritte Element (<code><Punkt></code>, der Kreismittelpunkt) ist relevant.
	* <code><Klothoide></code>: Attribut <code>W</code> des zweiten <code><PunktWinkel></code>-Elements		* <code><Klothoide></code>: Attribut <code>W</code> des zweiten <code><PunktWinkel></code>-Elements

Johannes: st2

2023-10-25T18:49:03Z

st2

← Nächstältere Version		Version vom 25. Oktober 2023, 20:49 Uhr
Zeile 23:		Zeile 23:
	* Krümmung von Streckenelementen: in der XML-Datei in 1/m gespeichert, im 3D-Editor in 1/km angezeigt.		* Krümmung von Streckenelementen: in der XML-Datei in 1/m gespeichert, im 3D-Editor in 1/km angezeigt.
	* Überhöhung von Streckenelementen: in der XML-Datei als Winkel im Bogenmaß gespeichert, im 3D-Editor in Grad und in mm (gemäß eingestelltem Oberbau) angezeigt.		* Überhöhung von Streckenelementen: in der XML-Datei als Winkel im Bogenmaß gespeichert, im 3D-Editor in Grad und in mm (gemäß eingestelltem Oberbau) angezeigt.

			== Gleisplan (.st2) ==

			Das Format ist sehr redundant, daher braucht man einige Werte nicht eintragen; sie werden vom Gleisplaneditor ignoriert und selbst berechnet:
			* <code><Gerade></code>: Attribut <code>W</code> beider <code><PunktWinkel></code>-Elemente
			* <code><Kreisbogen></code>: die beiden <code><PunktWinkel></code>-Elemente. Nur das dritte Element (<code><Punkt></code>, der Kreismittelpunkt) ist relevant.
			* <code><Klothoide></code>: Attribut <code>W</code> des zweiten <code><PunktWinkel></code>-Elements

	== Strecke (.st3) ==		== Strecke (.st3) ==

Johannes: /* Strecke (.st3) */ Nachfolger in anderen Modulen

2019-05-19T18:05:22Z

Strecke (.st3): Nachfolger in anderen Modulen

← Nächstältere Version		Version vom 19. Mai 2019, 20:05 Uhr
Zeile 34:		Zeile 34:
	Bei <code>NachNorm</code> und <code>NachGegen</code> handelt es sich um die Nummer eines ''Streckenelements'' im selben Modul.		Bei <code>NachNorm</code> und <code>NachGegen</code> handelt es sich um die Nummer eines ''Streckenelements'' im selben Modul.

	Bei <code>NachNormModul</code> und <code>NachGegenModul</code> handelt es sich um die Nummer eines ''Referenzpunkts'' im durch den <code>Datei</code>-Kindknoten angegebenen Modul.		Bei <code>NachNormModul</code> und <code>NachGegenModul</code> handelt es sich um die Nummer eines ''Referenzpunkts'' im durch den <code>Datei</code>-Kindknoten angegebenen Modul. Der Referenzpunkt ist vom Typ "Modulgrenze" und zeigt in Richtung der Modulgrenze. Existiert so ein Referenzpunkt nicht, erscheint beim Verknüpfen des Streckennetzes die Fehlermeldung ''Auf Element-Nr. %d folgt Nr. %d in Modul "%s", ist dort aber nicht als Schnittstelle definiert (Verknüpfung nicht hergestellt)''

			=== Reihenfolge <code>NachNorm</code> und <code>NachNormModul</code> bzw. <code>NachGegen</code> und <code>NachGegenModul</code> ===

			Der 3D-Editor schreibt die Knoten immer in der festen Reihenfolge:
			# alle <code>NachNorm</code>-Knoten
			# alle <code>NachGegen</code>-Knoten
			# alle <code>NachNormModul</code>-Knoten
			# alle <code>NachGegenModul</code>-Knoten

			Ein Mischen von <code>NachXXX</code> und <code>NachXXXModul</code> im selben Streckenelement ist also nicht möglich. Dass in derselben Richtung sowohl Nachfolger im selben als auch in anderen Modulen vorhanden sind, ist ohnehin ein theoretischer Fall, der keine sinnvolle Anwendung hat. Hat ein Element in einer Richtung Nachfolger im selben Modul, so ignoriert die Fahrstraßenerzeugung des 3D-Editors Nachfolger in anderen Modulen bei der Fahrstraßenerzeugung.

	=== <code>Anschluss</code>-Attribut des <code>StrElement</code>-Knotens ===		=== <code>Anschluss</code>-Attribut des <code>StrElement</code>-Knotens ===

Johannes: /* Allgemeines */ leere Attribute -> Standardwert

2019-03-12T19:07:24Z

Allgemeines: leere Attribute -> Standardwert

← Nächstältere Version		Version vom 12. März 2019, 21:07 Uhr
Zeile 3:		Zeile 3:
	== Allgemeines ==		== Allgemeines ==

	* Bei Attributen existiert für jeden Typ ein Standardwert, der verwendet wird, wenn das Attribut nicht vorhanden ist. Es folgt daraus, dass das Attribut auch beim Schreiben weggelassen werden kann, wenn sein Wert dem Standardwert entspricht. Zusi macht das konsequent so. [http://forum.zusi.de/viewtopic.php?p=233206#p233206 Quelle.] Der Standardwert ist		* Bei Attributen existiert für jeden Typ ein Standardwert, der verwendet wird, wenn das Attribut nicht vorhanden oder leer (Attribut="") ist. Es folgt daraus, dass das Attribut auch beim Schreiben weggelassen werden kann, wenn sein Wert dem Standardwert entspricht. Zusi macht das konsequent so. [http://forum.zusi.de/viewtopic.php?p=233206#p233206 Quelle.] Der Standardwert ist
	** bei Ganzzahlen (integer, integer 64 bit, integer enum, bool) der Wert <code>0</code>.		** bei Ganzzahlen (integer, integer 64 bit, integer enum, bool) der Wert <code>0</code>.
	** bei Gleitkommazahlen (single) der Wert <code>0.0</code>.		** bei Gleitkommazahlen (single) der Wert <code>0.0</code>.

Johannes: Einheiten

2018-02-04T19:32:24Z

Einheiten

← Nächstältere Version		Version vom 4. Februar 2018, 21:32 Uhr
Zeile 13:		Zeile 13:
	** wenn sie keinen Backslash enthalten, Dateien im selben Verzeichnis wie die Datei, in der der Pfad steht.		** wenn sie keinen Backslash enthalten, Dateien im selben Verzeichnis wie die Datei, in der der Pfad steht.
	:Insbesondere können Dateien, die auf einem anderen Laufwerk als das Zusi-Datenverzeichnis liegen, nicht referenziert werden.		:Insbesondere können Dateien, die auf einem anderen Laufwerk als das Zusi-Datenverzeichnis liegen, nicht referenziert werden.
	* Geschwindigkeiten werden in der Einheit Meter pro Sekunde angegeben. Ausnahme sind <code>Wert</code>-Attribute in <code>Ereignis</code>-Knoten der Ereignisse "Indusi 1000 Hz" und "Indusi 2000 Hz".
	* Programmseitig generierte XML-Dateien, die UTF-8-kodiert sind, sollten eine Byte Order Mark (<code>0xEF,0xBB,0xBF</code>) am Anfang enthalten, damit Texteditoren sie zuverlässig als UTF-8 erkennen, siehe [[UTF-8 Byte Order Mark setzen]].		* Programmseitig generierte XML-Dateien, die UTF-8-kodiert sind, sollten eine Byte Order Mark (<code>0xEF,0xBB,0xBF</code>) am Anfang enthalten, damit Texteditoren sie zuverlässig als UTF-8 erkennen, siehe [[UTF-8 Byte Order Mark setzen]].
	* Bei Gleitkommazahlen werden sowohl Punkt als auch Komma als Dezimaltrenner betrachtet. In alten Dateien findet sich im Knoten <code>Info</code> das Attribut <code>DecSep</code>, das aber anscheinend ignoriert wird.		* Bei Gleitkommazahlen werden sowohl Punkt als auch Komma als Dezimaltrenner betrachtet. In alten Dateien findet sich im Knoten <code>Info</code> das Attribut <code>DecSep</code>, das aber anscheinend ignoriert wird.

			== Einheiten ==

			Einige Werte werden in der XML-Datei anders gespeichert, als sie in der Benutzeroberfläche von Zusi angezeigt werden.
			* Geschwindigkeiten: in der XML-Datei in m/s gespeichert, in der Programmoberfläche (derzeit) in km/h angezeigt. Ausnahme sind die <code>Wert</code>-Attribute in <code>Ereignis</code>-Knoten der Ereignisse "Indusi 1000 Hz" und "Indusi 2000 Hz". Diese werden in der XML-Datei in km/h gespeichert.
			* Winkel: in der XML-Datei im Bogenmaß gespeichert, in der Programmoberfläche in Grad angezeigt.
			* Krümmung von Streckenelementen: in der XML-Datei in 1/m gespeichert, im 3D-Editor in 1/km angezeigt.
			* Überhöhung von Streckenelementen: in der XML-Datei als Winkel im Bogenmaß gespeichert, im 3D-Editor in Grad und in mm (gemäß eingestelltem Oberbau) angezeigt.

	== Strecke (.st3) ==		== Strecke (.st3) ==