Noções básicas de expressões

Se quiser criar e vincular animações complexas, mas quiser evitar criar dez ou centenas de quadros-chave manualmente, experimente usar expressões. Uma expressão é uma pequena parte do código, assim como um script, que você pode conectar aos projetos do After Effects. Ela avalia um valor único para uma única propriedade de camada em um ponto específico no tempo. Contudo, os scripts avisam um aplicativo para fazer algo, uma expressão indica que uma propriedade é algo.

Caso pareça complexo, assista ao vídeo a seguir para começar a explorar as expressões.

A linguagem da expressão é baseada na linguagem JavaScript padrão, mas não precisa conhecer o JavaScript para usar expressões. Você pode criar expressões usando o ícone de seleção ou copiando exemplos simples e alterá-los para atender suas necessidades.

Para abrir os controles de expressão, selecione a propriedade de camada que deseja afetar e mantenha pressionada a tecla Option no Mac ou ALT no PC enquanto clica no ícone do quadro-chave (cronômetro). A caixa de expressões é exibida, você pode usá-la para escrever. Edite expfll e consulte as opções de expressão, incluindo um local para escrever ou colar a expressão. Além disso, é possível usar a ferramenta Ícone de seleção principal para fazer referência a outra camada para sua expressão. Você também pode ativar ou desativar a expressão aqui sem precisar excluí-la.

Vejamos um exemplo de uma expressão comum e simples conhecida como chocalho.

As predefinições de animação podem incluir expressões, ou ainda consistirem inteiramente de uma expressão. As predefinições de animação que usam expressões em vez de quadros-chave às vezes são chamadas de comportamentos.

Após adicionar uma expressão a uma propriedade, você pode continuar adicionando ou editando quadros-chave para a propriedade. Uma expressão pode obter o valor de uma propriedade como determinado por seus quadros-chave e usar isso como entrada para criar novos valores, modificados. Por exemplo, a seguinte expressão na propriedade Rotação de uma camada adiciona 90 graus ao valor da propriedade Rotação, além do movimento com quadros-chave:

Alguns métodos, como chocalho, operam diretamente nos valores de propriedade com quadros-chave. (consulte Atributos e métodos de propriedade (referência da expressão).)

A seguinte expressão na propriedade Posição de uma camada mantém o movimento com quadros-chave da camada e faz com que chocalhe um pouco:

Quando estiver animando texto, você pode usar o seletor de expressão para especificar o quanto deseja que uma propriedade do animador afete cada caractere de texto. Você pode adicionar um ou vários seletores Expressão a um grupo do animador e esse grupo do animador pode conter uma ou mais propriedades.

Enquanto você estiver editando uma expressão, as visualizações de todos os tipos estão suspensas; uma barra vermelha será exibida na parte inferior dos painéis que o estão aguardando para sair do modo de edição de texto.

Os valores da propriedade que contém uma expressão aparecem no texto vermelho ou rosa.

Uma boa maneira de começar a trabalhar com expressões é criar uma expressão simples com o ícone de seleção e, em seguida, ajustar o comportamento da expressão usando operações matemáticas simples, como as listadas na tabela a seguir:

Jeff Almasol fornece um script que processa automaticamente expressões, fazendo alterações especificadas. Por exemplo, o script pode ser usado para remover ou ativar automaticamente as expressões desativadas.

É possível personalizar a interface do editor de código do editor de expressões, incluindo realce da sintaxe JavaScript com cores personalizadas, números de linha, encapsulamento de código e Completar automaticamente. Para personalizar essas opções, selecione Preferências > Scripts e expressões.

Para entender como funciona o editor, consulte o exemplo abaixo:

Nomes de composição, de camada, de gravação e de efeito são adicionados à função de Preenchimento automático e exibidos no contexto correto, com seus respectivos métodos comp(), layer(), footage(), e effect(). Isso permite que você mantenha sua expressão ativa ao fazer referência aos itens no projeto. Não é necessário rolar pela Linha de tempo ou abrir outros painéis para fazer referência a propriedades ou artigos usando o Seletor.

