Std DlgMacroRecord/ru: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
(8 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{UnfinishedDocu{{#translation:}}}} <!-- Needs English UI image -->
{{GuiCommand/ru|Name=Std DlgMacroRecord|Name/ru=Std DlgMacroRecord|MenuLocation=[[Macros/ru|Макрос]] → Запись макроса ...|Workbenches=All|SeeAlso=[[Std_DlgMacroExecuteDirect/ru|Выполнить макрос]]}}
<div class="mw-translate-fuzzy">
{{GuiCommand/ru
|Name=Std DlgMacroRecord
|Name/ru=Std DlgMacroRecord
|MenuLocation=[[Macros/ru|Макрос]] → Запись макроса ...
|Workbenches=All
|SeeAlso=[[Std_DlgMacroExecuteDirect/ru|Выполнить макрос]]
}}
</div>


== Description ==
== Description ==


The [[Image:Std_DlgMacroRecord.svg|16px]] Start Macro recording function initiates a recording session of a [[macros|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 [[File:Std MacroStopRecord.svg|16px]] [[Std MacroStopRecord|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 ({{incode|.FCMacro}})), that can be executed at a later time or even transferred to another computer running FreeCAD.
This function records a macro, all operations you made in 3D space.


== Usage ==
It is accessible via '''Macro → Macro recording ...''', or via {{KEY/it|[[File:Std DlgMacroRecord.png|16px]] Macro recording}} button in the macro toolbar [[File:Macros_toolbar.jpg|96px]].


#The Macro Record function is accessible via several ways:
== Utilization ==
#* 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}},
# '''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.
# Once completed, click {{KEY|[[File:Std MacroStopRecord.svg|16px]] [[Std MacroStopRecord|Stop the macro recording session]]}} to stop recording the macro.


=== Executing the Macro===
Start the function with one of these methods before. The following window appears:
{|
| [[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 {{KEY| ... }}.
* {{KEY|Record}} : Record the macro. Starts recording of everything that is done later.<br />The button {{KEY|[[File:Std_DlgMacroStop.png|16px]] Stop the macro recording session}} in the macros toolbar [[File:Macros_toolbar.jpg|96px]] turn green [[File:Std_DlgMacroStop_02.png|16px]].
* {{KEY|Stop}} : Stop recording the macro.
* {{KEY|Cancel}} : Cancels and closes the window.
|}


# The macro can be executed several ways:
#* Through the {{MenuCommand|Macro → Macros...}} menu
#* 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==
Once completed click {{KEY/it|[[File:Std_DlgMacroStop_02.png|16px]] [[Std DlgMacroStop|Stop the macro recording session]]}} to stop recording the macro.


# Press the [File:Std DlgMacroRecord.svg|16px]] button
The macro can be called through '''Macro → Macros...''', or with the {{KEY|[[File:Std_DlgMacroExecuteDirect.png|16px]] [[Std_DlgMacroExecuteDirect|Execute this macro]]}} button in the macro toolbar to be executed or modified as you want
# Enter a name for the macro and press {{Button|OK}}
# Open a document
# Create an [[Image:Part_Box.svg|24px]] [[Part Box|Cube]]
# Change the color of the box
# Press on [[File:Std MacroStopRecord.svg|16px]] to stop the macro recording


Result: The macro is available in your macros directory. [[#Executing the Macro|Execute]] the macro to recreate the steps you just recorded.
==Example==
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_DlgMacroStop_02.png|16px]].


{{Std Base{{#translation:}}}}
The macro is available in your macros directory.
{{Userdocnavi{{#translation:}}}}
{{clear}}
{{clear}}

Revision as of 20:53, 13 March 2020

Other languages:

This documentation is not finished. Please help and contribute documentation.

GuiCommand model explains how commands should be documented. Browse Category:UnfinishedDocu to see more incomplete pages like this one. See Category:Command Reference for all commands.

See WikiPages to learn about editing the wiki pages, and go to Help FreeCAD to learn about other ways in which you can contribute.

Std DlgMacroRecord

Системное название
Std DlgMacroRecord
Расположение в меню
Макрос → Запись макроса ...
Верстаки
All
Быстрые клавиши
Нет
Представлено в версии
-
См. также
Выполнить макрос

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

  1. Press the [File:Std DlgMacroRecord.svg|16px]] button
  2. Enter a name for the macro and press OK
  3. Open a document
  4. Create an Cube
  5. Change the color of the box
  6. Press on to stop the macro recording

Result: The macro is available in your macros directory. Execute the macro to recreate the steps you just recorded.