《OpenCV》Part11 OpenCV3.1.0 Qt中的信号槽函数传递cv::Mat格式参数

《OpenCV》Part11 OpenCV3.1.0 Qt中的信号槽函数传递cv::Mat格式参数

一、信号传送问题

1、写Qt的多线程程序，用到信号槽函数传递cv::Mat格式的参数，编译通过，但是debug时提示下列错误：

QObject::connect: Cannot queue arguments of type 'Mat'
(Make sure 'Mat' is registered using qRegisterMetaType().)

意思是说，信号槽队列中的数据类型必须是系统能识别的元类型，不然得用qRegisterMetaType()进行注册。

原因：当一个signal被放到队列中（queued）时，它的参数(arguments)也会被一起一起放到队列中（queued起来），这就意味着参数在被传送到slot之前需要被拷贝、存储在队列中（queue）中；为了能够在队列中存储这些参数(argument)，Qt需要去construct、destruct、copy这些对象，而为了让Qt知道怎样去作这些事情，参数的类型需要使用qRegisterMetaType来注册（如错误提示中的说明）

步骤：(以自定义TextAndNumber类型为例）

自定一种类型，在这个类型的顶部包含：#include <QMetaType>

在类型定义完成后，加入声明：Q_DECLARE_METATYPE(TextAndNumber);

在main()函数中注册这种类型：qRegisterMetaType<TextAndNumber>("TextAndNumber");

如果还希望使用这种类型的引用，可同样要注册：qRegisterMetaType<TextAndNumber>("TextAndNumber&");

#include <QMetaType> 
//必须包含QMetaType，否则会出现下面错误： 
//error: expected constructor, destructor, or type conversion before ‘;’ token 
#include <QString> 
class TextAndNumber { 
public: 
TextAndNumber(); 
TextAndNumber(int, QString); 
int count(); 
QString text(); 
private: 
int m_count; 
QString m_text; 
}; 
Q_DECLARE_METATYPE(TextAndNumber); 
#endif // TEXTANDNUMBER_H 

int main(int argc, char *argv[]) 
{ 
QApplication app(argc, argv); 
qRegisterMetaType<TextAndNumber>("TextAndNumber"); 
qRegisterMetaType<TextAndNumber>("TextAndNumber&"); 
TextDevice device; 
TextThread foo("foo"), bar("bar"); 
QObject::connect(&foo, SIGNAL(writeText(TextAndNumber&)), &device, SLOT(write(TextAndNumber&))); 
QObject::connect(&bar, SIGNAL(writeText(TextAndNumber&)), &device, SLOT(write(TextAndNumber&)));

上面是解决方法和步骤。网上对这个问题的解决有两种方案，除了上述的方法外，还有一种简单粗暴的方法，但是可能会造成风险。

———————————————————————————————————————————————————

二、解决方法：

第一种注册法：qRegisterMetatType<MoSystemLog>("MoSystemLog")
第二种修改Connect，加一个属性Qt::directConnection.
connect(cm, SIGNAL(sendLog(QUuid, QByteArray, bool)),this,SLOT(sendRes(QUuid,QByteArray,bool)),

Qt::DirectConnection);


三、方法解释：

1、第一种解决方法，即使用排队方式的信号-槽机制，Qt的元对象系统（meta-object system）必须知道信号传递的参数类型。这样元系统可以将信号参数COPY下来，放在队列中等待事件唤醒，供槽函数调用。Just a note here, if you would have to pass custom data types between threads in Qt. As we know, a signal-slot connection is then (by default) of type Qt::QueuedConnection. Because in such a situation Qt needs to store passed parameters for a while, it creates their temporary copies. If it doesn’t recognize the passed data type, throws out an error:
2、第二种方法，直接调用对方槽函数，不需要保存参数。但是官方认为这样做有风险。

四、背景知识：
1、首先要了解enum Qt::ConnectionType

Qt支持6种连接方式，其中3种最主要：
Qt::DirectConnection（直连方式）
当信号发出后，相应的槽函数将立即被调用。emit语句后的代码将在所有槽函数执行完毕后被执行。（信号与槽函数关系类似于函数调用，同步执行）
Qt::QueuedConnection（排队方式）
当信号发出后，排队到信号队列中，需等到接收对象所属线程的事件循环取得控制权时才取得该信号，调用相应的槽函数。emit语句后的代码将在发出信号后立即被执行，无需等待槽函数执行完毕。（此时信号被塞到信号队列里了，信号与槽函数关系类似于消息通信，异步执行）
Qt::AutoConnection（自动方式）
Qt的默认连接方式，如果信号的发出和接收这个信号的对象同属一个线程，那个工作方式与直连方式相同；否则工作方式与排队方式相同。

Qt官方文档中写明：
With queued connections, the parameters must be of types that are known to Qt's meta-object system, because Qt needs to copy the arguments to store them in an event behind the scenes. If you try to use a queued connection and get the error message
QObject::connect: Cannot queue arguments of type 'MyType'
callqRegisterMetaType() to register the data type before you establish the connection.
注意上面紫色的内容。

connect的第五个参数用于指定反应速度:
若将：
connect(cm, SIGNAL(sendLog(QUuid, QByteArray, bool)),
this,SLOT(sendRes(QUuid,QByteArray,bool)));
改为：
connect(cm, SIGNAL(sendLog(QUuid, QByteArray, bool)),
this,SLOT(sendRes(QUuid,QByteArray,bool)), Qt::DirectConnection);

可解决因信号没有及时发送，致使connect的接收方的槽不能作进一步处理，但是有风险。

———————————————————————————————————————————————————

对于结构体的信号槽传输，这里也给出一个例子。

解决方案：
将结构体搬出类，而不是写在类public里面，可以写在同一个头文件中。
例子：

#include <QtGui/QApplication>
#include <QVariant>
  
//*.h
structstruct1
{
    inta;
    doubleb;
};
  
structstruct2
{
    struct1 s;
    intc;
};
  
Q_DECLARE_METATYPE(struct1) //struct1与struct2 谁先谁后，没有影响
Q_DECLARE_METATYPE(struct2)
 
class Data()
{
   public:
        int x,y;
}
 
// *.cpp 
int main(int argc,char *argv[])
{
    QApplication a(argc, argv);
    struct1 v1 = {1, 2.0};
    QVariant var1;
    var1.setValue(v1);
  
    if(var1.canConvert<struct1>())   //判断能否转化为相应类型
    {
        struct1 v11 = var1.value<struct1>();
    }
  
    struct2 v2 = {{2, 3.0}, 5};
    QVariant var2;
  
    if(var2.canConvert<struct2>())
    {
        var2.setValue(v2);
        struct2 v22 = var2.value<struct2>();
    }
    returna.exec();
}
 

结束语:
将结构体搬出类，而不是写在类public里面，可以写在同一个头文件中。这个注册函数暂时还没用到，看看宏定义,Q_DECLARE_METATYPE(),里面好像已近带了这个注册功能。
qRegisterMetaType<QVariant>("QVariant"); //写在构造函数里