comp(name)

Tipo de valor devuelto: comp.

Tipo de argumento: name es una cadena.

Recupera otra composición por su nombre.

footage(name)

Tipo de valor devuelto: material de archivo.

Tipo de argumento: name es una cadena.

Recupera un elemento de material de archivo por el nombre.

thisComp

Tipo de valor devuelto: comp.

Representa la composición que contiene la expresión.

thisLayer

Tipo de valor devuelto: Capa, Luz o Cámara.

Representa la capa que contiene la expresión. Dado que thisLayer es el objeto predeterminado, su uso es opcional. Por ejemplo, puede iniciar una expresión con thisLayer.width o width y obtener el mismo resultado.

thisProperty

Tipo de valor devuelto: Propiedad.

Representa la propiedad que contiene la expresión. Por ejemplo, si escribe una expresión en la propiedad Rotación, puede iniciar una expresión con thisProperty para hacer referencia a la propiedad Rotación.

time

Tipo de valor devuelto: Número.

Representa el tiempo de la composición, en segundos, en el que se va a evaluar la expresión.

colorDepth

Tipo de valor devuelto: Número.

Devuelve el valor de profundidad de color del proyecto. Por ejemplo, colorDepth devuelve 16 cuando la profundidad de color del proyecto es de 16 bits por canal.

posterizeTime(framesPerSecond)

Tipo de valor devuelto: Número.

Tipo de argumento: framesPerSecond es un número.

El valor framesPerSecond se convierte en la velocidad de fotogramas a partir de la cual funciona el resto de la expresión. Esta expresión permite establecer que la velocidad de fotogramas de una propiedad sea más baja que la velocidad de fotogramas de la composición. Por ejemplo, la siguiente expresión actualiza el valor de la propiedad con un valor aleatorio una vez por segundo:

  posterizeTime(1); 
  random()

valor

Tipo de valor devuelto: Número, Conjunto o Cadena.

Representa el valor en el momento actual de la propiedad que contiene la expresión.

timeToFrames(t = time + thisComp.displayStartTime, fps = 1.0 / thisComp.frameDuration, isDuration = false)

Tipo de valor devuelto: Número.

Tipo de argumento: t y fps son números; isDuration es un valor booleano.

Convierte el valor de t, que se define de manera predeterminada en el tiempo de la composición actual, en un número entero de fotogramas. El número de fotogramas por segundo se especifica en el argumento fps, que se define de manera predeterminada en la velocidad de fotogramas de la composición actual (1.0 / thisComp.frameDuration). El argumento isDuration, que está definido como falso de manera predeterminada, debe ser verdadero si el valor t representa una diferencia entre dos tiempos en lugar de un tiempo absoluto. Los tiempos absolutos se redondean a la baja hacia el infinito negativo; las duraciones se redondean alejándose de cero (hacia arriba para valores positivos).

framesToTime(frames, fps = 1.0 / thisComp.frameDuration)

Tipo de valor devuelto: Número.

Tipo de argumento: frames y fps son números.

El inverso de timeToFrames. Devuelve el tiempo correspondiente al argumento frames, que es necesario. No es necesario que sea un número entero. Consulte timeToFrames para ver una explicación sobre el argumento fps.

timeToTimecode(t = time + thisComp.displayStartTime, timecodeBase = 30, isDuration = false)

Tipo de valor devuelto: Cadena.

Tipo de argumento: t y timecodeBase son números; isDuration es un valor booleano.

Convierte el valor de t en una cadena que representa un código de tiempo. Consulte timeToFrames para ver una explicación de los argumentos t e isDuration. El valor timecodeBase, que se define en 30 de manera predeterminada, especifica el número de fotogramas por segundo.

timeToNTSCTimecode(t = time + thisComp.displayStartTime, ntscDropFrame = false, isDuration = false)

Tipo de valor devuelto: Cadena.

Tipo de argumento: t es un número, ntscDropFrame e isDuration son valores booleanos.

Convierte t en una cadena que representa el código de tiempo NTSC. Consulte timeToFrames para ver una explicación de los argumentos t e isDuration. Si ntscDropFrame es falso (valor predeterminado), la cadena resultante es un código de tiempo sin eliminación de fotogramas NTSC. Si ntscDropFrame es verdadero, la cadena resultante es un código de tiempo con eliminación de fotogramas NTSC.

timeToFeetAndFrames(t = time + thisComp.displayStartTime, fps = 1.0 / thisComp.frameDuration, framesPerFoot = 16, isDuration = false)

Tipo de valor devuelto: Cadena.

Tipo de argumento: t, fps y framesPerFoot son números; isDuration es un valor booleano.

Convierte el valor de t en una cadena que representa pies de película y fotogramas. Consulte timeToFrames para ver una explicación de los parámetros t, fps e isDuration. El argumento framesPerFoot especifica el número de fotogramas en un pie de película. Se define en 16 de manera predeterminada, que es la velocidad más común para material de archivo de 35 mm.

timeToCurrentFormat(t = time + thisComp.displayStartTime, fps = 1.0 / thisComp.frameDuration, isDuration = false)

Tipo de valor devuelto: Cadena.

Tipo de argumento: t y fps son números; isDuration es un valor booleano.

Convierte el valor de t en una cadena que representa el tiempo en el formato de visualización actual de Ajustes del proyecto. Consulte timeToFrames para obtener una definición de todos los argumentos.

Se ha agregado un argumento opcional ntscDropFrame a la función timeToCurrentFormat() en After Effects CS5.5 y posterior. Opción predeterminada: ntscDropFrame = thisComp.ntscDropFrame.

Si desea ejercer un mayor control sobre el aspecto del código de tiempo del material de archivo, utilice el método timeToCurrentFormat u otros métodos timeTo para generar el código de tiempo en lugar de utilizar el efecto Código de tiempo o Números. Cree una capa de texto, agregue una expresión a la propiedad Texto de origen e introduzca timeToCurrentFormat en el campo de expresión. Con este método, puede dar formato y animar el texto de código de tiempo. Asimismo, el código de tiempo utiliza el mismo estilo de visualización definido en los ajustes actuales del proyecto.

Las funciones matemáticas vectoriales son métodos globales que realizan operaciones en conjuntos, tratándolos como vectores matemáticos. A diferencia de los métodos JavaScript integrados, como Math.sin, estos métodos no utilizan el prefijo Math. A menos que se especifique lo contrario, los métodos matemáticos vectoriales no son estrictos con las dimensiones, devuelven un valor que es la dimensión del objeto Conjunto de entrada más grande y los elementos que faltan se rellenan con ceros. Por ejemplo, la expresión add([10, 20], [1, 2, 3]) devuelve [11, 22, 3].

El sitio web de JJ Gifford proporciona explicaciones y ejemplos que muestran cómo utilizar geometría y trigonometría simple con expresiones.

Chris y Trish Meyer incluyen información adicional sobre los conjuntos y métodos matemáticos vectoriales en un artículo en el sitio web ProVideo Coalition (en inglés).

add(vec1, vec2)

Tipo de valor devuelto: conjunto.

Tipo de argumento: vec1 y vec2 son conjuntos.

Agrega dos vectores.

sub(vec1, vec2)

Tipo de valor devuelto: conjunto.

Tipo de argumento: vec1 y vec2 son conjuntos.

Resta dos vectores.

mul(vec, amount)

Tipo de valor devuelto: conjunto.

Tipo de argumento: vec es un conjunto, amount es un número.

Multiplica cada elemento del vector por la cantidad.

div(vec, amount)

Tipo de valor devuelto: conjunto.

Tipo de argumento: vec es un conjunto, amount es un número.

Divide cada elemento del vector entre la cantidad.

clamp(value, limit1, limit2)

Tipo de valor devuelto: número o conjunto.

Tipo de argumento: value, limit1 y limit2 son números o conjuntos.

El valor de cada componente de value debe encontrarse entre los valores correspondientes de limit1 y limit2.

Chris y Trish Meyer proporcionan información adicional sobre el método clamp en un artículo en el sitio web ProVideo Coalition (en inglés).

dot(vec1, vec2)

Tipo de valor devuelto: Número.

Tipo de argumento: vec1 y vec2 son conjuntos.

