无法连接到相机

工业相机

安装使用说明书

文件版本：V1.2

目录

1产品简介.....................................................................................................3

2程序的安装..................................................................................................4

3演示软件的使用方法.....................................................................................8

3.1菜单栏...............................................................................................9

3.2工具栏...............................................................................................9

3.3视频预览区.......................................................................................11

3.4状态栏.............................................................................................12

4相机DirectShow接口的使用方法.................................................................13

5相机TWAIN接口的使用方法.......................................................................17

在Photoshop中使用TWAIN接口捕获图像...................................................17

在Scopephoto中使用TWAIN接口捕获图像................................................19

在Image-ProPlus中使用TWAIN接口捕获图像............................................21

6相机Halcon接口的使用方法........................................................................22

7相机Labview接口的使用方法......................................................................27

8如何使用相机SDK进行二次开发..................................................................29

1产品简介

我公司工业相机有如下特点：

1，统一的SDK接口。我公司USB2.0、USB3.0、千兆网、1394接口的

CCD、CMOS相机，都使用同一套SDK、演示平台，您无需关心不同型

号、接口的相机带来的差异。

2，完美支持一台电脑接多个相机。用户或者开发人员可以在配置界面中方便

修改指定相机的名称，用来区分多相机，相机名称修改后，无论接在哪台

电脑、无论是使用DSHOW、TWAIN、还是SDK接口，都会显示为您修改

后的名字，您无需再为一台电脑接多个相机难以区分而烦恼。

3，相机支持4组参数保存与加载，同时，支持从文件中加载参数，方便量

产。支持多种不同的参数加载模式，可以按照相机的名称、唯一序列号、

或者型号来进行加载，以满足您不同的使用场合需求。

4，提供丰富的图像处理接口，算法关键部分采用硬件加速功能，有效提升图

像质量的同时降低CPU占用率。

5，支持多种第三方软件接口。目前已经支持的接口有DirectShow、

TWAIN、Halcon、Labview、OpenCV、OCX。

6，所有相机均支持时间戳功能，能够准确记录图像采集的时间点，录像文件

能够准确还原拍摄时的时间。

7，提供中英文两个版本，可动态切换。

8，人性化的相机配置界面。相机配置按功能归类，方便操作，并且不同的软

件接口下都采用同样的配置界面，无论您使用哪种软件接口，都能快速的

熟悉相机的操作。

9，提供OEM、ODM服务，支持软件定制（PID,VID,设备名,文件名等），支

持硬件PCB定制、增加输入、输出IO等，同时承接各种CMOS、CCD相

机的订制开发。

2程序的安装

默认情况下，我公司提供的安装包为一个可执行文件，文件

名以PlatformSetup(x.x.x.x).exe结尾，(x.x.x.x).为版本号。安

装前建议关闭360等杀毒软件和QQ、MSN应用程序。360安全

卫士经常会误报、误删相机安装组件，导致相机无法正常启动。

安装方法如下：

1，安装Halcon、Labview、Digimizer、imageproplus、

Scopephoto等第三方软件。如果您不需要使用这些软

件，这一步可以跳过。

2，运行XXXXPlatformSetup(x.x.x.x).exe。如果您是第一

次安装我们的程序，会出现以下界面，默认选择

Chine(Simplified)进行简体中文版的安装,您可以在下

拉列表中选择English进行英文版的安装：

点击OK后，出现如下界面：

点击下一步，出现如下的界面：

点击浏览改变程序安装的路径。设置好安装路径后，

点击下一步，出现如下界面：

该界面下选择在开始菜单中建立的文件夹的名称，点击安

装后，开始正式安装。

安装完成后如下：

至此，安装结束。安装结束后，开发文档、开发例程(含

源码)、辅助工具、演示和测量软件都位于安装目录下，

如下图所示：

3，连接相机，并给相机安装驱动。以USB接口的相机为

例，当相机通过USB连接线连接到电脑时，系统会弹出

驱动安装的提示，您直接点击下一步，让系统自动搜索

安装即可。当驱动安装成功后，再次连接相同型号的相

机，系统会自动安装好驱动，不会有任何提示。

4，运行您的工作软件。如Halcon、Labview、Amcap、

Image-ProPlus等。如果您是第一次使用我们的相机，

建议您先运行桌面上的，该程序是基于我们

的SDK接口开发的演示平台，您可以通过该软件来全面

了解我们的相机。

3演示软件的使用方法

完成程序安装后(安装方法见第2章节)，您就可以开始使用我们的演示软件了。

将相机连接到电脑上，然后双击桌面上的启动软件。

该软件启动后会自动搜索相机，并进行初始化工作，正常情况下，会弹出如下的界面

图3.1演示软件主界面

3.1菜单栏

