- Qt 6.4
- Qt Quick 3D
- Qt Quick 3D Examples and Tutorials
- Qt Quick 3D - RuntimeLoader Example
- Qt Quick 3D | Commercial or GPLv3

# Qt Quick 3D - RuntimeLoader Example

     // Copyright (C) 2021 The Qt Company Ltd.
     // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause

     import QtQuick
     import QtQuick.Window
     import QtQuick.Controls

     import Qt.labs.platform
     import Qt.labs.settings

     import QtQuick3D
     import QtQuick3D.Helpers
     import QtQuick3D.AssetUtils

     Window {
         visible: true
         width: 800
         height: 600

         property url importUrl;

         View3D {
             id: view3D
             anchors.fill: parent
             environment: SceneEnvironment {
                 backgroundMode: SceneEnvironment.SkyBox
                 lightProbe: Texture {
                     textureData: ProceduralSkyTextureData{}
                 }
             }

             camera: helper.orbitControllerEnabled ? orbitCamera : wasdCamera

             DirectionalLight {
                 eulerRotation: "-30, -20, -40"
                 ambientColor: "#333"
             }

             Node {
                 id: orbitCameraNode
                 PerspectiveCamera {
                     id: orbitCamera
                 }
             }

             PerspectiveCamera {
                 id: wasdCamera
             }

             function resetView() {
                 if (importNode.status === RuntimeLoader.Success) {
                     helper.resetController()
                 }
             }

             RandomInstancing {
                 id: instancing
                 instanceCount: 30
                 position: InstanceRange {
                     property alias boundsDiameter: helper.boundsDiameter
                     from: Qt.vector3d(-3*boundsDiameter, -3*boundsDiameter, -3*boundsDiameter);
                     to: Qt.vector3d(3*boundsDiameter, 3*boundsDiameter, 3*boundsDiameter)
                 }
                 color: InstanceRange { from: "black"; to: "white" }
             }

             QtObject {
                 id: helper
                 property real boundsDiameter: 0
                 property vector3d boundsCenter
                 property vector3d boundsSize
                 property bool orbitControllerEnabled: true

                 function updateBounds(bounds) {
                     boundsSize = Qt.vector3d(bounds.maximum.x - bounds.minimum.x,
                                              bounds.maximum.y - bounds.minimum.y,
                                              bounds.maximum.z - bounds.minimum.z)
                     boundsDiameter = Math.max(boundsSize.x, boundsSize.y, boundsSize.z)
                     boundsCenter = Qt.vector3d((bounds.maximum.x + bounds.minimum.x) / 2,
                                                (bounds.maximum.y + bounds.minimum.y) / 2,
                                                (bounds.maximum.z + bounds.minimum.z) / 2 )
                     console.log("Bounds changed: ", bounds.minimum, bounds.maximum,
                                 " center:", boundsCenter, "diameter:", boundsDiameter)

                     wasdController.speed = boundsDiameter / 1000.0
                     wasdController.shiftSpeed = 3 * wasdController.speed
                     wasdCamera.clipNear = boundsDiameter / 100
                     wasdCamera.clipFar = boundsDiameter * 10
                     view3D.resetView()
                 }

                 function resetController() {
                     orbitCameraNode.eulerRotation = Qt.vector3d(0, 0, 0)
                     orbitCameraNode.position = boundsCenter
                     orbitCamera.position = Qt.vector3d(0, 0, 2 * helper.boundsDiameter)
                     orbitCamera.eulerRotation = Qt.vector3d(0, 0, 0)
                     orbitControllerEnabled = true
                 }

                 function switchController(useOrbitController) {
                     if (useOrbitController) {
                         let wasdOffset = wasdCamera.position.minus(boundsCenter)
                         let wasdDistance = wasdOffset.length()
                         let wasdDistanceInPlane = Qt.vector3d(wasdOffset.x, 0, wasdOffset.z).length()
                         let yAngle = Math.atan2(wasdOffset.x, wasdOffset.z) * 180 / Math.PI
                         let xAngle = -Math.atan2(wasdOffset.y, wasdDistanceInPlane) * 180 / Math.PI

                         orbitCameraNode.position = boundsCenter
                         orbitCameraNode.eulerRotation = Qt.vector3d(xAngle, yAngle, 0)
                         orbitCamera.position = Qt.vector3d(0, 0, wasdDistance)

                         orbitCamera.eulerRotation = Qt.vector3d(0, 0, 0)
                     } else {
                         wasdCamera.position = orbitCamera.scenePosition
                         wasdCamera.rotation = orbitCamera.sceneRotation
                         wasdController.focus = true
                     }
                     orbitControllerEnabled = useOrbitController
                 }
             }

             RuntimeLoader {
                 id: importNode
                 source: importUrl
                 instancing: instancingButton.checked ? instancing : null
                 onBoundsChanged: helper.updateBounds(bounds)
             }

             Model {
                 parent: importNode
                 source: "#Cube"
                 materials: PrincipledMaterial {
                     baseColor: "red"
                 }
                 opacity: 0.2
                 visible: visualizeButton.checked && importNode.status === RuntimeLoader.Success
                 position: helper.boundsCenter
                 scale: Qt.vector3d(helper.boundsSize.x / 100,
                                    helper.boundsSize.y / 100,
                                    helper.boundsSize.z / 100)
             }

             Rectangle {
                 id: messageBox
                 visible: importNode.status !== RuntimeLoader.Success
                 color: "red"
                 width: parent.width * 0.8
                 height: parent.height * 0.8
                 anchors.centerIn: parent
                 radius: Math.min(width, height) / 10
                 opacity: 0.6
                 Text {
                     anchors.fill: parent
                     font.pixelSize: 36
                     text: "Status: " + importNode.errorString + "\nPress \"Import...\" to import a model"
                     color: "white"
                     wrapMode: Text.Wrap
                     horizontalAlignment: Text.AlignHCenter
                     verticalAlignment: Text.AlignVCenter
                 }
             }
         }

         OrbitCameraController {
             id: orbitController
             origin: orbitCameraNode
             camera: orbitCamera
             enabled: helper.orbitControllerEnabled
         }
         WasdController {
             id: wasdController
             controlledObject: wasdCamera
             enabled: !helper.orbitControllerEnabled
         }

         Row {
             RoundButton {
                 id: importButton
                 text: "Import..."
                 onClicked: fileDialog.open()
                 focusPolicy: Qt.NoFocus
             }
             RoundButton {
                 id: resetButton
                 text: "Reset view"
                 onClicked: view3D.resetView()
                 focusPolicy: Qt.NoFocus
             }
             RoundButton {
                 id: visualizeButton
                 checkable: true
                 text: "Visualize bounds"
                 focusPolicy: Qt.NoFocus
             }
             RoundButton {
                 id: instancingButton
                 checkable: true
                 text: "Instancing"
                 focusPolicy: Qt.NoFocus
             }
             RoundButton {
                 id: controllerButton
                 text: helper.orbitControllerEnabled ? "Orbit controller" : "WASD controller"
                 onClicked: helper.switchController(!helper.orbitControllerEnabled)
                 focusPolicy: Qt.NoFocus
             }
         }
         FileDialog {
             id: fileDialog
             nameFilters: ["glTF files (*.gltf *.glb)", "All files (*)"]
             onAccepted: importUrl = file
             Settings {
                 id: fileDialogSettings
                 category: "QtQuick3D.Examples.RuntimeLoader"
                 property alias folder: fileDialog.folder
             }
         }
     }