imaqregister

注册第三方自定义适配器

所有的页面崩溃

语法

适配器= imaqregister

适配器= imaqregister (adaptorpath)

适配器= imaqregister (adaptorpath、动作)

描述

适配器= 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)是不一样的硬件厂商提供的驱动程序共享库(DLL在Windows上)。适配器共享库是针对图像采集工具箱和指定的硬件供应商。

适配器= 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 =结构体字段:InstalledAdaptors:{“演示”“gentl”“gige”kinect的‘matrox’‘mwdemoimaq’‘大三角帆的winvideo} MATLABVersion:“9.7 (R2019b)”ToolboxName:“图像采集工具箱”ToolboxVersion:“6.1 (R2019b)”

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

vid = videoinput (“mwdemoimaq”)

总结视频输入对象使用“颜色设备”。采集源(s): input1可用。采集参数:“input1”是当前选中的源。10帧/触发使用选定的来源。“RGB_NTSC”视频数据被记录在开始。首先抓住每帧(s)。日志数据触发“记忆”。触发参数:1“立即”触发(s)开始。状态:等待开始。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,您可能需要执行应用程序以管理员身份运行模式。