Macros/es: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
(28 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

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


{{TOCright}}
{{TOCright}}
Line 7: Line 12:
[[Macros/es|Macros]] son una forma conveniente de reproducir acciones complejas en FreeCAD. Simplemente grabas las acciones mientras las realizas, luego guardas esas acciones con un nombre, y las reproduces cuando quieras. Como las macros son en realidad una lista de comandos [[Python/es|Python]], también puedes editarlas, y crear scripts muy complejos.
[[Macros/es|Macros]] son una forma conveniente de reproducir acciones complejas en FreeCAD. Simplemente grabas las acciones mientras las realizas, luego guardas esas acciones con un nombre, y las reproduces cuando quieras. Como las macros son en realidad una lista de comandos [[Python/es|Python]], también puedes editarlas, y crear scripts muy complejos.


<div class="mw-translate-fuzzy">
While Python scripts normally have the {{incode|.py}} extension, FreeCAD macros should have the {{incode|.FCMacro}} extension. A collection of macros written by experienced users is found in the [[macros recipes|macros recipes]] page.
Mientras que los scripts de Python normalmente tienen la extensión {{incode|.py}}, las macros de FreeCAD deben tener la extensión {{incode|.FCMacro}}. Una colección de macros escritas por usuarios experimentados se encuentra en la página [[macros recipes/es|recipes macros]].
</div>


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:
Vea el [[Power_users_hub/es|Centro de usuarios avanzados]] para aprender más sobre el lenguaje de programación [[Python/es|Python]], y sobre la escritura de macros. En particular, deberías empezar con estas páginas:
* [[Introduction_to_Python|Introduction to Python]]
* [[Introduction_to_Python/es|Introducción a Python]]
* [[Python_scripting_tutorial|Python scripting tutorial]]
* [[Python_scripting_tutorial/es|Tutorial de Guión en Python]]
* [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]]
* [[FreeCAD_Scripting_Basics/es|Fundamentos de Guión en FreeCAD]]


== ¿Cómo funciona? ==
<div class="mw-translate-fuzzy">
=== ¿Cómo funciona? ===


Si habilitas la salida en consola (Menú Editar -> Preferencias -> Macro -> Mostrar comandos de archivos de guión en la consola de Python), verás que en FreeCAD, cada acción que hacemos, como presionar un botón, da como salida un comando Python. Esos comandos son lo que se pueden grabar en una macro. La principal herramienta para la grabación de las macros es la barra de herramientas de macros: [[Image: Macros_toolbar.jpg]]. En ella tienes 4 botones: Grabar, detener la grabación, editar y reproducir la macro actual.
Activa la salida de la consola en el menú {{MenuCommand|Edición Preferencias → General → Macro Mostrar comandos de scripts en la consola de python}}. Verás que en FreeCAD, cada acción que realizas, como pulsar un botón, da salida a un comando de Python. Esos comandos son los que se pueden grabar en una macro. La herramienta principal para hacer macros es la barra de herramientas de macros: [[Image:Macros_toolbar.jpg]]. En ella tienes 4 botones: Grabar, detener la grabación, editar y reproducir la macro actual.
</div>


Su uso es muy sencillo: Pulsa el botón de grabar, se te pedirá que des un nombre a tu macro, y luego realiza algunas acciones. Cuando hayas terminado, pulsa el botón de parar la grabación, y tus acciones se guardarán. Ahora puedes acceder al diálogo de la macro con el botón de edición.
Enable the console output in the menu {{MenuCommand|Edit → Preferences → General → Macro → Show scripts commands in python console}}. You will see that in FreeCAD, 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.

[[Image:Macros.png]]
{{Caption|Diálogo de macros, que enumera las macros disponibles en el sistema}}


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Allí puedes gestionar tus macros, borrarlas, editarlas, duplicarlas, instalarlas o crear otras nuevas desde cero. Si editas una macro, se abrirá en una ventana del editor donde puedes hacer cambios en su código. Se pueden instalar nuevas macros utilizando el botón {{button|Complementos...}}, que enlaza con el [[Std_AddonMgr/es|Gestor Complementos]].
Es muy sencillo de utilizar: Presiona el botón de grabación, se pedirá que le asignes un nombre a tu macro, a continuación, realizar algunas acciones. Cuando termines, haz clic en el botón Detener grabación, y tus acciones se guardarán. Ahora puedes acceder al letrero de diálogo de macro con el botón de edición:
</div>
</div>


== Ejemplo ==
<div class="mw-translate-fuzzy">
[[Image:Macros.jpg]]
</div>


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Pulsa el botón de grabar, dale un nombre, digamos "cilindro de 10x10, entonces, en el [[Part_Workbench/es|Entorno de Pieza]], crea un cilindro con radio = 10 y altura = 10. A continuación, pulsa el botón "Detener la sesión de grabación de la macro". En el letrero de diálogo de edición macros, puedes ver el código Python que se ha registrado, y, si lo deseas, realizar modificaciones en él. Para ejecutar la macro, basta con pulsar el botón de ejecutar en la barra de herramientas mientras la macro se encuentra en el editor. Tu macro siempre se guarda en el disco, por lo que cualquier cambio que hagas, o cualquier macro nueva que crees, siempre estará disponible la próxima vez que inicies FreeCAD.
Allí puedes manejar tus macros, eliminar, editar o crear otras nuevas desde cero. Si editas una macro, esta se abrirá en una ventana del editor donde se pueden realizar cambios en su código.
</div>
</div>


