开发人员

本节中的主题将帮助开发人员集成软件。VisionPro Deep Learning 软件基于以下架构：

 

C 或 .NET 集成

VisionPro Deep Learning 提供了一个 C 库，可以在安装目录 (C:\Program Files\Cognex\VisionPro Deep Learning\3.0\bin) 中找到它，名称为 vidi_51.dll。关联的头文件位于以下目录：

  • C:\Program Files\Cognex\VisionPro Deep Learning\3.0\Develop\include

 

为了方便和更容易集成，VisionPro Deep Learning 还分发了一个 .NET 库，以面向对象的方式归纳了所有 C 库方法。.NET 库作为 NuGet 包分发，位于以下目录：

  • C:\ProgramData\Cognex\VisionPro Deep Learning\3.0 \Examples\packages

 

API 参考指南位于以下目录：

  • C:\Program Files\Cognex\VisionPro Deep Learning\3.0\Develop\docs

 

此外，还有几个示例可在以下目录中查看：

  • C:\ProgramData\Cognex\VisionPro Deep Learning\3.0\Examples
Note:
  • 在上述目录路径和文件名中，2.0 指的是 VisionPro Deep Learning 软件的版本。
  • Cognex 强烈建议您集成 .NET 库，除非您必须集成 C 库。

 

.NET 库和

.NET 库也可用于 VisionPro Deep Learning。还包含对算法以及可以通过项目使用 VisionPro Deep Learning 在图像上交互和操作的其他结构的存取权。还有 UI 组件库可用，用于与结果和图像交互并显示结果和图像。

 

.NET 库位于：

  • C:\Program Files\Cognex\VisionPro Deep Learning\3.0\Cognex Deep Learning Studio

库 说明
ViDi.NET.Interfaces.dll 包含接口的程序集。
ViDi.NET.Base.dll 包含常见类型的程序集。
ViDi.NET.dll 包含接口实现的程序集。
ViDi.NET.Local.dll 直接访问本地 C 库。
ViDi.NET.Remote.dll 包含服务器/客户端之间的通信实现的程序集。
ViDi.NET.UI.Interfaces.dll WPF 组件的接口。
ViDi.NET.UI.dll WPF 组件。

 

 

命令行

本章节主题涵盖了各种命令行参数，可在调用 VisionPro Deep Learning 应用程序时为其提供。

您将向其发出命令的服务应用程序的名称为 Cognex Deep Learning Studio.exe（IDE 应用程序）或 VisionPro Deep Learning Service.exe（如果使用 Deep Learning 客户端/服务器功能）。

以下路径是上述应用程序的位置：

  • C:\Program Files\Cognex\VisionPro Deep Learning\3.0\Cognex Deep Learning Studio\Cognex Deep Learning Studio.exe
  • C:\Program Files\Cognex\VisionPro Deep Learning\3.0\Service\VisionPro Deep Learning Service.exe

 

您可以首先指定应用程序的名称，然后是命令行参数，从而发出命令。例如，如果要更改默认的训练工作区路径，请打开 Windows 命令提示符并将目录更改为程序文件目录后，发出以下命令：

C:\Program Files\Cognex\VisonPro Deep Learning\3.0\Service>"VisionPro Deep Learning Service.exe" --training-workspace-path=c:\users\username\workspace_store

 

向 Deep Learning GUI 发出命令时，在初始化命令后，将出现 GUI 启动器屏幕，您将不会收到该命令的确认。

 

初始化工作区和应用程序命令行

有几个命令行参数可以在启动时与 VisionPro Deep LearningGUI 一起用于工作区和应用程序初始化。

这些命令是使用 Windows 命令提示符发出的，并导航到 Cognex Deep Learning Studio.exe（IDE 应用程序）的此目录：

  • C:\Program Files\Cognex\VisionPro Deep Learning\3.0\Cognex Deep Learning Studio

 

导航到 VisionPro Deep Learning Service.exe 的此目录（如果使用深度学习客户端/服务器功能）：

  • C:\Program Files\Cognex\VisionPro Deep Learning\3.0\Service。

     

您可以首先指定应用程序的名称，然后是命令行参数，从而发出命令。

 

可以发出以下命令行参数来定义工作区的路径，以及其他与应用相关的命令：

命令 说明

--workspace-path=文件路径

指定将保存工作区的目录位置。

--auto-save-interval=持续时间（分钟）

指定工作区自动保存之间的时间量。默认值为 5 分钟。设置为“-1”则从不自动保存。

Note: 自动保存功能不适用于运行时工作区。因此，如果设置--auto-save-internal 命令后激活 --runtime-only 命令，则将忽略自动保存功能。

--activate-debug-logs=[0 或 1]

激活日志记录以进行调试。

--help

用于返回命令行选项列表。

--version

请求版本信息。

 

GPU 模式命令行初始化

有几个命令行参数可以在启动时与 VisionPro Deep Learning GUI 一起用于库初始化。

这些命令是使用 Windows 命令提示符发出的，并导航到 Cognex Deep Learning Studio.exe（IDE 应用程序）的此目录：

  • C:\Program Files\Cognex\VisionPro Deep Learning\3.0\Cognex Deep Learning Studio

 

导航到 VisionPro Deep Learning Service.exe 的此目录（如果使用深度学习客户端/服务器功能）：

  • C:\Program Files\Cognex\VisionPro Deep Learning\3.0\Service。

     

您可以首先指定应用程序的名称，然后是命令行参数，从而发出命令。

 

以下命令行参数可用于控制 GPU 模式、使用哪个 GPU 设备以及 GPU 内存的分配：

命令 说明

--gpu-mode=NoSupport 或 SingleDevicePerTool

指定应用程序要使用的 GPU 模式。

SingleDevicePerTool

使用单个 GPU 训练和处理图像。

NoSupport

指定不使用 GPU。

Note: 此选项与 --gpu-devices 和/或 --optimized-gpu-memory 冲突。
Note: 有关 GPU 模式的更多信息，请参阅配置多个 GPU。 

--gpu-devices=GPU 的逗号分隔索引列表

通过索引列表指定将在初始化时使用的 GPU。例如：--gpu-devices=0,1

--optimized-gpu-memory=内存大小，单位 MB

指定预分配的优化内存缓冲区的大小。在默认情况下此设置处于激活状态，默认大小为 2 GB。要停用该功能，首先发出 --optimized-gpu-memory-override=1 命令，然后发出 --optimized-gpu-memory=0 命令。要使用非默认设置的内存缓冲区大小，首先发出 --optimized-gpu-memory-override = 1 命令，然后发出 --optimized-gpu-memory=<内存大小，MB> 命令。

Note: 默认启用 GPU 内存优化设置。有关该功能的更多信息，请参阅 GPU 内存优化。

--optimized-gpu-memory-override=[0 或 1]

如果使用 --optimized-gpu-memory 设置，则设置为 1。如果设置为 0，将分配默认的内存量。