康耐视自己总结vp控件参数说明中文cnlsearch edit control

1、CNLSearch Edit ControlPage 1 of 7折叠全部Cognex Vis onPro代码：全部CNLSearch Edit Control发送反馈本包含以下章节。Control Buttons (控件按钮)CNLSearch Edit Control Buffers (CNLSearch 编辑控件缓冲区)Train Params Tab (Train Params 选项卡)Train Region and Origab (Train Region and Origin 选项卡)Run Params Tab (Run Params 选项卡)Search Region Tab

2、 (Search Region 选项卡)Graphics Tab (Graphics 选项卡)Results Tab (Results 选项卡)CNLSearch 编辑控件为 LSearchTool 视觉工具及其组件提供图形用户界面。CNLSearch 工具可以搜索图像中像素值的已训练样板。CNLSearch 工具的用法为：首先对训练图像的一部分或全部进行训练，使其成为已训练样板，然后在一张或多张搜索图像中搜索已训练样板。通过抓取样板来训练图像，指定训练区域、样板原点以及其他训练参数，然后对样板进行训练，即可完成样板训练。通过提供搜索图像并指定搜索参数就可以搜索已训练样板。CNLSearch

3、编辑控件包括以下组件：一排位于左上角的控件按钮。一个工具显示窗口，用于显示以下 CNLSearch 工具图像缓冲区：Current.TrainImage、Current.InputImage 和 LastRun.InputImage。这些缓冲区包含已训练样板，CNLSearch 工具在其中搜索样板的搜索图像，以及包含搜索结果的同一图像。右键单击工具显示可打开包括缩放图像或显示像素或子像素网格的菜单选项。一组按功能组织的选项卡。这些功能包括运行工具的参数设置、关注搜索区域的参数设置、工具显示的显示设置以及训练结果。按下Control + Tab 键在选项卡组之间滚动。一个位于控件左下角的状态栏。

4、绿色圆圈表示工具已成功运行；红色圆圈表示工具未成功运行。状态栏还会显示运行工具的时间以及所有错误代码或消息。状态栏首次显示的时间是工具的原始执行时间。状态栏第二次显示的时间包含更新编辑控件所需的时间。控件只在可见状态下才能更新。Control Buttons (控件按钮)下表介绍了位于编辑控件左上角的按钮。表 1. 控件按钮按钮说明运行 CNLSearch 工具。必须在 Current.InputImage 缓冲区中提供图像（相当于 InputImage）。此按钮会调用 Run 方mk:MSITStore:C:PROGRA1CognexVI1Doczh-HansVI1.:.2015-1-12C

5、NLSearch Edit ControlPage 2 of 7法。请注意，您必须已经训练过样板。CNLSearch Edit Control Buffers (CNLSearch 编辑控件缓冲区)CNLSearch 编辑控件具有三个图像缓冲区。其中两个缓冲区使用底层 CNLSearch 工具的 InputImage 和 TrainImage；第三个缓冲区显示运行 CNLSearch 工具的最后一个输入图像以及该搜索的结果。全部三个缓冲区均可显示在本地和浮动工具显示窗口中。Current.InputImage 为 CNLSearch 工具提供输入图像，此为 CNLSearch 工具的 Inpu

6、tImage 缓冲区。Current.TrainImage 包含已训练样板，此为 TrainImage 缓冲区。LastRun.InputImage 缓冲区显示最近运行此工具的最后一个图像。使用 Graphics 选项卡突出显示搜索区域和搜索结果。通过单击 Run 按钮运行 CNLSearch 工具时，工具会搜索 Current.InputImage，以寻找 Current.TrainImage 缓冲区中的样板。此搜索的结果显示在 Results 选项卡上，结果图形则显示在 LastRun.InputImage 缓冲区上（选择 Results 选项卡上的结果可突出显示其在显示屏上的图形；单击显

7、示屏上的图形可突出显示其在 Results 选项卡上的结果）。您可以使用 Current.InputImage 作为已训练样板；为此，转到 Train Params 选项卡并单击 Grab Train Image 按钮。此按钮会将Current.InputImage到 Current.TrainImage 缓冲区，您可以在其中使用它来训练 CNLSearch 将搜索的样板。请注意，您的应用程序负责将图像到编辑控件的 Current.InputImage 缓冲区。使用 Tool Group Edit Control 创建从 AcqFifo 工具输出图像到 CNLSearch 工具输入图像的，然后

