docs: clarify source paint handoff and raster presentation limits

This commit is contained in:
2026-11-12 20:11:57 +08:00
parent b10a5b43d2
commit f743c427f7
2 changed files with 17 additions and 2 deletions
+6 -2
View File
@@ -4,6 +4,10 @@
//!
//! Source paint dispatch produces checked immutable commands. One read-only VM
//! resumable call sequences all overrides, sharing one instruction/frame budget.
//!
//! ui_bridge::begin_paint_frame 在布局/挂载几何就绪后调用 start;Prepare/Advance 依帧顺序只执行真实源覆盖,Collect 解码其结果。
//! Work 保存原只读续体、未发布 frame 和已完成覆盖,resume 沿原位置继续;cancel 结束调用并释放入口,不发布部分命令。
//! finish 再为未覆盖出现生成默认命令,组装裁剪/变换/归属平行表和面板;桥接层登记依赖后,endor_host 仍需验证全窗口稳定。
use crate::{
document::{Frame, RenderCommand},
layout::{self, Size},
@@ -66,7 +70,7 @@ fn number(store: &ObjectStore, object: ObjectRef, name: &str) -> Result<f32, VmE
Ok(value)
}
/// 从当前 desktop 的类型注册表取得绘制结果必须符合的托管类型。
// Collect 和 decode 使用当前桌面的类型注册表,避免用其他窗口的名义类型接受返回值。
// Collect 和 decode 使用传入 desktop 所属 VM 的注册身份;跨窗口可共享同一类型域,不能仅按类型名字相同接受返回值。
fn named_type(store: &ObjectStore, desktop: ObjectRef, name: &str) -> Result<ObjectRef, VmError> {
// desktop.types 本身必须为托管注册表对象;缺失类型不能静默采用结构匹配。
let registry = object(store.get_attr(desktop, "types")?)?;
@@ -383,7 +387,7 @@ impl NativeCallable for Advance {
/// 源绘制完成后的未发布结果:已装配帧、业务读取依赖和调度切片数。
pub struct Draft {
// 已经合并命令的原生帧;Draft 仍需桥接层提交,完成计算不等于发布成功。
// 已经合并命令的原生帧;桥接层仍需登记绘制依赖,运行时仍需完成文档验证与稳定性检查,不等于 GUI 已呈现。
pub frame: Frame,
// 保留源绘制的业务读取依赖,供下次写入后判定是否必须重绘。
pub reads: Vec<endor_core::ReadDependency>,