docs: 解释最新主线场景性能基准的采样与计时边界
This commit is contained in:
@@ -8,12 +8,14 @@ use crate::document::{NamespaceState, RenderCommand};
|
||||
const EXAMPLE: &str = include_str!("../../../examples/hello.endor");
|
||||
const PAGE: &str = include_str!("../../../examples/page.endor");
|
||||
|
||||
/// Opt-in release benchmark; run alone to avoid test-thread interference.
|
||||
/// 可选性能基准:分别测世界 UI 和普通三维场景在 1x/2x DPI 下的相机交互更新、变更绘制和同列表缓存绘制。
|
||||
/// 默认 ignore,需在已确认的构建环境中以 release 单测试线程运行,避免其他测试干扰;下面命令仅为运行说明。
|
||||
/// cargo test --release --locked scene_interaction_performance -- --ignored --nocapture --test-threads=1
|
||||
#[test]
|
||||
#[ignore]
|
||||
fn scene_interaction_performance() {
|
||||
use std::time::Instant;
|
||||
/// 对非空毫秒样本排序后返回均值、索引中位数和向上取整秩的 p95;调用方每组固定保留 30 次测量。
|
||||
fn summary(mut values: Vec<f64>) -> String {
|
||||
values.sort_by(f64::total_cmp);
|
||||
format!(
|
||||
@@ -23,6 +25,7 @@ fn scene_interaction_performance() {
|
||||
values[(values.len() * 95).div_ceil(100) - 1]
|
||||
)
|
||||
}
|
||||
// 每个场景/DPI 组合创建全新会话与像素缓冲,避免上一组合的相机状态和缓存直接污染下一组。
|
||||
for (name, source) in [
|
||||
("world-ui", include_str!("../../../examples/world-ui.endor")),
|
||||
("scene3d", include_str!("../../../examples/scene3d.endor")),
|
||||
@@ -44,6 +47,7 @@ fn scene_interaction_performance() {
|
||||
let mut updates = Vec::new();
|
||||
let mut draws = Vec::new();
|
||||
let mut cached = Vec::new();
|
||||
// 连续做 33 轮,前三轮预热;每轮使用最新发布版本构造事件,避免基准测到过期输入拒绝。
|
||||
for sample in 0..33 {
|
||||
let target = document
|
||||
.frame
|
||||
@@ -51,6 +55,7 @@ fn scene_interaction_performance() {
|
||||
.iter()
|
||||
.find(|mount| mount.scene3d_viewport)
|
||||
.unwrap();
|
||||
// 选当前帧第一个三维视口,小幅 orbit;带中心锚点使世界面板等坐标映射路径也有完整输入。
|
||||
let input = crate::events::Input {
|
||||
window: 1,
|
||||
session: document.frame.session,
|
||||
@@ -63,6 +68,7 @@ fn scene_interaction_performance() {
|
||||
tab_drop: None,
|
||||
screen_position: None,
|
||||
};
|
||||
// update 只计派发与完整文档刷新;display_list 构造在后面的绘制计时范围之外。
|
||||
let start = Instant::now();
|
||||
document = session.dispatch(&input).unwrap().document.unwrap();
|
||||
let update = start.elapsed().as_secs_f64() * 1000.;
|
||||
@@ -75,6 +81,7 @@ fn scene_interaction_performance() {
|
||||
height,
|
||||
)
|
||||
.unwrap();
|
||||
// 第一次 render 测相机已变化时的绘制;立即用同一列表再画一次,单独统计缓存重用路径。
|
||||
let draw = start.elapsed().as_secs_f64() * 1000.;
|
||||
let start = Instant::now();
|
||||
crate::software_renderer::SoftwareRenderer::render(
|
||||
@@ -84,6 +91,7 @@ fn scene_interaction_performance() {
|
||||
height,
|
||||
)
|
||||
.unwrap();
|
||||
// 三类样本按同一轮配对保存,仅舍弃预热数据,不改变真实执行的相机操作。
|
||||
if sample >= 3 {
|
||||
updates.push(update);
|
||||
draws.push(draw);
|
||||
@@ -96,6 +104,7 @@ fn scene_interaction_performance() {
|
||||
summary(draws),
|
||||
summary(cached)
|
||||
);
|
||||
// 额外打印派生工作量指标辅助解释耗时,不把这些查询本身算进上面的三类样本。
|
||||
for stat in ["measured", "arranged", "snapshotVisited"] {
|
||||
println!(
|
||||
"PERFSTAT {name} {stat}={}",
|
||||
|
||||
Reference in New Issue
Block a user