In-Sight® SDK 5.7.3 发行说明

Revision: 5.7.3.5, 06/18/2019

概述

本文档介绍用于 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。
以下推荐的硬件配置是指对于将要与最多四个 In-Sight 视觉系统连接的 PC 的要求。

最低配置	推荐配置
以 1.8GHz 运行的 Intel^® Celeron^® 1000M 处理器（或同级处理器）	以 2.7 GHz 运行的 Intel Core™ i7 处理器（或同级处理器）
2GB 可用 RAM	4GB 可用 RAM
4GB 可用硬盘空间	8GB 可用硬盘空间
具有 24 位色彩深度、分辨率至少为 1024x768 的视频卡（DPI 显示设置必须设为 96 DPI）	具有 32 位色彩深度、分辨率至少为 1920 x 1080 的视频卡（DPI 显示设置必须设为 96 DPI）
用于与 In-Sight 视觉系统连接的网络接口卡（至少 100Mbps）	用于与 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.7.3 软件包含 2 个固件版本：

In-Sight 5.7.3
In-Sight 4.10.5 PR1

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

In-Sight Firmware 5.7.3

In-Sight 5705 和 5705C 视觉系统
In-Sight 7000 Gen2 系列视觉系统
In-Sight 8000 系列视觉系统
In-Sight 9000 系列视觉系统
In-Sight Advantage Engine

In-Sight Firmware 4.10.5 PR1

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。

注意：如果在安装 Windows 更新时禁用了 Microsoft .NET Framework 3.5 的系统上尝试安装 In-Sight SDK，则可能会收到以下错误消息：安装 Microsoft .NET Framework 时出错; 错误代码 0x800f081f。如果发生这种情况，请等待 Windows 更新完成，必要时重新启动，然后再安装 In-Sight SDK。

支持的开发环境

Microsoft Visual Studio 2013
Microsoft Visual Studio 2015

注意：

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. 开始菜单中列有可以打开此地址的快捷方式。

已知问题

说明：发行说明中附加了问题编号（如果适用），以便更好地跟踪通过 Cognex 技术支持部门报告的已知问题。有关 Cognex In-Sight Display (CvsInSightDisplay) 控件已知问题的信息，请参阅“In-Sight Display Control 发行说明”。

问题#	问题
82151	In-Sight SDK 无法使用 CvsInSightDisplay.InSight.File.LoadJobFileLocally（）函数将作业从本地 PC 加载到视觉系统。解决方法：要将作业从本地 PC 加载到视觉系统，请按照下列步骤操作：使用 CvsInSightDisplay.InSight.File.SendFileToInSight（）将作业从 PC 发送到视觉系统。使用 CvsInSightDisplay.InSight.File.LoadJobFile（）从视觉系统加载作业。
31753	需要更新的 In-Sight SDK 控件（例如 CvsInSightDisplay）仅在它们可视的情况下才会要求更新。在它们隐藏或最小化时则不会发出更新请求。解决方法：如果在这种情况下需要更新，当新的结果需要从 In-Sight 视觉系统中获取时，需要添加调用 CvsInSight.AcceptUpdate() 以及/或 CvsInSightDisplay.AcceptUpdate()。建议将一个处理程式添加到 CvsInSight.ResultsChanged 事件，并且一旦结果处理完成，应该调用 CvsInSight.AcceptUpdate。
11930	在调用 SetExpression 之前，请先确保视觉系统处于脱机状态。

问题#

问题

82151

In-Sight SDK 无法使用 CvsInSightDisplay.InSight.File.LoadJobFileLocally（）函数将作业从本地 PC 加载到视觉系统。

解决方法：要将作业从本地 PC 加载到视觉系统，请按照下列步骤操作：

使用 CvsInSightDisplay.InSight.File.SendFileToInSight（）将作业从 PC 发送到视觉系统。
使用 CvsInSightDisplay.InSight.File.LoadJobFile（）从视觉系统加载作业。

31753

需要更新的 In-Sight SDK 控件（例如 CvsInSightDisplay）仅在它们可视的情况下才会要求更新。在它们隐藏或最小化时则不会发出更新请求。

解决方法：如果在这种情况下需要更新，当新的结果需要从 In-Sight 视觉系统中获取时，需要添加调用 CvsInSight.AcceptUpdate() 以及/或 CvsInSightDisplay.AcceptUpdate()。建议将一个处理程式添加到 CvsInSight.ResultsChanged 事件，并且一旦结果处理完成，应该调用 CvsInSight.AcceptUpdate。

11930

在调用 SetExpression 之前，请先确保视觉系统处于脱机状态。