// Copyright (C) 2023 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only

/*!
    \title Car Configurator
    \ingroup qtquickdemos
    \example demos/car-configurator
    \brief A car model example that demonstrates using \l{Qt Quick 3D} cameras,
    extended scene environment and Qt Quick 3D.
    \examplecategory {Application Examples}
    \meta {tag} {quick, 3d, camera}
    \meta {docdependencies} {QtQuick3D}
    \image car_configurator_overview.png
           {3D side-angle view of a black sports car against a desert backdrop}

    \e{Car Configurator} shows a car in different scene environments and in
    different colors. It's implemented with QML and relies on a number of Qt
    modules, most prominently \l{Qt Quick} and \l{Qt Quick 3D}.

    \include examples-run.qdocinc

    \section1 Platform notes

    This example does download some assets from an internet server at
    runtime. Therefore, you will need an internet connection when launching it
    for the first time.

    You can interact with the car model in
    two modes:

    \list
        \li Demo mode
        \li User mode
    \endlist

    \section1 Demo mode

    The camera perspective moves along different paths and shows different
    views of the car.

    \section1 User mode

    Users can rotate around the car using a mouse or touch input.

    \section1 Reset Camera
    The camera moves to its initial position.

    \section1 Scene environments
    There are four scene environments available for this example:

    \list
        \li Garage
        \li Desert
        \li Animated
        \li Studio
    \endlist

    \section2 Garage Environment

    The garage environment serves as the default setting and provides a clean, industrial presentation space:

    \snippet  demos/car-configurator/content/ScreenPrimary.qml  Showhall Scene Environment

    \section2 Desert Environment

    The desert environment features HDR sky dome lighting, atmospheric fog effects, and specialized ground geometry:

    \snippet demos/car-configurator/content/ScreenPrimary.qml Desert Scene Environment

    \section2 Animated Environment

    The animated environment showcases dynamic content with video wall effects:

    \snippet demos/car-configurator/content/ScreenPrimary.qml Videoroom Scene Environment

    \section2 Studio Environment

    The studio environment provides a clean, professional presentation setting with controlled lighting:

    \snippet demos/car-configurator/content/ScreenPrimary.qml Studio Scene Environment

    \section1 Car Colors
    There are four colors available for the car:

    \list
        \li White
        \li Black
        \li Yellow
        \li Red
    \endlist

    \section1 Lights
    You can turn the lights of the car on and off.

    \section1 Source files

    \sa {All Qt examples}
*/
