Std DlgMacroRecord: Difference between revisions

From FreeCAD Documentation
m (Std MacroStopRecord.svg)
No edit summary
(38 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>

<!--T:17-->
{{Docnav
|
|[[Std_MacroStopRecord|MacroStopRecord]]
|[[Std_Macro_Menu|Std Macro Menu]]
|
|IconR=Std_MacroStopRecord.svg
|IconC=Freecad.svg
}}

<!--T:1-->
<!--T:1-->
{{GuiCommand
{{GuiCommand
|Name=Std DlgMacroRecord
|Name=Std DlgMacroRecord
|MenuLocation=[[Macros|Macro]] → Macro recording ...
|MenuLocation=Macro → Macro recording...
|Workbenches=All
|Workbenches=All
|SeeAlso=[[Std_DlgMacroExecuteDirect|Execute macro]]
|SeeAlso=[[Std_MacroStopRecord|Std MacroStopRecord]]
}}
}}


== Description == <!--T:2-->
==Description== <!--T:2-->


<!--T:3-->
<!--T:3-->
The '''Std DlgMacroRecord''' command starts a [[Macros|macro]] recording session during which user actions are stored in a FreeCAD macro, a file with the {{FileName|.FCMacro}} extension. A macro can later be replayed, executed, to repeat the recorded actions.
This function records a macro, all operations you made in 3D space.


</translate>
<!--T:4-->
[[Image:Std_DlgMacroRecord_dialog.png]]
It is accessible via {{MenuCommand|Macro → Macro recording}}, or via {{Button|[[File:Std DlgMacroRecord.png|16px]] Macro recording}} button in the macro toolbar [[File:Macros_toolbar.jpg|96px]].
<translate>
<!--T:18-->
{{Caption|The Macro recording dialog box}}


== Utilization == <!--T:5-->
==Usage== <!--T:5-->


<!--T:6-->
<!--T:4-->
# There are several ways to invoke the command:
Start the function with one of these methods before. The following window appears:
#* Press the {{Button|[[Image:Std_DlgMacroRecord.svg|16px]] [[Std_DlgMacroRecord|Std DlgMacroRecord]]}} button.
#* Select the {{MenuCommand|Macro → [[Image:Std_DlgMacroRecord.svg|16px]] Macro recording...}} option from the menu.
# The Macro recording dialog box opens.
# Enter a name for the macro in the '''Macro name''' input box.
# Optionally change the '''Macro path''' by pressing the {{Button|...}} button.
# The {{Button|Stop}} button does not work at this time.
# Press the {{Button|Record}} button to close the dialog box and start the recording session.
# Perform the actions you want to record.
# To end the recording session do one of the following:
#* Press the {{Button|[[Image:Std_MacroStopRecord.svg|16px]] [[Std_MacroStopRecord|Std MacroStopRecord]]}} button.
#* Select the {{MenuCommand|Macro → [[Image:Std_MacroStopRecord.svg|16px]] Stop macro recording}} option from the menu.


<!--T:11-->
==Options== <!--T:19-->
[[Image:Menu_Std_DlgMacroRecord_it.png‎|Macro recording]]


<!--T:12-->
<!--T:20-->
* When the Macro recording dialog box is displayed: press {{KEY|Esc}} or the {{Button|Cancel}} button to abort the command.
* '''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-->
==Notes== <!--T:21-->
Once completed click {{KEY|[[File:Std MacroStopRecord.svg|16px]] [[Std MacroStopRecord|Stop the macro recording session]]}} to stop recording the macro.


<!--T:8-->
<!--T:22-->
* To execute the recorded macro use the [[Std_DlgMacroExecute|Std DlgMacroExecute]] command.
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
* To learn more about macros see the [[Macros]] page.


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


<!--T:13-->
<!--T:24-->
* The macro path can also be changed in the preferences: {{MenuCommand|Edit → Preferences... → General → Macro → Macro path}}. See [[Preferences_Editor#Macro|Preferences Editor]].
Click the button [[File:Std DlgMacroRecord.png|16px]] enter a name for the macro and validate, open a document, create a cube, change the color stop the macro with the button [[File:Std MacroStopRecord.svg|16px]].
* In most cases it is undesirable to record actions that do not change the model: under {{MenuCommand|Edit → Preferences... → General → Macro → GUI commands}} do one of the following:
** To exclude these actions uncheck the {{CheckBox|FALSE|Record GUI commands}} checkbox.
** To include them as comments only check both the {{CheckBox|TRUE|Record GUI commands}} and {{CheckBox|TRUE|Record as comment}} checkboxes.


<!--T:10-->
<!--T:25-->
{{Docnav
The macro is available in your macros directory.
|

|[[Std_MacroStopRecord|MacroStopRecord]]
<!--T:14-->
|[[Std_Macro_Menu|Std Macro Menu]]
{{Std Base}}
|
{{Userdocnavi}}
|IconR=Std_MacroStopRecord.svg
|IconC=Freecad.svg
}}


</translate>
</translate>
{{Std Base navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}
{{clear}}

Revision as of 20:56, 22 December 2020

Std DlgMacroRecord

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

Description

The Std DlgMacroRecord command starts a macro recording session during which user actions are stored in a FreeCAD macro, a file with the .FCMacro extension. A macro can later be replayed, executed, to repeat the recorded actions.

The Macro recording dialog box

Usage

  1. There are several ways to invoke the command:
    • Press the Std DlgMacroRecord button.
    • Select the Macro → Macro recording... option from the menu.
  2. The Macro recording dialog box opens.
  3. Enter a name for the macro in the Macro name input box.
  4. Optionally change the Macro path by pressing the ... button.
  5. The Stop button does not work at this time.
  6. Press the Record button to close the dialog box and start the recording session.
  7. Perform the actions you want to record.
  8. To end the recording session do one of the following:
    • Press the Std MacroStopRecord button.
    • Select the Macro → Stop macro recording option from the menu.

Options

  • When the Macro recording dialog box is displayed: press Esc or the Cancel button to abort the command.

Notes

Preferences

  • The macro path can also be changed in the preferences: Edit → Preferences... → General → Macro → Macro path. See Preferences Editor.
  • In most cases it is undesirable to record actions that do not change the model: under Edit → Preferences... → General → Macro → GUI commands do one of the following:
    • To exclude these actions uncheck the Record GUI commands checkbox.
    • To include them as comments only check both the Record GUI commands and Record as comment checkboxes.