图像设置:作用范围、保存和扩展
图像设置窗口绑定一个 ImageView,按照设置影响的对象组织页面。应用配置可以共享;当前视图的滤镜、标定和工具偏好由视图各自持有。提供方与作用范围是两个独立维度:Engine 扩展既可以提供全局默认值,也可以提供当前视图设置。
页面与生效范围
| 分区 | 页面与内容 | 生效和保存 |
|---|---|---|
| 当前视图 | 显示、工具栏 | 立即影响此视图,不持久化 |
| 当前视图 | 伪彩、显示滤镜、适用的 CVCIE 探针 | 局部状态;提供“应用默认值”和“将当前设为默认” |
| 当前视图 | 标定与单位 | 使用此视图的有效标定;“保存到此来源档案”才更新档案 |
| 应用偏好 | 显示与性能 | 共享 DefaultImageViewDisplayConfig;已有订阅者响应修改 |
| 应用偏好 | 创建时默认值 | 新视图缩放、滤镜、伪彩、探针及新标注文字的初始化值,不广播覆盖已有局部状态 |
| 应用偏好 | 文件打开 | TIFF 和 Engine CVCIE 读取/显示策略;当前文件不会因修改配置自动重读 |
| 应用偏好 | 实时图像 | 由支持 DefaultRealtimeCameraConfig 的实时入口使用 |
| 当前图像 | 图像信息、扩展与诊断 | 只读摘要、技术属性、打开器和支持后缀,提供复制与刷新 |
| 扩展 | 尚未声明作用范围的旧条目 | 显示外部管理提示,保存委托只由该条目的显式按钮调用 |
窗口按稳定页面 ID 导航,只有旧兼容条目回退到分组文本。搜索匹配页面、条目和可编辑属性名称。普通页面使用一个主滚动容器;当前值与默认值不依据“恰有两个条目”自动左右并排。
SettingsPropertyPresenter 位于 ColorVision.UI,复用属性编辑器、验证和可见性绑定,读取 Display 资源元数据及 DisplayName / Description。属性按本地化的 Display.GroupName 或 Category 分区。带 Range 且显式选择 SliderPropertiesEditor 的数值项提供滑块和文本输入。
局部状态和默认值
ImageViewConfig.Configs 是每个视图的类型字典;Properties 是随图像清除的附加字典。它们的生命周期及字符串键限制见编辑器上下文。不要把 scope 标签当成独立存储空间。
显示滤镜
每视图的 ImageDisplayEffects.Shader(ImageShaderPresentation)在创建时复制 DisplayShaderFilterDefaultConfig.State,并负责 effect 附着与释放。DisplayShaderFilterEditorTool 引用同一局部状态,负责界面和显式持久化,工具释放不释放显示能力。调节、普通窗口关闭和工具释放都不会自动写入全局默认值;SaveAsDefault 才显式复制并保存。修改默认值只影响后续创建的视图,已有视图通过 RestoreDefaults 主动应用。
统一滤镜页把“应用默认值”和“将当前设为默认”放在参数卡片之前,避免长参数列表把动作隐藏到滚动区域底部。参数按基础显示、白平衡与通道、色调调整、阈值与高亮、滤镜伪彩分区;有界数值在滑块拖动时立即更新当前视图,右侧文本框保留键盘精确输入。
Temperature 和 Tint 是默认值均为 0、范围为 -1..1 的显示白平衡控制。正色温提高红色并降低蓝色,正色调提高红蓝并降低绿色。负值方向相反。两者转换为 RGB 增益后与手动增益相乘,只改变显示。
显示滤镜保留 ImagePresentation.SceneEffect 的完整画布作用范围,图像与叠加内容一起受影响;滤镜状态变化会立即重绘,不提交源像素,也不保证后台 source 输出包含该效果。图像/叠加承载与输出限制见ImageEditor。
工具栏设置按钮打开统一图像设置窗口的滤镜页。旧 DisplayShaderFilterWindow 类型保留给兼容调用方,但不再是这个工具的默认入口。
AttachPersistence(state, saveAction) 保留外部宿主的显式持久化契约;该模式继续防抖写回宿主目标,并在页面提示外部管理。普通构造不自动附着全局存储。替换附着目标会取消旧计时器并推进保存代次,释放时取消排队回调。该接口没有取消/事务语义;宿主委托的失败契约仍由宿主负责。
伪彩与探针的换图行为
同一视图切换图像时保留伪彩配色与自动范围偏好,但关闭效果并按新图像位深重置范围,需重新启用效果。默认值只在 ImageDisplayEffects 创建或显式应用时读取。自动范围在新源已赋值后计算;controller 提供状态与不可变参数请求,连续帧由 ImageStreamPresentation 处理、检查有效期并发布,工具不再拥有或释放基础处理能力。具体源/显示分离和过期拒绝见编辑器上下文。
CVCIE 探针对象缓存在 Configs,切换文件不丢失此视图的半径/形状偏好。初次创建从全局默认值复制;旧 Properties[ViewStateKey] 对象可被收纳到新的视图缓存。全局默认页无需先打开 CVCIE;局部探针条目只在适用图像中注册。
标定
ImageCalibrationConfig.Profiles 保存档案;每个 ImageViewConfig.Calibration 保存独立有效值。该对象由比例尺和画布中的 DrawingVisualRuler 读取,修改一个视图不会影响另一个视图。
ApplyToView 解析显式 CalibrationSourceKey,否则使用相机厂家/型号键,再回退 Default。CalibrationProfileKey 保存解析结果,不能回填成显式输入键,否则后续相机信息会被旧键遮蔽。读取未知来源回退默认档案而不创建持久档案;同一来源再次应用默认保留局部调整,reload: true 才重新应用档案。来源变化只更新所属视图。
“保存到此来源档案”检查窗口捕获的档案键仍对应当前来源,然后从该视图的标定对象保存。厂家/型号组合不保证设备唯一;需要设备级档案时由宿主提供稳定键。既有配置类型、Default 和来源键格式保留,不自动重命名历史配置。
未绑定视图的旧比例尺和尺子静态 API 仍使用 DefalutTextAttribute.Defalut 作为兼容回退。新代码必须从上下文取得标定,不继续使用静态有效值。物理长度只接受正有限值,其他值归一到 1。
保存与错误
ImageSettingsSession 在窗口创建时捕获已声明为 Application / Defaults 且有保存委托的目标。它仅序列化这些配置对象以比较改动,不遍历编辑器、图像缓冲或任意运行时对象。
- “保存更改”和“完成/关闭”只保存已改动的持久目标;未修改窗口和只读信息浏览不产生存储调用。
- 一个目标成功保存后更新比较基线;保存后再关闭不会重复写入。部分目标失败时,只保留失败目标等待重试。
- “将当前设为默认”是独立动作,成功后同步该默认目标的基线;当前值不会因为普通关闭而升级为默认值。
- 输入验证失败会定位对应页面并阻止保存/完成。存储失败保留窗口并显示错误;用户可重试或选择“关闭,稍后再保存”。后者不回滚已即时生效的内存改动,也不保证它们已经落盘。
ImageSettingsPersistence.Save检查当前配置服务仍拥有页面绑定的同一实例。ConfigHandler使用返回结果的TrySave;其他IConfigService沿用其保存契约,失败需抛出异常。无存储服务或实例已被替换时,显示相应错误而不报告成功。- 旧条目未声明范围时不在关闭时自动调用保存委托。它们需要显式保存按钮,提供方应逐项补齐范围和目标身份。
窗口不在关闭时重新枚举 provider。图像清除或档案来源改变后,旧图像/档案/兼容扩展页禁用并提示重新打开;当前视图工具偏好和已捕获的全局目标仍可使用。视图释放后局部页也禁用。窗口关闭时解绑配置、图像事件和修改跟踪。
扩展协议
ImageViewSettingsEntry 保留原构造签名,并补充 Id、OwnerId、CategoryId、Scope、Order、说明、只读标志、属性白名单、可选视图工厂和显式动作。
RegisterSettings 保留旧入口;需要卸载的提供方使用返回 IDisposable 的 RegisterSettingsProvider。窗口逐个隔离 provider 异常,以 OwnerId + Id 去重并按顺序展示。视图释放清空注册;注册句柄重复释放无副作用。
保存委托应捕获正在展示的对象,而不是执行时再次访问活动视图。例如全局默认配置:
var config = CvcieDisplayConfig.Current;
new ImageViewSettingsEntry(SettingsText.FileOpening, "CVCIE", config,
() => ImageSettingsPersistence.Save(config))
{
Id = "cvcie-display",
OwnerId = "Engine",
CategoryId = ImageSettingsCategories.FileOpening,
Scope = ImageSettingsScope.Defaults,
Description = SettingsText.FileHint
};外接模块与 ImageEditor 只共享协议,不共享业务控制器。自定义 CreateView 必须自己保证只读契约及资源生命周期;通用宿主无法推断专用控件是否写入数据。
验证
用实际宿主确认多视图的局部设置互不影响,校验跨窗口保存与重开。
用实际 WPF 资源核对布局和主题。跨屏 DPI、真实设备图像与外部二进制宿主分别验收。