Devuelve el producto de puntos (interior) de los argumentos vectoriales.

cross(vec1, vec2)

Tipo de valor devuelto: conjunto [2 ó 3].

Tipo de argumento: vec1 y vec2 son conjuntos [2 ó 3].

Devuelve el producto vectorial cruzado de vec1 y vec2. Si desea obtener más información, consulte una referencia matemática o una guía de JavaScript.

normalize(vec)

Tipo de valor devuelto: conjunto.

Tipo de argumento: vec es un conjunto.

Normaliza el vector para que su longitud sea de 1,0. El uso del método normalize es un modo rápido de realizar la operación div(vec, length(vec)).

length(vec)

Tipo de valor devuelto: Número.

Tipo de argumento: vec es un conjunto.

Devuelve la longitud del vector vec.

length(point1, point2)

Tipo de valor devuelto: Número.

Tipo de argumento: point1 y point2 son conjuntos.

Devuelve la distancia entre dos puntos. El argumento point2 es opcional. Por ejemplo, length(point1, point2) es lo mismo que length(sub(point1, point2)).

Por ejemplo, añada esta expresión a la propiedad Focus Distance (Distancia de enfoque) de una cámara para bloquear el plano focal en el punto de interés de la cámara de modo que este punto esté enfocado:

  length(position, pointOfInterest)

lookAt(fromPoint, atPoint)

Tipo de valor devuelto: conjunto [3].

Tipo de argumento: fromPoint y atPoint son conjuntos [3].

El argumento fromPoint es la ubicación en el espacio del entorno de la capa que se desea orientar. El argumento atPoint es el punto en el espacio del entorno al que desea que apunte la capa. El valor devuelto se puede utilizar como una expresión de la propiedad Orientación, haciendo que el eje z de la capa señale a atPoint. Este método es especialmente útil para cámaras y luces. Si utiliza esta expresión en una cámara, desactive la orientación automática. Por ejemplo, esta expresión de la propiedad Orientación de una luz concentrada hace que la luz señale hacia el punto de anclaje de la capa número 1 de la misma composición: lookAt(position, thisComp.layer(1).position)

seedRandom(offset, timeless=false)

Tipo de valor devuelto: ninguno.

Tipo de argumento: offset es un Número, timeless es un Valor booleano.

Los métodos random y gaussRandom utilizan un valor de raíz que controla la secuencia de números. De forma predeterminada, la raíz se computa como una función de un identificador de capa único, la propiedad en la capa, el tiempo actual y un valor de desplazamiento de 0. Utilice seedRandom para establecer el desplazamiento en un valor distinto a 0 y crear una secuencia aleatoria diferente.

Utilice true para el argumento timeless para no utilizar el tiempo actual como entrada a la raíz aleatoria. El uso de true para el argumento timeless permite generar un número aleatorio que no varía dependiendo del tiempo de evaluación.

El valor offset, y no timeless, también se utiliza para controlar el valor inicial de la función wiggle.

Por ejemplo, esta expresión de la propiedad Opacidad establece el valor Opacidad en un valor aleatorio que no varía con el tiempo:

  seedRandom(123456, true); 
  random()*100

La multiplicación por 100 en este ejemplo convierte el valor entre 0 y 1 devuelto por el método random en un número entre 0 y 100; este rango suele ser más útil para la propiedad Opacidad, que tiene valores de 0% a 100%.

random()

Tipo de valor devuelto: Número.

Devuelve un número aleatorio entre 0–1.

En After Effects CS6, el comportamiento de random() se ha cambiado para ser más aleatorio cuando los ID de capa están próximos entre sí. La expresión wiggle() no resulta afectada.

random(maxValOrArray)

Tipo de valor devuelto: número o conjunto.

Tipo de argumento: maxValOrArray es un número o un conjunto.

Si maxValOrArray es un número, este método devuelve un número en el rango de 0 a maxValOrArray. Si maxValOrArray es un conjunto, este método devuelve un conjunto con la misma dimensión que maxValOrArray, donde cada componente varía entre 0 y el componente correspondiente de maxValOrArray.

random(minValOrArray, maxValOrArray)

Tipo de valor devuelto: número o conjunto.

Tipo de argumento: minValOrArray y maxValOrArray son números o conjuntos.

Si minValOrArray y maxValOrArray son números, este método devuelve un número en el rango de minValOrArray a maxValOrArray. Si los argumentos son conjuntos, este método devuelve un conjunto con la misma dimensión que el argumento de dimensión mayor, con cada componente en el rango desde el componente correspondiente de minValOrArray al componente correspondiente de maxValOrArray. Por ejemplo, la expresión random([100, 200], [300, 400]) devuelve un conjunto cuyo primer valor está en el rango 100–300 y cuyo segundo valor se encuentra entre 200–400. Si las dimensiones de los dos conjuntos de entrada no coinciden, los valores de mayor dimensión del conjunto más corto se rellenarán con ceros.

gaussRandom()

Tipo de valor devuelto: Número.

Devuelve un número aleatorio. Los resultados tienen una distribución gaussiana (acampanada). Aproximadamente el 90% de los resultados está en el rango de 0–1 y el 10% restante está fuera de este rango.

gaussRandom(maxValOrArray)

Tipo de valor devuelto: número o conjunto.

Tipo de argumento: maxValOrArray es un número o un conjunto.

Cuando maxValOrArray es un número, este método devuelve un número aleatorio. Aproximadamente el 90% de los resultados está en el rango de 0 a maxValOrArray y el 10% restante está fuera de este rango. Cuando maxValOrArray es un conjunto, este método devuelve un conjunto de valores aleatorios, con la misma dimensión que maxValOrArray. El 90% de los valores está en el rango de 0 a maxValOrArray y el 10% restante está fuera de este rango. Los resultados tienen una distribución gaussiana (acampanada).

gaussRandom(minValOrArray, maxValOrArray)

Tipo de valor devuelto: número o conjunto.

Tipo de argumento: minValOrArray y maxValOrArray son números o conjuntos.

Si minValOrArray y maxValOrArray son números, este método devuelve un número aleatorio. Aproximadamente el 90% de los resultados está en el rango de minValOrArray a maxValOrArray y el 10% restante está fuera de este rango. Si los argumentos son conjuntos, este método devuelve un conjunto de números aleatorios con la misma dimensión que el argumento de mayor dimensión. Para cada componente, aproximadamente el 90% de los resultados están en el rango desde el componente correspondiente de minValOrArray al componente correspondiente de maxValOrArray y el 10% restante está fuera de este rango. Los resultados tienen una distribución gaussiana (acampanada).

noise(valOrArray)

Tipo de valor devuelto: Número.

Tipo de argumento: valOrArray es un número o un conjunto [2 ó 3].

Devuelve un número en el rango de -1 a 1. El ruido no es realmente aleatorio; se basa en el ruido Perlin, lo que significa que los valores devueltos para los dos valores de entrada que están cerca entre sí también tienden a estar cerca el uno del otro. Este tipo de ruido resulta útil cuando se desea una secuencia de números aparentemente aleatorios que no varíen mucho de uno a otro, como es habitual en el caso de la animación de cualquier tipo de movimiento natural aparentemente aleatorio. Ejemplo: rotation + 360*noise(time)

Para todos los métodos de interpolación, el argumentot es a menudotiempo o valor, aunque puede tener otros valores en lugar de estos. Si t es tiempo, la interpolación entre los valores ocurre sobre una duración. Si t es valor, la expresión asigna un rango de valores a un nuevo rango de valores.

Para obtener explicaciones y ejemplos adicionales de los métodos de interpolación, consulte el sitio web de JJ Gifford.

Chris y Trish Meyer ofrecen ejemplos e información adicional para estos métodos en un artículo en el sitio web ProVideo Coalition (en inglés).

Ian Haigh proporciona una secuencia de comandos en el sitio webAfter Effects Scripts que se puede emplear para aplicar fácilmente expresiones del método de interpolación avanzadas como, por ejemplo, rebotes, a las propiedades.

Andrew Devis proporciona un par de tutoriales de vídeo en el sitio Web de Creative COW que muestran con detalle cómo utilizar el método de expresión lineal junto con el comando Convertir audio en fotogramas clave.

