Skip to content

模板编辑与创建宿主 ​

TemplateEditorWindow 是已有模板列表和编辑宿主;TemplateCreateView 负责准备创建来源与预览,TemplateCreate 只包装独立创建对话框。它们调用具体 ITemplate,不提供统一的数据库事务、撤销系统或隔离编辑会话。

注册身份、参数加载和普通持久化的唯一说明在模板注册、参数与持久化。模板菜单、JSON 编辑器和Flow 工作区各有独立入口与实现,不因共用模板窗口就拥有相同保存和运行语义。

编辑已有模板 ​

  1. 从模板菜单、算法面板或应用搜索进入目标模板。普通模板在右侧显示参数,专用模板可能提供独立编辑控件或双击入口。
  2. 点击名称选择条目,按住 Ctrl 或 Alt 单击可切换单行的选中状态,按住 Shift 单击可选择连续多行。数据库“序号”默认隐藏,需要时右键列头显示。列表获得焦点时按 Ctrl+F 打开搜索,按 Esc 关闭并清除筛选。
  3. 点击 保存,窗口会在 Save() 返回后关闭;使用保存快捷命令时窗口保留。重新打开并核对实际参数,具体数据库保存规则取决于模板类型。

通用 JSON 编辑器实现 ITemplateEditorValidation。保存、切换记录和最终创建前,宿主先检查编辑器草稿;有错误输入时保留当前编辑内容并阻止操作,避免保存上次有效值却表现为保存了当前草稿。该保护只适用于实现接口的编辑器,不改变其它模板的保存契约。

普通属性面板直接编辑共享参数对象。关闭窗口不是通用的“放弃更改”操作:它会重新调用 Load(),但不撤销已经发生的创建、删除、排序或数据库写入;离线重新加载也不恢复旧值。

打开、选择、保存和关闭 ​

阶段当前调用链不能据此推断
构造编辑窗口先同步 template.Load(),再初始化控件;绑定 ItemsSource 与初始索引打开窗口是只读操作、数据库与全部条目都健康
普通条目选择按选中对象找源集合索引,调用 SetSaveIndex,把 GetParamValue(index) 直接交给 PropertyGrid已建立独立工作副本,或只有真正修改的条目才被保存
自定义条目选择SetSaveIndex 后调用 SetUserControlDataContext(index)自定义控件一定复制参数或支持撤销
保存按钮ITemplate.Save(),随后关闭窗口多条 SQL 都已提交、所有消费者都已刷新
保存快捷命令ITemplate.Save() 正常返回后显示成功提示,窗口不关闭提示验证了影响行数或数据库事务
关闭再调用 ITemplate.Load()回滚已写数据库、撤销创建/删除/排序,或离线时恢复未保存值

普通属性面板收到的是共享参数对象,修改可立即被同一对象的其它持有者看见。重命名的 TemplateModel<T>.Key 也直接改 Value.Name;Enter、失焦或窗口停用只是退出名称编辑状态,不是名称校验、保存或回滚。普通保存索引是位置,不是稳定记录 ID。

普通泛型 Load() 在数据库连接可用时替换既有包装项的 Value,但不移除数据库已不存在的条目。并行窗口、静态 Params 和旧参数引用不具备会话隔离;重新加载后的包装项与旧参数引用也可能指向不同对象。

编辑控件与创建预览是不同钩子 ​

IsUserControl=false 时使用 PropertyGrid;为 true 时,编辑宿主调用 GetUserControl(),必要时从原 Grid 移除该控件并重新挂载。若模板实例缓存同一控件,打开另一个窗口不保证得到新的控件实例或独立状态。

IsSideHide=true 会隐藏右侧编辑区域并改变布局;列表双击仍交给 PreviewMouseDoubleClick(sourceIndex),由具体模板决定打开什么。Flow/POI 的独立编辑行为不能从普通 PropertyGrid 路径推定。

创建预览另用 CreateDefault()、CreateUserControl() 和可选的 ITemplateUserControl.SetParam(),不是复用 GetUserControl() / SetUserControlDataContext()。只实现已有模板编辑控件,并不保证新建预览也正确;基类 CreateUserControl() 仅返回空控件。

