299 lines
14 KiB
Rust
299 lines
14 KiB
Rust
//! Rust 测试框架通过 endor_host 的真实 VM/发布帧接口验收 illustrated-manuscript Endor 示例。
|
|
//! 第一项检查指针驱动/火焰生命周期与基本像素，第二项检查 owner-scoped 动画任务、不同视口和绘制几何。
|
|
//! write_png 仅在配置 TESSERA_MANUSCRIPT_SNAPSHOTS 时写图片；测试源码字符串与像素期望都是验收数据。
|
|
use super::*;
|
|
use crate::document::RenderCommand;
|
|
|
|
#[test]
|
|
/// 测试框架调用，证明动画由真实源状态和指针事件驱动，取消输入后源粒子会退场而非原生演示循环继续跑。
|
|
fn illustrated_manuscript_is_driven_by_real_endor_source_and_pointer_events() {
|
|
// 直接加载仓库随应用交付的示例，避免测试另写一份近似逻辑却无法覆盖实际程序。
|
|
let source = include_str!("../../../examples/illustrated-manuscript.endor");
|
|
// 固定会话代际只用于事件身份，几何/Mount ID 从真正发布的文档取出。
|
|
let (mut session, mut document) = ReplSession::load(source, "app.main", 1, 735).unwrap();
|
|
/// 本测试的同步求值助手，执行后只在有新文档时替换观察值，返回 Console 的字符串结果供断言。
|
|
fn evaluate(session: &mut ReplSession, document: &mut RenderDocument, source: &str) -> String {
|
|
// execute 复用持久 globals，不根据浏览文档伪造对象状态。
|
|
let result = session.execute(source, "app.main").unwrap();
|
|
if let Some(next) = result.document {
|
|
// 无变化时保留先前完整帧，不能用默认空文档替换它而误判渲染退场。
|
|
*document = next;
|
|
}
|
|
result.value
|
|
}
|
|
// 关闭自动计时器，后面显式 dragon.step 的次数才是唯一推进因素，消除定时采样干扰。
|
|
evaluate(&mut session, &mut document, "view.timer.cancel()");
|
|
document.validate().unwrap();
|
|
assert!(
|
|
document
|
|
.frame
|
|
.commands
|
|
.iter()
|
|
.any(|c| matches!(c, RenderCommand::Image { .. }))
|
|
);
|
|
assert!(document.frame.mounts.iter().any(|m| m.pointer_events));
|
|
// 读取模型的真实头段 x 作为基线，不靠图片相似度猜动画是否发生。
|
|
let before = evaluate(&mut session, &mut document, "dragon.segments.at(0).x");
|
|
// 目标必须具有 pointer_events，发布几何提供局部区域，不硬编码内部出现编号。
|
|
let target = document
|
|
.frame
|
|
.mounts
|
|
.iter()
|
|
.find(|m| m.pointer_events)
|
|
.unwrap();
|
|
// 用发布版本与实际目标构造合法原始指针，坐标放在画面内部，避免命中边缘的额外裁剪条件。
|
|
let mut input = crate::events::Input {
|
|
window: 1,
|
|
session: 735,
|
|
layout_version: document.frame.layout_version,
|
|
mount: target.id,
|
|
kind: "pointermove".into(),
|
|
point: Some([
|
|
target.x + target.width * 0.65,
|
|
target.y + target.height * 0.55,
|
|
]),
|
|
press_point: None,
|
|
delta: None,
|
|
tab_drop: None,
|
|
screen_position: None,
|
|
};
|
|
document = session
|
|
.dispatch(&input)
|
|
.unwrap()
|
|
.document
|
|
.unwrap_or(document);
|
|
for _ in 0..8 {
|
|
// 只推进源函数，证明位置变化来自已收到的指针目标与程序状态，不是宿主隐藏动画线程。
|
|
document = session
|
|
.execute("dragon.step()", "app.main")
|
|
.unwrap()
|
|
.document
|
|
.unwrap_or(document);
|
|
}
|
|
// 比较同一模型字段的前后值，检查显式推进阶段有实际位置变化，而非只生成更多绘图命令。
|
|
let after = evaluate(&mut session, &mut document, "dragon.segments.at(0).x");
|
|
assert_ne!(before, after);
|
|
// 事件每次使用最新实际几何版本，测试关注行为而非故意触发过期输入拒绝。
|
|
input.layout_version = document.frame.layout_version;
|
|
input.kind = "pointerdown".into();
|
|
document = session
|
|
.dispatch(&input)
|
|
.unwrap()
|
|
.document
|
|
.unwrap_or(document);
|
|
for _ in 0..3 {
|
|
// pointerdown 激活喷火状态，少量显式帧之后应有源粒子实例进入集合。
|
|
document = session
|
|
.execute("dragon.step()", "app.main")
|
|
.unwrap()
|
|
.document
|
|
.unwrap_or(document);
|
|
}
|
|
assert_ne!(
|
|
evaluate(&mut session, &mut document, "dragon.flames.count"),
|
|
"0"
|
|
);
|
|
// 在源模型侧检查粒子尺寸预算，避免仅像素图看起来小却实际对象无限长大。
|
|
let max_size = evaluate(&mut session, &mut document, "dragon.flames.at(0).size < 20");
|
|
assert_eq!(max_size, "true");
|
|
input.layout_version = document.frame.layout_version;
|
|
input.kind = "pointercancel".into();
|
|
// 取消必须沿同一输入分派路径清 pressed，不直接从测试修改 dragon.pressed 代替处理器。
|
|
session.dispatch(&input).unwrap();
|
|
assert_eq!(evaluate(&mut session, &mut document, "dragon.pressed"), "0");
|
|
for _ in 0..16 {
|
|
// 取消后继续更新已有粒子寿命，最终集合归零，验证没有仍被按住状态持续补发新火焰。
|
|
document = session
|
|
.execute("dragon.step()", "app.main")
|
|
.unwrap()
|
|
.document
|
|
.unwrap_or(document);
|
|
}
|
|
assert_eq!(
|
|
evaluate(&mut session, &mut document, "dragon.flames.count"),
|
|
"0"
|
|
);
|
|
// 真正发布列表交软件渲染器，不从源模型的“将要绘制”对象构造另一份测试专用画面。
|
|
let list = document.display_list(1.).unwrap();
|
|
// 预分配固定尺寸 RGB 像素，下面验证页面奶油背景确实进入最终合成结果。
|
|
let mut pixels = vec![0; 1024 * 800];
|
|
crate::software_renderer::SoftwareRenderer::render(&list, &mut pixels, 1024, 800).unwrap();
|
|
assert!(pixels.contains(&0xf4eee0));
|
|
}
|
|
|
|
/// 第二项集成测试共用的持久执行助手；保留最后完整文档，返回源值的 Console 表示，不重建 VM。
|
|
fn execute(session: &mut ReplSession, document: &mut RenderDocument, source: &str) -> String {
|
|
// 执行源代码及其同步刷新，Option 文档为空只代表没有新发布，不代表旧画面失效。
|
|
let result = session.execute(source, "app.main").unwrap();
|
|
if let Some(next) = result.document {
|
|
// 有新完整帧才覆盖测试观察值，后续输入版本与快照都从此值读取。
|
|
*document = next;
|
|
}
|
|
result.value
|
|
}
|
|
/// 第二项测试各阶段调用，先验证实际像素；仅明确配置快照目录时把同一像素编码为 PNG，便于人工检查。
|
|
fn write_png(document: &RenderDocument, w: u32, h: u32, scale: f32, name: &str) {
|
|
// scale 是物理像素倍率，显示列表和输出尺寸必须配套，不改变源程序使用的逻辑 viewport。
|
|
let list = document.display_list(scale).unwrap();
|
|
// 软件渲染覆盖真实像素数组，断言并非只检查命令里有一条背景矩形。
|
|
let mut pixels = vec![0; w as usize * h as usize];
|
|
crate::software_renderer::SoftwareRenderer::render(&list, &mut pixels, w, h).unwrap();
|
|
assert!(pixels.iter().filter(|&&p| p == 0xf4eee0).count() > 1000);
|
|
if let Ok(dir) = std::env::var("TESSERA_MANUSCRIPT_SNAPSHOTS") {
|
|
// 未设置目录时不产生文件；有目录才创建编码器，快照输出是显式选择的测试附加产物。
|
|
std::fs::create_dir_all(&dir).unwrap();
|
|
// name 区分宽窄视口及静止/穿行/喷火阶段，图片来自当前实际发布帧而非 ImageGen。
|
|
let file =
|
|
std::fs::File::create(std::path::Path::new(&dir).join(format!("endor-{name}.png")))
|
|
.unwrap();
|
|
// 像素是 0xRRGGBB，编码为每通道 8 位 RGB，不能把 u32 内存字节直接当 RGBA 保存。
|
|
let mut encoder = png::Encoder::new(file, w, h);
|
|
encoder.set_color(png::ColorType::Rgb);
|
|
encoder.set_depth(png::BitDepth::Eight);
|
|
// 显式提取高到低三个颜色分量，避免平台端序影响导出的颜色。
|
|
let rgb: Vec<_> = pixels
|
|
.iter()
|
|
.flat_map(|p| [(p >> 16) as u8, (p >> 8) as u8, *p as u8])
|
|
.collect();
|
|
encoder
|
|
.write_header()
|
|
.unwrap()
|
|
.write_image_data(&rgb)
|
|
.unwrap();
|
|
}
|
|
}
|
|
|
|
#[test]
|
|
/// 测试框架调用，验证真实 owner 定时任务、宽窄/高倍视口、喷火上限和 Page 关闭后的动画取消。
|
|
fn manuscript_script_snapshots_and_owned_animation_lifecycle() {
|
|
// 只追加测试推进函数，原示例本体不改；每次 step 前刷新 lastMove 以稳定触发运动场景。
|
|
let source = format!(
|
|
"{}\nfunction advanceTest():Unit {{dragon.lastMove=math.now() dragon.step()}}",
|
|
include_str!("../../../examples/illustrated-manuscript.endor")
|
|
);
|
|
for (width, height, scale) in [(1000., 900., 1.), (420., 760., 2.)] {
|
|
// 两种窗口使用独立 VM 与真实逻辑 viewport，窄视图同时覆盖高倍字体/图片采样。
|
|
let (mut session, mut document) = ReplSession::load_with_viewport(
|
|
&source,
|
|
"app.main",
|
|
1,
|
|
736,
|
|
Some(crate::layout::Size { width, height }),
|
|
)
|
|
.unwrap();
|
|
// 真实 owner-scoped Task 调用源 tick，先比较时间字段确认计时器而非宿主演示循环在推进。
|
|
let before = execute(&mut session, &mut document, "dragon.time");
|
|
// 等待超过示例定时截止时间，再在所属 VM poll，后台线程不会直接替程序改 time。
|
|
std::thread::sleep(std::time::Duration::from_millis(85));
|
|
if let Some(next) = session.poll_tasks().unwrap() {
|
|
// 只接收调度后真正完整发布文档，不从任务内部未收敛草稿截屏。
|
|
document = next;
|
|
}
|
|
// time 变化证明 owner/key 当前任务获得了一次有效交付。
|
|
let after = execute(&mut session, &mut document, "dragon.time");
|
|
assert_ne!(before, after);
|
|
execute(&mut session, &mut document, "view.timer.cancel()");
|
|
// 自动动画确认后取消，后续快照阶段由固定次数 step 控制；像素尺寸按逻辑尺寸乘 scale。
|
|
let (w, h) = ((width * scale) as u32, (height * scale) as u32);
|
|
write_png(
|
|
&document,
|
|
w,
|
|
h,
|
|
scale,
|
|
if width > 500. { "rest" } else { "narrow-rest" },
|
|
);
|
|
// 找当前真实指针出现并克隆几何，下面分派会改 document，不能保留对旧文档的借用。
|
|
let mount = document
|
|
.frame
|
|
.mounts
|
|
.iter()
|
|
.find(|m| m.pointer_events)
|
|
.unwrap()
|
|
.clone();
|
|
// 用视口比例选锚点，宽窄布局都位于同类内容区域，不依赖固定像素偏移。
|
|
let point = [mount.x + mount.width * 0.58, mount.y + mount.height * 0.50];
|
|
// 会话/版本/目标均从本轮 VM 和已发布帧取得，确保命中的是此视口而不是另一测试残留。
|
|
let mut input = crate::events::Input {
|
|
window: 1,
|
|
session: 736,
|
|
layout_version: document.frame.layout_version,
|
|
mount: mount.id,
|
|
kind: "pointermove".into(),
|
|
point: Some(point),
|
|
press_point: None,
|
|
delta: None,
|
|
tab_drop: None,
|
|
screen_position: None,
|
|
};
|
|
document = session
|
|
.dispatch(&input)
|
|
.unwrap()
|
|
.document
|
|
.unwrap_or(document);
|
|
for _ in 0..12 {
|
|
// 固定推进源运动，生成穿行状态，快照仍走实际 scene/paint/软件渲染链。
|
|
execute(&mut session, &mut document, "advanceTest()");
|
|
}
|
|
write_png(
|
|
&document,
|
|
w,
|
|
h,
|
|
scale,
|
|
if width > 500. { "crossing" } else { "narrow" },
|
|
);
|
|
input.layout_version = document.frame.layout_version;
|
|
input.kind = "pointerdown".into();
|
|
document = session
|
|
.dispatch(&input)
|
|
.unwrap()
|
|
.document
|
|
.unwrap_or(document);
|
|
// 按住并推进足够帧数达到粒子稳态上限，覆盖比静止更重的真实 paint 工作量。
|
|
// 计时仅作诊断输出，测试没有依赖机器速度的性能通过阈值。
|
|
let start = std::time::Instant::now();
|
|
for _ in 0..16 {
|
|
// 每次仍执行源 advanceTest，不能用原生测试循环直接生成粒子绕过语言能力。
|
|
execute(&mut session, &mut document, "advanceTest()");
|
|
}
|
|
eprintln!(
|
|
"Endor manuscript width={width}: 16 steady-fire VM refreshes {:?}",
|
|
start.elapsed()
|
|
);
|
|
assert_eq!(
|
|
execute(&mut session, &mut document, "dragon.flames.count <= 12"),
|
|
"true"
|
|
);
|
|
// 从源 artwork 与粒子速度对比最终图片角度，验证精灵轴校正符合源模型方向。
|
|
execute(
|
|
&mut session,
|
|
&mut document,
|
|
"function verifyFire(): Bool { art=dragon.artwork(0,0,1) c=art.at(art.count-1) p=dragon.flames.at(dragon.flames.count-1) return math.abs(c.angle+p.art.axis-math.atan2(p.vy,p.vx))<0.0001 }",
|
|
);
|
|
assert_eq!(execute(&mut session, &mut document, "verifyFire()"), "true");
|
|
// 单独验证最终绘图宽高，不只看粒子模型 size 字段，防止图片命令放大绕过尺寸预算。
|
|
execute(
|
|
&mut session,
|
|
&mut document,
|
|
"function verifyFireSize(): Bool { art=dragon.artwork(0,0,1) c=art.at(art.count-1) return math.max(c.width,c.height)<=20 }",
|
|
);
|
|
assert_eq!(
|
|
execute(&mut session, &mut document, "verifyFireSize()"),
|
|
"true"
|
|
);
|
|
write_png(
|
|
&document,
|
|
w,
|
|
h,
|
|
scale,
|
|
if width > 500. { "fire" } else { "narrow-fire" },
|
|
);
|
|
// Page 关闭须立即取消其 Mount 所有的任务；后续即使保留 dragon 对象也不能继续定时更新。
|
|
execute(&mut session, &mut document, "page.close()");
|
|
// 关闭时真实 time 是对照值，等待超过旧定时点再 poll 应完全不变。
|
|
let closed = execute(&mut session, &mut document, "dragon.time");
|
|
std::thread::sleep(std::time::Duration::from_millis(85));
|
|
session.poll_tasks().unwrap();
|
|
assert_eq!(execute(&mut session, &mut document, "dragon.time"), closed);
|
|
}
|
|
}
|