docs: clarify source paint handoff and raster presentation limits
This commit is contained in:
@@ -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>,
|
||||
|
||||
Reference in New Issue
Block a user