创建来源、预览与取消 ​

点击 新建,选择默认模板、内置业务预设、现有模板副本或导入文件等可用来源;修改名称和预览参数后点击 创建。名称会去除首尾空白,必须非空且通过该模板的重名检查。来源列表表示当前实现提供的准备方式,最终内容以实际预览和具体模板的创建结果为准。

已有条目的 创建副本 和列表顶部的 导入 会先准备内容,再打开创建窗口。导入窗口隐藏来源选择;文件已选好仍需完成创建。创建后列表数量变化时,宿主清空搜索并选择新条目;应核对条目名称及参数,不能只看列表数量。

TemplateCreateView.Initialize 构建来源列表;是否展示现有副本、文件导入,取决于反射判断 CopyTo(int) / Import() 是否被覆写,不是运行能力测试。普通模板列出默认来源;UseCatalogCreateSources=true 的模板只列出内置和现有分区,不提供 Default/File 来源卡片。Flow 启用该模式,打开时优先选择首个可用内置流程;空分区和无匹配搜索清除旧草稿与预览并禁用创建,不能从隐藏项创建。已准备的复制/导入内容仍以 Prepared 接入。已有暂存内容时增加 Prepared;请求 Existing 时先找指定索引,找不到再找同类首项,请求类别不存在才回退 Prepared、Default。

来源ApplyTemplateSource 的动作重要边界
Default清理模板暂存,随后准备默认预览默认值可能读取字典/数据库,不是纯本地空对象
Prepared使用当前 HasCreateTemplateSource 所表示的已准备内容不重新读取原文件,不证明所有资源引用有效
Existing对该源集合索引调用 CopyTo副本准备的深度、ID重映射和失败状态由子类决定
File调用 Import(),成功后使用其暂存内容和 ImportName文件选择完成不等于模板已创建;导入本身可能有子类副作用
Preset通过 ITemplateCreatePresetProvider.GetCreatePresets 列出,再用 ApplyCreatePreset(id) 准备草稿描述、分类及建议名由提供者定义;不能假定所有模板都支持,持久化仍由具体模板负责

内置预设加载失败时显示说明,并继续提供其余来源;来源筛选包含预设标题、描述与分类标签。BuiltInTemplateCatalog 从随包只读 SQLite Assets/Templates/BasicTemplates.db 按模板代码读取元数据和参数。选中预设时,预览上方显示业务用途、应选择的模块和适用条件。读取、选择及取消不创建、迁移或写入用户库;点击创建仍使用对应模板的持久化路径,不替换已有用户模板。

当前基础库包含 37 项:传感器 13 项,参数模板 15 项,以及流程 9 项。参数模板覆盖相机固定曝光、16 位自动曝光、四角区域 POI 布点、Y/XYZ 文件输出、亮度/色度均匀性、4×4 棋盘格对比度、MTF 图案、矩形亮区定位和 AA 布点;流程覆盖相机取图、拍照与 POI、亮度/色度均匀性、棋盘格对比度、拍照/图片条纹 MTF、图片发光区定位和通用传感器控制。预设从反馈中的实际参数和常见业务步骤提炼;跨设备复制的同名数据不能当作独立真机验证,名称相同也可能有不同曝光或阈值。图像处理的阈值/尺寸及相机曝光仍需按实际图像与设备调整。标定文件、固定光学中心、FOV 距离及源表电压/限流不作为这批通用基础参数。

ITemplate<T> 使用 mod-details 格式,以区分大小写的字典 symbol 映射目标库 ID;ITemplateJson<T> 使用 json 格式,在独立草稿中保存参数对象。ParameterTemplatePresets 同时检查载荷版本与格式。BuildPOI、auto_exp_time、Camera.RunParams 等代码存在新旧存储共用情形,因此创建来源按代码及载荷格式筛选,不能只按代码将 JSON 填入字典明细。缺少或重复的目标字典 symbol 会明确拒绝应用,避免静默丢失参数。传感器独立使用指令载荷,其适用协议和保存边界见传感器模板。

