imaqregister

注册第三方自定义适配器

折叠所有页面

语法

适配器= imaqregister

Adaptors = imaqregister(adaptorpath)

Adaptors = imaqregister(adaptorpath,action)

描述

适配器= imaqregister返回已注册第三方适配器的列表及其完整路径。如没有注册转接器，imaqregister返回一个空单元格数组。

请注意

的imaqhwinfo而且videoinput函数使用适配器基名称，而不是完整路径。例如，如果适配器全路径为“c: \ adaptor.dll”(Windows^®)，“/地方/适配器/ adaptor.so”(Linux^®),或“/地方/适配器/ adaptor.dylib”（macOS)，则适配器基名称为“适配器”．

例子

适配器= imaqregister (adaptorpath）注册指定的第三方适配器库并返回所有已注册适配器的列表。

注册适配器将通知图像采集工具箱™第三方适配器库的位置。如果使用。查询系统中可用的图像采集硬件imaqhwinfo，该工具箱使以前注册的适配器库可用。的imaqregister函数在MATLAB中保存已注册适配器的名称^®首选项目录，以便位置在MATLAB会话中持续存在。因为imaqhwinfo缓存您可能需要调用的可用适配器列表imaqreset后调用imaqregister使新注册的适配器可用。

请注意

适配器共享库(Windows上的DLL)与硬件供应商提供的驱动程序共享库(Windows上也是DLL)不同。适配器共享库特定于图像采集工具箱，并由硬件供应商指定。

适配器= imaqregister (adaptorpath，行动）从可用适配器列表中添加或删除第三方适配器，如所指定的行动．

例子

全部折叠

注册第三方适配器

打开实时脚本

在Windows系统上的“图像采集工具箱”中注册第三方适配器并预览其数据。本例使用图像采集工具箱中包含的演示适配器，但您可以按照以下步骤注册任何自定义第三方适配器。要查看演示适配器源文件，请导航到系统上的目录。在您的计算机上，确切的文件路径可能不同。

cd (“C: \ Program Files \ MATLAB工具箱\ R2019b \ \ imaq \ imaqadaptors \设备\ demo \ '）

使用imaqregister通知图像采集工具箱您的第三方适配器。对于本例，考虑用于Windows的演示适配器的预构建版本\工具箱\ \ demo \ win64 imaq \ imaqadaptors \工具包文件夹中。

imaqregister (“C: \ Program Files \ MATLAB工具箱\ R2019b \ \ imaq \ imaqadaptors \设备\ demo \ win64 \ mwdemoimaq.dll”）

ans =1×1单元格数组{“C: \ Program Files \ MATLAB工具箱\ R2019b \ \ imaq \ imaqadaptors \设备\ demo \ win64 \ mwdemoimaq.dll '}

工具箱缓存适配器信息，因此必须重新加载在工具箱中注册的适配器库，才能显示第三方适配器。

imaqreset

中查看已安装适配器的列表InstalledAdaptors字段。新注册的第三方适配器显示为mwdemoimaq．

imaqhwinfo

ans =带字段的结构:已安装的适配器:{'demo' 'gentl' 'gige' 'kinect' 'matrox' 'mwdemoimaq' 'spinnaker' 'winvideo'} MATLABVersion: '9.7 (R2019b)' ToolboxName: '图像采集工具箱' ToolboxVersion: '6.1 (R2019b)'

用这个适配器创建一个视频输入对象。

视频输入(“mwdemoimaq”）

视频输入对象使用“彩色设备”的摘要。采集源:input1可用。采集参数:'input1'是当前选中的源。使用所选源每个触发器10帧。'RGB_NTSC'视频数据将被记录在开始。抓取第一个每1帧(s)。在触发时将数据记录到“内存”。触发参数:启动时1个“立即”触发器。状态:等待启动。启动后获得0帧。 0 frames available for GETDATA.

获取适配器返回的数据的预览。

预览(vid)

完成预览后，关闭窗口。

closepreview (vid)

输入参数

全部折叠

`adaptorpath`- - - - - -适配器的路径
特征向量|字符串数组

适配器路径，指定为字符向量或字符串数组。必须指定适配器库文件的完整绝对路径。

例子:imaqregister (c: \ temp \ thirdpartyadaptor.dll)注册适配器thirdpartyadaptor．

数据类型:字符|字符串

`行动`- - - - - -适配器注册
`“注册”`(默认)|`“注销”`

适配器注册，指定为“注册”或“注销”．使用“注册”将第三方适配器添加到可用适配器列表。使用“注销”从列表中移除第三方适配器。

例子:imaqregister(“c: \ temp \ thirdpartyadaptor.dll”、“注销”)移除适配器thirdpartyadaptor．

数据类型:字符|字符串

提示

使用将自定义适配器部署到独立应用程序时，请遵循这些建议MATLAB编译器™．
- 调用imaqregister在你部署的MATLAB代码中。这确保部署的应用程序为运行应用程序的用户注册自定义适配器库。有关更多信息，请参见创建自定义适配器．
- 将自定义适配器库与独立应用程序打包。方法中添加适配器DLL文件为最终用户安装的文件部份应用程序编译器有关创建独立应用程序的详细信息，请参见从MATLAB创建独立的应用程序(MATLAB编译器)．
- 第一次运行调用imaqregister，则可能需要在中执行应用程序以管理员身份运行模式。