forked from qt-creator/qt-creator
Doc: Update info on baking lights
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:
BIN
doc/qtdesignstudio/images/icons/bakelights.png
Normal file
BIN
doc/qtdesignstudio/images/icons/bakelights.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 502 B |
@@ -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
|
||||||
|
@@ -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,40 +225,49 @@
|
|||||||
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}.
|
||||||
|
Reference in New Issue
Block a user