Skip to content

CVCIE POI 结果数值 ​

本主题说明 CVCIE/内存 CIE 的 POI 测量值如何进入结果列表、标注与 CSV,以及非正值处理的适用范围。CVCIEShowConfig 是应用级设置,不是每张图像的配置;它不会修改 CVCIE 文件或数据库原始 Value。

ImageView 区域与显示 ​

  • 椭圆独立设置两个半轴;圆是等半轴椭圆。矩形、椭圆和闭合多边形支持围绕中心旋转,测量使用图像坐标中的实际轮廓,不受缩放、描边和文字影响。绘制、闭合与自由套索操作见 ImageEditor 绘图。
  • ClosedPixelRegion 输出图内的扫描行区间。椭圆使用严格内部像素;多边形按奇偶规则填充,边采用半开区间,支持凹多边形及套索。超出图像的部分裁掉;未闭合的多边形、无有效像素的区域会报错,不产生本批新结果。
  • 新区域先对选中像素的 XYZ(单通道为 Y)求平均,再交给既有原生 POI 公式计算色度。传统圆和未旋转矩形仍走原有采样路径,保留边界取整约定;新区域不改变原生 ABI。
  • 鼠标信息探针和 CIE 图探针共享 CvcieMouseProbeOptions.CreateMeasurementPoint,支持点、圆、矩形、椭圆;椭圆使用区域宽度和高度,不提供多边形探针。
  • 磁盘 CVCIE 的鼠标探针和大图上的稀疏右键 POI 在后台读取取样区域,沿用原有像素选择和测量公式。右键 POI 的同一批区域共用一个文件句柄。区域较多、覆盖较大或已存在全图快照时,使用全图路径。每个探针只保留一个进行中的请求和最新的等待位置。离开画面或切图后丢弃旧结果。读盘核对打开时的文件大小、创建时间和修改时间。文件变更时保留当前画面和已有快照,重新打开即可读取新文件。
  • 结果表和统计默认显示三位小数,工具栏可选 0–9 位,计算值和 CSV 精度独立。复制选中行 按可见列及显示精度复制带表头的制表符文本。统计支持复制选中文字、完整数值或整组统计。
  • 本次测量回显居中并替代图形名称,名称本身保留。默认标记使用 X Y Z x y u′ v′ CCT λd 简写,可通过显示模板调整;结果表保留 CIE 标准名称及说明。移动、缩放、旋转或改变闭合状态时清除本次测量文字,重新计算后更新,手工消息不因此被清除。
  • 自定义节点与 EditPoiParam 模板按传统圆和矩形存储参数,忽略旋转与多边形。ImageView 可直接测量旋转区域和闭合多边形。D65 指标追加在 CSV 统计行后。

色彩中心与 D65 RMS ​

Color Uniformity(Δuv) 是 POI 两两之间最大的 CIE 1976 Δu′v′。相对 D65 RMS Δu′v′ 对有效 POI 等权计算。

[ \Delta u'v'_{RMS,D65}=\sqrt{\frac{1}{N}\sum_i[(u'i-u')^2+(v'i-v')^2]} ]

D65 使用 u′=0.1978294495、v′=0.4683321682。窗口同时显示平均 u′/v′、平均色度到 D65 的距离和相对平均色度的空间 RMS,并满足 RMS² = 平均色度偏差² + 空间 RMS²。NaN/无穷的 u′/v′ 不进入总数,但会计入“无效样本”;CSV 同步输出这些指标与样本数。

这里的 N 是当前结果列表中的有效 POI 数,不是 CVCIE 整幅图的每个像素。若产品规范明确要求 M×N 像素级指标,必须另行明确 ROI、低亮度排除和无效 XYZ 规则;不能把 POI 结果标成整图像素结果。

在 CIE 查看与分析 ​

在 POI 结果窗口选择 显示到 CIE 图,可在统一 CIE 窗口查看当前点。非负有效 XYZ 保留绝对亮度,其余可显示色坐标按仅 xy 查看。需要样品分析时,在 样品与色差 页点击 加入色度图当前点。关闭 POI 结果窗口会清除当前点,已记录的样品保留。 CIE 色度与样品分析

这条查看链不写回 PoiResultCIExyuvData,不修改原表格、复制行、数据库 Value、原生 CCT / Wave 或既有 CSV。派生指标只在 CIE 中展示;仅有 XYZ 无法恢复光谱、显色指数或光谱标定参数。

编辑图形回显内容 ​

在结果窗口进入 设置 → 图形回显 → 显示内容 → 选择字段。选择 X、Y、Z、x、y、u′、v′、CCT、主波长,并为每个字段选择 0–9 位小数;预览使用明确标注的示例数值,不代表当前测量。勾选模式按 XYZ、xy、u′v′、色温/主波长分行,回显使用简写。取消全部字段生成空模板。

高级 · 自定义模板 保留文字、单位、字段顺序和换行的手写入口,例如 Y:@Y:F1。多行编辑框把换行保存为原来的 \n 形式,仍使用 CVRawOpen.FormatMessage 渲染。原有模板打开时保持原文,关闭或取消不写回;修改勾选或小数位才按标准分组重新生成,存在自定义排版时会显示提示。高级编辑会同步字段选中状态和预览,格式异常会阻止应用。