linear(t, tMin, tMax, value1, value2)

Tipo de valor devuelto: número o conjunto.

Tipo de argumento: t, tMin y tMax son números y value1 y value2 son números o conjuntos.

Devuelve value1 si t <= tMin. Devuelve value2 si t >= tMax. Devuelve una interpolación lineal entre value1 y value2 si tMin < t < tMax.

Por ejemplo, esta expresión sobre la propiedad Opacidad hace que los valores de Opacidad aumenten linealmente del 20% al 80% durante el tiempo comprendido entre 0 y 6 segundos:

  linear(time, 0, 6, 20, 80)

Este método (al igual que todos los métodos de interpolación) también se puede emplear para convertir de un rango de valores en otro. Por ejemplo, esta expresión sobre la propiedad Opacidad convierte los valores de Opacidad de 0%-100% al rango 20%- 80%:

  linear(value, 0, 100, 20, 80)

linear(t, value1, value2)

Tipo de valor devuelto: número o conjunto.

Tipo de argumento: t es un número y value1 y value2 son números o conjuntos.

Devuelve un valor que se interpola linealmente desde value1 a value2 a medida que t varía entre 0 y 1. Devuelve value1 si t <= 0. Devuelve value2 si t >= 1.

ease(t, value1, value2)

Tipo de valor devuelto: número o conjunto.

Tipo de argumento: t es un número y value1 y value2 son números o conjuntos.

Similar a linear con los mismos argumentos, excepto que la interpolación facilita la entrada y la salida para que la velocidad sea 0 en los puntos inicial y final. Mediante este método se obtiene una animación suave.

ease(t, tMin, tMax, value1, value2)

Tipo de valor devuelto: número o conjunto.

Tipo de argumento: t, tMin y tMax son números y value1 y value2 son números o conjuntos.

Similar a linear con los mismos argumentos, excepto que la interpolación facilita la entrada y la salida para que la velocidad sea 0 en los puntos inicial y final. Mediante este método se obtiene una animación suave.

easeIn(t, value1, value2)

Tipo de valor devuelto: número o conjunto.

Tipo de argumento: t es un número y value1 y value2 son números o conjuntos.

Similar a ease, excepto que la tangente es 0 solo en el lado de value1 y la interpolación es lineal en el lado de value2.

easeIn(t, tMin, tMax, value1, value2)

Tipo de valor devuelto: número o conjunto.

Tipo de argumento: t, tMin y tMax son números y value1 y value2 son números o conjuntos.

Similar a ease, excepto que la tangente es 0 solo en el lado de tMin y la interpolación es lineal en el lado de tMax.

easeOut(t, value1, value2)

Tipo de valor devuelto: número o conjunto.

Tipo de argumento: t es un número y value1 y value2 son números o conjuntos.

Similar a ease, excepto que la tangente es 0 solo en el lado de value1 y la interpolación es lineal en el lado de value2.

easeOut(t, tMin, tMax, value1, value2)

Tipo de valor devuelto: número o conjunto.

Tipo de argumento: t, tMin y tMax son números y value1 y value2 son números o conjuntos.

Similar a ease, excepto que la tangente es 0 solo en el lado de tMin y la interpolación es lineal en el lado de tMax.

Harry Frank ofrece un tutorial de vídeo en su sitio web graymachine que muestra cómo utilizar estos métodos de conversión de color para cambiar el color de las ondas producidas por el efecto Ondas de radio.

rgbToHsl(rgbaArray)

Tipo de valor devuelto: conjunto [4].

Tipo de argumento: rgbaArray es un conjunto [4].

Convierte un color del espacio RGBA al espacio HSLA. La entrada es un Conjunto de valores de los canales rojo, verde, azul y alfa normalizados, todos en el rango de 0,0 a 1,0. El valor obtenido es un Conjunto de valores de los canales de tono, saturación, luminosidad y alfa, también en el rango de 0,0 a 1,0. Ejemplo:

  rgbToHsl.effect("Change Color")("Color To Change")

hslToRgb(hslaArray)

Tipo de valor devuelto: conjunto [4].

Tipo de argumento: hslaArray es un conjunto [4].

Convierte un color del espacio HSLA al espacio RGBA. Esta conversión es el proceso inverso de la conversión realizada con el método rgbToHsl.

Chris y Trish Meyer incluyen información adicional sobre estos métodos en un artículo en el sitio web ProVideo Coalition (en inglés).

degreesToRadians(degrees)

Tipo de valor devuelto: Número.

Tipo de argumento: grados es un número.

Convierte los grados en radianes.

radiansToDegrees(radians)

Tipo de valor devuelto: Número.

Tipo de argumento: radianes es un número.

Convierte los radianes en grados.

layer(index)

Tipo de valor devuelto: Capa, Luz o Cámara.

Tipo de argumento: index es un número.

Recupera la capa por el número (orden en el panel Línea de tiempo). Ejemplo: thisComp.layer(3)

layer(nombre)

Tipo de valor devuelto: Capa, Luz o Cámara.

Tipo de argumento: name es una cadena.

Recupera la capa por el nombre. Los nombres se clasifican en función del nombre de capa o de origen, si no existe nombre de capa. Si existen nombres duplicados, After Effects utiliza el primero (posición más alta) del panel Línea de tiempo. Ejemplo:

  thisComp.layer("Solid 1")

layer(otherLayer, relIndex)

Tipo de valor devuelto: Capa, Luz o Cámara.

Tipo de argumento: otherLayer es un objeto de capa y relIndex es un número.

Recupera la capa que está relIndex capas por encima o por debajo de otherLayer. Por ejemplo, thisComp.layer(thisLayer, 1).active devuelve verdadero si la siguiente capa en el panel Línea de tiempo está activa.

marcador

Tipo de valor devuelto: MarkerProperty.

Importante: No puede acceder a un marcador de composición mediante un número de marcador. Si ha creado un proyecto en una versión anterior de After Effects que utiliza números de marcador de composición en expresiones, debe cambiarlos para utilizar marker.key(name). Debido a que el nombre predeterminado de un marcador de composición es un número, para la conversión de la referencia para que utilice el nombre solo suele ser necesario poner el número entre comillas.

marker.key(index)

Tipo de valor devuelto: MarkerKey.

Tipo de argumento: index es un número.

Devuelve el objeto MarkerKey del marcador con el índice especificado. El índice hace referencia al orden del marcador en el tiempo de composición, no al nombre del marcador. Por ejemplo, esta expresión devuelve el tiempo del primer marcador de composición:

  thisComp.marker.key(1).time

marker.key(name)

Tipo de valor devuelto: MarkerKey.

Tipo de argumento: name es una cadena.

Devuelve el objeto MarkerKey del marcador con el nombre especificado. El valor name es el nombre del marcador, tal como se escribió en el campo Comentario del cuadro de diálogo del marcador; por ejemplo, marker.key("1"). Para un marcador de composición, el nombre predeterminado es un número. Si más de un marcador en la composición tienen el mismo nombre, el método devuelve el marcador que sucede primero en el tiempo (en tiempo de composición). El valor de una clave de marcador es una cadena, no un número. Por ejemplo, esta expresión devuelve el tiempo del marcador de composición con el nombre "0":

  thisComp.marker.key("0").time

marker.nearestKey(t)

Tipo de valor devuelto: MarkerKey.

Tipo de argumento: t es un número.

Devuelve el marcador que esté más cercano en el tiempo a t. Por ejemplo, esta expresión devuelve el tiempo del marcador de composición más cercano en el tiempo a 1 segundo:

  thisComp.marker.nearestKey(1).time

Esta expresión devuelve el tiempo del marcador de composición más cercano al tiempo actual:

  thisComp.marker.nearestKey(time).time

marker.numKeys

Tipo de valor devuelto: Número.

Devuelve el número total de marcadores de composición en la composición.

numLayers

Tipo de valor devuelto: Número.

Devuelve el número de capas de la composición.

activeCamera

Tipo de valor devuelto: cámara.

Devuelve el objeto Cámara de la cámara a través de la cual se procesa la composición en el fotograma actual. La cámara no es necesariamente por la que se mira en el panel Composición.

