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
|
||||
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
|
||||
|
||||
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.
|
||||
|
||||
Baked lightmaps allow pre-generating the direct lighting from lights such as DirectionalLight,
|
||||
PointLight, and SpotLight, including the shadows cast by the lights. At run time, instead of
|
||||
performing the appropriate 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
|
||||
Baked lightmaps allow pre-generating the direct lighting from lights,
|
||||
such as DirectionalLight, PointLight, and SpotLight, including the shadows
|
||||
cast by the lights. At run time, instead of performing the appropriate
|
||||
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.
|
||||
|
||||
\section2 Baking Lightmaps
|
||||
@@ -224,40 +225,49 @@
|
||||
To bake lightmaps for models in your 3D scene:
|
||||
|
||||
\list 1
|
||||
\li Right-click anywhere in the \uicontrol 3D view and select \uicontrol {Bake Lights}.
|
||||
\li In the \uicontrol {Lights Baking Setup} dialog:
|
||||
\li Select \inlineimage icons/bakelights.png in the \uicontrol 3D view
|
||||
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
|
||||
\li For every light you want to use to bake lightmaps, set \uicontrol {Bake Mode} to BakeModeAll.
|
||||
\li For every 3D model you want to bake lightmaps, select \uicontrol {In Use} and
|
||||
\uicontrol {Enabled}, and set the desired \uicontrol {Resolution}.
|
||||
\li To bake both direct (diffuse and shadow) and indirect lighting,
|
||||
select \uicontrol {Bake All}.
|
||||
\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
|
||||
\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 For every 3D model you want to bake into a lightmap, select
|
||||
\uicontrol {In Use} and \uicontrol {Enabled}, and set the desired
|
||||
\uicontrol {Resolution}.
|
||||
\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.
|
||||
\endlist
|
||||
|
||||
\image bake-lights-dialog.png
|
||||
|
||||
\section2 Manually Baking Lightmaps for a 3D Model
|
||||
Baked lightmap components are not visible in the \uicontrol Navigator view by default. To make
|
||||
them visible, select \inlineimage icons/visibilityon.png
|
||||
\note Baked lightmap components are not visible in the \uicontrol Navigator view by
|
||||
default. To make them visible, select \inlineimage icons/visibilityon.png
|
||||
in the \uicontrol Navigator view.
|
||||
|
||||
To bake lightmaps for a 3D model:
|
||||
\list 1
|
||||
\li From \uicontrol Components, drag a \uicontrol {Baked Lightmap} component to
|
||||
the 3D model in the \uicontrol Navigator view.
|
||||
\li From \uicontrol Components, drag a \uicontrol {Baked Lightmap} component
|
||||
to the 3D model in the \uicontrol Navigator view.
|
||||
\image baked-lightmaps-navigator.png
|
||||
\li In the \uicontrol Navigator view, select \e bakedLightmap and in the \uicontrol Properties
|
||||
view:
|
||||
\li In the \uicontrol Navigator view, select \e bakedLightmap, and in the
|
||||
\uicontrol Properties view:
|
||||
\list
|
||||
\li Select \uicontrol Enabled.
|
||||
\li In \uicontrol Key, set the filename base for the generated light maps. This must be
|
||||
a unique name.
|
||||
\li In \uicontrol {Load Prefix}, set the relative path to the folder where the generated
|
||||
light map files are saved.
|
||||
\li In \uicontrol Key, set the filename base for the generated light maps.
|
||||
This must be a unique name.
|
||||
\li In \uicontrol {Load Prefix}, set the relative path to the folder where
|
||||
the generated light map files are saved.
|
||||
\endlist
|
||||
\li In the \uicontrol Navigator view, select the 3D model and in the \uicontrol Properties
|
||||
view, select \uicontrol {Used in Baked Lighting}.
|
||||
|
Reference in New Issue
Block a user