8、运行 AcqFifo 工具或工具组，即可完成此操作。Train Params Tab (Train Params 选项卡)mk:MSITStore:C:PROGRA1CognexVI1Doczh-HansVI1.:.2015-1-12切换为电动模式。将其选中后，如果更改了某些参数，CNLSearch 工具将自动运行。编辑控件处于电动模式时，这些参数会显示闪电图标。打开或关闭本地工具显示窗口。此窗口有一个选择框，您可用它来指定您想要查看的图像缓冲区。打开一个或多个浮动工具显示窗口，以提供额外的工具显示窗口。与本地工具显示窗口一样，您可指定要查看的图像缓冲区。加载 ViPro 固有 (.vpp)

9、文件，此文件包含该视觉工具对象类型的一组已保存属性。为其他对象类型加载固有文件时会出现错误，加载会失败。有关 ViPro 固有功能的信息，请参阅 ViPro 中的“Persistence”。将底层工具的当前属性保存至 ViPro 固有文件。可以选择保存整个工具，也可选择保存不含其图像或结果的工具。将底层工具的当前属性保存至新的 ViPro 固有文件。将底层工具重置为默认状态。打开 Image Mask Editor，以创建要添加至训练图像的掩模。打开单独的新结果窗口，不用转至 Results 选项卡即可查看运行结果。启用或禁用此编辑控件中单个项目的工具提示显示。打开此帮助。CNLSearch

10、Edit ControlPage 3 of 7使用 Train Params 选项卡来配置和训练 CNLSearch 样板。利用此选项卡执行的关键操作包括获取训练图像指定训练时间参数训练样板下表总结了相关操作以及用于执行这些操作的控件。表 2. Train Params 选项卡功能功能说明Train Region and Origab (Train Region and Origin 选项卡)mk:MSITStore:C:PROGRA1CognexVI1Doczh-HansVI1.:.2015-1-12Pattern显示已训练样板的图像，由 TrainImage 内以青色边框突出显示的 Tra

11、inRegion 指定。可设置训练区域，方法是使用 Train Region and & Origin 选项卡或在 Current.TrainImage 中重新调整其显示大小。选项卡底部的消息文本指示是否已训练 CNLSearch 工具。Loattern从 ViPro 固有文件加载已训练样板。Save Pattern将当前已训练的样板保存到扩展名为 VPP 的 ViPro 固有文件中。Algorithm选择要训练哪种 CNLSearch 算法。您只能使用已训练过某个样板的算法来搜索此样板。这对应于 Algorithms属性。Ignore Polarity如果为真，与已训练样板呈负相关的样板将获

12、得正分。如果为假，则负相关的样板将得。这对应于IgnorePolarity 属性。Advanced Training Enabled如果为真，则启用 advanced training。高级训练可以用于修正重复样板图像，例如搜索结果位置确。高级训练仅应用于线性搜索算法。这对应于 AdvancedTrainingEnabled 属性。Partial Match Limits训练时部分匹配限制用于指定在运行时有多少已训练样板可以处于搜索图像的外部。训练时部分匹配限制仅用于启用了高级训练的训练期间。这对应于 PartialMatchLimitUp、PartialMatchLimitDown、 Par

13、tialMatchLimitLeft 和 PartialMatchLimitRight 属性。Train button根据在 TrainImage TrainRegion 中指定的方式来训练所需样板。调用 Train 功能。如果工具已经有已训练样板，将取消训练然后重新训练。样板训练成功后，控件底部的文本将显示“Trained”。Train 按钮仅在 Current.TrainImage 中有图像时才可用。Grab Train Image button将 TrainImage 缓冲区设置为 InputImage 缓冲区的参考。此按钮仅在 Current.InputImage 中有图像时才可用。您

14、的应用程序必须将图像到编辑控件的 Current.InputImage 缓冲区。使用 Tool Group Edit Control 创建从 AcqFifo 工具输出图像到 CNLSearch 工具输入图像的，然后运行 AcqFifo 工具或工具组，即可完成此操作。Edge Thresholds如果您在要训练的样板中包含 Nonlinear CNLPAS 算法，可以指定图像边缘像素的低阈值和高阈值。边缘强度（跨边缘的灰阶差异）低于低阈值的边缘像素会从已训练样板中排除，边缘强度高于高阈值的边缘则会包含在样板中；而边缘强度介于两个阈值之间的边缘则会在与其他高于高阈值的边缘存在 8 处连接时包含在样

