Macros/pl: Difference between revisions

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

{{Docnav/pl
{{Docnav/pl
|[[Introduction to Python/pl|Wprowadzenie do środowiska Python]]
|[[Standard Menu/pl|Menu główne]]
|[[Introduction to Python/pl|Wprowadzenie do Pythona]]
}}
}}

{{TOCright}}
{{TOCright}}


<span id="Introduction"></span>
==Wprowadzenie==
==Wprowadzenie==


[[Macros|Makra]] to wygodny sposób na odtworzenie złożonych działań w programie FreeCAD. Po prostu nagrywasz działania tak, jak je wykonujesz, a następnie zapisujesz je pod nazwą i odtwarzasz, kiedy tylko chcesz. Ponieważ makra są w rzeczywistości listą poleceń [[Python|Python]], możesz je również edytować i tworzyć bardzo złożone skrypty.
[[Macros/pl|Makra]] to wygodny sposób na odtworzenie złożonych działań w programie FreeCAD. Po prostu nagrywasz działania tak, jak je wykonujesz, a następnie zapisujesz je pod nazwą i odtwarzasz, kiedy tylko chcesz. Ponieważ makra są w rzeczywistości listą poleceń [[Python|Python]], możesz je również edytować i tworzyć bardzo złożone skrypty.


Podczas gdy skrypty Pythona zwykle mają rozszerzenie {{incode|.py}}, makra FreeCAD powinny mieć rozszerzenie {{incode|.FCMacro}}. Zbiór makr napisanych przez doświadczonych użytkowników znajduje się na stronie [[macros recipes|przepisy na makra]].
Podczas gdy skrypty Pythona zwykle mają rozszerzenie {{incode|.py}}, makra FreeCAD powinny mieć rozszerzenie {{incode|.FCMacro}}. Zbiór makr napisanych przez doświadczonych użytkowników znajduje się na stronie [[macros_recipes|przepisy na makra]].


Zobacz [[Power_users_hub/pl|Centrum Power użytkownika]], aby dowiedzieć się więcej o języku programowania [[Python|Python]] oraz o pisaniu makr. W szczególności powinieneś zacząć od tych stron:
<div class="mw-translate-fuzzy">
* [[Introduction_to_Python/pl|Wprowadzenie do środowiska Python]]
Zobacz [[Introduction to Python|Wprowadzenie do Pythona]], aby zapoznać się z językiem programowania '''Python''', a następnie [[Python scripting tutorial|Poradnik do pisania skryptów Python]] i [[FreeCAD Scripting Basics|Podstawy skryptów FreeCAD]], które pomogą Ci nauczyć się pisania makr.
* [[Python_scripting_tutorial/pl|Poradnik: Tworzenie skryptów Python]]
</div>
* [[FreeCAD_Scripting_Basics/pl|Podstawy tworzenia skryptów FreeCAD]]


<span id="How_it_works"></span>
<div class="mw-translate-fuzzy">
==Jak to działa==
==Jak to działa==


Włącz obsługę wyjścia konsoli w menu {{MenuCommand|Edcja → Preferencje → Ogólne → Makro → Pokaż polecenia skryptów w konsoli python}}. Zobaczysz, że w programie FreeCAD każda wykonywana czynność, taka jak naciśnięcie przycisku, wysyła polecenie Pythona. To właśnie te polecenia mogą być nagrywane w makrze. Głównym narzędziem do tworzenia makr jest pasek narzędzi makr: [[Image:Macros_toolbar.jpg]]. Na nim znajdują się 4 przyciski: Rejestrowanie makr, Zatrzymaj nagrywanie makra, Wykonaj makro.
Włącz obsługę wyjścia konsoli w menu {{MenuCommand|Edcja → Preferencje ...Python → Makro → Pokaż polecenia skryptów w konsoli python}}. Zobaczysz, że w programie FreeCAD każda wykonywana czynność, taka jak naciśnięcie przycisku, wysyła polecenie Pythona. To właśnie te polecenia mogą być nagrywane w makrze. Głównym narzędziem do tworzenia makr jest pasek narzędzi makr: [[Image:Macros_toolbar.jpg]]. Na nim znajdują się 4 przyciski: Rejestrowanie makr, Zatrzymaj nagrywanie makra, Wykonaj makro.
</div>

