Macros/de: Difference between revisions

From FreeCAD Documentation
(Created page with "===Verknüpfungen (links)=== Weitere Arbeitsbereiche installieren")
No edit summary
 
(93 intermediate revisions by 9 users not shown)
Line 1: Line 1:
<languages/>
Makros sind eine bequeme Möglichkeit, komplexe Aktionen in FreeCAD zu bewältigen. Sie können einfach Aktionen nach Belieben aufzeichnen, unter einem Namen speichern und diese 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.


{{Docnav/de
===Wie es funktioniert===
|[[Scripting_and_macros/de|Skripte und Makros]]
|[[Scripts/de|Skripte]]
}}


{{TOCright}}
Wenn Sie die Ausgabe in der Konsole aktivieren (Menü Bearbeiten -> Einstellungen -> Allgemein -> Makros -> Script Befehle in Python-Konsole anzeigen), werden Sie 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 4 Knöpfe: '''Aufnahme''', '''Beenden der Aufnahme''', '''Bearbeitung''' und '''Wiedergabe des aktuellen Makros'''.


<span id="Introduction"></span>
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''':
== Einführung ==

[[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.

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:
* [[Introduction_to_Python/de|Einführung in Python]]
* [[Python_scripting_tutorial/de|Python Tutorium Skripten]]
* [[FreeCAD_Scripting_Basics/de|FreeCAD Grundlagen Skripten]]

<span id="How_it_works"></span>
== Wie es funktioniert ==

Aktiviere die Konsolenausgabe im Menü {{MenuCommand|Bearbeiten Einstellungen Python→ 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 Symbolleiste Makro: [[Image:Macros_toolbar.jpg]]. Sie enthält die 4 Schaltflächen: Aufnahme, Aufnahme stoppen, Bearbeiten und Ausführen 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.


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


Dort können Sie Ihre Makros verwalten, löschen, bearbeiten 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.
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.


<span id="Example"></span>
===Beispiel===
== Beispiel ==


Drücken Sie die Aufnahmetaste, geben Sie einen Namen ein, z. B. "Zylinder 10x10", anschließend erstellen Sie in der [[Part Workbench]] 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.
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.


<span id="Customizing"></span>
===Anpassen===
== 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 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ü: Tools -> Benutzerdefiniert:
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]]


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.
[[Customize_Toolbars|Customize Toolbars]] This way you can make your macro become a real tool, just like any standard FreeCAD tool. This, added to the power of python scripting within FreeCAD, makes it possible to easily add your own tools to the interface. Read on to the [[Scripting]] page if you want to know more about python scripting...


Siehe [[Customize_Toolbars/de|Werkzeugleisten anpassen]] für eine ausführlichere Beschreibung.
===Creating macros without recording===
[[How to install macros]] 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.


<span id="Creating_macros_without_recording"></span>
===Makros Fundgrube===
== 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.
Besuchen Sie die [[Macros recipes/de|Macros recipes]] 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.
===Verknüpfungen (links)===
[[Installing_more_workbenches|Weitere Arbeitsbereiche installieren]]


<span id="Macro_repositories"></span>
===Tutorials===
== Makro Repositorien ==
[[How_to_install_additional_workbenches|How to install additional workbenches]]


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.
{{docnav/de|[[Standard Menu/de|Standard Menu]]|[[Introduction to Python/de|Einführung in Python]]}}


<span id="Additional_information"></span>
== Zusätzliche Informationen ==


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


<span id="Tutorials"></span>
{{clear}}
== Tutorien ==
<languages/>

Du kannst Erweiterungen manuell installieren, es ist jedoch viel einfacher, einfach den [[Std_AddonMgr/de|Addon-Manager]] zu verwenden.
* [[How_to_install_macros/de|Wie man Makros installiert]]
* [[How_to_install_additional_workbenches/de|Wie man zusätzliche Arbeitsbereiche installiert]]


{{Docnav/de
|[[Scripting_and_macros/de|Skripte und Makros]]
|[[Scripts/de|Skripte]]
}}

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

Latest revision as of 13:19, 2 September 2023

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 → Python→ 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 Symbolleiste Makro: . Sie enthält die 4 Schaltflächen: Aufnahme, Aufnahme stoppen, Bearbeiten und Ausführen 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.