Revision control
++ // Copyright (C) 2025 The Qt Company Ltd.
++ // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
++
++ /*!
++ \example simpleruntimeloader
++ \ingroup quick3d-examples
++ \title Qt Quick 3D - Simple RuntimeLoader Example
++ \examplecategory {3D}
++ \brief Demonstrates loading a 3D asset at runtime and querying its scene objects.
++ \image simpleruntimeloader.jpg
++ {Side panel listing materials, cameras, and lights alongside a 3D scene}
++
++ This example shows how to use \l RuntimeLoader to load a 3D asset at runtime and
++ how to use \l {RuntimeLoader::queryAll}{query} functions to discover the materials,
++ cameras, and lights contained in the loaded scene.
++
++ \section1 Loading the Asset
++
++ The \l RuntimeLoader item loads a glTF 2.0 asset and creates the corresponding
++ Qt Quick 3D objects as its children. The \l {RuntimeLoader::source}{source} property
++ points at the asset file:
++
++ \snippet simpleruntimeloader/main.qml runtime-loader
++
++ Once the \l {RuntimeLoader::status}{status} changes to \c RuntimeLoader.Success the
++ scene is ready and the query functions can be called.
++
++ \section1 Querying Scene Objects
++
++ After a successful load, \l {RuntimeLoader::queryAll}{queryAll()} returns a list of
++ all scene objects that match a given \l {RuntimeLoader::QueryFilter}{QueryFilter}.
++ The example retrieves materials, cameras, and lights in one go:
++
++ \snippet simpleruntimeloader/main.qml queryAll
++
++ The returned lists are plain JavaScript arrays of \l QQuick3DObject references. They
++ can be assigned directly to a \l {ListView::model}{ListView model} or used to set
++ active scene properties such as \l {View3D::camera}{View3D.camera}.
++
++ \section1 Interacting with Scene Objects
++
++ \section2 Materials
++
++ Each entry in the material list can be selected to apply one of the colour swatches
++ to it. The helper function casts the returned object to the correct material type
++ before writing to the colour property:
++
++ \snippet simpleruntimeloader/main.qml query-function
++
++ \section2 Cameras
++
++ Clicking a camera entry in the side panel assigns it to \l {View3D::camera}{View3D.camera},
++ switching the active viewpoint immediately.
++
++ \section2 Lights
++
++ Each light in the side panel has a toggle that sets the light's
++ \l {Node::visible}{visible} property, enabling or disabling it without removing it
++ from the scene:
++
++ \badcode
++ Switch {
++ checked: modelData.visible
++ onToggled: modelData.visible = checked
++ }
++ \endcode
++ */