Scripts/de

Einführung
Unter Skripten verstehen wir die Erstellung topologischer Objekte mit dem Python-Interpreter von FreeCAD. FreeCAD könnte ein "sehr guter" Ersatz für OpenSCAD sein, vor allem, weil es einen echten Python-Interpreter hat, das heißt, es hat eine echte Programmiersprache an Bord, fast alles, was man mit der GUI machen kann, ist mit einem Python-Skript machbar.

Bedauerlicherweise sind die Informationen über das Skripten in der Dokumentation und sogar in diesem Wiki verstreut und es mangelt an Einheitlichkeit beim "Schreiben", und die meisten von ihnen werden zu technisch erklärt.



Zum Appetitanregen
Das erste Hindernis auf einem einfachen Weg zur Skripterstellung ist, dass es keine direkte Möglichkeit gibt, den FreeCAD internen Python Editor über einen Menüeintrag oder ein Symbol im Werkzeugleistenbereich aufzurufen, aber wenn man weiß, dass FreeCAD eine Datei mit der Erweiterung im internen Python Editor öffnet, ist der einfachste Trick, sie in Ihrem bevorzugten Texteditor zu erstellen und sie dann mit dem üblichen Befehl  zu öffnen.

Um die Dinge in einer höflichen Art und Weise zu machen, muss die Datei mit einer gewissen Ordnung geschrieben werden. Der FreeCAD-Python-Editor hat eine gute "Syntax-Hervorhebung", die in vielen einfachen Editoren wie Windows Notepad oder einige grundlegende Linux Editoren fehlt, so ist es ausreichend, diese wenigen Zeilen zu schreiben:

Diese werden mit einem aussagekräftigen Namen und der Erweiterung gespeichert und die resultierende Datei in FreeCAD geladen, mit dem besagten Befehl.

Ein Minimalbeispiel dafür, was in einem Skript enthalten sein muss, wird in diesem Teil des Codes gezeigt, den du als Vorlage für fast jedes zukünftige Skript verwenden könntest:

Der obige Code enthält einige Tricks:


 * Diese Zeile importiert FreeCAD in FreeCADs Python-Interpreter. Es mag überflüssig erscheinen, ist es aber nicht.
 * Placement Rotation and Vector sind in FreeCAD-Skripten weit verbreitet. Werden sie auf diese Weise importiert, erspart dies viele Tastendrücke und verkürzt Codezeilen, da statt oder  nur noch  oder  getippt werden muss.

Lasse uns mit einem kleinen Skript anfangen, das eine sehr kleine Arbeit leistet, aber die Kraft dieses Ansatzes zeigt.

Die obigen Codezeilen werden nach eingegeben und der grüne Pfeil in der Symbolleiste Macro gedrückt.

