OpenSCAD Workbench/de

Einführung
Der OpenSCAD Arbeitsbereich soll Interoperabilität mit der Open Source Software OpenSCAD bieten. Dieses Programm wird nicht als Bestandteil von FreeCAD verteilt, sollte aber installiert werden, um diesen Arbeitsbereich voll nutzen zu können. OpenSCAD sollte nicht mit OpenCASCADE verwechselt werden, welches der geometrische Kernel ist, den FreeCAD zur Erstellung von Geometrie auf dem Bildschirm verwendet. Die OpenCASCADE Bibliotheken werden immer benötigt, um FreeCAD zu verwenden, während die ausführbare OpenSCAD Datei vollkommen optional ist.

Sie enthält einen CSG Importeur zum Öffnen der CSG Dateien aus OpenSCAD und einen Exporteur zur Ausgabe eines CSG basierten Baums. Geometrie, die nicht auf CSG Operationen basiert, wird als Netz exportiert.

Dieser Arbeitsbereich enthält Funktionen, um den CSG Funktionssbaum zu ändern und Modelle zu reparieren. Er enthält außerdem allgemein nutzbare Werkzeuge, die keine OpenSCAD Installation erfordern; sie können in Verbindung mit anderen Arbeitsbereichen verwendet werden.Beispielsweise verwendet der Netz Arbeitsbereich intern die OpenSCAD Funktionen, um Operationen mit Netzen durchzuführen, da diese recht robust sind.



Abhängigkeiten
In FreeCAD 0.19 wurde das Ply (Python-Lex-Yacc) Modul, das zum Importieren von CSG Dateien verwendet wird, aus dem FreeCAD Quellcode entfernt, da es sich um eine nicht von FreeCAD entwickelte Drittanbieter Bibliothek handelt. Folglich musst du nun Ply installieren, bevor du den OpenSCAD Arbeitsbereich verwenden kannst. Wenn du eine vorkompilierte, stabile Version von FreeCAD verwendest, sollte diese Abhängigkeit auf allen Plattformen automatisch installiert werden; in anderen Fällen, z.B. wenn du Kompilieren aus dem Quellcode verwendest, musst du es möglicherweise aus einem Online Repositorium installieren.

In openSUSE wird vorgenommen dies durch:

In Debian/Ubuntu basierten Systemen wird dies wie nachfolgend gemacht.

Die allgemeine Installation auf allen Plattformen kann über den Python Paketindex durchgeführt werden.



OpenSCAD Sprache und Dateiformat
Die OpenSCAD Sprache erlaubt die Benutzung von Variablen und Schleifen. Sie erlaubt die Deklarierung von Sub Modulen, um Geometrie und Code wieder zu verwenden. Dieser hohe Grad an Flexibilität macht parsing (Übersetzen) sehr kompliziert. Im Moment kann der OpenSCAD Arbeitsbereich in FreeCAD die OpenSCAD Sprache nicht direkt verarbeiten. Andernfalls, wenn OpenSCAD installiert ist, kann es dazu verwendet werden, die Eingabe in ein Ausgabeformat namens "CSG" zu verwandeln. Dies ist ein Unterbereich der OpenSCAD Sprache und kann als Eingabe für OpenSCAD zur weiteren Bearbeitung verwendet werden. Während der Umwandlung wird jegliches parametrisches Verhalten verlorengehen - alle Variablennamen werden verworfen, Schleifen aufgelöst und mathematische Ausdrücke errechnet.

Werkzeuge

 * [[Image:OpenSCAD_ColorCodeShape.svg|32px]] Farbcodeform: Ändert die Farbe von ausgewählten oder allen Formen basierend auf ihrer Gültigkeit
 * [[Image:OpenSCAD_ReplaceObject.svg|32px]] Objekt ersetzen: Ersetzt ein Objekt in der Baumstruktur. Bitte wähle altes, neues und Elternobjekt
 * [[Image:OpenSCAD_RemoveSubtree.svg|32px]] Unterbaum entfernen: Entfernt die ausgewählten Objekts und alle Kinder, die nicht von anderen Objekten referenziert werden.
 * [[Image:OpenSCAD_RefineShapeFeature.svg|32px]] Formmerkmale verfeinern: Verfeinert Formmerkmale.
 * [[Image:OpenSCAD_MirrorMeshFeature.svg|32px]] Spiegeln Netz Merkmale: Erstelle Spiegel Netz Merkmal.
 * [[Image:OpenSCAD_ScaleMeshFeature.svg|32px]] Skaliere Netz Merkmal: Skalieren eines Netzmerkmals.
 * [[Image:OpenSCAD_ResizeMeshFeature.svg|32px]] Größe des Netzmerkmals ändern: Ändern der Größe eines Netzmerkmals.
 * [[Image:OpenSCAD_IncreaseToleranceFeature.svg|32px]] Toleranzmerkmal erhöhen: Erhöht die Toleranz von Kanten/Flächen/Knoten von ausgewählten Objekten.
 * [[Image:OpenSCAD_Edgestofaces.svg|32px]] Kanten in Flächen umwandeln: Wandelt Kanten in Flächen um. Nützlich zur Vorbereitung von importierter DXF Geometrie zur Extrusion.
 * [[Image:OpenSCAD_ExpandPlacements.svg|32px]] Positionierungen erweitern: Erweitert alle Platzierungen im Feature-Baum abwärts.
 * [[Image:OpenSCAD_ExplodeGroup.svg|32px]] Explodiere Gruppe: Löst eine Bindung oder einen Teilverbund in die einzelnen Teile auf.
 * [[Image:OpenSCAD_AddOpenSCADElement.svg|32px]] Hinzufügen OpenSCAD Element: Fügt durch Eingabe von OpenSCAD-Code in das Aufgabenpaneel ein OpenSCAD Element hinzu.
 * [[Image:OpenSCAD_MeshBoolean.svg|32px]] Polygonnetz Boolean: Erzeugt ein neues Netzobjekt durch eine boolesche Operation aus Formen.
 * [[Image:OpenSCAD_Hull.svg|32px]] Hülle: Wendet eine Hülle auf selektierte Formen an.
 * [[Image:OpenSCAD_Minkowski.svg|32px]] Minkowski: Wendet eine Minkowski-Summe auf selektierte Formen an.

