脚本 是一系列的命令,它告知应用程序执行一系列操作。您可以在大多数 Adobe 应用程序中使用脚本来自动执行重复性任务、执行复杂计算,甚至使用一些没有通过图形用户界面直接显露的功能。例如,您可以指示 After Effects 对一个合成中的图层重新排序、查找和替换文本图层中的源文本,或者在渲染完成时发送一封电子邮件。
After Effects 脚本使用 Adobe ExtendScript 语言,该语言是 JavaScript 的一种扩展形式。ExtendScript 文件具有 .jsx 或 .jsxbin 文件扩展名。
加载和运行脚本
当 After Effects 启动时,它将从“Scripts”文件夹加载脚本。对于 After Effects,“Scripts”文件夹默认位于以下位置:
- (Windows) Program Files\Adobe\Adobe After Effects <version>\Support Files
- (Mac OS) Applications/Adobe After Effects <version>
脚本也安装在用 After Effects CC 12.1 启动的用户位置中。
After Effects 自带若干脚本,这些脚本自动安装在“Scripts”文件夹中。
通过“文件”>“脚本”菜单可以使用加载的脚本。如果您在 After Effects 运行期间编辑脚本,则必须保存更改以便应用更改。如果您在 After Effects 运行期间在“Scripts”文件夹中放置了一个脚本,则必须重新启动 After Effects 以便该脚本显示在“脚本”菜单中,但您可以使用“运行脚本文件”命令立即运行这一新脚本。
可以从“窗口”菜单的底部使用“ScriptUI Panels”文件夹中的脚本。如果编写脚本的目的是在一个可停靠面板中提供用户界面,则应将该脚本放在“ScriptUI”文件夹中。ScriptUI 面板的工作方式很像 After Effects 用户界面中的默认面板。
注意:
默认情况下,不允许脚本写入文件或通过网络收发通信。要允许脚本写入文件和通过网络通信,请选择“编辑”>“首选项”>“_ 脚本和表达式_”(Windows) 或“After Effects”>“首选项”>“脚本和表达式”(Mac OS),然后选择“允许脚本写入文件和访问网络”选项。
- 要运行已加载的脚本,请选择“文件”>“脚本”>[脚本名称]。
- 要运行尚未加载的脚本,请选择“文件”>“脚本”>“运行脚本文件”,找到并选择脚本,单击“打开”。
- 要停止运行脚本,请按 Esc 键。
- 要从命令行运行脚本,请从命令行调用 afterfx.exe。以 -r 开关和要运行的脚本的完整路径为参数。此命令不会打开 After Effects 应用程序的新实例;它在现有实例中运行脚本。
示例(对于 Windows):
afterfx -r c:\script_path\example_script.jsx
注意:
您可以使用此命令行技术并结合带自定义键盘的软件,将脚本调用绑定到一个键盘快捷键。
您可以在 After Effects 中查看最近运行的 10 个脚本的列表。要查看此列表,请选择“文件”>“脚本”>“最近的脚本文件”。
要再次运行最近运行的十个脚本中的任何一个,请按 Cmd+Option+Shift+D (macOS) 或 Ctrl+Alt+Shift+D (Win)。
Jeff Almasol 提供了一个创建简单控制台面板的脚本。控制台面板包括一个文本区域,从中您可以输入要估值的 ExtendScript 命令。这里不捕获错误或消息;此控制台只是一个简单的命令输入途径,您无需先创建一个脚本。
After Effects 附带的脚本
After Effects 提供了几个预先写好的脚本来帮助您执行常见任务,您可将其作为修改和创建您自己的脚本的基础。
注意:
运行示例脚本 Demo Palette.jsx,了解脚本的功用。
编写和修改脚本
您可以使用脚本编辑器(ExtendScript 工具包的一部分)编写自己的要用于 After Effects 的脚本。ExtendScript 工具包为您创建、调试和测试自己的脚本提供了一个便利界面。有时,您需要做的只是对现有脚本稍加修改以便满足您的要求;这样的小改动常常无需多少计算机编程和脚本语言知识就能完成。
要启动脚本编辑器,请选择“文件”>“脚本”>“打开脚本编辑器”。
脚本访问
动态图形模板的脚本访问
使用以下脚本方法,脚本可以将属性添加到“基本图形”面板和导出“动态图形”模板:
- 属性 canAddToMotionGraphicsTemplate() 方法 app.project.item(index).layer(index).propertySpec.canAddToMotionGraphicsTemplate(comp) 测试是否可以将属性添加到指定合成的基本图形面板。如果可以添加属性,则返回 true,否则返回 false。如果不能添加属性,可能是因为它不是受支持的属性类型之一或属性已被添加到该合成。After Effects 显示警告对话框。
支持的属性类型是:
- 复选框
- 颜色
- 数字滑块(即单值数值属性,如“变换”>“不透明度”或“滑块控件”表达式控制效果)
- 源文本
参数:
comp | 要测试的合成将属性添加到 compItem。 |
返回:
布尔值。
- 属性 addToMotionGraphicsTemplate() 方法 app.project.item(index).layer(index).propertySpec.addToMotionGraphicsTemplate(comp) 将属性添加给指定合成的基本图形面板。如果属性添加成功,则返回 true,否则返回 false。如果未添加属性,可能是因为它不是受支持的属性类型之一或属性已被添加到该合成。After Effects 将显示警告对话框。使用 canAddToMotionGraphicsTemplate() 方法来测试是否可以将属性添加到“动态图形”模板。
参数:
comp | 要测试的合成将属性添加到 compItem。 |
返回:
布尔值。
- CompItem motionGraphicsTemplateName 属性 app.project.item(index).motionGraphicsTemplateName 在基本图形面板中为合成读取或写入名称属性。基本图形面板中的名称用于导出的动态图形模板的文件名称,如 My Template.mogrt。以下示例设置活动合成的名称,然后将其返回为警告:
app.project.activeItem.motionGraphicsTemplateName = "My Template";alert(app.project.activeItem.motionGraphicsTemplateName);
类型:
字符串;读取/写入。
- CompItem exportAsMotionGraphicsTemplate() 方法 app.project.item(index).exportAsMotionGraphicsTemplate(doOverWriteFileIfExisting, file_path) 将合成导出为动态图形模板。 如果动态图形模板导出成功,则返回 true,否则返回 false。基本图形面板中的名称用于动态图形模板的文件名称,如 My Template.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() 方法。
参数:
doOverWriteFileIfExisting | 是否覆盖具有相同名称的现有文件、布尔值。 必填。 |
file_path | 将保存文件的文件夹的路径。(可选)。 |
返回:
布尔值。
- CompItem openInEssentialGraphics() method app.project.item(index).openInEssentialGraphics() 在“基本图形”面板中打开合成。
参数:
无
返回:
无
上次更新日期: 2022年8月24日
原文链接:https://helpx.adobe.com/cn/after-effects/using/scripts.html