Script

Uno script è una serie di comandi che forzano un’applicazione a eseguire una sequenza di operazioni. Potete utilizzare gli script in gran parte delle applicazioni Adobe per automatizzare le operazioni ripetitive, eseguire calcoli complessi e persino utilizzare alcune funzionalità non mostrate direttamente tramite l’interfaccia utente grafica. Ad esempio, potete comandare ad After Effects di riordinare i livelli in una composizione, trovare e sostituire il testo sorgente nei livelli testo o inviare un messaggio e-mail al termine del rendering.

Gli script di After Effects utilizzano il linguaggio Adobe ExtendScript, che è una forma estesa di JavaScript. I file ExtendScript hanno l’estensione .jsx o .jsxbin.

Per una descrizione delle funzionalità di scripting disponibili con After Effects, consultate la guida After Effects Scripting Guide in After Effects Developer Center.

Quando After Effects si avvia, carica gli script dalla cartella Scripts. Per impostazione predefinita, la cartella Scripts si trova nello stesso percorso di After Effects:

• (Windows) Programmi\Adobe\Adobe After Effects <versione>\Support Files

• (Mac OS) Applicazioni/Adobe After Effects <versione>

A partire da After Effects CC 12.1 gli script vengono installati anche in percorsi definiti dall’utente.

Diversi script sono forniti con After Effects e vengono installati automaticamente nella cartella Scripts.

Gli script caricati sono disponibili dal menu File > Script. Se modificate uno script durante l’esecuzione di After Effects, dovete salvare le modifiche per fare in modo che vengano apportate. Se inserite uno script nella cartella Script mentre After Effects è in esecuzione, dovete riavviare After Effects per fare in modo che lo script appaia nei menu Script, anche se potete eseguire immediatamente il nuovo script tramite il comando Esegui file script.

Gli script presenti nella cartella ScriptUI Panels sono disponibili nella parte inferiore del menu Finestra. Se uno script è stato scritto per fornire un’interfaccia utente in un pannello ancorabile, esso dovrebbe venire inserito nella cartella ScriptUI. I pannelli ScriptUI funzionano allo stesso modo dei pannelli predefiniti nell’interfaccia utente di After Effects.

• Per eseguire uno script caricato, scegliete File > Script > [nome script].

• Per eseguire uno script non caricato, scegliete File > Script > Esegui file script, individuate e selezionate lo script e fate clic su Apri.

• Per interrompere uno script in esecuzione, premete Esc.

• Per eseguire uno script dalla riga di comando, chiamate afterfx.exe dalla riga di comando. Come argomenti, usate lo switch -r e il percorso completo dello script da eseguire. Questo comando non apre una nuova istanza dell’applicazione After Effects, ma viene eseguito lo script nell’istanza esistente.

  Esempio (per Windows):

  afterfx -r c:\script_path\example_script.jsx

Potete visualizzare l’elenco degli ultimi dieci script eseguiti in After Effects. Per visualizzarlo, scegliete File > Script > File di script recenti.

Per eseguire di nuovo uno degli ultimi dieci script eseguiti, premete Comando + Opzione + Maiusc + D (macOS) o Ctrl + Alt + Maiusc + D (Windows).

Jeff Almasol mette a disposizione uno script che crea un semplice pannello di console. Il pannello di console include un’area di testo in cui potete immettere i comandi ExtendScript da valutare. La console non rileva gli errori, né visualizza messaggi, ma è un semplice strumento di immissione dei comandi, che evita di dover creare prima uno script. Per ulteriori informazioni, visitate il sito Web redefinery di Jeff Almasol.

After Effects offre diversi script predisposti per aiutarvi nell’esecuzione delle operazioni più comuni e per fornirvi una base per modificare e creare i vostri script.

Potete scrivere i vostri script per After Effects utilizzando l’editor di script, incluso nell’ExtendScript Toolkit. L’ExtendScript Toolkit costituisce una comoda interfaccia per la creazione, il debug e la verifica degli script. Talvolta è sufficiente apportare una leggera modifica a uno script esistente per fargli compiere l’operazione desiderata; spesso tali piccole modifiche possono essere eseguite anche da chi ha scarse conoscenze di programmazione e linguaggi di scripting.

Per ulteriori informazioni, consultate la guida allo script di After Effects.

Per avviare l’editor degli script, scegliete File > Script > Apri editor di script.

Un’esercitazione nel forum AE Enhancers guida il lettore nelle varie fasi della creazione di uno script.

Nel sito Web redefinery di Jeff Almasol potete trovare un insieme di utility di scripting che forniscono utili funzioni, per facilitare la creazione di script personalizzati.

David Torno offre un elenco di matchname per gli script per After Effects.

