安装控件
该控件工具是基于迈德威视相机 SDK 开发的，可兼容迈德威视所有型号的相机，包括 USB2.0 和 USB3.0 以及 GigE 和智能相机，安装控件前，需要先安装迈德威视标准的相机安装包(MindVision Camera PlatformSetup(x.x.x.x))，然后手动复制以下几个文件进行 VisionPro 的控件安装。（注意：该控件基于 VisionPro8.3 版本开发，其他版本的 visionpro 可能存在不兼容的问题，如需帮助请联系我司技术支持人员）：
1. MindvisionCameraTool.dll，复制到康耐视的安装路径 Cognex\VisionPro\bin 下。
2. MindvisionCameraTool.ico，复制到康耐视的安装路径 Cognex\VisionPro\bin 下。
3. MindvisionCameraTool.vtt，复制到康耐视的安装路径 Cognex\VisionPro\bin\Templates\Tools 下。
使用控件
加载工具
完成控件的安装后，打开 VisionPro QuickBuild，进入作业编辑器，如下图所示，点击工具列表按钮后，可以在弹出的列表框里看到 MindvisionCameraTool 工具了。拖动工具即可加入的规则列表中
工具功能介绍
1. 控件工具可以有 3 种方式初始化相机，具体方式，由输入型参数 InitMethod 决定，InitMethod 为 int32 类型，具体功能如下：
⚫ InitMethod 为 0 时（默认），初始化找到的第一个相机。
⚫ InitMethod 为 1 时，按照 CameraName 参数指定的名字初始化相机。
⚫ InitMethod 为 2 时，按照 CameraSn 指定的序列号初始化相机。
2. 控件工具的输出参数有 3 个，分别是 CameraHandle，OutputImageGrey8 和 OutputImageRgb24 ，3 个
参数的作用如下
⚫ CameraHandle,相机初始化后的句柄。有多个相机时，句柄各不一样。只读型变量，不要手动给它赋值，
否则会引起错误。未连接相机时，该变量为 0 ，连接成功后，该变量为大于 0 的整数。
⚫ OutputImageGrey8,为康耐视的 8 位灰度格式的图像，该工具每运行一次，成功采集的到图像后，
OutputImageGrey8 会自动更新。
⚫ OutputImageRgb24，为康耐视的 24 位彩色格式的图像，该工具每运行一次，成功采集得到图像后，OutputImageGrey8 会自动更新。
注意，如果使用迈德威视黑白相机时，请使用 OutputImageGrey8， 只有 OutputImageGrey8 会更
新图像， OutputImageRgb24 会 始终为空 ； 反之如果 时 使 用 迈德威视 彩 色 相 机 时 ， 请 使 用
OutputImageRgb24，只有 OutputImageRgb24 会更新图像，OutputImageGrey8 会始终为空。
如下图所示，请根据使用的相机，选择合适的图像输出。
3. 控件工具的输入参数解释
图 4 控件中的输入参数(AnalogGain、AutoExposure 等)，是和图 5 界面上的操作对应的，具体意义如下：
⚫ AnalogGain，int32 类型，模拟增益。对应于图 5 中的”增益”参数。调节增益可以改变相机亮度，但是增益越大，噪声会越大。增益的调节不影响帧率。
⚫ AutoExposure ，bool 类型，对应图 5 中，曝光设置下的模式，自动和手动。为 true 时，使能自动曝光模式，AnalogGain 和 ExposureTime 会根据环境亮度自动调整；为 false 时，禁止自动曝光，由用户输入的 AnalogGain 和 ExposureTime 决定相机图像亮度。默认为 false，即手动设置曝光模式。
⚫ CameraName，string 类型，指示相机名称，可读写，如果要按名称初始化指定的相机，必须事先改赋值，否则会导致初始化失败；如果不是按名称初始化相机，则该变量不需要赋值，相机初始化后，
该变量会显示相机的名称。对应图 5 中的相机列表里的相机名。
⚫ CameraSn，string 类型，指示相机序列号，可读写，如果要按序列号初始化指定的相机，必须事先改改变量赋值，否则会导致初始化失败；如果不是按序列号初始化相机，则该变量不需要赋值，相机初始化后，该变量会显示相机的序列号。在图 5 中没有体现出来。
⚫ CameraTriggerMode，int32 类型，对应图 5 中的采集模式。为 0 时，相机处于连续采集模式，无论该工具是否被执行，会在后台一直采集并更新图像；为 1 时，为软触发采图模式，只有该工具在执行一次的时候，才会去给相机发指令，重新采集一张图像；为 2 时，为硬触发采图模式
⚫ ExposureTime，double 类型，相机的曝光时间，对图 5 中的“曝光时间”，单位为微秒，支持小数。曝光时间越大，相机图像亮度越高，反之越暗。注意，曝光时间越大，如果时拍运动物体，会有严重的拖影，并且曝光时间和帧率成反比，曝光时间越长，帧率越低，采集图像需要的时间越长。
⚫ InitMethod , int32 类型，相机初始化的方式。默认为 0 。表示自动初始化扫描到的第一个相机。为 1时，按照 CameraName 指定的相机名进行初始化；为 2 时按照 CameraSn 指定的序列号进行初始化。
⚫ OutputIo0Mode，int32 类型，默认为 0，该值可以设定 6pin 航空接头上闪光灯 IO 的模式，为 0 时，设置该 IO 用作闪光灯，STR+和 STR-功能；为 1 时，设置该 IO 为 OUTPUT0 的 GPIO 模式。
⚫ OutpuIo0State，int32 类型，默认为 0。只有当 OutputIo0Mode 为 1 时，可以通过 OutpuIo0State
来设置 OUTPUT0 这个 GPIO 的输出状态。0，和 1 分别表示关闭和导通 STR+ 、STR-的功能。
采集图像
黑白相机，采集的图像会在 OutputImageGrey8 里更新，如图 6 所示:
彩色相机，采集的图像，会在 OutputImageRgb24 里更新，如图 7 所示。
参数存档说明
工具自带的输入型参数如下图所示：
⚫ 参与序工具列化保存的参数有OutIO0State 、OutIO0Mode。
⚫ 其余参数均不参与序列化保存，而是通过我们SDK自动保存在电脑上的配置文件，会自动记录上一次关闭相机时的参数。
该工具是基于我们相机 SDK 开发的，所以，相机的配置参数，是可以通过其它软件来调整，调整以后保存，再用 Visionpro 里的 mindvision 工具打开相机后，会自动加载修改过的参数，参数配置文件在迈德威视软件的安装路径下的 Camera/Configs 文件夹里，如下图所示：
可以通过桌面上的演示软件，来调整相机的各种参数，包括图像尺寸、曝光、增益、gamma、对比度等等。
同时使用 2 个相机的配置方法
如果要同时使用 2 个或者 2 个以上的相机进行工作，为了易于区分，建立固定的对应关系，我们建议使用相机的自定义名称或者序列号来进行绑定操作。
使用自定义相机名称来绑定和初始化相机
首先，使用我们自带的演示软件，修改相机名字。按以下流程进行：
1. 打开演示软件，可以扫描到多个相机。
2. 分别打开每个相机，在弹出的界面中，对着图像区域点鼠标右键，选择 相机配置，如图 11 所示：
3. 在设备信息栏目下，修改相机自定义名称。
4. 修改后，相机需要重新上电后新的自定义名称才能生效。自定义名称是写入相机内部的，设置成功后，该相机无论接到哪个电脑上，名字都会是设定好的自定义名称。
5. 关闭我们的演示软件，打开 visionpro 的 QuickBuild，然后进行如下设置：
6. 在 CogToolBlock1 中新增 2 个 int32 类型的参数，起名为 InitMethod1 和 InitMethod2，都赋值为 1，表示按名称进行初始化，再新增 2 个 string 参数，起名为 Name1 和 Name2,分别赋值为 Camera1 和 Camera2(请将 Camera1 和 Camera2 替换为您自己设定的相机名)。然后分别进行数据连接操作，如图 14 所示：
7. 经过以上步骤，就成功的建立了相机的唯一对应关系，不受相机上电顺序以及端口的影响而改变。两个相机可同时工作，界面如下图所示：
使用序列号来绑定和初始化相机
相机的序列号是唯一的，并且是不可以修改的，可以通过我们提供的工具事先读出来，再进行绑定操作。
1. 使用下图中的工具，得到相机的序列号。
2. 关闭我们的演示软件，打开 visionpro 的 QuickBuild，然后图 13 中一样的设置。
3. 在 CogToolBlock1 中新增 2 个 int32 类型的参数，起名为 InitMethod1 和 InitMethod2，都赋值为 2，表示按名称进行初始化，再新增 2 个 string 参数，起名为 Sn1 和 Sn2,分别赋值为 xxxxx 和 yyyyy(请将 xxxxx 和yyyyy 替换为您使用的 2 个相机的实际的序列号)。然后分别进行数据连接操作，如图 17 所示，至此就完成了按序列号初始化指定相机的操作。
问题与反馈
目前，该工具只加入了部分相机参数，并没有把所有可调节的参数映射到工具的输入参数上，其它参数的调节，需要通过我们的演示软件进行，调节后再保存。如果需要新增某参数到该工具里直接调节，可以联系我们的技术支持进行修改。
