Macros/de: Difference between revisions

From FreeCAD Documentation
mNo edit summary
No edit summary
(46 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{docnav/de
{{Docnav/de
|[[Standard Menu/de|Standardmenü]]
|
|[[Introduction to Python/de|Einführung in Python]]
|[[Introduction to Python/de|Einführung in Python]]
}}
}}


{{TOCright}}
== Einleitung ==


== Einführung ==
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/de|Python]]-Befehlen ist, können Sie sie auch bearbeiten und sehr komplexe Skripte erstellen.


[[Macros/de|Makros]] sind eine bequeme Möglichkeit, komplexe Aktionen in FreeCAD zu wiederholen. Du kannst 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/de|Python]] Befehlen ist, kannst du sie auch bearbeiten und sehr komplexe Skripte erstellen.
Während Python-Skripte normalerweise die Dateiendung {{incode|.py}} haben, sollten FreeCAD-Makros die Endung {{incode|.FCMacro}} haben. Eine Sammlung von Makros, die von erfahrenene Anwendern geschrieben wurden, findet sich auf der [[macros recipes/de|Makrorezepte]]-Seite.


Während Python Skripte normalerweise die Dateiendung {{incode|.py}} haben, sollten FreeCAD Makros die Endung {{incode|.FCMacro}} haben. Eine Sammlung von Makros, die von erfahrenene Anwendern geschrieben wurden, findet sich auf der [[macros_recipes/de|Makrorezepte]] Seite.
Siehe [[Introduction to Python/de|Einführung in Python]] zum Kennenlernen der Python-Programmiersprache und dann [[Python scripting tutorial/de|Python Tutorial]] und [[FreeCAD Scripting Basics/de|FreeCAD Scripting Basics]] zum Schreiben von Makros.


Siehe [[Power_users_hub/de|Anlaufstelle für Intensivnutzer]] um mehr über die [[Python/de|Python]] Programmiersprache und über das Schreiben von Makros zu erfahren. Insbesondere solltest du mit diesen Seiten beginnen:
== Anwendung ==
* [[Introduction_to_Python/de|Einführung in Python]]
* [[Python_scripting_tutorial/de|Python Tutorium Skripten]]
* [[FreeCAD_Scripting_Basics/de|FreeCAD Grundlagen Skripten]]