== Personalización ==
<div class="mw-translate-fuzzy">
=== Ejemplo ===


Por supuesto que no es práctico cargar una macro en el editor con el fin de usarla. FreeCAD proporciona formas mucho mejores de iniciar la macro, como la asignación de un atajo de teclado, o poner una entrada en el menú. Una vez que la macro se crea, todo esto se puede hacer a través de menú {{MenuCommand| Herramientas Personalizar}}.
Pulsa el botón de grabar, dale un nombre, digamos "cilindro de 10x10, entonces, en el [[Part Module/es|Entorno de Pieza]], crea un cilindro con radio = 10 y altura = 10. A continuación, pulsa el botón "Detener la sesión de grabación de la macro". En el letrero de diálogo de edición macros, puedes ver el código Python que se ha registrado, y, si lo deseas, realizar modificaciones en él. Para ejecutar la macro, basta con pulsar el botón de ejecutar en la barra de herramientas mientras la macro se encuentra en el editor. Tu macro siempre se guarda en el disco, por lo que cualquier cambio que hagas, o cualquier macro nueva que crees, siempre estará disponible la próxima vez que inicies FreeCAD.
</div>


[[Image:Macros config.jpg]]
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 FreeCAD.


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
De esta manera puedes hacer que tu macro se convierta en una herramienta real, como cualquier herramienta estándar de FreeCAD. Esto, sumado a la potencia de los scripts de Python dentro de FreeCAD, hace posible añadir fácilmente tus propias herramientas a la interfaz. Sigue leyendo la página [[Scripting/es|Guión]] si quieres saber más sobre [[Python/es|Python]] scripting.
=== Personalización ===

Por supuesto que no es práctico cargar una macro en el editor con el fin de usarla. FreeCAD proporciona formas mucho mejores de iniciar la macro, como la asignación de un atajo de teclado, o poner una entrada en el menú. Una vez que la macro se crea, todo esto se puede hacer a través de menú -> Herramientas -> Personalizar:
</div>
</div>


Ver [[Customize_Toolbars/es|Personalizar barras de herramientas]] para una descripción más detallada.
Of course it is not practical to load a macro in the editor in order to use it. FreeCAD 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.


== Creación de macros sin grabar ==
[[Image:Macros config.jpg]]

También puedes copiar/pegar directamente código python en una macro, sin grabar acciones de la interfaz gráfica de usuario. Basta con crear una nueva macro, editarla, y pegar el código. A continuación, puedes guardar la macro del mismo modo que se guarda un documento de FreeCAD. La próxima vez que se inicie FreeCAD, la macro aparecerá bajo el apartado "Macros instaladas" del menú Macro.


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Ver [[How to install macros/es|Cómo instalar las macros]] para obtener una descripción más detallada.
Así puedes hacer que tu macro se convierta en una auténtica herramienta, al igual que cualquier herramienta estándar de FreeCAD. Esto, sumado a la potencia de Python en FreeCAD, permite añadir fácilmente tus propias herramientas a la interfaz. Sigue leyendo en la página del [[Power users hub/es|Centro de usuarios avanzados]] si quieres saber más sobre los archivos de guión en lenguaje Python ...
</div>
</div>

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


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
=== Creación de macros sin grabar ===
== Repositorio de Macros ==

También puedes copiar/pegar directamente código python en una macro, sin grabar acciones de la interfaz gráfica de usuario. Basta con crear una nueva macro, editarla, y pegar el código. A continuación, puedes guardar la macro del mismo modo que se guarda un documento de FreeCAD. La próxima vez que se inicie FreeCAD, la macro aparecerá bajo el apartado "Macros instaladas" del menú Macro.
</div>
</div>

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 FreeCAD document. Next time you start FreeCAD, 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.


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
=== Repositorio de Macros ===

Visita la página [[Macros recipes/es|Recetas de macros]] para recoger algunas macros útiles para añadir a tu instalación de FreeCAD.
Visita la página [[Macros recipes/es|Recetas de macros]] para recoger algunas macros útiles para añadir a tu instalación de FreeCAD.
</div>
</div>


== Información adicional ==
Visit the [[Macros recipes|Macros recipes]] page to pick some useful macros to add to your FreeCAD installation.


* [[Macro_at_Startup/es|Ejecutar automáticamente la macro al inicio]]
== Additional information ==
* [[Installing_more_workbenches/es|Instalar más ambientes de trabajo]]


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


