Automating Design Tasks with Scripting

Lo scripting offre un metodo potente per aumentare le tue capacità e la tua produttività con Altium Designer. Uno script contiene un insieme di istruzioni (comandi automatizzati) che vengono interpretate quando viene eseguito in Altium Designer. Gli script possono essere scritti in diversi linguaggi, completi di finestre di dialogo sofisticate, ed essere sottoposti a debug all'interno di Altium Designer. Puoi usare gli script per raggiungere i tuoi obiettivi di progettazione con un input minimo da parte dell'utente e con meno pressioni sulla tastiera e clic del mouse.

Con gli script, puoi automatizzare attività ripetitive ed eseguire modifiche che non sono disponibili con i comandi esistenti in Altium Designer. Ad esempio, potresti usare uno script per cercare e aggiornare i riferimenti fiduciali in un documento PCB, oppure per esportare una netlist personalizzata.

Gli script possono essere salvati in un progetto di script o in un progetto di progettazione. Sono disponibili diversi linguaggi di scripting per scrivere script in Altium Designer.

Panoramica e configurazione del sistema di scripting

Il sistema di scripting di Altium Designer fornisce tutti gli strumenti e le funzionalità necessari per creare script che automatizzano le attività nel software.

Gli script possono essere scritti per automatizzare attività ripetitive o migliorare una funzionalità in Altium Designer. Il sistema di scripting è composto da due parti principali: l'editor e il debugger. L'editor di script, il debugger e i pannelli di scripting lavorano insieme per aiutarti a scrivere ed eseguire il debug dei tuoi script con facilità. Uno script può essere eseguito direttamente dall'editor di script oppure assegnato a un menu, a una barra degli strumenti o a un tasto di scelta rapida, in modo da poter essere applicato al documento corrente, ad esempio un PCB, in qualsiasi momento.

► Leggi informazioni su il sistema di scripting in Altium Designer

Creazione e archiviazione degli script

Gli script di Altium Designer vengono solitamente creati e archiviati in un progetto di script (*.PrjScr), ma possono essere aggiunti o archiviati in qualsiasi tipo di progetto.

Per iniziare a scrivere script, comincia creando un nuovo progetto di script e aggiungendo file di script a quel progetto.

Un progetto di script ti aiuta a gestire i tuoi script e può essere creato selezionando File » New » Project » Script Project dai menu principali. Un nuovo progetto verrà elencato nel pannello Projects. Per aggiungere un nuovo script al progetto, fai clic con il pulsante destro del mouse sul nome del progetto e seleziona Add New to Project dal menu contestuale.

Quando crei un nuovo script, ci sono due tipi di script tra cui scegliere in base ai requisiti del tuo progetto: unità di script e moduli di script. Le unità di script ti consentono di scrivere procedure e funzioni autonome. I moduli di script ti consentono di creare finestre di dialogo con controlli e gestori di eventi, oltre a procedure e funzioni.

► Leggi informazioni su Creazione e archiviazione degli script in Altium Designer

Scrittura degli script

Esistono diversi concetti e termini essenziali che si applicano alla scrittura degli script:

• I processi sono stringhe di comando che puoi usare per eseguire comandi negli script.

• I componenti sono oggetti di controllo visivi nel pannello Tool Palette che puoi trascinare e rilasciare in un modulo di script per manipolare il progetto.

• Un componente posizionato in un modulo di script ha metodi, proprietà ed eventi.

• Le interfacce oggetto sono interfacce oggetto speciali che puoi usare per estrarre e modificare dati nei documenti di progettazione dai tuoi script.

Il linguaggio di scripting predefinito è impostato su DelphiScript (*.pas). Il motore di scripting stesso è scritto in Embarcadero Delphi e il pannello Tool Palette è basato sulla VCL (Visual Component Library) di Delphi.

► Leggi informazioni su Scrittura degli script in Altium Designer

Strumenti di modifica e debug degli script

Il sistema di scripting di Altium Designer è composto da due parti principali: l'editor e il debugger. L'editor offre una gamma di funzionalità di assistenza e ispezione del codice di scripting, mentre il debugger fornisce accesso ai componenti dello script e alle funzionalità di debug. Gli strumenti dell'editor di scripting sono una risorsa fondamentale durante il debug degli script.

Nel sistema di scripting è disponibile una gamma di strumenti per aiutare nel debug degli script. Questi includono l'applicazione di più breakpoint in uno script, l'uso del pannello Watch List per monitorare il valore delle variabili, l'uso dei segnalibri per spostarsi in modo più efficiente e l'uso delle funzioni step into e step over per seguire l'esecuzione degli script.