15、板中。相当于 EdgeThresholdLow 和 EdgeThresholdHigh 属性。CNLSearch Edit ControlPage 4 of 7使用 Train Region and Origin 选项卡定义 TrainRegion，此操作可定义成为已训练样板的 TrainImage 缓冲区的区域。您还可以图形方式定义 Current.TrainImage 缓冲区中的训练区域。首先以图形方式指定训练区域，然后使用此选项卡微调训练区域参数，这样可能更容易。CNLSearch 编辑控件会更新训练区域值，以便此选项卡上的值与 Current.TrainImage 缓冲区中的训练区域形

16、状始终匹配。可以度数（默认）或弧度指定此选项卡上的某些参数，如 Ro它们转换成度数。ion 和 Skew。底层工具始终使用弧度值，但编辑控件会在适当时会将表 3. Train Region 功能功能说明表 4. 训练原点功能功能说明Run Params Tab (Run Params 选项卡)mk:MSITStore:C:PROGRA1CognexVI1Doczh-HansVI1.:.2015-1-12Origin X Origin Y用于定义训练区域原点位置的值。以图形方式修改原点时，这些值将改变。相当于 OriginX 和 OriginY 属性。Center Origin将训练区域的原点置

17、于训练区域的中心。TrainRegionMode定义工具如何解释您所指定的训练区域。Pixel Aligned Bounding Box 使用您所指定区域中的像素以及包围此区域的像素配对限定框中的像素来训练样板。这表示包含位于已定义区域之外但位于限定矩形之内的图像部分。Pixel Aligned Bounding Box Adjust Mask 将已定义区域包围在矩形内，但会遮盖区域以外、矩形以内的图像部分，结果是只有您指定区域内的像素包含在已训练样板中。仿射变换只能在区域形状为 CogRectangleAffine 时使用。此模式通过对区域的像素进行仿射变换来创建新图像。一般来说，此模式在您

18、知道运行时图像相对于训练图像进行了旋转或其他仿射变换时十分有用，但如果可能，应从与运行时图像类似的图像进行训练，而非试图对预期的旋转或仿射变换进行补偿。TrainRegion选择输入区域的形状。选择“None=Use entire image”表示此工具使用整个输入图像。CNLSearch 工具支持以下输入区域形状：CogCircleCogEllipseCogPolygonCogRectangleCogRectangleAffine所显示的区域定义参数集取决于所使用的区域形状。有关使用多边形作为输入区域的信息，请参阅 “Using Polygon Input Regions”。Selected

19、 Space Name解释训练区域的坐标空间。相当于 SelectedSpaceName 属性。有关信息，请参阅“Coordinate Space Names”。Select Mode当 Region Sh为 CogRectangle 或 CogRectangleAffine 时可用。选择用于定义矩形的参数集。如果选择 cogRectangleAffine，请注意，旋转角度和倾斜角度可以度数或弧度指定，但底层工具始终使用弧度来作为度量。Fit In Image使训练区域在 Current.TrainImage 内居中。相当于 FitToImage 属性。CNLSearch Edit Contr

20、olPage 5 of 7使用 Run Params 选项卡指定如何执行样板搜索。这些参数包括要使用的运行算法、阈值和限制。表 5. Run Params 选项卡功能功能说明Search Region Tab (Search Region 选项卡)mk:MSITStore:C:PROGRA1CognexVI1Doczh-HansVI1.:.2015-1-12Algorithm应用于执行 CNLSearch 检测的算法。您可以为已训练图像中具有线性亮度变化的搜索图像指定 Linear Search or Linear CNLPAS 算法，或者为具有非线性亮度变化的搜索图像指定 Nonlinear

21、 CNLPAS 算法。性模式算法中，Linear Search 算法更为激进，速度较快，但可能遗漏某些样板实例，Linear CNLPAS 算法则较为保守，速度可能较慢，但不太可能遗漏任何样板实例。此设置相当于 Algorithm 属性。请注意，对于指定用于搜索的算法，必须已经进行过样板训练。Accuracy指定搜索的 accuracy 级别。请注意，对于指定用于搜索的精确度级别，必须已经进行过样板训练。um Results指定要查找的结果数。相当于 MaxResults 属性。Accept threshold指定结果分数的 acceptance threshold。指定一个值，使得样板的任何

22、实际实例所得到的分数都不会低于此阈值。相当于 AcceptThreshold 属性。Confu threshold指定结果分数的 confuthreshold。指定非有效样板所能得到的最高分数。此值向工具表明您所期望的搜索图像的程度如何；指定的值越大，工具将越仔细。相当于 ConfuThreshold 属性。XY Overlap两个样板实例之间允许的最大 overlap 百分比（0.0 到 1.0）。如果两个样板实例的区域超过指定的百分比，则分数较低的样板实例将被丢弃。相当于 XYOverlap 属性。Reduce Partial Match Score如果选中，CNLSearch 将减小有部

