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

/*!
    \example picking
    \ingroup quick3d-examples
    \title Qt Quick 3D - Picking example
    \examplecategory {Data Visualization & 3D}
    \brief Demonstrates picking of models.

    This example demonstrates picking. There are 3 different animated models which can be picked.
    When a model is picked, the animation is stopped and the model color changed to make it clear
    which model got picked. Detailed information of the pick result is displayed on the top of
    the application window.

    \image picking-example.png

    \section1 Making Model Pickable

    To make a model pickable, the \l {Model::pickable}{pickable} property needs to be set to
    \c {true}. We also add \c objectName for the model to be able to display the name of the
    picked model.

    \snippet picking/main.qml pickable model

    The \c isPicked property was added to be used to toggle the animation and color.

    \snippet picking/main.qml picked color

    \dots

    \snippet picking/main.qml picked animation

    \section1 Getting Pick Results

    To do the actual picking we need to add a \l MouseArea to cover the entire \l View3D.

    \snippet picking/main.qml mouse area

    In the \c onClicked handler of the mouse area, we use the \l {View3D::pick}{pick} method to get
    the actual result of the pick.

    \snippet picking/main.qml pick result

    If the result has a \l {PickResult::objectHit}{target object}, we go through the
    specifics of the result, and display them in the text field at the top of the application
    view.

    \snippet picking/main.qml pick specifics

*/


