docs: clarify UI registration signatures and visual snapshot fields
This commit is contained in:
@@ -3,7 +3,8 @@
|
||||
//!
|
||||
//! UiBridge::dispatch 按输入 kind 分流到下面三个方法:整页、局部二维视口和局部三维场景分别处理。
|
||||
//! 它们只在所属 VM worker 上修改托管相机属性或调用 controller.update,不直接改 GUI 已发布帧。
|
||||
//! 姿态变化随后由正常依赖/快照刷新观察;任何新帧仍需走 layout/paint/commit 的完整发布路径。
|
||||
//! 姿态变化随后由正常依赖/快照刷新观察;任何新帧仍需完成布局、桥接挂载提交、绘制和稳定发布。
|
||||
//! 这三个入口由 dispatch 在信封校验与选窗检查之后调用;内部仍分别验证发布版本和该手势所需的目标/坐标字段。
|
||||
use super::*;
|
||||
|
||||
impl UiBridge {
|
||||
@@ -61,6 +62,7 @@ impl UiBridge {
|
||||
.ok_or_else(|| anyhow::anyhow!("3D controller disabled"))?;
|
||||
// 同一视觉对象的边框/内边距由快照解析,手势锚点与可用尺寸都应扣除这部分。
|
||||
let node = block::snapshot(vm.object_store(), occurrence.block)?;
|
||||
// 此处的一次性快照只用于读取盒模型,不替换 Presentation 的视觉缓存,也不提交新的布局或画面。
|
||||
// inset 将外框换算成视口内容盒,避免控制器把边框尺寸算成场景宽高。
|
||||
let inset = crate::layout::insets(&node);
|
||||
// 几何来自具体 Mount,两个窗口中共享同一场景仍可能有不同视图投影。
|
||||
@@ -198,6 +200,7 @@ impl UiBridge {
|
||||
.delta
|
||||
.ok_or_else(|| anyhow::anyhow!("viewport input has no delta"))?;
|
||||
// 基于旧快照计算三个新值,完成验证后才依次回写托管属性。
|
||||
// x/y 是世界偏移而非屏幕位移;几何先撤外层投影,除以本相机 zoom 后才属于可累加到 x/y 的单位。
|
||||
let (mut x, mut y, mut zoom) = (old.x, old.y, old.zoom);
|
||||
if input.kind == "viewport-zoom" {
|
||||
// 缩放必须有锚点,不能让缺失指针导致隐式绕视口原点缩放。
|
||||
|
||||
Reference in New Issue
Block a user