ImageEditor:上下文、工具装配与临时选区
ImageView 是 WPF 视图宿主,文档、显示能力、算法协调和工具装配有各自的状态拥有者。扩展通过 EditorContext 或更窄的上下文访问这些能力;新增功能应先确定其写入的是源像素、显示结果还是绘图对象,再选择入口。文件打开、撤销、保存和 3D 操作见 ImageEditor。
状态由谁持有
| 拥有者 | 状态与责任 |
|---|---|
Documents/ImageDocument | 当前 ImageSource、文档 ID、source revision 与 ImageFrameStore;租约缓存跟随文档失效和释放 |
ImageEditorSession | 协调源替换、源像素提交、配置清理及处理能力释放;通过 ImageSourceMetadata 解析像素元数据并应用当前视图标定 |
Presentation/ImagePresentation | 当前显示源、FunctionImage 与显示请求代次;在视图 Dispatcher 上成对发布或恢复基准源 |
ImageDisplayEffects | 每视图伪彩 state/controller 及 ImageShaderPresentation;工具栏不拥有这些基础能力 |
ImageStreamPresentation / ImageChannelPresenter | 连续帧的有界后台处理与发布、单通道异步显示;都经 ImagePresentation 写入显示 |
Operations/ImageOperationCoordinator | preview/analysis claim、结果发布事务、回滚和文档变更失效,持有所选 runtime 的协调入口及本视图 overlay manager |
Output/ImageSnapshotCapture / ImageSnapshotEncoder | UI 捕获、独立快照和后台编码;输出不自行提交文档源 |
IEditorToolFactory / Tooling/EditorToolbarComposer | 扩展发现与实例生命周期、工具栏元素装配;刷新 UI 不创建新的文档或显示能力 |
Navigation/ImageGroupNavigation | 图像组项目、当前索引、手动选择及自动跟随;视图负责 Dispatcher 适配和导航按钮 |
Draw/ImageDrawingPresentation / Tooling/ImageContextMenuComposer | 绘图列表同步、显示配置与缩放订阅、活动编辑提交,以及按命中对象/扩展构建菜单;绘图上下文、临时 ROI 与算法 overlay 各自保留所有权 |
ImageView.CreateEditorContext 创建视图配置、绘图上下文和处理上下文,再由 EditorContext 聚合。ImageProcessingContext 提供强类型 Presentation、DisplayEffects、StreamPresentation 和算法入口,算法协调转给 ImageOperationCoordinator。binding 仅提供同一个文档的身份、版本、源及操作委托;ImageView 提供的可选 CaptureSourceState 在文档 Dispatcher 同步源引用与共享 revision,算法取得该状态不要求先创建 native 帧。所有宿主的 FunctionImage 都由 ImagePresentation 持有,binding 不存储显示状态。文档没有 Source 时取帧返回 null,不从显示图推断计算源。EditorContext 不是任意服务的注册容器:绘图列表、选择态、画布和缩放主要转发给 DrawEditorContext,文本编辑上下文按需创建。
源像素提交与显示发布
静态 PNG/TIFF 的格式解码仍由 ImageEditor 负责。IAsyncImageOpen.OpenImageAsync 的 Task 在内容发布完成后结束,兼容的 OpenImage 保留旧入口;宿主可等待 ImageView.ImageOpenCompletion。换图和清空取消旧请求,迟到的能力准备结果必须释放,不能发布到新图;失败通过完成 Task 返回,格式器日志不等于成功完成。连续帧不使用此静态完成契约。
在图像画布右键选择 在新窗口中打开图像,可以在独立的 ImageView 中查看当前图像。画布为空或仅有结果占位图时不显示该入口。新窗口有自己的图像生命周期,关闭时释放其 ImageView。
解码结果 DecodedImageContent 独立保存无损样本和可识别参数,浮点 TIFF 的 Gray16 显示代理不作为测量原图。可选 IImageContentProvider 在正式发布前验证并组装能力,ImageDocument 持有内容和 IImageContentCapability 生命周期;ImageEditor 不依赖 Engine。实际编辑、换文件、清空及关闭撤销能力和旧缓冲,参数继续作为只读记录。SetDisplayLayerSource 专用于有明确坐标对应的显示/算法层切换,保留内容身份和测量能力;普通 SetImageSource 或像素提交仍是内容变更。几何变换没有同步测量坐标的契约,因此同样撤销能力。版本化参数与导出边界见 CV 图像导出。
普通位图和 TIFF 串行执行解码与显示位图复制,排队请求可独立取消。每次打开使用独立显示位图,避免准备期间改写已发布的像素。完成复制后即释放解码槽位,因此新图可在已取消的旧能力准备仍在退出时打开。通过最终校验的请求才能替换源像素。内容退役继续等待已发起请求退出并释放其迟到的能力结果。
显示层保留资格只属于本次替换,不豁免加载通知中的重入编辑。能力退役先原子分离旧对象和旧消费者,再在所有权锁外等待读者退出;可复用提供者通过 DetachForRetirement(contentVersion) 捕获该次激活的资源,返回清理操作,不能让迟到清理访问后来安装的缓冲、图层或工具。CVRAW 的复用读取另需等待已分离的测量读者全部退出。取消或目标已被替换的静态打开以取消 Task 结束,不能返回成功。
AttachImageContentCapability 通过 Dispatcher 检查后接管传入能力的生命周期,发布者只释放尚未交接的准备结果。激活失败时按该次能力身份和内容版本摘除,再退役释放,避免文档保留已释放对象或清理重入中新安装的能力。能力的 Activate() 回调换源或换能力后,过期调用以取消结束,不继续安装旧能力工具或发送成功加载通知;这不要求回滚已接受的像素。
ViewBitmapSource 实际类型是 ImageSource,可持有基准位图或 DrawingImage 等矢量画布;FunctionImage 表示处理/预览显示结果。兼容 setter 只赋值,不自动推进 revision,也不等于完整源替换或显示发布。内部显示生产者应使用 Presentation.Publish(displaySource, functionImage),恢复基准图用 RestoreSource();这些操作本身不提交源像素。
CommitSourcePixels(source) 在 ImageView、EditorContext 和 ImageProcessingContext 提供等价入口,统一转发到 ImageEditorSession 的同一个实现:先赋基准源,再显式推进一次 source revision,不重新打开文件或执行完整换图重置。原位改写现有位图仍可调用 NotifySourcePixelsChanged()。SetImageSource 则走完整源替换,保留元数据、标定、图层和加载通知契约。源状态捕获和缓存取帧共用源引用变化的失效检测,但不能以此代替生产者主动提交,尤其不能自动识别同一位图的字节改写;详见源帧寿命。
源赋值与显示发布要求 UI Dispatcher;NotifySourcePixelsChanged() 保留后台生产者的通知入口。帧存储同步退役旧版本、原子失效显示请求,随后算法与图元清理调度到 UI。同步回调为新版本创建的 preview、analysis 或 overlay 必须保留,不能让迟到的旧版本清理将它移除。文档释放后拒绝源赋值,失败的提交也不能重新挂回像素引用。
异步显示请求通过 BeginRequest() 捕获 (DocumentId, SourceRevision, Generation),TryPublish 只接受仍有效的请求;新的显示选择或文档变更使旧请求失效。单通道提取持有读取租约直到后台读取完成,迟到输出即使仍拥有有效内存,也不能覆盖新的显示选择。Publish 是 UI 同步发布边界,不提供文件、像素运算或任意外部回调的整体事务。
文档变更会使旧显示和算法范围失效。算法提交的 claim、回滚及重入仲裁由 ImageOperationCoordinator 负责。 统一算法平台
配置分类不是隔离容器
ImageViewConfig.Properties 是一个按字符串键索引的字典。ImageViewPropertyScope 包含 ImageMetadata、ViewState、OpenerRuntime 三项。
SetImageMetadata、SetViewState、SetOpenerRuntime共用SetProperty;同名键会覆盖原值及 scope/owner/description。scope 和 owner 是说明元数据,不是命名空间或权限隔离。新键应避免与已有键冲突。GetProperties<T>只接受值本身属于T,否则返回默认值,不自动转换。直接写公开Properties字典可能绕过或留下旧的分类元数据;没有分类记录的条目在GetPropertyEntries中归为ViewState。ClearProperties清空文件路径、全部属性及分类记录,再触发Cleared,不是只清ImageMetadata。ClearCommand本身只发Cleared通知,并不调用ClearProperties;实际后果还取决于订阅者。Configs是另一份按精确Type缓存的IImageEditorConfig字典,GetRequiredService<T>缺项时构造并缓存。ClearProperties不清这份字典;它也不等于全局ConfigService的配置实例或保存入口。Properties与分类记录标了JsonIgnore,不能把临时属性写入当成已保存。
ImageViewConfig.Calibration 是当前视图的独立标定状态,比例尺和尺子从同一上下文读取。显示滤镜在构造时复制默认值,普通调整不回写默认;CVCIE 探针缓存于 Configs。设置的范围、保存和兼容契约见图像设置。
关闭编辑服务也会改变图像文档
SetImageSource(source) 使用视图的 EnableEditorImageServices,并启用默认图层控制器;三参入口 (source, enableEditorImageServices, configureDefaultLayerController) 可分别指定这两个行为。它总会先登记 ImageSourceReplaced、重置伪彩并清旧源,再检查/设置新像素源。enableEditorImageServices=false 主要关闭图层选择以及本次伪彩图像配置和当前视图标定应用,不会跳过文档版本推进、源替换、像素元数据、加载通知或状态栏刷新。不支持的像素格式可能在旧源已清除后抛出异常。
伪彩换图保留配色与自动范围偏好,关闭效果并重新计算图像相关范围;自动范围在新源赋值后计算。Presentation/PseudoColor 持有伪彩控制器、PseudoColorState 和默认配置,PseudoColorEditorTool 仅绑定控件及操作同一能力;释放工具不释放 controller。连续帧通过 DisplayEffects.TryCapturePseudoColorRequest 取得参数,并统一由 StreamPresentation 提交源与显示结果,不提供另一条外部处理结果发布路径。默认配置类型保留原完整类型名作为已有用户配置的稳定持久键,运行状态不依赖工具实例。静态图预览、连续帧 native 处理和显示 shader 保持各自输入与数值契约,不能因同属“效果”就视为等价算法。
在 ImageView 设置「伪彩色 → 自动范围」中选择自动或手动范围。新视图默认选择自动范围,并遵循「默认显示与标注 → 伪彩默认偏好」中已有保存值。可在当前视图用「将当前设为默认」保存偏好。
静态伪彩首个有效结果发布前显示原图。TaskConflator 串行合并滑块请求,只保留最新待执行请求。已进入 native 的操作可能仍运行。 统一算法平台
静态图的通道选择与伪彩开关分别保留状态:普通关闭伪彩会重新呈现当前所选图层,例如 Red 单通道,不强制切回 Composite。支持的 8/16 位 RGB 单通道先在后台准备独立冻结显示,再于同一 UI 调用中取消伪彩并恢复该通道,避免取消后等待提取期间停留在全彩图;取消中的同步原图显示通知仍会发生,不代表从未发布过原图事件。默认位图图层的 Bgr24/Bgr32/Bgra32/Rgb24/Rgb48 源在仍属于当前伪彩会话时,关闭复用其只读 canonical 输入,避免再次创建 native 源缓存;Pbgra32 的 canonical 已反预乘,不能据此还原原始通道。自定义图层或没有有效会话输入时保留原取帧路径。准备期间换图、切换通道、发布其它显示或建立新算法 owner,会使旧准备失效。同一源图内,开启伪彩时通过默认位图图层选择器切换通道,若当前静态伪彩会话仍拥有预览,则复用会话及其独立 canonical 输入,保留旧伪彩直到新结果,不并行准备普通灰度显示。自动范围模式仍取得所需 native 源帧并计算新通道范围,手动模式保留当前上下限,两种模式都重绘伪彩。这类通道请求在接纳与实际发布时核验源、版本及归属,过期请求不能夺回后继显示或算法 owner。RGB 单通道预览只改变显示,不改文档源像素或 revision。关闭过程若有同步回调换图、发布其它显示或建立新算法 owner,则保留后继操作。换图 Reset,以及效果关闭时的范围和配色配置,不触发图层重选。
静态算法输入已归一为 BGR/BGRA,因此伪彩在 UI 捕获请求时,将 Rgb24/Rgb48/Rgba64 的源通道 0、2 交换为 canonical 通道索引;公开连续帧请求和自动范围仍使用源通道索引。 使用实际 native 输出核对配色数值。
ImageShaderPresentation 拥有独立滤镜状态和 effect 附着,工具负责界面与显式持久化。显示白平衡提供范围为 -1..1、默认 0 的色温与色调控制,并与手动 RGB 增益组合;显示滤镜不重排颜色通道。以上变化都不提交或改写源像素。滤镜沿用完整画布的 SceneEffect 范围,包含图像和叠加内容;没有静默缩小成只处理底图。关闭时仅在当前 effect 仍是自身对象时恢复先前 effect。
连续帧显示
相机 RealtimeFramePresenter 把帧交给 ImageStreamPresentation。可变输入先复制并冻结;已冻结输入直接复用,后台处理读取该快照,不读取生产者下次改写的暂存位图。相机在回调有效期内复制像素,位图创建、写入、翻转和冻结由单个后台任务完成,最多一帧准备或等待 UI 发布、一帧待准备;UI 只发布快照,重置和释放拒绝旧流的迟到快照。WPF 合成前需要转换的格式(Bgr24、Rgb24、Gray16、Rgb48,含伪彩和通道结果)由后台 ImageRenderProxy 预先生成 Bgr32 副本,避免整帧转换占用 UI 线程;副本只由 DrawCanvas 绘制且随所属 Source 更换失效,Source、ViewBitmapSource 和所有读像素的工具仍得到原格式与位深。每帧不小于 64 MB 的流按累计 1 GiB 触发一次非阻塞 GC 回收旧帧原生缓冲。需要伪彩或 RGB 单通道显示时,使用同一条最多一帧执行、一帧等待的处理队列,新输入替换等待帧,不建立无界队列;在途帧可以先发布,随后处理最新等待帧。
处理输出也在后台复制成独立冻结位图,并在后台释放 native 输出,不借用或改写已有 FunctionImage,以免破坏其它预览或输出仍保留的图像。发布时先通过 CommitSourcePixels 提交此次处理对应的冻结源,再通过 Presentation.Publish 发布同帧结果。因此当前基准源与显示结果来自同一帧,source revision 仍按帧提交推进;流身份和序号用于调度,不替代文档版本。
提交期间若重入回调又换图、推进版本、重置流、选择新显示或取得新的算法预览,此帧停止发布并重置流状态。SelectionVersion 区分显式显示选择与文档失效时清理旧预览的基准恢复,后者不应被当成新选择而阻断正常帧。已有处理结果的帧提交通过精确匹配文档、源引用及下一版本的作用域,延后自身失效清理造成的原图发布,避免单通道或伪彩之间插入全彩图;正常结果和同步回调的新显示均优先,未完成且没有后继选择的提交仍恢复基准源。新选择在该版本创建的显示请求也保留有效性,不能被后置清理当成旧请求作废。
换图、释放、流重置、参数变化、所选通道和调用方的发布条件均参与过期检查。未开启伪彩时,Composite 直接发布冻结源,RGB 单通道则在后台提取对应灰度显示,文档仍保留完整彩色帧。开启伪彩按当前源通道处理,关闭后继续呈现最后一帧的所选通道;通道切换和伪彩参数调整通过 RefreshCurrent() 重处理最后的冻结帧。native 处理异常时,仍有效的请求回退到该帧原图,清除旧处理显示。重置不承诺中断正在执行的 native 调用,迟到输出会释放;实时请求仍需已有基准源,缺少基准时先发布原图建立源。上游指标计算见相机实时链。
连续伪彩的原生路径可直接读取已冻结的相机帧,并写入独立的 Bgr24 输出位图。源缓冲在处理期间保持只读并持续有效,输出冻结后才交给发布队列。
扩展发现、构造与刷新
新增功能先确定状态的寿命与写入边界:
| 新增能力 | 放置与接入方式 |
|---|---|
| 新文件格式或连续数据源 | 打开器负责格式与元数据;有原生资源或播放状态时使用独立内容 session,连续像素交给 StreamPresentation |
| 新显示效果 | 在 Presentation 中持有处理能力和当前状态,由处理上下文提供;工具负责绑定与配置。先明确效果作用于源像素、显示像素还是整个场景 |
| 新交互算法 | 使用现有 runtime 和 ImageOperationCoordinator 的 preview/analysis 契约,由 ImageAlgorithmInputFactory 按文档源状态取得私有输入,结果通过既有提交或 overlay 路径交付 |
| 新图元或编辑工具 | 图元、选择与历史操作放在 Draw,工具与菜单使用现有扩展点;不把文档源或 native 句柄放进工具栏控件 |
| 新输出格式 | ImageSnapshotCapture 确定捕获内容,ImageSnapshotEncoder 负责后台编码;后台不访问活动 WPF 控件 |
这些边界不要求每项功能新增一个接口,也不要求把 ImageView 变成通用服务容器。优先复用已有上下文,只有确实存在不同实现或需要隔离外部资源时才引入新的替换接缝。
EditorToolFactory.cs 中的 IEditorToolFactory 实际是类。构造时各扩展点走不同发现入口,并非全部统一为无参反射:
| 扩展点 | 当前构造约束 |
|---|---|
IDVContextMenu | AssemblyHandler 的程序集/类型集合;优先可解析上下文构造,无匹配时才尝试 public 无参构造 |
IIEditorToolContextMenu、全局 IEditorTool | Application.Current.GetAssemblies() 与 AssemblyHandler.GetTypes;要求可解析的 public 上下文构造,不提供无参回退 |
IImageComponent | AssemblyService.LoadImplementations<IImageComponent>();不同于上述上下文注入通道 |
IImageOpen | AssemblyService 程序集内查 FileExtensionAttribute,对每个后缀用 Activator.CreateInstance(type, context) 创建实例;后缀转小写后 Dictionary.Add,重复后缀会冲突,不是后者自动覆盖 |
上下文构造只匹配 EditorContext、DrawEditorContext、ImageProcessingContext、DrawCanvas、TextEditingContext、ImageViewConfig 六种精确类型;选择参数最多且所有参数可解析的 public 构造。它不是通用 DI,不自动匹配基类、任意接口或新增服务。每个视图装配自己的扩展实例,程序集与类型的缓存规则见UI 扩展发现。
只有实现 IAlgorithmCatalogBoundMenu 的菜单走 runtime descriptor/adapter/capability 门禁;不能把该门禁泛化到所有右键菜单或直接 native 工具。后者见本地 Native 分析。
RefreshToolBars 委托 EditorToolbarComposer 移除自己生成的 UI 元素,并从现有工具集合重新装配;它不重扫程序集、重建打开器或发现新加载插件。composer 只拥有 UI 附着,工具实例仍由工厂管理。初始化时工厂早于 Crosshair 创建,随后才执行 IImageComponent.Execute 等步骤;扩展构造不能假定所有视图服务都已就绪。
打开器通过 IImageOpenEditorToolProvider 贡献当前工具。GetEffectiveEditorTools 先放打开器工具,再加入未被其非空 GuidId 覆盖的全局工具;比较区分大小写,空 ID 不参与覆盖,也不会自动去重打开器内部的重复 ID。ApplyImageOpenTools 为本次装配建立代次,先通知旧 lifecycle 停用,在本地枚举候选工具;仍属于当前代次才替换集合,将退出有效集合的 IEditorToggleTool.IsChecked 设为 false,再刷新工具栏并通知新 lifecycle 启用。提供者或 lifecycle 回调重入替换工具时,过期装配停止,不把旧工具追加到新集合;能力发布在工具装配后再次核对文档归属,失效的打开以取消结束。同一打开器重复调用仍执行刷新生命周期,装配代次不代表文件内容需要释放。被覆盖的鼠标读数等工具必须停止事件监听和 overlay,避免按钮消失后仍与 CIE 探针同时绘制;重新成为有效工具时保持关闭,用户可再次启用。单纯 RefreshToolBars 不停用仍有效的工具;停用不等于所有旧工具已 Dispose。
工厂 Dispose 停用当前打开器 lifecycle,并对全局及当前打开器工具中的 IDisposable 去重释放,不承诺释放每个 opener/component。ImageEditorSession.Dispose 依次释放连续帧、显示能力、算法 overlay 和文档。ImageView.Unloaded 仅解绑窗口快捷键,不是 Dispose;宿主仍需负责真正释放。工具栏重建、控件卸载和文档资源释放不能混用。
相机、算法和校正设备通过 DockViewRegistration 注册轻量视图工厂。注册及后台采集不创建图像视图;主窗口显式显示全部视图或用户打开页签时才创建当前实例。DockViewManagerHost 在实际 Closed 后移除文档映射、清除注册表和设备对当前视图的引用,并 Dispose 源图、图层、快照缓冲及事件订阅;列偏好保存为不含 UI 对象和菜单回调的数据。再次打开会创建新实例,原页签中的临时图像与结果列表不保留,持久化结果仍可查询。取消关闭、普通页签切换及 WPF Unloaded 不释放视图。没有当前相机视图时不创建本地 RAW/CIE 预览快照;关闭实时相机页签仅断开预览显示,设备视频状态保持,重新打开后接入新视图。
Abstractions/IImageEditor.cs 中的 IImageOpenContentLifetime 将当前文件资源与工具栏生命周期分开。文件替换、清空及销毁视图经 ImageView.ReleaseImageContent 调用 ReleaseContentAsync,先失效旧请求,再异步等待正在读的内容退役;UI 不阻塞等待可能回调 Dispatcher 的读取。相机实时开始、本地预览及内存 CIE 接入同样先结束原文件内容。只有同一打开器紧接着加载下一文件时传入 reuseBuffers=true,允许保留可复用分配,但旧测量消费者仍须退出。RAW 切换到 PNG/JPG 等其他打开器会释放旧输入数组,后续重开不会被迟到的清理任务清除;工具栏刷新、普通页签切换及单纯显示图层变化不调用此入口。图像格式插件不实现此可选接口时仍保持原有行为。
清图和关页会解除大图及快照缓存引用。ImageMemoryReclaimer 在后台回收体量大的空闲缓冲,仍可能有短时 GC 停顿。渲染器和其他模块的常驻内存独立。大幅 RGB48 仅导出全尺寸标记 PNG 时,渲染线程可暂存一个底图位图供同尺寸、同 DPI 的下一张复用。按双缓冲计上限为 512 MiB,空闲约 5 秒后解除引用。编码线程只接收独立冻结的渲染结果。排查时反复打开与关闭实际窗口,分别观察进程私有内存和托管堆。
临时 ROI:形状、坐标与有效期
ImageView.BeginSelectAsync 每次创建一个 TransientRoiSelectionSession,支持 Rectangle、Circle、Polygon、Quadrilateral。临时 visual 直接加入/移出画布,不登记撤销命令,也不是持久注释。
手动选择只需要有效画布,不要求 BitmapSource:宽高有限且大于零的 ImageSource 均可进入选区,包括 POI 默认白色 DrawingImage。选择过程不将矢量画布栅格化,也不生成虚构像素。涉及统计、识别等像素计算时,ImageAlgorithmInputFactory 仍要求当前文档具有可读取的 WPF 位图,并核对源引用与 revision;能绘制选区不代表能执行图像计算。
多边形模式的完成键为 Enter、Space、End、Tab;Escape 取消任意形状并返回 null。
| 形状 | 绘制与完成 | 右键行为 |
|---|---|---|
| Rectangle | 拖拽后松开左键;矩形宽高均大于 1 且数值有限时完成 | session 不处理右键 |
| Circle | 按下点为圆心,拖拽距离为半径;松开左键且包围框通过同一校验时完成 | session 不处理右键 |
| Polygon | 逐点点击,再按完成键或右键;至少三个点,形状须非退化且不自交 | 尝试完成;无效时继续等待 |
| Quadrilateral | 第四次点击后尝试完成;完成键同样要求四点有效;第四点无效时,下一次点击替换第四点 | 不足四点时取消;已有四点时尝试完成 |
- 位置来自
e.GetPosition(DrawCanvas),是 WPF 画布坐标;此类没有统一进行原始像素换算或边界裁剪。非 96 DPI、图像变换或裁剪后不能直接把坐标当源像素 ROI,需按调用链明确转换,见 ROI 路由。 - 矩形/圆拖拽无效时清除本次临时形状并继续等待;无效多边形保留选点继续等待。这些情况不立即返回
null。 - 同一画布只保留一个临时选区;新请求成功启动前,旧选区取消并返回
null。结束时清理临时图形和本次鼠标捕获,恢复光标、平移快捷键和编辑模式。初始源无效的请求直接返回null,画布上的活动选区继续等待输入。 - 绑定
ImageProcessingContext时捕获不可变ImageSelectionScope:文档身份、source revision 和 WPF 逻辑画布宽高CanvasWidth/CanvasHeight。位图同时保存真实像素宽高和 DPI;非位图的HasPixels=false、像素宽高为零、DPI 占位值为 96,逻辑尺寸保留小数,不能将它当作可计算的像素源。选取期间换图、源版本变化或文档释放使 session 取消;成功结果携带该 scope。单独构造无处理上下文的绘图 session 则不能提供同样的图像绑定保证。 - 已完成结果不会在日后换图时自动消失。调用方须保留
SelectResult.SourceScope,使用ImageAlgorithmInputFactory.Acquire(context, scope)等入口再次核验;不能丢掉 scope 后复用旧坐标。
验证范围
算法 claim 和预览回滚仍需结合算法平台契约验证。
实际应用中核对过期 ROI 拒绝、鼠标操作和不同 DPI 下的选区交互。
