//! 把页面、2D 视口和 3D 视口的相机输入转换成托管对象更新。 //! 输入携带具体出现的 Mount;嵌套世界 UI 先做逆投影,避免把屏幕位移直接当成场景坐标。 //! //! UiBridge::dispatch 按输入 kind 分流到下面三个方法:整页、局部二维视口和局部三维场景分别处理。 //! 它们只在所属 VM worker 上修改托管相机属性或调用 controller.update,不直接改 GUI 已发布帧。 //! 姿态变化随后由正常依赖/快照刷新观察;任何新帧仍需走 layout/paint/commit 的完整发布路径。 use super::*; impl UiBridge { /// dispatch 的 scene-pan/orbit/zoom 分支调用,把命中出现位置的输入包装成 CameraGesture 交给控制器。 pub(super) fn dispatch_scene_view( &self, vm: &mut Vm, input: &crate::events::Input, ) -> Result<()> { // 锁内只读取当前发布版本与弱 Mount 身份,离开锁后才进入 VM 操作,避免持 session 锁调用用户代码。 let (weak, desktop) = { // 当前窗口已由外层选定;本锁内同时读版本和 Mount,避免把旧几何与新弱身份混用。 let state = self .session .lock() .map_err(|_| anyhow::anyhow!("UI session poisoned"))?; anyhow::ensure!( state.published_version == input.layout_version, "obsolete 3D camera view" ); ( *state .mounts .active .get(&input.mount) .ok_or_else(|| anyhow::anyhow!("3D viewport unavailable"))?, state.desktop, ) }; // upgrade 返回临时拥有根,下方即使任一步失败也通过闭包外的 release 清理。 let mount = vm .upgrade(weak)? .ok_or_else(|| anyhow::anyhow!("3D viewport Mount expired"))?; // 不能直接 ? 返回整个方法,否则错误时跳过 Mount 根释放;用闭包暂存处理结果。 let result = (|| { // 除 session 发布版本外,再检查目标自身仍挂接、版本匹配且确为 3D 视口,拒绝旧出现操作。 let occurrence = vm.payload::(mount, "Mount")?.clone(); anyhow::ensure!( occurrence.mounted && occurrence.version == input.layout_version && occurrence.geometry.scene3d_viewport, "obsolete 3D viewport" ); // resolve 跟随 Block 的共享替换关系,再读取实际视觉状态,不能只信任旧 payload。 let (_, data) = block::resolve(vm.object_store(), occurrence.block)?; // visual_data 合并当前可见属性,后面的相机/控制器来自模型而非原生画面的旧快照。 let data = block::visual_data(vm.object_store(), data)?; // 没有显式相机就无法解释手势,拒绝更新而不是猜一个默认相机改变场景语义。 let camera = data .camera .ok_or_else(|| anyhow::anyhow!("missing 3D camera"))?; // 显式配置 controller 才能接收 3D 手势;没有控制器的场景仍可显示,但不能自动修改相机。 let controller = data .controller .ok_or_else(|| anyhow::anyhow!("3D controller disabled"))?; // 同一视觉对象的边框/内边距由快照解析,手势锚点与可用尺寸都应扣除这部分。 let node = block::snapshot(vm.object_store(), occurrence.block)?; // inset 将外框换算成视口内容盒,避免控制器把边框尺寸算成场景宽高。 let inset = crate::layout::insets(&node); // 几何来自具体 Mount,两个窗口中共享同一场景仍可能有不同视图投影。 let geometry = &occurrence.geometry; // 外层二维视图逆变换用于锚点定位;没有视图变换时使用恒等变换。 let outer = geometry.view.unwrap_or_default(); // delta 的第一分量还会用作缩放倍率;缺失说明输入信封不满足相机事件要求。 let delta = input .delta .ok_or_else(|| anyhow::anyhow!("3D camera delta required"))?; // 缩放使用倍率而非二维位移;旋转/平移通过 logical_delta 处理嵌套二维/面板投影。 // 不可逆映射时忽略本次连续增量,不在无效坐标上继续更新相机。 let local_delta = if input.kind == "scene-zoom" { // 缩放不产生平移 dx/dy,只把原第一分量写到 gesture.factor。 [0., 0.] } else { // 平移/旋转先撤销外层投影;映射失败表示本帧增量无法可靠应用。 let Some(delta) = geometry.logical_delta(input.point, delta) else { return Ok(()); }; delta }; // 可用锚点先映回所在视口空间;无法取得时使用内容左上角,传给控制器的是扣除 inset 的局部点。 let point = input .point .and_then(|p| geometry.view_point(crate::geometry::Point::new(p[0], p[1]), false)) .map(|p| outer.inverse(p)) .unwrap_or(crate::geometry::Point::new( geometry.x + inset.left, geometry.y + inset.top, )); // 将输入封装为名义 CameraGesture 临时对象;不把原生 Input 或窗口指针直接交给源控制器。 let gesture = vm.new_object()?; // 临时手势也有独立拥有根;把附类型/写字段/控制器错误暂存,外层始终 release(gesture)。 let result = (|| { vm.attach_type( gesture, desktop_type(vm.object_store(), "CameraGesture", desktop)?, )?; vm.set_attr(gesture, "kind", Value::Text(input.kind.clone()))?; for (name, value) in [ ("dx", local_delta[0]), ("dy", local_delta[1]), // factor 复用原 delta 第一项,仅缩放种类按倍率解释;dx/dy 已经转换为逻辑位移。 ("factor", delta[0]), ("width", (geometry.width - inset.horizontal()).max(0.)), ("height", (geometry.height - inset.vertical()).max(0.)), ("pointX", point.x - geometry.x - inset.left), ("pointY", point.y - geometry.y - inset.top), ] { // 全部数值通过统一语言数值编码写属性,控制器读取的是普通托管字段。 vm.set_attr(gesture, name, crate::native_visual::value(value))?; } // 绑定 controller.update 保留接收者语义,再带 camera/gesture 两个显式参数进行有界调用。 let function = vm.bind_attr(controller, "update")?; // callable 校验在 VM 执行边界继续完成,非对象方法值直接作为契约错误返回。 let result = match function { Value::Object(function) => vm.call_with_limits( function, &[Value::Object(camera), Value::Object(gesture)], endor_core::ExecutionLimits { max_frames: 128, max_instructions: 1_000_000, }, ), _ => Err(invalid("controller.update is not callable")), }; // 先保存调用结果再释放绑定方法,错误路径同样清理;成功返回值也不保留为业务状态。 vm.release_value(function)?; vm.release_value(result?)?; Ok(()) })(); // 临时手势无论控制器成功或失败均释放,然后返回先前处理结果。 vm.release(gesture)?; result })(); // upgrade 得到的拥有根在闭包执行后统一释放,内部任一步失败也不会遗留该临时根。 vm.release(mount)?; result } /// dispatch 的 viewport-pan/zoom 分支调用,逆投影具体 CanvasViewport 输入并改写其 Camera2D 属性。 pub(super) fn dispatch_viewport_view( &self, vm: &mut Vm, input: &crate::events::Input, ) -> Result<()> { // 二维视口同样先校验发布版本,再从活动表捕获原 Mount,不能因目标消失自动换成另一个视口。 let weak = { // 锁内只检查发布版本并复制弱身份;下面读取相机和写 VM 属性时不持有会话锁。 let state = self .session .lock() .map_err(|_| anyhow::anyhow!("UI session poisoned"))?; anyhow::ensure!( state.published_version == input.layout_version, "obsolete viewport view" ); *state .mounts .active .get(&input.mount) .ok_or_else(|| anyhow::anyhow!("viewport is no longer active"))? }; // 临时根保证输入处理期间 Mount 仍可读取,方法尾部无论成功失败都释放。 let mount = vm .upgrade(weak)? .ok_or_else(|| anyhow::anyhow!("viewport Mount expired"))?; // 闭包集中实际处理,使所有 ? 都先回到统一释放路径。 let result = (|| { // 弱身份能升级不代表仍挂载/版本有效,先验证具体出现上下文。 let occurrence = vm.payload::(mount, "Mount")?; anyhow::ensure!( occurrence.mounted && occurrence.version == input.layout_version && occurrence.geometry.canvas_viewport, "obsolete viewport occurrence" ); // 复制几何和 Block 身份,结束 occurrence 对 VM 的借用后才能改写相机。 let geometry = occurrence.geometry.clone(); // Block 只用于找相机/边距,输入定位仍来自 Mount 的几何。 let block = occurrence.block; // 共享替换后的实际视觉状态才包含当前相机引用。 let (_, data) = block::resolve(vm.object_store(), block)?; // 托管属性覆盖 payload 缺省值,保持与布局/绘制同一视觉读取约定。 let data = block::visual_data(vm.object_store(), data)?; // 局部视口必须有 Camera2D,不把整页 Surface 当作相机替代。 let camera = data .camera .ok_or_else(|| anyhow::anyhow!("viewport has no camera"))?; // 读取已校验的相机快照作为本次基准;共享相机用户会通过普通属性变更观察到相同更新。 let old = crate::viewport::camera(vm.object_store(), camera)?; // 该分量在 zoom 时表示倍率,在 pan 时表示外部逻辑位移,随后分支分别解释。 let delta = input .delta .ok_or_else(|| anyhow::anyhow!("viewport input has no delta"))?; // 基于旧快照计算三个新值,完成验证后才依次回写托管属性。 let (mut x, mut y, mut zoom) = (old.x, old.y, old.zoom); if input.kind == "viewport-zoom" { // 缩放必须有锚点,不能让缺失指针导致隐式绕视口原点缩放。 let pointer = input .point .ok_or_else(|| anyhow::anyhow!("zoom requires anchor"))?; // 先用屏幕/视图坐标做外框检查,再逆投影到布局逻辑坐标。 let pointer = crate::geometry::Point::new(pointer[0], pointer[1]); anyhow::ensure!( geometry.contains(pointer), "zoom anchor is outside viewport" ); // 外框命中不保证投影可逆;None 作为错误返回,不能继续使用原屏幕数值。 let pointer = geometry .logical_point(pointer) .ok_or_else(|| anyhow::anyhow!("zoom anchor cannot be projected"))?; // 当前 Block 快照给出布局边距,用它取得正确内容盒的缩放锚点。 let node = block::snapshot(vm.object_store(), block)?; // inset 与布局模块共用同一规则,避免相机手势与绘制对内容原点理解不同。 let inset = crate::layout::insets(&node); // 已验证指针落在出现外框还不够;扣除 inset 后必须落入实际内容盒,禁止用边框作为缩放锚点。 let local = [ pointer.x - geometry.x - inset.left, pointer.y - geometry.y - inset.top, ]; anyhow::ensure!( local[0] >= 0.0 && local[1] >= 0.0 && local[0] < geometry.width - inset.horizontal() && local[1] < geometry.height - inset.vertical(), "zoom anchor is outside content viewport" ); // 以实际钳制后的新 zoom 反求 pan,保持锚点下世界位置:old_pan + local/old_zoom = new_pan + local/new_zoom。 zoom = (old.zoom * delta[0]).clamp(0.01, 100.0); x += local[0] / old.zoom - local[0] / zoom; y += local[1] / old.zoom - local[1] / zoom; } else { // 平移没有锚点保持公式,只需逆投影增量再除相机自身缩放。 let Some(delta) = geometry.logical_delta(input.point, delta) else { return Ok(()); }; // 屏幕/父层逻辑位移先撤销外层投影,再除本视口 zoom 转为相机世界偏移,不能直接加原像素增量。 x += delta[0] / zoom; y += delta[1] / zoom; } // 把世界偏移限制回模型坐标预算,再走 set_attr 变更追踪,不直接改原生渲染快照。 x = x.clamp(-MAX_DIMENSION as f32, MAX_DIMENSION as f32); y = y.clamp(-MAX_DIMENSION as f32, MAX_DIMENSION as f32); vm.set_attr(camera, "x", crate::native_visual::value(x))?; vm.set_attr(camera, "y", crate::native_visual::value(y))?; vm.set_attr(camera, "zoom", crate::native_visual::value(zoom))?; Ok(()) })(); // release 发生在 result? 之前,保证投影/属性写入错误不会泄漏升级得到的 Mount。 vm.release(mount)?; result } /// dispatch 的 page-pan/zoom 分支调用,兼容旧 Page 表面相机;独立 CanvasViewport 不走此方法。 pub(super) fn dispatch_page_view( &self, vm: &mut Vm, input: &crate::events::Input, ) -> Result<()> { // 兼容 Page 相机不通过 Mount 定位,而是读取当前活动页面及其 Surface 副本;发布版本仍必须一致。 let (page, mut surface, viewport) = { // 只复制当前已发布页的相机与真实视口,不持锁执行下面的坐标计算或 VM 属性写入。 let state = self .session .lock() .map_err(|_| anyhow::anyhow!("UI session poisoned"))?; anyhow::ensure!( state.published_version == input.layout_version, "obsolete page view" ); ( state .active .ok_or_else(|| anyhow::anyhow!("no active Page"))?, state.surface.clone(), state.layout.viewport, ) }; // 外层信封校验之后仍要求本路径必需的增量字段,防止不完整调用静默改变相机。 let delta = input .delta .ok_or_else(|| anyhow::anyhow!("page view requires delta"))?; if input.kind == "page-zoom" { // 旧 Page 模式只允许 Canvas 缩放,有限文档或 Window 页面保持各自尺寸语义。 anyhow::ensure!( surface.mode == crate::page::Mode::Canvas, "zoom requires canvas mode" ); // 以光标为缩放锚点,先要求它存在,再检查可用视口范围。 let pointer = input .point .ok_or_else(|| anyhow::anyhow!("zoom requires anchor"))?; // 转为页面几何共用的 Point,便于调用 Surface::to_world 做缩放前逆变换。 let pointer = crate::geometry::Point::new(pointer[0], pointer[1]); anyhow::ensure!( pointer.x >= 0.0 && pointer.y >= 0.0 && viewport.is_none_or(|v| pointer.x < v.width && pointer.y < v.height), "zoom anchor is outside viewport" ); // 先保留旧缩放下锚点对应的世界点,再调整 zoom 并解新 pan,避免缩放时内容从光标下漂移。 let world = surface.to_world(pointer); surface.zoom = (surface.zoom * delta[0]).clamp(0.1, 4.0); surface.pan = crate::geometry::Point::new( world.x - pointer.x / surface.zoom, world.y - pointer.y / surface.zoom, ); } else { // 平移按当前 zoom 换成世界距离,不直接把屏幕像素累加进世界 pan。 surface.pan.x += delta[0] / surface.zoom; surface.pan.y += delta[1] / surface.zoom; } // 有限页面按当前内容/视口钳制;Window 会重置导航,Canvas 则保留自由 pan/zoom。 if let Some(viewport) = viewport { surface.clamp(viewport); } // 内容模式 clamp 之外再加通用坐标预算;Canvas 可自由漫游,但也不能无限增长偏移。 let limit = MAX_DIMENSION as f32; surface.pan.x = surface.pan.x.clamp(-limit, limit); surface.pan.y = surface.pan.y.clamp(-limit, limit); // 最终回写活动 Page 的普通托管属性,后续刷新重新提取 Surface;此函数不直接发布原生帧。 vm.set_attr(page, "panX", crate::native_visual::value(surface.pan.x))?; vm.set_attr(page, "panY", crate::native_visual::value(surface.pan.y))?; vm.set_attr(page, "zoom", crate::native_visual::value(surface.zoom))?; Ok(()) } }