Automatización de tareas de diseño con scripts

Los scripts proporcionan un método potente para ampliar sus capacidades y productividad con Altium Designer. Un script contiene un conjunto de instrucciones (comandos automatizados) que se interpretan cuando se ejecuta en Altium Designer. Los scripts pueden escribirse en varios lenguajes, incluir cuadros de diálogo sofisticados y depurarse dentro de Altium Designer. Puede usar scripts para lograr sus objetivos de diseño con una intervención mínima del usuario y con menos pulsaciones de teclado y clics del mouse.

Con los scripts, puede automatizar tareas repetitivas y realizar ediciones que no están disponibles con los comandos existentes en Altium Designer. Por ejemplo, podría usar un script para buscar y actualizar marcas fiduciales en un documento PCB, o para exportar una netlist personalizada.

Los scripts pueden guardarse en un proyecto de scripts o en un proyecto de diseño. Hay varios lenguajes de script disponibles para escribir scripts en Altium Designer.

Descripción general y configuración del sistema de scripting

El sistema de scripting de Altium Designer proporciona todas las herramientas y funciones necesarias para crear scripts que automaticen tareas en el software.

Los scripts pueden escribirse para automatizar tareas repetitivas o mejorar una función en Altium Designer. El sistema de scripting se compone de dos partes principales: el editor y el depurador. El editor de scripts, el depurador y los paneles de scripting trabajan juntos para ayudarle a escribir y depurar sus scripts fácilmente. Un script puede ejecutarse directamente desde el editor de scripts o asignarse a un menú, una barra de herramientas o una tecla de acceso rápido, de modo que pueda aplicarse al documento actual, como un PCB, en cualquier momento.

► Lea sobre Sistema de scripting en Altium Designer

Creación y almacenamiento de scripts

Los scripts de Altium Designer normalmente se crean y almacenan en un proyecto de scripts (*.PrjScr), pero pueden agregarse o almacenarse en cualquier tipo de proyecto.

Para comenzar a escribir scripts, empiece creando un nuevo proyecto de scripts y agregando archivos de script a ese proyecto.

Un proyecto de scripts le ayuda a administrar sus scripts y puede crearse seleccionando File » New » Project » Script Project en los menús principales. Un nuevo proyecto aparecerá en el panel Projects. Para agregar un nuevo script al proyecto, haga clic con el botón derecho en el nombre del proyecto y seleccione Add New to Project en el menú contextual.

Al crear un nuevo script, hay dos tipos de scripts para elegir según los requisitos de su proyecto: unidades de script y formularios de script. Las unidades de script le permiten escribir procedimientos y funciones independientes. Los formularios de script le permiten crear cuadros de diálogo con controles y controladores de eventos, además de procedimientos y funciones.

► Lea sobre Creación y almacenamiento de scripts en Altium Designer

Escritura de scripts

Hay una serie de conceptos y términos esenciales que se aplican a la escritura de scripts:

• Los procesos son cadenas de comandos que puede usar para ejecutar comandos en scripts.

• Los componentes son objetos de control visual en el panel Tool Palette que puede arrastrar y soltar en un formulario de script para manipular el diseño.

• Un componente que se coloca en un formulario de script tiene métodos, propiedades y eventos.

• Las interfaces de objetos son interfaces de objetos especiales que puede usar para extraer y modificar datos en documentos de diseño desde sus scripts.

El lenguaje de scripting predeterminado está configurado como DelphiScript (*.pas). El motor de scripting en sí está escrito en Embarcadero Delphi, y el panel Tool Palette se basa en la VCL (Visual Component Library) de Delphi.

► Lea sobre Escritura de scripts en Altium Designer

Herramientas de edición y depuración de scripts

El sistema de scripting de Altium Designer se compone de dos partes principales: el editor y el depurador. El editor ofrece una variedad de funciones de ayuda e inspección para código de script, y el depurador proporciona acceso a componentes de script y funciones de depuración. Las herramientas del editor de scripting son un recurso clave al depurar scripts.

Hay una gama de herramientas en el sistema de scripting que ayudan en la depuración de scripts. Estas incluyen la aplicación de múltiples puntos de interrupción en un script, el uso del panel Watch List para supervisar el valor de las variables, el uso de marcadores para desplazarse con mayor eficiencia y el uso de las funciones step into y step over para rastrear scripts.

► Lea sobre Herramientas de edición de scripts en Altium Designer