Flow 单独处理 flow-recipe 载荷,由固定节点类型构建实际连线的 STN 草稿;右侧显示结构预览与运行前配置清单,创建后双击进入流程编辑器。选择和预览不执行节点、不导入关联参数模板。流程的本地/MySQL 保存、设备与服务前提由流程模板契约维护。

来源应用失败时会恢复之前的列表选择或显示错误,但没有对具体模板内部状态做事务回滚。切换来源会重建预览;离开 Prepared 后会移除该来源条目。来源搜索只筛选标题、描述和来源标签,不重新查询数据库。

非 IsSideHide 模板会调用 CreateDefault 准备预览参数:普通控件直接编辑该对象,自定义控件通过创建预览钩子接收它。IsSideHide 跳过预览,所以不能假定每条创建路径都已准备 CreateTemp。预览异常会隐藏面板并显示错误,却没有一个统一的“预览失败则禁止创建”门禁;创建能否完整落库取决于具体实现,普通实现没有统一的完整性保证。

创建按钮 Trim 名称,检查非空、ExitsTemplateName 和已选来源,然后调用 TryCreateTemplate。成功时清暂存并发出 TemplateCreated;独立对话框记录 CreateName、设置 DialogResult=true。这只是所调用创建路径的报告,不是独立的数据库验收。

取消、Esc 或未成功创建就关闭对话框,会调用 Discard:清理模板创建来源、选中来源和预览控件。它不删除可能已经创建的数据库记录,不回滚子类导入副作用,也不恢复另一个窗口持有的共享对象。新建、复制和导入的调用方还应核对实际集合/数据库状态,不能只看对话框结果。

搜索后的显示位置不总是源位置 ​

筛选结果按模板对象定位。搜索框按 Enter 打开当前结果并收起搜索。顶部操作栏以图标和文字显示新建、保存、导入、导出和删除,删除和导出作用于当前选中的行。列表获得焦点时,Alt+Delete 也可打开删除确认,确认框列出目标名称。批量导出沿用模板原有的打包格式。

编辑参数时,单按 Delete 由当前编辑控件处理。删除模板请用工具栏或列表右键菜单的“删除”,也可在列表中按 Alt+Delete。

列头排序改变源集合顺序。拖动按源对象找到两个目标,一次异步交换这两个模板的数据库顺序,中间项不动;不会逐项交换拖动经过的记录。保存期间禁用窗口交互并阻止关闭,提交成功后共享集合和下拉列表同步,失败提示重新打开核对。MySQL 的主记录 ID 与明细 Pid 在同一事务中交换,本地模板则交换 SQLite sort_order,具体约束见模板持久化与排序。

TemplatesExtension.CreateEmpty 是下拉列表适配:新增 Empty 项,并复用源集合中的包装对象;监听 Add/Remove/Reset,不是完整的 Move/Replace 同步或独立深复制。使用这种列表的调用方要处理空项与索引偏移,不直接拿显示索引写入模板源集合。

全局搜索和模板设置 ​

应用搜索按注册键与条目名称标识候选,执行时重新解析当前注册并查找索引;打开普通编辑器或专用入口的规则统一见模板入口。搜索目录与窗口加载属于不同阶段,候选可见不代表数据库内容已经刷新。

TemplateSetting 由 ConfigService 解析,保存模板窗口设置。普通编辑列表每次打开默认显示名称列,列头菜单可临时调整列的可见性。公共窗口的操作栏与列表使用当前主题资源,右侧挂载各模板自己的参数编辑器。设置的保存与重载见软件配置契约。

验证入口与缺口 ​

通用模板取消、筛选后目标选择、控件复用和数据库增删改查按具体实现核对。

有授权时,应以隔离数据库和非敏感样例分别验证:打开/关闭、真实目标身份、默认/副本/文件来源、预览失败、保存部分失败与旧引用。记录已执行的最小用例和缺口;不要通过重置现场数据库、启动真实流程或删除模板来验证文档。

基于 MIT License 发布。