23、分位于搜索图像外部的样板实例所得到的分数。分数按照样板处于图像内部的百分比进行。相当于 PartialMatchReducore 属性。Search Po Enabled启用点搜索（仅 Linear Search 算法支持点搜索），此时 CNLSearch 会尝试仅查找使用 SearchPo X 和SearchPo Y 控件指定的某个点处或该点附近的单个样板实例。相当于 SearchPo Enabled 属性。Use Run Params Partial Match Limits如果选中，CNLSearch 将使用您在 Run Params 选项卡中指定的部分匹配限制来限制允许已训练样板的多大

24、部分处于搜索图像外部。如果未选中此复选框，则将使用 Train Params 选项卡中指定的部分匹配限制。选中此选项按钮相当于将 PartialMatchLimitsUsePattern 属性设置为假。Edge Thresholds Use Pattern仅针对非线性 CNLPAS 算法。如果选中，CNLSearch 将使用您在 Train Params 选项卡中指定的边缘阈值来创建运行时图像边缘。如果未选中，将使用您在此选项卡中指定的 EdgeThresholdLow 和 EdgeThresholdHigh 阈值。相当于 EdgeThresholdsUsePattern 属性。CNLSear

25、ch Edit ControlPage 6 of 7使用 Search Region 选项卡定义 SearchRegion，即限制样板搜索的 InputImage 缓冲区区域。搜索区域以青色边框显示在 Current.InputImage 中，您可以图形形式定义此缓冲区中的搜索区域。首先以图形方式指定搜索区域，然后使用此选项卡微调搜索区域参数，这样可能会更容易。重新调整 InputImage 中搜索区域的大小时，此选项卡上的值会变化；同样地，更改参数值会导致搜索区域改变其大小和形状。表 6. Search Region 选项卡功能功能说明Graphics Tab (Graphics 选项卡)使

26、用 Graphics 选项卡选择 LastRun.InputImage、Current.InputImage 以及 Current.TrainImage 显示缓冲区中显示的结果图形。mk:MSITStore:C:PROGRA1CognexVI1Doczh-HansVI1.:.2015-1-12Region Mode定义区域的限定框。相当于 SearchRegionMode 属性。Pixel Aligned Bounding Box 将已定义区域包围在矩形内。这表示包含位于已定义区域之外但位于限定矩形之内的图像部分。仿射变换只能在区域形状为 CogRectangleAffine 时使用。此模式通

27、过对区域的像素进行仿射变换来创建新图像。您将使用此方法来修正已训练样板和运行时图像之间的旋转或其他仿射变换。Region Sh搜索区域的形状，相当于 SearchRegion。选择“None=Use entire image”表示整个 Current.InputImage 成为搜索区域。区域定义的参数集取决于所选的 Region Sh。Selected Space Name解释搜索区域的坐标空间。相当于 SelectedSpaceName 属性。有关信息，请参阅“Coordinate Space Names”。Select Mode当 Region Sh 为 CogRectangle 或 Co

28、gRectangleAffine 时可用。选择用于定义矩形的参数集。如果选择 cogRectangleAffine，请注意，旋转角度和倾斜角度可以度数或弧度指定，但底层工具始终使用弧度来作为度量。Fit In Image使搜索区域在 Current.InputImage 内居中。相当于 FitToImage 方法。CNLSearch Edit ControlPage 7 of 7表 7. Graphics 选项卡功能功能说明Results Tab (Results 选项卡)Results 选项卡显示最近的样板搜索结果。这对应于 LSearchResult 界面。使用结果网格下面的滑块控件显示完

29、整的结果集。表 8. Results 选项卡功能功能说明 2013 Cognex Corporation 保留所利mk:MSITStore:C:PROGRA1CognexVI1Doczh-HansVI1.:.2015-1-12Results Grid显示每个结果的以下信息。此结果的 Score。范围为 0.0 至 1.0，值越大表示匹配得越好。LocationX 和 LocationY 指定了样板原点在输入图像中的位置。此位置位于输入图像的所选空间内。AreaCoverageScore 是样板实例位于搜索图像内的部分（范围从 0.0 到 1.0）。此分数仅适用于使用 Linear Search 算法执行的搜索（其他算法无法查找部分位于搜索图像外部的样板）。AreaScore 是匹配的