How to display a Mat image in Qt

Posted on Posted in OpenCV Tutorials, Qt Tutorials, Tutorials

You can use this method to convert an OpenCV Mat image to a Qt QImage which then can be easily turned into a QPixmap and then displayed on a QLabel. It might sound a little bit confusing but I’ll explain all of its parts. Check the method and my descriptions below:

Let’s say you have a OpenCV Mat variable named img:

Mat img;

And you have filled it with an actual image using OpenCV imread function:

img = imread(“c:/test.jpg”);

You should note that OpenCV always uses BGR color space by default but Qt, like many other programs and libraries, uses RGB so you have to convert the color space to match Qt’s. For this you can use OpenCV cvtColor function with CV_BGR2RGB parameter:

cvtColor(img, img, CV_BGR2RGB);

Now to be able to display your image you just need the following line of code. It is assumed that you have a QLabel named image_label on your window:

ui->image_lbl->setPixmap(QPixmap::fromImage(QImage(, img.cols, img.rows, img.step, QImage::Format_RGB888)));

As you can see you can put the whole thing in a single line. First your OpenCV Mat image is converted to QImage and then to QPixmap, and finally setPixmap method of QLabel sets your image’s bitmap.

Leave a Reply

Your email address will not be published. Required fields are marked *