Con gli script è possibile aggiungere proprietà al pannello Grafica essenziale ed esportare un modello di grafica animata mediante i seguenti metodi di scripting:

• Il metodo app.project.item(index).layer(index).propertySpec.canAddToMotionGraphicsTemplate(comp) della proprietà canAddToMotionGraphicsTemplate() verifica se la proprietà può essere aggiunta al pannello Grafica essenziale per la composizione specificata. Restituisce vero se la proprietà può essere aggiunta, falso in caso contrario. Se la proprietà non può essere aggiunta, è perché non appartiene a uno dei tipi di proprietà supportati oppure perché la proprietà è già stata aggiunta a quella composizione. After Effects presenta una finestra di dialogo di avvertenza.

I tipi di proprietà supportati sono:

• Casella di controllo
• Colore
• Cursore numerico (ad esempio, una proprietà numerica con valore singolo, ad esempio Trasforma > Opacità o l’effetto di controllo espressione Controllo cursore)
• Testo sorgente

Parametri:

Valori restituiti:

Booleani.

• Il metodo app.project.item(index).layer(index).propertySpec.addToMotionGraphicsTemplate(comp) della proprietà addToMotionGraphicsTemplate() aggiunge la proprietà al pannello Grafica essenziale per la composizione specificata. Restituisce vero se la proprietà viene aggiunta correttamente; falso in caso contrario. Se la proprietà non viene aggiunta, è perché non appartiene a uno dei tipi di proprietà supportati oppure la proprietà è già stata aggiunta a quella composizione. After Effects presenterà una finestra di dialogo di avvertenza. Utilizzate il metodo canAddToMotionGraphicsTemplate() per verificare se la proprietà può essere aggiunta a un modello di grafica animata.

Parametri:

Valori restituiti:

Booleani.

• L’attributo app.project.item(index).motionGraphicsTemplateName dell’elemento compItem motionGraphicsTemplateName legge o scrive la proprietà del nome nel pannello Grafica essenziale per la composizione. Il nome nel pannello Grafica essenziale è utilizzato per il nome file di un modello di grafica animata esportato, ad esempio My Template.mogrt. L’esempio seguente imposta il nome per la composizione attiva e lo restituisce come avviso: 

app.project.activeItem.motionGraphicsTemplateName = "My Template";
alert (app.project.activeItem.motionGraphicsTemplateName);

Tipo:

Stringa; lettura/scrittura.

• Il metodo app.project.item(index).exportAsMotionGraphicsTemplate(doOverWriteFileIfExisting, file_path) dell’elemento compItem exportAsMotionGraphicsTemplate() esporta la composizione come un modello di grafica animata. Restituisce vero se il modello di grafica animata è stato esportato correttamente, falso in caso contrario. Il nome nel pannello Grafica essenziale è utilizzato per il nome file del modello di grafica animata, ad esempio My Template.mogrt. Utilizzate l’attributo motionGraphicsTemplateName per impostare il nome. Facoltativamente, specificate il percorso della cartella in cui viene salvato il file del modello di grafica animata. Se non viene specificato, il file verrà salvato nella cartella Essential Graphics dell’utente corrente:

macOS:

Utenti/Libreria/Supporto applicazione/Adobe/Common/Essential Graphics/

Windows:

C:\Utenti\\AppData\Roaming\Adobe\Common\Essential Graphics\

Se il progetto è cambiato dall’ultima volta che è stato salvato, After Effects richiede all’utente di salvare il progetto. Per evitare ciò, utilizzate il metodo di progetto save() prima di esportare il modello di grafica animata.

Parametri:

Valori restituiti:

Booleani.

• Il metodo app.project.item(index).openInEssentialGraphics dell’elemento compItem openInEssentialGraphics() apre la composizione nel pannello Grafica essenziale.

Parametri:

Nessuno

Valori restituiti:

Nessuno

Scoprite gli script, i progetti e altri elementi utili sul sito Adobe Add-ons.

Nella sezione relativa agli script del sito Web Motionscript di Dan Ebberts potete trovare esercitazioni sugli script e script utili.

Lloyd Alvarez mette a disposizione una serie di utili script nel suo sito Web After Effects Scripts.

Il forum AE Enhancers fornisce esempi di script e informazioni utili sulla creazione di script (nonché espressioni e predefiniti di animazione) in After Effects.

Nel sito Web redefinery di Jeff Almasol potete trovare una serie di script utili.

Nel sito Web Creative Workflow Hacks di Dale Bradshaw potete trovare script e suggerimenti.

Nel sito Web nabscripts potete trovare molti script utili.

Nel sito Web di Christopher Green potete trovare molti script utili.