Enable the console output in the menu {{MenuCommand|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: [[Image:Macros_toolbar.jpg]]. On it you have 4 buttons: Record, stop recording, edit and play the current macro.


Jest to bardzo łatwe w użyciu: <br />Naciśnij przycisk {{button|Rejestrowanie makr}}, zostaniesz poproszony o podanie nazwy dla swojego makra, a następnie wykonaj kilka czynności. Kiedy skończysz, kliknij przycisk {{KEY|Zatrzymaj nagrywanie makra}}, a Twoje działania zostaną zapisane. Teraz możesz uzyskać dostęp do okna dialogowego makra za pomocą przycisku {{button|Edycja}}.
Jest to bardzo łatwe w użyciu: <br />Naciśnij przycisk {{button|Rejestrowanie makr}}, zostaniesz poproszony o podanie nazwy dla swojego makra, a następnie wykonaj kilka czynności. Kiedy skończysz, kliknij przycisk {{KEY|Zatrzymaj nagrywanie makra}}, a Twoje działania zostaną zapisane. Teraz możesz uzyskać dostęp do okna dialogowego makra za pomocą przycisku {{button|Edycja}}.
Line 29: Line 29:
{{Caption|Okno dialogowe Makro, zawierające listę makrodefinicji dostępnych w systemie.}}
{{Caption|Okno dialogowe Makro, zawierające listę makrodefinicji dostępnych w systemie.}}


W tym miejscu możesz zarządzać swoimi makrami, usuwać, edytować, powielać, instalować lub tworzyć nowe od podstaw. Jeśli edytujesz makro, zostanie ono otwarte w oknie edytora, w którym możesz dokonać zmian w jego kodzie. Nowe makra można zainstalować za pomocą przycisku {{button|Dodatki...}}, który prowadzi do [[AddonManager|Addon Manager]].
W tym miejscu możesz zarządzać swoimi makrami, usuwać, edytować, powielać, instalować lub tworzyć nowe od podstaw. Jeśli edytujesz makro, zostanie ono otwarte w oknie edytora, w którym możesz dokonać zmian w jego kodzie. Nowe makra można zainstalować za pomocą przycisku {{button|Dodatki...}}, który prowadzi do [[Std_AddonMgr/pl|Menadżera dodatków]].


<span id="Example"></span>
<div class="mw-translate-fuzzy">
==Przykład==
==Przykład==


Naciśnij przycisk nagrywania, podaj nazwę, powiedzmy "cylinder 10x10", a następnie w [[Part Workbench|Part]] utwórz walec o promieniu=10 i wysokości=10. Następnie naciśnij przycisk {{button|Zatrzymaj}}. W oknie dialogowym edycji makr możesz zobaczyć kod Pythona, który został nagrany i, jeśli chcesz, wprowadź do niego zmiany. Aby wykonać makro, wystarczy nacisnąć przycisk wykonania na pasku narzędzi, gdy makro znajduje się w edytorze. Twoje makro jest zawsze zapisywane na dysku, więc każda wprowadzona zmiana lub każde nowe makro, które stworzysz, będzie zawsze dostępne przy następnym uruchomieniu programu FreeCAD.
Naciśnij przycisk nagrywania, podaj nazwę, powiedzmy "cylinder 10x10", a następnie w środowisku [[Part_Workbench/pl|Część]] utwórz walec o promieniu=10 i wysokości=10. Następnie naciśnij przycisk {{button|Zatrzymaj}}. W oknie dialogowym edycji makr możesz zobaczyć kod Pythona, który został nagrany i, jeśli chcesz, wprowadź do niego zmiany. Aby wykonać makro, wystarczy nacisnąć przycisk wykonania na pasku narzędzi, gdy makro znajduje się w edytorze. Twoje makro jest zawsze zapisywane na dysku, więc każda wprowadzona zmiana lub każde nowe makro, które stworzysz, będzie zawsze dostępne przy następnym uruchomieniu programu FreeCAD.
</div>


<span id="Customizing"></span>
Press the record button, give a name, let's say "cylinder 10x10", then, in the [[Part Workbench|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.

<div class="mw-translate-fuzzy">
==Dostosowywanie==
==Dostosowywanie==


Oczywiście nie jest praktyczne ładowanie makra w edytorze, aby móc z niego korzystać. FreeCAD zapewnia znacznie lepsze sposoby korzystania z makra, takie jak przypisanie do niego skrótu klawiaturowego lub umieszczenie jego pozycji w menu. Po utworzeniu makra, wszystko to można zrobić poprzez menu {{MenuCommand|Narzędzia → Dostosuj}}.
Oczywiście nie jest praktyczne ładowanie makra w edytorze, aby móc z niego korzystać. FreeCAD zapewnia znacznie lepsze sposoby korzystania z makra, takie jak przypisanie do niego skrótu klawiaturowego lub umieszczenie jego pozycji w menu. Po utworzeniu makra, wszystko to można zrobić poprzez menu {{MenuCommand|Narzędzia → Dostosuj}}.
</div>

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 {{MenuCommand|Tools → Customize}} menu.


[[Image:Macros config.jpg]]
[[Image:Macros config.jpg]]


W ten sposób możesz sprawić, że Twoje makro stanie się prawdziwym narzędziem, tak jak każde standardowe narzędzie FreeCAD. Jest to dodatek do mocy skryptów Python w FreeCAD, który umożliwia łatwe i przyjemne tworzenie własnych narzędzi w interfejsie.
<div class="mw-translate-fuzzy">
[[Customize Toolbars|Dostosuj paski narzędzi]] W ten sposób możesz sprawić, że Twoje makro stanie się prawdziwym narzędziem, tak jak każde standardowe narzędzie FreeCAD. Jest to dodatek do mocy skryptów Python w FreeCAD, który umożliwia łatwe i przyjemne tworzenie własnych narzędzi w interfejsie.
Aby dowiedzieć się więcej na temat skryptów [[Python]], przeczytaj stronę [[Scripting|Tworzenie skryptów]].
</div>


Aby uzyskać bardziej szczegółowy opis, zobacz artykuł [[Customize_Toolbars|dostosowanie pasków narzędzi]].
See [[Customize_Toolbars|Customize Toolbars]] for a more detailed description.


<span id="Creating_macros_without_recording"></span>
<div class="mw-translate-fuzzy">
===Tworzenie makr bez nagrywania===
==Tworzenie makr bez nagrywania==


[[How to install macros|Jak zainstalować makra]] Możesz również bezpośrednio skopiować/wkleić kod pytona do makra, bez nagrywania akcji w GUI. Po prostu utwórz nowe makro, edytuj je i wklej swój kod. Następnie możesz zapisać swoje makro w ten sam sposób, w jaki zapisujesz dokument FreeCAD. Następnym razem, gdy uruchomisz FreeCAD, makro pojawi się pod pozycją {{MenuCommand|Zainstalowane makra}} w menu Makro.
Możesz również bezpośrednio skopiować/wkleić kod pytona do makra, bez nagrywania akcji w GUI. Po prostu utwórz nowe makro, edytuj je i wklej swój kod. Następnie możesz zapisać swoje makro w ten sam sposób, w jaki zapisujesz dokument FreeCAD. Następnym razem, gdy uruchomisz FreeCAD, makro pojawi się pod pozycją {{MenuCommand|Zainstalowane makra}} w menu Makro.
</div>


Zobacz prezentacje [[How_to_install_macros/pl|jak zainstalować makrodefinicje]], aby uzyskać bardziej szczegółowy opis.
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="Macro_repositories"></span>
See [[How to install macros|How to install macros]] for a more detailed description.

<div class="mw-translate-fuzzy">
==Repozytorium makrodefinicji==
==Repozytorium makrodefinicji==
Odwiedź stronę [[Macros recipes|Przepisy na makra]], aby wybrać kilka przydatnych makrodefinicji do dodania w programie FreeCAD.
</div>


Istnieją dwa główne miejsca, w których można znaleźć makra. Pierwszym z nich jest oficjalne repozytorium makrodefinicji na [https://github.com/FreeCAD/FreeCAD-macros GitHub]. Drugim jest strona [[Macros_recipes/pl|Przepisy na makrodefinicje]], z której możesz wybrać kilka użytecznych makrodefinicji do dodania do swojej instalacji FreeCAD. Makrodefinicje z obu repozytoriów mogą być instalowane poprzez [[Std_AddonMgr/pl|Menadżer dodatków]] bezpośrednio z programu FreeCAD.
Visit the [[Macros recipes|Macros recipes]] page to pick some useful macros to add to your FreeCAD installation.


<span id="Additional_information"></span>
<div class="mw-translate-fuzzy">
==Przydatne linki==
==Informacje dodatkowe==
[[Installing_more_workbenches|Instalacja dodatkowych Środowisk pracy]].
</div>


* [[Macro_at_Startup|Automatically run macro at startup]]
*[[Macro_at_Startup|Automatyczne uruchamianie makra podczas startu programu]]
* [[Installing_more_workbenches|Installing more workbenches]]
*[[Installing_more_workbenches|Instalacja dodatkowych Środowisk pracy]].


<span id="Tutorials"></span>
<div class="mw-translate-fuzzy">
==Poradniki==
==Poradniki==
[[How_to_install_additional_workbenches|Jak zainstalować dodatkowe Środowiska pracy]].
</div>


Możesz ręcznie instalować rozszerzenia, jednak znacznie prostsze jest użycie narzędzia [[Std_AddonMgr/pl|Menadżer dodatków]].
You can manually install extensions, however, it is much simpler to just use the [[Std_AddonMgr|Addon Manager]].
* [[How_to_install_macros/pl|Jak zainstalowac makro]]
* [[How to install macros|How to install macros]]
* [[How_to_install_additional_workbenches|How to install additional workbenches]]
* [[How_to_install_additional_workbenches/pl|Jak zainstalować dodatkowe Środowiska pracy]]



{{Docnav/pl
{{Docnav/pl
|[[Introduction to Python/pl|Wprowadzenie do środowiska Python]]
|[[Standard Menu/pl|Menu główne]]
|[[Introduction to Python/pl|Wprowadzenie do Pythona]]
}}
}}


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

Latest revision as of 16:35, 14 August 2023

Wprowadzenie

Makra to wygodny sposób na odtworzenie złożonych działań w programie FreeCAD. Po prostu nagrywasz działania tak, jak je wykonujesz, a następnie zapisujesz je pod nazwą i odtwarzasz, kiedy tylko chcesz. Ponieważ makra są w rzeczywistości listą poleceń Python, możesz je również edytować i tworzyć bardzo złożone skrypty.

Podczas gdy skrypty Pythona zwykle mają rozszerzenie .py, makra FreeCAD powinny mieć rozszerzenie .FCMacro. Zbiór makr napisanych przez doświadczonych użytkowników znajduje się na stronie przepisy na makra.

Zobacz Centrum Power użytkownika, aby dowiedzieć się więcej o języku programowania Python oraz o pisaniu makr. W szczególności powinieneś zacząć od tych stron:

Jak to działa

Włącz obsługę wyjścia konsoli w menu Edcja → Preferencje ... → Python → Makro → Pokaż polecenia skryptów w konsoli python. Zobaczysz, że w programie FreeCAD każda wykonywana czynność, taka jak naciśnięcie przycisku, wysyła polecenie Pythona. To właśnie te polecenia mogą być nagrywane w makrze. Głównym narzędziem do tworzenia makr jest pasek narzędzi makr: . Na nim znajdują się 4 przyciski: Rejestrowanie makr, Zatrzymaj nagrywanie makra, Wykonaj makro.

Jest to bardzo łatwe w użyciu:
Naciśnij przycisk Rejestrowanie makr, zostaniesz poproszony o podanie nazwy dla swojego makra, a następnie wykonaj kilka czynności. Kiedy skończysz, kliknij przycisk Zatrzymaj nagrywanie makra, a Twoje działania zostaną zapisane. Teraz możesz uzyskać dostęp do okna dialogowego makra za pomocą przycisku Edycja.

Okno dialogowe Makro, zawierające listę makrodefinicji dostępnych w systemie.

W tym miejscu możesz zarządzać swoimi makrami, usuwać, edytować, powielać, instalować lub tworzyć nowe od podstaw. Jeśli edytujesz makro, zostanie ono otwarte w oknie edytora, w którym możesz dokonać zmian w jego kodzie. Nowe makra można zainstalować za pomocą przycisku Dodatki..., który prowadzi do Menadżera dodatków.

Przykład

Naciśnij przycisk nagrywania, podaj nazwę, powiedzmy "cylinder 10x10", a następnie w środowisku Część utwórz walec o promieniu=10 i wysokości=10. Następnie naciśnij przycisk Zatrzymaj. W oknie dialogowym edycji makr możesz zobaczyć kod Pythona, który został nagrany i, jeśli chcesz, wprowadź do niego zmiany. Aby wykonać makro, wystarczy nacisnąć przycisk wykonania na pasku narzędzi, gdy makro znajduje się w edytorze. Twoje makro jest zawsze zapisywane na dysku, więc każda wprowadzona zmiana lub każde nowe makro, które stworzysz, będzie zawsze dostępne przy następnym uruchomieniu programu FreeCAD.

Dostosowywanie

Oczywiście nie jest praktyczne ładowanie makra w edytorze, aby móc z niego korzystać. FreeCAD zapewnia znacznie lepsze sposoby korzystania z makra, takie jak przypisanie do niego skrótu klawiaturowego lub umieszczenie jego pozycji w menu. Po utworzeniu makra, wszystko to można zrobić poprzez menu Narzędzia → Dostosuj.

W ten sposób możesz sprawić, że Twoje makro stanie się prawdziwym narzędziem, tak jak każde standardowe narzędzie FreeCAD. Jest to dodatek do mocy skryptów Python w FreeCAD, który umożliwia łatwe i przyjemne tworzenie własnych narzędzi w interfejsie.

Aby uzyskać bardziej szczegółowy opis, zobacz artykuł dostosowanie pasków narzędzi.

Tworzenie makr bez nagrywania

Możesz również bezpośrednio skopiować/wkleić kod pytona do makra, bez nagrywania akcji w GUI. Po prostu utwórz nowe makro, edytuj je i wklej swój kod. Następnie możesz zapisać swoje makro w ten sam sposób, w jaki zapisujesz dokument FreeCAD. Następnym razem, gdy uruchomisz FreeCAD, makro pojawi się pod pozycją Zainstalowane makra w menu Makro.

Zobacz prezentacje jak zainstalować makrodefinicje, aby uzyskać bardziej szczegółowy opis.

Repozytorium makrodefinicji

Istnieją dwa główne miejsca, w których można znaleźć makra. Pierwszym z nich jest oficjalne repozytorium makrodefinicji na GitHub. Drugim jest strona Przepisy na makrodefinicje, z której możesz wybrać kilka użytecznych makrodefinicji do dodania do swojej instalacji FreeCAD. Makrodefinicje z obu repozytoriów mogą być instalowane poprzez Menadżer dodatków bezpośrednio z programu FreeCAD.

Informacje dodatkowe

Poradniki

Możesz ręcznie instalować rozszerzenia, jednak znacznie prostsze jest użycie narzędzia Menadżer dodatków.