width

Tipo de valor devuelto: Número.

Devuelve la anchura de la composición en píxeles.

Aplique la siguiente expresión a la propiedad Posición de una capa para centrar la capa en el fotograma de composición:

  [thisComp.width/2, thisComp.height/2]

height

Tipo de valor devuelto: Número.

Devuelve al altura de la composición en píxeles.

duration

Tipo de valor devuelto: Número.

Devuelve la duración de la composición en segundos.

ntscDropFrame

Tipo de valor devuelto: booleano.

Devuelve true si el código de tiempo está en el formato de fotograma eliminado (After Effects CS 5.5 y posterior).

displayStartTime

Tipo de valor devuelto: Número.

Devuelve el tiempo de inicio de la composición en segundos.

frameDuration

Tipo de valor devuelto: Número.

Devuelve la duración de un fotograma, en segundos.

shutterAngle

Tipo de valor devuelto: Número.

Devuelve el valor del ángulo del obturador de la composición en grados.

shutterPhase

Tipo de valor devuelto: Número.

Devuelve la fase del obturador de la composición en grados.

bgColor

Tipo de valor devuelto: conjunto [4].

Devuelve el color de fondo de la composición.

pixelAspect

Tipo de valor devuelto: Número.

Devuelve la proporción de aspecto de píxeles de la composición.

nombre

Tipo de valor devuelto: Cadena.

Devuelve el nombre de la composición.

Para utilizar un elemento de material de archivo del panel Proyecto como un objeto en una expresión, utilice el método global footage, como en footage("file_name"). También puede acceder a un objeto de material de archivo mediante el atributo source en una capa cuyo origen sea un elemento de material de archivo.

width

Tipo de valor devuelto: Número.

Devuelve la anchura del elemento de material de archivo, en píxeles.

height

Tipo de valor devuelto: Número.

Devuelve la altura del elemento de material de archivo, en píxeles.

duration

Tipo de valor devuelto: Número.

Devuelve la duración del elemento de material de archivo, en segundos.

frameDuration

Tipo de valor devuelto: Número.

Devuelve la duración de un fotograma en el elemento de material de archivo, en segundos.

ntscDropFrame

Tipo de valor devuelto: booleano.

Devuelve true si el código de tiempo está en el formato de fotograma eliminado (After Effects CS5.5 y posterior).

pixelAspect

Tipo de valor devuelto: Número.

Devuelve la proporción de aspecto de píxeles del material de archivo.

name

Tipo de valor devuelto: Cadena.

Devuelve el nombre del elemento de material de archivo tal y como se muestra en el panel Proyecto.

source

Tipo de valor devuelto: comp o material de archivo.

Devuelve el objeto Comp o Material de archivo de origen de la capa. El tiempo predeterminado se ajusta al tiempo del origen. Ejemplo: source.layer(1).position

sourceTime(t = time)

Tipo de valor devuelto: Número.

Devuelve el origen de capa correspondiente al tiempo t (After Effects CS5.5 y posterior).

effect(name)

Tipo de valor devuelto: Efecto.

Tipo de argumento: name es una cadena.

After Effects busca el efecto por su nombre en el panel Controles de efectos. El nombre puede ser el nombre predeterminado o el nombre definido por el usuario. Si varios efectos tienen el mismo nombre, se utiliza el efecto más cercano a la parte superior del panel Controles de efectos. Ejemplo:

  effect("Fast Blur")("Blurriness")

effect(index)

Tipo de valor devuelto: Efecto.

Tipo de argumento: index es un número.

After Effects busca el efecto en su índice del panel Controles de efectos, partiendo de 1 y continuando hacia abajo desde el principio.

mask(name)

Tipo de valor devuelto: Máscara.

Tipo de argumento: name es una cadena.

El nombre puede ser el nombre predeterminado o el nombre definido por el usuario. Si varias máscaras tienen el mismo nombre, se utiliza la primera (superior). Ejemplo:

  mask("Mask 1")

mask(index)

Tipo de valor devuelto: Máscara.

Tipo de argumento: index es un número.

After Effects busca la máscara por su índice en el panel Línea de tiempo, a partir de 1 hacia abajo desde el principio.

width

Tipo de valor devuelto: Número.

Devuelve la anchura de la capa, en píxeles. Es el mismo que source.width.

height

Tipo de valor devuelto: Número.

Devuelve la altura de la capa, en píxeles. Es el mismo que source.height.

index

Tipo de valor devuelto: Número.

Devuelve el número de índice de la capa de la composición.

parent

Tipo de valor devuelto: Capa, Luz o Cámara.

Devuelve el objeto Capa primario de la capa, si lo hay. Ejemplo: position[0] + parent.width

hasParent

Tipo de valor devuelto: booleano.

Devuelve verdadero si la capa tiene una capa primaria y falso si no la tiene.

Utilice el atributo hasParent para determinar si una capa tiene una capa primaria. Puede utilizar este atributo aunque la capa no tenga ninguna capa primaria en ese momento. Por ejemplo, la siguiente expresión indica que la capa a la que se aplica se ondulará según la posición de su capa primaria. Si la capa no dispone de capa primaria, se ondulará según su propia posición. Si la capa cuenta con capa primaria, el comportamiento de la capa cambia en consecuencia:

  idx = index; 
  if (hasParent) { 
    idx = parent.index; 
  } 
  thisComp.layer(idx).position.wiggle(5,20)

inPoint

Tipo de valor devuelto: Número.

Devuelve el punto de entrada de la capa, en segundos.

Nota: Por lo general, el valor de outPoint es mayor que el valor deinPoint. Sin embargo, si una capa se cambia en el tiempo, el valor de inPoint será mayor que el valor de outPoint. Del mismo modo, el valor de startTime puede ser mayor que el valor de inPoint.

outPoint

Tipo de valor devuelto: Número.

Devuelve el punto de salida de la capa, en segundos.

startTime

Tipo de valor devuelto: Número.

Devuelve la hora de inicio de la capa, en segundos.

hasVideo

Tipo de valor devuelto: booleano.

Devuelve verdadero si la capa tiene vídeo y falso si no lo tiene.

hasAudio

Tipo de valor devuelto: booleano.

Devuelve verdadero si la capa tiene audio y falso si no lo tiene.

active

Tipo de valor devuelto: booleano.

Devuelve true si el definidor de vídeo está activado para la capa y el tiempo actual está en el rango de Punto de inicio de la capa a Punto final de la capa; de lo contrario, devuelve false.

enabled

Tipo de valor devuelto: booleano.

Devuelve el valor true si el conmutador de vídeo  está activado para la capa; de lo contrario, se devuelve false.

audioActive

Tipo de valor devuelto: booleano.

Devuelve true si el definidor de audio  está activado para la capa y el tiempo actual está en el rango de Punto de inicio de la capa a Punto final de la capa; de lo contrario, devuelve false.

sampleImage(point, radius = [.5, .5], postEffect=true, t=time)

Tipo de valor devuelto: conjunto [4].

Tipo de argumento: point es un Conjunto [2], radius es un Conjunto [2], postEffect es un valor booleano y t es un número.

Muestrea los valores de color y de canal alfa de una capa y devuelve el promedio del valor de peso de alfa de los píxeles dentro de la distancia especificada del punto como un conjunto: [ rojo, verde, azul, alfa]. Si postEffect es verdadero, los valores muestreados son para la capa después de que las máscaras y los efectos se hayan procesado. Si postEffect es falso, los valores muestreados son para la capa antes de que las máscaras y los efectos se hayan procesado. El valor de entrada point está en espacio de capa, el punto [0,0] es el centro del píxel de la parte superior izquierda de la capa. El valor de entrada radius especifica la distancia horizontal y vertical desde el centro de la muestra hasta los bordes del rectángulo muestreado. El valor predeterminado muestrea un píxel.

Nota: El parámetro postEffect hace referencia a los efectos aplicados directamente a la capa, no a los efectos aplicados indirectamente, como con una capa de ajuste.

Este ejemplo muestrea un rectángulo de 4 píxeles de ancho y 3 píxeles de alto, centrado alrededor de un punto 100 píxeles hacia abajo y hacia la derecha de la esquina superior izquierda de la capa:

  thisComp.layer(1).sampleImage([100, 100], [2, 1.5])