== Wie es funktioniert ==
Aktivieren Sie die Ausgabe in der Konsole im Menü (MenuCommand|Bearbeiten → Einstellungen → Allgemein → MakrosScript 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: [[Image:Macros_toolbar.jpg]].<br />
Darauf haben Sie vier Schaltflächen: {{Button|Aufnahme}}, {{Button|Beenden der Aufnahme}}, {{Button|Bearbeitung}} und {{Button|Wiedergabe des aktuellen Makros}}.


Aktiviere die Konsolenausgabe im Menü {{MenuCommand|Bearbeiten → Einstellungen → Allgemein→ MakroSkript Befehle in Python Konsole anzeigen}}. Du wirst sehen, dass in FreeCAD jede Aktion, die du ausführst, wie z.B. das Drücken einer Schaltfläche, einen Python Befehl ausgibt. Diese Befehle sind das, was in einem Makro aufgezeichnet werden kann. Das Hauptwerkzeug zum Erstellen von Makros ist die Makro Werkzeugleiste: [[Image:Macros_toolbar.jpg]]. Auf ihr hast du 4 Schaltflächen: Aufnahme, Aufnahme stoppen, Bearbeiten und Abspielen des aktuellen Makros.
Sie ist sehr einfach zu bedienen: Drücken Sie die {{Button|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 {{Button|Aufzeichnung beenden}}, und Ihre Aktionen werden gespeichert. Zum Bearbeiten klicken Sie nun auf den Makro-Dialog mit der Schaltfläche {{Button|Bearbeiten}}.

Es ist sehr einfach zu bedienen: Drücke die Aufnahmetaste, du wirst aufgefordert, deinem Makro einen Namen zu geben und dann einige Aktionen durchzuführen. Wenn du fertig bist, klicke auf die Schaltfläche Aufzeichnung stoppen, und deine Aktionen werden gespeichert. Du kannst nun mit der Schaltfläche Bearbeiten auf den Makro Dialog zugreifen.


[[Image:Macros-DE.png]]
[[Image:Macros-DE.png]]
{{Caption|Makro-Dialog mit einer Liste der im System verfügbaren Makros}}
{{Caption|Makro Dialog, der die im System verfügbaren Makros auflistet}}


<div class="mw-translate-fuzzy">
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 {{Button|Addons...}} installiert werden, die den [[Addon-Manager/de|Addon-Manager]] aufruft.
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 {{Button|Addons...}} installiert werden, die den [[Std_AddonMgr/de|Addon-Manager]] aufruft.
</div>


== Beispiel ==
== Beispiel ==
Drücken Sie die {{Button|Aufnahme}}-Taste, geben Sie einen Namen ein, z. B. "Zylinder 10x10", anschließend erstellen Sie im [[Part Workbench/de|Part-Arbeitsbereich]] einen Zylinder mit Radius = 10 und Höhe = 10. Dann drücken Sie den {{Button|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 {{Button|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.


Drücken die Aufnahmetaste, gib einen Namen an, sagen wir "Zylinder 10x10", und erstelle dann im [[Part_Workbench/de|Formteil Arbeitsbereich]] einen Zylinder mit Radius = 10 und Höhe = 10. Drücke dann die "Aufzeichnung stoppen" Schaltfläche. Im Dialogfeld "Makros bearbeiten" siehst du den aufgezeichneten Python Code und kannst, wenn du möchtest, Änderungen daran vornehmen. Um dein Makro auszuführen, drücke einfach die "Ausführen" Schaltfläche in der Werkzeugleiste, während sich dein Makro im Editor befindet. Dein Makro wird immer auf der Festplatte gespeichert, so dass jede Änderung, die du vornimmst, oder jedes neue Makro, das du erstellst, immer verfügbar ist, wenn du FreeCAD das nächste Mal startest.
== 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ü {{MenuCommand|Werkzeuge → Benutzerdefiniert}}.
== Anpassung ==

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 dein Makro zu verwenden, wie das Zuweisen einer Tastenkombination oder einen Eintrag im Menü erstellen. Sobald dein Makro erstellt wurde, kannst du dies im Menü {{MenuCommand|Werkzeuge → Benutzerdefiniert}} erledigen.


[[Image:Macros-config-DE.png]]
[[Image:Macros-config-DE.png]]


[[Customize_Toolbars/de|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/de|Scripting]]-Seite, wenn Sie mehr über [[Python/de|Python]]-Programmierung wissen wollen.
Auf diese Weise kannst du dein Makro zu einem echten Werkzeug machen, genau wie jedes andere FreeCAD Standardwerkzeug. Dies, zusätzlich zu den Möglichkeiten der Python Skripterstellung innerhalb von FreeCAD, macht es möglich, der Schnittstelle auf einfache Weise deine eigenen Werkzeuge hinzuzufügen. Lies weiter auf der Seite [[Scripting/de|Scripting]], wenn du mehr über [[Python/de|Python]] Skripten erfahren möchtest.

Siehe [[Customize_Toolbars/de|Werkzeugleisten anpassen]] für eine ausführlichere Beschreibung.


== Erstellen von Makros ohne Aufzeichnung ==
== Erstellen von Makros ohne Aufzeichnung ==
[[How to install macros/de|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.


Du kannst Python Code auch direkt in ein Makro kopieren/einfügen, ohne die GUI Aktion aufzuzeichnen. Erstelle einfach ein neues Makro, bearbeite es und füge deinen Code ein. Du kannst dein Makro dann auf die gleiche Weise speichern, wie du ein FreeCAD Dokument speicherst. Wenn du FreeCAD das nächste Mal startest, erscheint das Makro unter dem Punkt "Installierte Makros" des Makro Menüs.
== Makros Fundgrube ==
Besuchen Sie die [[Macros recipes/de|Makrorezepte]]-Seite, um sich einige nützliche Makros holen, um diese Ihrer FreeCAD-Installation hinzuzufügen.


Siehe [[How_to_install_macros/de|Wie Makros installieren]] für eine ausführlichere Beschreibung.
== Verweise ==
[[Installing_more_workbenches/de|Weitere Arbeitsbereiche installieren]].


== Makro Repositorien ==
[[Macro_at_Startup|Automatically run macro at startup]].

Es gibt zwei wichtige Anlaufstellen für Makros. Die erste ist das offiziell geprüfte Makro Repository unter [https://github.com/FreeCAD/FreeCAD-macros GitHub]. Die zweite ist die [[Macros_recipes/de|Makrorezepte]] Seite Dort kannst du einige nützliche Makros finden, die du zu deiner FreeCAD Installation hinzufügen kannst. Makros aus beiden Repositorien können über den [[Std_AddonMgr|Addon Manager]] direkt in FreeCAD installiert werden.

== Zusätzliche Informationen ==

* [[Macro_at_Startup/de|Automatisches Makroausführen beim Start]]
* [[Installing_more_workbenches/de|Installieren weiterer Arbeitsbereiche]]


== Tutorien ==
== Tutorien ==
[[How_to_install_additional_workbenches/de|Wie werden weitere Arbeitsbereiche installiert?]].


Du kannst Erweiterungen manuell installieren, es ist jedoch viel einfacher, einfach den [[Std_AddonMgr/de|Addon-Manager]] zu verwenden.
<div class="mw-translate-fuzzy">
* [[How_to_install_macros/de|Wie man Makros installiert]]
{{docnav/de|[[Standard Menu/de|Standard Menu]]|[[Introduction to Python/de|Einführung in Python]]}}
* [[How_to_install_additional_workbenches/de|Wie man zusätzliche Arbeitsbereiche installiert]]
</div>


{{Userdocnavi/de}}


{{Docnav/de
[[Category:Poweruser Documentation/de]]
|
|[[Introduction to Python/de|Einführung in Python]]
}}


{{Powerdocnavi{{#translation:}}}}
{{clear}}
[[Category:Developer Documentation{{#translation:}}]]
[[Category:Python Code{{#translation:}}]]
[[Category:Macros{{#translation:}}]]

Revision as of 18:16, 3 November 2021

Einführung

Makros sind eine bequeme Möglichkeit, komplexe Aktionen in FreeCAD zu wiederholen. Du kannst 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, kannst du 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 Anlaufstelle für Intensivnutzer um mehr über die Python Programmiersprache und über das Schreiben von Makros zu erfahren. Insbesondere solltest du mit diesen Seiten beginnen:

Wie es funktioniert

Aktiviere die Konsolenausgabe im Menü Bearbeiten → Einstellungen → Allgemein→ Makro → Skript Befehle in Python Konsole anzeigen. Du wirst sehen, dass in FreeCAD jede Aktion, die du ausführst, wie z.B. das Drücken einer Schaltfläche, einen Python Befehl ausgibt. Diese Befehle sind das, was in einem Makro aufgezeichnet werden kann. Das Hauptwerkzeug zum Erstellen von Makros ist die Makro Werkzeugleiste: . Auf ihr hast du 4 Schaltflächen: Aufnahme, Aufnahme stoppen, Bearbeiten und Abspielen des aktuellen Makros.

Es ist sehr einfach zu bedienen: Drücke die Aufnahmetaste, du wirst aufgefordert, deinem Makro einen Namen zu geben und dann einige Aktionen durchzuführen. Wenn du fertig bist, klicke auf die Schaltfläche Aufzeichnung stoppen, und deine Aktionen werden gespeichert. Du kannst nun mit der Schaltfläche Bearbeiten auf den Makro Dialog zugreifen.

Makro Dialog, der die im System verfügbaren Makros auflistet

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 die Aufnahmetaste, gib einen Namen an, sagen wir "Zylinder 10x10", und erstelle dann im Formteil Arbeitsbereich einen Zylinder mit Radius = 10 und Höhe = 10. Drücke dann die "Aufzeichnung stoppen" Schaltfläche. Im Dialogfeld "Makros bearbeiten" siehst du den aufgezeichneten Python Code und kannst, wenn du möchtest, Änderungen daran vornehmen. Um dein Makro auszuführen, drücke einfach die "Ausführen" Schaltfläche in der Werkzeugleiste, während sich dein Makro im Editor befindet. Dein Makro wird immer auf der Festplatte gespeichert, so dass jede Änderung, die du vornimmst, oder jedes neue Makro, das du erstellst, immer verfügbar ist, wenn du FreeCAD das nächste Mal startest.

Anpassung

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 dein Makro zu verwenden, wie das Zuweisen einer Tastenkombination oder einen Eintrag im Menü erstellen. Sobald dein Makro erstellt wurde, kannst du dies im Menü Werkzeuge → Benutzerdefiniert erledigen.

Auf diese Weise kannst du dein Makro zu einem echten Werkzeug machen, genau wie jedes andere FreeCAD Standardwerkzeug. Dies, zusätzlich zu den Möglichkeiten der Python Skripterstellung innerhalb von FreeCAD, macht es möglich, der Schnittstelle auf einfache Weise deine eigenen Werkzeuge hinzuzufügen. Lies weiter auf der Seite Scripting, wenn du mehr über Python Skripten erfahren möchtest.

Siehe Werkzeugleisten anpassen für eine ausführlichere Beschreibung.

Erstellen von Makros ohne Aufzeichnung

Du kannst Python Code auch direkt in ein Makro kopieren/einfügen, ohne die GUI Aktion aufzuzeichnen. Erstelle einfach ein neues Makro, bearbeite es und füge deinen Code ein. Du kannst dein Makro dann auf die gleiche Weise speichern, wie du ein FreeCAD Dokument speicherst. Wenn du FreeCAD das nächste Mal startest, erscheint das Makro unter dem Punkt "Installierte Makros" des Makro Menüs.

Siehe Wie Makros installieren für eine ausführlichere Beschreibung.

Makro Repositorien

Es gibt zwei wichtige Anlaufstellen für Makros. Die erste ist das offiziell geprüfte Makro Repository unter GitHub. Die zweite ist die Makrorezepte Seite Dort kannst du einige nützliche Makros finden, die du zu deiner FreeCAD Installation hinzufügen kannst. Makros aus beiden Repositorien können über den Addon Manager direkt in FreeCAD installiert werden.

Zusätzliche Informationen

Tutorien

Du kannst Erweiterungen manuell installieren, es ist jedoch viel einfacher, einfach den Addon-Manager zu verwenden.