290 lines
14 KiB
Rust
290 lines
14 KiB
Rust
//! 把页面、2D 视口和 3D 视口的相机输入转换成托管对象更新。
|
|
//! 输入携带具体出现的 Mount;嵌套世界 UI 先做逆投影,避免把屏幕位移直接当成场景坐标。
|
|
//!
|
|
//! Camera mutations run on the owning VM worker, just like other page input.
|
|
use super::*;
|
|
|
|
impl UiBridge {
|
|
/// 解码指定 3D 视口的旋转/平移/缩放输入,再调用其托管相机控制器。
|
|
pub(super) fn dispatch_scene_view(
|
|
&self,
|
|
vm: &mut Vm,
|
|
input: &crate::events::Input,
|
|
) -> Result<()> {
|
|
// 锁内只读取当前发布版本与弱 Mount 身份,离开锁后才进入 VM 操作,避免持 session 锁调用用户代码。
|
|
let (weak, desktop) = {
|
|
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,
|
|
)
|
|
};
|
|
let mount = vm
|
|
.upgrade(weak)?
|
|
.ok_or_else(|| anyhow::anyhow!("3D viewport Mount expired"))?;
|
|
let result = (|| {
|
|
// 除 session 发布版本外,再检查目标自身仍挂接、版本匹配且确为 3D 视口,拒绝旧出现操作。
|
|
let occurrence = vm.payload::<crate::mount::Mount>(mount, "Mount")?.clone();
|
|
anyhow::ensure!(
|
|
occurrence.mounted
|
|
&& occurrence.version == input.layout_version
|
|
&& occurrence.geometry.scene3d_viewport,
|
|
"obsolete 3D viewport"
|
|
);
|
|
let (_, data) = block::resolve(vm.object_store(), occurrence.block)?;
|
|
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)?;
|
|
let inset = crate::layout::insets(&node);
|
|
let geometry = &occurrence.geometry;
|
|
let outer = geometry.view.unwrap_or_default();
|
|
let delta = input
|
|
.delta
|
|
.ok_or_else(|| anyhow::anyhow!("3D camera delta required"))?;
|
|
// 缩放使用倍率而非二维位移;旋转/平移通过 logical_delta 处理嵌套二维/面板投影。
|
|
// 不可逆映射时忽略本次连续增量,不在无效坐标上继续更新相机。
|
|
let local_delta = if input.kind == "scene-zoom" {
|
|
[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()?;
|
|
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")?;
|
|
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
|
|
}
|
|
|
|
/// 把具体 CanvasViewport 的位移或缩放锚点映射到其显式 Camera2D。
|
|
pub(super) fn dispatch_viewport_view(
|
|
&self,
|
|
vm: &mut Vm,
|
|
input: &crate::events::Input,
|
|
) -> Result<()> {
|
|
// 二维视口同样先校验发布版本,再从活动表捕获原 Mount,不能因目标消失自动换成另一个视口。
|
|
let weak = {
|
|
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"))?
|
|
};
|
|
let mount = vm
|
|
.upgrade(weak)?
|
|
.ok_or_else(|| anyhow::anyhow!("viewport Mount expired"))?;
|
|
let result = (|| {
|
|
let occurrence = vm.payload::<crate::mount::Mount>(mount, "Mount")?;
|
|
anyhow::ensure!(
|
|
occurrence.mounted
|
|
&& occurrence.version == input.layout_version
|
|
&& occurrence.geometry.canvas_viewport,
|
|
"obsolete viewport occurrence"
|
|
);
|
|
let geometry = occurrence.geometry.clone();
|
|
let block = occurrence.block;
|
|
let (_, data) = block::resolve(vm.object_store(), block)?;
|
|
let data = block::visual_data(vm.object_store(), data)?;
|
|
let camera = data
|
|
.camera
|
|
.ok_or_else(|| anyhow::anyhow!("viewport has no camera"))?;
|
|
// 读取已校验的相机快照作为本次基准;共享相机用户会通过普通属性变更观察到相同更新。
|
|
let old = crate::viewport::camera(vm.object_store(), camera)?;
|
|
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"
|
|
);
|
|
let pointer = geometry
|
|
.logical_point(pointer)
|
|
.ok_or_else(|| anyhow::anyhow!("zoom anchor cannot be projected"))?;
|
|
let node = block::snapshot(vm.object_store(), block)?;
|
|
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(())
|
|
})();
|
|
vm.release(mount)?;
|
|
result
|
|
}
|
|
|
|
/// 处理旧 Page 模式的兼容相机事件;独立视口使用各自的输入路径。
|
|
pub(super) fn dispatch_page_view(
|
|
&self,
|
|
vm: &mut Vm,
|
|
input: &crate::events::Input,
|
|
) -> Result<()> {
|
|
// 兼容 Page 相机不通过 Mount 定位,而是读取当前活动页面及其 Surface 副本;发布版本仍必须一致。
|
|
let (page, mut surface, viewport) = {
|
|
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" {
|
|
anyhow::ensure!(
|
|
surface.mode == crate::page::Mode::Canvas,
|
|
"zoom requires canvas mode"
|
|
);
|
|
let pointer = input
|
|
.point
|
|
.ok_or_else(|| anyhow::anyhow!("zoom requires anchor"))?;
|
|
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 {
|
|
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);
|
|
}
|
|
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(())
|
|
}
|
|
}
|