feedc0de/qt-creator
1
0
Fork 0
forked from qt-creator/qt-creator
Code Pull Requests Activity

Doc: Update info on baking lights

Browse Source 
Fixes: QDS-11174
Change-Id: I8f92c3cca0faaa3f4b1db11caa8825677c80121e
Reviewed-by: Miikka Heikkinen <miikka.heikkinen@qt.io>
Reviewed-by: Mats Honkamaa <mats.honkamaa@qt.io>
Reviewed-by: Qt CI Patch Build Bot <ci_patchbuild_bot@qt.io>
This commit is contained in:
Johanna Vanhatapio
2023-12-07 16:56:06 +02:00
parent d6bc19e54d
commit 4d042e5b7d
3 changed files with 43 additions and 26 deletions
Download Patch File Download Diff File Expand all files Collapse all files

BIN
doc/qtdesignstudio/images/icons/bakelights.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 502 B

7
doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-editor.qdoc
View File

@@ -153,6 +153,13 @@
For more information about the available scene light types and their For more information about the available scene light types and their
properties, see \l{Lights}. properties, see \l{Lights}.
\section1 Baking Lights
Bake lights to light static elements in your scene. To bake lights,
select \inlineimage icons/bakelights.png to open the
\uicontrol {Lights Baking Setup} dialog. For more information, see
\l {Baking Lightmaps}.
\section1 Selecting Components \section1 Selecting Components
To move, rotate, or scale components in the scene, you need to select them To move, rotate, or scale components in the scene, you need to select them

62
doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-lights.qdoc
View File

@@ -213,10 +213,11 @@
\note Lightmaps baking is released as technical preview in \QDS 4.1. \note Lightmaps baking is released as technical preview in \QDS 4.1.
Baked lightmaps allow pre-generating the direct lighting from lights such as DirectionalLight, Baked lightmaps allow pre-generating the direct lighting from lights,
PointLight, and SpotLight, including the shadows cast by the lights. At run time, instead of such as DirectionalLight, PointLight, and SpotLight, including the shadows
performing the appropriate calculations in the fragment shader, and, in case of shadows, cast by the lights. At run time, instead of performing the appropriate
generating the potentially costly shadow maps in real time, the pre-generated light map is calculations in the fragment shader, and, in case of shadows, generating
the potentially costly shadow maps in real time, the pre-generated light map is
sampled instead. sampled instead.
\section2 Baking Lightmaps \section2 Baking Lightmaps
@@ -224,47 +225,56 @@
To bake lightmaps for models in your 3D scene: To bake lightmaps for models in your 3D scene:
\list 1 \list 1
\li Right-click anywhere in the \uicontrol 3D view and select \uicontrol {Bake Lights}. \li Select \inlineimage icons/bakelights.png in the \uicontrol 3D view
\li In the \uicontrol {Lights Baking Setup} dialog: toolbar or right-click anywhere in the \uicontrol 3D view and select
\uicontrol {Bake Lights} to open the \uicontrol {Lights Baking Setup}
dialog to define settings for baking lights.
\li Set \uicontrol {Bake Mode} for each light source:
\list \list
\li For every light you want to use to bake lightmaps, set \uicontrol {Bake Mode} to BakeModeAll. \li To bake both direct (diffuse and shadow) and indirect lighting,
\li For every 3D model you want to bake lightmaps, select \uicontrol {In Use} and select \uicontrol {Bake All}.
\uicontrol {Enabled}, and set the desired \uicontrol {Resolution}. \li To bake only indirect lighting, select \uicontrol {Bake Indirect}.
\li To not include a light source in the baking of lights, select
\uicontrol {Baking Disabled}.
\endlist \endlist
\li Optional. If you have components with unexposed models or lights (for example, imported \li For every 3D model you want to bake into a lightmap, select
3D models created in other software), select \uicontrol {Expose models and lights} to add the \uicontrol {In Use} and \uicontrol {Enabled}, and set the desired
models and light of that component to the \uicontrol Models and \uicontrol Lights sections of \uicontrol {Resolution}.
the dialog. \li Optional. If you have components with unexposed models or lights
(for example, imported 3D models created in other software), select
\uicontrol {Expose models and lights} to add the models and light of
that component to the \uicontrol Models and \uicontrol Lights sections
of the dialog.
\li Select \uicontrol Bake. \li Select \uicontrol Bake.
\endlist \endlist
\image bake-lights-dialog.png \image bake-lights-dialog.png
\section2 Manually Baking Lightmaps for a 3D Model \section2 Manually Baking Lightmaps for a 3D Model
Baked lightmap components are not visible in the \uicontrol Navigator view by default. To make \note Baked lightmap components are not visible in the \uicontrol Navigator view by
them visible, select \inlineimage icons/visibilityon.png default. To make them visible, select \inlineimage icons/visibilityon.png
in the \uicontrol Navigator view. in the \uicontrol Navigator view.
To bake lightmaps for a 3D model: To bake lightmaps for a 3D model:
\list 1 \list 1
\li From \uicontrol Components, drag a \uicontrol {Baked Lightmap} component to \li From \uicontrol Components, drag a \uicontrol {Baked Lightmap} component
the 3D model in the \uicontrol Navigator view. to the 3D model in the \uicontrol Navigator view.
\image baked-lightmaps-navigator.png \image baked-lightmaps-navigator.png
\li In the \uicontrol Navigator view, select \e bakedLightmap and in the \uicontrol Properties \li In the \uicontrol Navigator view, select \e bakedLightmap, and in the
view: \uicontrol Properties view:
\list \list
\li Select \uicontrol Enabled. \li Select \uicontrol Enabled.
\li In \uicontrol Key, set the filename base for the generated light maps. This must be \li In \uicontrol Key, set the filename base for the generated light maps.
a unique name. This must be a unique name.
\li In \uicontrol {Load Prefix}, set the relative path to the folder where the generated \li In \uicontrol {Load Prefix}, set the relative path to the folder where
light map files are saved. the generated light map files are saved.
\endlist \endlist
\li In the \uicontrol Navigator view, select the 3D model and in the \uicontrol Properties \li In the \uicontrol Navigator view, select the 3D model and in the \uicontrol Properties
view, select \uicontrol {Used in Baked Lighting}. view, select \uicontrol {Used in Baked Lighting}.
\li Optional. Adjust \uicontrol Resolution to set the light map resoution. This effects how \li Optional. Adjust \uicontrol Resolution to set the light map resoution. This effects how
accurate and time-consuming the lightmap baking is. accurate and time-consuming the lightmap baking is.
\li In the \uicontrol Navigator view, select the light component that you want to bake \li In the \uicontrol Navigator view, select the light component that you want to bake
lightmaps for, and in the \uicontrol Properties view, set \uicontrol {Bake Mode} to BakeModeAll. lightmaps for, and in the \uicontrol Properties view, set \uicontrol {Bake Mode} to BakeModeAll.
\li Right-click anywhere in the \uicontrol 3D view and select \uicontrol {Bake Lights}. \li Right-click anywhere in the \uicontrol 3D view and select \uicontrol {Bake Lights}.
\li Select \uicontrol {Setup baking manually}, and then select \uicontrol Bake. \li Select \uicontrol {Setup baking manually}, and then select \uicontrol Bake.
\endlist \endlist