压暗
让图像经由可调节的黑暗程度渐入或渐暗至黑场的转场
将下一张图像一次性换入,并让它的暗度从一个数值过渡到另一个数值。暗度 0 表示图像不受影响,1 表示全黑,因此 from: 1, to: 0 让新图像从黑场中亮起,from: 0, to: 1 则让它暗入黑场
image.darken 由这个过渡承担:原地压暗一张图像,就是从当前暗度过渡到新的暗度。其他图像过渡能用的地方,Darkness 都能用
用法
import { Darkness } from "narraleaf-react";
// 让下一张图像从黑场中亮起
scene.jumpTo(next, new Darkness({ from: 1, to: 0, duration: 800 }));
// 暗入黑场
scene.jumpTo(next, new Darkness({ from: 0, to: 1, duration: 600, easing: "easeIn" }));
// 背景与立绘使用同一个过渡
scene.setBackground("/backgrounds/room-night.webp", new Darkness({ from: 1, to: 0, duration: 1000 }));
image.char("image1.jpg", new Darkness({ from: 0, to: 0.6, duration: 400 }));公共方法
constructor
options: DarknessOptionsfrom: number- 图像起始的暗度,取值范围为0–1to: number- 图像结束时的暗度,取值范围为0–1duration: number- 过渡效果的持续时间,以毫秒为单位easing?: TransformDefinitions.EasingDefinition- 缓动函数,参见TransformDefinitions.EasingDefinition