Automatizando tarefas de projeto com scripts

O scripting fornece um método poderoso para aumentar as suas capacidades e produtividade com o Altium Designer. Um script contém um conjunto de instruções (comandos automatizados) que são interpretadas quando é executado no Altium Designer. Os scripts podem ser escritos em várias linguagens, com caixas de diálogo sofisticadas, e depurados no Altium Designer. Pode utilizar scripts para atingir os seus objetivos de design com uma intervenção mínima do utilizador e menos pressões de teclas e cliques do rato.

Com scripts, pode automatizar tarefas repetitivas e efetuar edições que não estão disponíveis com os comandos existentes no Altium Designer. Por exemplo, pode utilizar um script para procurar e atualizar marcas fiduciais num documento PCB, ou para exportar uma netlist personalizada.

Os scripts podem ser guardados num projeto de scripts ou num projeto de design. Estão disponíveis várias linguagens de scripting para escrever scripts no Altium Designer.

Visão geral e configuração do sistema de scripting

O sistema de scripting do Altium Designer fornece todas as ferramentas e funcionalidades necessárias para criar scripts que automatizam tarefas no software.

Os scripts podem ser escritos para automatizar tarefas repetitivas ou melhorar uma funcionalidade no Altium Designer. O sistema de scripting é composto por duas partes principais: o editor e o depurador. O editor de scripts, o depurador e os painéis de scripting trabalham em conjunto para o ajudar a escrever e depurar os seus scripts com facilidade. Um script pode ser executado diretamente a partir do editor de scripts ou atribuído a um menu, barra de ferramentas ou tecla de atalho, para que possa ser aplicado ao documento atual – como, por exemplo, um PCB – em qualquer altura.

► Leia sobre Sistema de scripting no Altium Designer

Criar e armazenar scripts

Os scripts do Altium Designer são normalmente criados e armazenados num projeto de scripts (*.PrjScr), mas podem ser adicionados a ou armazenados em qualquer tipo de projeto.

Para começar a escrever scripts, comece por criar um novo projeto de scripts e adicionar ficheiros de script a esse projeto.

Um projeto de scripts ajuda-o a gerir os seus scripts, e pode ser criado selecionando File » New » Project » Script Project nos menus principais. Um novo projeto será listado no painel Projects. Para adicionar um novo script ao projeto, clique com o botão direito no nome do projeto e selecione Add New to Project no menu de contexto.

Ao criar um novo script, existem dois tipos de script à escolha, dependendo dos requisitos do seu projeto – unidades de script e formulários de script. As unidades de script permitem escrever procedimentos e funções autónomos. Os formulários de script permitem criar caixas de diálogo com controlos e processadores de eventos, bem como procedimentos e funções.

► Leia sobre Criar & armazenar scripts no Altium Designer

Escrever scripts

Existem vários conceitos e termos essenciais aplicáveis à escrita de scripts:

• Os processos são cadeias de comandos que pode utilizar para executar comandos em scripts.

• Os componentes são objetos de controlo visual no painel Tool Palette, que pode arrastar e largar para um formulário de script para manipular o design.

• Um componente colocado num formulário de script tem métodos, propriedades e eventos.

• As interfaces de objeto são interfaces de objeto especiais que pode utilizar para extrair e modificar dados em documentos de design a partir dos seus scripts.

A linguagem de scripting predefinida está definida para DelphiScript (*.pas). O próprio motor de scripting é escrito em Embarcadero Delphi, e o painel Tool Palette é baseado na VCL (Visual Component Library) do Delphi.

► Leia sobre Escrever scripts no Altium Designer

Ferramentas de edição e depuração de scripts

O sistema de scripting do Altium Designer é composto por duas partes principais – o editor e o depurador. O editor oferece um conjunto de funcionalidades de ajuda e inspeção de código de scripting, e o depurador fornece acesso a componentes de script e funcionalidades de depuração. As ferramentas do editor de scripting são um recurso fundamental ao depurar scripts.

Existe um conjunto de ferramentas no sistema de scripting para ajudar na depuração de scripts. Estas incluem a aplicação de múltiplos pontos de interrupção num script, a utilização do painel Watch List para monitorizar o valor das variáveis, o uso de marcadores para navegar com mais eficiência e a utilização das funcionalidades step into e step over para seguir a execução dos scripts.