• Para adicionar uma expressão a uma propriedade, selecione a propriedade no painel Linha de tempo e escolha Animação > Adicionar expressão ou pressione Alt+Shift+= (Windows) ou Option+Shift+= (Mac OS); ou clique com a tecla Alt pressionada (Windows) ou clique com a tecla Option pressionada (Mac OS) no botão do cronômetro ao lado do nome da propriedade no painel Linha de tempo ou no painel Controles do efeito.
• Para vincular um conjunto de propriedades em camadas e composições, use links de propriedade.
  Selecione qualquer propriedade ou conjunto de propriedades e escolha Editar > Copiar com links de propriedade ou Editar > Copiar com links de propriedade relativos, em seguida, cole-as em qualquer camada da composição. As propriedades coladas permanecem conectadas à camada de onde foram copiadas, de modo que qualquer alteração feita à propriedade original será refletida em todas as instâncias dos links da propriedade colada.
  É possível copiar uma camada inteira com links de propriedades e colá-la para criar duplicatas que acompanham as alterações feitas no original.

  O comando Copiar com links relativos à propriedade funciona como o comando Copiar com links de propriedades, com a exceção de que o comando Copiar com links relativos à propriedade cria expressões que não fazem referência a composição de origem pelo nome. Mantém um link relativo entre a camada com a expressão e a composição que contém a camada. Isso pode ser útil quando, por exemplo, você deseja mover camadas manipuladas pela expressão de uma composição para outra, mas deixar as camadas fazerem referência a uma camada de controle somente na mesma composição. As expressões criadas com o comando Copiar com os links de propriedade relativos são idênticas às criadas usando o ícone de seleção de expressão.

  O resultado de copiar a propriedade Posição de uma camada com o comando Copiar com links relativos à propriedade é o seguinte:

  thisComp.layer("control_layer").transform.position

  O resultado de copiar a propriedade de posição de uma Camada com o comando Copiar com links de propriedades é como a seguir, que se refere especificamente à composição de origem da camada na expressão:

  comp("source_comp").layer("control_layer").transform.position

• Para desativar temporariamente uma expressão, clique na opção Ativar expressão . Quando uma expressão é desativada, uma barra aparece na opção .
• Para remover uma expressão de uma propriedade, selecione a propriedade no painel Linha de tempo e escolha Animação > Remover expressão ou clique com a tecla Alt pressionada (Windows) ou clique com a tecla Option pressionada (Mac OS) no botão do cronômetro ao lado do nome da propriedade no painel Linha de tempo ou no painel Controles do efeito.

Se você não estiver familiarizado com JavaScript ou a linguagem de expressões do After Effects, você ainda pode utilizar as expressões usando o ícone de seleção. Arraste simplesmente o ícone de seleção de uma propriedade para outra para vincular as propriedades com uma expressão e o texto da expressão é inserido no campo de expressão no ponto de inserção. Se o texto for selecionado no campo de expressão, o novo texto de expressão substitui o texto selecionado. Se o ponto de inserção não estiver no campo de expressão, o novo texto de expressão substitui todo o texto no campo.

Você pode arrastar o ícone de seleção para o nome ou o valor de uma propriedade. Se você arrastar para o nome de uma propriedade, a expressão resultante mostra os valores como um. Por exemplo, se você arrastar o ícone de seleção para o nome da propriedade Posição, aparece uma expressão como a seguir:

Se você arrastar o ícone de seleção para um dos valores da propriedade Posição (como o valor y), aparece uma expressão como a seguir, em que as coordenadas x e y da propriedade estão vinculadas ao valor y da propriedade Posição:

Se a camada, máscara ou efeito para o qual você arrasta o ícone de seleção não tiver um nome exclusivo no contexto local, o After Effects renomeia-o. Por exemplo, se você tiver duas ou mais máscaras como o nome “Mask” na mesma camada, e arrastar o ícone de seleção para uma delas, o After Effects renomeia-a como “Máscara 2.”

O formato de expressões criadas pelo ícone de seleção é determinado pela preferência Ícone de seleção de expressão escreve em inglês compacto (Editar > Preferências > Geral (Windows) ou After Effects > Preferências > Geral (Mac OS)). Por padrão, o ícone de seleção cria expressões em inglês compacto, usando os nomes das propriedades conforme aparecem no painel Linha de tempo para as propriedades de uma expressão. Como esses nomes são codificados no aplicativo e nunca mudam, essas expressões podem trabalhar quando o After Effects é executado em outro idioma. Todos os nomes de propriedades que podem alterar são delimitados por aspas duplas e mantêm-se os mesmos em qualquer idioma. Se você não pretende compartilhar seus projetos em todos os idiomas, pode desmarcar essa preferência. Esta preferência não afeta nomes de efeitos ou propriedades do efeito.

