读取并比较图像

如果您在测试用例中添加 media access tab(媒体访问标签页) 的图像或 mask(掩膜)元素,就会显示此对话框。

../../../_images/Multimedia_Bild_lesen.png

该对话框分为四个部分:

引用

您可以在此更改 mapping item(映射项),或新建一个映射项。

在对话框右侧,您会看到当前从摄像头读取到的整张图像的预览。 如果已选择 mask(掩膜),图像上会高亮显示其边界。 您可以右键单击图像,并在上下文菜单中选择 Refresh 来刷新预览。

滤镜

您可以在此对图像应用一个或多个 filters(滤镜)。 通过滤镜,您可以处理图像,例如将其转换为黑白图或提升清晰度。 滤镜会在与期望图像进行比较或启动光学字符识别之前先执行。 通过复选框,还可以选择是否将这些滤镜应用到期望图像上。

左侧列表显示当前已应用到图像上的滤镜。 这些滤镜会按照从上到下的顺序依次执行。

您可以在右侧区域调整所选滤镜的参数。 在“value”列中,既可以指定数字、字符串等简单值,也可以引用 test case variables(测试用例变量) 或 API 调用。

该部分右侧会显示应用了掩膜和滤镜之后的已读取图像预览。

如果您在“评估”部分中选择期望类型“Image”,则同样会将滤镜应用到参考图像上。

保存图像

如果您希望将该图像保存到 test case variable(测试用例变量) 中以便后续引用,可以在此指定其名称。

评估

在此部分中,您可以设置一个在执行测试用例时进行评估的期望。 可以通过该部分左上角的下拉菜单选择不同类型的期望。

期望类型 Image

该期望会将从摄像头读取到的图像与一个或多个图像参考进行比较。 例如,可使用 Mask editor(掩膜编辑器) 创建期望图像。

用于比较的图像取决于参考表达式的求值结果。 所选参考类型定义了允许使用的值类型。

参考类型

有效输入类型

示例

对象

Image-Variable(图像变量) 或图像变量列表。

  • testCaseVariable

  • [var1, var2, var3]

Workspace(工作区)

字符串或字符串列表。这些字符串必须是 glob 模式,并以当前 Workspace 作为基础目录。

  • 'Images/Car.png'

  • 'Images/**/*.png'

  • ['image1.png', 'image2.png']

  • ['dir1/*.png', 'dir2/*.png']

图像目录 (仅适用于 Read Image 测试 步骤)

字符串或字符串列表。这些字符串必须是 glob 模式,并以 image directory of the corresponding media device(对应媒体设备的图像目录) 作为基础目录。

  • 'Images/Car.png'

  • 'Images/**/*.png'

  • ['image1.png', 'image2.png']

  • ['dir1/*.png', 'dir2/*.png']

此外,还可以定义两种不同类型的容差:

  • Color tolerance:当两个像素的颜色值差异小于 X 时,会将它们视为“相等”。 X 可以是 0 到 255 之间的数值。如果选择 0,则两个像素的颜色必须完全一致;如果选择 255,则任意像素都会被视为相等。 差异会针对每个颜色通道(红、绿、蓝)分别计算。

  • Tolerance:您可以在此指定两张图像之间允许有多少像素不同,超过该值后才会被视为“不相等”。 该值以百分比给出。0% 表示所有像素都必须匹配;100% 表示无需任何像素匹配,因此结果始终评估为“True”。 该容差在颜色容差之后应用。

右侧会显示将用于比较的图像。滤镜也会应用到该参考图像上。

Expectation Prompt

在这里可以为 ecu.test agent 定义 prompt。如果选择此期望类型,agent 将在运行时检查 prompt 是否得到满足。例如,可以定义 prompt “There is a car in the image.”,agent 将分析读取的图像并将该 prompt 评估为 SUCCESS 或 FAILED。也可以将 prompt 与参考图像结合使用,以 进行更复杂的分析。在这种情况下,参考图像将与 prompt 一起显示给 agent。图像来源的定义方式与“Image”期望类型相同。不过,此时参考图像不用于基于像素的比较, 而是用于支持 agent 完成 prompt。可以在此定义诸如“参考图像位于 读取的图像中。”或“读取的图像与参考图像相似。”之类的评估。对于 多个参考图像,可以使用从零开始的索引引用它们,例如“参考 图像 0 位于读取的图像中,而参考图像 1 不在读取的图像中。”

期望类型 String

如果选择该期望类型,ecu.test 会在应用滤镜后启动光学字符识别(OCR)。 您可以将识别出的文本与该部分输入字段中指定的文本进行比较。

如果文本未能被充分识别,则可能需要使用 filters(滤镜) 或 masks(掩膜) 对图像进行预处理。 通常,白底黑字可获得最佳识别率。图像缩放比例以及文本大小也会影响识别效果。 小写字母“x”的高度建议位于 10 到 30 像素之间,但实际数值会因字体不同而变化。 使用掩膜将图像裁剪到只包含目标区域,也可能提高文本识别效果。 另外,您也可以在 Image 变量上调用 API 方法 FindText(查找文本)。 该方法会执行多种预处理步骤来查找文本区域。

期望类型 Unspecific

您也可以在此手动定义条件。在这种情况下,“value”是一个 Image 对象。 Image 对象的接口可参见 API documentation(API 文档)。

更多信息