► Leia sobre Ferramentas de edição de scripts no Altium Designer

► Leia sobre Depurar scripts no Altium Designer

Executar scripts

Embora o sistema de scripting do Altium Designer forneça os meios para criar tarefas automatizadas sofisticadas para o Altium Designer, os scripts resultantes também precisam de estar facilmente acessíveis durante o processo de design. Por exemplo, um script criado para executar um conjunto complexo de operações durante a edição de um PCB deverá estar prontamente disponível no próprio editor PCB, onde pode ser executado com um ou dois cliques do rato.

O Altium Designer permite isso ao possibilitar que um script seja atribuído a um iniciador de processo e, assim, a um comando que pode ser atribuído a um menu, barra de ferramentas e atalho.

Um script pode ser executado utilizando o comando Run do editor quando está aberto no editor de scripts. Isto requer que o projeto de scripts esteja aberto no Altium Designer, o que não é uma abordagem conveniente para aceder a um script necessário durante o processo de design de PCB, por exemplo. Em alternativa, a caixa de diálogo Select Item To Run (File » Run Script) permite-lhe navegar até um script no seu disco rígido local ou numa Workspace ligada e depois executar o processo pretendido. O script permanece carregado durante a sessão atual.

Um método mais adequado para aceder a um script utilizado com frequência é instalar o projeto como Global Project a partir da página Scripting System – Global Projects da caixa de diálogo Preferences. Neste caso, o projeto é carregado automaticamente quando o Altium Designer é iniciado e pode ser executado em qualquer altura através do comando File » Run Script.

► Leia sobre Executar scripts no Altium Designer

Componentes gráficos de scripting

Os componentes visuais de formulário disponíveis para utilização em scripts do Altium Designer derivam maioritariamente da Visual Component Library (VCL) da Embarcadero, que é uma coleção de componentes visuais definidos para desenvolver aplicações Windows utilizando as linguagens Delphi e C++.

Desenvolvidas como uma biblioteca visual de classes, as classes VCL descendem do objeto TComponent (ele próprio descendente do objeto raiz TObject) numa hierarquia linear de objetos. Assim, um componente de script comum, como o objeto TButton, herda as propriedades, métodos e eventos dos seus objetos ascendentes. Neste caso, a hierarquia de classes é: TObject → TPersistent → TComponent → TControl → TWinControl → TButtonControl → TButton.

Note que os componentes que descendem do objeto TControl são geralmente componentes visuais (controlos), e os componentes comuns que descendem de TWinControl são maioritariamente wrappers da API do Windows.

Ao criar um formulário no editor de scripts do Altium Designer, os componentes são acedidos a partir do painel Tool Palette. Os formulários de script têm um ficheiro *.DFM associado, que inclui detalhes da configuração do formulário, das localizações dos seus componentes e de outros atributos; o ficheiro encontra-se na pasta anfitriã do projeto de scripts. O Altium Designer permite que os componentes sejam utilizados tanto por DelphiScript como por VBScript ao criar formulários de script.

► Leia sobre Componentes gráficos de scripting no Altium Designer

Exemplos de scripts

Para fornecer uma visão mais aprofundada dos aspetos gerais do sistema de scripting, e da utilização dos modelos de objetos Delphi e X2 em scripts, são analisados dois projetos de exemplo numa perspetiva funcional – um copiador de contorno de placa e um script gerador de netlist. Os scripts Board Outline Copier e Netlister são desenvolvidos utilizando os modelos de objetos X2 para ilustrar as capacidades do sistema de scripting no Altium Designer.

Estes são scripts existentes disponíveis na coleção de scripts de exemplo. A pasta Scripts dentro do ficheiro ZIP contém subpastas organizadas de acordo com as linguagens de scripting.

Note que pode encontrar uma vasta gama de scripts úteis na coleção GitHub do Altium Designer.

► Leia sobre Análise de exemplos de scripts no Altium Designer

► Leia sobre Referência de exemplos de scripting para Altium Designer

Suporte de linguagens de scripting

Os scripts podem ser escritos para o Altium Designer em várias linguagens de scripting. Note que a linguagem principal e a mais referida na documentação de scripting é DelphiScript, que está intimamente relacionada com Embarcadero Delphi™.

► Leia sobre Suporte de linguagens de scripting no Altium Designer