Scenegraph/de: Difference between revisions

From FreeCAD Documentation
No edit summary
(Created page with "Siehe Coin3d snippets mit freundlicher Genehmigung von MariwanJ's research für den Arbeitsbereich Design456. The code repository can be found at https://github.com/MariwanJ/COIN3D_Snippet.")
 
(52 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{docnav/de|[[Mesh to Part/de|Mesh to Part]]|[[Pivy/de|Pivy]]}}


{{Docnav/de
Die Geometrie, die in den 3D-Ansichten von FreeCAD angezeigt wird, wird von der Bibliothek [http://en.wikipedia.org/wiki/Coin3D Coin3d] dargestellt. Coin3D ist eine Implementierung des Standards[http://en.wikipedia.org/wiki/Open_Inventor OpenInventor]. Die Software unter [ http://en.wikipedia.org/wiki/Open_CASCADE openCascade] bietet ebenfalls die gleiche Funktionalität, aber schon zu Beginn von FreeCAD wurde entschieden, nicht den eingebauten openCascade Viewer zu verwenden, sondern auf die leistungsfähigere coin3D-Software zu wechseln. Eine gute Möglichkeit, etwas über diese Bibliothek zu erfahren, ist das Buch[http://www-evasion.imag.fr/Membres/Francois.Faure/doc/inventorMentor/sgi_html/ Open Inventor Mentor].
|[[Scripted_objects/de|Skriptgenerierte Objekte]]
|[[Pivy/de|Pivy]]
}}

{{TOCright}}

<span id="Introduction"></span>
==Einführung==

Die Geometrie, die in den [[3D_view/de|3D-Ansichten]] von FreeCAD erscheint, wird von der [https://en.wikipedia.org/wiki/Coin3D Coin3D-Bibliothek] gerendert. Coin3D ist eine Implementierung des [https://en.wikipedia.org/wiki/Open_Inventor Open Inventor-Standards]. Die [https://en.wikipedia.org/wiki/Open_Cascade_Technology OpenCASCADE-Software] bietet ebenfalls die gleiche Funktionalität, aber es wurde in der sehr frühen Phase von FreeCAD entschieden, nicht den eingebauten OpenCASCADE-Betrachter zu verwenden, sondern auf die leistungsfähigere Coin3D-Software umzusteigen. Eine gute Möglichkeit, diese Bibliothek kennenzulernen, ist das Buch [http://www-evasion.imag.fr/Membres/Francois.Faure/doc/inventorMentor/sgi_html/ Open Inventor Mentor].

<span id="Description"></span>
==Beschreibung==


[http://en.wikipedia.org/wiki/Open_Inventor OpenInventor] ist eigentlich eine 3D Szenenbeschreibungssprache. Die in openInventor beschriebene Szene wird dann in OpenGL auf Ihrem Bildschirm dargestellt. Coin3D kümmert sich darum, so dass Programmierer sich nicht um komplexe openGL Aufrufe kümmern müssen und nur gültigen OpenInventor Code bereitstellen können. Der große Vorteil ist, dass openInventor ein sehr bekannter und gut dokumentierter Standard ist.
[https://en.wikipedia.org/wiki/Open_Inventor Open Inventor] ist eine 3D-Szenenbeschreibungssprache. Die in Open Inventor beschriebene Szene wird dann in OpenGL auf dem Bildschirm gerendert. Coin3D kümmert sich darum, so dass Programmierer sich nicht mit komplexen OpenGL Aufrufen befassen müssen, sondern nur gültigen Open Inventor-Code zur Verfügung stellen müssen. Der große Vorteil ist, dass Open Inventor ein sehr bekannter und gut dokumentierter Standard ist.


Eine der großen Aufgaben, die FreeCAD für Dich erledigt, ist die Übersetzung von openCascade Geometrieinformationen in die openInventor Sprache.
Eine der großen Aufgaben, die FreeCAD für dich übernimmt, ist die Übersetzung von OpenCASCADE Geometrieinformationen in die Open Inventor-Sprache.


OpenInventor beschreibt eine 3D Szene in Form einer [https://de.wikipedia.org/wiki/Szenengraph Szenegraph], wie die folgende:
Open Inventor beschreibt eine 3D-Szene in Form eines [https://de.wikipedia.org/wiki/Szenengraph Szenengraphen], wie dem folgenden:


[[Image:Scenegraph.gif]]
[[Image:Scenegraph.gif]]
Bild von [http://www-evasion.imag.fr/~Francois.Faure/doc/inventorMentor/sgi_html/index.html Inventor mentor]
{{Caption|Bild entnommen aus [https://web.archive.org/web/20190807185912/http://www-evasion.imag.fr/~Francois.Faure/doc/inventorMentor/sgi_html/ Inventor mentor]}}


Ein openInventor Szenengraph beschreibt alles, was zu einer 3D Szene gehört, wie Geometrie, Farben, Materialien, Licht, usw. und organisiert all diese Daten in einer komfortablen und übersichtlichen Struktur. Alles kann in Unterstrukturen gruppiert werden, so dass Du Deine Szeneninhalte so gestalten kannst, wie Du es willst. Hier ist ein Beispiel für eine openInventor Datei:
Ein Open Inventor-Szenengraph beschreibt alles, was zu einer 3D-Szene gehört, wie Geometrie, Farben, Materialien, Licht, usw. und organisiert all diese Daten in einer praktischen und übersichtlichen Struktur. Alles kann in Unterstrukturen gruppiert werden, so dass Du deine Szeneninhalte so gestalten kannst, wie Du es willst. Hier ist ein Beispiel für eine Open Inventor-Datei:

{{Code|code=
{{Code|lang=bash|code=
#Inventor V2.0 ascii
#Inventor V2.0 ascii
Line 37: Line 50:
}
}
}
}

}}
}}


Wie man sieht, ist die Struktur sehr einfach. Du verwendest Trennzeichen, um deine Daten in Blöcken zu organisieren, ein wenig wie du deine Dateien in Ordnern organisieren würdest. Jede Anweisung wirkt sich auf das aus, was als nächstes kommt, z.B. sind die ersten beiden Elemente unseres Wurzel Trennzeichens eine Rotation und eine Translation, beide wirken sich auf das nächste Element aus, das ein Trennzeichen ist. In diesem Trennzeichen wird ein Material definiert und eine weitere Transformation durchgeführt. Unser Zylinder wird daher von beiden Transformationen betroffen sein, derjenigen, die direkt auf ihn angewendet wurde, und derjenigen, die auf seinen übergeordneten Trennzeichen angewendet wurde.
Wie man sieht, ist die Struktur sehr einfach. Es werden Unterteilungen (separators) verwendet, um Daten in Blöcken zu organisieren; ein wenig wie Dateien in Ordnern zu organisieren. Jede Anweisung wirkt sich auf das aus, was als nächstes kommt, z.B. sind die ersten beiden Elemente unseres Wurzel-Elements (root separator) eine Drehung (Rotation) und eine Verschiebung (Translation); Beide wirken sich auf das nächste Element aus, das eine weitere Unterteilung (separator) ist. In dieser Unterteilung wird ein Material definiert und eine weitere Transformation.
Unser Zylinder ist daher von beiden Transformationen betroffen, von der einen, die direkt auf ihn angewendet wurde, und von der anderen, die auf sein übergeordnetes Unterteilungselement angewendet wurde.


Wir haben auch viele andere Arten von Elementen, um unsere Szene zu organisieren, wie Gruppen, Schalter oder Anmerkungen. Wir können sehr komplexe Materialien für unsere Objekte definieren, mit Farbe, Texturen, Schattierungsmodi und Transparenz. Wir können auch Lichter, Kameras und sogar Bewegungen definieren. Es ist sogar möglich, Skriptteile in openInventor Dateien einzubetten, um komplexere Verhaltensweisen zu definieren.
Wir haben auch viele andere Arten von Elementen, um unsere Szene zu organisieren, wie Gruppen, Schalter oder Anmerkungen. Wir können sehr komplexe Materialien für unsere Objekte definieren, mit Farbe, Texturen, Schattierungsmodi und Transparenz. Wir können auch Lichter, Kameras und sogar Bewegungen definieren. Es ist sogar möglich, Skriptteile in Open Inventor-Dateien einzubetten, um komplexere Verhaltensweisen zu definieren.


Wenn Du mehr über openInventor erfahren möchtest, gehe direkt zu seiner berühmtesten Referenz, der [http://www-evasion.imag.fr/~Francois.Faure/doc/inventorMentor/sgi_html/index.html Inventor mentor].
Mehr über Open Inventor erfährt man unter seiner bekanntesten Referenz: [http://www-evasion.imag.fr/~Francois.Faure/doc/inventorMentor/sgi_html/ Inventor mentor].


In FreeCAD muß normalerweise nicht mit openInventor Szenengraph zusammengearbeitet. Jedes Objekt in einem FreeCAD-Dokument, sei es ein Drahtmodel (mesh), eine Part-Form oder irgendetwas anderes, wird automatisch in openInventor-Code umgewandelt und in den Hauptszenengraph eingefügt, den man in der 3D-Ansicht sieht. Dieser Szenengraph wird fortwährend bei Änderungen aktualisiert, auch wenn Objekte eingefügt oder entfernt werden. Das heißt, jedes Objekt (im App-Raum) hat einen Ansichtprovider (ein entsprechendes Ojekt im Gui-Raum), der für die Ausgabe von openInventor-Code zuständig ist.
In FreeCAD müssen wir normalerweise nicht direkt mit dem Open Inventor-Szenengraph interagieren. Jedes Objekt in einem FreeCAD-Dokument, sei es ein Netz, eine Part-Form oder etwas anderes, wird automatisch in Open Inventor-Code konvertiert und in den Haupt-Szenengraphen eingefügt, der in einer [[3D_view/de|3D-Ansicht]] dargestellt wird. Dieser Szenengraph wird kontinuierlich aktualisiert, wenn Objekte geändert, hinzugefügt oder entfernt werden. Tatsächlich hat jedes Objekt (im App-Raum) einen Viewprovider (ein entsprechendes Objekt im Gui-Raum), der für die Ausgabe von Open Inventor-Code verantwortlich ist.


Es gibt jedoch viele Vorteile, um direkt auf die Szenegrafik zugreifen zu können. So können wir beispielsweise das Aussehen eines Objekts vorübergehend ändern oder Objekte zur Szene hinzufügen, die im FreeCAD Dokument nicht wirklich existieren, wie z.B. Konstruktionsgeometrie, Helfer, grafische Hinweise oder Werkzeuge wie Manipulatoren oder Bildschirminformationen.
Es hat jedoch viele Vorteile, direkt auf den Szenengraph zuzugreifen. So können wir beispielsweise vorübergehend das Aussehen eines Objekts ändern oder Objekte zur Szene hinzufügen, die im FreeCAD-Dokument nicht wirklich existieren, wie z.B. Konstruktionsgeometrie, Hilfselemente, grafische Hinweise oder Werkzeuge wie Manipulatoren oder Bildschirminformationen.

FreeCAD selbst verfügt über mehrere Werkzeuge, um Open Inventor-Code anzusehen oder zu ändern. Der folgende Python-Code zeigt beispielsweise die Open Inventor-Darstellung eines ausgewählten Objekts:


FreeCAD selbst verfügt über mehrere Werkzeuge, um openInventor-Code zu sehen oder zu ändern. Der folgende Python Code zeigt beispielsweise die openInventor Darstellung eines ausgewählten Objekts:
{{Code|code=
{{Code|code=
obj = FreeCAD.ActiveDocument.ActiveObject
obj = FreeCAD.ActiveDocument.ActiveObject
Line 57: Line 71:


}}
}}
Aber wir haben auch ein Python-Modul, das den vollständigen Zugriff auf alles, was von Coin3D verwaltet wird, ermöglicht, wie z.B. unsere FreeCAD-Szenengrafik. Also, lies weiter mit [[Pivy/de|Pivy]].


Aber wir haben auch ein Python-Modul, das den vollständigen Zugriff auf alles ermöglicht, was von Coin3D verwaltet wird, wie z.B. unser FreeCAD-Szenengraph. Mehr dazu unter [[Pivy/de|Pivy]].
{{docnav/de|[[Mesh to Part/de|Drahtmodel zu Part]]|[[Pivy/de|Pivy]]}}


<span id="Coding_examples"></span>
{{Userdocnavi/de}}
==Code-Beispiele==

Siehe [[Coin3d_snippets/de|Coin3d snippets]] mit freundlicher Genehmigung von MariwanJ's research für den Arbeitsbereich [[Design456_Workbench|Design456]]. The code repository can be found at https://github.com/MariwanJ/COIN3D_Snippet.
{{Top}}

{{Docnav/de
|[[Scripted_objects/de|Skriptgenerierte Objekte]]
|[[Pivy/de|Pivy]]
}}


{{Powerdocnavi{{#translation:}}}}
[[Category:Poweruser Documentation/de]]
[[Category:Developer Documentation{{#translation:}}]]
{{clear}}

Latest revision as of 15:28, 16 February 2023

Einführung

Die Geometrie, die in den 3D-Ansichten von FreeCAD erscheint, wird von der Coin3D-Bibliothek gerendert. Coin3D ist eine Implementierung des Open Inventor-Standards. Die OpenCASCADE-Software bietet ebenfalls die gleiche Funktionalität, aber es wurde in der sehr frühen Phase von FreeCAD entschieden, nicht den eingebauten OpenCASCADE-Betrachter zu verwenden, sondern auf die leistungsfähigere Coin3D-Software umzusteigen. Eine gute Möglichkeit, diese Bibliothek kennenzulernen, ist das Buch Open Inventor Mentor.

Beschreibung

Open Inventor ist eine 3D-Szenenbeschreibungssprache. Die in Open Inventor beschriebene Szene wird dann in OpenGL auf dem Bildschirm gerendert. Coin3D kümmert sich darum, so dass Programmierer sich nicht mit komplexen OpenGL Aufrufen befassen müssen, sondern nur gültigen Open Inventor-Code zur Verfügung stellen müssen. Der große Vorteil ist, dass Open Inventor ein sehr bekannter und gut dokumentierter Standard ist.

Eine der großen Aufgaben, die FreeCAD für dich übernimmt, ist die Übersetzung von OpenCASCADE Geometrieinformationen in die Open Inventor-Sprache.

Open Inventor beschreibt eine 3D-Szene in Form eines Szenengraphen, wie dem folgenden:

Bild entnommen aus Inventor mentor

Ein Open Inventor-Szenengraph beschreibt alles, was zu einer 3D-Szene gehört, wie Geometrie, Farben, Materialien, Licht, usw. und organisiert all diese Daten in einer praktischen und übersichtlichen Struktur. Alles kann in Unterstrukturen gruppiert werden, so dass Du deine Szeneninhalte so gestalten kannst, wie Du es willst. Hier ist ein Beispiel für eine Open Inventor-Datei:

#Inventor V2.0 ascii
 
Separator { 
    RotationXYZ {	
       axis Z
       angle 0
    }
    Transform {
       translation 0 0 0.5
    }
    Separator {	
       Material {
          diffuseColor 0.05 0.05 0.05
       }
       Transform {
          rotation 1 0 0 1.5708
          scaleFactor 0.2 0.5 0.2
       }
       Cylinder {
       }
    }
}

Wie man sieht, ist die Struktur sehr einfach. Es werden Unterteilungen (separators) verwendet, um Daten in Blöcken zu organisieren; ein wenig wie Dateien in Ordnern zu organisieren. Jede Anweisung wirkt sich auf das aus, was als nächstes kommt, z.B. sind die ersten beiden Elemente unseres Wurzel-Elements (root separator) eine Drehung (Rotation) und eine Verschiebung (Translation); Beide wirken sich auf das nächste Element aus, das eine weitere Unterteilung (separator) ist. In dieser Unterteilung wird ein Material definiert und eine weitere Transformation. Unser Zylinder ist daher von beiden Transformationen betroffen, von der einen, die direkt auf ihn angewendet wurde, und von der anderen, die auf sein übergeordnetes Unterteilungselement angewendet wurde.

Wir haben auch viele andere Arten von Elementen, um unsere Szene zu organisieren, wie Gruppen, Schalter oder Anmerkungen. Wir können sehr komplexe Materialien für unsere Objekte definieren, mit Farbe, Texturen, Schattierungsmodi und Transparenz. Wir können auch Lichter, Kameras und sogar Bewegungen definieren. Es ist sogar möglich, Skriptteile in Open Inventor-Dateien einzubetten, um komplexere Verhaltensweisen zu definieren.

Mehr über Open Inventor erfährt man unter seiner bekanntesten Referenz: Inventor mentor.

In FreeCAD müssen wir normalerweise nicht direkt mit dem Open Inventor-Szenengraph interagieren. Jedes Objekt in einem FreeCAD-Dokument, sei es ein Netz, eine Part-Form oder etwas anderes, wird automatisch in Open Inventor-Code konvertiert und in den Haupt-Szenengraphen eingefügt, der in einer 3D-Ansicht dargestellt wird. Dieser Szenengraph wird kontinuierlich aktualisiert, wenn Objekte geändert, hinzugefügt oder entfernt werden. Tatsächlich hat jedes Objekt (im App-Raum) einen Viewprovider (ein entsprechendes Objekt im Gui-Raum), der für die Ausgabe von Open Inventor-Code verantwortlich ist.

Es hat jedoch viele Vorteile, direkt auf den Szenengraph zuzugreifen. So können wir beispielsweise vorübergehend das Aussehen eines Objekts ändern oder Objekte zur Szene hinzufügen, die im FreeCAD-Dokument nicht wirklich existieren, wie z.B. Konstruktionsgeometrie, Hilfselemente, grafische Hinweise oder Werkzeuge wie Manipulatoren oder Bildschirminformationen.

FreeCAD selbst verfügt über mehrere Werkzeuge, um Open Inventor-Code anzusehen oder zu ändern. Der folgende Python-Code zeigt beispielsweise die Open Inventor-Darstellung eines ausgewählten Objekts:

obj = FreeCAD.ActiveDocument.ActiveObject
viewprovider = obj.ViewObject
print viewprovider.toString()

Aber wir haben auch ein Python-Modul, das den vollständigen Zugriff auf alles ermöglicht, was von Coin3D verwaltet wird, wie z.B. unser FreeCAD-Szenengraph. Mehr dazu unter Pivy.

Code-Beispiele

Siehe Coin3d snippets mit freundlicher Genehmigung von MariwanJ's research für den Arbeitsbereich Design456. The code repository can be found at https://github.com/MariwanJ/COIN3D_Snippet.

Anfang