Doc: Document the 3D asset importer improvements

Added information about the new features and reorganized a bit.

Fixes: QDS-12818
Change-Id: I53049eb5959d1af36e83ef6f2ab8ebe2acff876a
Reviewed-by: Johanna Vanhatapio <johanna.vanhatapio@qt.io>
Reviewed-by: Miikka Heikkinen <miikka.heikkinen@qt.io>
This commit is contained in:
Teea Poldsam
2024-06-12 09:36:40 +03:00
committed by Teea Põldsam
parent dabe235fba
commit 0d35eaced7
3 changed files with 42 additions and 25 deletions

Binary file not shown.

Before

Width:  |  Height:  |  Size: 36 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 19 KiB

View File

@@ -1,4 +1,4 @@
// Copyright (C) 2021 The Qt Company Ltd. // Copyright (C) 2024 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
/*! /*!
@@ -23,42 +23,59 @@
For more information about exporting 3D graphics, see For more information about exporting 3D graphics, see
\l{Exporting 3D Assets}. \l{Exporting 3D Assets}.
\image studio-import-3d.png \image studio-import-3d.webp
\section1 Importing a 3D Asset \section1 Importing a 3D Asset
To import a 3D asset to a \QDS project: To import a 3D asset to a \QDS project:
\list 1 \list 1
\li Drag-and-drop an external file containing the 3D asset from, \li Open the import dialog in one of the following methods:
for example, File Explorer (on Windows), to the \uicontrol{3D} view. \list
\li In the \uicontrol {3D Scene Options} tab, select options for \li Select \l Assets > \inlineimage icons/plus.png, select the file you
importing the file. want to import, and click \uicontrol Open.
\note To see all options, select \uicontrol{Show All Options}. \li Drag the 3D asset to the \uicontrol 3D view. In this case, the 3D asset will be
\li Select \uicontrol Import to import the 3D asset. 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 \endlist
The 3D asset is now added to your scene, and you can see it in the Additionally, you can define options for importing the file in the \uicontrol {3D Scene Options}
\uicontrol{3D} and \uicontrol Navigator views. It is also tab. To preview the 3D asset before importing it, rotate the preview image by dragging it.
available in \uicontrol Components > \uicontrol {My 3D Components}. Select \uicontrol Import to generate the 3D asset with the updated settings, and then select
\uicontrol Accept to close the import dialog.
Alternatively, you can initiate the import dialog from the \note To see all options, select \uicontrol {Show All Options}.
\uicontrol Assets view:
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 \list 1
\li Select \l Assets > \inlineimage icons/plus.png \li Open the import dialog in one of the following methods:
. \list
\li Select \uicontrol {3D Assets} in the dropdown menu to filter 3D \li Select \uicontrol Assets > \inlineimage icons/plus.png, select the files you
graphics files. want to import, and click \uicontrol Open.
\li Select a file to import, and then select \uicontrol Open. \li Select the 3D asset files and drag them to the \uicontrol 3D view. In this
\li In the \uicontrol {3D Scene Options} tab, select options for case, the 3D assets will be added to your scene, so they will appear in the
importing the file. \uicontrol 3D and \uicontrol Navigator views.
\note To see all options, select \uicontrol{Show All Options}. \endlist
\li Select \uicontrol Import to import the 3D asset. \li Select \uicontrol Accept to import the 3D assets.
\endlist \endlist
The 3D asset now appears in \uicontrol Components > Additionally, you can define options for importing the files in the \uicontrol
\uicontrol {My 3D Components}. You can add it to the scene by {3D Scene Options} tab by selecting the asset you want to edit from the \uicontrol
drag-and-dropping it to the \uicontrol{3D} view. {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}.
*/ */