AskaEth
70dea995b7
两处拆分，只为过 `gate::every_source_file_stays_under_the_line_limit`： - `download/rails.rs` 435 行 → `rails.rs` 311 + `rails/major.rs` 157：主版本桶那一栏 （`major_rail` / `major_entries` / `major_shape` / `MajorEntry` / `MajorShape`）搬进子模块， `rail_title` 留在父模块（两条栏共用）。`Key::VersionMajorTitle` 的落点跟着搬， `tests/i18n.rs` 的死 key 扫描表补上 `rails/major.rs`（漏扫会把活 key 判成死 key）。 - `tests/options_shot.rs` 475 行 → 345 + `options_shot/chips.rs` 75 + `options_shot/compact.rs` 67。 顺带修 `options_shot::bands()` 的一处既有缺口：它按三栏算列表列左缘（112+0+24+0+24 = 160）， chips 档没有侧栏时这个左缘是错的，右缘跟着冲出画面 22px——M125 的 chips 守门正好踩到 「扫描越界读到下一行像素」，`first_rule_y` 因此恒返回 None。现在 chips 档直接取页左缘 （112），三栏三档的数值一个不变（M123 那些 140/140、缝 24 的断言照旧）。 守门实跑（本机，tiny-skia）： - 解 ignore 的 `chips::a_chips_tier_shot_…` 在修后图绿、**修前图红**（实测 18px ≠ 44）； - `compact::a_compact_tier_shot_…` 修后图绿、修前图红（实测 44px 文字行 ≠ 40px 图标按钮）； - chips 那条换深色图同样绿（断言不依赖主题色）。
353 lines
13 KiB
Rust
353 lines
13 KiB
Rust
//! 选项区 × 三栏的**像素**验收（M123 ①）：真 PNG 上的几何断言。
|
||
//!
|
||
//! ## 为什么还要一条像素测试
|
||
//!
|
||
//! [`super::options_screen`] 断的是「喂给树的模型 + 裁决出来的数字」，它抓不住**画出来**：
|
||
//! 两栏是不是真同屏、栏宽有没有按裁决落地、版本行有没有被压成一条缝、确认键是不是还在屏内。
|
||
//! 那些只有图能回答——所以这里直接量 `pages_demo` 出的 PNG，按**产品自己的裁决函数**
|
||
//! （[`VersionRails::of_metrics`] + [`frame_metrics`]）推出每一栏该在的 x 区间，再要求像素同意。
|
||
//!
|
||
//! ## 开关与跑法（与 `components/*/probe.rs` 同一族范式：没有图就 SKIP，不假绿）
|
||
//!
|
||
//! ```text
|
||
//! # ① 1180 宽（Wide 档，两栏都展开）
|
||
//! ULL_DL_DEMO=options-fabric cargo run -p unlucky-app-iced --example pages_demo -- \
|
||
//! --screen=download --width=1180 --height=760 --screenshot=opt.png \
|
||
//! --screenshot-theme=light --software-renderer
|
||
//! ULL_DL_OPTIONS_SHOT=opt.png cargo test -p unlucky-app-iced --lib options_shot
|
||
//! ```
|
||
//!
|
||
//! 颜色**不**写死：`run_at` 只要求「同一段颜色连续」，栏与栏的边界按「颜色变了」判，
|
||
//! 于是浅色/深色都能跑同一条断言（实测浅色下 Card=(235,245,255)、Canvas=(246,250,255)）。
|
||
|
||
use std::path::PathBuf;
|
||
|
||
use unlucky_design::color::SchemeFlavor;
|
||
use unlucky_design::typography::Platform;
|
||
|
||
use crate::pages::layout::rails::RAIL_GAP;
|
||
use crate::pages::layout::{available_width, frame_metrics, PaneKit, VersionRails};
|
||
use crate::theme::{Families, Ui};
|
||
|
||
const FAMILIES: Families = Families {
|
||
text: "Segoe UI",
|
||
display: "Segoe UI",
|
||
mono: "Consolas",
|
||
};
|
||
|
||
/// 1180 宽那张（`01-options-fabric-en-light.png`）。
|
||
const WIDE_SHOT: &str = "ULL_DL_OPTIONS_SHOT";
|
||
/// 700 宽那张（`02-options-fabric-en-light-chips700.png`）——chips 档回归守门用。
|
||
const CHIPS_SHOT: &str = "ULL_DL_CHIPS_SHOT";
|
||
/// 736 宽那张（`04-options-fabric-en-light-compact736.png`）——Compact 档主版本栏用。
|
||
const COMPACT_SHOT: &str = "ULL_DL_COMPACT_SHOT";
|
||
|
||
fn ui() -> Ui {
|
||
Ui::with_platform(SchemeFlavor::Light, Platform::Windows, FAMILIES)
|
||
}
|
||
|
||
fn shot_path(key: &str) -> Option<PathBuf> {
|
||
let path = PathBuf::from(std::env::var_os(key)?);
|
||
if path.is_absolute() || path.exists() {
|
||
return Some(path);
|
||
}
|
||
let root = PathBuf::from(env!("CARGO_MANIFEST_DIR")).join("../..");
|
||
Some(root.join(path))
|
||
}
|
||
|
||
/// 一张 RGB 图（只留本文件要用的那两件事：宽高 + 取点）。
|
||
struct Shot {
|
||
width: usize,
|
||
height: usize,
|
||
pixels: Vec<[u8; 3]>,
|
||
}
|
||
|
||
impl Shot {
|
||
fn load(path: &std::path::Path) -> Self {
|
||
let bytes = std::fs::read(path).expect("读截图");
|
||
let image = image::load_from_memory(&bytes).expect("解 PNG").to_rgb8();
|
||
let (width, height) = (image.width() as usize, image.height() as usize);
|
||
Self {
|
||
width,
|
||
height,
|
||
pixels: image.pixels().map(|pixel| pixel.0).collect(),
|
||
}
|
||
}
|
||
|
||
fn at(&self, x: usize, y: usize) -> [u8; 3] {
|
||
self.pixels[y * self.width + x]
|
||
}
|
||
|
||
/// `(起点, 长度)`：`(x, y)` 所在的那一段**同色**横条。
|
||
fn run_at(&self, x: usize, y: usize) -> (usize, usize) {
|
||
let color = self.at(x, y);
|
||
let mut start = x;
|
||
while start > 0 && self.at(start - 1, y) == color {
|
||
start -= 1;
|
||
}
|
||
let mut end = x;
|
||
while end + 1 < self.width && self.at(end + 1, y) == color {
|
||
end += 1;
|
||
}
|
||
(start, end - start + 1)
|
||
}
|
||
|
||
/// 在 `x` 这一竖列上，`[from, to)` 里**第一段**与 `background` 不同的连续区：`(top, height)`。
|
||
///
|
||
/// 用它量「第一行版本行有多高」：选中行有底色，行外是页面底色，两段一夹就是行高。
|
||
fn first_filled_band(
|
||
&self,
|
||
x: usize,
|
||
from: usize,
|
||
to: usize,
|
||
background: [u8; 3],
|
||
) -> Option<(usize, usize)> {
|
||
let filled = |y: usize| self.at(x, y) != background;
|
||
let top = (from..to.min(self.height)).find(|y| filled(*y))?;
|
||
let mut bottom = top;
|
||
while bottom + 1 < to.min(self.height) && filled(bottom + 1) {
|
||
bottom += 1;
|
||
}
|
||
Some((top, bottom - top + 1))
|
||
}
|
||
|
||
/// `[from, to)` 里最长的一段**同色**横条：`(y, 长度)`（颜色必须与底色不同）。
|
||
///
|
||
/// 用它找面板里那条实心「安装」按钮：它是列表列里唯一一条 ≥ 80px 的实色带。
|
||
fn longest_run(
|
||
&self,
|
||
left: usize,
|
||
right: usize,
|
||
from: usize,
|
||
to: usize,
|
||
background: [u8; 3],
|
||
) -> (usize, usize) {
|
||
let mut best = (0, 0);
|
||
for y in from..to.min(self.height) {
|
||
let mut run = 0;
|
||
let mut color = background;
|
||
for x in left..right {
|
||
let pixel = self.at(x, y);
|
||
if pixel == background {
|
||
color = background;
|
||
run = 0;
|
||
} else if pixel == color {
|
||
run += 1;
|
||
} else {
|
||
color = pixel;
|
||
run = 1;
|
||
}
|
||
if run > best.1 {
|
||
best = (y, run);
|
||
}
|
||
}
|
||
}
|
||
best
|
||
}
|
||
|
||
/// 列表列里最后一行**有内容**的 y（`None` = 整列都是底色）。
|
||
fn last_ink_row(&self, left: usize, right: usize, background: [u8; 3]) -> Option<usize> {
|
||
(0..self.height).rev().find(|y| {
|
||
(left..right).any(|x| {
|
||
let pixel = self.at(x, *y);
|
||
pixel
|
||
.iter()
|
||
.zip(background)
|
||
.map(|(a, b)| u32::from(a.abs_diff(b)))
|
||
.sum::<u32>()
|
||
> 12
|
||
})
|
||
})
|
||
}
|
||
|
||
/// `y` 这一行上、含 `x` 的那段**连续非底色**区：`(起点, 长度)`。
|
||
///
|
||
/// 与 [`Shot::run_at`] 的区别：颜色可以变（药丸底色 + 里面的图标墨迹算同一块）。
|
||
fn fill_run(
|
||
&self,
|
||
y: usize,
|
||
left: usize,
|
||
right: usize,
|
||
x: usize,
|
||
background: [u8; 3],
|
||
) -> (usize, usize) {
|
||
let filled = |x: usize| self.at(x, y) != background;
|
||
let mut start = x;
|
||
while start > left && filled(start - 1) {
|
||
start -= 1;
|
||
}
|
||
let mut end = x;
|
||
while end + 1 < right && filled(end + 1) {
|
||
end += 1;
|
||
}
|
||
(start, end - start + 1)
|
||
}
|
||
|
||
/// 列表列里、`from` 起的**第一条薄通栏横线**的 y（`divider::full` 画的那条 1px 线）。
|
||
///
|
||
/// 用它量「版本列表到哪儿为止」：尾部面板上沿有一条通栏分隔线，它上面的高度就是列表拿到的。
|
||
/// 只认**薄**线（上下两行都与它不同色）——选中行的底色带也是通栏的，那是 44px 的块，不是线。
|
||
fn first_rule_y(
|
||
&self,
|
||
left: usize,
|
||
right: usize,
|
||
from: usize,
|
||
background: [u8; 3],
|
||
) -> Option<usize> {
|
||
let thin = |y: usize| {
|
||
let color = self.at(left + 2, y);
|
||
color != background
|
||
&& (left + 2..right.saturating_sub(2)).all(|x| self.at(x, y) == color)
|
||
&& (y == 0 || self.at(left + 2, y - 1) != color)
|
||
&& (y + 1 >= self.height || self.at(left + 2, y + 1) != color)
|
||
};
|
||
(from..self.height).find(|y| thin(*y))
|
||
}
|
||
}
|
||
|
||
/// 三栏的 x 区间，全部从**产品自己的裁决函数**推出来（不是手抄的像素坐标）。
|
||
struct Bands {
|
||
type_rail: (usize, f32),
|
||
major_rail: (usize, f32),
|
||
list: (usize, f32),
|
||
}
|
||
|
||
fn bands(width: f32) -> Bands {
|
||
let ui = ui();
|
||
let rails = VersionRails::of_metrics(frame_metrics(PaneKit::Single, width));
|
||
// 可用宽 = 窗口 − 导航轨 − 两侧页边距 ⇒ 页边距反推出来（只有左侧那一份进左缘）
|
||
let avail = available_width(width);
|
||
let gutter = (width - avail - ui.metrics().nav_rail_width) / 2.0;
|
||
assert!(
|
||
(gutter - 24.0).abs() < 0.01,
|
||
"页边距应当是一格 24：{gutter}"
|
||
);
|
||
let left = (width - avail - gutter).round() as usize;
|
||
assert_eq!(
|
||
left,
|
||
(ui.metrics().nav_rail_width + gutter).round() as usize,
|
||
"页左缘 = 导航轨 + 一格页边距"
|
||
);
|
||
assert_eq!(left, 112, "harness 的导航轨 88 + 页边距 24");
|
||
let type_rail = (left, rails.type_rail);
|
||
let major_rail = (
|
||
left + rails.type_rail as usize + RAIL_GAP as usize,
|
||
rails.major_rail,
|
||
);
|
||
// chips 档没有两条侧栏（宽度都是 0）：列表就是整条可用宽，左缘 = 页左缘。
|
||
// 不分支的话会算成 `112 + 0 + 24 + 0 + 24 = 160`，右缘跟着冲出画面 22px
|
||
// （M125 缺陷 1 的守门就是在这里踩到「扫描越界读下一行像素」的）。
|
||
let list = if rails.tier.is_three_column() {
|
||
(
|
||
major_rail.0 + rails.major_rail as usize + RAIL_GAP as usize,
|
||
rails.list,
|
||
)
|
||
} else {
|
||
(left, rails.list)
|
||
};
|
||
Bands {
|
||
type_rail,
|
||
major_rail,
|
||
list,
|
||
}
|
||
}
|
||
|
||
/// `01-options-fabric-en-light.png`（1180×760）上的四条断言。
|
||
///
|
||
/// 抓得住：①两条侧栏**同时**在同一条扫描线上画出来（不是只有一条、也不是其中一条塌成 0 宽）；
|
||
/// ②两条栏各自的像素宽度 = `VersionRails` 裁决出来的 140/140，栏间 24 的缝真的空着（栏没有重叠）；
|
||
/// ③版本行至少有一行**完整**（44 = `row_height`），即列表没有被面板压成「缝」；
|
||
/// ④选项区的确认键与「实例名」都在屏内（列表列最下面一行墨迹离窗口底边还有余量）。
|
||
///
|
||
/// 抓不住：文本有没有被裁（那要看字形宽度，见报告「没验的部分」）、hover/tooltip 层（静态图拍不到）、
|
||
/// 深色主题下的对比度（本条只跑浅色图；深色另用同一 argv 换 `--screenshot-theme` 出图人看）。
|
||
#[test]
|
||
fn an_options_shot_shows_both_rails_and_the_whole_panel() {
|
||
let Some(path) = shot_path(WIDE_SHOT) else {
|
||
eprintln!(
|
||
"[options-shot] SKIPPED：未设置 {WIDE_SHOT}。这是**渲染层**几何断言，\
|
||
需要先出图（见本文件模块文档的 1180 那张）。"
|
||
);
|
||
return;
|
||
};
|
||
let shot = Shot::load(&path);
|
||
assert_eq!(
|
||
(shot.width, shot.height),
|
||
(1180, 760),
|
||
"验收图必须 1180×760"
|
||
);
|
||
|
||
let bands = bands(1180.0);
|
||
let ui = ui();
|
||
let y = 400;
|
||
|
||
// ① 两条栏同时画在同一条扫描线上，且宽度 = 裁决值（像素边界一条不差）
|
||
for (name, (start, width)) in [("类型栏", bands.type_rail), ("主版本栏", bands.major_rail)]
|
||
{
|
||
let (run_start, run_len) = shot.run_at(start + 8, y);
|
||
assert_eq!(
|
||
(run_start, run_len as f32),
|
||
(start, width),
|
||
"{name}：像素区间与 `VersionRails` 裁决不一致（y={y}）"
|
||
);
|
||
assert_ne!(
|
||
shot.at(start, y),
|
||
shot.at(start.saturating_sub(1), y),
|
||
"{name}：左缘没有边界"
|
||
);
|
||
}
|
||
// 栏间 24 的缝真的空着（两条栏没有叠在一起），且列表列不是面板底色
|
||
let gap_x = bands.type_rail.0 + bands.type_rail.1 as usize + RAIL_GAP as usize / 2;
|
||
assert_eq!(
|
||
shot.at(gap_x, y),
|
||
shot.at(gap_x - 1, y),
|
||
"两栏之间的缝被填掉了（栏重叠或间距丢失）"
|
||
);
|
||
assert_ne!(
|
||
shot.at(gap_x, y),
|
||
shot.at(bands.type_rail.0, y),
|
||
"缝与栏同色 ⇒ 读不出「两条栏」"
|
||
);
|
||
assert_ne!(
|
||
shot.at(bands.list.0 + 8, y),
|
||
shot.at(bands.major_rail.0, y),
|
||
"列表列被侧栏底色盖住了"
|
||
);
|
||
|
||
// ③ 完整的一行版本行：第一行（选中行）的底色带必须正好一行高（`row_height` = 44）
|
||
let canvas = shot.at(bands.list.0 + 2, 12);
|
||
let (_, row_height) = shot
|
||
.first_filled_band(bands.list.0 + 60, 235, 520, canvas)
|
||
.expect("列表列里应当有版本行");
|
||
assert_eq!(
|
||
row_height as f32,
|
||
ui.metrics().row_height,
|
||
"版本行被裁/被压：实测可视行高 {row_height}，应为 {}",
|
||
ui.metrics().row_height
|
||
);
|
||
|
||
// ④ 选项区整块在屏内：列表列最下面的墨迹离底边还有余量（被切的话它会贴到 759）
|
||
let last = shot
|
||
.last_ink_row(
|
||
bands.list.0,
|
||
bands.list.0 + bands.list.1 as usize - 2,
|
||
canvas,
|
||
)
|
||
.expect("列表列里应当有内容");
|
||
assert!(
|
||
last + 8 < shot.height,
|
||
"选项区被窗口底边切掉：最后一行墨迹在 y={last}（图高 {}）",
|
||
shot.height
|
||
);
|
||
assert!(
|
||
last > 600,
|
||
"选项区不在屏上：最后一行墨迹在 y={last}，解析应当有「实例名」那一格"
|
||
);
|
||
}
|
||
|
||
// ---- chips 档（缺陷 1）与 Compact 档（缺陷 2）的像素守门（拆出来守 400 行红线）
|
||
|
||
mod chips;
|
||
|
||
mod compact;
|