Понимание языка выражений

Язык выражений After Effects основан на JavaScript с расширенным набором встроенных объектов. В After Effects используется основной стандартный язык JavaScript, а не расширения, специфичные для веб-браузера, а также он содержит собственный набор объектов расширений, таких как Слой, Композиция, Видеоряд и Камера.

Хотя язык выражений основан на языке разработки сценариев, существует тонкое, но существенное различие между сценарием и выражением. Выражения отдают команды свойству сделать что-либо, тогда как сценарии отдают команды что-либо сделать приложению.

При создании выражений следует помнить следующее.

• Значение выражения является значением последнего вычисленного оператора. Это обычно последняя строка выражения. В своей простейшей форме значение выражения создается последней переменной или функцией, вызванной в выражении, в зависимости от порядка расчета. Однако это также может быть любое значение, которое вы явно указываете в качестве значения для возврата. Сюда могут входить значения, использованные гораздо раньше в выражении для целей отладки, или значения вне явно объявленных функций и переменных, которые не обрабатываются в том порядке, в котором они были записаны.

• JavaScript — это регистрозависимый язык.

• Функции не следует объявлять в конце выражения.

В JavaScript значение, хранимое в объекте, называется свойством. Однако в After Effects термин «свойство» используется в отношении компонентов слоя, как это определено на панели Временная шкала. По этой причине в After Effects свойства JavaScript рассматриваются в качестве методов или атрибутов. Как правило, отличие между методом и атрибутом заключается в том, что метод обычно выполняет какую-либо операцию для создания своего выходного (возвратного) значения, тогда как атрибут просто ссылается на существующее значение для определения своего выходного (возвратного) значения. Отличить метод от атрибута можно по наличию скобок за именем метода, в которые заключены любые входные аргументы метода.

Объект — это элемент, который может содержать другие объекты, атрибуты и методы. Композиции, слои и видеоряд — это примеры объектов. В частности, композиции, слои и видеоряд являются глобальными объектами, т. е. к ним можно устанавливать ссылку в любом контексте не ссылаясь на какой-либо объект более высокого уровня.

Получение доступа к атрибутам и методам

Для получения доступа к атрибутам и методам свойств слоя используется язык выражений. Для получения доступа к значению используйте цепочку ссылок объекта, разделенных точкой (.). Для построения цепочки из ссылок объекта с пропуском уровня слоя (например, для отсылки к свойствам эффекта, маскам или аниматорам текста) можно использовать скобки. Например, чтобы связать свойство Непрозрачность в слое А со свойством Размытость эффекта Размытие по Гауссу в слое В, введите следующее выражение в поле выражения свойства Непрозрачность для слоя А:

При чтении этого выражения слева направо выполняется переход с более высокого уровня, содержащего объект, к конкретному свойству:

• Используемый глобальный объект ссылается на текущую композицию thisComp.

• Ссылка к определенному объекту слоя в этой композиции устанавливается по имени слоя: layer("Layer B").

• Ссылка к определенному объекту эффекта в этом слое устанавливается по имени эффекта: effect("Gaussian Blur").

• Ссылка к определенному свойству эффекта в этом эффекте устанавливается по имени эффекта: ("Blurriness").

Для компонента n многомерного свойства, такого как компонент Y точки управления эффектом, добавьте [n] в конце, как показано ниже:

Объект выражения по умолчанию является свойством, по которому выполняется написание выражения, со следующим за ним слоем, содержащим выражение, поэтому свойство указывать не требуется. Например, выражение покачивания, написанное по свойству слоя Положение, может выглядеть следующим образом:

Добавьте слой и свойство при их извлечении из слоя и свойства, по которым написано выражение. Например, выражение, написанное по свойству Непрозрачность слоя В, связывающее его со свойством Поворот слоя А, будет выглядеть следующим образом:

Массивы и многомерные свойства

Массив – это тип объекта, хранящий упорядоченный набор чисел. Массив отображается в виде списка чисел, разделенных запятыми и заключенных в скобки, как в следующем примере:

Объект массива можно присвоить переменной, чтобы было проще ссылаться на значения массива в других областях выражения. Например:

Размер объекта массива — это число элементов в массиве. Размер myArray — это число 2. Разные свойства в After Effects имеют разные размеры в зависимости от числа аргументов значения, которым они обладают. В языке выражений значения свойств являются единичными значениями (объекты числа) либо массивами (объекты массива).

В следующей таблице приведены примеры некоторых свойств и их размеры.

Получить доступ к отдельным элементам объекта массива можно с помощью скобок и порядкового номера для указания требуемого элемента. Элементы в объекте массива индексируются с нуля. В предыдущем примере myArray[0] — это число 10, а myArray[1] — 23.

Следующие два выражения эквивалентны:

Массивы свойства положения

Массивы свойства «Положение» нумеруются следующим образом:

• position[0] – это координата X положения.

• position[1] – это координата Y положения.

• position[2] – это координата Z положения.

Представление цветов в массивах

Цвета представлены в виде 4D-массивов:

• Красный
• Зеленый
• Синий
• Альфа-канал

