Sur cette page

Qt 3D: Exemple QML simple

Une application QML qui démontre comment rendre une scène dans Qt 3D.

Capture d'écran du rendu d'un objet 3D

L'exemple simple montre comment rendre une scène dans Qt 3D.

Exécution de l'exemple

Pour exécuter l'exemple à partir de Qt CreatorOuvrez le mode Welcome et sélectionnez l'exemple à partir de Examples. Pour plus d'informations, voir Qt Creator: Tutorial : Construire et exécuter.

Configuration de la scène

Nous configurons l'ensemble 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 entité 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 de l'événement est définie par Qt3DQuickWindow :

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