Veja um exemplo em inglês compacto:

Esta é a mesma expressão, não em inglês compacto:

No modo Editor de gráfico, o único campo de expressão aparecerá como uma caixa redimensionável na parte inferior do Editor de gráfico e mostra somente a expressão da propriedade selecionada. Para mostrar simultaneamente vários campos de expressão, o painel Linha de tempo deve estar no modo da barra de camadas.

• Para mostrar apenas propriedades com expressões, selecione uma ou mais camadas e, em seguida, pressione EE.
• Para mostrar o campo de expressão no Editor de gráfico, escolha Mostrar editor de expressão no menu Escolher o tipo e as opções de gráfico na parte inferior do Editor de gráfico. Quando você adiciona uma nova expressão a uma propriedade, o editor de expressão é exibido, independentemente dessa configuração.

• Para saber como uma expressão altera o gráfico de valor ou de velocidade, clique no botão Mostrar gráfico pós-expressão enquanto exibe o gráfico de valor ou de velocidade no Editor de gráfico.

  O gráfico colorido esmaecido indica o valor ou velocidade antes que a expressão seja aplicada e o gráfico colorido brilhante indica o valor ou velocidade depois que a expressão é aplicada. Ativar a sobreposição do gráfico para a propriedade Posição também altera a exibição do caminho de movimento no painel Composição para poder ver o caminho afetado pela expressão.

A propriedade Texto de origem de uma camada de texto é interpretada por expressões como uma Sequência de caracteres JavaScript. Você pode usar o ícone de seleção para obter o texto de origem de outra camada de texto; porém, apenas o estilo do primeiro caractere da camada de destino é usado.

No painel Gráficos essenciais, no menu Propriedades de texto de origem, você pode selecionar a caixa de texto Usar camada como fallback. Quando marcada, você pode selecionar uma composição/subcomposição e uma forma ou camada de clipe para determinar uma caixa de texto alternativa para editar o texto no Monitor de programas do Premiere Pro.

Para obter mais informações sobre o objeto Sequência de caracteres String JavaScript, consulte um recurso de referência JavaScript.

Você pode usar “\r” em uma expressão de cadeia de caracteres para iniciar uma nova linha de texto. Por exemplo, para copiar o texto original de uma camada na mesma camada e para repeti-lo todos os caracteres em maiúsculas em uma linha, use a seguinte expressão:

Adicionar uma camada de texto a uma composição e adicionar uma expressão à sua propriedade Texto de origem pode ser uma excelente forma de examinar os valores de propriedades de outras camadas. Por exemplo, a seguinte expressão em uma propriedade Texto de origem reporta o nome e o valor da propriedade Opacidade para a próxima camada na ordem de empilhamento de camadas:

O exemplo a seguir indica o nome do item de gravação usado como a origem da primeira camada de imagem na ordem de empilhamento no tempo atual que tem a opção Vídeo definida.

Aharon Rabinowitz fornece um tutorial em vídeo e expressões em Red Giant TV que mostra como animar uma pontuação de videogame com a propriedade Texto de origem e um efeito Controle deslizante (um efeito Controles a expressões).

É possível usar expressões para controlar o estilo de texto, bem como o próprio texto. Trabalhe com qualquer expressão de texto, bem como com Modelos de animações. É possível vincular vários títulos e atualizar o estilo de uma só vez, o que é usado para o design de título, especialmente títulos principais e finais.

Para obter mais informações, consulte Usar expressões para editar e acessar propriedades de texto.

Se gravar uma expressão complexa e projetada para você ou outra pessoa para usar posteriormente, você deve adicionar comentários que explicam o que a expressão faz e como as partes funcionam.

• Digite // no início de um comentário. Todo o texto entre // e o final da linha são ignorados. Por exemplo:  // Isto é um comentário.

  Para exemplos desse tipo de comentário, consulte Exemplo expressão: Atenuar a opacidade de uma camada 3D com base na distância da câmera.