► Leggi informazioni su Strumenti di modifica degli script in Altium Designer

► Leggi informazioni su Debug degli script in Altium Designer

Esecuzione degli script

Sebbene il sistema di scripting di Altium Designer fornisca i mezzi per creare attività automatizzate sofisticate per Altium Designer, gli script risultanti devono anche essere facilmente accessibili durante il processo di progettazione. Ad esempio, uno script creato per eseguire un insieme complesso di operazioni durante la modifica di un PCB dovrebbe essere prontamente disponibile nell'editor PCB stesso, dove può essere eseguito con uno o due clic del mouse.

Altium Designer lo consente permettendo di assegnare uno script a un launcher di processo e quindi a un comando che può essere assegnato a un menu, a una barra degli strumenti e a una scorciatoia.

Uno script può essere eseguito usando il comando Run dell'editor quando è aperto nell'editor di script. Questo richiede che il progetto di script sia aperto in Altium Designer, il che non è un approccio pratico per accedere a uno script necessario durante il processo di progettazione PCB, ad esempio. In alternativa, la finestra di dialogo Select Item To Run (File » Run Script) ti consente di individuare uno script sul tuo disco rigido locale o in un Workspace connesso e quindi eseguire il processo desiderato. Lo script rimane caricato per la sessione corrente.

Un metodo più adatto per accedere a uno script usato frequentemente consiste nell'installare il progetto come progetto globale dalla pagina Scripting System – Global Projects della finestra di dialogo Preferences. In questo caso, il progetto viene caricato automaticamente all'avvio di Altium Designer e può essere eseguito in qualsiasi momento tramite il comando File » Run Script.

► Leggi informazioni su Esecuzione degli script in Altium Designer

Componenti grafici di scripting

I componenti visivi dei moduli disponibili per l'uso negli script di Altium Designer derivano per lo più dalla Visual Component Library (VCL) di Embarcadero, che è una raccolta di componenti visivi definiti per lo sviluppo di applicazioni Windows usando i linguaggi Delphi e C++.

Sviluppate come libreria di classi visive, le classi VCL discendono dall'oggetto TComponent (a sua volta discendente dall'oggetto radice TObject) in una gerarchia lineare di oggetti. Pertanto, un componente di script comune, come l'oggetto TButton, eredita proprietà, metodi ed eventi dai suoi oggetti superiori. In questo caso, la gerarchia di classi è: TObject → TPersistent → TComponent → TControl → TWinControl → TButtonControl → TButton.

Nota che i componenti che discendono dall'oggetto TControl sono generalmente componenti visivi (controlli), mentre i componenti comuni che discendono da TWinControl sono per lo più wrapper attorno alla Windows API.

Quando si crea un modulo nell'editor di script di Altium Designer, i componenti sono accessibili dal pannello Tool Palette. I moduli di script hanno un file *.DFM associato, che include dettagli sulla configurazione del modulo, sulle posizioni dei suoi componenti e su altri attributi; il file si trova nella cartella host del progetto di script. Altium Designer consente di usare i componenti sia con DelphiScript sia con VBScript durante la progettazione dei moduli di script.

► Leggi informazioni su Componenti grafici di scripting in Altium Designer

Esempi di script

Per fornire un'ulteriore comprensione degli aspetti generali del sistema di scripting e dell'uso dei modelli a oggetti Delphi e X2 negli script, vengono esaminati due progetti di esempio dal punto di vista funzionale: un copiatore del contorno della scheda e uno script di generazione della netlist. Gli script Board Outline Copier e Netlister sono sviluppati usando i modelli a oggetti X2 per illustrare le capacità del sistema di scripting in Altium Designer.

Si tratta di script esistenti disponibili nella raccolta di script di esempio. La cartella Scripts all'interno del file ZIP contiene sottocartelle organizzate in base ai linguaggi di scripting.

Nota che un'ampia gamma di script utili può essere trovata nella raccolta GitHub di Altium Designer.

► Leggi informazioni su Analisi degli esempi di script in Altium Designer

► Leggi informazioni su Riferimento agli esempi di scripting per Altium Designer

Supporto dei linguaggi di scripting

Gli script per Altium Designer possono essere scritti in diversi linguaggi di scripting. Nota che il linguaggio principale e quello più citato nella documentazione sullo scripting è DelphiScript, che è strettamente correlato a Embarcadero Delphi™.

► Leggi informazioni su Supporto dei linguaggi di scripting in Altium Designer