Macros/pl: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
 
(120 intermediate revisions by 6 users not shown)
Line 1: Line 1:
<languages/>
Makra wygodnym sposobem na tworzenie skomplikowanych działań we FreeCADzie. Po prostu nagrywasz działania kiedy wykonujesz, następnie zapisujesz pod jakąś nazwą i odtwarzasz kiedy chcesz. Ponieważ makra są w rzeczywsistości listą poleceń pythona, możesz je edytować i tworzyć bardzo skomplikowane skrypty.


{{Docnav/pl
===Jak to działa===
|[[Introduction to Python/pl|Wprowadzenie do środowiska Python]]
}}


{{TOCright}}
Jeśli aktywujesz wyjście konsoli (Menu Edit -> Preferences -> General -> Macros -> Show scripts commands in python console), zobaczysz je we FreeCADzie. Każdą akcja jaką wykonasz, jak naciśnięcie przycisku, wyzwoli polecenie pythona. Te polecenia są tym co może być zapisane w makrze. Główne narzędzie do tworzenia makr w pasku narzędzi makr: [[Image:Macros_toolbar.jpg]]. Masz na nim cztery przyciski: Nagrywaj, zatrzymaj nagrywanie, edytuj i odtwarzaj aktualne makro.


<span id="Introduction"></span>
Użytkowanie jest bardzo proste: naciśnij przycisk nagrywania, zostaniesz zapytany o nazwę dla makra, następnie wykonaj kilka działań. Kiedy skończysz. kliknij przycisk zatrzymujący nagrywanie, twoje działania zostaną zapisane. Teraz możesz uzyskać dostęp do okna dialogowego makra dzięki przyciskowi edycji:
==Wprowadzenie==


[[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.
[[Image:Macros.jpg]]


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]].
W tym miejscu możesz zarządzać makrami, usuwać je lub tworzyć nowe od podstaw. Przy edycji makra zostanie ono otwarte w oknie edytora, gdzie możesz dokonywać zmian w kodzie 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:
===Przykład===
* [[Introduction_to_Python/pl|Wprowadzenie do środowiska Python]]
* [[Python_scripting_tutorial/pl|Poradnik: Tworzenie skryptów Python]]
* [[FreeCAD_Scripting_Basics/pl|Podstawy tworzenia skryptów FreeCAD]]


<span id="How_it_works"></span>
Wciśnij przycisk nagrywania, nadaj nazwę, powiedzmy "cylinder 10x10", następnie w [[Part Workbench/pl|Warsztacie Part]], stwórz walec z promieniem = 10 i wysokością = 10. Potem naciśnij przycisk "zatrzymaj nagrywanie". W oknie edycji makra możesz zobaczyć kod pythona, który został zarejestrowany i, jeśli chcesz, zmień go. By wykonać twoje makro, kiedy znajduje się w edytorze, po prostu naciśnij znajdujący się na pasku narzędzi przycisk odtwarzania makra. Twoje makro jest zawsze zapisywane na dysk, więc jakakolwiek wykonana zmiana lub utworzenie nowego mara będzie widoczne przy następnym uruchomieniu FreeCADa.
==Jak to działa==


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.
===Dostosowanie===


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}}.
Oczywiście ładowanie makra do edytora w celu użycia nie jest praktyczne. FreeCAD zapewnia znacznie lepsze sposoby wykonania makra jak przypisanie skrótu klawiaturowego czy wstawienie elementu w menu. Podczas tworzenia twojego makra, wszystko można zrobić przez menu Tools -> Customize:

[[Image:Macros.png]]
{{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 [[Std_AddonMgr/pl|Menadżera dodatków]].

<span id="Example"></span>
==Przykład==

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.

<span id="Customizing"></span>
==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}}.


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


Tym sposobem możesz zrobić z makra prawdziwe narzędzie, jak każde inne standardowe narzędzie FreeCADa.To, wraz z siłą skryptowania pythona zawartą we FreeCADzie, umożliwia łatwe dodawanie do interfejsu twoich własnych narzędzi. Jeśli chcesz dowiedzieć się więcej o skryptach pythona przeczytaj stronę [[Scripting/pl|Skryptowanie]]...
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ł [[Customize_Toolbars|dostosowanie pasków narzędzi]].

<span id="Creating_macros_without_recording"></span>
==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ą {{MenuCommand|Zainstalowane makra}} w menu Makro.

Zobacz prezentacje [[How_to_install_macros/pl|jak zainstalować makrodefinicje]], aby uzyskać bardziej szczegółowy opis.

<span id="Macro_repositories"></span>
==Repozytorium makrodefinicji==

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.


<span id="Additional_information"></span>
===Tworzenie makr bez nagrywania===
==Informacje dodatkowe==


*[[Macro_at_Startup|Automatyczne uruchamianie makra podczas startu programu]]
Mażesz także bezpośrednio skopiować/wkleić kod do makra, bez nagrywania działań interfejsu graficznego. Po prostu stwórz nowe makro, edytuje je i wklej dwój kod. Możesz póżniej zapisać makro w ten sam sposób jak zapisujesz dokument FreeCADa. Przy następnym uruchomieniu FreeCADa makro pojawi się pod elementem "Installed Macros" w menu Macro.
*[[Installing_more_workbenches|Instalacja dodatkowych Środowisk pracy]].


<span id="Tutorials"></span>
===Repozytorium makr===
==Poradniki==


Możesz ręcznie instalować rozszerzenia, jednak znacznie prostsze jest użycie narzędzia [[Std_AddonMgr/pl|Menadżer dodatków]].
Odwiedź stronę [[Macros recipes]] by zebrać kilka użytecznych makr, które możesz dodać do swojej instalacji FreeCADa.
* [[How_to_install_macros/pl|Jak zainstalowac makro]]
* [[How_to_install_additional_workbenches/pl|Jak zainstalować dodatkowe Środowiska pracy]]


{{docnav/pl|Image Module/pl|Introduction to python/pl}}


{{Docnav/pl
{{languages | {{en|Macros}} {{se|Macros/se}} }}
|[[Introduction to Python/pl|Wprowadzenie do środowiska Python]]
}}


{{Powerdocnavi{{#translation:}}}}
[[Category:Poweruser Documentation]]
[[Category:Developer Documentation{{#translation:}}]]
[[Category:Python Code{{#translation:}}]]
[[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.