Makros

Other languages:

Einleitung

Makros sind eine bequeme Möglichkeit, komplexe Aktionen in FreeCAD zu wiederholen. Sie können einfach Aktionen nach Belieben aufzeichnen, diese dann unter einem Namen speichern und sie jederzeit wieder abspielen. Da ein Makro in Wirklichkeit eine Liste aus Python-Befehlen ist, können Sie sie auch bearbeiten und sehr komplexe Skripte erstellen.

Während Python-Skripte normalerweise die Dateiendung .py haben, sollten FreeCAD-Makros die Endung .FCMacro haben. Eine Sammlung von Makros, die von erfahrenene Anwendern geschrieben wurden, findet sich auf der Makrorezepte-Seite.

Siehe Einführung in Python zum Kennenlernen der Python-Programmiersprache und dann Python Tutorial und FreeCAD Scripting Basics zum Schreiben von Makros.

Anwendung

Aktivieren Sie die Ausgabe in der Konsole im Menü (MenuCommand|Bearbeiten → Einstellungen → Allgemein → Makros → Script Befehle in Python-Konsole anzeigen). Sie werden sehen, dass jede Aktion die Sie in FreeCAD vornehmen, wie z.B. das Drücken einer Taste, den entsprechenden Python-Befehl ausgibt. Genau diese Befehle sind es, die auch in einem Makro aufgezeichnet werden. Das wichtigste Werkzeug zur Erstellung von Makros ist die Makro-Symbolleiste: .
Darauf haben Sie vier Schaltflächen: Aufnahme, Beenden der Aufnahme, Bearbeitung und Wiedergabe des aktuellen Makros.

Enable the console output in the menu Edit → Preferences → General → Macro → Show scripts commands in python console. You will see that in FreeCAD, every action you do, such as pressing a button, outputs a Python command. Those commands are what can be recorded in a macro. The main tool for making macros is the macros toolbar: . On it you have 4 buttons: Record, stop recording, edit and play the current macro.

Sie ist sehr einfach zu bedienen: Drücken Sie die Aufnahme-Taste. Nun werden Sie aufgefordert einen Namen für Ihr Makro zu vergeben, dann führen Sie einige Aktionen aus. Wenn Sie fertig sind, klicken Sie auf die Schaltfläche Aufzeichnung beenden, und Ihre Aktionen werden gespeichert. Zum Bearbeiten klicken Sie nun auf den Makro-Dialog mit der Schaltfläche Bearbeiten.

Makro-Dialog mit einer Liste der im System verfügbaren Makros

Dort können Sie Ihre Makros verwalten, löschen, bearbeiten, duplizieren, installieren oder von Grund auf neue erstellen. Wenn Sie ein Makro bearbeiten, wird es in einem Editor-Fenster geöffnet, wo Sie Änderungen an seinem Code vornehmen können. Neue Makros können (ab FreeCAD v0.17) über die Schaltfläche Addons... installiert werden, die den Addon-Manager aufruft.

Beispiel

Drücken Sie die Aufnahme-Taste, geben Sie einen Namen ein, z. B. "Zylinder 10x10", anschließend erstellen Sie im Part-Arbeitsbereich einen Zylinder mit Radius = 10 und Höhe = 10. Dann drücken Sie den Aufnahme beenden-Knopf. Im Bearbeiten-Dialog von Makros können Sie den Python-Code sehen, der aufgezeichnet wurde, und wenn Sie wollen, können Sie daran Änderungen vornehmen. Um ein Makro auszuführen, drücken Sie einfach auf die Schaltfläche Ausführen in der Symbolleiste, während Ihr Makro im Editor angezeigt wird. Ihre Makros werden immer auf der Festplatte gespeichert, so dass jede Änderung, die Sie machen, oder ein Makro, das Sie neu erstellen, immer beim nächsten Start von FreeCAD verfügbar sein wird.

Press the record button, give a name, let's say "cylinder 10x10", then, in the Part Workbench, create a cylinder with radius = 10 and height = 10. Then, press the "stop recording" button. In the edit macros dialog, you can see the python code that has been recorded, and, if you want, make alterations to it. To execute your macro, simply press the execute button on the toolbar while your macro is in the editor. You macro is always saved to disk, so any change you make, or any new macro you create, will always be available next time you start FreeCAD.

Anpassen

Natürlich ist es nicht praktisch vor dem Benutzen immer erst ein Makro in den Editor zu laden. FreeCAD bietet deutlich bessere Möglichkeiten um Ihr Makro zu verwenden, wie das Zuweisen einer Tastenkombination oder einen Eintrag im Menü erstellen. Sobald Ihr Makro erstellt wurde, können Sie dies erledigen im Menü Werkzeuge → Benutzerdefiniert.

Of course it is not practical to load a macro in the editor in order to use it. FreeCAD provides much better ways to use your macro, such as assigning a keyboard shortcut to it or putting an entry in the menu. Once your macro is created, all this can be done via the Tools → Customize menu.

Benutzerdefinierte Anpassung der Werkzeugleisten Auf diesem Weg können Sie Ihr Makro zu einem echten Werkzeug machen, wie jedes Standard-FreeCAD-Werkzeug. Dies, kombiniert mit der Macht von Python-Scripting innerhalb von FreeCAD, macht es leicht möglich, Ihre eigenen Werkzeuge in die Oberfläche einzubinden. Lesen Sie auf der Scripting-Seite, wenn Sie mehr über Python-Programmierung wissen wollen.

See Customize Toolbars for a more detailed description.

Erstellen von Makros ohne Aufzeichnung

Makros installieren Sie können Python-Code auch direkt in ein Makro kopieren/einfügen, ohne Aufzeichnung von Aktionen. Erstellen Sie einfach ein neues Makro, bearbeiten Sie es, und fügen Sie den Code ein. Anschließend können Sie das Makro genau wie ein FreeCAD-Dokument speichern. Beim nächsten Start von FreeCAD wird das Makro unter dem "Installierte Makros"-Punkt des Makro-Menü angezeigt.

You can also directly copy/paste python code into a macro, without recording GUI action. Simply create a new macro, edit it, and paste your code. You can then save your macro the same way as you save a FreeCAD document. Next time you start FreeCAD, the macro will appear under the "Installed Macros" item of the Macro menu.

See How to install macros for a more detailed description.