• Digite /* no início do comentário e * no final do comentário. Todo o texto entre /* e * é ignorado. Por exemplo:  /*  Isto é um         comentário multilinhas. */

  Para exemplos desse tipo de comentário, consulte Salvar e reusar expressões.

Depois de gravar uma expressão, você pode salvá-la para uso futuro copiando-a e colando-a em um aplicativo de edição de texto ou salvando-a em uma predefinição de animação ou projeto modelo. Contudo, como as expressões são gravadas em relação a outras camadas em um projeto e podem usar nomes específicos de camada, é necessário às vezes modificar uma expressão para transferi-la entre projetos.

Você pode definir suas próprias funções em expressões com a sintaxe de função JavaScript normal. Neste exemplo, uma função é definida para calcular a média de dois valores e a última linha usa esta função:

Para salvar uma expressão para usar em um outro projeto, você deve adicionar comentários à expressão. (Consulte Adicionar comentários a uma expressão.) Você deve também usar variáveis para que você possa alterar um valor em um lugar em vez de ter que alterá-lo em vários locais.

Por exemplo, esta expressão tem um comentário com várias linhas no início que explica o que a expressão faz e um comentário curto após a variável é declarada e inicializada que informa para que serve a variável:

Você pode salvar uma predefinição de animação que inclui uma expressão e reusá-la em outros projetos, caso a expressão não faça referência às propriedades que não existem em outros projetos. Ao salvar uma predefinição na qual uma propriedade tem uma expressão, mas nenhum quadro-chave, somente a expressão é salva. Se a propriedade tiver um ou mais quadros-chave, a predefinição salva contém a expressão juntamente com todos os valores do quadro-chave.

É possível copiar uma expressão de uma propriedade de camada, com ou sem os quadros-chave da propriedade.

• Para copiar uma expressão e quadros-chave de uma propriedade para outras propriedades, selecione a propriedade de camada de origem no painel Linha de tempo, copie a propriedade de camada, selecione as propriedades da camada de destino e cole.
• Para copiar uma expressão de uma propriedade para outras propriedades sem copiar quadros-chave, selecione a propriedade de origem, escolha Editar > Copiar somente expressão, selecione as propriedades de destino e cole.

Use um efeito Controles de expressão para adicionar um controle que você pode usar para manipular os valores de uma ou mais propriedades vinculando a propriedade ao controle usando expressões. Um único controle pode afetar várias propriedades imediatamente.

Você pode usá-los para controlar outros parâmetros usando expressões. É possível adicionar um controle deslizante que move somente uma camada dentro de determinados limites, ou permitir que o usuário selecione entre várias opções arrastando um controle deslizante. É possível adicionar caixas de seleção para ativar ou desativar camadas ou alterar esquemas de cores em camadas de texto e de gráfico. É possível adicionar controles de ângulo que orientam a rotação de várias camadas, além de poder adicionar controles de cor que alteram a cor do texto, brilhos ou formas. Há sete tipos de Controles de expressão no After Effects, mas o Controle de ponto 3D e o Controle de camada não são compatíveis com o painel Gráficos essenciais, portanto, eles não são usados para design MOGRT.

Os nomes dos efeitos do Controle de expressão indicam o tipo de controle de propriedade que eles fornecem: Controle de ângulo, Controle de caixa de seleção, Controle de cor, Controle de camada, Controle de ponto, Controle deslizante e Controle do menu suspenso. O After Effects CS5.5 e posterior inclui também um Controle de ponto 3D.

Você aplica efeitos Controles de expressão a uma camada exatamente como aplica outros efeitos, como arrastar o efeito para a camada do painel Efeitos e predefinições.

Você pode aplicar efeitos Controles de expressão a uma camada; no entanto, é útil aplicá-los a uma camada nula, que você pode apenas usar como uma camada de controle. Você adiciona as expressões a propriedades em outras camadas para tirar a entrada do controle. Por exemplo, é possível adicionar um efeito Controle deslizante a uma camada nula zero (Nulo 1) e aplicar esta expressão às propriedades Posição de várias camadas:

Neste exemplo, ao arrastar o controle deslizante, cada camada com esta expressão move-se. As camadas com números de índice maiores (camadas na parte inferior do painel Linha de tempo) são alteradas para criar camadas com números de índice menores, a intervalos de 10 pixels. Você pode definir quadros-chave para o controle deslizante na camada nula e todas as outras camadas são animadas apropriadamente.

Geralmente é útil renomear cada instância de um efeito Controle de expressão para exibir o uso respectivo. Por exemplo, renomear uma instância do efeito Controle de cor para cor de céu torna mais fácil dizer o quê o efeito está controlando. Você pode renomear cada instância de um efeito Controle de expressão como renomearia qualquer outro efeito: selecione-o no painel Linha de tempo ou painel Controles do efeito e pressione Enter no teclado principal (Windows) ou Return (Mac OS).

Em alguns casos, é útil converter uma expressão para quadros-chave. Por exemplo, se você deseja paralisar os valores em uma expressão, é possível convertê-la em quadros-chave e ajustá-los adequadamente. Se uma expressão demorar muito tempo para avaliar, é possível convertê-la em quadros-chave para renderizar mais rapidamente. Quando você converte uma expressão em quadros-chave, o After Effects avalia a expressão, criando um quadro-chave em cada quadro e, em seguida, desativa a expressão.

O idioma da expressão do After Effects é baseado em JavaScript 1.2, com um conjunto extenso de objetos integrados. O After Effects usa apenas a linguagem JavaScript padrão 1.2 principal, não as extensões específicas do navegador Web. O After Effects contém seu conjunto próprio de objetos de extensões – como Camada, Composição, Gravação e Câmera – que você pode usar para obter a maioria dos valores em um projeto do After Effects.

Embora o idioma da expressão seja baseado em uma linguagem de script, uma diferença sutil mas importante existe entre um script e uma expressão: enquanto um script instrui o aplicativo para fazer algo, uma expressão indica que uma propriedade é algo.

Para obter mais informações sobre o JavaScript, consulte um recurso de referência a JavaScript.

Ao criar expressões, lembre-se do seguinte:

• O valor de uma expressão é o valor da última instrução avaliada.

• O JavaScript é uma linguagem que diferencia maiúsculas e minúsculas.

• Os pontos e vírgulas são obrigatórios para separar instruções ou linhas.

• Os espaços entre palavras são ignorados, exceto em uma sequência de caracteres.

No JavaScript, um valor armazenado em um objeto é chamado de propriedade. Contudo, o After Effects utiliza o termo propriedade para fazer referência a componentes de camada conforme definido no painel Linha de tempo. Por esse motivo, o After Effects refere-se a propriedades JavaScript como métodos ou atributos. Na prática geral, a diferença entre um método e um atributo é o que um método faz normalmente algo para criar seu valor de saída (return), enquanto um atributo se refere simplesmente a um valor existente para determinar seu valor de saída (return). Você pode informar um método de um atributo mais facilmente, procurando os parênteses depois do nome do método, os quais circundam todos os argumentos de entrada do método.

Um objeto é um item que contém outros objetos, atributos e métodos. As composições, camadas e itens de gravação são exemplos de objetos. Especificamente, as composições, camadas e itens de gravação são objetos globais, significando que podem ser referenciadas em qualquer contexto sem referência a um objeto de nível superior.

Use o idioma da expressão para acessar atributos e métodos de propriedades de camada. Para acessar um valor, use uma cadeia de referências de objetos separados pelo operador ponto (.). Para vincular referências de objetos passados do nível de camada (por exemplo, para fazer referência a propriedades do efeito, máscaras ou animadores de texto), é possível usar parênteses. Por exemplo, para vincular a propriedade Opacidade na camada A à propriedade do Nível de desfoque do efeito Desfoque gaussiano na camada B, digite a seguinte expressão no campo de expressão para a propriedade Opacidade para a camada A:

Ao ler esta expressão da esquerda para a direita, você progride do nível superior, contendo o objeto para baixo até à propriedade específica:

• O objeto global usado se refere à composição atual: thisComp.

• Um objeto de camada específico nessa composição é referenciado pelo nome: camada(“Camada B”).

• Um objeto de efeito específico nessa camada é referenciado pelo nome: efeito(“Desfoque gaussiano”).

• Uma propriedade de efeito específico nesse efeito é referenciada pelo nome: (“Blurriness”).