Dan Ebberts incluye un ejemplo de cómo utilizar el método sampleImage en su sitio web Motionscript.

El foro de AE Enhancers proporciona una expresión que utiliza el método sampleImage para medir una capa de texto o capa de forma y determinar su cuadro delimitador eficaz.

Todd Kopriva proporciona instrucciones para el uso del método sampleImage y el efecto de control de puntos para controlar los colores de un punto especificado durante la corrección de color en su blog After Effects Region of Interest.

Cuando se agregan máscaras, efectos, pintura o texto a una capa, After Effects agrega nuevas propiedades en el panel Línea de tiempo. Son muchas las propiedades que deberíamos incluir aquí, por ello recomendamos que utilice el icono espiral para conocer la sintaxis y poder hacer referencia a ellas en las expresiones.

anchorPoint

Tipo de valor devuelto: propiedad [2 ó 3].

Devuelve el valor de punto de anclaje de la capa en el sistema de coordenadas de la capa (espacio de capa).

position

Tipo de valor devuelto: propiedad [2 ó 3].

Devuelve el valor de posición de la capa, en el espacio de entorno si la capa no tiene primaria. Si la capa tiene primaria, devuelve el valor de posición de la capa en el sistema de coordenadas de la capa primaria (en el espacio de capa de la capa primaria).

escala

Tipo de valor devuelto: propiedad [2 ó 3].

Devuelve el valor de escala de la capa, expresado como porcentaje.

rotación

Tipo de valor devuelto: Propiedad.

Devuelve el valor de giro de la capa en grados. Para una capa 3D, devuelve el valor de giro z en grados.

opacidad

Tipo de valor devuelto: Propiedad.

Devuelve el valor de opacidad de la capa, expresado como porcentaje.

audioLevels

Tipo de valor devuelto: propiedad [2].

Devuelve el valor de la propiedad Niveles de audio de la capa en decibelios. Se trata de un valor 2D; el primer valor representa el canal de audio izquierdo y el segundo valor al derecho. El valor no es la amplitud de la pista de audio del material de origen. Por el contrario, se trata del valor de la propiedad Niveles de audio, que se puede ver afectado por los fotogramas clave.

timeRemap

Tipo de valor devuelto: Propiedad.

Devuelve el valor de la propiedad Reasignación de tiempo en segundos, si está habilitada.

marker.key(index)

Tipo de valor devuelto: MarkerKey.

Tipo de argumento: index es un número.

Devuelve el objeto MarkerKey del marcador de capa con el índice especificado.

marker.key(name)

Tipo de valor devuelto: MarkerKey.

Tipo de argumento: name es una cadena.

Devuelve el objeto MarkerKey del marcador de capa con el nombre especificado. El valor name es el nombre del marcador, tal como se escribió en el campo Comentario del cuadro de diálogo del marcador; por ejemplo, marker.key("ch1"). Si más de un marcador en una capa tienen el mismo nombre, este método devuelve el marcador que suceda en primer lugar (en el tiempo de capa). El valor de una clave de marcador es una cadena, no un número.

Esta expresión sobre una propiedad aumenta el valor de la propiedad de 0 a 100 entre dos marcadores identificados por el nombre:

  m1 = marker.key("Start").time; 
  m2 = marker.key("End").time;  
  linear(time, m1, m2, 0, 100);

marker.nearestKey(t)

Tipo de valor devuelto: MarkerKey.

Tipo de argumento: t es un número.

Devuelve el marcador de capa más cercano en el tiempo a t. Por ejemplo, esta expresión devuelve el tiempo del marcador en la capa más cercana en tiempo a 1 segundo:

  marker.nearestKey(1).time

Esta expresión devuelve el tiempo del marcador en la capa más cercana al tiempo actual:

  marker.nearestKey(time).time

marker.numKeys

Tipo de valor devuelto: Número.

Devuelve el número total de marcadores en la capa.

name

Tipo de valor devuelto: Cadena.

Devuelve el nombre de la capa.

orientation

Tipo de valor devuelto: propiedad [3].

Devuelve el valor de orientación 3D, en grados, de una capa 3D.

rotationX

Tipo de valor devuelto: Propiedad.

Devuelve el valor de giro x, en grados, de una capa 3D.

rotationY

Tipo de valor devuelto: Propiedad.

Devuelve el valor de giro y, en grados, de una capa 3D.

rotationZ

Tipo de valor devuelto: Propiedad.

Devuelve el valor de giro z, en grados, de una capa 3D.

lightTransmission

Tipo de valor devuelto: Propiedad.

Devuelve el valor de la propiedad Transmisión de la luz de una capa 3D.

castsShadows

Tipo de valor devuelto: Propiedad.

Devuelve un valor de 1.0 si la capa proyecta sombras.

acceptsShadows

Tipo de valor devuelto: Propiedad.

Devuelve un valor de 1.0 si la capa acepta sombras.

acceptsLights

Tipo de valor devuelto: Propiedad.

Devuelve un valor de 1.0 si la capa acepta luces.

ambient

Tipo de valor devuelto: Propiedad.

Devuelve el valor del componente de ambiente como porcentaje.

diffuse

Tipo de valor devuelto: Propiedad.

Devuelve el valor del componente de difusión como porcentaje.

specular

Tipo de valor devuelto: Propiedad.

Devuelve el valor del componente especular como porcentaje.

shininess

Tipo de valor devuelto: Propiedad.

Devuelve el valor del componente de brillo como porcentaje.

metal

Tipo de valor devuelto: Propiedad.

Devuelve el valor del componente de metal como porcentaje.

Utilice los métodos de transformación de espacio de capa para transformar los valores de un espacio a otro, como del espacio de capa al espacio de entorno. Los métodos “de” transforman valores del espacio de capa al espacio con nombre (composición o entorno). Los métodos “a” transforman valores del espacio con nombre (composición o entorno) al espacio de capa. Cada método de transformación utiliza un argumento opcional para determinar el tiempo en el que se calcula la transformación; sin embargo, casi siempre se puede utilizar el tiempo actual (predeterminado).

Utilice los métodos de transformación “Vec” cuando desee transformar un vector de dirección, como la diferencia entre dos valores de posición. Utilice los métodos de transformación sencillos (no ”Vec”) para transformar un punto, como una posición. El espacio de composición (comp.) y de entorno es el mismo para las capas 2D. Sin embargo, en el caso de las capas 3D, el espacio de composición depende de la cámara activa y el espacio de entorno es independiente de la cámara.

Chris y Trish Meyer ofrecen información adicional sobre estos métodos en un artículo en el sitio web ProVideo Coalition (en inglés).

toComp(point, t=time)

Tipo de valor devuelto: conjunto [2 ó 3].

Tipo de argumento: point es un conjunto [2 ó 3] y t es un número.

Transforma un punto del espacio de capa al espacio de composición.

fromComp(point, t=time)

Tipo de valor devuelto: conjunto [2 ó 3].

Tipo de argumento: point es un conjunto [2 ó 3] y t es un número.

Transforma un punto del espacio de composición al espacio de capa. El punto resultante en una capa 3D puede tener un valor distinto de cero aunque esté en el espacio de capa. Ejemplo: fromComp(thisComp.layer(2).position)

toWorld(point, t=time)

Tipo de valor devuelto: conjunto [2 ó 3].

Tipo de argumento: point es un conjunto [2 ó 3] y t es un número.

Transforma un punto del espacio de capa al espacio de entorno independiente de la vista. Ejemplo:

  toWorld.effect("Bulge")("Bulge Center")

Dan Ebberts incluye una expresión en su sitio web MotionScript que utiliza el método toWorld para orientar de forma automática una capa a lo largo únicamente de un eje. Por ejemplo, esto resulta útil a la hora de cambiar de posición los caracteres de lado a lado de modo que sigan a la cámara mientras permanecen verticales.

Carl Larsen ofrece un par de tutoriales de vídeo en el sitio web Creative COW en los que se explican los principios básicos de la asociación y posteriormente se utiliza una expresión que implica al método toWorld para trazar la ruta de una capa secundaria:

• Parte 1

• Parte 2

Rich Young ofrece un conjunto de expresiones en su sitio web AE Portal (en inglés) que utilizan el método toWorld para vincular una cámara y luz a una capa con el efecto Esfera CC.

fromWorld(point, t=time)

Tipo de valor devuelto: conjunto [2 ó 3].

Tipo de argumento: point es un conjunto [2 ó 3] y t es un número.

Transforma un punto del espacio de entorno al espacio de capa. Ejemplo: fromWorld(thisComp.layer(2).position)

Consulte Ejemplo de expresión: Creación de un abombado entre dos capas para obtener un ejemplo de cómo se puede utilizar este método.

toCompVec(vec, t=time)

Tipo de valor devuelto: conjunto [2 ó 3].

Tipo de argumento: vec es un conjunto [2 ó 3] y t es un número.

Transforma un vector del espacio de capa al espacio de composición. Ejemplo: toCompVec([1,0])

fromCompVec(vec, t=time)

Tipo de valor devuelto: conjunto [2 ó 3].

Tipo de argumento: vec es un conjunto [2 ó 3] y t es un número.

Transforma un vector del espacio de composición al espacio de capa. Ejemplo (capa 2D):

  dir=sub(position, thisComp.layer(2).position); 
  fromCompVec(dir)

toWorldVec(vec, t=time)

Tipo de valor devuelto: conjunto [2 ó 3].

Tipo de argumento: vec es un conjunto [2 ó 3] y t es un número.

Transforma un vector del espacio de capa al espacio de entorno. Ejemplo:

  p1 = effect("Eye Bulge 1")("Bulge Center");  
  p2 = effect("Eye Bulge 2")("Bulge Center");   
  toWorld(sub(p1, p2))

fromWorldVec(vec, t=time)

Tipo de valor devuelto: conjunto [2 ó 3].

Tipo de argumento: vec es un conjunto [2 ó 3] y t es un número.

Transforma un vector del espacio de entorno al espacio de capa. Ejemplo: fromWorld(thisComp.layer(2).position)

fromCompToSurface(point, t=time)

Tipo de valor devuelto: conjunto [2].

Tipo de argumento: point es un conjunto [2 ó 3] y t es un número.

Proyecta un punto situado en el espacio de la composición en un punto de la superficie de la capa (valor z cero) en la ubicación donde aparece cuando se ve desde la cámara activa. Este método es útil para definir puntos de control de efecto. Utilícelo solo con capas 3D.

Los objetos Cámara tienen los mismos atributos y métodos que los objetos Capa, a excepción de source, effect, mask, width, height, anchorPoint, scale, opacity, audioLevels, timeRemap y todas las propiedades materiales.

pointOfInterest

Tipo de valor devuelto: propiedad [3].

Devuelve el punto de valores de interés de una cámara en el espacio de entorno.

zoom

Tipo de valor devuelto: Propiedad.

Devuelve los valores de zoom de una cámara en píxeles.

A continuación se indica una expresión para la propiedad Escala de una capa que mantiene el tamaño relativo de la capa en el fotograma, al mismo tiempo que cambia la posición z (profundidad) de una capa o el valor de zoom de una cámara:

  cam = thisComp.activeCamera;  
  distance = length(sub(position, cam.position));  
  scale * distance / cam.zoom;

depthOfField

Tipo de valor devuelto: Propiedad.

Devuelve 1 si la propiedad Profundidad de campo de una cámara está activada, o bien, devuelve 0 si esta propiedad está desactivada.

focusDistance

Tipo de valor devuelto: Propiedad.

Devuelve el valor de distancia de enfoque de una cámara, en píxeles.

aperture

Tipo de valor devuelto: Propiedad.

Devuelve el valor de apertura de una cámara, en píxeles.

blurLevel

Tipo de valor devuelto: Propiedad.

Devuelve el valor de nivel de desenfoque de una cámara como porcentaje.

active

Tipo de valor devuelto: booleano.

Devuelve true si la cámara es la cámara activa para la composición en el momento actual: el definidor de vídeo  para la capa de la cámara está activado, el tiempo actual está en el rango de Punto de inicio de la capa a Punto final de la capa y es la primera (superior) capa de la cámara que se incluye en el panel Línea de tiempo. Si no es así, devuelve el valor falso.

Los objetos Cámara tienen los mismos atributos y métodos que los objetos Capa, a excepción de source, effect, mask, width, height, anchorPoint, scale, opacity, audioLevels, timeRemap y todas las propiedades materiales.

pointOfInterest

Tipo de valor devuelto: propiedad [3].

Devuelve el punto de valores de interés para una luz en el espacio de entorno.

intensity

Tipo de valor devuelto: Propiedad.

Devuelve los valores de intensidad de una luz como porcentaje.

color

Tipo de valor devuelto: propiedad [4].

Devuelve el valor de color de una luz.

coneAngle

Tipo de valor devuelto: Propiedad.

Devuelve el ángulo de cono de una luz, en grados.

coneFeather

Tipo de valor devuelto: Propiedad.

Devuelve el valor de calado de cono de una luz como porcentaje.

shadowDarkness

Tipo de valor devuelto: Propiedad.

Devuelve el valor de oscuridad de la sombra de una luz como porcentaje.

shadowDiffusion

Tipo de valor devuelto: Propiedad.

Devuelve el valor de difusión de la sombra de una luz, en píxeles.

David Van Brink incluye un artículo informativo y un proyecto de ejemplo en su blog omino pixel que muestra cómo utilizar expresiones con luces.

active

Tipo de valor devuelto: booleano.

Devuelve verdadero si el efecto está activado (el definidor Efecto está seleccionado)

param(name)

Tipo de valor devuelto: Propiedad.

Tipo de argumento: name es una cadena.

Devuelve una propiedad de un efecto. Los puntos de control de efecto están siempre en el espacio de capa. Ejemplo:

  effect("Bulge").param("Bulge Height") 

param(index)

Tipo de valor devuelto: Propiedad.

Tipo de argumento: index es un número.

Devuelve una propiedad de un efecto. Los puntos de control de efecto están siempre en el espacio de capa. Por ejemplo, effect("Bulge").param(4) devuelve la propiedad Alto de abombado.

maskOpacity

Tipo de valor devuelto: Propiedad.

Devuelve el valor de opacidad de una máscara como porcentaje.

maskFeather

Tipo de valor devuelto: Propiedad.

Devuelve el valor de calado de una máscara, en píxeles.

maskExpansion

Tipo de valor devuelto: Propiedad.

Devuelve el valor de expansión de una máscara, en píxeles.

invert

Tipo de valor devuelto: booleano.

Devuelve verdadero si se invierte la máscara y falso si no se invierte.

valor

Tipo de valor devuelto: Número, Conjunto o Cadena.

Devuelve el valor de una propiedad en el momento actual.

valueAtTime(t)

Tipo de valor devuelto: número o conjunto.

Tipo de argumento: t es un número.

Devuelve el valor de una propiedad en el tiempo especificado, en segundos.

Por ejemplo, para elegir aleatoriamente un valor de propiedad para cada fotograma entre un conjunto de cuatro valores, defina cuatro valores como fotogramas clave a 0, 1, 2 y 3 segundos y, a continuación, aplique la siguiente expresión a la propiedad:

  valueAtTime(random(4))

Nota: Dan Ebberts ofrece más ejemplos y técnicas para el uso de los métodos valueAtTime y velocityAtTime en su sitio web MotionScript (en inglés).

velocity

Tipo de valor devuelto: número o conjunto.

Devuelve el valor de la velocidad dirigida temporal en el tiempo actual. Para propiedades espaciales, como Posición, devuelve el valor del vector tangente. El resultado es la misma dimensión que la propiedad.

velocityAtTime(t)

Tipo de valor devuelto: número o conjunto.

Tipo de argumento: t es un número.

Devuelve el valor de la velocidad dirigida temporal en el tiempo especificado.

speed

Tipo de valor devuelto: Número.

Devuelve un valor de velocidad positiva 1D igual a la velocidad a la que la propiedad cambia en el tiempo predeterminado. Este elemento solo puede utilizarse para propiedades espaciales.

speedAtTime(t)