► Lea sobre Depuración de scripts en Altium Designer

Ejecución de scripts

Aunque el sistema de scripting de Altium Designer proporciona los medios para crear tareas automatizadas sofisticadas para Altium Designer, los scripts resultantes también deben ser de fácil acceso durante el proceso de diseño. Por ejemplo, un script creado para realizar un conjunto complejo de operaciones mientras se edita un PCB debería estar disponible directamente en el propio editor de PCB, donde pueda ejecutarse con uno o dos clics del mouse.

Altium Designer proporciona esto permitiendo que un script se asigne a un iniciador de procesos y, por lo tanto, a un comando que puede asignarse a un menú, una barra de herramientas y un acceso directo.

Un script puede ejecutarse usando el comando Run del editor cuando está abierto en el editor de scripts. Esto requiere que el proyecto de scripts esté abierto en Altium Designer, lo cual no es un enfoque conveniente para acceder a un script necesario durante el proceso de diseño de PCB, por ejemplo. Como alternativa, el cuadro de diálogo Select Item To Run (File » Run Script) le permite buscar un script en su disco duro local o en un Workspace conectado y luego ejecutar el proceso deseado. El script permanece cargado durante la sesión actual.

Un método más adecuado para acceder a un script de uso frecuente es instalar el proyecto como un Proyecto global desde la página Scripting System – Global Projects del cuadro de diálogo Preferences. En este caso, el proyecto se carga automáticamente cuando se inicia Altium Designer y puede ejecutarse en cualquier momento mediante el comando File » Run Script.

► Lea sobre Ejecución de scripts en Altium Designer

Componentes gráficos de scripting

Los componentes visuales de formulario disponibles para usar en scripts de Altium Designer derivan en su mayoría de la Visual Component Library (VCL) de Embarcadero, que es una colección de componentes visuales definidos para desarrollar aplicaciones de Windows utilizando los lenguajes Delphi y C++.

Desarrolladas como una biblioteca visual de clases, las clases VCL descienden del objeto TComponent (que a su vez desciende del objeto raíz TObject) en una jerarquía lineal de objetos. Por lo tanto, un componente de script común, como el objeto TButton, hereda las propiedades, métodos y eventos de sus objetos ascendentes. En este caso, la jerarquía de clases es: TObject → TPersistent → TComponent → TControl → TWinControl → TButtonControl → TButton.

Tenga en cuenta que los componentes que descienden del objeto TControl son generalmente componentes visuales (controles), y los componentes comunes que descienden de TWinControl son en su mayoría encapsuladores de la API de Windows.

Al crear un formulario en el editor de scripts de Altium Designer, se accede a los componentes desde el panel Tool Palette. Los formularios de script tienen un archivo *.DFM asociado, que incluye detalles de la configuración del formulario, las ubicaciones de sus componentes y otros atributos; el archivo se encuentra en la carpeta host del proyecto de scripts. Altium Designer permite que los componentes se usen con DelphiScript o VBScript al diseñar formularios de script.

► Lea sobre Componentes gráficos de scripting en Altium Designer

Ejemplos de scripts

Para ofrecer una mayor comprensión de los aspectos generales del sistema de scripting y del uso de los modelos de objetos Delphi y X2 en scripts, se examinan dos proyectos de ejemplo desde una perspectiva funcional: un copiador del contorno de la placa y un script generador de netlists. Los scripts Board Outline Copier y Netlister se desarrollan utilizando los modelos de objetos X2 para ilustrar las capacidades del sistema de scripting en Altium Designer.

Estos son scripts existentes disponibles en la colección de scripts de ejemplo. La carpeta Scripts dentro del archivo ZIP contiene subcarpetas organizadas según los lenguajes de scripting.

Tenga en cuenta que puede encontrar una amplia variedad de scripts útiles en la colección de GitHub de Altium Designer.

► Lea sobre Análisis de ejemplos de scripts en Altium Designer

► Lea sobre Referencia de ejemplos de scripting para Altium Designer

Compatibilidad con lenguajes de scripting

Los scripts para Altium Designer pueden escribirse en varios lenguajes de script. Tenga en cuenta que el lenguaje principal y el más mencionado en la documentación de scripting es DelphiScript, que está estrechamente relacionado con Embarcadero Delphi™.

► Lea sobre Compatibilidad con lenguajes de scripting en Altium Designer