# 迁移到本版本

本主题包含关于将现有 Cognex ViDi Suite 项目从先前版本迁移到当前版本时所产生的更改的信息，这些更改可能影响现有项目。

### C 库叠加函数弃用

Cognex ViDi Suite 提供两种机制，即 C API 和 .NET API，用于显示结果图形。但是，此版本弃用以下 C 库叠加图形函数，并将在以下版本中删除：

- vidi_training_tool_get_overlay ();
- vidi_runtime_sample_get_overlay ();
- vidi_runtime_get_overlay ();
- vidi_training_sample_get_overlay();

要在将来访问叠加图形，您需要使用 Cognex Cognex Designer、.NET API 或 In-SightCognex ViDi Suite。

### 工具训练工作流程的变更

在 3.4.0 版本中，有一种新方法可用于指定将用于训练工具的图像/视图。如果要重新训练在先前版本中训练过的工具，则需要通过“精选训练集”对话框配置工具，以使用新的训练集范例。请参阅“训练集”和“使用精选训练集对话框”主题。

## 过往版本 - Cognex ViDi Suite 3.2 至 3.3

- 不支持导入使用 2.1 及更早版本创建的工作区存档。如果您要从 Cognex ViDi Suite 套件版本 2.1 或更早版本迁移，您必须首先使用版本 3.0、3.1、3.2 或 3.2.1 导入工作区然后导出，然后才能将它们导入 Cognex ViDi Suite 3.3.0。

- Cognex ViDi Suite 3.3.0 要求使用 411.31 及以上的 NVIDIA 驱动程序版本。

  要获取更新的 NVIDIA 驱动程序，请访问：https://www.nvidia.com/download/find.aspx

  有关 Cognex ViDi Suite 驱动兼容性的更多信息，请访问：https://support.cognex.com/en/downloads/detail/deep-learning/3763/1033

- Cognex ViDi Suite 3.3.0 中的客户端/服务器功能已更新为使用 HTTP 通信协议，不再支持 TCP 协议。要在客户端/服务器应用程序中使用新的 HTTP 协议，必须将客户端和服务器都升级到 Cognex ViDi Suite 3.3.0。软件没有跨版本客户端/服务器兼容性（例如运行 3.2.1 的客户端只能连接到运行 3.2.1 的服务器，运行 3.3.0 的客户端只能连接到运行 3.3.0 的服务器。

  Note: HTTP 通信通常为运行时图像处理提供更好的吞吐量。但是，对于高延迟网络拓扑，HTTP 通信可能会增加训练和开发过程中的接口延迟。

## 过往版本 - Cognex ViDi Suite 3.1 至 3.2

### C 库函数弃用

一系列 C 库函数被弃用，如下所示：

- 运行时函数

  Note: 弃用的函数位于新的 vidi_runtime_legacy.h 标题文件。

  先前版本 | 新版本
  --- | ---
  vidi_runtime_get_overlay | 不可用
  vidi_runtime_process_sample | vidi_runtime_sample_process
  vidi_runtime_get_image | vidi_runtime_sample_get_image

- 训练函数

  Note: 弃用的函数位于新的 vidi_training_legacy.h 标题文件。

  先前版本 | 新版本
  --- | ---
  vidi_training_stream_process_sample | vidi_training_sample_process
  vidi_training_blue_add_feature | vidi_training_blue_set_feature
  vidi_training_blue_add_model | vidi_training_blue_create_model
  vidi_training_tool_set_mask | vidi_training_roi_set_mask
  vidi_training_tool_get_mask | vidi_training_roi_get_mask
  vidi_training_ini_sample | vidi_training_add_sample
  vidi_training_process_sample | vidi_training_sample_process

### NuGet 包弃用

NuGet 包已被弃用，并且不再包含在 Cognex ViDi Suite 安装程序中。如果您有从早期 Cognex ViDi Suite 版本引用 NuGet 包的运行时和/或训练应用程序，您需要删除这些引用，并将其替换为对 .NET .dll 库的引用。

要在 Visual Studio 中删除 NuGet 包，请选择工具 -> NuGet 包管理器 -> 管理解决方案的 NuGet 包...

要在项目中添加 .NET .dll，请右键单击并选择添加 -> 参考。

## 过往版本 - Cognex ViDi Suite 3.0 到 3.1

- 对于蓝色定位工具，使用模型匹配时，X 和 Y 位置夹紧的行为发生了变化。在版本 2.1 中，这些约束条件被解析，以应用于模型坐标原点的位置。在 3.0 版中，它们被解释为对模型中节点的质心位置的约束。