"Se um trabalhador quiser fazer bem o seu trabalho, ele deve primeiro afiar suas ferramentas." - Confúcio, "Os Analectos de Confúcio. Lu Linggong"
Primeira página > Programação > After Effects Scripts Projects and Syntheis Guide

After Effects Scripts Projects and Syntheis Guide

Postado em 2025-05-01
Navegar:582

Scripting: After Effects Projects and Compositions

Conteúdo
Introdução
Aplicativo
Projeto
pastas e composições
Exemplo
dicas rápidas
Conclusão

Introdução

Neste artigo, passarei por alguns dos princípios básicos da navegação de projetos e composições de efeitos usando um script. Farei referência a algumas das partes mais úteis do guia de script e mostrando alguns exemplos práticos de como ele funciona.

Vamos começar.


Aplicativo

app

o aplicativo faz referência ao aplicativo após os efeitos. Para fazer referência a qualquer coisa dentro dos efeitos após os efeitos, você precisará começar dizendo ao seu script para analisar o aplicativo.

Embora você possa fazer referência às configurações, arquivos e sistema de computador após os efeitos é instalado (eu vou entrar nessas opções em outro artigo), é mais do que provável o objeto principal que você precisará fazer referência após o aplicativo ser um projeto após efeitos.

app.newProject()

newProject () cria um novo projeto vazio. Você será solicitado pelos efeitos depois se quiser salvar seu trabalho atual antes que isso aconteça.

app.open(file)

Open () enquanto isso permite abrir um projeto existente. Deixando em branco os colchetes, ele exibirá a caixa de diálogo aberta do projeto como se estivesse navegando para o arquivo> Open Project ... no menu After Effects. Como alternativa, você pode fazer referência a um arquivo dentro dos colchetes para abrir um projeto específico.

project = new File ("...FilePath/AE Project.aep");
app.open(project);

você precisará criar um novo arquivo () para localizar o arquivo no seu script. Prefiro armazenar isso em uma variável para manter as coisas arrumadas. Novamente, você será solicitado a salvar seu projeto atual antes da abertura do arquivo.


Projeto

app.project

Referências do projeto O projeto atual aberto em After Effects. A partir daqui, podemos acessar todos os itens de dentro do nosso projeto, criar novos e acessar a fila de renderização.

app.project.save([file])

salvar () salva o projeto. Sem adicionar a opção de um arquivo ou se o projeto não tiver sido salvo anteriormente, esse método trará o diálogo salvo para o usuário salvar seu projeto. Lembre -se - você precisa criar um novo arquivo em seu projeto antes de poder fazer referência a ele neste método.

app.project.importFile(importOptions)

importfile () funciona um pouco assim:

new ImportOptions().file = new File("...FilePath/My File.jpg");
app.project.importFile(file)

vou impor arquivos com mais detalhes em outro artigo. Mas, como uma visão geral rápida, você usa esse método para importar arquivos para o seu projeto. Você não apenas precisa criar um novo arquivo, mas também precisa criar novas importOptions para especificar o que está importando e como. Isso nos permite fazer coisas como sequências de imagens de importação, importar arquivos como e forçar ordem alfabética.

app.project.importFileWithDialog()

importfileWithDialog () Enquanto isso, abre a caixa de diálogo Importar imagens, para que o usuário final selecione seu arquivo.

app.project.renderQueue

RenderQueue nos concede acesso à fila de renderização e nos permite definir configurações de renderização e até renderizar composições. Eu vou mais nisso em outro artigo.

app.project.activeItem

ActiveItem refere -se ao item atual que está sendo visualizado, geralmente uma composição, camada de filmagem, espaço reservado ou sólido. Ele apenas faz referência a um item de cada vez e retorna um nulo se vários itens estiverem ativos ou se nenhum estiver ativo. Pode ser útil fazer referência à composição ativa, para scripts que adicionam camadas ou afetam o que o usuário está trabalhando atualmente de alguma forma. Observe que isso não é o mesmo que um item sendo selecionado .

app.project.selection

seleção refere -se a todos os itens atualmente selecionados dentro do painel do projeto. É isso que você precisa ao fazer referência aos itens selecionados, em vez do item que está ativo.

app.project.item(index)

item () refere -se especificamente a um único item dentro do seu projeto - seja uma composição, sólida ou o que você tem. Assim:

app.project.item(1)
app.project.item("Comp 01")

O índice representa o número do índice do item dentro da janela do projeto, ou também pode se referir ao nome da camada.

app.project.items
itens

Enquanto isso, refere -se à coleção dos itens dentro do seu projeto. É usado para criar novas composições e pastas.


Pastas e composições