点击 应用 才把草稿写回宿主配置;随后父属性窗口仍遵循其直接编辑/工作副本模式和应用配置保存规则。修改只作用于下一次三通道 POI 图形回显,不重新计算已打开的结果,也不改变单通道固定 Y 回显、表格精度和 CSV。窗口通过 PropertyEditorType 仅为 Template 配置专用编辑器,不全局替换字符串编辑器;EditCommand 不作为可编辑属性显示。

调整结果数值 ​

前提是图像视图已经加载可测量的 CIE 数据。打开与通道选择见 CV 文件读取;单纯的显示底图不保证存在测量缓冲。

  1. 在图像中准备椭圆(含圆)、矩形或闭合多边形测量区域,右键选择 POI,打开 WindowCVCIE 结果窗口。
  2. 点击结果窗口的 设置,在 计算结果 分类调整以下选项。
  3. 返回图像,再次执行 POI,查看新结果窗口。设置不会重新计算已打开窗口里的结果或旧标注。
  4. 需要 CSV 时,在新结果窗口点击 导出 CSV;导出使用该窗口的全部结果,不会重新测量。

右键 POI 使用点击时的区域。后台计算只读共享已有平面 CIE 像素。切图会丢弃旧结果,测量结束时几何已变化或已删除的图形不接收旧标注,结果窗口仍保留本次取样区域。

配置默认值行为
启用非正值替换 ClampNonPositiveValues开启对三通道 X、Y、Z 分别处理;单通道只处理 Y
最小值 MinimumValue0.0001替换值,接受大于或等于 0 的有限数;负数、NaN 或无穷大不写入,保留先前设置;关闭替换时隐藏此字段

设置使用直接编辑模式:字段写入设置对象后,关闭窗口不会撤销;它也没有独立的文件保存步骤。持久化遵循应用配置保存,旧配置缺少这两个字段时使用默认值。配置重载后,已开结果窗口仍持有初始化时的设置引用,应重新打开结果窗口再调整,避免编辑旧对象。

替换规则与色值重算 ​

“最小值”是替换值,不是所有结果的下限。开启时,CreateValueNormalizer 按 !(value > 0) 判断:

输入值开启替换关闭替换
正有限数保留,即使小于 MinimumValue保留
0、负数、NaN、负无穷替换为 MinimumValue保留
正无穷保留保留

例如默认设置下,-2 和 0 变为 0.0001,0.00001 仍为 0.00001。开关不能作为“所有输出都有限或大于零”的保证;MinimumValue=0 也合法。

三通道通过 NormalizeXyz 比较替换前后的 XYZ,只有至少一项实际变化才重算 x、y、u′、v′、CCT 与 Wave。它不单独替换这些衍生字段;XYZ 未变化时保留原来的色值,即使原值为负数或 NaN。单通道没有此重算步骤。

重算时,CalculateColorMetrics 先以 XYZ 中最大值归一化为浮点比例,再调用同一 POI 原生色温公式与主波长表,结果对象仍保留替换后的 XYZ。最大值不是正有限数时,衍生字段统一返回 NaN。例如负 XYZ 被替换为全零会触发此结果;原来就是全零、替换后也未变化时,则直接保留原衍生字段。原生公式还可能返回无效色值,主波长计算有 -1、-99 哨兵值,不能把重算完成当作有效测色判定。

生效时机与输出 ​

路径使用设置的时机与范围
图像右键 POI命令开始时取得一次配置快照,整批使用同一个数值处理函数;标注、列表、统计与 CSV 以这一批处理后的结果为输入
数据库结果转为 PoiResultCIExyuvData(model) / PoiResultCIEYData(model)每次构造显示对象时读取设置;不改模型中的原始 JSON,也不回写数据库
已加载的历史结果ViewHanlePOIXZY / ViewHanlePOIY 只在 ViewResults 为 null 时加载;再次选中同一项或执行 保存数据列 会复用已有值
鼠标探针、CIE 图探针、常规 PoiMeasurementService.Calculate使用常规测量路径,不读取此替换配置
真彩图像显示使用独立的显示配置,不由 CVCIEShowConfig 控制

修改后要重新观察历史数据,可重新 查询 创建新的主结果对象,再选中对应记录;查询与导出入口的范围见算法结果交接。关闭替换只能显示现有原始数据,无法恢复已被上游计算替换或丢弃的负值。

本地图像 POI 先用 CalculateRaw 请求保留原生非正值,再应用上述设置,因此关闭开关时能保留本次测量的实际负值。此路径要求 DLL 支持相应 V2 标志,不会因关闭界面开关而改回旧调用;参数、固定下限和不兼容 DLL 的处理见 POI Batch API。

标注还受显示数量和格式控制:本地视图的图元总数达到 1000 时不更新文字,三通道还检查 IsShowString 并使用 Template,单通道文字固定为 Y:F1。因此文字缺失或舍入为零,不等于结果集合没有数值。CSV 直接使用结果对象并覆盖选定文件;导出不同于重新计算。

验证边界 ​

变更色值算法需使用匹配的 native DLL。真实窗口操作、配置落盘后重启、旧 DLL 组合及设备样本按实际交付环境验证。

基于 MIT License 发布。