菜单栏位于主界面的最上方，分为[相机设置]、[预览控制]、[图像采集]、[工具]、[选

项]、[帮助]六大类。

[相机设置]，该菜单下可以进行相机设备相关的各种参数的设置。包括曝光设置、

触发设置、颜色调整，IO操作、视频参数、分辨率、十字线、LUT查表变换、图

形处理设置等若干个子菜单。

[预览控制]，该菜单下设置软件的预览模式。分为缩放模式和1:1显示模式，缩放

模式下，图像将缩放到适合窗口大小显示；1:1显示模式，图像不缩放，直接按原

始大小进行显示，如果图像大于显示器的分辨率，则只显示局部，此时可以通过

窗口右侧和底部的滚动条来选择1:1显示的范围。

[图像采集]，该菜单下可以设置图像的采集方式。图像采集分为拍照和录像两种，

拍照可以单独设置分辨率，独立于预览通道，拍照设置里可以设置拍照文件保存

的路径、自动拍照的周期、文件保存的格式等等；录像功能则是将预览的视频保

存成AVI文件。

[工具]，该菜单可以设置外部第三方测量软件的接口。默认情况下，本软件会自动

搜索Digimizer的路径，在按下启动测量工具时，会自动将当前预览图像发送到

Digimizer软件中。您可以在这里设置您自己的测量软件接口。

[选项]，该菜单可以设置一些提示信息的开关状态。

[帮助]，该菜单下是一些帮助和说明信息。

3.2工具栏

工具栏位于菜单栏下方，映射了一些常用的功能，简化操作。如图所示：

图3.2菜单栏

点击后显示相机设置窗口，功能和菜单栏中[相机设置一样]。

点击后进行一次软触发，如果相机当前的工作模式不是软触发模式，则会弹

出提示。效果和下图中触发一次按钮功能一样,您还可以在该页面下设置一次触

发的帧数。

图3.3软触发一次

点击后使能相机工作，SDK中开始接收图像数据。与[预览控制]菜单下，播

放按钮功能一样。

点击后中断相机工作，SDK停止接收图像数据，相机也停止图像采集。此时

预览、抓拍、录像均被暂停。与[预览控制]菜单下，暂停按钮功能一样。

点击后相机停止工作，功能和类似。与[预览控制]菜单下，停止按钮

功能一样。

点击后，放大窗口。与[预览控制]菜单下，放大按钮功能一样。

点击后，缩小窗口，与[预览控制]菜单下，缩小按钮功能一样。

点击后，窗口最大化，与[预览控制]菜单下，全屏显示按钮功能一样。

点击后，抓拍一张图片，并保存到磁盘中。与[图像采集]菜单下，抓拍按

钮功能一样。

点击后，进行抓拍设置。与[图像采集]菜单下，抓拍设置按钮功能一样。

点击后，将当前预览图像发送到测量软件。与[工具]菜单下，启动测量工

具按钮功能一样。

点击后，进行测量工具设置。与[工具]菜单下，设置测量工具按钮功能一

样。

点击后，使能或者禁止自动曝光功能。与相机配置窗口下，[曝光控制]子页

中模式选择功能相同。

点击后，根据当前预览图像，进行一次性白平衡校正。与相机配置窗口下，

[颜色调整]子页下，一键白平衡按钮功能相同。

3.3视频预览区

视频预览区能够连续显示从相机中接收到的图像。

当选择为缩放模式显示时，图像会被按照原始宽高比缩放到适合窗口大小进行显

示；当选择为1：1显示模式时，图像按照1：1的比例进行显示，如果图像的尺寸大

于窗口预览区的尺寸，则可以通过调节窗口右侧和底层的滚动条来决定显示的区域。

当对视频预览区点击鼠标右键时，会弹出如下的快捷菜单:

图3.4预览区右键菜单

该快捷菜单中的功能和菜单栏以及工具栏中的相应功能是一样的，唯一不同的地

方是，点击该快捷菜单中的1:1显示模式时，会以您右键点击的位置为中心点来进

行1:1显示，方便您在缩放模式预览时，快速定位到指定位置进行1:1查看。

3.4状态栏

状态栏位于窗口的最下方，指示了当前预览图像的信息。

图3.5状态栏

如图3.5所示，状态栏从左到右，依次显示了图像的尺寸、显示帧率、采集帧率和窗

口预览区大小相对于图像实际大小的比率。(一般情况下，显示帧率等于采集帧率，当

电脑的性能较差时，显示帧率会低于采集帧率)

4相机DirectShow接口的使用方法

DirectShow接口是Windows平台通用的视频接口，绝大多数商业图像软件都支持

通过DirectShow接口的方式来访问图像采集设备，例如Scopephoto、imagepro

plus、Halcon、Labview等知名软件，都支持该接口。

下面以Scopephoto软件和MV-U300USB2.0相机为例，讲述如何通过

