Macros/ru

Введение
Макросы это удобный способ повторения сложных действий в FreeCAD. Вы просто записываете свои действия, в то время как вы их делаете, а затем сохраняете их под названием, и воспроизводите их когда нужно. Поскольку макросы в действительности список команд Python, вы можете также редактировать их, и создавать очень сложные сценарии.

While Python scripts normally have the extension, FreeCAD macros should have the  extension. A collection of macros written by experienced users is found in the macros recipes page.

See the Power users hub to learn more about the Python programming language, and about writing macros. In particular, you should start with these pages:
 * Introduction to Python
 * Python scripting tutorial
 * FreeCAD Scripting Basics

Как это работает
Включите вывод в консоль через меню. Вы увидите, что в FreeCAD, каждое действие что вы совершаете, например, при нажатии кнопки, выводится как команда Python. Эти команды могут быть записаны в макрос. Основным инструментом для создания макросов является панель инструментов макросы:. На это у вас есть 4 кнопки: запись(record), остановка записи(stop), редактирования и воспроизведения текущего макроса(edit and play the current macro).

Enable the console output in the menu. 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.

Его очень просто использовать: нажмите кнопку записи, вам будет предложено дать имя вашему макросу, а затем выполнить некоторые действия. Когда вы закончите, нажмите кнопку остановки записи, и ваши действия будут сохранены. Теперь вы можете получить доступ к диалогу макроса с помощью кнопки редактирования.



Здесь Вы можете управлять своими макросами, удалять, редактировать, дублировать, устанавливать новые с нуля. Если Вы редактируете макрос, он будет открыт в окне редактора, где Вы можете сделать изменения в его код. Новые макросы могут быть установлены используя кнопку, которая связана с Менеджером дополнений.

Пример
Нажмите кнопку записи(record), дайте имя, скажем, "cylinder 10x10", а затем, в верстаке Part, создайте цилиндр с радиусом = 10 и высотой = 10. Затем нажмите "Остановить запись(stop)" кнопку. В диалоге редактирования макросов, вы можете увидеть Python код, который был записан, и, если вы хотите, произведите изменения в нем. Чтобы выполнить макрос, просто нажмите кнопку execute на панели инструментов, пока ваш макрос в редакторе. Ваш макрос всегда сохраняется на диске, поэтому любые изменения которые вы делаете, или каких-либо новые созданные макросы, всегда будут доступны при следующем запуске FreeCAD.

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.

Настройка
Конечно, это не практично загружать макрос в редактор, затем чтобы использовать его. FreeCAD предоставляет гораздо лучшие способы использования макросов, такие как на них назначение клавиш, или добавлении записи в меню. Как только ваш макрос будет создан, все это можно сделать через

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



Customize Toolbars Таким образом, вы можете сделать ваш макрос реальным инструментом, как и любой стандартный инструмент FreeCAD. Это, приумножает власть Python сценариев в FreeCAD, позволяет с легкостью добавлять ваши собственные инструменты для интерфейса. Читайте дальше, Написание сценариев, если вы хотите знать больше о сценарияхPython.

See Customize Toolbars for a more detailed description.

Создание макросов без записи
Как установить макрос Вы также можете непосредственно копировать/вставлять Python код в макрос, без записи GUI действий. Просто создайте новый макрос, редактируйте его и вставте код. Затем можно сохранить макрос так же, как вы сохраняете документ FreeCAD. При следующем запуске FreeCAD, макрос появится в пункте меню "Installed 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.

See How to install macros for a more detailed description.

Хранилище макросов
Посетите страницу Рецепты макросов, где вы можете выбрать некоторые полезные макросы, чтобы добавить их к своей системе, FreeCAD.

Visit the Macros recipes page to pick some useful macros to add to your FreeCAD installation.

Ссылки
Установка дополнительных верстаков.


 * Automatically run macro at startup
 * Installing more workbenches

Учебники
Как устанавливать дополнительные верстаки.

You can manually install extensions, however, it is much simpler to just use the Addon Manager.
 * How to install macros
 * How to install additional workbenches