Macros/es: Difference between revisions

Latest revision as of 10:54, 9 August 2023

Other languages:

Scripting and macros

Scripts

Index

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

Indice

Power user documentation

FreeCAD scripting: Python, Introduction to Python, Python scripting tutorial, FreeCAD Scripting Basics

Modules: Builtin modules, Units, Quantity
Workbenches: Workbench creation, Gui Commands, Commands, Installing more workbenches
Meshes and Parts: Mesh Scripting, Topological data scripting, Mesh to Part, PythonOCC

Parametric objects: Scripted objects, Viewproviders (Custom icon in tree view)
Scenegraph: Coin (Inventor) scenegraph, Pivy
Graphical interface: Interface creation, Interface creation completely in Python (1, 2, 3, 4, 5), PySide, PySide examples beginner, intermediate, advanced
Macros: Macros, How to install macros
Embedding: Embedding FreeCAD, Embedding FreeCADGui

Other: Expressions, Code snippets, Line drawing function, FreeCAD vector math library (deprecated)

Hubs: User hub, Power users hub, Developer hub

@@ Line 1: / Line 1: @@
+<languages/>
-Las macros son una forma cómoda de crear acciones complejas en FreeCAD. Usted simplemente graba las acciones a medida que las hace, a continuación, lo guarda con un nombre, y las podrá reproducir siempre que lo desee. Dado que las macros son en realidad una lista de comandos de Python, también puede editar y crear ''guiones'' (scrips) o secuencias de comandos muy complejos.
+{{Docnav
-===  ¿Cómo funciona? ===
+|[[Scripting_and_macros|Scripting and macros]]
+|[[Scripts|Scripts]]
+}}
+{{TOCright}}
-Si habilita la salida en consola (Menú Edición -> Preferencias -> General -> Macros -> Mostrar comandos de scripts en la consola de Python), verá 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 puede 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 tiene 4 botones: Grabar, detener la grabación, editar y reproducir la macro actual.
+<span id="Introduction"></span>
+== Introducción ==
+[[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.
-Es muy sencillo de utilizar: Presione el botón de grabación, se le pedirá que asigne un nombre a su macro, a continuación, realizar algunas acciones. Cuando termine, haga clic en el botón Detener grabación, y sus acciones serán salvados. Ahora puede acceder al diálogo de macro con el botón de edición:
+<div class="mw-translate-fuzzy">
-[[Image:Macros.jpg]]
+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>
+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:
-Allí puede usted  manejar sus macros, eliminar, editar o crear otros nuevos desde cero. Si edita una macro, esta se abrirá en una ventana del editor donde se pueden realizar cambios en su código.
+* [[Introduction_to_Python/es|Introducción a Python]]
+* [[Python_scripting_tutorial/es|Tutorial de Guión en Python]]
+* [[FreeCAD_Scripting_Basics/es|Fundamentos de Guión en FreeCAD]]
+<span id="How_it_works"></span>
-=== Ejemplo ===
+==  ¿Cómo funciona? ==
+<div class="mw-translate-fuzzy">
-Pulse el botón de grabar, dele un nombre, digamos "cilindro de 10x10, entonces, en el [[Part Workbench]], cree un cilindro con radio = 10 y altura = 10. A continuación, pulse el botón "stop grabación". En la edición macros de diálogo, puede ver el código Python que se ha registrado, y, si lo desea, 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. Su macro siempre se guarda en el disco, por lo que cualquier cambio que haga, o cualquier macro nueva que cree, siempre estará disponible la próxima vez que inicie FreeCAD.
+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.
+[[Image:Macros.png]]
-=== Personalización  ===
+{{Caption|Diálogo de macros, que enumera las macros disponibles en el sistema}}
+<div class="mw-translate-fuzzy">
-Por supuesto que no es práctico cargar una macro en el editor con el fin de usarla. FreeCAD proporciona formas mucho mejores de arrancar 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:
+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]].
+</div>
+<span id="Example"></span>
+== Ejemplo ==
+<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.
+</div>
+<span id="Customizing"></span>
+== 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ú  {{MenuCommand| Herramientas →  Personalizar}}.
 [[Image:Macros config.jpg]]
+<div class="mw-translate-fuzzy">
-Así puede hacer que su macro se convierta en una auténtica herramienta, al igual que cualquier herramienta estándar FreeCAD. Esto, sumado a la potencia de Python en FreeCAD, permite añadir fácilmente sus propias herramientas a la interfaz. Sigue leyendo en la página [[Scripting]] si quieres saber más sobre los guiones en lenguaje Python ...
+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.
+</div>
+Ver [[Customize_Toolbars/es|Personalizar barras de herramientas]] para una descripción más detallada.
+<span id="Creating_macros_without_recording"></span>
+== 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.
+<div class="mw-translate-fuzzy">
+Ver [[How to install macros/es|Cómo instalar las macros]] para obtener una descripción más detallada.
+</div>
+<span id="Macro_repositories"></span>
+<div class="mw-translate-fuzzy">
+== Repositorio de Macros ==
+</div>
+<div class="mw-translate-fuzzy">
-=== Creación de macros sin grabar ===
+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>
+<span id="Additional_information"></span>
-Usted también puede copiar/pegar directamente código python en una macro, sin grabar acciones del GUI. Basta con crear una nueva macro, editarla, y pegar el código. A continuación, puede guardar la macro del mismo modo que se guarda un documento FreeCAD. La próxima vez que comience FreeCAD, la macro aparecerá bajo el apartado "Macros instalados" del menú Macro.
+== Información adicional ==
+* [[Macro_at_Startup/es|Ejecutar automáticamente la macro al inicio]]
-=== repositorio de Macros ===
+* [[Installing_more_workbenches/es|Instalar más ambientes de trabajo]]
+<span id="Tutorials"></span>
-Visite la página [[Macros recipes]] para recoger algunas macros útiles para añadir a su instalación FreeCAD.
+== Tutoriales ==
+<div class="mw-translate-fuzzy">
+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>
+<div class="mw-translate-fuzzy">
-{{docnav/es|Image Module/es|Introduction to python/es}}
+{{docnav/es|Standard Menu/es|Introduction to Python/es}}
+</div>
+{{Powerdocnavi{{#translation:}}}}
-[[Category:Poweruser Documentation]]
+[[Category:Developer Documentation{{#translation:}}]]
+[[Category:Python Code{{#translation:}}]]
+[[Category:Macros{{#translation:}}]]