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 文件读取;单纯的显示底图不保证存在测量缓冲。
- 在图像中准备椭圆(含圆)、矩形或闭合多边形测量区域,右键选择 POI,打开
WindowCVCIE结果窗口。 - 点击结果窗口的 设置,在 计算结果 分类调整以下选项。
- 返回图像,再次执行 POI,查看新结果窗口。设置不会重新计算已打开窗口里的结果或旧标注。
- 需要 CSV 时,在新结果窗口点击 导出 CSV;导出使用该窗口的全部结果,不会重新测量。
右键 POI 使用点击时的区域。后台计算只读共享已有平面 CIE 像素。切图会丢弃旧结果,测量结束时几何已变化或已删除的图形不接收旧标注,结果窗口仍保留本次取样区域。
| 配置 | 默认值 | 行为 |
|---|---|---|
启用非正值替换 ClampNonPositiveValues | 开启 | 对三通道 X、Y、Z 分别处理;单通道只处理 Y |
最小值 MinimumValue | 0.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 组合及设备样本按实际交付环境验证。