Tipo de valor devuelto: Número.

Tipo de argumento: t es un número.

Devuelve el valor de la velocidad espacial en el tiempo especificado.

wiggle(freq, amp, octaves=1, amp_mult=.5, t=time)

Tipo de valor devuelto: número o conjunto.

Tipo de argumento: freq, amp, octaves, amp_mult y t son números.

Agita (ondula) de manera aleatoria el valor de la propiedad.

El valor freq es la frecuencia en ondulaciones por segundo.

El valor amp es la amplitud en unidades de la propiedad a la que se aplica.

El valor octaves es el número de octavas de ruido para agregar de forma conjunta. Este valor controla el grado de detalle de la ondulación. Haga que este valor sea superior al valor predeterminado 1 para incluir frecuencias más altas o más bajas e incorporar armonía de amplitud en la ondulación.

El valor amp_mult es la cantidad por la que se multiplica amp para cada octava. Este valor controla la rapidez de eliminación de armonía. El valor predeterminado es 0,5; acérquelo más a 1 para que la armonía se agregue con la misma amplitud que la frecuencia base, o más cerca de 0 para agregarlo con menos detalle.

El valor t es el tiempo de inicio base. El valor predeterminado se ajusta al tiempo actual. Use este parámetro si desea que la salida sea una ondulación del valor de propiedad muestreada en un tiempo distinto.

Ejemplo: position.wiggle(5, 20, 3, .5) produce unas 5 ondulaciones por segundo con un tamaño medio de unos 20 píxeles. Además de la ondulación principal, se producen dos niveles más de ondulación detallada con una frecuencia de 10 y 20 ondulaciones por segundo, y tamaños de 10 y 5 píxeles, respectivamente.

Este ejemplo, en una propiedad bidimensional como Escala, ondula ambas dimensiones con la misma cantidad:

  v = wiggle(5, 10); 
  [v[0], v[0]]

Este ejemplo, en una propiedad bidimensional, ondula solo a través del eje y:

  freq = 3; 
  amp = 50; 
  w = wiggle(freq,amp); 
  [value[0],w[1]];

Paul Tuersley proporciona una secuencia de comandos en el foro de AE Enhancers que agrega automáticamente las expresiones wiggle (ondulación), smooth (suavizado) y loop (bucle) a las propiedades seleccionadas.

Dan Ebberts proporciona una expresión de ejemplo y una explicación detallada en su sitio web MotionScript que muestra cómo utilizar el parámetro de tiempo del método wiggle para crear una animación en bucle.

Kert Gartner incluye un tutorial de vídeo en el sitio web VFX Haiku que muestra cómo añadir movimiento orgánico en imágenes utilizando el método de expresión wiggle en los bordes de posición libre.

temporalWiggle(freq, amp, octaves=1, amp_mult=.5, t=time)

Tipo de valor devuelto: número o conjunto.

Tipo de argumento: freq, amp, octaves, amp_mult y t son números.

Muestrea la propiedad en un tiempo ondulado. El valor freq representa la frecuencia en ondulaciones por segundo, amp representa la amplitud en unidades de la propiedad a la que se aplica, octaves es el número de octavas de ruido que se van a sumar, amp_mult es la cantidad por la que amp se multiplica por cada octava y t es el tiempo de inicio base. Para que esta función tenga sentido, la propiedad que muestrea debe estar animada, dado que la función solo modifica el tiempo de muestreo, no el valor. Ejemplo: scale.temporalWiggle(5, .2)

smooth(width=.2, samples=5, t=time)

Tipo de valor devuelto: número o conjunto.

Tipo de argumento: width, samples y t son números.

Suaviza los valores de la propiedad a lo largo del tiempo, convirtiendo breves desviaciones largas del valor en pequeñas desviaciones distribuidas de forma más regular. Esto se consigue aplicando un filtro de cuadro al valor de la propiedad en el momento especificado. El valor width es el intervalo de tiempo (en segundos) sobre el cual se realiza el promedio del filtro. El valorsamples es el número de muestras diferenciadas espaciadas a partes iguales en el tiempo. Utilice un valor mayor para una obtener suavidad mayor (aunque el rendimiento disminuirá). Por lo general, se recomienda que el parámetro samples sea un número impar para que el valor en el tiempo actual se incluya en el promedio. Ejemplo: position.smooth(.1, 5)

loopIn(type="cycle", numKeyframes=0)

Tipo de valor devuelto: número o conjunto.

Crea un bucle de un segmento de tiempo que se mide desde el primer fotograma clave de la capa hacia delante, hacia el punto de salida de la capa. El bucle se reproduce hasta el punto de inicio de la capa. El valor numKeyframes determina qué segmento se repite: este segmento es la porción de la capa desde el primer fotograma clave hasta el fotograma clave numKeyframes+1 fotograma clave. Por ejemplo, loopIn("cycle", 3) crea un bucle del segmento limitado por los fotogramas clave primero y cuarto. El valor predeterminado 0 significa que se creará un bucle de todos los fotogramas clave.

Si lo desea puede utilizar los métodos de bucle de fotogramas clave para repetir una serie de fotogramas clave. Puede usar estos métodos en la mayoría de las propiedades. Las excepciones incluyen propiedades que no se pueden expresar mediante valores numéricos sencillos en el panel Línea de tiempo como, por ejemplo, la propiedad Texto de origen, las propiedades de forma de trazado y la propiedad Histograma para el efecto Niveles. Los fotogramas clave o los valores de duración que son demasiado grandes se recortan al máximo valor permitido. Los valores que son demasiado pequeños generan un bucle constante.

Tipo de bucle	Resultado
ciclo	(predeterminado) Repite el segmento especificado.
pingpong	Repite el segmento especificado, alternando entre adelante y atrás.
desplazamiento	Repite el segmento especificado, pero desplaza cada ciclo según la diferencia en el valor de la propiedad al principio y al final del segmento, multiplicada por el número de veces que se ha repetido el segmento.
continuar	No repite el segmento especificado, pero continúa animando una propiedad según la velocidad dirigida en el primer o el último fotograma clave. Por ejemplo, si el último fotograma clave de la propiedad Escala de una capa es 100%, la capa continúa la escala desde 100% hasta el punto final, en lugar de volver directamente hasta el punto final. Este tipo no acepta un argumento fotogramas clave o duración.

Todd Kopriva incluye un proyecto de ejemplo en su blog donde se muestra el uso de los métodos loopIn y loopOut y todos los tipos de bucle.

Paul Tuersley proporciona una secuencia de comandos en el foro de AE Enhancers que agrega automáticamente las expresiones wiggle (ondulación), smooth (suavizado) y loop (bucle) a las propiedades seleccionadas.

loopOut(type="cycle", numKeyframes=0)

Tipo de valor devuelto: número o conjunto.

Crea un bucle de un segmento de tiempo que se mide desde el último fotograma clave de la capa hacia atrás, hacia el punto de inicio de la capa. El bucle se reproduce hasta el punto final de la capa. El número especificado de fotogramas clave determina el segmento que forma el bucle. El valor numKeyframes define el número de segmentos de fotogramas clave que forman el bucle; el rango especificado se mide hacia atrás desde el último fotograma clave. Por ejemplo, loopOut("cycle", 1) repite el segmento delimitado por los fotogramas clave último y penúltimo. El valor predeterminado 0 significa que se creará un bucle de todos los fotogramas clave. Para obtener más información, consulte la entrada para loopIn.

David Van Brink ofrece un artículo instructivo y un proyecto de ejemplo en su blog omino pixel que muestra cómo utilizar los efectos de eco y animación y el método loopOut para animar un conjunto de bacterias estilizadas en movimiento.

loopInDuration(type="cycle", duration=0)

Tipo de valor devuelto: número o conjunto.

Crea un bucle de un segmento de tiempo que se mide desde el primer fotograma clave de la capa hacia delante, hacia el punto de salida de la capa. El bucle se reproduce hasta el punto de inicio de la capa. La duración especificada determina el segmento que forma el bucle. El valor duration define el número de segundos de composición de un segmento que forman el bucle; el rango especificado se mide desde el primer fotograma clave. Por ejemplo, loopInDuration("cycle", 1) crea un bucle del primer segundo de toda la animación. El valor predeterminado 0 significa que el segmento que forma el bucle comienza en el Punto de salida de la capa. Para obtener más información, consulte la entrada para loopIn.

