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 uma descrição dos recursos de script disponíveis com o After Effects, consulte o Guia de Scripts do After Effects em Centro de Desenvolvimento do After Effects no site da Adobe.

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

• (Windows) Arquivos de Programas\Adobe\Adobe After Effects <version>\Arquivos de suporte

• (Mac OS) Aplicativos/Adobe After Effects <version>

Os scripts também estão instalados em locais do usuário a partir do After Effects CC 12.1.

O After Effects vem com vários scripts e que são automaticamente instalados na pasta Scripts.

Os scripts carregados estão disponíveis no menu Arquivo > scripts. Se você editar um script quando o After Effects estiver em execução, será necessário salvar as alterações para que as alterações sejam aplicadas. Se você inserir um script na pasta Scripts quando o After Effects estiver em execução, reinicie o After Effects para que o script seja exibido no menu Scripts, embora seja possível executar imediatamente o script usando o comando Executar arquivo de script.

Os scripts na pasta Painéis de ScriptUI estão disponíveis na parte inferior do menu Janela. Se um script é escrito para fornecer uma interface do usuário do painel encaixável, o script deve ser armazenado na pasta ScriptUI. Os painéis de ScriptUI funcionam da mesma forma que painéis padrão na interface do usuário 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 script, localize e selecione um script e clique em Abrir.

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

• Para executar um script de linha de comando, chame afterfx.exe da 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 existente.

  Exemplo (para Windows):

  afterfx -r c:\script_path\example_script.jsx

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

Para executar novamente qualquer um dos scripts recentemente executados, pressione Cmd+Option+Shift+D (macOS) ou Ctrl+Alt+Shift+D (Windows).

Jeff Almasol fornece um script que cria um painel de console simples. O painel do console inclui uma área de texto na qual é possível digitar comandos ExtendScript a serem avaliados. Não há captura de erros ou mensagens; esse console é só uma maneira simples de inserir comandos sem precisar criar um script. Para obter informações, consulte o site de Jeff Almasol.

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.

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.

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

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

Um tutorial no fórum AE Enhancers conduz o leitor, passo a passo, na criação de um script.

Jeff Almasol fornece um conjunto de utilitários de script – como funções úteis – para facilitar a criação de seus próprios scripts no seu site redefinery.

David Torno fornece uma lista de nomes de correspondência para scripts do After Effects.

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

• Método de propriedade canAddToMotionGraphicsTemplate() app.project.item(index).layer(index).propertySpec.canAddToMotionGraphicsTemplate(comp) Testar se a propriedade pode ser adicionada ao painel Gráficos essenciais da 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.

Os tipos de propriedade compatíveis são:

• Caixa de seleção
• Cor
• Controle deslizante numérico (isto é, 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) Adicionar a propriedade ao painel Gráficos essenciais da 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 Ler ou gravar o nome da propriedade no painel Gráficos essenciais da 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:

Sequência de caracteres; leitura/gravação.

• Método CompItem exportAsMotionGraphicsTemplate() app.project.item(index).exportAsMotionGraphicsTemplate(doOverWriteFileIfExisting, file_path) Exportar a composição como um Modelo de animações. Retornará true se o Modelo de animações for exportado com sucesso; caso contrário, retornará false. 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:\Users\\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 de projeto save() antes de exportar o Modelo de animações.

Parâmetros:

Retorna:

Booleano.

• Método CompItem openInEssentialGraphics() app.project.item(index).openInEssentialGraphics() Abrir a composição no painel Gráficos essenciais.

Parâmetros:

Nenhum

Retorna:

Nenhum

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

Dan Ebberts oferece tutoriais de scripts e scripts úteis na seção de script do seu site MotionScript.

Lloyd Alvarez fornece uma coleção de scripts úteis no seu site Scripts do After Effects.

O fórum 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.

Jeff Almasol fornece uma coleção de scripts úteis no seu site redefinery.

Dale Bradshaw oferece scripts e truques no seu site Creative Workflow Hacks.

O site nabscripts fornece muitos scripts úteis.

Christopher Green fornece muitos scripts úteis no seu site.