Bounce Motion 1.0.0

官方一句话：“Bouncing a ball is the first thing you learn in animation and one of the most tedious things to keyframe. Bounce Motion turns it into a few clicks. Click where you want the ball to start, then click each place you want it to land, Bounce Motion does the rest.”（弹跳的球是你在动画里学到的第一件事，也是最需要 K 关键帧的烦人事之一。Bounce Motion 把它变成几次点击。点你想让球开始的地方，再点每一个你想让它落地的地方，剩下的 Bounce Motion 来做。）

官方副标题：FOR AFTER EFFECTS。官方描述：

Bounce Motion is an animation tool that lets you create polished bouncing motion. Simply place your start point, click where each bounce should land, adjust the arc, timing, stretch and squash, then export directly to After Effects.

You can also import background images as guide layers, making it easy to animate accurately over existing artwork or layouts.

Every bounce is fully editable, giving you precise creative control while taking care of the tedious work for you.

（Bounce Motion 是一个让你做出精致弹跳运动的动画工具。放好起点，点每个弹跳该落地的位置，调弧线、时序、拉伸与挤压，然后直接导出到 After Effects。你也可以把背景图作为参考层导入，让基于既有美术或版式做精准动画变得容易。每个弹跳都完全可编辑，给你精确的创作控制，同时替你把枯燥的活干完。）

一、官方四个卖点

• Flexible Output. Export as keyframes or expression controls.（灵活输出——导出成关键帧或表达式控制器。）
• Save Time. No keyframing. No graph editing.（省时间——不用 K 关键帧，不用编辑曲线图。）
• No more manual keyframing.（告别手动打关键帧。）
• Export as baked keyframes or editable expressions.（导出成烘焙关键帧或可编辑表达式。）
• Custom backgrounds.（自定义背景。）
• Quick, intuitive bounce animations.（快速直观的弹跳动画。）

二、工作流（官方「Easy Bouncing in a Few Clicks」）

官方：Design believable bouncing animations in minutes.（几分钟设计出可信的弹跳动画。）

1. 放起点
2. 点每一个落地点
3. 调弧线（arc）、时序（timing）、拉伸（stretch）与挤压（squash）
4. 直接导出到 After Effects

另外可导入背景图作为参考层（guide layers），基于既有美术/版式做精准动画——官方强调参考层「never exported」（永不导出）。

三、两种导出模式（从 UI tooltip 读出）

面板的 exportModeInput 有两档，tooltip 原文：

Baked writes a keyframe per frame. It always works and needs nothing set up in After Effects.
Expression writes an editable rig instead, so you can drag the landings in the comp and scale squash, stretch and speed with sliders.

（Baked：每帧写一个关键帧。永远能用，AE 里不需要任何额外设置。Expression：写一套可编辑的绑定，你可以在合成里拖动落地点，用滑杆缩放挤压、拉伸与速度。）

四、参数（UI 控件与 tooltip 全文）

Ball（球体）

• radiusInput —— Radius（半径）
• colourInput / colourPick —— Colour（颜色，可点选或手输 hex，带不带 # 都行）

Bounce（弹跳）

• durInput —— Duration：本次弹跳耗时。跟随弧高自动计算，直到你手输一个值为止
• heightInput —— 弧线高度
• holdInput —— Hold：在弧顶附近多停留的时间。球会缓入缓出这段，而不是硬停
• hangEaseInput —— Hang Ease：球减速进入顶点再加速的锐利程度。0 = 均匀摊开，100 = 自然，200 = 在顶点几乎停住
• stretchInput —— Stretch：球行进中拉长的程度。随速度缩放——懒散的一跳几乎不变形，快速的一跳会拉丝。超过 1 就变卡通而非物理
• squashInput —— Squash：落地时压扁的程度。压进它撞到的那个面，无论那个面什么角度
• squashDurInput —— Squash 持续时间：以接触那一刻为中心

Comp / Export（合成与导出）

• widthInput / heightInput —— Width / Height（合成尺寸）
• fpsInput —— Frame rate
• matchCompInput —— Follow the active comp：从当前所在合成读取宽高与帧率
• exportModeInput —— Baked / Expression（见上）
• useSelectedInput —— Apply to selected layer：驱动你选中的图层而不是新建一个球。它的锚点保持不动
• showDotsInput —— Show dots：在每一个导出帧上显示球的位置。点密 = 慢，点疏 = 快
• showGridInput —— 显示网格
• gridSizeInput —— 网格尺寸

