Сценарии

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

В сценариях After Effects используется язык Adobe ExtendScript, представляющий собой расширенную форму языка JavaScript. Для имен файлов ExtendScript используется расширение .jsx или .jsxbin.

Описания возможностей сценариев, доступных в After Effects, см. в руководстве по разработке сценариев After Effects в Центре разработки After Effects.

При запуске After Effects загружает сценарии из папки «Сценарии» (Scripts). Для After Effects папка «Сценарии» по умолчанию находится в следующих местах:

• (Windows) Program Files\Adobe\Adobe After Effects <version>\Support Files

• (Mac OS) Applications/Adobe After Effects <version>

Сценарии также устанавливаются в папках пользователя начиная с After Effects CC 12.1.

Некоторые сценарии поставляются с After Effects и устанавливаются в папку «Сценарии» автоматически.

Загруженные сценарии доступны в меню «Файл» > «Сценарии». При изменении сценария во время работы After Effects необходимо сохранить изменения, чтобы они были применены. При сохранении сценария в папку «Сценарии» во время работы After Effects необходимо перезапустить After Effects, чтобы сценарий появился меню «Сценарии», хотя новый сценарий можно запустить немедленно с помощью команды «Выполнить файл сценария».

Сценарии в папке «Панели ScriptUI» (ScriptUI Panels) доступны в нижней части меню «Окно». Если сценарий был написан для обеспечения пользовательского интерфейса в прикрепляемой панели, этот сценарий следует помещать в папку «ScriptUI». Работа панелей ScriptUI очень похожа на работу панелей по умолчанию в пользовательском интерфейсе After Effects.

• Чтобы запустить загруженный сценарий, выберите «Файл» > «Сценарии» > «[имя сценария]».

• Чтобы выполнить сценарий, который не был загружен, выберите «Файл» > «Сценарии» > «Выполнить файл сценария», найдите и выберите сценарий, а затем нажмите кнопку «Открыть».

• Чтобы остановить выполняемый сценарий, нажмите клавишу ESC.

• Чтобы выполнить сценарий из командной строки, вызовите afterfx.exe из командной строки. В качестве аргументов используйте параметр -r и полный путь к сценарию. Эта команда не открывает новый экземпляр приложения After Effects, а выполняет сценарий в существующем экземпляре.

  Пример (для Windows)

  afterfx -r c:\script_path\example_script.jsx

Можно просмотреть список из десяти последних выполнявшихся сценариев в After Effects. Чтобы просмотреть список, выберите Файл > Сценарии > Последние файлы сценариев.

Чтобы выполнить снова любой из десяти последних выполнявшихся сценариев, нажмите клавиши Cmd + Option + Shift + D (macOS) или Ctrl + Alt + Shift + D (Windows).

Джефф Алмасол предоставляет сценарий, создающий простую консольную панель. Консольная панель содержит текстовую область, в которой можно ввести вычисляемые команды ExtendScript. Обработка ошибок и сообщений отсутствует — эта консоль просто обеспечивает удобный способ ввода команд без предварительного создания сценария. 

Сценарии, предоставляемые в After Effects

Чтобы упростить выполнение типовых задач и создать основу для изменения и создания собственных сценариев, After Effects поставляется с несколькими заранее написанными сценариями.

Написание и редактирование сценариев

С помощью редактора сценариев, входящего в набор инструментов ExtendScript, можно создавать собственные сценарии для After Effects. Набор инструментов ExtendScript предоставляет удобный интерфейс для создания, отладки и тестирования собственных сценариев. Иногда все, что понадобится сделать, — это внести небольшие изменения в существующий сценарий, чтобы он выполнял нужные действия. Такие незначительные изменения часто можно выполнить с минимальными знанием компьютерного программирования и языков сценариев.

Дополнительные сведения см. в руководстве по разработке сценариев After Effects.

Чтобы запустить редактор сценариев, выберите Файл > Сценарии > Открыть редактор сценариев.

Учебное пособие на форуме AE Enhancers шаг за шагом помогает читателю выполнить все этапы создания сценария.

Дэвид Торно (David Torno) предлагает список имен для поиска сценариев After Effects.

Доступ для разработки сценариев

Доступ для разработки сценариев шаблонов анимационного дизайна

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

