Automatizando tarefas de projeto com scripts

Os scripts oferecem uma maneira poderosa de ampliar suas capacidades e sua produtividade com o Altium Designer. Um script contém um conjunto de instruções (comandos automatizados) que são interpretadas quando ele é executado no Altium Designer. Os scripts podem ser escritos em várias linguagens, incluir caixas de diálogo sofisticadas e ser depurados no Altium Designer. Você pode usar scripts para atingir seus objetivos de projeto com o mínimo de intervenção do usuário e menos pressionamentos de teclas e cliques do mouse.

Com scripts, você pode automatizar tarefas repetitivas e realizar edições que não estão disponíveis nos comandos existentes do Altium Designer. Por exemplo, você pode usar um script para localizar e atualizar marcas fiduciais em um documento de PCB ou para exportar uma netlist personalizada.

Os scripts podem ser salvos em um projeto de scripts ou em um projeto de design. Há várias linguagens de script disponíveis para escrever scripts no Altium Designer.

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

O sistema de scripts do Altium Designer oferece 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 aprimorar uma funcionalidade do Altium Designer. O sistema de scripts é composto por duas partes principais: o editor e o depurador. O editor de scripts, o depurador e os painéis de scripts trabalham em conjunto para ajudar você a escrever e depurar seus scripts com facilidade. Um script pode ser executado diretamente no editor de scripts ou associado a um menu, uma barra de ferramentas ou uma tecla de atalho, para que possa ser aplicado ao documento atual — como uma PCB — a qualquer momento.

► Leia sobre o Sistema de scripts no Altium Designer

Criação e armazenamento de scripts

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

Para começar a escrever scripts, crie um novo projeto de scripts e adicione arquivos de script a esse projeto.

Um projeto de scripts ajuda você a gerenciar 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, há 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 independentes. Os formulários de script permitem criar caixas de diálogo com controles e manipuladores de eventos, além de procedimentos e funções.

► Leia sobre Criação e armazenamento de scripts no Altium Designer

Escrita de scripts

Há vários conceitos e termos essenciais que se aplicam à escrita de scripts:

• Processos são cadeias de comandos que você pode usar para executar comandos em scripts.

• Componentes são objetos de controle visual no painel Tool Palette que você pode arrastar e soltar em um formulário de script para manipular o projeto.

• Um componente inserido em um formulário de script tem métodos, propriedades e eventos.

• Interfaces de objetos são interfaces especiais que você pode usar para extrair e modificar dados em documentos de projeto a partir dos seus scripts.

A linguagem de script padrão é DelphiScript (*.pas). O próprio mecanismo de scripts é escrito em Embarcadero Delphi, e o painel Tool Palette é baseado na VCL (Visual Component Library) do Delphi.

► Leia sobre Escrita de scripts no Altium Designer

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

O sistema de scripts do Altium Designer é composto por duas partes principais: o editor e o depurador. O editor oferece diversos recursos de auxílio e inspeção do código de scripts, e o depurador fornece acesso aos componentes do script e aos recursos de depuração. As ferramentas do editor de scripts são um recurso essencial para depurar scripts.

O sistema de scripts oferece diversas ferramentas para ajudar na depuração de scripts. Entre elas estão a definição de vários pontos de interrupção em um script, o uso do painel Watch List para monitorar o valor das variáveis, o uso de marcadores para navegar com mais eficiência e o uso de recursos de execução passo a passo, entrando ou não nas rotinas, para acompanhar a execução dos scripts.

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

► Leia sobre Depuração de scripts no Altium Designer

Execução de scripts

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

O Altium Designer possibilita isso ao permitir que um script seja associado a um iniciador de processos e, assim, a um comando que pode ser atribuído a um menu, uma barra de ferramentas e um atalho.

Um script pode ser executado usando o comando Run do editor quando estiver aberto no editor de scripts. Isso exige que o projeto de scripts esteja aberto no Altium Designer, o que não é uma abordagem conveniente para acessar um script necessário durante o processo de projeto de PCB, por exemplo. Como alternativa, a caixa de diálogo Select Item To Run (File » Run Script) permite localizar um script no disco rígido local ou em um Workspace conectado e, em seguida, executar o processo desejado. O script permanece carregado durante a sessão atual.

Uma maneira mais adequada de acessar um script usado com frequência é instalar o projeto como um projeto global na página Scripting System – Global Projects da caixa de diálogo Preferences. Nesse caso, o projeto é carregado automaticamente quando o Altium Designer é iniciado e pode ser executado a qualquer momento por meio do comando File » Run Script.

► Leia sobre Execução de scripts no Altium Designer

Componentes gráficos de scripts

Os componentes visuais de formulário disponíveis para uso em scripts do Altium Designer são, em sua maioria, derivados da Visual Component Library (VCL) da Embarcadero, uma coleção de componentes visuais definidos para desenvolver aplicativos Windows usando as linguagens Delphi e C++.

Desenvolvida como uma biblioteca de classes visuais, a VCL contém classes que descendem do objeto TComponent (que, por sua vez, descende do objeto raiz TObject) em uma hierarquia linear de objetos. Portanto, um componente de script comum, como o objeto TButton, herda as propriedades, os métodos e os eventos de seus objetos ancestrais. Nesse caso, a hierarquia de classes é: TObject → TPersistent → TComponent → TControl → TWinControl → TButtonControl → TButton.

Observe que os componentes que descendem do objeto TControl geralmente são componentes visuais (controles), e os componentes comuns que descendem de TWinControl são, em sua maioria, encapsulamentos da API do Windows.

Ao criar um formulário no editor de scripts do Altium Designer, os componentes são acessados pelo painel Tool Palette. Os formulários de script têm um arquivo *.DFM associado, que inclui detalhes da configuração do formulário, das posições dos componentes e de outros atributos; o arquivo fica na pasta que contém o projeto de scripts. O Altium Designer permite usar os componentes tanto com DelphiScript quanto com VBScript ao projetar formulários de script.

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

Exemplos de scripts

Para oferecer uma visão mais aprofundada dos aspectos gerais do sistema de scripts e do uso dos modelos de objetos Delphi e X2 em scripts, dois projetos de exemplo são analisados sob a perspectiva funcional: um copiador de contorno de placa e um script de geração de netlist. Os scripts Board Outline Copier e Netlister foram desenvolvidos usando os modelos de objetos X2 para ilustrar os recursos do sistema de scripts no Altium Designer.

Esses scripts estão disponíveis no download de exemplos da Altium. Observe que esse arquivo ZIP foi criado na época do lançamento do Altium Designer 10. A pasta Scripts no arquivo ZIP contém subpastas organizadas por linguagem de script.

Observe que uma ampla variedade de scripts úteis pode ser encontrada na coleção do Altium Designer no GitHub.

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

► Leia sobre Referência de exemplos de scripts para o Altium Designer

Suporte a linguagens de script

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

► Leia sobre Suporte a linguagens de script no Altium Designer