# GPU 模式命令行初始化

有几个命令行参数可以在启动时与 Cognex ViDi Suite GUI 一起用于库初始化。这些命令使用 Windows 命令提示符发出，并导航到 %ProgramFiles%\Cognex\ViDi Suite\3.3 目录。首先指定应用程序名称 ("ViDi Suite GUI"；如果使用 ViDi 客户端/服务器功能，则是 "ViDi Suite Service.exe"），然后是命令行变量。

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

命令 | 说明
--- | ---
--gpu-mode=NoSupport 或 SingleDevicePerTool 或 MultipleDevicesPerTool | 指定应用程序要使用的 GPU 模式。
SingleDevicePerTool | 将有一个 GPU 用于分析工具。使用多个 GPU 时，单个图像的处理时间保持不变，但可以在不同设备上同时处理多个图像。
MultipleDevicesPerTool | 对于使用红色分析工具，此模式可能会提升速度（就单图像处理延迟而言）。在多个 GPU 之间分配图像分析。 Note: 如果您将使用此模式，请考虑以下事项： 对于多个 GPU，所有 GPU 的以下内容应相同： GPU 型号 GPU 内存 GPU 驱动模式 如果工作区包含红色分析工具以外的工具，则其性能可能会受到影响，进而降低。 使用较小的图像和较大的特征尺寸时，红色分析工具的 MultipleDevicesPerTool 模式可能较慢。
NoSupport | 指定不使用 GPU。 Note: 此选项与 --gpu-devices 和/或 --optimized-gpu-memory 冲突。
Note: 有关 GPU 模式的更多信息，请参阅多线程主题
--gpu-devices=GPU 的逗号分隔索引列表 | 通过索引列表指定将在初始化时使用的 GPU。例如：--gpu-devices=0,1
--optimized-gpu-memory=内存大小，单位 MB | 指定预分配的优化内存缓冲区的大小。默认激活此设置，默认大小为 GPU 内存的三分之二。要停用该功能，首先发出 --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，将分配默认的内存量。