Qt 3D: Exemple simple en QML
Une application QML qui montre comment afficher une scène dans Qt 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 :
- Qt Creator
Ouvrez le mode « Welcome » et sélectionnez l’exemple dans « Examples ». Pour plus d’informations, consultez Qt Creator: Tutoriel : Compiler et exécuter.
- Qt Extension for Visual Studio Code
Exécutez la commande « Qt: Open Qt examples » à partir de Command Palette, puis sélectionnez l’exemple dans la liste. Pour plus d’informations, consultez Qt Extension for Visual Studio Code: Tutoriel : Compiler et exécuter.
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.0Les 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 :
InputSettings { }© 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.