AnimateParallax 1.6.0

官方一句话：“Create parallax effect intuitively in After Effects. Visually manipulate Z-space to easily achieve realistic depth.”（在 After Effects 里直观地创建视差效果。可视化地操控 Z 空间，轻松获得真实深度。）

官方页头标语更短：Visually control depth.（可视化控制深度。）

psdly 的官方描述还提到它的出身：

Inspired by Adobe Animate’s Layer Depth feature. AnimateParallax gives After Effects an intuitive visual interface to create and manage parallax effects. You no longer need to write complex expressions each layers or manually keyframe multiple layers. Simply adjust the Z-position of your layers visually, hit Apply, and you’re done!

（灵感来自 Adobe Animate 的 Layer Depth 功能。AnimateParallax 给 After Effects 一个直观的可视化界面来创建和管理视差效果。你再也不需要给每个图层写复杂表达式、或者手动 K 多个图层的关键帧。直接可视化调整图层的 Z 位置，点 Apply，完事！）

一、核心工作流

面板把合成里的 3D 图层列成一个 depth view（深度视图），你直接在里面拖动图层的 Z 位置，看到的就是最终的空间关系。调好后点 Apply，插件自动写好视差表达式。

包内 main.jsx 的注释把功能说得很清楚：

AnimateParallax – An After Effects extension that allows you to easily and visually adjust Z positions and apply expressions that create parallax effects.

二、五个主动作

1. Apply（应用视差）——默认写视差表达式 + 缩放调整。官方 1.3.0 加了快捷键分流：

［New］Ctrl+Click Apply now sets Z positions only without adding expressions or scale adjustments.
###Usage
・Apply: Parallax effects with expressions (unchanged)
・Ctrl+Apply: Z position only, no expressions

• Apply —— 视差效果 + 表达式（保持原样）
• Ctrl+Apply —— 只设 Z 位置，不加表达式、不动缩放

2. Apply Z Position Only —— 只写 Z 位置，不写表达式

3. Bake Parallax Expressions（烘焙）——把视差表达式烘焙成关键帧。提示串：Parallax expressions baked successfully、Bake Confirmation、Some layers already have keyframes、Keyframes Detected / Delete Keyframes。

4. Distribute Z（分布 Z）——把图层在 Z 空间均匀铺开。串：No layers to distribute、No non-parented layers to distribute、Distribute Z。

5. Randomize Z（随机 Z）——随机打乱 Z 位置。串：Randomize Z、No layers to randomize、No non-parented layers to randomize。

三、Z 值的复制 / 粘贴 / 重置

Copy / Paste Z：Copy a Z value first、Please select a layer to copy Z value、Cannot copy Z value from parented layer、Paste Z、No valid layers to paste (parented layers skipped)

Reset Z：Reset Z、No layers to reset

Drag Z：上下文菜单项 label: Drag Z，可在深度视图里直接拖动改 Z。错误处理串：Error in handleCanvasMouseDown:、Error in handleCanvasMouseMove:、Error in handleNumMouseDown:、Error in handleNumDragMouseMove:

Undo / Redo：Nothing to undo、Nothing to redo

四、Settings 设置

可从界面打开的配置项：

• settings-default-near / settings-default-far —— 默认近端 / 远端值（有校验：Far value must be greater than Near value）
• settings-layer-color-mode —— 图层颜色模式
• scale-toggle-checkbox —— 缩放开关
• Sync Required / Update List / Remove & Apply

五、多图层编辑（1.2.0 加入）

官方说明：

Added support for selecting and editing multiple layers at once.
・Note: This applies to manual Z-value adjustments. Buttons like Distribute, Random, Apply and Bake will continue to affect all loaded layers, regardless of the selection.

（支持一次选多个图层编辑。注意：这适用于手动调 Z 值。而 Distribute、Random、Apply、Bake 这些按钮始终作用于所有已加载图层，不受选中影响。）

同版本还加了鼠标滚轮滚动：”Enabled layer list scrolling with the mouse wheel over the depth view panel.”

六、分离尺寸图层支持（1.1.0 加入）

官方：”Added support for layers with separated transform dimensions”（支持位置/缩放等维度被分离的图层）。同版本还修了滚动条重置、UI 刷新、数字等宽字体等问题。

安装（随包 read.txt 原文）：把 com.aescripts.animateparallax 文件夹拷到 C:Program Files (x86)Common FilesAdobeCEPextensions（Windows）或 System Disk/Library/Application Support/Adobe/CEP/extensions/（Mac）；Windows 运行 Add Keys.reg 一次，Mac 运行 install-as-admin 一次；在 AE 偏好设置开启「Allow Scripts to Write Files and Access Network」（AE CC 2019.1 及以后在 Scripting & Expressions 页）；然后 Window → Extensions → AnimateParallax。

版本核对：manifest ExtensionBundleVersion 1.6.0、main.jsx 头部 @version v1.6.0，一致。注意 psdly 标题写 V1.0.0，但包内 manifest 与源码版本都是 1.6.0，本条目按包内实际版本 1.6.0 记录。官方版本历史：1.6.0、1.3.0（2025-07-15）、1.2.0（2025-06-22）、1.1.0（2025-06-13）。

宿主要求：manifest HostList <Host Name="AEFT" Version="[23.0,99.9]"/>，即需要 After Effects 2023 或更高。RequiredRuntime CSXS 11.0。

边界与错误处理（从 JS 提示串提取）：No project is open / No active composition；No 3D layers selected in composition；Parented (cannot be processed) / Parented layer——父子级联的图层不能处理；Some layers were not found. / Layer not found (id: ...)；Not a 3D layer: ...；Some layers already have keyframes（烘焙前会问是否删除关键帧）；No layers loaded. Please refresh first.；Failed to communicate with After Effects: Make sure a project is open and try again；Empty response from After Effects。

工程状态监听：Project changed - resetting panel state、Project closed - resetting panel state、Application quitting - cleaning up、Browser beforeunload - emergency cleanup。

面板信息：尺寸 300×300（manifest Geometry），AutoVisible true，菜单 AnimateParallax，MainPath ./panel/panel.html，ScriptPath ./panel/jsx/main.jsx，CEF 参数含 --enable-nodejs、--mixed-context、--allow-file-access-from-files、--allow-file-access。另有一个 preferences 扩展（ModalDialog 300×300）与 about 扩展（Modeless 350×440）。

技术栈：CEP 11 / manifest Version 11.0。panel.js（428 KB）内嵌 jQuery（sizzle 选择器引擎可见），依赖 aesp.js + aesp-wrapper.js（aescripts 框架）+ ajv（JSON schema 校验）。node_modules 只依赖 mkdirp / path / temp 三个包，已按官方结构剔除。

本夸克目录内容：com.aescripts.animateparallax/（CEP 扩展本体：CSXS manifest、panel/ 面板与 jsx、dialog/、preferences/、img/logo.png、custom/analytics.json）、Add Keys.reg、install-as-admin.zip、read.txt、cover.jpg、README.md。

参数来源说明：官方描述段落、价格 $39.00、FLS $99.99、FREE TRIAL、官方标签、版本历史（1.3.0/1.2.0/1.1.0 更新内容）均来自 aescripts 官方页；按钮名、提示串、错误串、设置项 id、工程状态监听串均来自包内明文 panel/js/panel.js、panel/jsx/main.jsx、panel/panel.css；安装步骤来自随包 read.txt。非推测。

原产品页：https://aescripts.com/animateparallax/

封面图片来自作者官方产品页。本文为中文整理，功能与兼容性信息以作者官方页面与包内说明为准。资源仅供学习交流，商业使用请购买正版授权。