C++ Extensions: Image Provider Example

How to load images in QML with QQuickImageProvider.

This example shows how to use QQuickImageProvider to serve images to QML Image items, and how to package it into a QQmlEngineExtensionPlugin which is detected and loaded at runtime. The plugin is then a reusable component that can be installed into a system-wide location for use by multiple applications.

It can be built and tested like this:

$ qt-cmake .
$ cmake --build .
$ qml -I . imageprovider-example.qml

Alternatively, a QQuickImageProvider intended for use in only one application can simply be instantiated in main.cpp as documented.

Example project @ code.qt.io

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.