isso nos traz muito bem para pastas e composições.

app.project.items.addFolder(name);
app.project.items.addComp(name, width, height, pixelAspect, duration, frameRate);

addFolder () cria uma nova pasta para o seu projeto. Verifique se o argumento do nome é uma string (em "" ou '').

addComp (), no entanto, tem muitos outros argumentos a serem considerados. Isso ocorre porque há muitas informações necessárias para criar uma nova composição:

duração A duração da composição em segundos Framerate a taxa de quadros da composição
Argumento Descrição
nome o nome da composição. Precisa ser uma string (em "" ou '')
largura a largura da sua composição
altura A altura da sua composição
pixelaspect A proporção de pixels. Você quase certamente está procurando definir isso como pixels quadrados, o que você pode fazer definindo a proporção para 1. Qualquer outra proporção de pixels pode ser definida inserindo a proporção correta (por exemplo, o anamórfico 2: 1 pode ser definido ao entrar 2, e D1/DV PAL Widescreen pode ser definido por 1.46).
você pode criar novos compostos dentro das pastas referenciando a pasta, como esta:


pasta01 = App.project.items.addfolder ("Comps"); Comp01 = Folder01.items.addcomp ("Comp 01", 1920, 1080, 1, 5, 25);
folder01 = app.project.items.addFolder("Comps");
Comp01 = folder01.items.addComp("Comp 01", 1920, 1080, 1, 5, 25);
e pode mover itens para a pasta após o fato, definindo o atributo parentfolder do item:


pasta01 = App.project.items.addfolder ("Comps"); Comp01 = App.project.items.addcomp ("Comp 01", 1920, 1080, 1, 5, 25); Comp01.parentfolder = pastor01;
folder01 = app.project.items.addFolder("Comps");
Comp01 = folder01.items.addComp("Comp 01", 1920, 1080, 1, 5, 25);
Depois de criar uma composição, você pode defini -la como seu item ativo usando o OpenInViewer ()


comp1.openinViewer ();
comp1.openInViewer();

Exemplo

Usando um pouco do que eu cobri, aqui está um script curto que permite abrir um novo projeto, criar 2 pastas e 2 composições e adicionar um comp ao outro como um pré -computação.


app.newProject (); pasta1 = app.project.items.addolder ("_ final"); pasta2 = app.project.items.addfolder ("pré -compoca"); comp1 = pasta1.items.addcomp ("comp 01", 1920, 1080, 1, 10, 25); comp2 = pasta2.items.addcomp ("comp 02", 1920, 1080, 1, 10, 25); comp1.openinViewer (); app.project.activeItem.layers.add (comp2);
comp1.openInViewer();

Dicas rápidas

você encontrará, depois de executar este script, se você pressionar os efeitos após os efeitos, ele apenas desfazerá cada ação um de cada vez. Na maioria das vezes, isso não é ideal, pois os scripts geralmente passam por muitas ações, tornando isso demorado e irritante para o usuário final.


App.BeginUndogroup (Desmarca) App.endUNDOGROUPOURP (Deseftring)
folder01 = app.project.items.addFolder("Comps");
Comp01 = folder01.items.addComp("Comp 01", 1920, 1080, 1, 5, 25);
é aí que entram. Eles permitem agrupar as ações do script, para que possam ser desfeitas em uma moção. A troca de destaque é o que você verá ao lado da opção de desfazer em efeitos após os efeitos. Embora você não precise necessariamente adicionar EndUNDOGroup () se você tiver apenas uma instância de BeginUndOgroup () no seu script (como ele fechará automaticamente), é uma boa prática adicioná -lo ao final do seu script, para manter seu script arrumado.


Conclusão

Espero que isso tenha ajudado a esclarecer como fazer referência a projetos e composições após efeitos enquanto faz seus scripts após efeitos. No próximo artigo, vou criar o Windows pop -up para os usuários interagirem com seus scripts.

tem alguma dúvida? Algo errado aqui ou não está funcionando? Deixe -me saber nos comentários.

Declaração de lançamento Este artigo é reproduzido em: https://dev.to/kocrative/scripting-after-effects-projects-and-compositions-18jb?1 Se houver alguma infração, entre em contato com [email protected] para excluí-lo.
Tutorial mais recente Mais>

Isenção de responsabilidade: Todos os recursos fornecidos são parcialmente provenientes da Internet. Se houver qualquer violação de seus direitos autorais ou outros direitos e interesses, explique os motivos detalhados e forneça prova de direitos autorais ou direitos e interesses e envie-a para o e-mail: [email protected]. Nós cuidaremos disso para você o mais rápido possível.

Copyright© 2022 湘ICP备2022001581号-3