Guia do Usuário Cancelar

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.

Observação:
  • 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 inserir um script na pasta Scripts enquanto o After Effects estiver em execução, será necessário reiniciá-lo para que ele seja exibido no menu Scripts, embora seja possível executar o novo script imediatamente usando o comando Executar arquivo de script.

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.

Observação:

Por padrão, não é permitido que os scripts gravem arquivos ou enviem e recebam comunicações pela rede. Para permitir que os scripts gravem arquivos e se comuniquem em uma rede,

  • Windows : selecione Editar > Preferências > Scripts e expressões > e selecione Permitir que scripts gravem arquivos e acessem a rede.
  • macOS: selecione After Effects > Configurações > Scripts e expressões > e escolha Permitir que scripts gravem arquivos e acessem a rede.
  • 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

Observação:

Você pode usar essa técnica de linha de comando, junto com o software que vem com um teclado personalizável, para vincular a invocação de um script a um atalho de teclado.

É 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
Observação:

No site AE Scripts, Lloyd Alvarez fornece uma dica sobre como executar scripts JSXBIN quando você não tem acesso às pastas Scripts ou Painéis ScriptUI.

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.

Dica:

Execute o script de amostra Demo Palette.jsx para ter uma ideia do que é possível fazer com 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)
app.project.item(index).layer(index).propertySpec.canAddToMotionGraphicsTemplate(comp)
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:

comp

A composição para a qual deseja testar a adição de propriedades: compItem.

Retorna: booleano.


  • Método de propriedade addToMotionGraphicsTemplate()
app.project.item(index).layer(index).propertySpec.addToMotionGraphicsTemplate(comp)
app.project.item(index).layer(index).propertySpec.addToMotionGraphicsTemplate(comp)
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:

comp

A composição para a qual deseja testar a adição de propriedades: compItem.

Retorna: booleano.


  • Atributo CompItem motionGraphicsTemplateName 
app.project.item(index).motionGraphicsTemplateName
app.project.item(index).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);
app.project.activeItem.motionGraphicsTemplateName = “Meu modelo”; alert(app.project.activeItem.motionGraphicsTemplateName);
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)
app.project.item(index).exportAsMotionGraphicsTemplate(doOverWriteFileIfExisting, file_path)
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:

doOverWriteFileIfExisting

Se substituirá ou não um arquivo existente com o mesmo nome, booleano. Obrigatório.

file_path

Caminho para a pasta na qual o arquivo será salvo. Opcional.

Retorna: booleano.


  • Método CompItem openInEssentialGraphics()
app.project.item(index).openInEssentialGraphics()
app.project.item(index).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.

Receba ajuda com mais rapidez e facilidade

Novo usuário?