Scripts

Um script é uma série de comandos que instrui um aplicativo a executar uma série de operações. É possível usar scripts na maioria dos aplicativos da Adobe para automatizar tarefas repetitivas, executar cálculos complexos e utilizar alguma funcionalidade não exposta diretamente na interface gráfica do usuário. Por exemplo, é possível direcionar o After Effects para reorganizar as camadas em uma composição, localizar e substituir o texto de origem em camadas de texto, ou para enviar um email quando a renderização estiver concluída.

Os scripts do After Effects usam a linguagem Adobe ExtendScript, que é uma forma de JavaScript estendido. Os arquivos do ExtendScript têm a extensão de nome de arquivo JSX ou JSXBIN.

Para obter uma descrição dos recursos de script disponíveis com o After Effects, consulte Guia de scripts do After Effects.

Carregar e executar scripts

Quando o After Effects é iniciado, ele carrega os scripts da pasta Scripts. Por padrão, a pasta Scripts está nos seguintes locais do After Effects:

• Windows: Arquivos de Programas\Adobe\Adobe After Effects <version>\Support Files

• macOS: Aplicativos/Adobe After Effects <version>

O After Effects vem com vários scripts e que são automaticamente instalados na pasta Scripts. Todos os scripts carregados estão disponíveis no menu Arquivo > Scripts.

Os scripts na pasta ScriptUI Panels estão disponíveis na parte inferior do menu Janela. Se um script é escrito para fornecer uma interface em um painel encaixável, o script precisa ser colocado na pasta ScriptUI. Os painéis do ScriptUI funcionam da mesma forma que os painéis padrão na interface do After Effects.

• Para executar um script carregado, escolha Arquivo > Scripts > [nome do script].

• Para executar um script que não foi carregado, escolha Arquivo > Scripts > Executar arquivo de script, localize e selecione um script e clique em Abrir.

• Para interromper um script em execução, pressione Esc.

• Para executar um script a partir da linha de comando, invoque afterfx.exe na linha de comando. Use o comutador -r e o caminho completo do script a ser executado como argumentos. Este comando não abre uma nova instância do aplicativo do After Effects, ele executa o script na instância já existente.

  Exemplo (Windows): afterfx -r c:\caminho_do_script\script_de_exemplo.jsx

É possível visualizar a lista dos dez scripts executados mais recentemente no After Effects. Para ver a lista, selecione Arquivo > Scripts > Arquivos de script recentes.

Para executar novamente qualquer um dos dez scripts executados mais recentemente,

• macOS: Cmd + Option + Shift + D
• Windows: Ctrl + Alt + Shift + D

Scripts incluídos no After Effects

O After Effects fornece vários scripts pré-gravados para auxiliar na realização de tarefas comuns e fornecer uma base para que você altere e crie seus próprios scripts.

Gravar e modificar scripts

Você pode gravar seus próprios scripts para usar no After Effects usando o editor de scripts, que faz parte do ExtendScript Toolkit. O ExtendScript Toolkit fornece uma interface conveniente para criar, depurar e testar seus próprios scripts. Às vezes, tudo o que é necessário fazer é uma pequena modificação de um script existente para que ele faça aquilo que você pretende; normalmente podem ser realizadas pequenas alterações com alguns dados acerca da programação do computador e as linguagens de script.

Para iniciar o editor de scripts, escolha Arquivo > Scripts > Abrir Editor de scripts.

Consulte o Guia de scripts do After Effects para obter mais informações.

Acesso a scripts

Acesso a scripts de modelos de animações

Os scripts podem adicionar propriedades ao painel Gráficos essenciais e exportar um Modelo de animações, por meio dos seguintes métodos de script:

• Método de propriedade canAddToMotionGraphicsTemplate()
  

app.project.item(index).layer(index).propertySpec.canAddToMotionGraphicsTemplate(comp)

Teste se a propriedade pode ser adicionada ao painel Gráficos essenciais para a composição especificada. Retornará true se a propriedade puder ser adicionada; caso contrário, retornará false. Se a propriedade não puder ser adicionada, é porque não é um dos tipos de propriedade suportados ou já foi adicionada a essa composição. O After Effects apresenta uma caixa de diálogo de aviso. 

Tipos de propriedade compatíveis:

• Caixa de seleção
• Cor
• Controle deslizante numérico (uma propriedade numérica de valor único, como Transformar > Opacidade ou o efeito de controle de expressão do Controle deslizante)
• Texto de origem

Parâmetros:

Retorna: booleano.

• Método de propriedade addToMotionGraphicsTemplate()

app.project.item(index).layer(index).propertySpec.addToMotionGraphicsTemplate(comp)

Adicione a propriedade ao painel Gráficos essenciais para a composição especificada. Retornará true se a propriedade for adicionada com sucesso; caso contrário, retornará false. Se a propriedade não for adicionada, é porque não se encaixa em um dos tipos de propriedade suportados ou já foi adicionada a essa composição. O After Effects apresentará uma caixa de diálogo de aviso. Use o método canAddToMotionGraphicsTemplate() para testar se a propriedade pode ser adicionada a um Modelo de animações.

Parâmetros:

Retorna: booleano.

• Atributo CompItem motionGraphicsTemplateName 

app.project.item(index).motionGraphicsTemplateName

Leia ou grave a propriedade nome no painel Gráficos essenciais para a composição. O nome no painel Gráficos essenciais é usado para o nome de arquivo de um Modelo de animações exportado, por exemplo, Meu modelo.mogrt. O exemplo a seguir define o nome para a composição ativa e o retorna como um alerta: 

app.project.activeItem.motionGraphicsTemplateName = "Meu modelo";
alert(app.project.activeItem.motionGraphicsTemplateName);

Tipo: String; leitura/gravação.

• Método CompItem exportAsMotionGraphicsTemplate()
  

app.project.item(index).exportAsMotionGraphicsTemplate(doOverWriteFileIfExisting, file_path)

Exporta a composição como um Modelo de animações. Retornará verdadeiro se o Modelo de animações for exportado com sucesso; caso contrário, retornará falso. O nome no painel Gráficos essenciais é usado para o nome de arquivo do Modelo de animações, por exemplo, Meu modelo.mogrt. Use o atributo motionGraphicsTemplateName para definir o nome. Opcionalmente, especifique o caminho para a pasta na qual o arquivo de Modelo de animações é salvo. Se não especificado, o arquivo será salvo na pasta de Gráficos essenciais do usuário atual:

• macOS:  /Users/Library/Application Support/Adobe/Common/Essential Graphics/
• Windows: C:\Usuários\AppData\Roaming\Adobe\Common\Essential Graphics\

Se o projeto tiver sido alterado desde a última vez em que foi salvo, o After Effects solicitará que o usuário salve o projeto. Para evitar isso, use o método save() do projeto antes de exportar o Modelo de animações.

Parâmetros:

Retorna: booleano.

• Método CompItem openInEssentialGraphics()

app.project.item(index).openInEssentialGraphics()

Onde encontrar scripts úteis adicionais

Encontre scripts, projetos e outros itens úteis no site Adobe Add-ons.

O site AE Enhancers oferece scripts de exemplo e informações úteis sobre scripts (bem como expressões e predefinições de animação) no After Effects.