康耐视自己总结vp控件参数说明中文2d symbol tool edit control

1、2DSymbolToolEditPage1of折叠全代码：全Cognex2DSymbolToolEdit发送反2DSymbolToolEditPage1of折叠全代码：全Cognex2DSymbolToolEdit发送反包含以下章节Control Buttons (控件按钮Train Params Tab (Train Params 选项卡Train Region Tab (Train Region 选项卡Train Results Tab (Train Results 选项卡Run Params and Reg on Tab (Run Params and Reg on 选项卡Graphcs

2、 Tab (Graphics 选项卡Results Tab (Results 选项卡在此版本中弃用了 2D Symbol工具。对于查找2D符号的新应用程序请使用 IDtool(ID工具)。此版本对于现有应用程序继续支持 Symbol 工具。Cognex 建议您迁移至 ID 且请了解未来的 Pro 版本将完全取消支持 2D Symbol 工具。2D Symbol 工具编辑控件为 Cog2DSymbolTool 工具提供图形用户界面，此工Data Matrix 和 Qu ck Response (QR) 符号。此编辑控于指定 operating mode，设置一系列 train parameter

3、s，以及查看 2D Symbol tool results。2D Symbol tool 编辑控件如下图所示此编辑控件提供以下功能一排位于左上角的控件按钮，可完成大部分常规操作一组功能选项卡，用于选择代码系统的类型（Data Matrix 或 QR 代码）、指定符号中内建的错误校验与校正 (ECC) 一个图像显示窗口，用于显示取像和 2D Symbol 您可以尝试用 QuickBuild 来创建 Cog2DSymbol 工具，以练习使用此编辑控件。新的 Cog2DSymbol 工具带有 InputImage 的输入终端以及若干结要在自定义视觉应用程序中包含此编辑控件，必须先将其添加至您的 Vi

4、sual Stud o.NET 开发环境。有Controls to Visual Studio”信息，请参“Adding Ed Control Buttons (控件按钮下表介绍了每个按钮的功能表 1. 控件按1Doczh-2DSymbolToolEditPage2ofTrainParamsTabTrainParams选项卡本节包含以下子节Operating Decoded String Code 2DSymbolToolEditPage2ofTrainParamsTabTrainParams选项卡本节包含以下子节Operating Decoded String Code attern and

5、 Save TrainAdvanced Train Train使用 Train Params 选项卡设置工具将使用的操作模式，选择代码系统方法并使用训练图像。下图所示为默认的 Train Params 选项1Doczh-说功根据需要了解特定的训练参数当前输入图像中的符号Electric 切换为电动模式，在此模式下，2Dymbl工具在特定配置参数更改时自动执行。在电动模式下，每个电气特性旁会显示闪电图标。Localimage 打开或关闭本地图像显示窗口。2D Symbol 工具支持以下图像缓Current.InputImage 缓冲区，包含工具将要分析的下一个图像以及您可在 Run Params

6、/Region 选项卡上Current.TrainImage 缓冲区，包含您用于以典型参数训练此 2D Symbol 工具的符号图像，其中典型参数LastRun.InputImage 缓冲区，包含由 2D Symbol 工具处理的最后一个图像以及您从 Graph cs 选项卡启此外，根据您在 Graphics 选项卡中的选择，本地图像显示可能包含以下图像缓冲区输入图像中用于训练样板的区域的图像缓冲Floatingimage 打开一个或多个浮动图像窗口，这些窗口支持与本地图像显示窗口相同的图像缓冲区打开 ViPro 固有 (.vpp) 文件，此文件包含该视觉工具对象类型的一组已保存属性。尝试为其

7、他对象类型打开 .vpp 文件时，ViPro 会将视觉工具的当前属性保存至 ViPro 固有 (.vpp) 文件。此编辑控件可以选择在保存视觉工具时一并保存或Save 将视觉工具的当前属性保存至新的 Pro 固有 (.vpp)文件将视觉工具重置为默认状态此工具可以选择重置为默认构造状态（适用于 Visual Studio.NET 应用程序）或其模板初始化状态（适用QuickBuild 应用程序）Show 启用或禁用编辑控件中单个项目的工具提示显示打开此 Vis onPro 的联机帮助文件2DSymbolToolEditPage3of 您必须选择以下操作模式表 2. Operating Mode

8、2DSymbolToolEditPage3of 您必须选择以下操作模式表 2. Operating Mode 选选说使用 Symbology 字段选择此 2D Symbol 工具将设置切换为 QR Code。的符号类型。默认情2D Symbol 工具被配置Data Matrix 符号。必要时将Decoded String Code 一些 2D 代码系统可以采用不同的语言编码其数据，但前提是遵守国际标准化组织 (ISO) 制定的特定代码页。默认情况下，2D Symbol 工具用 Code Page 1252 - Latin 1 (English)，但您可将其改为使用 Code Page 932

9、- 。虽然此编辑控件仅提供英语和日语字符集的选项，但您可使用 Visual Studio.NET 视觉应用程序中的 DecodedStringCodePage 属性来指Windows 支持的任何代码页。如果您使用除 1252 或 932 以外的其他代码页，此编辑控件中的此字段将反映代码页。atternandSave此编辑控件提供以下按钮，用以载入和保存您用于通过您想要进的符号的典型特征来训练工具的样板1Doczh-使用可有效处理典型质量符号的算法来训练符号。对于大多数应用程序Symbols操作模式可最轻松地实现最佳性能。工具通过分析在 Current.TrainImage 缓冲区使用可处理高度

10、磨损符号的算法来训练和 符号。仅在无法使用 Typ cal Symbols 模式来成功训练样板时，才尝试使用此模式。使用此模式可 许多 Typical Symbols 模式自动学习的配置参数。您可以选择让工具学 些参数的最佳设置，同时明确地设定其他设置。此外，您可以使用 Train Region 选项卡来指定训练图像的精确区域，还可指定 nominal gr d 来准确定义 finder pattern 的位置和方向。2DSymbolToolEditPage4of表 3. 样板按按功Train Buttons (Train 按钮此编辑控件提供以下按钮用于抓取训练图像以2DSymbolToolE

11、ditPage4of表 3. 样板按按功Train Buttons (Train 按钮此编辑控件提供以下按钮用于抓取训练图像以及训练实际样板表 4. Train 按按功您可以选择指定超时值，如果工具未能在指派的时间内训练好样板，此值会导致 2DSymbol工具生成 CogimeoutExpiredException。此编辑控件不强制规定超时值上限。Advanced Train 5. Advanced Train Opt 选功训练参数仅在使用 Highly Degraded Symbols 模式时才可用，因为在 Typical Symbols 模式下，工具会自动学习所有训练参数。您可以将训练允许

12、工具学习哪些训练参数以及预先配置哪些训练参数都取决于您视觉应用程序的具体需求。请记住，2DSymbl工具在有关学习训练参数的能力方面具有以下行为：。如果您让工具从当前图像学习针对所有训练参数的当前设置，则工具将尝试这样做，并利用其认为最可能存在于当前图像中的设置来号。符数的学习。如果工具无法充分确定某个被禁用了学习的训练参数，它将使用预设参数设置来尝符号对 2D Symbol 工具在适应连续图像中符号外观可能出现的变化方面，此方法实现了最大的灵活性表 6. Train 1Doczh-允许工具补变形，当相机与的符号之间不成 90 度时可能发变形允许工具补偿不符合规范的模块，即点阵中的每个点看起来

13、都有一个亮域和一个暗域 在 Current.InputImage 缓冲区中的图像到 Current.TrainImage 缓冲区。工具必须具有其中包含在将根据Current.rainImage缓冲区中当前所的图像以及您指定的训练参数（如果您使用 HighlyDegradedymbls操作模式），训练工具将使用的样板。如果训练图像未包含足够信息来成功完成样板的训练，ViPro 会显示错误消息。例如，如果您指定的训练区域中未包含足够的必需特征，则可能发生这种情况。Current.TrainImage 缓冲区中必须具有训练图像，此按钮才会启从Pro 固有 (.vpp) 文件加载样板，用于通过的符号的

14、典型参数来训练工具将当前的样板保存至 Pro 固有 (.vpp)文件2DSymbolToolEditPage5of参说TrainRegionTabTrainRegion选项卡本节包含以下子节Train 2DSymbolToolEditPage5of参说TrainRegionTabTrainRegion选项卡本节包含以下子节Train Nominal Gr使用 Train Region 选项卡可指定包含您应用程序典型符号的训练图像的精确区域，还可指定标称网格来精确定义搜寻器样板的位置和下图所示为默认的 Train Reg on 选项1Doczh-如Data Matrix 符号，工具支持两种错误校

15、验与校正 (ECC) 方法：卷积码（ECC 50、80100 和 140）和 Reed-Solomon 编码（ECC 200）。ECC 的级别较高时，即使存在较大量损坏或如QR Code 符号，工具支持版本 1、2以及 McroQRTrainFlags 或 自动学习 ECC 级别或 QR Code 每个符号是黑底白字还是白底黑字。请参阅 2D Symbol 理论中的 Polar ty 章节了解自动学习样板的极性DataMatrixRows 如Data Matrix 符号，您可以设置行数和列数QRCodeGr如QR 符号，您可以为每个符号设置 grid size自格尺寸让工具学习最佳的 nomi

16、nal grid 以定义搜寻器样板的尺寸和方向指定符号是否在每个取像中呈 mirrored指定符号是否符合 AIM 2DSymbolToolEditPage6of使用选项卡的 Train Reg on2DSymbolToolEditPage6of使用选项卡的 Train Reg on 部分指定其中包含典型符号的训练图像的精确区域。默认情况下，工具使用整个训练图像，但如果它包含可能使具在尝试训练符号样板时产的其他图像特征，您就可能需要选择训练图像的子集。如果您选择了一个区域形状而非整个图像Current.TrainImage 会以青色显示区域形状，如您可选择区域以调整其尺寸以及在训练图像中的位置

17、。此外，您还可以使用以下参数来进一步调整区域形状表 7. Train Region 参参说1Doczh-定义工具如何解释您所指定的训练区域。选择以下任一选项Pixel Aligned Bounding Box 仿射变换仅在您为区域形状指定 CogRectangleAffine 时有效，其中仿射矩形中的像素将进行 affine transformation 来去除任何旋转和倾斜效果，然后再由工具尝试选择输入区域的形状。选择“None=Useentireimage”表示此工具使用整个输入图像。2Dymbl工具支持以下输入区域形状： To Use Polygon Input Regions”。解释训

18、练区域的坐标空间。有关信息，请参阅“Coordinate Space Names”2DSymbolToolEditPage7of使用选项卡的 Nominal Grid2DSymbolToolEditPage7of使用选项卡的 Nominal Grid 部分定义矩形，从而定义 Data Matrix 和 QR Code 符号中搜寻器样板的尺寸和方向。2D Symbol 工具依赖于标称网格所提供的点位置来精确定位图像中的搜寻器样板。在 Typ cal Symbols 模式中，工具会在您训练样板时尝试自动检测点位置，并忽略任何标称网格设置。仅在您使用 Highly Degraded Symbols

19、模式时才定义标称网格。不论您是否使用 Highly Degraded Symbols 模式，Current.TrainImage 缓冲区始终会显示标称网格的形状。如果不选中，标称网格将呈品红您可以选择标称网格的图形来调整其大小并重新定位，以使其与搜寻器样板周围的区域拟合，如下图此外，您还可以使用以下参数来进一步调整标称区域表 8Nominal Grid 参参说1Doczh-指定解释训练区域的坐标空间。有关信息，请参阅“Coordinate Space Names”Select 选择用于定义标称网格的参数集。请注意，旋转角度和倾斜角度可以度数或弧度指定，但底层工具始终以弧度来作为度量。使标称网格

20、在 Current.TrainImage 内居中2DSymbolToolEditPage8ofTrainResultsTabTrainResults选项卡本节包含以下2DSymbolToolEditPage8ofTrainResultsTabTrainResults选项卡本节包含以下子节Trained Train Found Trained Result Train Decode 成功训练某个样板之后，Train Results 选项卡会包含有关已训练样板的信息。无论使用 Typical Symbols 模式还是 Highly Degraded 模式，选项卡都包含相同的信息。此选项中上几乎所有

21、字段都是只读字段。下图所示为典型的 Train Results 选项卡选项卡的 Trained Parameters 部分显示有关已训练样板的以下信息表 9. Trained Parameters 值说TrainFound1Doczh-如果您使用 Data Matrix 符号，工具会检测当前的 ECC 如果您使用 QR Code 符号，工具会检测当前的模型类型DataMatrixRows 和 如果您使用 Data Matrix 符号，工具会检测符号中的行数和QRCodeGr如果您使用 QR Code 符号，工具会检测符号的网格大小工具会检测符号的工具会检测图像是否镜像并在选项卡中显示 Yes

22、或 No如果您使用 Data Matrix 符号，工具会检测符号是否兼容 AIM2DSymbolToolEditPage9of选项卡的此部分显示有关符号的以下信息表 10. Train Found Result 值说Trained Result 选项卡的2DSymbolToolEditPage9of选项卡的此部分显示有关符号的以下信息表 10. Train Found Result 值说Trained Result 选项卡的此部分显示有关已训练样板周围的结果网格的以下表 11. Trained Result Grid 值说Train Decode 选项卡的此区域显示有关符号中编码字符串的以下1

23、2.Train Decode Result 值说RunParamsandRegionTabRunParamsandRegion选项卡本节包含以下子节Search Advanced Run-Time Run1Doczh-此字段显示 Yes 或 No，具体取决于符号中的字符串是否能Num工具会显示训练样板期间所遇到错误数据单词的数量NumError 工具会显示训练样板期间所遇到错误位的数量工具会显示符号中编码字符串的值Selected Space 解释此样板的坐标空间。有关信息，请参阅“Coordinate Space Names”Select 选择定用于义结果网格尺寸的参数集LocationX

24、和 Locat工具会返回在所选训练图像空间中所找到符号中心的 (x, y) 坐标位置缩放值应始终接近于 1 或等于 1，如果不是则您应使用其他训练图像得分值应始终接近于 1 或等于 1，如果不是则您应使用其他训练图像2DSymbolToolEditPage10of如果您获取的图像2DSymbolToolEditPage10of如果您获取的图像包含的符号比的符号多，您可以使用此选项卡来指定整个可用图像的一部分。您还可以选择工具是否在应用程序执行期间补变形或不符合规范的模块。下图所示为默认的 Run Params / Reg on 选项卡Search 选项卡的 Search Reg on 部分提供

25、以下参数用于定义每个输入图像的特定部分表 13. Search Region 参1Doczh-参说SearchReg 定义工具如何解释您所指定的训练区域。选择以下任一选项Pixel Aligned Bounding Box 用于指定工具应处理像素配对限定框中包含的所有像素Affine Transform 仅在指定了 CogRectangleAffine 输入区域时才有效，在该输入区域中像素在应用运算符之Region 选择输入区域的形状。选择“None=Useentireimage”表示此工具使用整个输入图像。2Dymbl工具支持以下输入区域形状：所显示的区域定义参数集取决于所使用的区域形状。有

26、关使用多边形作为输入区域信息，请参“How 2DSymbolToolEditPage11ofUse Polygon Input Regions”使用以下选项来启模式或不符合2DSymbolToolEditPage11ofUse Polygon Input Regions”使用以下选项来启模式或不符合规范模块模式14. Advanced Run-Time Opt 选说Run使用以下运行参数来确定工具是否限制每个输入图像的训练参数以及工具是否使用超时值表 15. Run参说Graphics Tab (Graphics 选项卡本节包含以下子节Train使用 Graphics 选项卡指定此工具生成并显

27、示的图形。下图所示为 Graphics 选项卡1Doczh-启用此字段以使得 2Dymbl 工具在分析图像之前自动训练新样板。当您检测具有不同属性的符号时，或当应用程序执行时生产环境条件发生明显改变时，此字段十分必要。您可以设置超时值，以防止 2D Symbol 工具挂起应用程序如果您同时启用了 Timeout 选项和 Automatically Train Before Each Run 选项，应选择足够大的超时值以包含训练所需的时间。此外，如果您启用了 Train Params 选项卡上的 Tra imeout 值，则 Timeout值应大于 Tra imeout 值。定义工具如何使模式。

28、选项包括Use Pattern:如果在训练工具时已启模式，则使用此模式定义工具如何使用不符合规范模块模式。选项包括Pattern:如果在训练工具时已启用不符合规范模式，则使用此模2DSymbolToolEditPage12of您可以在 Current.TrainImage 缓冲2DSymbolToolEditPage12of您可以在 Current.TrainImage 缓冲区中启用或禁用以下图形标称网包含符号的训练网符号中心的点位您可以在 LastRun.InputImage 缓冲区中启用或禁用以下图形包含符号的结果网符号中心的点位对于 Show Input Image，确定输入图像是否为的一部分，以及此图像是否或保存作为参考您还可以启用或禁用以下图形1Doczh-2DSymbolToolEditPage13ofLastRun.InputImage 缓冲区中代表工具已分析过输入2DSymbolToolEditPage13ofLastRun.InputImage 缓冲区