Scene（场景）

• saveBtn —— Save scene：存成 .bounce 文件
• loadBtn —— Load scene：打开之前存的 .bounce
• clearBtn —— Clear all：清空所有弹跳重来
• undoBtn / redoBtn —— Undo / Redo（Ctrl+Z / Ctrl+Shift+Z，Mac 用 Cmd）
• delBtn —— Delete：删除选中的弹跳，它们飞向的落地点也一起走
• playBtn —— Play 预览
• scrub —— 拖动擦洗动画
• autoTimeInput —— Set the travel time from the arc height, the way a real bounce works. 手输时间则自动关闭

Guide image（参考图）

• bgImgBtn / bgImgClearBtn —— Choose image / Clear
• bgImgOpacity —— 参考图不透明度
• bgImgX / bgImgY —— Move the guide image across / up or down the canvas. 纯参考，永不导出

View（视图）

• zoomInBtn / zoomOutBtn / zoomReadout —— Zoom in / Zoom out（滚轮也能缩放）
• Reset zoom 复位

五、技术形态

• CEP 11 扩展（ExtensionManifest Version="11.0"，ExtensionBundleId com.laurence.bouncemotion，ExtensionBundleVersion 1.0.0）
• HostList AEFT [18.4, 99.9]——manifest 里有条注释解释了为什么设 18.4：
  

  AEFT 18.4 is the first After Effects build on CEP 11. Setting the floor at 18.0 would let AE 2021.0-2021.3 install the panel and then fail to load it, because RequiredRuntime 11.0 is unmet on their CEP 10 engine. Failing at install time with a clear message beats a dead panel.

  （AEFT 18.4 是第一个跑在 CEP 11 上的 AE 版本。把下限设成 18.0 会让 AE 2021.0–2021.3 装上这个面板却加载失败，因为它们的 CEP 10 引擎不满足 RequiredRuntime 11.0。在安装时就以明确信息失败，比留一个死面板好。）

• 面板 960×620（min 720×420），AutoVisible true，菜单 Bounce Motion
• CEF 参数：--v=0、--enable-nodejs、--mixed-context
• 图形用 Canvas 2D 渲染（canvasWrap / stage 元素），UI 为 18 KB HTML + 3.5 MB JS
• 宿主侧 host/index.jsx 提供 bmApplyBaked / bmApplyRig / bmGetComp / bmGetSelection / bmLoadScene / bmSaveScene / bmTargetLayer 等函数

六、安装（随包 Installation method.txt）

1. 把 com.laurence.bouncemotion 拷到 Win：C:Program Files (x86)Common FilesAdobeCEPextensions；Mac：System disk/Library/Application Support/Adobe/CEP/extensions
2. Win 跑 Add Keys.reg，Mac 跑 install-as-admin
3. AE 设置里勾选 Allow scripts to read, write and access the network（Win：Edit → Preferences → General；Mac：After Effects CC → Preferences → General；AE CC 2019.1 及以后在 Scripts & Expressions 页）
4. 重启 AE，顶部菜单 Window → Extensions → Bounce Motion

版本核对：本包版本 1.0.0（manifest ExtensionBundleVersion 1.0.0、面板显示 v1.0，psdly 标题 V1.0）。已用 same_plugin.sh "Bounce Motion" 查重，站点无同一插件。

价格与授权：官方价格 $14.99。官方来源 aescripts.com/bounce-motion/。

本夸克目录内容：Bounce Motion V1.0/com.laurence.bouncemotion/（CEP 扩展本体：index.html、js/main.js 3.5 MB、host/index.jsx、CSXS/manifest.xml、META-INF/signatures.xml、mimetype）、Installation method.txt、Add Keys.reg、install-as-admin.zip、cover.png、README.md。共 11 个文件 / 4332459 字节，与本地逐字节一致。

参数来源说明：官方描述、四个卖点、工作流四步、价格 $14.99，均来自 aescripts 官方页；全部控件 id 与 label、Baked/Expression 两档导出模式的 tooltip 全文、各参数（Duration / Hold / Hang Ease / Stretch / Squash / Radius / Colour）的准确语义、参考图与缩放/撤销/删除等操作说明、CEP manifest 全部字段与 18.4 版本下限的注释、宿主 jsx 函数清单、面板尺寸与 CEF 参数，均来自包内 index.html（含 title 属性）、CSXS/manifest.xml、host/index.jsx 与 js/main.js。非推测。

原产品页：https://aescripts.com/bounce-motion/

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