Mindvision工业相机VisionPro专用控件使用说明

Mindvision工业相机VisionPro专用控件使用说明目录安装控件...................................................................................................................................................................................2使用控件...................................................................................................................................................................................2加载工具...........................................................................................................................................................................2工具功能介绍...................................................................................................................................................................4采集图像...........................................................................................................................................................................7参数存档说明...................................................................................................................................................................8同时使用2个相机的配置方法.......................................................................................................................................9使用自定义相机名称来绑定和初始化相机...........................................................................................................9使用序列号来绑定和初始化相机.........................................................................................................................14问题与反馈.............................................................................................................................................................................16安装控件该控件工具是基于迈德威视相机SDK开发的，可兼容迈德威视所有型号的相机，包括USB2.0和USB3.0以及GigE和智能相机，安装控件前，需要先安装迈德威视标准的相机安装包(MindVisionCameraPlatformSetup(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下。使用控件加载工具完成控件的安装后，打开VisionProQuickBuild，进入作业编辑器，如下图所示，点击工具列表按钮后，可以在弹出的列表框里看到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的Qu