In-Sight® SDK 5.6.0 发行说明
© 版权所有 1999-2018 Cognex Corporation. 保留所有权利。
Revision: 5.6.0.6, 05/25/2018
概述
本文档介绍用于 Microsoft® Windows® 的 In-Sight 软件开发包 (SDK)，包括下列主题：
有关 CvsInSightDisplay 控件的特定信息，另请参阅“In-Sight Display Control 发行说明”。
关于 In-Sight SDK
In-Sight SDK 提供了一个用于开发与联网的 In-Sight 视觉系统交互的自定义应用程序的平台。使用 In-Sight SDK 可开发复杂程度各异的程序，从停驻在窗体上的简单 In-Sight Display Control，到功能强大的加载作业、保存图像和通过多个 I/O 通道通讯的应用程序。
如需下载最新版本的发行说明和文档、以及文档的不同语言版本，请访问 In-Sight 在线帮助中心。
注意：In-Sight SDK 不支持 In-Sight Micro 1020、In-Sight 2000 系列以及 In-Sight 7020、7010、7230 和 7432 视觉系统。
系统要求
PC 硬件要求
最低配置
注意：最低硬件要求适用于连接到以低速运行的单个低分辨率 In-Sight 视觉系统的 PC。
- 以 1.8GHz 运行的 Intel® Celeron® 1000M 处理器（或同级处理器）
- 2GB 可用 RAM
- 4GB 可用硬盘空间
- 具有 24 位色彩深度、分辨率至少为 1024x768 的视频卡（DPI 显示设置必须设为 96 DPI）
- 用于与 In-Sight 视觉系统连接的网络接口卡（至少 100Mbps）
推荐配置
注意：推荐硬件配置是指对于将要与最多四个 In-Sight 视觉系统连接的 PC 的要求。
- 以 2.7 GHz 运行的 Intel Core™ i7 处理器（或同级处理器）
- 4GB 可用 RAM
- 8GB 可用硬盘空间
- 具有 32 位色彩深度、分辨率至少为 1920 x 1080 的视频卡（DPI 显示设置必须设为 96 DPI）。
- 用于与 In-Sight 视觉系统连接的千兆位网络接口卡
操作系统要求
In-Sight 软件已在以下操作系统上进行过测试：
- Microsoft® Windows® 10 Professional （64 位）
- Microsoft Windows 7 Professional, Service Pack 1 （64 位）
- Microsoft Windows Server 2016
虽然 In-Sight SDK 可以在其它操作系统上工作，但不满足上述要求的系统可能不受支持。
支持的语言
- 英语
- 日语
- 法语
- 德语
- 西班牙语（欧洲）
- 韩语
- 中文（简体）
支持的 In-Sight 视觉系统/传感器
支持的固件版本
In-Sight 5.6.0 软件包含 3 个固件版本：
- In-Sight 5.6.0
- In-Sight 5.2.2
- In-Sight 4.10.5
含有较早固件版本的 In-Sight 视觉系统可能会正常运作，但较早的固件版本可能不支持某些新的功能且未经过全面测试。为获得最佳效果，使用旧固件版本的视觉系统应更新到受支持的最新固件版本。
注意：有关支持的视觉系统型号和固件版本，请参阅 In-Sight® 浏览器帮助文档中的固件版本主题。
In-Sight 固件版本 5.6.0
- In-Sight 2000 系列视觉传感器
- In-Sight 5705 和 5705C 视觉系统
- In-Sight 7000 Gen2 系列视觉系统
- In-Sight 8000 系列视觉系统
In-Sight 固件版本 5.2.2
- In-Sight Advantage Engine
In-Sight 固件版本 4.10.5
- In-Sight Micro 1000 系列视觉系统
- In-Sight 5000 系列视觉系统（除了 In-Sight 5705 和 5705C 视觉系统）
- In-Sight 7000 系列视觉系统（除了 In-Sight 7000 Gen2 系列视觉系统）
注意：
- In-Sight SDK 不支持 In-Sight Micro 1020、In-Sight 2000 系列以及 In-Sight 7020、7010、7230 和 7432 视觉系统。
- 当与运行 In-Sight 5.1.0 或更新版本的 In-Sight 视觉系统通信时，用户需要发送信息到视觉系统以获取最新的图像和结果。如果使用了 CvsInSightDisplay， 则该过程会被自动处理。否则，用户在准备好接收新的结果时，需要调用 CvsInSight.AcceptUpdate() 或 CvsInSightDisplay.AcceptUpdate()。
- 与运行 In-Sight 4.x.x 固件版本的 In-Sight 视觉系统通信没有变化。不需要调用 CvsInSight.AcceptUpdate()，且调用该指令对接收图片和结果没有任何作用。
Microsoft .NET Framework 4.5
In-Sight 软件需要运行 Microsoft .NET Framework 4.5。如果 In-Sight 软件安装程序没有检测到 Microsoft .NET Framework 4.5，安装程序会先下载并安装 Microsoft .NET Framework 4.5。
支持的开发环境
- Microsoft Visual Studio 2013
- Microsoft Visual Studio 2012
注意
- Microsoft Visual Basic 6.0、Rockwell Automation FactoryTalk® View Site Edition (SE) 以及兼容的 ActiveX 主机应用都支持 ActiveX 控件。
- 如需创建 ToolBuilder EasyBuilder 工具，必须使用 GUID 生成工具 (guidgen.exe)。该工具包含在 Microsoft Visual Studio 中。有关 guidgen.exe 的详情，请参阅 MSDN。
ToolBuilder 支持
In-Sight SDK 支持创建自定义 EasyBuilder 工具（有关详细信息，请参阅 ToolBuilder 程序员参考指南。） 所有 ToolBuilder 创建的 EasyBuilder 工具必须被保存到以下可供 In-Sight 浏览器使用的目录：C:\Program Files (x86)\Cognex\In-Sight\In-Sight Explorer 5.x.x\AddIns。在使用 ToolBuilder 创建的 EasyBuilder 工具时，工具的 DLL 必须被放置在 In-Sight 浏览器 5.x.x\AddIns 目录。将之前所创建的所有 ToolBuilder DLL 文件复制并粘贴到 AddIns 目录。
安装
要安装 In-Sight SDK，必须以拥有完全管理权限的用户身份登录。
注意：使用不同版本的 In-Sight Display Control 或 In-Sight SDK 开发的 COM/ActiveX 应用程序与此版本不兼容，将无法正常工作。需要针对此版本重新编译自定义应用程序，或者必须重新安装原始版本。(CR# 5084)
示例项目
In-Sight SDK 示例项目安装在下列文件夹中：
- C:\Users\Public\Documents\Cognex\In-Sight\In-Sight Sample Projects 5.x.x
“开始”菜单中列有可以打开此地址的快捷方式。
已知问题
注意：发行说明中附加了请求更改号码 (CR#)，以改进对通过 Cognex 技术支持中心报告的已知问题的跟踪。有关 Cognex In-Sight Display (CvsInSightDisplay) 控件已知问题的信息，请参阅“In-Sight Display Control 发行说明”。
| 31753 |
需要更新的 In-Sight SDK 控件（例如 CvsInSightDisplay）仅在它们可视的情况下才会要求更新。在它们隐藏或最小化时则不会发出更新请求。
解决方法：如果在这种情况下需要更新，当新的结果需要从 In-Sight 视觉系统中获取时，需要添加调用 CvsInSight.AcceptUpdate() 以及/或 CvsInSightDisplay.AcceptUpdate()。建议将一个处理程式添加到 CvsInSight.ResultsChanged 事件，并且一旦结果处理完成，应该调用 CvsInSight.AcceptUpdate。
|
| 15264 |
在 64 位操作系统上构建 In-Sight SDK 应用程序时，必须将“平台目标”设为 x86。如果将“平台目标”设为“任何 CPU”或 x64，应用程序可能由于出现 FileNotFoundException 或 BadImageFormatException 而运行失败。
解决方法：为在 Visual Studio 中的 x86 目标平台上运行而配置应用程序：
- 在“解决方案浏览器”中右键单击项目并选择属性。
- 选择构建选项卡。
- 将平台目标下拉菜单切换至 x86。
注意：有关在不同项目类型中解决此问题的具体操作，请参阅 In-Sight SDK 参考帮助文件。
|
| 11930 |
在调用 SetExpression 之前，请先确保视觉系统处于脱机状态。 |