SSG-Ruledesigner-Konfigurator/wiki/IntegrationShape.md

- [1. Allgemeines zur Integration ein neuen Shapes in die Library des RD Configurators](#1-allgemeines-zur-integration-ein-neuen-shapes-in-die-library-des-rd-configurators)
  - [1.1. Welche Programme benötige ich zur Erstellung des neuen Shapes](#11-welche-programme-benötige-ich-zur-erstellung-des-neuen-shapes)
  - [1.2. Definition der Bilder zur Darstellung am Beispiel einer Säule](#12-definition-der-bilder-zur-darstellung-am-beispiel-einer-säule)
  - [1.3. Erzeugung einer 3D STL Datei im CAD als Repräsentant](#13-erzeugung-einer-3d-stl-datei-im-cad-als-repräsentant)
- [2. Schritte zur Erstellung der Säule im WebGraphicalEditor (WGE)](#2-schritte-zur-erstellung-der-säule-im-webgraphicaleditor-wge)
  - [2.1. Vorbereitung der Umgebung](#21-vorbereitung-der-umgebung)
  - [2.2. Start des Programmes](#22-start-des-programmes)
  - [2.3. Aufruf des Wizards](#23-aufruf-des-wizards)
  - [2.4. Erstellung einer neuen Gruppe für Shapes](#24-erstellung-einer-neuen-gruppe-für-shapes)
  - [2.5. Erzeugung eines Shapes](#25-erzeugung-eines-shapes)
  - [2.6. Angaben zu den Dimensionen des Shapes](#26-angaben-zu-den-dimensionen-des-shapes)
  - [2.7. Angaben der Connection Points](#27-angaben-der-connection-points)


# 1. Allgemeines zur Integration ein neuen Shapes in die Library des RD Configurators

## 1.1. Welche Programme benötige ich zur Erstellung des neuen Shapes
- inkscape (oder ein ähnliches Programm zur Erstellung von SVG Dateien)
- eventuell ein Programm zur windows Bildverarbeitung (für icons)
- ein CAD System zur Ableitung der STL Datei aus dem 3D Modell

## 1.2. Definition der Bilder zur Darstellung am Beispiel einer Säule

- svg Datei: Darstellung der Säule in 2D mit dem Format der nötigen Länge und Breite, hier z.B. 100 mm Breite und 150 mm Länge
![Säule als .svg](bilder/S1Zoll.svg)
- ein Bild der Pixelgröße 64x64
![Säule als 64pixel .jpg](bilder/S1Zoll64.jpg)
- ein Bild der Pixelgröße 32x32
![Säule als 32pixel .jpg](bilder/S1Zoll32.jpg)


## 1.3. Erzeugung einer 3D STL Datei im CAD als Repräsentant 

ein Bild der Erzeugung im SolidEdge

![Säule als 32pixel .jpg](bilder/S1Zoll3d.png)

Anschliessend muss dieses als .stl Datei exportiert werden.
Bei der Erstellung der STL ist zu beachten, dass der Ursprung der 2D Icons des svg mit dem der 3D Datei übereinstimmt. 

# 2. Schritte zur Erstellung der Säule im WebGraphicalEditor (WGE)

## 2.1. Vorbereitung der Umgebung
Zuerst muss man den .rdx aufrufen, der die Library verwendet.  Dabei wird der Ordner mit allen Shapes etc. ins Installationsverzeichnkis kopiert. (Alternativ auch von Hand dorthin kopieren, z.B.  **C:\PLM\RuleDesigner\RDConfigurator Fusion\WebApi\Editor2D**

## 2.2. Start des Programmes
Danach muss das Programm mit der Library gestartet werden, damit die Library im folgenden Assistenten auswählbar ist.

## 2.3. Aufruf des Wizards
Dann muss der Wizard gestartet werden, welcher die Aufnahme von Shapes in die Library ermöglicht
![Menü des WGE](bilder/MenüWGE.png)

## 2.4. Erstellung einer neuen Gruppe für Shapes
wenn benötigt kann eine neue Gruppe erstellt werden:
![Erstelle Gruppe](bilder/ErstellungGruppe.png  )
Wichtig ist bei der Erstellung der IDs, keine Sonderzeichen, keine Umlaute oder sonstige Leerzeichen. 

## 2.5. Erzeugung eines Shapes

![Fügt Shape hinzu](bilder/AddShape.png)
![Setze Id des Shapes](bilder/AddShapeIdSet.png)

### Eintragung der Pfade zu den erstellten Icons, bzw. der STL, bzw. der SVG Datei

Icons:
![Trage Icons 32/64 pixel als Pfad ein](bilder/WebGraphicalEditorIcons.png)

STL:
![Gebe STL Datei an](bilder/WebGraphicalEditorSTL.png  )

SVG:
![Gebe SVG Datei an](bilder/WebGraphicalEditorSVG.png  )
Der Wizard erstellt daraufhin jeweils eine Kopie der Originaldatei

## 2.6. Angaben zu den Dimensionen des Shapes

![Angabe der Dimensionen](bilder/Angabe3DInfos.png  )

##  2.7. Angaben der Connection Points

Die Angaben der Connection Points beziehen sich auf ein Quadrat der Kantenlänge von 1000 pixel.

Hier als Referenz jeweils ein Punkt in der linken oberen/rechten unteren Ecke und einen in der Mitte:

![Angabe der Dimensionen](bilder/ConnectionPoints.png  )

hier die *Dokumentation* von PBU als Hilfe:
```
96 px = 1 Inch = 25,4 mm

Connection Point works on a sqare of 1000 point: 
A --------- B
 |        |
F|   E 	  |
 |        |
C --------- D

A=(0,0)
B=(1000,0)
C=(1000,1000)
D=(0,1000)
E=(500,500)
F=(0,500)

PROPERTIES ACTIONS :
(WIDTH=100)
(HEIGHT=Value-(Width*2))
(IMAGE=xxx.jpg)
(ROTATION=45)  reasons clockwise
```