Dokumentation um Integration eines Shapes und Positionierung von Connection Points erweitert

This commit is contained in:
Simon Schmutzler
2024-02-06 12:39:21 +01:00
parent 878531378b
commit ed19298bf9
15 changed files with 86 additions and 2 deletions
+86 -2
View File
@@ -81,6 +81,90 @@ Zeit [h:mm]| Thema
2:57|[Import der 3d Information in RD Configurator (Festlegung des Centers in 3D und im Graphical Studio)](bilder/session2/257-ImportStlFile.png)
2:59|Koordinatensystem in 3D und 2D
## 2.4. Lessons learned
Die SVG Datei muß im Inkscape im Hintergrund der Datei (Dokumenteneinstellungen -> Seitengröße -> BEnutzerdefiniert) die Länge und Breite des Elements (in mm) haben, welches dargestellt werden soll. Icongröß0e und Dokumentengröße im Inkscape müssen übereinsteimmen.
## 2.4 Integration einer SVG-Datei als Shape
Am Beispiel der Bügelträgerbeladung wird die Integration eines Shapes in den RDC gezeigt.
Zunächst müssen die Grenzmaße in x und y-Richtung und nach Möglichkeit auch in z-Richtung bekannt sein.
![Maße aus einer Zeichnungsableitung](bilder/session2/svg-integration-grenzmaße.png)
In Inkscape wird nun eine Vektorgrafik (SVG) erstellt. Das Shape als vereinfachte Grafik der Baugruppe kann nun gezeichnet werden. Alle Vektoren und Teilelemente sollten am Schluss gruppiert werden (Strg + G). Die Größe des gezeichneten Shapes muss nun auf die Grenzmaße der Baugruppe angepasst werden.
![Größe des Shapes ändern](bilder/session2/svg-integration-shapegröße.png)
Um eine Maßstabsgetreue Wiedergabe im RDC zu ermöglichen, muss die Seitengröße der SVG-Datei ebenfalls auf die Grenzmaße angepasst werden.
Die Maße des Dokuments werden dabei auf die Grenzmaße des Objekts festgelegt.
Unter "Datei -> Dokumenteneinstellungen..." kann die Seitengröße konfiguriert werden.
![Öffnen der Dokumenteneinstellungen](bilder/session2/svg-integration-dokumenteneinstellungen.png)
Das Zeichnungsobjekt wird ausgewählt und über die Schaltfläche "Seitengröße auf Zeichnungs-/Auswahlgröße" wird die Seitengröße auf die Shapegröße angepasst und das Shape zentriert.
Damit ist die Bearbeitung des Shapes in Inkscape abgeschlossen.
![Seitengröße anpassen](bilder/session2/svg-integration-seitengröße.png)
Im "Web Graphical Editor Library Wizard" wird nun die SSG-Library geöffnet und zum vorher angelegten Shape navigiert.
Unter dem Reiter "Main" werden die Abmessungen der Breite (W) und Länge bzw. Höhe (H) eingetragen. Hier kann der Wert in Millimetern eingegeben werden, eine Umrechnung in Pixel erfolgt automatisch. Die Werte für die Breite und Höhe in Pixeln können hier ebenfalls später für die Berechnung abgerufen werden.
![Größe des Shapes](bilder/session2/svg-integration-wizard-shapegröße.png)
Unter dem Reiter "2D" kann die zuvor erstellte SVG-Datei importiert werden.
![Auswahl der SVG-Datei](bilder/session2/svg-integration-wizard-import.png)
Über die Schaltfläche "Deploy Library" wird nun eine XML-Datei aus der ausgewählten SVG-Datei erzeugt. Dafür muss die Library überschrieben werden.
![Import deploy](bilder/session2/svg-integration-wizard-deploy.png)
Anschließend ist ein Speichern der gesamten Library über die Schaltfläche "Save Library" erforderlich. Dadurch wird die entsprechende XML-Datei in folgendem Verzeichnis überschrieben:
"C:\Program Files\RuleDesigner\RDConfigurator Fusion\WebApi\Editor2D\SSG\shapes\svg\"
![Speichern der Library](bilder/session2/svg-integration-wizard-speichern.png)
Zuletzt muss das neu erzeugte Library-Verzeichnis in das von Git verwaltete Verzeichnis kopiert werden. Hierbei wird das gesamte SSG-Verzeichnis kopiert und geänderte Dateien werden überschrieben:
Quellverzeichnis: <span style="font-style: italic;">C:\Program Files\RuleDesigner\RDConfigurator Fusion\WebApi\Editor2D\SSG</span>
Zielverzeichnis: <span style="font-style: italic;">C:\Users\USERNAME\Documents\SSG-Ruledesigner-Konfigurator\Editor2DLibrary\SSG</span>
## 2.5 Positionierung eines Connection-Points
Um einen Connection-Point maßstabsgetreu positionieren zu können, wird dieser Punkt in Inkscape ermittelt. Dazu wird mit dem Vektor-Tool ("Bezierkurven und gerade Linien") durch zweifaches Klicken an verschiedenen Positionen eine Vektor zwischen zwei Punkten gebildet.
![Bezierwerkzeug](bilder/session2/svg-connectionpoint-vektor-zeichnen.png)
Beim Positionieren der beiden Punkte ist <span style="font-weight: bold;">einer</span> der beiden Verbindungspunkte an die Soll-Position des Connection-Points zu platzieren. Sind beide Punkte platziert, kann die Eingabe mit der rechten Maustaste abgeschlossen werden.
![Vektor zeichnen](bilder/session2/svg-connectionpoint-vektor-zeichnen-02.png)
![Vektorposition Connection-Point](bilder/session2/svg-connectionpoint-vektor-position.png)
Mit dem Werkzeug "Bearbeiten der Knoten oder der Anfasser eines Pfades" können die Anfasser nachträglich verschoben werden und die Endposition des Connection-Points korrigiert werden.
![Vektoranfasse auswählen](bilder/session2/svg-connectionpoint-vektor-anfasser.png)
Anschließen wird mit dem selben Werkzeug der Knotenpunkt mit der Position des Connection-Points ausgewählt. Die Koordinaten des Punktes werden in der Oberfläche angezeigt. Die Anzeigeeinheit muss auf Pixel ("px") einstellt sein. um die Koordinaten auslesen zu können.
Der Ursprung (x=0 px, y=0 px) der Seite liegt oben links. Die Koordinaten für den ausgewählten Knotenpunkt können nun in der Oberfläche abgelesen werden.
![CP Position auslesen](bilder/session2/svg-connectionpoint-position-auslesen.png)
Nun erfolgt eine Umrechnung der Pixelgrößen für die Position des Connection-Points des Shapes in der RDC Library:
Koordinaten aus Inkscape auslesen:
$$
P_{CP,\;px} = (262, 158)\\
$$
Auslesen der Breite und Höhe (2D) des Shapes aus dem Library Wizard:
$$
W_{px} = 2554.9606\\
H_{px} = 1285.0394\\
$$
Referenzgröße der Library (Breite, Höhe):
$$
R_{w,\;h,\;px} = 1000\\
$$
Umrechnungsfaktoren für Breiten- und Längenmaß:
$$
F_{w} = \frac{R_{w,\;h,\;px}}{W_{px}} = \frac{1000\;px}{2554.9606\;px} = 0.391395
$$
$$
F_{h} = \frac{R_{w,\;h,\;px}}{H_{px}} = \frac{1000\;px}{1285.0394\;px} = 0.778186
$$
Nun kann die Umrechnung der x- und y-Koordinaten für den Connection-Point erfolgen:
$$
P_{CP,\;neu,\;px} = (262*F_{w}, 158*F_{h}) = (102.54549, 122.953388)
$$
Die Werte für die Koordinaten werden anschließend im Library Wizard im jeweiligen Shape unter dem Reiter "Connection Points" eingetragen.
![CP Koordinaten eingeben](bilder/session2/svg-connectionpoint-koordinaten-eingeben.png)
Abschließend muss die Aktualisierung der Shape Daten durch "Deploy Library", "Save Library" und Kopieren des SSG-Verzeichnisses in das verwaltete Verzeichnis des RDC übertragen werden (s.o.).
Binary file not shown.

After

Width:  |  Height:  |  Size: 40 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 41 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 14 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 12 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 22 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 23 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 31 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 23 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 115 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 36 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 81 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 66 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 82 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 13 KiB