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

/*!
    \page studio-importing-3d.html

    \previouspage qtquick-fonts.html
    \nextpage creator-exporting-qml.html

    \title Importing 3D assets

    In \QDS, you can import 3D assets in formats such as .stl, .dae, .fbx, .glb,
    .gltf, .obj, .uia, and .uip. For a list of formats supported by each
    \l{Qt Quick 3D} version, see the module documentation.

    During the import, you can optimize the files for \QDS. You can remove
    components from meshes to reduce the cache size, find and fix issues in
    the files, optimize graphs and meshes, and so on. The available options
    depend on whether you are importing files that you created with Qt 3D Studio
    or with other 3D graphics tools. See the tooltips in the options dialog
    for more information about a particular option.

    For more information about exporting 3D graphics, see
    \l{Exporting 3D assets}.

    \image studio-import-3d.webp

    \section1 Importing a 3D asset

    To import a 3D asset to a \QDS project:

    \list 1
        \li Open the import dialog in one of the following methods:
            \list
                \li Select \l Assets > \imageplus, select the file you
                    want to import, and click \uicontrol Open.
                \li Drag the 3D asset to the \uicontrol 3D view. In this case, the 3D asset will be
                    added to your scene, so it will appear in the \uicontrol 3D and
                    \uicontrol Navigator views.
            \endlist
        \li Select \uicontrol Accept to import the 3D asset.
    \endlist

    Additionally, you can define options for importing the file in the \uicontrol {3D Scene Options}
    tab. To preview the 3D asset before importing it, rotate the preview image by dragging it.
    Select \uicontrol Import to generate the 3D asset with the updated settings, and then select
    \uicontrol Accept to close the import dialog.

    \note To see all options, select \uicontrol {Show All Options}.

    After importing the 3D asset, it is available in \uicontrol Components > \uicontrol
    {My 3D Components}.

    \section1 Importing multiple 3D assets

    To import multiple 3D assets to a \QDS project:

    \list 1
        \li Open the import dialog in one of the following methods:
            \list
                \li Select \uicontrol Assets > \imageplus, select the files you
                    want to import, and click \uicontrol Open.
                \li Select the 3D asset files and drag them to the \uicontrol 3D view. In this
                    case, the 3D assets will be added to your scene, so they will appear in the
                    \uicontrol 3D and \uicontrol Navigator views.
            \endlist
        \li Select \uicontrol Accept to import the 3D assets.
    \endlist

    Additionally, you can define options for importing the files in the \uicontrol
    {3D Scene Options} tab by selecting the asset you want to edit from the \uicontrol
    {Imported objects} list. To preview the 3D asset before importing it, rotate the preview image
    by dragging it. Select \uicontrol Import to generate the 3D asset with the updated settings,
    and then select \uicontrol Accept to close the import dialog.

    \note To see all options, select \uicontrol {Show All Options}.

    After importing the 3D assets, they are available in \uicontrol {Components} > \uicontrol
    {My 3D Components}.

*/
