このページでは

Qt Graphs Qt Quick 3Dとの連携

Qt Graphs for 3DはQt Quick 3Dを基盤としているため、Qt Quick の3Dシーンをグラフに統合することが可能です。

赤い台座の上に反射する球体が配置された3D棒グラフ

シーン環境

グラフ内でQt Quick 3Dシーンの環境を調整するには、グラフのenvironment プロパティで、SceneEnvironment またはExtendedSceneEnvironment のいずれかを次のように定義します。

environment: ExtendedSceneEnvironment {
    aoEnabled: true
    aoDither: true
    ditheringEnabled: true
    lightProbe: Texture {
        textureData: ProceduralSkyTextureData {
            groundBottomColor: "black"
            skyTopColor: "white"
        }
    }
    backgroundMode: SceneEnvironment.SkyBox
    lensFlareEnabled: true
    lensFlareGhostCount: 10
    lensFlareApplyStarburstTexture: true
    lensFlareBloomBias: 0.4
}

サポートされていない機能

アンチエイリアシングモードやシーンのクリアカラーを上書きすることはできません。つまり、SceneEnvironment.antialiasingMode やSceneEnvironment.clearColor に値を設定しても効果はありません。ただし、backgroundMode がSceneEnvironment.Color に設定されていない場合、背景には設定が反映されます。

シーンの統合

Qt Quick の3Dシーンをグラフに統合するには、グラフのimportScene プロパティを、以下の設定を持つNode に設定します。

importScene: Node {
    Model {
        scale: Qt.vector3d(0.01, 0.01, 0.01)
        source: "#Sphere"
        x: 2.5
        z: 2
        y: 1
        castsReflections: false
        receivesReflections: true
        materials: [
            PrincipledMaterial {
                baseColor: "gold"
                metalness: 1.0
                roughness: 0.1
            }
        ]
        ReflectionProbe {
            boxSize: Qt.vector3d(6, 3, 5)
            boxOffset: Qt.vector3d(-1.5, -1, -1.5)
            parallaxCorrection: true
            quality: ReflectionProbe.High
        }
    }
    Model {
        scale: Qt.vector3d(0.01, 0.01, 0.01)
        source: "#Sphere"
        x: -2.5
        z: -2
        y: 1
        castsReflections: false
        receivesReflections: true
        materials: [
            PrincipledMaterial {
                baseColor: "white"
                metalness: 0.0
                roughness: 0.0
                transmissionFactor: 1.0
                thicknessFactor: 50
            }
        ]
    }
}

Nodes をグラフの子として直接追加しても機能しません。これは、グラフのデフォルトの子が対応するシリーズであるためです。

© 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.