DirectShow接口使用我公司MindVision系列的相机：

1.用数据线将相机和PC相连接。

2.启动Scopephoto后，弹出如图4.1所示的对话框，在”Live捕获”下,可以看

到我们的MV-U300相机。

图4.1Scopephoto启动界面

3.点击CameraMV-U300后，如图4.2所示。

图4.2Scopephoto打开MV-U300时界面

4.点击“设置”菜单，选择视频源属性，如图4.3所示，然后会弹出如图4.4

所示的相机参数配置窗口。

图4.3相机参数设置

图4.4DirectShow接口中相机配置窗口

5.点击“设置”菜单，选择视频流格式，如图4.5所示，然后会弹出如图4.6

所示的相机视频视频分辨率设置窗口。

图4.5相机分辨率设置

图4.6DirectShow接口相机分辨率设置窗口

5相机TWAIN接口的使用方法

TWAIN接口和DirectShow接口一样，也是一项重要的接口标准，不同的是

TWAIN接口是跨平台的，在Windows、Linux/Unix,MacOSX系统下都可以使用

TWAIN接口进行图像捕获。

本章将以MV-U300相机为例，讲述如何通过TWAIN接口使用我们的相机。

在Photoshop中使用TWAIN接口捕获图像

以PhotoshopCS4版本为例，流程如下：

1.用数据线将相机和PC相连接。

2.启动Photoshop后，点击”文件”菜单，选择“导入”，如图5.1所示，可以

看到我们的MV-U300相机。

图5.1Photoshop中使用TWAIN接口列表

3.点击CameraMV-U300后，弹出如图5.2所示窗口。窗口左侧有一些设置参

数的按钮，点击后，会弹出如图4.4一样的配置窗口。

图5.2TWAIN接口图像采集预览窗口

4.在预览窗口下，选定好要捕获的画面后，点击图5.2中的捕获按钮，图像就

被采集到了Photoshop中，如图5.3所示。

图5.3Photoshop通过TWAIN接口采集到的图片

在Scopephoto中使用TWAIN接口捕获图像

在第3章已经演示了Scopephoto如果通过DirectShow接口访问MV-U300。

Scopephoto不仅支持DirectShow，也支持TWAIN接口，其TWAIN接口的使用流程

如下：

1.用数据线将相机和PC相连接。

2.启动Scopephoto后，点击”文件”菜单，选择“影像导入”后，再点击

“Twain:选择设备(S)…”，如图5.1所示。在弹出的设备选择对话框中可以看

到我们的MV-U300相机，如图5.2所示。您的电脑中可能存在多个TWAIN

设备，在列表中选中CameraMV-U300后，点击选定按钮。

图5.4Scopephoto中选择Twain设备

图5.5TWAIN设备选择对话框

3.点击”文件”菜单，选择“影像导入”后，再点击“Twain:捕获(A)…”，如图

5.6所示。点击后，弹出相机的TWAIN采集预览窗口，如图5.2所示。

图5.6Scopephoto中使用Twain设备进行图像捕获

4.在预览窗口下，选定好要捕获的画面后，点击图5.2中的捕获按钮，图像就

被采集到了Photoshop中，如图5.7所示。

图5.7Scopephoto通过TWAIN接口采集到的图像

在Image-ProPlus中使用TWAIN接口捕获图像

以Image-ProPlus6.0为例，流程如下：

1.用数据线将相机和PC相连接。

2.启动Image-ProPlus后，点击”Acquire”菜单，选择“SelectScanner…”，

如图5.8所示。在弹出的设备选择对话框中可以看到我们的MV-U300相机，

如图5.5所示。您的电脑中可能存在多个TWAIN设备，在列表中选中

CameraMV-U300后，点击选定按钮。

图5.8Image-ProPlus中选择TWAIN设备

3.点击”Acquire”菜单，选择“Scan…”，如图5.8所示。点击后，弹出相机的

TWAIN采集预览窗口，如图5.2所示。

4.在预览窗口下，选定好要捕获的画面后，点击图5.2中的捕获按钮，图像就

被采集到了Image-ProPlus中，如图5.9所示。

图5.9Image-ProPlus通过TWAIN接口采集到的图像

6相机Halcon接口的使用方法

Halcon是目前世界上最全能的机器视觉软件。世界各地的用户从Halcon为快速开

发图像分析和机器视觉程序的灵活架构获益匪浅。Halcon提供了超过1100多种具备

突出性能控制器的库,如模糊分析,形态,模式匹配,3D校正等。Halcon支持多个操作系

统。

我们的相机接口专门为Halcon进行了优化设置，能够良好的支持Halcon。在已经

安装了Halcon的系统中，再运行我们的MindVisionPlatformSetup(x.x.x.x).exe安装

程序，安装程序会自动检测Halcon的安装路径，并对其进行相应的设置，安装完成

