Macros - Revision history

LabRPS at 03:24, 30 October 2024

2024-10-30T03:24:20Z

← Older revision		Revision as of 20:24, 29 October 2024
Line 30:		Line 30:
	== Example ==		== Example ==

	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 LabRPS.		Press the record button, give a name, let's say "wind on tall building", then, in the [[WindLab_Workbench\|WindLab Workbench]], create a wind simulation. 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 LabRPS.

	== Customizing ==		== Customizing ==
Line 39:		Line 39:

	This way you can make your macro become a real tool, just like any standard LabRPS tool. This, added to the power of python scripting within LabRPS, makes it possible to easily add your own tools to the interface.		This way you can make your macro become a real tool, just like any standard LabRPS tool. This, added to the power of python scripting within LabRPS, makes it possible to easily add your own tools to the interface.

	~~See [[Customize_Toolbars\|Customize Toolbars]] for a more detailed description.~~

	== Creating macros without recording ==		== Creating macros without recording ==
Line 51:		Line 49:

	There are two main places for macros. The first one is the official peer-reviewed macro repository on [https://github.com/LabRPS/LabRPS-macros GitHub]. The second one is the [[Macros_recipes\|Macros recipes]] page from which you can pick some useful macros to add to your LabRPS installation. Macros from both repositories can be installed via the [[Std_AddonMgr\|Addon Manager]] directly from LabRPS.		There are two main places for macros. The first one is the official peer-reviewed macro repository on [https://github.com/LabRPS/LabRPS-macros GitHub]. The second one is the [[Macros_recipes\|Macros recipes]] page from which you can pick some useful macros to add to your LabRPS installation. Macros from both repositories can be installed via the [[Std_AddonMgr\|Addon Manager]] directly from LabRPS.

	~~== Additional information ==~~

	* [[Macro_at_Startup\|Automatically run macro at startup]]
	* [[Installing_more_workbenches\|Installing more workbenches]]

	== Tutorials ==		== Tutorials ==
Line 61:		Line 54:
	You can manually install extensions, however, it is much simpler to just use the [[Std_AddonMgr\|Addon Manager]].		You can manually install extensions, however, it is much simpler to just use the [[Std_AddonMgr\|Addon Manager]].
	* [[How_to_install_macros\|How to install macros]]		* [[How_to_install_macros\|How to install macros]]
	* [[How_to_install_additional_workbenches\|How to install additional workbenches]]

LabRPS: /* Introduction */

2024-07-27T16:15:36Z

Introduction

← Older revision		Revision as of 09:15, 27 July 2024
Line 10:		Line 10:
	[[Macros\|Macros]] are a convenient way to reproduce complex actions in LabRPS. You simply record actions as you do them, then save those actions under a name, and replay them whenever you want. Since macros are in reality a list of [[Python\|Python]] commands, you can also edit them, and create very complex scripts.		[[Macros\|Macros]] are a convenient way to reproduce complex actions in LabRPS. You simply record actions as you do them, then save those actions under a name, and replay them whenever you want. Since macros are in reality a list of [[Python\|Python]] commands, you can also edit them, and create very complex scripts.

	While Python scripts normally have the {{incode\|.py}} extension, LabRPS macros should have the {{incode\|.~~FCMacro~~}} extension. A collection of macros written by experienced users is found in the [[Macros_recipes\|macros recipes]] page.		While Python scripts normally have the {{incode\|.py}} extension, LabRPS macros should have the {{incode\|.RPSMacro}} extension. A collection of macros written by experienced users is found in the [[Macros_recipes\|macros recipes]] page.

	See the [[Power_users_hub\|Power users hub]] to learn more about the [[Python\|Python]] programming language, and about writing macros. In particular, you should start with these pages:		See the [[Power_users_hub\|Power users hub]] to learn more about the [[Python\|Python]] programming language, and about writing macros. In particular, you should start with these pages:

LabRPS: /* Customizing */

2024-07-27T09:18:40Z

Customizing

← Older revision		Revision as of 02:18, 27 July 2024
Line 36:		Line 36:
	Of course it is not practical to load a macro in the editor in order to use it. LabRPS 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.		Of course it is not practical to load a macro in the editor in order to use it. LabRPS 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.png]]

	This way you can make your macro become a real tool, just like any standard LabRPS tool. This, added to the power of python scripting within LabRPS, makes it possible to easily add your own tools to the interface.		This way you can make your macro become a real tool, just like any standard LabRPS tool. This, added to the power of python scripting within LabRPS, makes it possible to easily add your own tools to the interface.