В проектах с разрядностью цвета 8 бит на канал или 16 бит на канал каждое значение в массиве цветов находится в диапазоне от 0 (черный) до 1 (белый). Например, красный может находиться в диапазоне от 0 (нет цвета) до 1 (красный). Таким образом, [0,0,0,0] соответствует черному цвету и прозрачности, а [1,1,1,1] — белому цвету и непрозрачности. В проектах с глубиной цвета 32 бит на канал допускаются значения ниже 0 и более 1.

При использовании индекса, большего, чем индекс компонента самого высокого размера в объекте массива, After Effects сообщит об ошибке. Например, myArray[2]приводит к ошибке, но position[2] возвращает координату Z положения.

Многие свойства и методы в языке выражений After Effects обрабатывают объекты массива в качестве аргументов или возвращают их в виде значений. Например, thisLayer.position является объектом массива, который является 2-размерным или 3-размерным в зависимости от того, каким является слой: двух- или трехмерным.

Примеры

Если требуется написать выражение, в котором будет сохраняться значение Y анимации свойства Положение, а значение X будет зафиксировано на 9, следует создать следующее выражение:

Выражение можно сократить еще:

Это важный аспект, поэтому давайте рассмотрим еще один пример. Если требуется совместить значение положения X из слоя А со значением положения Y из слоя В, необходимо составить следующее выражение:

Можно создать выражение, которое будет ссылаться только на одно значение в массиве 2D- или 3D-свойства. По умолчанию используется первое значение, пока не будет указано другое. Например, при перетаскивании инструмента «Лассо» от свойства Поворот слоя А к свойству Масштаб слоя В отобразится следующее выражение:

По умолчанию это выражение использует первое значение свойства Масштаб, которое является шириной. Если вместо этого требуется использовать значение высоты, перетащите инструмент «Лассо» непосредственно ко второму значению, а не к имени свойства или измените выражение следующим образом:

И наоборот, при перетаскивании инструмента «Лассо» от свойства Масштаб слоя В к свойству Поворот слоя А After Effects автоматически создает переменную, присваивает ей одномерное свойство Поворот, а затем использует эту переменную для обоих размеров свойства Масштаб:

Векторы

В After Effects многие свойства и методы используют или возвращают векторы. After Effects ссылается на массив как на вектор, если он представляет собой точку или направление в пространстве. Например, After Effects описывает положение как возврат вектора.

Однако, несмотря на то, что функция типа audioLevels возвращает двухмерное значение (уровни левого и правого каналов), она не носит название вектор, так как она не представляет собой точку или направление. Некоторые функции в After Effects принимают аргументы вектора, но они обычно бывают полезны, только если передаваемые значения представляют собой направление. Например, cross(vec1, vec2) вычисляет третий вектор, находящийся под правильными углами относительно входных векторов. Векторное произведение полезно, когда vec1 и vec2 являются векторами, представляющими собой направления в пространстве, но не только когда они представляют две произвольные коллекции чисел.

Индексы и метки

Индексация свойств Слой, Эффект и Маска в After Effects начинается с 1. Например, первый слой на панели Временная шкала — это layer(1).

Обычно рекомендуется использовать имя слоя, эффекта или маски вместо номера, чтобы избежать путаницы и ошибок при перемещении слоя, эффекта либо маски, или если выполняется изменение аргументов во время обновления и улучшения продукта. При использовании имени всегда заключайте его в прямые кавычки. Например, первое из этих выражений проще понять, чем второе, и первое выражение продолжит работать, даже если будет изменен порядок следования эффектов:

Время выражения

Время внутри выражения всегда находится во времени композиции (а не времени слоя) и измеряется в секундах (это не относится к выражению sourceRectAtTime()). Время по умолчанию для любого выражения представляет собой текущее время композиции, во время которого выполняется вычисление выражения. В следующих выражениях используется время композиции по умолчанию; также выражения возвращают одинаковые значения:

Для использования относительного времени добавьте инкрементное значение времени к аргументу time. Например, чтобы значение Положение было на 5 секунд меньше текущего времени, используйте следующее выражение:

В ссылках времени по умолчанию к свойствам во вложенных композициях используется исходное время по умолчанию композиции, а не перераспределенное время. Однако при использовании функции источника для получения свойства используется перераспределенное время.

Например, если источник слоя в содержащей композиции является вложенной композицией и в содержащей композиции было перераспределено время, при получении значений положения слоя во вложенной композиции с помощью следующего выражения значения положения будут использовать время композиции по умолчанию:

Однако при осуществлении доступа к слою 1 с помощью функции source значения положения будут использовать перераспределенное время:

Поскольку выражения работают со временем, измеряемым в секундах (не кадрах), иногда требуется использовать методы преобразования времени, чтобы преобразовать значения времени для выполнения операций с кадрами.

Пример. Использование справочника языка выражения для написания выражения

Следуйте указаниям в этом примере, чтобы научиться пользоваться справочником языка выражения After Effects для написания выражений. Выражение, созданное в этом примере, связывает свойство Положение сплошного слоя 2 со свойством Положение сплошного слоя 1 при сдвиге смещения сплошного слоя 2 на 2 секунды от сдвига сплошного слоя 1.

Дополнительные ресурсы о выражениях