ColorVision.ImageEditor:打开、绘制与输出
ImageView 承载 WPF 画布、导航按钮和交互入口,EditorContext 向扩展提供配置、绘图与处理上下文。源数据由 ImageDocument 持有,ImageEditorSession 协调文档变更,显示统一经 ImagePresentation 发布;算法协调、显示能力、输出和工具栏装配有独立拥有者,详见上下文与状态归属。创建控件会装配工具、菜单和服务,不是无副作用的轻量图片框;运行主程序仍先遵守启动前提。
客户 OK/NG、MES 字段及业务导出不属于此模块;历史结果与中立算法的分界见结果展示链。
图像顶部、左右两侧、底部绘图及 POI 工具栏的“更多”箭头仅在存在溢出项目时显示;窗口尺寸或工具项目变化后随实际布局更新。内容全部放得下时不占用箭头空间,模板等 ComboBox 自身的下拉入口保持可用。
顶部和两侧工具栏随当前图像启用缩放、保存、直方图、3D 和滤镜等操作。左侧工具栏的设置齿轮位于“清空”下方,打开统一设置的“显示”页,滤镜参数可在“滤镜”页调整。无图时仍可打开文件、进入设置和手动计算 CIE 色域。
图像全屏与恢复
图像顶部工具栏的全屏按钮只展示当前图像及其工具栏。进入后按新视口等比例适配图像;再次点击该按钮、按 F11 / Esc,或点击顶部退出按钮,恢复原文档位置和进入前的缩放、平移,并同步更新倍率显示与绘图缩放。鼠标移到屏幕顶边时显示退出按钮,进入时短暂显示按键提示。
ImageFullScreenMode 暂时将图像内容移到宿主窗口,退出时恢复原父容器及子项顺序。窗口边框、显示器边界和原窗口状态由 Common 的 WindowFullScreenSession 负责;紧凑标题栏在改变窗口样式之前暂停,不能让标题拖动区截获图像顶部工具栏的鼠标命中。窗口尺寸改变和图像缩放是两个独立状态。ImageView.Dispose 在清理图像前退出仍活动的图像全屏会话并恢复宿主;窗口直接关闭时释放模式持有的恢复信息,不再操作已关闭窗口。
图像预览有键盘焦点或鼠标位于预览内时,F11 与图像工具栏全屏按钮效果相同,适用于主窗口中的图像和独立 ImageView 宿主。未由图像处理的 F11 才在冒泡阶段进入主窗口全屏。若先进入主窗口全屏,再通过图像按钮进入图像全屏,第一次 F11 / Esc 只返回全屏工作区,第二次才恢复普通窗口。已处理的按键、带修饰键的 F11 和长按重复事件不再次切换。
真实图像工具栏与缩放仍需结合 WPF 预览检查。
CIE 色度图与手动色域计算
图像右侧的 CIE 入口打开紧凑的独立窗口,继续接收图像取样点。默认窗口为 860 × 680 DIP,色度图占主体;模式切换与坐标系、缩放、适应和显示选项浮在图上。画布留白与图表底色统一为白色,不以黑色边带填补宽高比差异,也不拉伸坐标轴比例。
悬停读数取指针所在的像素格。RGB48 和 RGBA64 按原始 16 位 RGB 通道推算相对 sRGB/D65 色度,标记颜色按 8 位显示。
“色度图”支持 CIE 1931 xy、CIE 1960 uv 和 CIE 1976 u′v′。默认显示 sRGB 与 D65,其余色域、白点、色温线和日光轨迹可从“显示选项”展开;展开时图表避让面板。当前点的 xy 常驻左下角,展开可看 uv、u′v′、CCT 和 Duv;图上游标读数显示在右下角。显示选项只控制参考叠加,不改变图像测量结果。
“色域计算”保留 RGB xy 输入、多标准选择、自动计算和原 CSV 导出。右侧参数可收起,底部结果可折叠,结果表按内容增高并在上限内滚动;表格优先显示标准、面积比、样品面积和标准面积,RGB 坐标保留在输入区与完整导出中。这里计算的是 xy 平面三角形面积比,不是相交覆盖率,也不是三维色域体积。
CieDiagramView 在可见且完成布局后合并适配请求,打开、坐标系切换和适应模式下的视口改变会保持等比例居中。滚轮、平移或缩放按钮进入手动视图状态;修改计算输入和窗口布局不覆盖手动视图,点击“适应”恢复自动适配。未加载和不可见的页不持续排队缩放,卸载会取消待执行请求。计算页和色度图页分别保留自己的叠加与输入状态。
入口与实现位于 UI/ColorVision.ImageEditor/Cie/。 界面文字、配色和面板展开效果需用真实 WPF 窗口确认。
打开图像与完成信号
工具栏、Ctrl+O 和右键“打开”共用 ApplicationCommands.Open。右键命令指向当前视图,宿主可接管选图流程。右键“在文件夹中选择文件”仅在当前图像对应的磁盘文件存在时显示。
活动图像的摘要显示在状态栏中间,包含尺寸、通道、位深和可用的文件标识。悬停摘要可预览图像详情,鼠标离开摘要和浮窗后收起。点击摘要可保留浮窗并复制其中的像素格式、DPI、文件路径与时间,以及图像已提供的采集或相机信息;浮窗失去焦点或按 Esc 时关闭。文件按钮会在资源管理器选中当前图像的源文件;点击时核对该文件是否仍可访问。
ImageView 按扩展名查询 IEditorToolFactory.IImageOpens。扩展名命中后仍须完成解码。
| 输入 | 打开器与限制 |
|---|---|
| BMP、JPG/JPEG、PNG、WEBP、ICO、GIF | Tif/CommonImageOpen.cs 声明这些扩展名,使用 WPF 解码;具体编码、像素格式及本机解码能力仍需满足,GIF 被识别不代表提供动画播放 |
| TIF/TIFF | Tif/Opentif.cs;默认 ConvertGray32FloatToGray16OnOpen=true,Gray32Float 测量图可被映射为 Gray16 显示代理,不能把显示值或随后导出的底图当成原始浮点样本 |
| CVRAW/CVCIE | 由已加载的 Engine/ColorVision.Engine/Media/CVRawOpen.cs 扩展注册,不是 ImageEditor 自带的普通位图解码器 |
未登记的格式在图像组、文档、元数据和格式能力变更前被拒绝。主工作区中的图像控件将不属于自身的文件拖放交给宿主,视频文件通过统一打开路由使用系统关联应用。独立图像窗口提示格式不支持并保留当前图像。
SetImageSource 对 WriteableBitmap 接受 Bgr32、Bgra32、Pbgra32、Bgr24、Rgb24、Indexed8、Rgb48、Gray8、Gray16、Gray32Float;其他格式会报不支持。不要将“打开器识别扩展名”扩大成“该格式的任意位深、通道或编码均支持”。
- 普通同路径打开会跳过重载;“还原原图”在源文件仍存在且有打开器时强制重走文件打开流程,不是撤销栈中的一次图元操作,也不是恢复任意历史像素。
- 静态图片在后台探测和解码,期间保留已发布的像素。换图和清空取消旧请求,拒绝迟到结果。
ImageOpenCompletion报告文件缺失和解码失败。失败或取消后可直接重开同一路径。格式读取和可选色度能力在发布前交接,详见上下文契约。 ImageSourceLoaded表示当前像素源已载入或更新;ExternalRenderCompleted只在外部渲染者显式通知时发出。该事件也可携带Succeeded=false或空Source,发生事件不等于渲染成功。需要导出结果叠图时,核对成功标志、当前任务Context与ImageRevision,再在视图 Dispatcher 捕获;不能仅凭像素加载或事件名称判断标注已完整。快照 API 自身不会等待或校验外部渲染状态,事件字段见ImageViewLifecycleEventArgs.cs。
CVCIE 的全局默认显示在“图像设置 → 文件打开 → CVCIE”中配置,由 Engine 的 CvcieDisplayConfig 持久化,CvcieDisplaySettingProvider 注册到设置窗口,加载 Engine 后无需先打开 CVCIE 即可设置;开启“启用真彩显示”后新打开的 CVCIE 默认采用 XYZ 真彩 sRGB,关闭后默认原图;亮度可选择自动适配或固定参考白。图层下拉框允许临时切换当前图片,不改全局开关。XYZ 转换与原图/Y 灰度回退也由 Engine 提供,异常只记日志,详见 CV 文件的显示与校正边界。
SetLayerController 替换或清空控制器时会 Dispose 实现 IDisposable 的旧控制器,同一实例重设选择不释放。Engine 的 CVCIE 控制器借此取消后台切换并释放显示缓存;选择返回不表示新图层已显示,消费方仍以 ImageSourceLoaded 为完成信号。
图像组导航
OpenImageGroup、AppendImageToGroup 和 SelectImageInGroup 通过 ImageGroupNavigation 管理项目与索引,ImageView 只适配 Dispatcher、按钮状态和实际打开回调。组内路径按大小写不敏感去重,保留首次出现的项目元数据,忽略空白路径;初始索引按规范化后的集合截取到有效范围。空组输入执行完整 Clear。
自动跟随默认开启;手动选择旧图后暂停跟随,选到末项恢复。关闭自动跟随后追加新项目不自动切图,仍可显式选择;追加已存在路径不会创建重复项,open=true 仍可选择该项。选择先更新导航状态和按钮,再打开图像,最后发出选中事件;该事件本身不替代打开器的图像加载完成信号。
设置扩展与模块边界
ImageView.RegisterSettings 保留原有 provider 入口;RegisterSettingsProvider 还返回可注销的句柄。条目声明稳定 ID、作用范围、提供方、当前绑定对象及可选保存/默认动作。窗口按页面 ID 组织显示,只有应用偏好和默认值的实际改动在保存/完成时持久化;当前视图调整、信息浏览和标定档案不通过普通关闭隐式保存。旧条目需要显式调用其保存按钮。范围、兼容和错误语义见图像设置。ImageEditor 不反向依赖 Engine 的配置类型,FileIO 也不承担用户显示设置。
真实设备和跨显示器 DPI 的行为需在目标环境确认。
绘图、选择与撤销
参考线模式可选同心圆、简单十字、双十字和斜十字。旧相机显示配置中保存的 CrossMask 或 GridLines 会加载为简单十字,继续使用该相机的其他设置。
缩放和平移定位图像区域;绘图工具向同一 DrawCanvas 添加矩形、圆、线、多边形、曲线或文本等对象。对象选不中时先确认当前绘图/选择状态和对象是否支持选择,再查命中测试与属性编辑器,不要先修改设备或算法配置。
DrawCanvas 保留 Image 的布局和 Stretch 行为,将底图绘制到独立 DrawingVisual 子层;编辑图元集合、命中测试和撤销栈不把底图当作注释。ImageDrawingPresentation 同步绘图列表、文字/消息显示配置、缩放布局和活动编辑提交,并在组件初始化后附着订阅、释放时解绑。图像与图元的承载分离没有改变现有 shader 的作用范围:ImageShaderPresentation 仍将 SceneEffect 附着到整个画布,兼容整场景显示效果。
ImageView 组合视口 Zoombox 与图像内容 DrawCanvas:前者负责视口变换和裁剪,后者保留图像坐标下的底图与标注。业务通过 ImageView.Clear 清理当前文档,通过 ImageView.Dispose 结束视图生命周期,由宿主统一释放工具订阅、图像和子控件引用;普通卸载保留重新挂载能力,不能等同于永久释放。
源图替换、清空和释放画布都会丢弃旧底图。DrawCanvas.Clear 只清标注和撤销记录。Zoombox 未布局时只保留最后的适配请求,换图、卸载或显式操作会取消旧请求。
ContentMatrixChanged 在矩阵实际变化时通知。缩放和平移保留矩阵绑定。Pan 使用视口坐标,非等比缩放按轴限制倍率。
圆形和矩形绘图工具在底部紧凑属性条中提供持续选项。连续模式关闭时显示 1×,开启时显示 ∞;尺寸锁定关闭时显示开锁,开启时显示闭锁。图标与点击热区应大于普通状态文字,使缩放画布上的高频切换仍容易命中。开启后的持久选中态必须通过稳定的背景、边框或前景反馈与未选中态区分;鼠标按下只提供瞬时反馈,不能与持续选中态共用唯一的视觉差异。ImageView.xaml 定义紧凑控件样式与承载区域,CompactInspector.cs 创建属性元素,圆形和矩形管理器提供连续、锁定及尺寸状态。
椭圆可独立编辑 Rx、Ry,相等时为圆。椭圆、矩形和多边形通过属性条的 θ° 或选框上方的旋转手柄围绕中心旋转;拖动时按 Shift 以 15° 对齐,完成一次拖动登记一笔撤销。非零旋转时,外接选择框缩放保持图形比例,独立长宽仍可在属性中编辑,避免把旋转后的外接框误当成原始长宽。
多边形默认在 Enter 完成时闭合,也可点击起点附近完成;至少需要三个顶点。关闭工具的“闭合”选项可保留折线,对已有多边形可在属性或右键菜单切换“闭合区域”。自由套索按住鼠标拖动采集轮廓,松开时自动闭合,Esc 取消;它生成同一种多边形对象。注释往返保存 IsClosed 和 Rotation。这些封闭图形的 CVCIE 计算及传统节点边界见 CVCIE POI。 画布右键由整个 Zoombox 承接。有图时优先显示图元的专用菜单,其余情况由 ImageContextMenuComposer 构建标准菜单,略去不可执行的命令和空分组。无图时仍可打开文件、进入设置或使用可独立选图的批处理。
选区右键可直接编辑或删除对象。矩形的另存、复制和替换集中在“裁剪”,使用同一片源像素。裁剪覆盖与选区相交的边缘像素,并裁到图像边界内。另存时仅在新图像编码完成后替换目标文件,编码失败会保留已有文件。选区可用的算法放在“分析测量”,涉及多种用途时按标准图像菜单的分类展开。
DrawCanvas 的撤销/重做只覆盖登记到 ActionCommand 的操作;加入新命令会清空 redo,清空画布会清空两栈。不能把换图、任意像素处理或外部保存都视为可撤销。橡皮擦多对象删除是一笔撤销事务;临时框选图形不进入撤销历史。
注释由 AnnotationMapper 映射圆、矩形、文本、线、多边形和 Bézier 曲线。导入先验证文件并准备新图元,成功后整批替换当前注释,可用一次撤销恢复。文件必须包含 Items 数组,旧文件可省略 V1 版本和图像像素坐标字段。未知图元导出时可能跳过,新增类型需补映射和坐标往返验证。注释 JSON 不包含源像素和客户结果记录。
保存前分清输出语义
主窗口可配置的“另存为”(默认 Ctrl+Shift+S)沿焦点调用 SaveAs。图像保留其渲染 PNG 输出语义;3D 查看器将同一命令接到截图入口,模型未就绪、加载或导出中不可用。
ImageView.Snapshot.cs 保留公开输出入口,捕获由 Output/ImageSnapshotCapture 负责,编码由 Output/ImageSnapshotEncoder 负责。ImageViewSnapshot 携带可独立消费的冻结源或缓冲租约及绘图快照;后台编码不再持有整个视图,也不改变文档源或当前显示。
截图保留采集参数、相机信息和校正摘要。PNG 写 ColorVision tEXt,JPEG 写说明。若换图未完成仍显示旧图,截图沿用旧图来源和 DPI。即时截图按画布 DPI 输出,后台截图按源尺寸和所选比例渲染。8 位截图标记 pixelRole=display,不能恢复可重放测量数据。后台 source 只保存基准像素。标尺仍读取 EXIF CameraModel 和 CameraManufacturer。
| 操作或 API | 实际输出 |
|---|---|
界面“另存为” / Save / CaptureSnapshot | CaptureSnapshot 在 UI 线程提交活动绘图编辑并产生 Pbgra32 渲染位图,“另存为”和 Save 将其编码为 PNG;不保留原图的高位深 |
CaptureSnapshotForBackgroundSave 后输出 rendered | 捕获当前基准位图和可支持的绘图,后台 STA 合成;可选 PNG/JPEG 和缩小比例,是渲染图 |
SaveSnapshotExportsAsync 的 source 分支 | 跳过场景渲染,保存捕获的当前基准位图,支持 PNG/TIFF/BMP 选项;无缩放或有损质量选项,编码器和像素格式仍必须兼容 |
| 注释导入/导出 | .cvanno.json 等 JSON;导出会提交活动绘图编辑并写目标文件,导入在解析/转换成功后清除现有注释再加入新对象,不是追加或整图快照 |
后台捕获优先使用 ViewBitmapSource,只有它不是位图时才回退到 ImageShow.Source,因此当前屏幕上的 FunctionImage 不一定就是后台输出的底图。“source”是当前载入/处理后的基准位图,不是源文件字节副本;经过 TIFF 显示转换后也不会凭空恢复原始浮点数据。BMP 仅允许代码明确支持的格式,Rgb48 等不能无损保留时会拒绝,而不是静默降位深。
捕获需在视图 Dispatcher 执行,无有效图像可返回 null。后台只接受可复制的 DrawingVisual,带 Effect、CacheMode 或其他不支持的图元会拒绝。场景 SceneEffect 不参与后台合成。含叠层的捕获提交活动编辑,includeOverlays=false 保留草稿。保存 API 消耗并释放 ImageViewSnapshot,未保存的快照由调用方释放。
保存会创建目录、写临时文件并替换同名目标,需确认写入范围和覆盖授权。rendered 与 source 必须使用不同路径;双输出先保存 rendered 再保存 source,并非整体事务:前者失败时后者不执行,后者失败时前者可能已写入。不要以调用已发起或某一文件存在宣告全部导出完成。
叠加层与算法入口
普通注释、Engine 历史结果图元和统一算法 overlay 不是同一种持久数据。统一算法由 AlgorithmOverlayRenderer 生成图元,AlgorithmOverlayManager 将图元与 artifact 一起绑定文档、source revision 和注册 token。transient 随会话释放或源像素提交清理;persistent 可以跨会话释放和源像素提交保留,但换图/清理仍会移除,名称中的 persistent 不代表已经保存到磁盘。完整替换、过期会话和历史 handler 契约以结果展示链为准。
应用需要自行布局标签时可通过 AlgorithmOverlayRenderer.RegisterVisual 注册 DrawingVisual,继续使用同一文档、source revision 与注册 token 的生命周期;应用负责字号、缩放重绘和交互命中。BMW 主图回显由 BmwSfrOverlayRenderer 绘制框线和数值标签。共享显示设置支持 MTF50、MTF10、指定频率 MTF 与 Nyquist 响应;按原图测量拟合生成刃边虚线,再转换到当前 DPI/缩放的画布坐标,绘制范围限定在对应 ROI 内。中心十字使用识别出的靶标中心,默认显示且可关闭;可选显示中心原图坐标、内部矩形实际尺寸和距中心距离。中心只在定位成功且坐标有效时出现,标注数值使用原图像素,中心十字保持固定屏幕大小。显示切换只查询结果,不触发测量。
图像右键分为“图像处理”和“分析测量”,批量算法入口在“图像处理”。分类见 AlgorithmMenuGroups,定位时可按真实菜单文案搜源码。
批量图像处理的“添加文件夹”可取消,扫描完成后统一加入列表。递归扫描跳过目录链接和联接,避免把所选范围外的目录加入批次。批量图片和分析报告与本批次其他源文件重名时追加编号。允许覆盖已有输出时,目录链接与联接按实际位置处理,选中文件的符号链接目标也受保护。
Catalog 与独立工具使用同一分组,组内 Order 直接参与排序。修改菜单文案保留兼容 ID、算法 ID、参数和结果协议。
标准图像菜单按应用语言加载资源,第三方条目可回退到自身显示名称。缩放插值按数值合并 WPF 枚举别名,显示名称变化不改变选中值。
统一算法菜单由当前 Runtime 能力和 provider 可用性决定;有 Descriptor 或源码不等于默认可执行。查询 Blob、轮廓、亚像素边缘、拟合、FFT、摩尔纹等能力时,先核对统一算法平台的发布门禁,再读对应专题的输入约束与预览/提交/导出边界。本地 Native 分析等直接入口不自动受这套门禁控制。工具构造、刷新与临时 ROI 见编辑器上下文。不能依据实现文件存在就构造一个产品菜单,也不能假设关闭算法窗口必然恢复原图。
CIE 在同一个窗口提供 色度图 / 色域计算 / 样品与色差,多样品、色差、色域覆盖与导出契约见 CIE 色度与样品分析。选中样品可直接设为色域 R、G 或 B;实测 XYZ、RGB 推算和仅色坐标分别处理。
3D:亮度高度图与模型场景
图像亮度高度图
“图像 → 3D 视图”把当前 DrawCanvas.Source 的 WriteableBitmap 交给 Window3D。高度定义保持为 Z = byte灰度 / 255 × 显示高度,默认显示高度为 100。它表达当前显示图像的亮度,不是物理深度、原始 RGB48/Gray16/Gray32Float 测量值,也不从亮度重建真实物体。切换源图层或改变上游显示映射可能改变输入亮度。
HeightMapPixelSampler 对显示亮度做双线性采样。高位深、浮点等需要转换的像素沿用 WPF 显示转换,包括浮点无效值的处理。透明度须大于 127 才参与网格,粗网格也检查内部透明点,避免跨洞连接。
HeightMapDxRenderer 使用 SharpDX/DirectX 11。图例表示未加光照的 0–255 调色值,曲面光照会改变视觉亮度。采样、网格与命中分别见 HeightMapPixelSampler、HeightMapDxRenderer 和 HeightMapDxGeometry。
| 设置/操作 | 行为 |
|---|---|
DetailResolution | 静止网格最长边,默认 1536,可设 128–2048;按图像比例采样且不放大超过源尺寸(单像素维度复制成两点供网格使用) |
TargetPixelsX / TargetPixelsY | 保留旧配置键,作为缓存交互网格的 X/Y 上限;默认 512,设置界面允许 128–1024 |
AdaptiveDetail | 默认开启,拖动/相机平滑期间显示较低细节,停止约 160 ms 后恢复;关闭后始终显示细网格。较低性能显卡可先用静止 768 / 交互 256 |
| 显示高度 | 仅调整显示比例;渲染质量设置不改变 XY 尺度(以原图适配 512×512 的默认平面为基准)。不静默平滑灰度、不抹掉峰值;有限采样仍可能遗漏原图细节 |
| 左键 / 右键或中键 / 滚轮 | 围绕稳定目标旋转 / 在相机平面平移 / 缩放;Shift+左键也可平移。HeightMapOrbitCamera 按经过的时间平滑趋向目标 |
| Home、重置、双击 | 在完整网格就绪后按高度包围盒八角与真实视图区比例重新取景,并恢复默认方向;俯视提供正面查看。初始取景和重置使用同一逻辑 |
| 悬停读数 | 底栏显示源图映射坐标、最近细网格采样灰度、该灰度对应 Z,以及插值曲面交点 Z;采样值不能冒充源像素的原始测量读数 |
| 截图 / 导出 | 截图用 DirectX 视口读取 PNG/JPEG/BMP;模型导出由 HeightMapModelExporter 在后台流式输出完整细节和当前高度的 OBJ(MTL/256 项 PNG)或二进制 STL;OBJ 附带伪彩材质和纹理并保留隐藏纹理文件设置,STL 只含几何,二者均不包含相机方向。导出开始后固定网格/LUT/高度快照,后续视角或采样变化不会混入文件 |
侧栏、视图区、图例和读数底栏各占布局区域,控制内容可滚动。首次取景等网格准备完成后才执行,不在只有坐标轴时调用加载自动缩放。保持完整取景状态时,窗口比例和显示高度改变会重新适配;用户手动旋转/平移/缩放后保留其观察位置,Home 可再次完整取景。关闭会取消未完成构建并释放视口/GPU资源,不强制对整个进程执行 GC。
OBJ/STL 模型场景
ModelViewer3DControl/ModelViewer3DModel是 SharpDX/Assimp 的 OBJ/STL 模型查看链,支持场景树、可见性和隔离状态。模型名称、几何统计和当前视图显示在状态栏中间。线框由MeshNode.RenderWireframe控制,不能照旧说明把它写成FindEdges加边圆柱,或把高度曲面的 WPF 工具链直接套过来。- 界面
ExportModel_Click调用ModelViewer3DLoader.ExportAsync(model.FilePath, ...),导出时重新由Importer读取源文件,再交给Exporter,不是序列化当前显示场景。因此隐藏/隔离、线框与窗口变换不构成模型导出内容;源文件后续变化也可能影响输出。ModelViewer3DModel.ExportToFile()则是另一条对已有场景操作的 API,不能因其存在就推断界面使用了它。 - OBJ、材质和纹理全部写完后成组落位。落位失败会回滚已替换的配套文件;回滚失败时保留可用备份并报告路径。导出保真以实际样本重新导入为准。
实际格式兼容性、性能与交互应在目标显卡、目标样本和实际桌面上验证。
入口缺失与失败定位
| 现象 | 先查的代码边界 |
|---|---|
| 图像区空白或仍像旧图 | 实际打开器、文件/编码、最终 ImageSourceLoaded 与当前路径;不要把旧显示当成本次打开成功,也不要一概先重装 native DLL |
| 工具栏缺项或工具重复 | EditorToolFactory.cs 的发现集合、上下文构造、可见性和 opener 的 GuidId 覆盖;算法入口另查 Runtime 门禁;通用规则见UI 发现链 |
| 标注或结果偏移、换图后残留 | 图像坐标空间、裁剪/旋转、画布缩放;再按注释、历史 handler 或统一 overlay 分流,避免混用清理机制 |
| 保存缺标注、位深变化或只生成一个文件 | 捕获是否成功、使用哪种输出分支、外部渲染是否完成、源像素格式和双输出异常 |
| 伪彩/滤镜、CIE 或 3D 显示异常 | 当前输入类型及工具配置,再查 shader、colormap、CIE 数据/图片资源或 3D 依赖;视觉效果不构成测量正确性证明 |
| 放大后没有像素数字 | PixelValueOverlay.TryGetRenderState 要求有效且支持的位图格式、画布采用 NearestNeighbor、单像素显示宽高达到 PixelValueOverlayMinPixelCellSize、可见区域非空且像素数不超过 PixelValueOverlayMaxVisiblePixelCount;仅放大不保证满足全部条件,阈值归 DefaultImageViewDisplayConfig |
发布资源与依赖以 ColorVision.ImageEditor.csproj 和UI 模块交付为准;本页不另列一份发布流程,也不把 DLL 存在当作工具或 native 功能通过。
验证边界
真实打开器、图层切换、旧源租约、TIFF 解码像素和输入文件只读性需要使用获授权的样本单独验证。普通位图通道选择只改变显示;可重放 CVRAW 及内嵌有效参数的 PNG/TIFF 共享测量能力,XYZ 层切换可更换当前显示/算法输入,但保留原始测量样本和内容身份。普通 Save 和后台快照的 source 分支仍遵守上表的位图输出语义,不承诺恢复原始测量样本;测量原图导出使用独立的内容快照入口。
新增自定义图元往返、未知输入格式、全部绘图工具、CIE、3D 及 native 资源仍须按改动在获授权环境验证。最小检查使用非敏感本地样本;另存、导入替换和真实运行须分别确认副作用,不连接设备来验证纯图像交互。