Du wirst einige magische Dinge sehen, ein neues Dokument mit dem Namen "Pippo" (italienischer Name von Goofy') ist geöffnet, und du wirst in der 3D Ansicht einen Würfel sehen, wie in der Abbildung unten.





Etwas mehr...
Nicht allzu erstaunlich? Ja, aber irgendwo müssen wir anfangen, wir können das Gleiche mit einem Zylinder tun, diese Kodezeilen nach der Methode und vor der Zeile  hinzufügen.

Auch hier nichts allzu Aufregendes. Aber bitte beachte einige Besonderheiten:


 * Das Fehlen des üblichen Verweises auf die, die in vielen Dokumentations Codeschnipseln vorhanden ist, ist beabsichtigt, dieser Code könnte sogar beim Aufruf von FreeCAD als Modul in einem externen Python Interpreter verwendet werden, die Sache ist mit einem AppImage nicht einfach zu bewerkstelligen, aber mit etwas Vorsicht wäre es machbar. Und in dem Standard Motto von Python, dass "besser explizit als implizit" in einer sehr " dürftigen" Weise erklärt, woher die Dinge kommen.
 * Beachte die Verwendung des dem aktiven Dokument zugewiesenen "konstanten" Namens in = ; activeDocument ist keine "Konstante" im strengen Sinne, aber in einer "semantischen" Weise ist unser "aktives Dokument", das für unseren Gebrauch eine richtige "Konstante" ist, so dass die Python Konvention, den "ALL CAPS" Namen für "Konstanten" zu verwenden, ganz zu schweigen davon, dass  viel kürzer ist als.
 * Jede Methode gibt eine Geometrie zurück, dies wird in der Fortsetzung der Seite deutlich.
 * Geometrie hatte nicht die Eigenschaft, wenn die einfachen Geometrien verwendet werden, um komplexere Geometrie zu erstellen, ist die Verwaltung von eine umständliche Sache.

Was ist nun mit diesen Geometrien zu tun?

Lasse uns boolesche Operationen einführen. Als Einstiegsbeispiel setze diese Zeilen nach, dies erzeugt eine Methode für eine Verschmelzung, auch als Vereinigung Operation bekannt:

Nichts Außergewöhnliches auch hier, beachte jedoch die Einheitlichkeit in der Methodencodierung; Dieser Ansatz ist linearer als derjenige, den man in anderen Tutorien zur Skripterstellung sieht, diese "Linearität" hilft sehr bei der Lesbarkeit und auch bei Ausschneiden-Kopieren-Einfügen Operationen.

Verwenden wir die Geometrien, löschen wir Zeilen unterhalb des Codeabschnitts, die mit beginnen, und fügen wir die folgenden Zeilen ein:

Starte das Skript mit dem grünen Pfeil und wir sehen in der 3D Ansicht so etwas wie:



Platzierung
Das Platzierungskonzept ist relativ komplex, siehe Aeroplane Tutorium für eine ausführlichere Erklärung.

Normalerweise ist es notwendig, dass sich die Geometrien gegenseitig respektieren. Beim Bau komplexer Objekte ist dies eine wiederkehrende Aufgabe, am häufigsten wird die Geometrie Eigenschaft verwendet.

FreeCAD bietet eine große Auswahl an Möglichkeiten, diese Eigenschaft zu setzen, eine ist mehr auf eine andere zugeschnitten, abhängig vom Wissen und dem Hintergrund des Benutzers, aber je klarer das Schreiben im zitierten Tutoriumerklärt wird, verwendet es eine eigentümliche Definition des Anteils von, recht einfach zu erlernen.

Aber gegenüber anderen Überlegungen ist eine Sache ausschlaggebend, nämlich der geometrische Referenzpunkt, also der Punkt, von dem aus das Objekt von FreeCAD modelliert wird, wie in dieser Tabelle beschrieben, kopiert von Platzierung:

Diese Informationen müssen wir vor allem dann im Auge behalten, wenn wir eine Rotation anwenden müssen.

Einige Beispiele mögen helfen, lösche die gesamte Zeile nach der Methode und füge den Teil des Codes darunter ein:

Lasse uns etwas im Code erklären:


 * Wir haben eine Methode verwendet, um eine Kugel zu definieren, wobei wir die einfachste Definition verwendet haben und nur den Radius verwendet haben.
 * Wir haben eine zweite Schreibweise für die Vereingung oder Verschmelzung eingeführt, die mehrere Objekte verwendet, nicht weiter entfernt von dem üblichen Part::Fuse es verwendet Part:Multifuse. Wir verwenden nur eine Eigenschaft . Wir haben ein Tupel als Argumente übergeben, aber es akzeptiert auch eine Liste.
 * Wir haben ein komplexes Objekt aeroplano' definiert. (italienisches Wort für Flugzeug), aber wir haben es auf eine "parametrische" Art und Weise getan, indem wir einige Parameter definiert und andere Parameter durch einige Berechnungen auf der Grundlage der Hauptparameter abgeleitet haben.
 * Wir haben einige Platzierungs Eigenschaften in der Methode verwendet, und bevor wir die endgültigen Geometrien zurückgeben, haben wir eine  Eigenschaft mit der Gieren-Stampfen-Rollen Schreibweise verwendet. Beachte die letzten, die ein Rotationszentrum der gesamten Geometrie definieren.

Man kann leicht feststellen, dass aeroplano Geometrie um sein "Baryzentrum" oder seinen "Schwerpunkt" rotiert, den ich in der Flügelmitte festgelegt habe, ein Ort, der relativ "natürlich" ist, aber wo immer man will, platziert werden könnte.

Der erste ist der Übersetzungsvektor, der hier nicht verwendet wird, aber wenn du  durch diese Zeilen ersetzt:

Du wirst diesen Text im Berichtsfenster sehen:

Was ist geschehen?

FreeCAD hat die mit anderen Worten unsere  Definition übersetzt, die drei Komponenten, Translation, Rotation und Rotationszentrum in den "internen" Werten von nur zwei Komponenten, Translation und Rotation', spezifiziert.

du kannst leicht den Wert von mit einer print Anweisung in der  Methode visualisieren und sehen das es ist:

mit anderen Worten, das Rotationszentrum der Geometrie liegt bei, aber dieses Rotationszentrum wird in der GUI nicht angezeigt, es könnte als Wert eingegeben werden, es könnte nicht leicht abgerufen werden.

Dies ist die Bedeutung des Wortes "umständlich", das ich zur Definition der Eigenschaft verwendet habe.

This is the complete code example with a decent script docstring following Google docstrings convention: