Std DlgMacroRecord: Difference between revisions

From FreeCAD Documentation
mNo edit summary
mNo edit summary
Line 17: Line 17:


<!--T:4-->
<!--T:4-->
The Macro Record fucntion is accessible via several ways:
#The Macro Record function is accessible via several ways:
# The {{Button|[[Image:Std_DlgMacroRecord.svg|16px]] Macro recording}} button in the macro toolbar [[File:Macros_toolbar.jpg|96px]]
#* The {{Button|[[Image:Std_DlgMacroRecord.svg|16px]] Macro recording}} button in the macro toolbar [[File:Macros_toolbar.jpg|96px]]
# The menu {{MenuCommand|{{StdMenu|[[Std Macro Menu|Macro]]}} → Macro recording}},
#* The menu {{MenuCommand|{{StdMenu|[[Std Macro Menu|Macro]]}} → Macro recording}},
# '''Result:''' A dialog box will appear querying the user for the following information
#: [[Image:Menu_Std_DlgMacroRecord_it.png‎|Macro recording]]
:::* '''Macro name''': Enter the name of the new macro.
:::* '''Macro path''': Path macro library. To change the path, click {{Button| ... }}.
:::* {{KEY|Record}}: Record the macro (starts recording all actions in the [[3D view]]).
::::'''Note:''' The button {{Button|[[File:Std MacroStopRecord.svg|16px]] Stop macro recording session}} in the macros toolbar [[File:Macros_toolbar.jpg|96px]] will turn green [[File:Std MacroStopRecord.svg|16px]].
:::* {{Button|Stop}}: Stop recording the macro.
:::* {{Button|Cancel}}: Cancels and closes the window.


<!--T:6-->
<!--T:7-->
Once completed, click {{KEY|[[File:Std MacroStopRecord.svg|16px]] [[Std MacroStopRecord|Stop the macro recording session]]}} to stop recording the macro.
Start the function with one of these methods before. The following window appears:


<!--T:11-->
=== Executing the Macro=== <!--T:8-->
[[Image:Menu_Std_DlgMacroRecord_it.png‎|Macro recording]]

<!--T:12-->
* '''Macro name''': Enter the name of the new macro.
* '''Macro path''': Path macro library. To change the path, click {{Button| ... }}.
* {{KEY|Record}}: Record the macro. Starts recording of everything that is done later. The button {{Button|[[File:Std MacroStopRecord.svg|16px]] Stop the macro recording session}} in the macros toolbar [[File:Macros_toolbar.jpg|96px]] turn green [[File:Std MacroStopRecord.svg|16px]].
* {{Button|Stop}}: Stop recording the macro.
* {{Button|Cancel}}: Cancels and closes the window.

<!--T:7-->
Once completed click {{KEY|[[File:Std MacroStopRecord.svg|16px]] [[Std MacroStopRecord|Stop the macro recording session]]}} to stop recording the macro.


# The macro can be executed several ways:
<!--T:8-->
#* Through the {{MenuCommand|Macro → Macros...}} menu
The macro can be called through {{MenuCommand|Macro → Macros...}}, or with the {{Button|[[File:Std_DlgMacroExecuteDirect.svg|16px]] [[Std_DlgMacroExecuteDirect|Execute this macro]]}} button in the macro toolbar to be executed or modified as you want
#* Pressing the {{Button|[[File:Std_DlgMacroExecuteDirect.svg|16px]] [[Std_DlgMacroExecuteDirect|Execute this macro]]}} button in the macro toolbar
# Choose the macro
# Press {{Button|OK}}


==Example== <!--T:9-->
==Example== <!--T:9-->

Revision as of 21:33, 12 February 2020

Std DlgMacroRecord

Menu location
Macro → Macro recording...
Workbenches
All
Default shortcut
None
Introduced in version
-
See also
Execute macro

Description

The Start Macro recording function initiates a recording session of a macro. This means it will record all operation the user makes in the 3D view. Once the user is finished with the sequence of action, the Stop Macro Recording functions ends the macro recording session. This is a powerful technique to record repetitive sequences of actions (in to Python code that can be saved in a FreeCAD Macro file (.FCMacro)), that can be executed at a later time or even transferred to another computer running FreeCAD.

Usage

  1. The Macro Record function is accessible via several ways:
    • The Macro recording button in the macro toolbar
    • The menu Macro → Macro recording,
  2. Result: A dialog box will appear querying the user for the following information
    Macro recording
  • Macro name: Enter the name of the new macro.
  • Macro path: Path macro library. To change the path, click ... .
  • Record: Record the macro (starts recording all actions in the 3D view).
Note: The button Stop macro recording session in the macros toolbar will turn green .
  • Stop: Stop recording the macro.
  • Cancel: Cancels and closes the window.

Once completed, click Stop the macro recording session to stop recording the macro.

Executing the Macro

  1. The macro can be executed several ways:
    • Through the Macro → Macros... menu
    • Pressing the Execute this macro button in the macro toolbar
  2. Choose the macro
  3. Press OK

Example

Click the button enter a name for the macro and validate, open a document, create a cube, change the color stop the macro with the button .

The macro is available in your macros directory.