Sur cette page

Qt 3D: Exemple simple en QML

Une application QML qui montre comment afficher une scène dans Qt 3D.

Capture d'écran montrant le rendu d'un objet 3D

Cet exemplesimple montre comment afficher une scène dans Qt 3D.

Exécution de l'exemple

Vous pouvez exécuter l'exemple à partir de :

Configuration de la scène

Nous configurons l'intégralité de la scène dans le fichier main.qml.

Pour pouvoir utiliser les types des modules Q3D et Q3D Render, nous devons importer ces modules :

import Qt3D.Core 2.0
import Qt3D.Render 2.0

Les premières entités que nous créons sont une « Camera », qui représente la caméra utilisée pour le rendu final, et un contrôleur de caméra, qui nous permet de contrôler cette caméra à l’aide du clavier ou de la souris :

Camera {
    id: camera
    projectionType: CameraLens.PerspectiveProjection
    fieldOfView: 45
    aspectRatio: 16/9
    nearPlane : 0.1
    farPlane : 1000.0
    position: Qt.vector3d( 0.0, 0.0, -40.0 )
    upVector: Qt.vector3d( 0.0, 1.0, 0.0 )
    viewCenter: Qt.vector3d( 0.0, 0.0, 0.0 )
}

Une entité « RenderSettings » spécifie un «ForwardRenderer» comme framegraph actif :

components: [
    RenderSettings {
        activeFrameGraph: ForwardRenderer {
            clearColor: Qt.rgba(0, 0.5, 1, 1)
            camera: camera
            showDebugOverlay: true
        }
    },
    // Event Source will be set by the Qt3DQuickWindow
    InputSettings { }
]

La source d’événement est définie par la classe Qt3DQuickWindow :

Exemple de projet sur 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.