<div class="mw-translate-fuzzy">
== Tutorials ==
Puede instalar manualmente las extensiones, sin embargo, es mucho más sencillo utilizar el [[Std_AddonMgr/es|Gestor Complementos]].
* [[How to install macros/es|Cómo instalar macros]]
* [[How_to_install_additional_workbenches/es|Cómo instalar ambientes de trabajo adicionales]]
</div>


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]]


<div class="mw-translate-fuzzy">
{{docnav/es|Standard Menu/es|Introduction to Python/es}}
</div>


{{Powerdocnavi{{#translation:}}}}
{{Powerdocnavi{{#translation:}}}}
Line 92: Line 90:
[[Category:Python Code{{#translation:}}]]
[[Category:Python Code{{#translation:}}]]
[[Category:Macros{{#translation:}}]]
[[Category:Macros{{#translation:}}]]
{{clear}}

Revision as of 18:35, 3 November 2021

Introducción

Macros son una forma conveniente de reproducir acciones complejas en FreeCAD. Simplemente grabas las acciones mientras las realizas, luego guardas esas acciones con un nombre, y las reproduces cuando quieras. Como las macros son en realidad una lista de comandos Python, también puedes editarlas, y crear scripts muy complejos.

Mientras que los scripts de Python normalmente tienen la extensión .py, las macros de FreeCAD deben tener la extensión .FCMacro. Una colección de macros escritas por usuarios experimentados se encuentra en la página recipes macros.

Vea el Centro de usuarios avanzados para aprender más sobre el lenguaje de programación Python, y sobre la escritura de macros. En particular, deberías empezar con estas páginas:

¿Cómo funciona?

Activa la salida de la consola en el menú Edición → Preferencias → General → Macro → Mostrar comandos de scripts en la consola de python. Verás que en FreeCAD, cada acción que realizas, como pulsar un botón, da salida a un comando de Python. Esos comandos son los que se pueden grabar en una macro. La herramienta principal para hacer macros es la barra de herramientas de macros: . En ella tienes 4 botones: Grabar, detener la grabación, editar y reproducir la macro actual.

Su uso es muy sencillo: Pulsa el botón de grabar, se te pedirá que des un nombre a tu macro, y luego realiza algunas acciones. Cuando hayas terminado, pulsa el botón de parar la grabación, y tus acciones se guardarán. Ahora puedes acceder al diálogo de la macro con el botón de edición.

Diálogo de macros, que enumera las macros disponibles en el sistema

Allí puedes gestionar tus macros, borrarlas, editarlas, duplicarlas, instalarlas o crear otras nuevas desde cero. Si editas una macro, se abrirá en una ventana del editor donde puedes hacer cambios en su código. Se pueden instalar nuevas macros utilizando el botón Complementos..., que enlaza con el Gestor Complementos.

Ejemplo

Pulsa el botón de grabar, dale un nombre, digamos "cilindro de 10x10, entonces, en el Entorno de Pieza, crea un cilindro con radio = 10 y altura = 10. A continuación, pulsa el botón "Detener la sesión de grabación de la macro". En el letrero de diálogo de edición macros, puedes ver el código Python que se ha registrado, y, si lo deseas, realizar modificaciones en él. Para ejecutar la macro, basta con pulsar el botón de ejecutar en la barra de herramientas mientras la macro se encuentra en el editor. Tu macro siempre se guarda en el disco, por lo que cualquier cambio que hagas, o cualquier macro nueva que crees, siempre estará disponible la próxima vez que inicies FreeCAD.

Personalización

Por supuesto que no es práctico cargar una macro en el editor con el fin de usarla. FreeCAD proporciona formas mucho mejores de iniciar la macro, como la asignación de un atajo de teclado, o poner una entrada en el menú. Una vez que la macro se crea, todo esto se puede hacer a través de menú Herramientas → Personalizar.

De esta manera puedes hacer que tu macro se convierta en una herramienta real, como cualquier herramienta estándar de FreeCAD. Esto, sumado a la potencia de los scripts de Python dentro de FreeCAD, hace posible añadir fácilmente tus propias herramientas a la interfaz. Sigue leyendo la página Guión si quieres saber más sobre Python scripting.

Ver Personalizar barras de herramientas para una descripción más detallada.

Creación de macros sin grabar

También puedes copiar/pegar directamente código python en una macro, sin grabar acciones de la interfaz gráfica de usuario. Basta con crear una nueva macro, editarla, y pegar el código. A continuación, puedes guardar la macro del mismo modo que se guarda un documento de FreeCAD. La próxima vez que se inicie FreeCAD, la macro aparecerá bajo el apartado "Macros instaladas" del menú Macro.

Ver Cómo instalar las macros para obtener una descripción más detallada.

Repositorio de Macros

Visita la página Recetas de macros para recoger algunas macros útiles para añadir a tu instalación de FreeCAD.

Información adicional

Tutoriales

Puede instalar manualmente las extensiones, sin embargo, es mucho más sencillo utilizar el Gestor Complementos.


Standard Menu/es
Introduction to Python/es