loopOutDuration(type="cycle", duration=0)

Tipo de valor devuelto: número o conjunto.

Crea un bucle de un segmento de tiempo que se mide desde el último fotograma clave de la capa hacia atrás, hacia el punto de inicio de la capa. El bucle se reproduce hasta el punto final de la capa. La duración especificada determina el segmento que forma el bucle. El valor duration define el número de segundos de composición de un segmento que forman el bucle; el rango especificado se mide hacia atrás desde el último fotograma clave. Por ejemplo, loopOutDuration("cycle", 1) crea un bucle del último segundo de toda la animación. El valor predeterminado 0 significa que el segmento que forma el bucle comienza en el punto de entrada de la capa. Para obtener más información, consulte la entrada para loopIn.

key(index)

Tipo de valor devuelto: Clave o MarkerKey.

Tipo de argumento: index es un número.

Devuelve el objeto Clave o MarkerKey por el número. Por ejemplo, key(1) devuelve el primer fotograma clave.

key(markerName)

Tipo de valor devuelto: MarkerKey.

Tipo de argumento: markerName es una cadena.

Devuelve el objeto MarkerKey con su nombre. Utilícelo solo en propiedades de marcador.

nearestKey(t)

Tipo de valor devuelto: Clave o MarkerKey.

Devuelve el objeto Clave o MarkerKey más cercano a un tiempo designado.

numKeys

Tipo de valor devuelto: Número.

Devuelve el número de fotogramas clave de una propiedad. Devuelve el número de marcadores de una propiedad de marcador.

Nota: Si utiliza el comando Separar dimensiones para dividir las dimensiones de la propiedad Posición en componentes individuales, el número de fotogramas clave cambia, por lo que también cambia el valor devuelto por este método.

propertyGroup(countUp = 1)

Tipo de valor devuelto: grupo.

Devuelve un grupo de propiedades relacionadas con la propiedad en la que se ha escrito la expresión. Por ejemplo, si agrega la expresión propertyGroup(1) a la propiedad Rotación de un trazo de pincel, la expresión se aplica al grupo de propiedades de Transformación, que contiene la propiedad Rotación. Si, en su lugar, agrega propertyGroup(2), la expresión se aplica al grupo de propiedades de Pincel. Este método le permite establecer relaciones independientes de los nombres en la jerarquía de propiedades. El método resulta especialmente útil cuando se duplican propiedades que contienen expresiones.

El método numProperties para propertyGroup devuelve el número de propiedades en el grupo de propiedades.

Este ejemplo devuelve el número de propiedades en el grupo que contiene la propiedad en la que se escribe la expresión:

  thisProperty.propertyGroup(1).numProperties

propertyIndex

Tipo de valor devuelto: Número.

Devuelve el índice de una propiedad en relación con otras propiedades de su grupo de propiedades, incluidos los grupos de propiedades de máscaras, efectos, animadores de texto, selectores, formas, rastreadores y puntos de rastreo.

name

Tipo de valor devuelto: Cadena.

Devuelve el nombre de la propiedad o el grupo de propiedades.

Ejemplo: Animación con el método propertyGroup y el atributo propertyIndex

Valores de propertyGroup relativos a la propiedad Posición de un trazo de pincel

A.

propertyGroup(4)

B.

propertyGroup(3)

C.

propertyGroup(2)

D.

propertyGroup(1)

E.

El valor propertyIndex de Posición es 2; el valor propertyIndex de Rotación es 4.

En este ejemplo, el método propertyGroup de cada trazo de pincel se aplica al grupo de propiedades Pincel porque este grupo está dos grupos de propiedades por encima de la propiedad Rotación. El atributo propertyIndex de cada trazo de pincel devuelve un valor único para cada trazo de pincel. El valor resultante se multiplica por el tiempo y por 200 y se aplica a cada valor de giro, lo que hace girar cada trazo de pincel de manera diferente, creando trazos de pintura en espiral:

  propertyGroup(2).propertyIndex * time * 200

Animación de un trazo de pincel con una expresión

Al acceder a un objeto Clave, puede obtener las propiedades de tiempo, índice y valor de él. Por ejemplo, la siguiente expresión proporciona el valor del tercer fotograma clave Posición: position.key(3).value.

  d = Math.abs(time - nearestKey(time).time); 
  easeOut(d, 0, .1, 100, 0)

valor

Tipo de valor devuelto: número o conjunto.

Devuelve el valor del fotograma clave.

time

Tipo de valor devuelto: Número.

Devuelve el tiempo del fotograma clave.

index

Tipo de valor devuelto: Número.

Devuelve el índice del fotograma clave.

Puede tener acceso a valores para marcadores de composición y de capa con los mismos métodos. Acceda a los marcadores de capa mediante el objeto thislayer.marker; acceda a los marcadores de composición mediante el objeto thisComp.marker.

Para las expresiones, los marcadores son un tipo especial de Objeto clave, de modo que puede utilizar métodos como nearestKey(time) para acceder a los marcadores y estos también disponen de los atributos tiempo e índice. El atributo índice no es el número (nombre) del marcador, sino el número de índice del fotograma clave que representa el orden del marcador en la regla de tiempo.

Las expresiones tienen acceso a todos los valores de un marcador que puede establecer en el cuadro de diálogo Marcador de composición o Marcador de capa. Esta expresión en la propiedad Texto de origen de una capa de texto muestra el tiempo, la duración, el índice, el comentario (nombre), el capítulo, la URL, el destino de fotograma y el nombre de punto de partida del marcador de capa más cercano al tiempo actual, además de si el marcador es para un punto de partida de evento:

  m = thisLayer.marker.nearestKey(time);  
  s = "time:" + timeToCurrentFormat(m.time) + "\r" +  
      "duration: " + m.duration + "\r" +  
      "key index: " + m.index + "\r" +  
      "comment:" + m.comment + "\r" +  
      "chapter:" + m.chapter + "\r" +  
      "URL:" + m.url + "\r" +  
      "frame target: " + m.frameTarget + "\r" +  
      "cue point name: " + m.cuePointName + "\r" +  
      "Event cue point? " + m.eventCuePoint + "\r";  
  for (param in m.parameters){  
       s += "parameter: " + param + " value: " + m.parameters[param] + "\r";  
  } 
  s

Debido a que los metadatos XMP de un elemento de material de archivo se pueden convertir en marcadores de capa para una capa basada en ese elemento, las expresiones pueden interactuar con metadatos XMP. Para obtener más información, consulte metadatos XMP en After Effects.

Dan Ebberts ofrece un tutorial en el Adobe After Effects Developer Center donde se incluye un ejemplo del uso de metadatos XMP con expresiones.

duration

Tipo de valor devuelto: Número.

Duración en segundos del marcador.

comment

Tipo de valor devuelto: Cadena.

Contenidos del campo Comentario en el cuadro de diálogo de marcador.

chapter

Tipo de valor devuelto: Cadena.

Contenidos del campo Capítulo en el cuadro de diálogo de marcador.

url

Tipo de valor devuelto: Cadena.

Contenido del campo URL en el cuadro de diálogo de marcador.

frameTarget

Tipo de valor devuelto: Cadena.

Contenidos del campo Destino de fotograma en el cuadro de diálogo de marcador.

eventCuePoint

Tipo de valor devuelto: booleano.

Ajuste del tipo punto de partida en el cuadro de diálogo de marcador. Verdadero para Evento; falso para Navegación.

cuePointName

Tipo de valor devuelto: Cadena.

Contenidos del campo Nombre del punto de partida en el cuadro de diálogo de marcador.

parámetros

Tipo de valor devuelto: conjuntos asociados de valores de Cadena.

Contenidos de los campos Nombre de parámetro y Valor de parámetro en el cuadro de diálogo de marcador.

Por ejemplo, si tiene un parámetro denominado "color de fondo", puede utilizar la siguiente expresión para acceder a su valor en el marcador más cercano:

  thisComp.marker.nearestKey(time).parameters["background color"]