In-Sight® SDK 5.6.1 发行说明

Revision: 5.6.1.4, 09/14/2018

概述

本文档介绍用于 Microsoft^® Windows^® 的 In-Sight 软件开发包 (SDK)，包括下列主题：

关于 In-Sight SDK
系统要求
安装
示例项目
API 更改
已知问题

有关 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 视觉系统。

系统要求

该部分介绍了 In-Sight SDK 的系统要求。

PC 硬件最低要求

最低硬件要求适用于连接到以低速运行的单个低分辨率 In-Sight 视觉系统的 PC：

以 1.8GHz 运行的 Intel^® Celeron^® 1000M 处理器（或同级处理器）
2GB 可用 RAM
4GB 可用硬盘空间
具有 24 位色彩深度、分辨率至少为 1024x768 的视频卡（DPI 显示设置必须设为 96 DPI）
用于与 In-Sight 视觉系统连接的网络接口卡（至少 100Mbps）

PC 硬件要求

以下的推荐硬件配置是指对于将要与最多四个 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 5.6.1 软件包含 3 个固件版本：

In-Sight 5.6.1
In-Sight 5.2.2
In-Sight 4.10.5

含有较旧固件版本的视觉系统可能正常工作。但是, 某些功能将不受旧固件版本的支持, 且未经过完全测试。为获得最佳运行效果，请将运行较旧固件版本的视觉系统更新到受支持的最新固件版本。有关支持的视觉系统型号和固件版本，请参阅 In-Sight^® 浏览器帮助文档中的固件版本主题。

In-Sight 固件版本 5.6.1

In-Sight 2000 系列视觉传感器
In-Sight 5705 和 5705C 视觉系统
In-Sight 7000 Gen2 系列视觉系统
In-Sight 8000 系列视觉系统
In-Sight 9902L 线扫描视觉系统

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 发行说明”。

CR#	问题
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 之前，请先确保视觉系统处于脱机状态。

CR#

问题

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 之前，请先确保视觉系统处于脱机状态。