mindvision工业相机visionpro专用控件使用说明资料

《mindvision工业相机visionpro专用控件使用说明资料》由会员分享，可在线阅读，更多相关《mindvision工业相机visionpro专用控件使用说明资料（17页珍藏版）》请在金锄头文库上搜索。

1、 Mindvision 工业相机 VisionPro 专用控件使用说明 目录 安装控件 . 2 使用控件 . 2 加载工具 . 2 工具功能介绍 . 4 采集图像 . 7 参数存档说明 . 8 同时使用 2 个相机的配置方法 . 9 使用自定义相机名称来绑定和初始化相机 . 9 使用序列号来绑定和初始化相机 . 14 问题与反馈 . 16 安装控件 该控件工具是基于迈德威视相机 SDK 开发的，可兼容迈德威视所有型号的相机，包括 USB2.0 和 USB3.0 以 及 GigE 和智能相机，安装控件前，需要先安装迈德威视标准的相机安装包(MindVision Camera Platform S

2、etup(2.1.9.43)，然后手动复制以下几个文件进行 VisionPro 的控件安装，专用的控件文件用的 DLL 文件分为 32 位和 64 位两个版本，分别位于 X64 和 X86 两个文件夹里，用户根据自己安装的 visionpro 版本来选择复制（注 意：该控件基于 VisionPro8.2 版本开发，更高版本的 visionpro 可能存在不兼容的问题，如需帮助请联系我司技术 支持人员） ： 1. MindvisionCameraTool.dll，复制到康耐视的安装路径 CognexVisionProbin 下。 2. MVSDK.dll，复制到康耐视的安装路径 CognexVi

3、sionProbin 下 3. MindvisionCameraTool.ico，复制到康耐视的安装路径 CognexVisionProbin 下。 4. MindvisionCameraTool.vtt，复制到康耐视的安装路径 CognexVisionProbinTemplatesTools 下。 使用控件 加载工具 完成控件的安装后， 打开 VisionPro QuickBuild， 进入作业编辑器， 如下图所示， 点击工具列表按钮后， 可以在弹出的列表框里看到 MindvisionCameraTool 工具了。拖动工具即可加入的规则列表种 图 1 图 2 工具功能介绍 图 3 工具默认的

4、输入和输出参数 1. 控件工具可以有 3 种方式初始化相机，具体方式，由输入型参数 InitMethod 决定，InitMethod 为 int32 类 型，具体功能如下： InitMethod 为 0 时（默认） ，初始化找到的第一个相机。 InitMethod 为 1 时，按照 CameraName 参数指定的名字初始化相机。 InitMethod 为 2 时，按照 CameraSn 指定的序列号初始化相机。 2. 控件工具的输出参数有 3 个，分别是 CameraHandle，OutputImageGrey8 和 OutputImageRgb24 ，3 个 参数的作用如下： Camera

5、Handle,相机初始化后的句柄。有多个相机时，句柄各不一样。只读型变量，不要手动给它赋值， 否则会引起错误。未连接相机时，该变量为 0 ，连接成功后，该变量为大于 0 的整数。 OutputImageGrey8,为康耐视的 8 位灰度格式的图像，该工具每运行一次，成功采集的到图像后， OutputImageGrey8 会自动更新。 OutputImageRgb24，为康耐视的 24 位彩色格式的图像，该工具每运行一次，成功采集的到图像后， OutputImageGrey8 会自动更新。 注意，如果使用迈德威势黑白相机时，请使用 OutputImageGrey8， 只有 OutputImage

6、Grey8 会更 新图像，OutputImageRgb24 会始终为空；反之如果时使用迈德威势彩色相机时，请使用 OutputImageRgb24， 只有 OutputImageRgb24 会更新图像， OutputImageGrey8 会始终为空。 如 下图所示，请根据使用的相机，选择合适的图像输出。 图 4 选择要预览的图像 3. 控件工具的输入参数解释 图 4 控件中的输入参数(AnalogGain、AutoExposure 等)，是和图 5 界面上的操作对应的，具体意义如下： 图 5 工具配置界面 AnalogGain，int32 类型，模拟增益。对应于图 5 中的”增益”参数。调节增

7、益可以改变相机亮度，但 是增益越大，噪声会越大。增益的调节不影响帧率。 AutoExposure ，bool 类型，对应图 5 中，曝光设置下的模式，自动和手动。为 true 时，使能自动曝光 模式，AnalogGain 和 ExposureTime 会根据环境亮度自动调整；为 false 时，禁止自动曝光，由用户输 入的 AnalogGain 和 ExposureTime 决定相机图像亮度。默认为 false，即手动设置曝光模式。 CameraName，string 类型，指示相机名称，可读写，如果要按名称初始化指定的相机，必须事先给该变 量赋值，否则会导致初始化失败；如果不是按名称初始化相

8、机，则该变量不需要赋值，相机初始化后，该 变量会显示相机的名称。对应图 5 中的相机列表里的相机名。 CameraSn，string 类型，指示相机序列号，可读写，如果要按序列号初始化指定的相机，必须事先给该 变量赋值， 否则会导致初始化失败； 如果不是按序列号初始化相机， 则该变量不需要赋值， 相机初始化后， 该变量会显示相机的序列号。在图 5 中没有体现出来。 CameraTriggerMode，int32 类型，对应图 5 中的采集模式。为 0 时，相机处于连续采集模式，无论该 工具是否被执行，会在后台一直采集并更新图像；为 1 时，为软触发采图模式，只有该工具在执行一次的 时候，才会去

9、给相机发指令，重新采集一张图像；为 2 时，为硬触发采图模式，只有 ExposureTime，double 类型，相机的曝光时间，对图 5 中的“曝光时间”，单位为微秒，支持小数。曝 光时间越大，相机图像亮度越高，反之越暗。 注意， 曝光时间越大， 如果时拍运动物体， 会有严重的拖影， 并且曝光时间和帧率成反比，曝光时间越长，帧率越低，采集图像需要的时间越长。 InitMethod , int32 类型， 相机初始化的方式。 默认为 0 。 表示自动初始化扫描到的第一个相机。 为 1 时， 按照 CameraName 指定的相机名进行初始化；为 2 时按照 CameraSn 指定的序列号进行初

10、始化。 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

11、 所示: 图 6 黑白相机采集图像 彩色相机，采集的图像，会在 OutputImageRgb24 里更新，如图 7 所示。 图 7 彩色相机采集图像 参数存档说明 工具自带的输入型参数如下图所示： 图 9 工具自带的参数 参与序工具列化保存的参数有OutIO0State 、OutIO0Mode。 其余参数均不参与序列化保存，而是通过我们SDK自动保存在电脑上的配置文件，会自动记录上一次关闭相机时的参 数。 该工具是基于我们相机 SDK 开发的，所以，相机的配置参数，是可以通过其它软件来调整，调整以后保存， 再用 Visionpro 里的 mindvision 工具打开相机后，会自动加载修改过的

12、参数，参数配置文件在迈德威势软件的安 装路径下的 Camera/Configs 文件夹里，如下图所示： 图 8 相机参数存档文件 可以通过桌面上的演示软件，来调整相机的各种参数，包括图像尺寸、曝光、增益、gamma、对比度等等。 图 9 迈德威势演示程序 同时使用 2 个相机的配置方法 如果要同时使用 2 个或者 2 个以上的相机进行工作，为了易于区分，建立固定的对应关系，我们建议使用相 机的自定义名称或者序列号来进行绑定操作。 使用自定义相机名称来绑定和初始化相机 首先，使用我们自带的演示软件，修改相机名字。按以下流程进行： 1. 打开演示软件，可以扫描到多个相机。 图 10 扫描到多个相机

13、 2. 分别打开每个相机，在弹出的界面中，对着图像区域点鼠标右键，选择 相机配置，如图 11 所示： 图 11 打开相机设置窗口 3. 在设备信息栏目下，修改相机自定义名称。 图 12 自定义相机名称 4. 修改后，相机需要重新上电后新的自定义名称才能生效。自定义名称是写入相机内部的，设置成功后，该相机 无论接到哪个电脑上，名字都会是设定好的自定义名称。 5. 关闭我们的演示软件，打开 visionpro 的 QuickBuild，然后进行如下设置： 图 13 从工具栏里拖出 1 个 CogToolBlock 和 2 个迈德威势相机采集工具 6. 在 CogToolBlock1 中新增 2 个

14、 int32 类型的参数，起名为 InitMethod1 和 InitMethod2，都赋值为 1，表示 按名称进行初始化， 再新增 2 个 string 参数， 起名为 Name1 和 Name2,分别赋值为 Camera1 和 Camera2(请 将 Camera1 和 Camera2 替换为您自己设定的相机名)。然后分别进行数据连接操作，如图 14 所示： 图 14 按名称初始化指定的相机配置方法 7. 经过以上步骤，就成功的建立了相机的唯一对应关系，不受相机上电顺序以及端口的影响而改变。两个相机可 同时工作，界面如下图所示： 图 15 2 个相机同时工作 使用序列号来绑定和初始化相机

15、相机的序列号是唯一的，并且是不可以修改的，可以通过我们提供的工具事先读出来，再进行绑定操作。 1. 使用下图中的工具，得到相机的序列号。 图 16 读取相机序列号 2. 关闭我们的演示软件，打开 visionpro 的 QuickBuild，然后图 13 中一样的设置。 3. 在 CogToolBlock1 中新增 2 个 int32 类型的参数，起名为 InitMethod1 和 InitMethod2，都赋值为 2，表示 按名称进行初始化，再新增 2 个 string 参数，起名为 Sn1 和 Sn2,分别赋值为 xxxxx 和 yyyyy(请将 xxxxx 和 yyyyy 替换为您使用的 2 个相机的实际的序列号)。然后分别进行数据连接操作，如图 17 所示，至此就完成了 按序列号初始化指定相机的操作。 图 17 指定序列号来初始化相机 问题与反馈 目前， 该工具只加入了部分相机参数， 并没有把所有可调节的参数映射到工具的输入参数上， 其它参数的调节， 需要通过我们的演示软件进行，调节后再保存。如果需要新增某参数到该工具里直接调节，可以联系我们的技术支 持进行修改。 邮箱：support 电话：0755-28376557 也可以通过和您对接的销售人员进行问题反馈。