Para obter o componente n de uma propriedade multidimensional, como componente y de um ponto de controle do efeito, adicione [n] no fim, desta forma:

O objeto padrão de uma expressão é a propriedade na qual a expressão é gravada, seguido pela camada que contém a expressão; consequentemente, você não precisa especificar a propriedade. Por exemplo, uma expressão de chocalho gravada na propriedade Posição de uma camada pode ser qualquer um dos seguintes:

Inclua a camada e a propriedade para recuperá-las fora da camada e da propriedade na qual a expressão está gravada. Por exemplo, uma expressão gravada na propriedade Opacidade da camada, B, vinculando-a à propriedade Rotação da camada A aparecerá como esta expressão:

Jeff Almasol fornece um script no seu site de redefinery com o qual você pode determinar como fazer referência a qualquer propriedade nas expressões.

Uma Matriz é um tipo de objeto que armazena um conjunto ordenado de números. Uma Matriz é representada como uma lista de números separados por vírgulas e delimitados por colchetes, como mostra este exemplo:

Você pode atribuir um objeto Matriz a uma variável, facilitando a referência a valores de matriz em outras áreas da expressão. Por exemplo:

A dimensão de um objeto Matriz é o número de elementos na matriz. A dimensão de myArray é 2. As várias propriedades no After Effects possuem dimensões diferentes dependendo do número de argumentos de Valor que têm. Em linguagem de expressão, os valores de propriedades são um valores únicos (objetos Número) ou matrizes (objetos Matriz).

As tabelas a seguir fornecem exemplos de algumas propriedades e suas dimensões:

Você pode acessar os elementos individuais de um objeto Matriz usando colchetes e um número de índice para indicar o elemento desejado. Os elementos em um objeto Matriz são indexados iniciando em 0. Usando o exemplo anterior, myArray[0] é 10 e myArray[1] é 23.

As duas expressões a seguir são equivalentes:

As matrizes da propriedade Posição são indexadas como se segue:

• a position[0] é a coordenada x da posição.

• a position[1] é a coordenada y da posição.

• a position[2] é a coordenada z da posição.

As cores são representadas como matrizes a quatro dimensões [vermelho, verde, azul, alfa]. Em projetos com uma intensidade de cor de 8 bpc ou 16 bpc, cada valor em uma matriz de cores varia de 0 (preto) a 1 (branco). Por exemplo, vermelho pode variar de 0 (nenhuma cor) a 1 (vermelho). Assim, [0,0,0,0] é preto e transparente, e [1,1,1,1] é branco e completamente opaco. Em projetos com intensidade de cor de 32 bpc, valores abaixo de 0 e acima de 1 são permitidos.

Se você usar um índice que é maior que o índice do componente de maior dimensão em um objeto Matriz, o After Effects retornará um erro. Por exemplo, myArray[2] causa um erro, mas a position[2] retorna a coordenada z da Posição.

Muitas das propriedades e métodos no idioma de expressão do After Effects têm objetos Matriz como argumento ou os retornam como valores. Por exemplo, thisLayer.position é um objeto Matriz que é bidimensional ou tridimensional dependendo se a camada é 2D ou 3D.

Se quiser criar uma expressão que mantenha o valor y de uma animação de Posição, mas fixa o valor de x em 9, use o seguinte:

Este é ainda mais sucinto:

Este é um aspecto importante, portanto vejamos mais um exemplo. Se você deseja combinar o valor da posição x da camada A com o valor da posição y da camada B, use o seguinte:

Você pode criar uma expressão para fazer referência apenas a um valor na matriz de uma propriedade 2D ou 3D. Por padrão, o primeiro valor é usado, a menos que você especifique o contrário. Por exemplo, se você arrastar o ícone de seleção da propriedade Rotação da camada A para a propriedade Escala da camada B, a seguinte expressão aparece:

Por padrão, esta expressão usa o primeiro valor da propriedade Escala, que é a largura. Se preferir usar o valor da altura, arraste o ícone de seleção diretamente para o segundo valor em vez do nome de propriedade, ou altere a expressão como se segue:

Inversamente, se você arrastar o ícone de seleção da propriedade Escala da camada B para a propriedade Rotação da camada A, o After Effects cria automaticamente uma variável, atribui o valor da propriedade Rotação unidimensional a ela e usa essa variável para ambas as dimensões da propriedade Escala:

No After Effects, muitas propriedades e métodos tomam ou retornam vetores. O After Effects refere-se a uma matriz como um vetor se representar um ponto ou a direção no espaço. Por exemplo, o After Effects descreve posição como o retorno de um vetor.

No entanto, embora uma função como audioLevels retorne um valor bidimensional (níveis de canal esquerdo e direito), não é chamada de vetor porque não representa um ponto ou uma direção. Algumas funções no After Effects aceitam argumentos de vetor, mas normalmente são úteis apenas quando os valores passados representam uma direção. Por exemplo, cross(vec1, vec2) calcula um terceiro vetor perpendicular aos vetores de entrada. O produto cruzado é útil quando vec1 e vec2 são dois vetores que representam instruções do espaço, mas não se apenas representam duas coleções arbitrárias de números.

A indexação dos elementos Camada, Efeito e Máscara no After Effects inicia em 1. Por exemplo, a primeira camada do painel Linha de tempo é camada(1).

Em geral, é melhor usar o nome de uma camada, efeito ou uma máscara em vez do número para evitar confusão e erros se a camada, efeito ou máscara são movidos, ou se os argumentos são alterados durante as atualizações do produto. Quando usar um nome, encerre-o sempre com aspas retas. Por exemplo, a primeira dessas expressões é mais fácil de entender do que a segunda expressão, e a primeira expressão continuará funcionando se você alterar a ordem de efeitos:

O tempo em uma expressão está sempre no tempo da composição (não tempo de camada) e é medido em segundos. O tempo padrão de todas as expressões é o tempo de composição atual no qual a expressão está sendo avaliada. As expressões a seguir usam ambas o tempo de composição padrão e retornam os mesmos valores:

Para usar um tempo relativo, adicione um valor de tempo incremental ao argumento tempo. Por exemplo, para obter o valor Posição 5 segundos antes do tempo atual, use a seguinte expressão:

As referências de tempo atual às propriedades em composições aninhadas usam o tempo de composição padrão original, não o tempo remapeado. Contudo, se você utilizar a função source para recuperar uma propriedade, o tempo remapeado é usado.

Por exemplo, se a origem de uma camada na composição de conteúdo estiver aninhada e na composição de conteúdo você tiver tempo remapeado, quando você obter os valores de posição com a seguinte expressão, os valores da posição usam o tempo padrão da composição:

Contudo, se você acessar a camada 1 usando a função source, os valores da posição usam o tempo remapeado:

Como as expressões operam no tempo em unidades de segundos (não quadros), às vezes é necessário usar métodos de conversão de tempo para converter os valores de tempo para executar operações em quadros. (Consulte Métodos de conversão de tempo (referência de expressão).)

Em caso de falha de avaliação da expressão, os erros de expressão aparecem em uma faixa de aviso no fim dos painéis Composição e Camada. O After Effects não desativa a expressão, mas continua a avaliá-la. A faixa de aviso é exibida enquanto ocorrer falha de avaliação da expressão, isto é, até ela ser corrigida ou desativada manualmente.

Exemplo de faixa de aviso de erro de expressão:

• Clique nos botões de seta Para a esquerda ou Para a direita a fim de exibir o erro de expressão anterior ou seguinte quando a expressão múltipla não conseguir avaliar.
• O botão Revelar expressão (lupa) expõe a propriedade com a expressão falha no painel Linha de tempo. Se a expressão estiver em uma composição diferente, essa composição abrirá.
• O botão Expandir/Recolher aviso (setas para cima/para baixo) mostra ou oculta o texto de erro.

O texto de erro de expressão tem apenas uma linha e é cortado de acordo com a largura do painel Composição.

Para exibir o texto completo de erro da expressão:

Clique  ao lado da expressão. O erro completo aparece na caixa de diálogo.

Para ocultar o aviso:

Selecione After Effects (Mac OS) ou Editar (Windows) > Preferências > Geral e desabilite Mostrar faixa de aviso quando o projeto tem expressões de erro.

Quando essa opção é desativada, a faixa de aviso permanece oculta mesmo quando novos erros de expressão ocorrem.

Reative essa opção para exibir os erros de expressão.