Differences

This shows you the differences between two versions of the page.

--- symbols-de [2020/01/15 15:52] – rainerk
+++ symbols-de [2024/03/14 00:35] (current) – [Thema 1 - 6] rainerk
@@ Line 15: / Line 15: @@
  \\
 =====Das offizielle SpDrS60-Thema=====
-Das ofizielle Thema ist __**[[:symbols-themes-spdr60-de|SpDrS60]]**__.\\
+Das offizielle Thema ist __**[[:symbols-themes-spdr60-de|SpDrS60]]**__.\\
 Für Tests und Problemmeldungen sollte dieses Thema verwendet werden.\\
 Alle anderen Themen müssen der Namens-, Verbindungs- und Größen-Konvention des SpDrS60-Themas entsprechen.\\
@@ Line 21: / Line 21: @@
  \\
 =====Einstellungen=====
-{{rocgui-ini-svg-de.png?0x460}}\\
+  * **Hinweis:** Mit Rev. 2.1.4068+ wurde der Dialog für ein 6. Thema erweitert.
+|< >|
+|  {{rocgui-ini-svg-de.png?700}}  |
+|  Rocview-Egenschaften, Registerkarte 'SVG' mit geöffnetem Eigenschafts-Dialog zu **Thema 1**  |
+| **Achtung:** Für **RocWeb** und **andRoc** müssen die SVG-Pfade im **[[rocrailini-rocweb-de#rocweb-einstellungen|RocWeb-Dialog der Rocrail-Eigenschaften]]** eingestellt werden.|
+|< >|
+|  **wenn für einen Objekt-Typ keine passende SVG-Datei gefunden wird, \\ zeigt der Gleisplan an der Position ein Fehler-Symbol.**  |
+|  {{:symbols:errsym.png}}  |
+|  **SVG-Datei nicht gefunden**  |
+> **Hinweis:**
+> Möglche Ursachen:
+> Es müssen noch weitere Themen definiert werden, z.B.  **''User, Accessories''**.
+> Für einige Objekttypen erforderliche SVG-Nummer, Zubehör-Option und/oder Zubehör-Nummer sind nicht oder falsch definiert.
 \\
-==== Thema 1 - 5 ====
+==== Thema 1...6 ====
 Einstellen des Pfades zum Verzeichnis des gewünschten Themas. Erforderlich ist ein __Neustart von Rocview um es zu aktivieren__.\\
 Sollen eigene definierte SVG-Symbole verwendet werden, muss der entsprechende Pfad zu diesen Symbolen als erster in die Themenliste gesetzt werden. \\
@@ Line 30: / Line 47: @@
 Das bedeutet, dass jeweils das erste Thema bestimmt, wie ein SVG-Symbol aussieht.\\
-====[ . . . ]====
+====Dreipunkt-Schaltfläche [ . . . ]====
 Öffnet die Explorer-Sicht zur Auswahl des gewünschten Verzeichnisses für das Thema.
 \\
@@ Line 39: / Line 56: @@
 ==== Schriftgröße für Objekt-Kennungen ====
-Stellt die Schriftgröße der Kennung am  Objekt-Symbol im Gleisplan ein. Voreingestellt ist **7**.\\
+Stellt die Schriftgröße der Kennung am  Objekt-Symbol im Gleisplan ein. Bereich 2 bis 15. Voreingestellt ist **7**.\\
 __Rocview muss neugestartet werden, damit Änderungen aktiviert werden.__
 \\
-===Farbe...===
+====Farbe====
-Im Standarddialog kann die Schrift-Farbe der Objekt-Kennung eingestellt werden. Schwarz ist voreingestellt.
+Zeigt die eingestellte Farbe für die Schrift der Objekt-Kennung. Mit Klick der linken Maustaste wird der Standarddialog des Betriebssystems geöffnet, in dem die Farbe eingestellt werden kann. Schwarz ist voreingestellt.
 \\
@@ Line 50: / Line 67: @@
 Stellt die Schriftgröße für Block-Kennungen und für Text-Objekte mit Schriftgröße 0 ein. \\
 Beste Ergebnisse für: ((Abhängig von Bildschirm-Auflösung und pers. Geschmack.))
-  * OS X = 14
+  * macOS = 14
   * Linux = 13
   * Windows = 10
   * Default = 10
-__Rocview muss neugestartet werden, damit Änderungen aktiviert werden.__\\
-\\
+==== Anpassen ====
+Das Feld dient der Anpassung der Textpunktgröße von -100% bis +100%. Dies kann hilfreich sein, wenn mehrere Rocviews auf verschiedenen Plattformen / Auflösungen mit demselben Server verbunden sind. \\
+|< >|
+^ Beispiele ^^
+|  {{:rocview:text-ps-mac-2560x1600.png?0x100}}  |  {{:rocview:text-ps-win-1920x1280.png?0x100}}  |  {{:rocview:text-ps-win-1920x1280-50.jpg?0x100}}  |
+|  Mac 2560x1600  |  Windows 1920x1280  |  Windows 1920x1280 -50%  |
+__Rocview muss neugestartet werden, damit Änderungen aktiviert werden.__
+====ZBL-Punktgröße====
+Größe der Beschriftung der CTC-SVG-Symbole.
+==== Auto Kennungsbreite ====
+Wenn 3 eingestellt ist, beginnen die Objekt-Kennungen mit 100: Z.B. **sw100** \\
+Wenn 0 oder 1 eingestellt ist, beginnen die Objekt-Kennungen ohne führende Nullen: z.B. **sw1** \\
+==== Zug-Verbinder ====
+Das Zeichen, das verwendet wird, um die Lok- und Zug-Kennungen zu verbinden.\\
+Standard ist ein Unterstrich.\\
+Beispiel mit Gleichheitszeichen "=": (Lok-Kennung="V20_020", Zug-Kennung="HsDh")\\
+{{:rocview:block-trainconnector.jpg}}\\
+==== Schwarz ersetzen ====
+Ersetzt //'im laufenden Betrieb'// alle ''stroke="rgb(0,0,0)"''-Definitionen durch die ausgewählte Farbe.\\
+Könnte nützlich sein, falls der Fenster-Hintergrund eine dunkle Farbe hat.
+ \\
+=====Optionen=====
 ==== Zeige Fahrstraßen-/Block-Ausleuchtung ====
 Auf Systemen mit geringer Grafik- und/oder Hauptprozessorleistung können die folgenden Optionen deaktiviert werden, um die Beanspruchung der Resourcen zu reduzieren: \\
@@ Line 67: / Line 110: @@
 Nur das **SpDrS60**-Thema enthält die erforderlichen SVGs.\\
 {{:rocview:sw-routes.png}}\\
-Wenn die Fahrstraßen mit einer Revision älter als 7884 erzeugt wurden, muss der Analyzer erneut gestartet werden,\\
+Wenn die Fahrstraßen mit einer Revision älter als 7884 erzeugt wurden, muss der Router erneut gestartet werden,\\
 damit die Fahrstraßen-Kennungen automatisch in die Weichen-Objekte eingetragen werden. \\
-Im Fall manueller Fahrstraßen den __**[[:select-de|Auswahl-Dialog]]**__ verwenden.
+Im Fall manuell angelegter Fahrstraßen den __**[[:select-de|Auswahl-Dialog]]**__ verwenden.
  \\
 ====Fahrstraße priorisieren====
 Überschreibt die Blockbelegung, falls eine Fahrstraße reserviert ist.
  \\
+====Zeige Kurz-Kennung====
+Zeigt anstelle der Lok-Kennung die **[[:loc-gen-de#benutze_kurz-kennung|Kurz-Kennung]]** im Block.\\
+ \\
 =====Gleis-/Straßen-Plan=====
@@ Line 84: / Line 132: @@
 ==== Text-Editor ====
   * Am Ende dieser Seite ist ein zweiteiliges **[[#videos|Video-Tutorial]]** zum Thema
-Wenn man eigene Symbole für Gleisplan-Objekte verwenden möchte, dann müssen diese im SVG-Format erstellt werden.\\
+Wenn eigene Symbole für Gleisplan-Objekte verwendet werden sollen, dann müssen diese im SVG-Format erstellt werden.\\
 Die Attribute **''width''** und **''hight''** in der SVG-Datei werden verwendet, um die Größe des Symbols im Gleisplan zu berechnen.\\
 Es muss allerdings sichergestellt sein, dass diese Werte ein Vielfaches von 32 darstellen. \\
@@ Line 91: / Line 139: @@
 \\
 Die Dateinamen für die einzelnen Symbole mit den jeweiligen Zuständen sind vordefiniert. Siehe: **[[symbolnames-de|Symbol-Namen]]**
-\\
+**Hinweis:** In Dateinamen dürfen __keine Großbuchstaben__ enthalten sein
+==== Selbst erstellte Symbole in den Gleisplan einfügen ====
+:!: Selbst erstellte SVG-Symbole werden __NICHT__ im Dialog **[[rocgui-menu-de#symbol_hinzufuegen|Symbol hinzufügen]]** dargestellt. \\ Zum Einfügen dieser Symbole in den Gleisplan muss ein Standardsymbol des gewünschten Objekttyps ausgewählt werden. Die Nummer des eigenen Symbols muss im Eigenschaften-Dialog des Objekts in den Feldern **[[output-gen-de#svg|SVG]]**, **[[tracks-gen-de#nummer|Nummer]]** oder **[[sensor-gen-de#zubehoer|Zubehör#]]** eingestellt werden. Bei Objekt-Typen mit der Option **Zubehör** kann festgelegt werden, ob das Symbol aus dem //accessory//-Thema verwendet werden soll.
 =====Unterstützte SVG-Elemente=====
-====Pfad====
+====Pfad (path)====
   * https://developer.mozilla.org/en-US/docs/Web/SVG/Element/path
 Nur **M**, **L**, **C** und **z** werden ausgewertet. Alle Koordinaten werden zu Ganzzahlen gerundet.
  \\
+===Attribute und Befehle im <path-Element===
 ^Befehl^Name^Beschreibung^
 |**M** x,y|moveto|Bewegt den Zeichenstift auf die angegebene Koordinate.|
@@ Line 102: / Line 155: @@
 |**z**|closepath|Schließt den Zeichenvorgang des aktuellen <path> ab.|
-Die x/y-Koordinaten eines Symbols mit 32x32 Pixel:
+Die Attribute **''stroke''** und **''stroke-width''** definieren die Farbe und Stärke der gezeichneten "Linien"; optional bestimmt **''fill''** die Füll-Farbe einer mit den Parametern des **d**-Attributs umschlossenen Fläche.\\
-|< >|
+Farben können anstelle von z.B. **''stroke="blue"''** auch mit der RGB-Funktion **''stroke="rgb(0,0,255)"''** definiert werden.\\
-|  ''0 0''  |  . .  |  ''31 0''  |
+Damit sind beliebige Mischfarben aus dem 32bit-Farbraum möglich, soweit es die PC-Grafik-Hardware unterstützt.\\
-|  . .  |  |  . .  |
+Die Befehle mit ihren Koordinaten werden im **d**-Attribut (**d**raw = zeichnen) definiert, dass __immner__ mit dem **M**-Befehl beginnt und mit dem **z**-Befehl endet.\\
-|  ''0 31''  |  . .  |  ''31 31''  |
+===Beispiele===
 Das folgende Beispiel (Gleis mit blauer Umrandung und gelber Füllung) zeigt, welche Informationen einer SVG-Datei durch Rocview ausgewertet werden:
 <code xml>
@@ Line 116: / Line 168: @@
 </svg>
 </code>
-====Attribute und Befehle====
-Die Attribute **''stroke''** und **''stroke-width''** definieren die Farbe und Stärke der gezeichneten "Linien"; optional bestimmt **''fill''** die Füll-Farbe einer mit den Parametern des **d**-Attributs umschlossenen Fläche.\\
-Farben können anstelle von z.B. **''stroke="blue"''** auch mit der RGB-Funktion **''stroke="rgb(0,0,255)"''** definiert werden.\\
-Damit sind beliebige Mischfarben aus dem 32bit-Farbraum möglich, soweit es die PC-Grafik-Hardware unterstützt.\\
-Die Befehle mit ihren Koordinaten werden im **d**-Attribut (**d**raw = zeichnen) definiert, dass __immner__ mit dem **M**-Befehl beginnt und mit dem **z**-Befehl endet.\\
  \\
-====Kreis====
+====Kreis (circle)====
-  * https://developer.mozilla.org/en-US/docs/Web/SVG/Element/path
+  * https://developer.mozilla.org/en-US/docs/Web/SVG/Element/circle
 <code xml>
 <svg xmlns="http://www.w3.org/2000/svg" width="32" height="32">
@@ Line 133: / Line 178: @@
 </svg>
 </code>
+**Hinweis:** //Wenn der Radius "r" Null ist, wird dieses SVG-Element übersprungen.//\\
 ====Ellipse====
   * https://developer.mozilla.org/en-US/docs/Web/SVG/Element/ellipse
@@ Line 143: / Line 188: @@
 </svg>
 </code>
+**Hinweis:** //Wenn der Radius "rx" oder "ry" Null ist, wird dieses SVG-Element übersprungen.//\\
-====Polygon====
+====Vieleck (polygon)====
-  * https://developer.mozilla.org/en-US/docs/Web/SVG/Element/ellipse
+  * https://developer.mozilla.org/en-US/docs/Web/SVG/Element/polygon
 <code xml>
 <svg width="100%" viewBox="0 0 32 32" xmlns="http://www.w3.org/2000/svg">
@@ Line 153: / Line 198: @@
 </svg>
 </code>
+ \\
-====Rechteck====
+====Rechteck (rect)====
-  * https://developer.mozilla.org/en-US/docs/Web/SVG/Element/ellipse
+  * https://developer.mozilla.org/en-US/docs/Web/SVG/Element/rect
 <code xml>
 <svg width="100%" viewBox="0 0 32 32" xmlns="http://www.w3.org/2000/svg">
@@ Line 164: / Line 209: @@
 </code>
 Einstellung **rx > 0** zeichnet ein abgerundetes Rechteck.\\
+ \\
-====Line====
+====Linie (line)====
-  * https://developer.mozilla.org/en-US/docs/Web/SVG/Element/ellipse
+  * https://developer.mozilla.org/en-US/docs/Web/SVG/Element/line
 <code xml>
 <svg width="100%" viewBox="0 0 32 32" xmlns="http://www.w3.org/2000/svg">
   <g>
-    <line x1="0" y1="0" x2="31" y2="31" stroke="black"/>
+    <line x1="0" y1="0" x2="31" y2="31" stroke="black" stroke-width="8"/>
   </g>
 </svg>
 </code>
+  * **Hinweis:** Beim **''line''**-Element wird das in der [[https://www.w3.org/TR/svg-strokes/#LineCaps|www.w3.org-Spezifikation]] angegebene Attribut **''stroke-linecap''** __nicht unterstützt__. \\ Rocview stellt die Enden des **''line''**-Elements immer **round** dar. **((dafür ist minimal **''stroke-width="3"''** erforderlich))**
-====PolyLine====
+====Mehrfachlinie (polyline)====
   * https://developer.mozilla.org/en-US/docs/Web/SVG/Element/polyline
 <code xml>
@@ Line 186: / Line 231: @@
  \\
-=====Blinkende Begriffe=====
+=====Alternative SVG durch zweiten <g>-Container=====
-Beginnend mit Revision 5315 kann in der SVG-Definition ein zweiter Graphik-Container((zweiter ''**<g>...</g>**''-Abschnitt)) hinzugefügt werden.\\
+In der SVG-Definition kann ein zweiter Graphik-Container (''**<g>**''-Knoten) hinzugefügt werden.\\
-Die Elemente der beiden Container werden abwechselnd im Sekunden-Rhythmus angezeigt.\\
+Die Elemente der beiden Container werden im Sekunden-Rhythmus abwechselnd angezeigt = "Blinken".
-Diese Funktion ist nur bei Signal-Objekten aktiviert.\\
+  * **Hinweis:** Im Gleisplan ist diese Funktion nur aktiv, wenn \\ 1. dem Objekt eine SVG-Datei mit zweitem <g>-Container zugeordnet ist. \\ 2. im Kontext-Menü des Objekts die Option "Alternative SVG aktivieren" gesetzt ist.
+  * **Achtung:** //Rocweb kann diese Mehrfach-Container nicht unterstützen und zeigt alle überlappt an.//\\
 ====Beispiel====
@@ Line 235: / Line 284: @@
  \\
+===== Externe Hilfsmittel für SVG-Dateien =====
+====Online-SVG-Viewer/Editor====
+Das Online-Tool **[[https://www.rapidtables.com/web/tools/svg-viewer-editor.html|SVG-Viewer/Editor]]** kann hilfreich sein, um SVG-Symbole anzuzeigen, zu erstellen und zu bearbeiten.\\
+Es ist nicht so mächtig wie **[[#inkscape|Inkscape]]**, aber es ist viel einfacher zu verwenden, als Inkscape oder andere.
+  * **Hinweis:** \\ Leider prüft das Tool nicht die XML-Konformität. Mit dem Tool bearbeitete SVG-Dateien sollten z.B. mit einem Browser darauf geprüft werden.
+Um mit dem Tool vertraut zu werden, empfiehlt sich das Öffnen einer SVG-Datei aus einem Rocrail-Thema.\\
+Damit können durch Änderungen an den Code-Elementen sehr gut die Auswirkungen auf die Symbol-Darstellung verfolgt werden.\\
+Alternativ sind auch Code-Abschnitte auf dieser Wiki-Seite geeignet, wenn sie per //Copy & Paste// in das Tool übertragen werden. \\
+\\
+Da die "Neu"-Funktion des Tools keinen für Rocrail-Symbole passenden Rahmen erzeugt, \\
+sollte zur Erstellung neuer Symbole zuerst folgender Rahmen in das Code-Fenster des Tools kopiert werden:
+<code xml>
+<svg width="100%" viewBox="0 0 32 32" xmlns="http://www.w3.org/2000/svg">
+  <g>
+    <!-- Hier die SVG-Elemente einfügen -->
+  </g>
+</svg>
+</code>
+Alternativ kann eine neue SVG-Datei natürlich auch durch Änderungen einer vorhandenen Datei erzeugt werden.\\
+|< >|
+^  Funktionen  ^
+| {{:wiki:svg-viewer-new.png?25}} Neu |
+| {{:wiki:svg-viewer-open.png?25}} SVG-Datei öffnen |
+| {{:wiki:svg-viewer-view.png?25}} SVG-Code darstellen |
+| {{:wiki:svg-viewer-save.png?25}} SVG-Datei speichern |
+ \\
+====Inkscape====
+Inkscape (http://www.inkscape.org/) ist ein sehr mächtiges Tool zur Erstellung und Bearbeitung von SVG-Dateien. Da Rocrail nur ganzzahlige Koordinaten verwendet, sollten folgende Einstellungen in Inkscape erfolgen:
+{{inkscape_config1-de.png}}{{inkscape_config2-de.png}}{{inkscape_config3-de.png}}
+Dabei ist zu beachten, dass insbesondere die Option 'Immer einrasten' nur beim Zeichnen der Pfade (Shift+F6) wirkt. Sobald Knoten mit der Maus verschoben werden, generiert InkScape Koordinaten mit Nachkommastellen.
+Eine weitere sinnvolle Einstellung ist das Anzeigen des Umrisses:
+{{inkscape_config4-de.png}}\\
+\\
+Nach Fertigstellung muss die Grafik als SVG-Datei gespeichert werden.
+:!: __Diese in Inkscape gespeicherte Datei kann Rocview nicht direkt verwenden.__ Sie muss erst noch bearbeitet werden:
+Mit einem Texteditor (notepad++) werden nur die Zeilen herauskopiert, die mit den **[[#unterstuetzte_svg-elemente|unterstützten SVG-Elementen]]** beginnen:\\
+  * **''<path ...''**, **''<circle ...''**, **''<ellipse ...''**, **''<polygon ...''**, **''<line ...''** und **''<polyline ...''**
+Diese Zeilen müssen noch in die **''<svg>''**- u. **''<g>''**-Knoten eingefügt werden:
+<code xml>
+<svg width="100%" viewBox="0 0 32 32" xmlns="http://www.w3.org/2000/svg">
+  <g>
+    <!-- Hier nur die Zeilen mit den unterstützten SVG-Elementen einfügen -->
+  </g>
+</svg>
+</code>
+Der gesamte **''<svg>''**-Abschnitt muss als SVG-Datei den **[[symbolnames-de|Konventionen für die Namensgebung]]** entsprechend gespeichert werden.\\
+Die Datei wird in ein Themen-Verzeichnis kopiert und ist in Rocview als Objekt-Symbol in Gleisplänen zu verwenden.\\
+\\
+:!: Ein Forums-Beitrag u.a. zu Erfahrungen mit Inkscape: https://forum.rocrail.net/viewtopic.php?p=25518#25518
+ \\
 ===== Videos =====
 Die folgenden Videos zeigen die Grundlagen zur Erstellung von SVG-Symbolen mit einem Text-Editor:\\