Einstellungen

 * [[Image:Std_DlgPreferences.svg|32px]] Einstellungen: verfügbare Einstellungen für die OpenSCAD Werkzeuge.

Einschränkungen
OpenSCAD erstellt CSG (constructive solid geometry) genauso wie es Netz-Körper importiert und 2D-Geometrie extrudiert (aus DXF-Dateien). FreeCAD erlaubt es, CSG auch mit Grundkörpern zu erstellen. Der Geometriekern von FreeCAD (OCCT) arbeitet mit einer Umgrenzungsdarstellung. Deshalb sollte die Umwandlung von CSG nach BREP in der Theorie möglich sein, während die Umwandlung von BREP nach CSG im Allgemeinen nicht funktionieren dürfte.

OpenSCAD nutzt intern Netz-Körper. Manche Operationen, die bei Netz-Körpern nützlich sind, sind bei BREP-Körpern nicht sinnvoll und können daher nicht voll unterstützt werden. Unter diesen sind konvexe Hülle, Minkowski-Summe, glide und subdiv. Im Moment benutzen wir die OpenSCAD-Ausführungsdatei, um Hüllen und Minkowski-Operationen durchzuführen und die Ergebnisse zu importieren. Das bedeutet, das die beteiligte Geometrie trianguliert (temporär in Netz-Körper verwandelt) wird. In OpenSCAD wird nicht-einheitliches Skalieren oft benutzt, das keinerlei Probleme bei der Benutzung mit Netz-Köpern macht. In unserem Geometriekern werden geometrische Grundelemente (Linien, Kreissegmente) in BSplines konvertiert, bevor man solche Operationen durchführt. Diese BSplines sind bekannt dafür, dass Sie später in booleschen Operationen Fehler verursachen. Eine automatisierte Lösung ist im Moment nicht verfügbar. Bitte posten Sie im Fourm, wenn Sie solche Fehler entdecken. Oft können solche Problem dadurch vermieden werden, dass man kleine Teile des Modelles anders aufbaut. Ein Zylindersegment kann ersetzt werden durch ein extrudiertes Stück einer Ellipse.

Importing text
Importing OpenSCAD code with texts requires that the fonts that are used are properly installed on your system. You can verify this by opening OpenSCAD as a standalone tool and checking the list in. The list will also give you the correct font names. If a font does not appear in the list after installing, you may have to manually copy the font file to the appropriate system directory.

Importing texts is relatively slow. Behind the scenes FreeCAD uses a DXF file created by OpenSCAD. The more contours there are the slower the import.

It can be a good idea to first import a simple test case (replace with the correct font name):

TESTFONT="NameOfFont"; linear_extrude(0.001) { text("A", size=5, font=TESTFONT, script="Latn"); };

The parameter can be left out here, but is required if the text string does not contain any letters, but only punctuation and/or numbers.

Please note that statements in your source files are ignored when importing in FreeCAD. Under OpenSCAD the effect of a statement is that the provided font file is temporarily added to the list of known fonts (although even there the statement does not work when a script is modified interactively).

Hinweise
Wenn DXF importiert wird, sollte die "Draft Präzision" auf einen sinnvollen Wert eingestellt werden, um so die Erkennung von verbundenen Kanten zu erleichtern.

Wenn FreeCAD beim Import von CSG abstürzt, wird dringend empfohlen, "Modell automatisch nach Boolescher Operation überprüfen" im Menü zu aktivieren.

Tutorien

 * OpenSCAD Code Importieren

Verweise

 * Das offizielle Quellcodeverzeichnis des OpenSCAD-Projekts wird auf GitHub gehosted.
 * Offene Tickets gekennzeichnet mit "OpenSCAD" auf FreeCADs Github-Issue-Tracker. Es gibt auch Tickets auf dem jetzt archvierten Mantis-Bugtracker.
 * Modelle gekennzeichnet mit "OpenSCAD" auf Thingiverse.