1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
|
// Copyright (C) 2022 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only
#include "qquick3dbakedlightmap_p.h"
QT_BEGIN_NAMESPACE
/*!
\qmltype BakedLightmap
\inherits QtObject
\inqmlmodule QtQuick3D
\brief Specifies baked lightmap settings for a model.
\since 6.4
A BakedLightmap object can be used to enable:
\list
\li persistently storing the baked lightmap data - during baking, or
\li loading the previously generated and stored lightmaps - at run time.
\endlist
A Model with \l{Model::usedInBakedLighting}{usedInBakedLighting} set to
true is considered to be part of the raytraced scene when baking lightmaps,
meaning the model's geometry and material contribute to direct and indirect
lighting. This on its own does not however enable generating, including
full calculation of bounced indirect lighting, and finally saving a
lightmap for the model. To do that, the model also needs to be associated
with an \l enabled BakedLightmap object with a unique key set.
When running in normal mode, the same BakedLightmap object indicates that
the Model has lightmap data, and that the engine should attempt to load
this data (based on the unique key) and use it when rendering.
For more information on how to bake lightmaps, see the \l Lightmapper
documentation.
\note As of Qt 6.4, lightmap baking is in an early technical preview state.
Changes to features, quality, and API are likely happen in future releases.
\sa Lightmapper, Model::usedInBakedLighting
*/
/*!
\qmlproperty bool BakedLightmap::enabled
When false, the lightmap generated for the model is not stored during
lightmap baking, even though \l key is set to a non-empty value.
The default value is true.
*/
/*!
\qmlproperty string BakedLightmap::key
When non-empty and \l enabled is true, the lightmap generated for the model
is stored persistently during lightmap baking. The value should be a unique
string that is fit to be included in the name of a file in the filesystem.
No other Model in the scene must use the same key.
The default value is empty.
\sa loadPrefix
*/
/*!
\qmlproperty string BakedLightmap::loadPrefix
When non-empty, the value is prepended as a path to the value of \l key
when loading the lightmap for the Model. This allows shipping the generated
lightmaps in different location than they were written to, for example as
embedded resources via the Qt resource system.
For example, the following enables lightmap generation for a static model,
using a unique key for identifying the lightmap data between baking and
real runs of the application. Once baking is performed, the generated file
can be listed in the application's CMake project as a resource under the
\c{/lightmaps} PREFIX, letting the build process pick up the file and
include it in the executable.
\qml
Model {
source: "model.mesh"
y: 10
bakedLightmap: BakedLightmap {
key: "model34156"
loadPrefix: "qrc:/lightmaps"
// will attempt to load from :/lightmaps/qlm_model34156.exr at run time
}
}
\endqml
The default value is empty.
\sa key
*/
bool QQuick3DBakedLightmap::isEnabled() const
{
return m_enabled;
}
void QQuick3DBakedLightmap::setEnabled(bool enabled)
{
if (m_enabled == enabled)
return;
m_enabled = enabled;
emit enabledChanged();
emit changed();
}
QString QQuick3DBakedLightmap::key() const
{
return m_key;
}
void QQuick3DBakedLightmap::setKey(const QString &key)
{
if (m_key == key)
return;
m_key = key;
emit keyChanged();
emit changed();
}
QString QQuick3DBakedLightmap::loadPrefix() const
{
return m_loadPrefix;
}
void QQuick3DBakedLightmap::setLoadPrefix(const QString &loadPrefix)
{
if (m_loadPrefix == loadPrefix)
return;
m_loadPrefix = loadPrefix;
emit loadPrefixChanged();
emit changed();
}
QT_END_NAMESPACE
|
