Qt5.12：QML 3D场景中QQuickImageProvider加载纹理失效问题求解

目前Qt 3D的TextureLoader并不支持image://协议的QQuickImageProvider，没有直接的简便实现方式，以下是两种可行的解决方案：

方案一：纯QML实现（利用Image中转） #

通过Image组件加载QQuickImageProvider提供的图片，再将Image内容转换为3D可用的Texture，赋值给3D材质。因为Image原生支持image://协议，能正常获取图片。

修改后的QML代码示例：

id: scene3d
Entity {
    Entity {
        id: floor

        // 隐藏的Image，用于加载QQuickImageProvider的地图图片
        Image {
            id: mapImage
            source: "image://colors/yellow.png"
            visible: false // 无需在界面显示
            // 图片加载/更新时自动同步到3D纹理
            onSourceChanged: {
                if (mapImage.status === Image.Ready) {
                    material.baseColor = Texture.fromImage(mapImage)
                }
            }
        }

        components: [
            PlaneMesh {
                width: 10
                height: 10
                mirrored: true
            },
            TexturedMetalRoughMaterial {
                id: material
                // 可选：设置默认纹理作为加载占位
                baseColor: TextureLoader { source: "default_map.png" }
            }
        ]
    }
}

当2D地图动态更新时，只要QQuickImageProvider返回新的图片数据，Image会自动触发sourceChanged信号，进而同步更新3D场景的纹理。

方案二：C++生成QTexture2D（灵活性更高） #

如果需要对纹理进行精细控制（比如自定义格式、mipmap设置），可以在C++端直接从QQuickImageProvider获取图片，生成QTexture2D对象后暴露给QML使用。

C++代码片段： #

#include <QTexture2D>
#include <QQuickImageProvider>
#include <QGuiApplication>
#include <QQmlApplicationEngine>

class MapTextureProvider : public QObject
{
    Q_OBJECT
    Q_PROPERTY(QTexture2D* mapTexture READ mapTexture NOTIFY mapTextureChanged)
public:
    QTexture2D* mapTexture() const { return m_texture; }

    // 调用此方法更新纹理，参数为ImageProvider的ID和图片ID
    Q_INVOKABLE void updateMapTexture(const QString& providerId, const QString& imageId) {
        QQuickImageProvider* provider = qApp->imageProvider(providerId);
        if (!provider) return;

        QImage image = provider->requestImage(imageId, nullptr, QSize());
        if (image.isNull()) return;

        if (!m_texture) {
            m_texture = new QTexture2D(this);
            // 自定义纹理设置，比如开启mipmap
            m_texture->setGenerateMipMaps(true);
            m_texture->setFormat(QAbstractTexture::SRGB8_Alpha8);
        }
        m_texture->setImage(image);
        emit mapTextureChanged();
    }

signals:
    void mapTextureChanged();

private:
    QTexture2D* m_texture = nullptr;
};

// 注册到QML模块
qmlRegisterType<MapTextureProvider>("MapUtils", 1, 0, "MapTextureProvider");

对应QML代码： #

import MapUtils 1.0

id: scene3d
MapTextureProvider {
    id: mapTextureProvider
    Component.onCompleted: {
        // 初始化加载地图纹理
        mapTextureProvider.updateMapTexture("colors", "yellow.png")
    }
}
Entity {
    Entity {
        id: floor

        components: [
            PlaneMesh {
                width: 10
                height: 10
                mirrored: true
            },
            TexturedMetalRoughMaterial {
                id: material
                baseColor: mapTextureProvider.mapTexture
            }
        ]
    }
}

后续2D地图更新时，只需调用mapTextureProvider.updateMapTexture()即可同步更新3D纹理。

内容的提问来源于stack exchange，提问作者Vilture