Mindvision工业相机
VisionPro专用控件使用说明
目录
安装控件 (2)
使用控件 (2)
加载工具 (2)
工具功能介绍 (4)
采集图像 (7)
参数存档说明 (8)
同时使用2个相机的配置方法 (9)
使用自定义相机名称来绑定和初始化相机 (9)
使用序列号来绑定和初始化相机 (14)
问题与反馈 (16)
安装控件
该控件工具是基于迈德威视相机SDK开发的，可兼容迈德威视所有型号的相机，包括USB2.0和USB3.0以及GigE和智能相机，安装控件前，需要先安装迈德威视标准的相机安装包(MindVision Camera Platform Setup(2.1.9.43))，然后手动复制以下几个文件进行VisionPro的控件安装，专用的控件文件用的DLL文件分为32位和64位两个版本，分别位于X64和X86两个文件夹里，用户根据自己安装的visionpro版本来选择复制（注意：该控件基于VisionPro8.2版本开发，更高版本的visionpro可能存在不兼容的问题，如需帮助请联系我司技术支持人员）：
1.MindvisionCameraTool.dll，复制到康耐视的安装路径Cognex\VisionPro\bin 下。
2.MVSDK.dll，复制到康耐视的安装路径Cognex\VisionPro\bin 下
3.MindvisionCameraTool.ico，复制到康耐视的安装路径Cognex\VisionPro\bin 下。
4.MindvisionCameraTool.vtt，复制到康耐视的安装路径Cognex\VisionPro\bin\Templates\Tools下。
使用控件
加载工具
完成控件的安装后，打开VisionPro QuickBuild，进入作业编辑器，如下图所示，点击工具列表按钮后，可以在弹出的列表框里看到MindvisionCameraTool工具了。拖动工具即可加入的规则列表种
图1
图2
工具功能介绍
图3 工具默认的输入和输出参数
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会始终为空。如下图所示，请根据使用的相机，选择合适的图像输出。
图4 选择要预览的图像
3.控件工具的输入参数解释
图4控件中的输入参数(AnalogGain、AutoExposure等)，是和图5界面上的操作对应的，具体意义如下：
图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所示:
图6 黑白相机采集图像
彩色相机，采集的图像，会在OutputImageRgb24里更新，如图7所示。
图7彩色相机采集图像
参数存档说明
工具自带的输入型参数如下图所示：
图9 工具自带的参数
●参与序工具列化保存的参数有OutIO0State、OutIO0Mode。
●其余参数均不参与序列化保存，而是通过我们SDK自动保存在电脑上的配置文件，会自动记录上一次关闭相机时的参
数。
该工具是基于我们相机SDK开发的，所以，相机的配置参数，是可以通过其它软件来调整，调整以后保存，再用Visionpro里的mindvision工具打开相机后，会自动加载修改过的参数，参数配置文件在迈德威势软件的安装路径下的Camera/Configs文件夹里，如下图所示：
图8 相机参数存档文件
可以通过桌面上的演示软件，来调整相机的各种参数，包括图像尺寸、曝光、增益、gamma、对比度等等。
图9 迈德威势演示程序
同时使用2个相机的配置方法
如果要同时使用2个或者2个以上的相机进行工作，为了易于区分，建立固定的对应关系，我们建议使用相机的自定义名称或者序列号来进行绑定操作。
使用自定义相机名称来绑定和初始化相机
首先，使用我们自带的演示软件，修改相机名字。按以下流程进行：
1.打开演示软件，可以扫描到多个相机。
图10 扫描到多个相机
2.分别打开每个相机，在弹出的界面中，对着图像区域点鼠标右键，选择相机配置，如图11所示：
图11 打开相机设置窗口
3.在设备信息栏目下，修改相机自定义名称。
图12 自定义相机名称
4.修改后，相机需要重新上电后新的自定义名称才能生效。自定义名称是写入相机内部的，设置成功后，该相机
无论接到哪个电脑上，名字都会是设定好的自定义名称。
5.关闭我们的演示软件，打开visionpro的QuickBuild，然后进行如下设置：
图13 从工具栏里拖出1个CogToolBlock和2个迈德威势相机采集工具
6.在CogT oolBlock1中新增2个int32类型的参数，起名为InitMethod1和InitMethod2，都赋值为1，表示
按名称进行初始化，再新增2个string参数，起名为Name1和Name2,分别赋值为Camera1和Camera2(请将Camera1和Camera2替换为您自己设定的相机名)。然后分别进行数据连接操作，如图14所示：
图14 按名称初始化指定的相机配置方法
7.经过以上步骤，就成功的建立了相机的唯一对应关系，不受相机上电顺序以及端口的影响而改变。两个相机可
同时工作，界面如下图所示：
图15 2个相机同时工作
使用序列号来绑定和初始化相机
相机的序列号是唯一的，并且是不可以修改的，可以通过我们提供的工具事先读出来，再进行绑定操作。
1.使用下图中的工具，得到相机的序列号。
图16 读取相机序列号
2.关闭我们的演示软件，打开visionpro的QuickBuild，然后图13中一样的设置。
3.在CogT oolBlock1中新增2个int32类型的参数，起名为InitMethod1和InitMethod2，都赋值为2，表示
按名称进行初始化，再新增2个string参数，起名为Sn1和Sn2,分别赋值为xxxxx和yyyyy(请将xxxxx和yyyyy替换为您使用的2个相机的实际的序列号)。然后分别进行数据连接操作，如图17所示，至此就完成了按序列号初始化指定相机的操作。
图17 指定序列号来初始化相机
问题与反馈
目前，该工具只加入了部分相机参数，并没有把所有可调节的参数映射到工具的输入参数上，其它参数的调节，需要通过我们的演示软件进行，调节后再保存。如果需要新增某参数到该工具里直接调节，可以联系我们的技术支持进行修改。
邮箱：support@https://www.doczj.com/doc/677598873.html,
电话：0755-********
也可以通过和您对接的销售人员进行问题反馈。