docs: explain hit selection and scroll viewport projection order

This commit is contained in:
2026-11-12 20:43:30 +08:00
parent 45b0b53d4f
commit afff46c0a8
4 changed files with 17 additions and 0 deletions
+2
View File
@@ -136,6 +136,7 @@ impl DisplayList {
/// 按设备比例缩放命令,文字、边框和矩形不能分别使用不一致比例。
pub fn scale(&mut self, scale: f32) {
// 原地累计缩放:重复调用会相乘,并非设置绝对缩放值。调用方负责提供有效设备比例。
// scene 合成宿主 chrome 时调用;只改视口/局部几何,不重新解码 Image 或重建 Scene3D 世界数据。
for command in &mut self.commands {
// 先处理各变体独有的长度(字体、圆角、描边),再把公共矩形交给下方统一缩放。
let rect = match command {
@@ -231,6 +232,7 @@ impl DisplayList {
/// 按原顺序合并另一组绘制命令,不在这里重排层次。
// 消费另一个列表并移动其命令,不复制字符串或场景数据,也不在连接处补裁剪指令。
pub fn extend(&mut self, other: DisplayList) {
// 连接处不自动隔离 Clear 或裁剪状态;scene 合并页面时会自行跳过额外 Clear,并用外层 PushClip/PopClip 限制页面区域。
self.commands.extend(other.commands);
}
}