SPBokeh 1.0.0

官方一句话：“Lens-inspired swirl bokeh for Adobe After Effects and Premiere Pro.”（镜头灵感的旋转散景，用于 AE 与 PR）

它还原的是老镜头全开光圈时的那个现象——官方描述：“Open an old lens wide and the bokeh turns to arcs in the corners — that familiar swirl.”（老镜头全开时，边缘的高光会扭成弧线，那种熟悉的旋涡）

SPBokeh 不是给画面套一层模糊，而是按空间位置变化地重建散景形状：越靠画面边缘，高光越从圆形拉成弧、甚至猫眼，和真实球面像差的行为一致。二进制里的定位标语是：

Spatially-varying swirl bokeh. D3D12 engine (Windows) sharing the Metal engine algorithm.

AE 和 PR 共用同一个 .aex，装一次两个宿主都能用（效果内部名 AE.SPBOKEH SwirlBokeh）。

一、镜头像差是核心

普通景深插件只会做均匀圆形散景。SPBokeh 的差异全在 Lens Aberrations 这一组：

• Chromatic Aberration —— 色散
• Cat-eye / Cat-eye Falloff —— 猫眼（靠边高光收成楔形）及其衰减
• Coma —— 彗差
• Field Curvature —— 像场弯曲
• Anamorphic / Anamorphic Angle —— 变形镜头与拉伸角

再配 Swirl 组的 Swirl Strength / Edge Enhance / Swirl Bias（旋多少、边缘加强多少、往哪边旋），边缘高光才会从圆变成弧。

二、光圈与洋葱圈

Bokeh Basics 里 Aperture Shape 可选：Circle | Square | Pentagon | Hexagon | Heptagon | Octagon（圆 / 方 / 五边 / 六边 / 七边 / 八边）。

Bokeh Details 组的 Onion Ring / Onion Ring Count 模拟镜头镜片的洋葱圈纹理，Aperture Roundness 控制圆润度，Lens Character 是整体镜头性格的总开关，Rim / Bright Rim / Rim Width 管边缘亮环。

三、Focus & Depth 聚焦

把效果限制在真实焦点区域：

• Depth Layer / Mask Layer —— 指定深度图层或蒙版图层
• Focus Depth / Depth Range / Depth Feather —— 焦点位置、深度范围、羽化
• Depth Invert —— 深度图反相时翻转（亮 = 近，反了就用它）
• Occlusion Strength —— 遮挡强度

如果不想额外做深度图，还有 Built-in Mask：Enable 打开，Center / Size / Aspect / Angle / Feather / Invert / Influence 全套，View 可在 Preview 与 Final 间切换。Info 区的 Matte Expand 与 Depth Guide 是官方帮助入口。

四、深度图层工作流（官方原文）

1. 把深度图片段放到另一条视频轨上。
2. 先给主片段加 Track Matte Key：Matte 选深度轨，Composite Using = Matte Luma。
3. 在它下面应用 SPBokeh，勾选 Use Depth Layer。
4. 调 Focus Depth、Depth Range、Depth Feather。亮 = 近；深度图是反的就用 Depth Invert 翻过来。

顺序很重要——Track Matte Key 必须在 SPBokeh 之前。

五、渲染与色彩

Render & Color 组控制性能与色彩管线：

• Render Quality：Preview | Balanced | Final
• Quality：Fast | Balanced | High | Ultra
• Background Res：Auto | Full | 1/2 | 1/4（背景缓冲分辨率）
• Color Processing：Automatic (AE) | Gamma-Encoded | Linear
• Processing Device：Auto (GPU preferred) | GPU (D3D12) | CPU

排障时看 AE 控制台/日志，后端会自报：[SPBokeh] Renderer backend: D3D12、CPU (Auto fallback)、CPU (GPU fallback)、CPU (selected)、D3D12 and CPU fallback failed。

六、预设管理

内置 5 个：Ember / Solstice / Nocturne / Aureole / Stellate，加上 Custom。

用户预设菜单：New Custom、Save Current as New…、Rename Selected…、Delete Selected…、Import User Presets…、Export User Presets…、Open Preset Manager…

导出时官方明确提示：“All user presets were exported. Built-in presets were not included.”（只导出自定义预设，内置的不包含）

安装（官方指南）：推荐用 aescripts + aeplugins Manager App，登录或 Account > Add Trial，找到 SPBokeh 点 Install，重开 AE / PR。手动安装：macOS 拷 Mac/SPBokehAE.plugin 到 /Library/Application Support/Adobe/Common/Plug-ins/7.0/MediaCore/；Windows 拷 Windows/SPBokehAE.aex 到 C:Program FilesAdobeCommonPlug-ins7.0MediaCore。

Windows 必须保持 DirectX_Assets 与 .aex 同级——里面 16 个 .cso / .rs 成对着色器资源（prepareSource / buildMaps / genMip / refineMaps / morphDepth / downsampleForGather / gatherBokeh_l0o0 / l0o1 / l1o0 / l1o1 / composite）是 D3D12 后端运行时读取的，少了插件直接初始化失败。本夸克目录已按原结构摆放。

版本核对：效果内版本串 SPBokeh v%d.%d.%d.%d，安装包名 V1.0.0，psdly 标题 V1.0，三方一致，按 1.0.0 记录。

技术信息：AE 效果名 AE.SPBOKEH SwirlBokeh；C++ 类结构（从二进制符号读出）SPBokehPrGPUFilter / SPBokehRenderer / SPBokehCPURenderer / SPBokehD3D12RendererAdapter / SPBokehD3D12Bridge；构建路径 C:devSPBokeh-github-41e2a91appsafter-effectsSPBokehAEbuildWinx64ReleaseSPBokehAE.pdb。Windows 走 D3D12，与 Mac 侧 Metal 引擎共用同一套算法；无 GPU 时有 CPU 渲染器兜底。

参数来源说明：全部参数名、分组顺序与下拉选项来自 Windows/SPBokehAE.aex 内字符串表（提取顺序即界面顺序）；How to Use 四步、安装路径、QUICK CONTROLS 归类来自随包 Install_and_Quick_Start.pdf（已解出文本）；官方标语与价格来自 aescripts 官方页。非推测。

第三方组件（THIRD_PARTY_NOTICES.md）：The Forge（Apache 2.0，仅研究参考、未打包源码）；Jorge Jimenez 的 Interleaved Gradient Noise（仅用于 dither 确定性采样分布，不属其 DoF / swirl / cat-eye / occlusion / compositing 算法）；David Hoskins “Hash without Sine”（MIT，hash22 风格采样 dithering）。兼容 AE 与 PR，但非 Adobe 产品。

本包内容：Windows/SPBokehAE.aex（AE + PR 共用）、Windows/DirectX_Assets/（16 个着色器资源，务必与 aex 同级）、Windows/read.txt、THIRD_PARTY_NOTICES.md、cover.jpg（官方封面）。macOS 的 SPBokeh 1.0.0.dmg 与安装指南 PDF 因源包内被替换为中文站免责声明页、无法确认完整性，未随本包分发；macOS 请从官方 Manager App 安装 SPBokehAE.plugin。

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

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