LabRPS: Created page with "{{Docnav |Scripting and macros |Scripts }} {{TOCright}} == Introduction == Macros are a convenient way to reproduce complex actions in LabRPS. You simply record actions as you do them, then save those actions under a name, and replay them whenever you want. Since macros are in reality a list of Python commands, you can also edit them, and create very complex scripts. While Python scripts normally have the {{..."

2024-07-27T08:58:40Z

Created page with "{{Docnav |Scripting and macros |Scripts }} {{TOCright}} == Introduction == Macros are a convenient way to reproduce complex actions in LabRPS. You simply record actions as you do them, then save those actions under a name, and replay them whenever you want. Since macros are in reality a list of Python commands, you can also edit them, and create very complex scripts. While Python scripts normally have the {{..."

New page

{{Docnav
|[[Scripting_and_macros|Scripting and macros]]
|[[Scripts|Scripts]]
}}

{{TOCright}}

== Introduction ==

[[Macros|Macros]] are a convenient way to reproduce complex actions in LabRPS. You simply record actions as you do them, then save those actions under a name, and replay them whenever you want. Since macros are in reality a list of [[Python|Python]] commands, you can also edit them, and create very complex scripts.

While Python scripts normally have the {{incode|.py}} extension, LabRPS macros should have the {{incode|.FCMacro}} extension. A collection of macros written by experienced users is found in the [[Macros_recipes|macros recipes]] page.

See the [[Power_users_hub|Power users hub]] to learn more about the [[Python|Python]] programming language, and about writing macros. In particular, you should start with these pages:
* [[Introduction_to_Python|Introduction to Python]]
* [[Python_scripting_tutorial|Python scripting tutorial]]
* [[LabRPS_Scripting_Basics|LabRPS Scripting Basics]]

== How it works ==

Enable the console output in the menu {{MenuCommand|Edit → Preferences → Python → Macro → Show scripts commands in python console}}. You will see that in LabRPS, 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.

It is very simple to use: Press the record button, you will be asked to give a name to your macro, then perform some actions. When you are done, click the stop recording button, and your actions will be saved. You can now access the macro dialog with the edit button.

[[Image:Macros.png]]
{{Caption|Macro dialog, listing the macros available in the system}}

There you can manage your macros, delete, edit, duplicate, install or create new ones from scratch. If you edit a macro, it will be opened in an editor window where you can make changes to its code. New macros can be installed using the {{button|Addons...}} button, which links to the [[Std_AddonMgr|Addon Manager]].

== Example ==

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

== Customizing ==

Of course it is not practical to load a macro in the editor in order to use it. LabRPS 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]]

This way you can make your macro become a real tool, just like any standard LabRPS tool. This, added to the power of python scripting within LabRPS, makes it possible to easily add your own tools to the interface.

See [[Customize_Toolbars|Customize Toolbars]] for a more detailed description.

== Creating macros without recording ==

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 LabRPS document. Next time you start LabRPS, the macro will appear under the "Installed Macros" item of the Macro menu.

See [[How_to_install_macros|How to install macros]] for a more detailed description.

== Macro repositories ==

There are two main places for macros. The first one is the official peer-reviewed macro repository on [https://github.com/LabRPS/LabRPS-macros GitHub]. The second one is the [[Macros_recipes|Macros recipes]] page from which you can pick some useful macros to add to your LabRPS installation. Macros from both repositories can be installed via the [[Std_AddonMgr|Addon Manager]] directly from LabRPS.

== Additional information ==

* [[Macro_at_Startup|Automatically run macro at startup]]
* [[Installing_more_workbenches|Installing more workbenches]]

== Tutorials ==

You can manually install extensions, however, it is much simpler to just use the [[Std_AddonMgr|Addon Manager]].
* [[How_to_install_macros|How to install macros]]
* [[How_to_install_additional_workbenches|How to install additional workbenches]]

{{Docnav
|[[Scripting_and_macros|Scripting and macros]]
|[[Scripts|Scripts]]
}}

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