Std DlgMacroRecord: Difference between revisions
No edit summary |
(Usage) |
||
(19 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
<languages/> |
<languages/> |
||
{{Page in progress}} |
|||
<translate> |
<translate> |
||
<!--T:17--> |
|||
{{Docnav |
{{Docnav |
||
| |
| |
||
|[[Std_DlgMacroExecute|DlgMacroExecute]] |
|||
|[[Std_MacroStopRecord|Std MacroStopRecord]] |
|||
|[[Std_Macro_Menu|Std Macro Menu]] |
|[[Std_Macro_Menu|Std Macro Menu]] |
||
| |
| |
||
|IconR= |
|IconR=Std_DlgMacroExecute.svg |
||
|IconC=Freecad.svg |
|IconC=Freecad.svg |
||
}} |
}} |
||
<!--T:1--> |
|||
{{GuiCommand |
{{GuiCommand |
||
|Name=Std DlgMacroRecord |
|Name=Std DlgMacroRecord |
||
Line 21: | Line 20: | ||
}} |
}} |
||
==Description== |
==Description== <!--T:2--> |
||
<!--T:3--> |
|||
The '''Std DlgMacroRecord''' command starts a [[Macros|macro]] recording session during which |
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. |
||
</translate> |
|||
⚫ | |||
[[Image:Std_DlgMacroRecord_dialog.png]] |
|||
<translate> |
|||
<!--T:18--> |
|||
{{Caption|The Macro recording dialog box}} |
|||
⚫ | |||
<!--T:4--> |
|||
# There are several ways to invoke the command: |
# There are several ways to invoke the command: |
||
#* Press the {{Button|[[Image:Std_DlgMacroRecord.svg|16px]] [[Std_DlgMacroRecord|Std DlgMacroRecord]]}} button. |
#* Press the {{Button|[[Image:Std_DlgMacroRecord.svg|16px]] [[Std_DlgMacroRecord|Std DlgMacroRecord]]}} button. |
||
Line 35: | Line 42: | ||
# The {{Button|Stop}} button does not work at this time. |
# 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. |
# Press the {{Button|Record}} button to close the dialog box and start the recording session. |
||
# The button image of the command changes to {{Button|[[Image:Std_MacroStopRecord.svg|16px]]}} and the menu text changes to {{MenuCommand|Stop macro recording}}. |
|||
# Perform the actions you want to record. |
# Perform the actions you want to record. |
||
# To end the recording session do one of the following: |
# To end the recording session do one of the following: |
||
#* Press the {{Button|[[Image:Std_MacroStopRecord.svg|16px]] [[ |
#* Press the {{Button|[[Image:Std_MacroStopRecord.svg|16px]] [[Std_DlgMacroRecord|Std DlgMacroRecord]]}} button. |
||
#* Select the {{MenuCommand|Macro → [[Image:Std_MacroStopRecord.svg|16px]] Stop macro recording}} option from the menu. |
#* Select the {{MenuCommand|Macro → [[Image:Std_MacroStopRecord.svg|16px]] Stop macro recording}} option from the menu. |
||
==Options== |
==Options== <!--T:19--> |
||
<!--T:20--> |
|||
⚫ | |||
⚫ | |||
⚫ | |||
<!--T:22--> |
|||
⚫ | |||
* To execute the recorded macro use the [[Std_DlgMacroExecute|Std DlgMacroExecute]] command. |
|||
⚫ | |||
⚫ | |||
⚫ | |||
<!--T:24--> |
|||
⚫ | |||
⚫ | |||
* In most cases it is undesirable to record actions that do not change the model: under {{MenuCommand|Edit → Preferences... → Python → 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:25--> |
|||
{{Docnav |
{{Docnav |
||
| |
| |
||
|[[Std_DlgMacroExecute|DlgMacroExecute]] |
|||
|[[Std_MacroStopRecord|Std MacroStopRecord]] |
|||
|[[Std_Macro_Menu|Std Macro Menu]] |
|[[Std_Macro_Menu|Std Macro Menu]] |
||
| |
| |
||
|IconR= |
|IconR=Std_DlgMacroExecute.svg |
||
|IconC=Freecad.svg |
|IconC=Freecad.svg |
||
}} |
}} |
||
Line 64: | Line 81: | ||
{{Std Base navi{{#translation:}}}} |
{{Std Base navi{{#translation:}}}} |
||
{{Userdocnavi{{#translation:}}}} |
{{Userdocnavi{{#translation:}}}} |
||
{{clear}} |
Latest revision as of 08:11, 10 October 2023
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
- There are several ways to invoke the command:
- Press the Std DlgMacroRecord button.
- Select the Macro → 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.
- The Stop button does not work at this time.
- Press the Record button to close the dialog box and start the recording session.
- The button image of the command changes to and the menu text changes to Stop macro recording.
- Perform the actions you want to record.
- To end the recording session do one of the following:
- Press the Std DlgMacroRecord button.
- Select the Macro → Stop macro recording option from the menu.
Options
- When the Macro recording dialog box is displayed: press Esc or the Close button to abort the command.
Notes
- To execute the recorded macro use the Std DlgMacroExecute command.
- To learn more about macros see the Macros page.
Preferences
- The macro path can also be changed in the preferences: Edit → Preferences... → Python → Macro → Macro path. See Preferences Editor.
- In most cases it is undesirable to record actions that do not change the model: under Edit → Preferences... → Python → Macro → GUI commands do one of the following:
Std Base
- File: New, Open, Close, Close All, Save, Save As, Save a Copy, Save All, Revert, Import, Export,Merge project, Project information, Print, Print preview, Export PDF, Recent files, Exit
- Edit: Undo, Redo, Cut, Copy, Paste, Duplicate selection, Refresh, Box selection, Box element selection, Select All, Delete, Send to Python Console, Placement, Transform, Alignment, Toggle Edit mode, Edit mode, Preferences
- View:
- Miscellaneous: Create new view, Orthographic view, Perspective view, Fullscreen, Bounding box, Toggle axis cross, Clipping plane, Texture mapping, Toggle navigation/Edit mode, Appearance, Random color, Workbench, Status bar
- Standard views: Fit all, Fit selection, Isometric, Dimetric, Trimetric, Home, Front, Top, Right, Rear, Bottom, Left, Rotate Left, Rotate Right
- Freeze display: Save views, Load views, Freeze view, Clear views
- Draw style: As is, Points, Wireframe, Hidden line, No shading, Shaded, Flat lines
- Stereo: Stereo red/cyan, Stereo quad buffer, Stereo Interleaved Rows, Stereo Interleaved Columns, Stereo Off, Issue camera position
- Zoom: Zoom In, Zoom Out, Box zoom
- Document window: Docked, Undocked, Fullscreen
- Visibility: Toggle visibility, Show selection, Hide selection, Select visible objects, Toggle all objects, Show all objects, Hide all objects, Toggle selectability, Toggle measurement, Clear measurement
- Toolbars: File, Edit, Clipboard, Workbench, Macro, View, Structure, Help
- Panels: Tree view, Property view, Selection view, Tasks, Python console, DAG view, Model, Report view
- Link navigation: Go to linked object, Go to the deepest linked object, Select all links
- Tree view actions: Sync view, Sync selection, Sync placement, Pre-selection, Record selection, Single document, Multi document, Collapse/Expand, Initiate dragging, Go to selection, Selection Back, Selection Forward
- Tools: Edit parameters, Save image, Load image, Scene inspector, Dependency graph, Project utility, Measure distance, Add text document, View turntable, Units calculator, Customize, Addon manager
- Macro: Macro recording, Macros, Recent macros, Execute macro, Attach to remote debugger, Debug macro, Stop debugging, Step over, Step into, Toggle breakpoint
- Help: Help, FreeCAD Website, Donate, Users documentation, Python scripting documentation, Automatic Python modules documentation, FreeCAD Forum, FreeCAD FAQ, Report a bug, About FreeCAD, What's This
User documentation
- Getting started
- Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
- Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate
- Help: Tutorials, Video tutorials
- Workbenches: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework
- Hubs: User hub, Power users hub, Developer hub