QQmlImageProviderBase Class
The QQmlImageProviderBase class is used to register image providers in the QML engine. More...
| Header: | #include <QQmlImageProviderBase> |
| CMake: | find_package(Qt6 COMPONENTS Qml REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Qml) |
| qmake: | QT += qml |
| Inherits: | QObject |
| Inherited By: |
Public Types
| enum | Flag { ForceAsynchronousImageLoading } |
| flags | Flags |
| enum | ImageType { Image, Pixmap, Texture, ImageResponse } |
Public Functions
| virtual QQmlImageProviderBase::Flags | flags() const = 0 |
| virtual QQmlImageProviderBase::ImageType | imageType() const = 0 |
Detailed Description
Image providers must be registered with the QML engine. The only information the QML engine knows about image providers is the type of image data they provide. To use an image provider to acquire image data, you must cast the QQmlImageProviderBase pointer to a QQuickImageProvider pointer.
See also QQuickImageProvider and QQuickTextureFactory.
Member Type Documentation
enum QQmlImageProviderBase::Flag
flags QQmlImageProviderBase::Flags
Defines specific requirements or features of this image provider.
| Constant | Value | Description |
|---|---|---|
QQmlImageProviderBase::ForceAsynchronousImageLoading | 0x01 | Ensures that image requests to the provider are run in a separate thread, which allows the provider to spend as much time as needed on producing the image without blocking the main thread. |
The Flags type is a typedef for QFlags<Flag>. It stores an OR combination of Flag values.
enum QQmlImageProviderBase::ImageType
Defines the type of image supported by this image provider.
| Constant | Value | Description |
|---|---|---|
QQmlImageProviderBase::Image | 1 | The Image Provider provides QImage images. The QQuickImageProvider::requestImage() method will be called for all image requests. |
QQmlImageProviderBase::Pixmap | 2 | The Image Provider provides QPixmap images. The QQuickImageProvider::requestPixmap() method will be called for all image requests. |
QQmlImageProviderBase::Texture | 3 | The Image Provider provides QSGTextureProvider based images. The QQuickImageProvider::requestTexture() method will be called for all image requests. |
QQmlImageProviderBase::ImageResponse | 4 | The Image provider provides QQuickTextureFactory based images. Should only be used in QQuickAsyncImageProvider or its subclasses. The QQuickAsyncImageProvider::requestImageResponse() method will be called for all image requests. Since Qt 5.6 |
Member Function Documentation
[pure virtual] QQmlImageProviderBase::Flags QQmlImageProviderBase::flags() const
Implement this to return the properties of this image provider.
[pure virtual] QQmlImageProviderBase::ImageType QQmlImageProviderBase::imageType() const
Implement this method to return the image type supported by this image provider.