• Метод свойства canAddToMotionGraphicsTemplate() app.project.item(index).layer(index).propertySpec.canAddToMotionGraphicsTemplate(comp) Проверка возможности добавления свойства на панель «Основные графические элементы» для указанной композиции. Возвращает значение true, если свойство можно добавить. В противном случае возвращается значение false. Если свойство нельзя добавить, оно либо не относится к одному из поддерживаемых типов свойств, либо оно уже было добавлено к этой композиции. After Effects отображает диалоговое окно с предупреждением. 

Поддерживаемые типы свойств:

• Флажок
• Цвет
• Числовой ползунок (т. е. числовое свойство с одним значением, например «Преобразовать» > «Непрозрачность» или эффект элементов управления выражениями «Ползунок»)
• Исходный текст

Параметры:

Возвращает:

логический.

• Метод свойства addToMotionGraphicsTemplate() app.project.item(index).layer(index).propertySpec.addToMotionGraphicsTemplate(comp) Добавление свойства на панель «Основные графические элементы» для указанной композиции. Возвращает значение true, если свойство успешно добавлено. В противном случае возвращается значение false. Если свойство не добавлено, оно либо не относится к одному из поддерживаемых типов свойств, либо оно уже было добавлено к этой композиции. After Effects отобразит диалоговое окно с предупреждением. Используйте метод canAddToMotionGraphicsTemplate() для проверки возможности добавления свойства в шаблон анимационного дизайна.

Параметры:

Возвращает:

логический.

• Атрибут CompItem motionGraphicsTemplateName app.project.item(index).motionGraphicsTemplateName Считывание или запись свойства имени в панель «Основные графические элементы» для композиции. Имя на панели «Основные графические элементы» используется в качестве имени файла экспортированного шаблона анимационного дизайна, например Мой шаблон.mogrt. В следующем примере задается имя для активной композиции, а затем возвращается как предупреждение:

app.project.activeItem.motionGraphicsTemplateName = "Мой шаблон";
alert(app.project.activeItem.motionGraphicsTemplateName);

Тип:

строка; чтение/запись.

• Метод CompItem exportAsMotionGraphicsTemplate() app.project.item(index).exportAsMotionGraphicsTemplate(doOverWriteFileIfExisting, file_path) Экспорт композиции как шаблона анимационного дизайна. Возвращает значение true, если шаблон анимационного дизайна успешно экспортирован. В противном случае возвращается значение false. Имя на панели «Основные графические элементы» используется в качестве имени файла шаблона анимационного дизайна, например Мой шаблон.mogrt. Используйте атрибут motionGraphicsTemplateName, чтобы задать имя. Также можно указать путь к папке, где будет сохранен шаблон анимационного дизайна. Если путь не указан, файл будет сохранен в папке «Основные графические элементы» (Essential Graphics) текущего пользователя.

macOS:

/Users//Library/Application Support/Adobe/Common/Essential Graphics/

Windows:

C:\Users\\AppData\Roaming\Adobe\Common\Essential Graphics\

В случае изменения проекта с момента последнего сохранения программа After Effects предлагает пользователю сохранить проект. Чтобы избежать этого, используйте метод save() проекта перед экспортом шаблона анимационного дизайна.

Параметры:

Возвращает:

логический.

• Метод CompItem openInEssentialGraphics() app.project.item(index).openInEssentialGraphics() Открытие композиции на панели «Основные графические элементы».

Параметры:

Нет

Возвращает:

Нет

Ресурсы для поиска других полезных сценариев

Сценарии, проекты, а также другие полезные элементы см. на веб-сайте надстроек Adobe Add-ons.

В разделе о разработке сценариев на своем веб-сайте MotionScript Дэн Эббертс (Dan Ebberts) предлагает руководства по созданию сценариев и полезные сценарии.

Ллойд Альварез (Lloyd Alvarez) предоставляет набор полезных сценариев на своем /веб-сайте со сценариями After Effects.

На форуме AE Enhancers представлены примеры сценариев и полезные сведения об их разработке (а также о выражениях и стилях анимации) в After Effects.

Дейл Брэдшоу (Dale Bradshaw) предоставляет сценарии и полезные приемы на своем /веб-сайте Creative Workflow Hacks.

Кристофер Грин (Christopher Green) предоставляет множество полезных сценариев на своем веб-сайте.