SuperAPI AI 工具集

paper-cinder-transition

写作与研究

查看项目

更新于 10-16 06:46

技能介绍

用途:在自有场景之间做纸燃烧转场,而不是淡入淡出。旧画面被一条火线“吃掉”,火线扫过时先烤焦旧页,再露出实时的新场景。若燃烧是加载环且需在阻塞主线程时存活,用 fire-paper-loader;若文字由遮罩写入而非燃烧,用 masked-reveal;若为无燃烧的滚动驱动序列,用 scroll-scrubbed-visual-sequence。

主要能力:单次全屏 pass 按像素判定属于冻结旧帧、燃烧带还是实时新场景,依据到噪声前沿的有符号距离。包含距离场、余烬渐变、炭化规则与噪声烘焙;支持从文字所在侧进入、按章节播种不同轮廓、scissor 裁剪实时场景、0.75 缩放与静止后全尺寸交叉淡入、bloom、ACES 色调与颗粒。

使用方式:把冻结旧帧快照到全分辨率目标,新场景保持实时渲染;前沿按像素测量,斜率用有限差分而非 dFdx;噪声烘焙为 1024² RGBA16F 纹理与 2048² R16F 哈希表;实时场景仅在火线后方加 0.16 屏余量内绘制。默认时长 3.0 秒(1.5–5 秒可读)。

限制与注意:需绑定 uKbN 与 uKbH,否则余烬带失效;scissor 余量不足会露出未绘制像素;炭化远边须取自宽前沿,否则出现漂浮炭岛;余烬边缘发白多因提黑曲线,应改用增益。prefers-reduced-motion 时不做燃烧,改为固定时刻静止帧 0.35 秒交叉淡入;document.hidden 或离开视口时暂停并重置时间基准;dt 钳制 1/30 秒,DPR 上限 2。性能上逐像素噪声是主要开销,烘焙后 1440x900 实测 p50 8.3 ms、p90 8.8 ms。具体安装命令与收费信息暂未提供。