后，便可在Halcon中使用我们的相机了。

有关使用MindVision相机在Halcon中进行开发的详细说明，请参考软件安装目录

下的Document中，MindVision工业相机开发手册中第5章，目前我们的软件包支

持Halcon8、Halcon9、Halcon10和Halcon11这4个版本,在安装包中，

文件对应Halcon8，对应

HALCON9和HALCON10,对应Halcon11，需要根据

halcon版本复制不同的文件到halcon的bin目录下，安装包会自动识别halcon的

默认路径来识别版本，然后复制对应的文件，如果用户在安装halcon时修改了默认

路径，安装包可能无法正确识别版本，这个情况可以手动复制对应的文件到halcon

的bin目录下，如有疑问，请联系我们的技术支持。

这里以Halcon10、MV-U300USB2.0相机为例，简要说明使用流程:

1.用数据线将相机和PC相连接。

2.启动Halcon后，点击”助手”菜单，选择“打开新的ImageAcquisition”，

如图6.1所示。

图6.1Halcon图像采集接口

3.点击“图像获取接口(I)”,在下拉列表中，找到Mindvision(或者是

Mindvision8、Mindvision11，分别对应不同的halcon版本)。如图6.2所

示。

4.点击图6.2中的“连接”标签页，出现如图6.3所示的窗口。在图6.3中，我

们可以看到我们的MV-U300相机。如果同时连接了多台Mindvision相机，

请在设备列表中选择您想要访问的相机。

图6.2在Halcon图像采集接口列表中找到Mindvision

图6.3Halcon中Mindvision相机采集接口窗口

5.点击图6.3中的”连接(n)”按钮，成功连接后，“参数”标签页被激活，如图

6.4所示。此时可以进行颜色空间和位深度的选择。我们的接口支持RGB24

和RAW两种颜色空间，位深度支持8、10、12位三种(仅部分相机支持

10、12比特的位深度，无帧存系列只支持8位位深度)。建议使用8位位深

度和RGB24颜色空间。

图6.4Halcon中成功连接MV-U300

6.参数设置。点击“参数”标签页按钮，切换到参数配置页面，如图6.5所

示。bits_per_channel中可以选择每通道下的位深度；grab_timeout为抓图

超时时间，单位为毫秒;camera_play点击后，开始或者继续图像采集功

能;camer_pau点击后，暂停图像采集功能;show_camera_ttings点击

后，显示MV-U300相机的配置页面，如图6.6所示。

图6.5Halcon中相机参数设置页面

7.图像采集。Halcon中图像采集分为单次采集和实时采集两种方式。点击图

6.4中“采集(S)”按钮，进行一次单次采集，采集后图像现在Halcon窗口

内，如图6.7所示；点击图6.4中的”实时(v)”按钮，进行连续采集，Halcon

中将连续显示采集到得图像。

图6.6Halcon中显示相机的设置窗口

图6.7Halcon中采集到的图像

7相机Labview接口的使用方法

有关使用MindVision相机在Labview中进行开发的详细说明，请参考软件安装目

录下的Document中，MindVision工业相机开发手册中第6章。

在Labview中可以通过以下3种方式来访问相机：

1.使用NIMAX(需要Vision模块),如下图所示：

该方式下，可以切换相机的分辨率，但是其他的参数就不方便设置，您可以先用

我们的演示软件打开相机，调好参数后保存下来，然后再用NIMAX打开，即可

恢复您刚才设置好的参数。

2.使用我们提供的基于ActiveX控件的VI例程，不需要Vision模块。该例程

“MV_labview_演示程序.exe”位于安装目录的Demo/Labview/uActiveX

目录下。该例程演示了如何在labview中使用我们的相机。该目录下同时存

放了Labview中访问我们相机的vi源码和LabView工程。(注:工程为

LabView2012版本建立,运行Labview演示程序需要安装Labview2012运行

时库)。

3.使用我们提供的基于SDK的DLL文件调用方式的VI例程，该例程需要

Vision模块。该例程“MV_labview_演示程序.exe”位于安装目录的

Demo/Labview/uActiveX目录下。该例程演示了如何在labview中使用我

们的相机。

8如何使用相机SDK进行二次开发

程序安装完以后，在安装目录的SDK文件夹中，有如图8.1所示的一些文件和子

目录。其中Document文件夹中，有工业相机开发手册;Demo文件夹中有若干开发例

程。

如果DirectShow、TWAIN等接口仍不能满足您的项目需求，您可以基于我们的

SDK进行二次开发。开发前，请务必先阅读完Document文件夹中的工业相机开发手

册，该手册中对二次开发进行了详细说明，并描述了各个开发例程的特点和适用条

件，阅读后再开发，可以节约您大量的开发时间。

图8.1安装目录文件结构