fc749f7f8b
This adds information about performance and procedural generation.
(cherry picked from commit 194d45f11d)
150 lines
11 KiB
XML
150 lines
11 KiB
XML
<?xml version="1.0" encoding="UTF-8" ?>
|
|
<class name="BakedLightmap" inherits="VisualInstance" version="3.4">
|
|
<brief_description>
|
|
Prerendered indirect light map for a scene.
|
|
</brief_description>
|
|
<description>
|
|
Baked lightmaps are an alternative workflow for adding indirect (or baked) lighting to a scene. Unlike the [GIProbe] approach, baked lightmaps work fine on low-end PCs and mobile devices as they consume almost no resources in run-time.
|
|
[b]Procedural generation:[/b] Lightmap baking functionality is only available in the editor. This means [BakedLightmap] is not suited to procedurally generated or user-built levels. For procedurally generated or user-built levels, use [GIProbe] instead.
|
|
[b]Note:[/b] Due to how lightmaps work, most properties only have a visible effect once lightmaps are baked again.
|
|
</description>
|
|
<tutorials>
|
|
<link>https://docs.godotengine.org/en/3.4/tutorials/3d/baked_lightmaps.html</link>
|
|
</tutorials>
|
|
<methods>
|
|
<method name="bake">
|
|
<return type="int" enum="BakedLightmap.BakeError" />
|
|
<argument index="0" name="from_node" type="Node" default="null" />
|
|
<argument index="1" name="data_save_path" type="String" default="""" />
|
|
<description>
|
|
Bakes the lightmap, scanning from the given [code]from_node[/code] root and saves the resulting [BakedLightmapData] in [code]data_save_path[/code]. If no root node is provided, parent of this node will be used as root instead. If no save path is provided it will try to match the path from the current [member light_data].
|
|
</description>
|
|
</method>
|
|
</methods>
|
|
<members>
|
|
<member name="atlas_generate" type="bool" setter="set_generate_atlas" getter="is_generate_atlas_enabled" default="true">
|
|
When enabled, the lightmapper will merge the textures for all meshes into a single large layered texture. Not supported in GLES2.
|
|
</member>
|
|
<member name="atlas_max_size" type="int" setter="set_max_atlas_size" getter="get_max_atlas_size" default="4096">
|
|
Maximum size of each lightmap layer, only used when [member atlas_generate] is enabled.
|
|
</member>
|
|
<member name="bias" type="float" setter="set_bias" getter="get_bias" default="0.005">
|
|
Raycasting bias used during baking to avoid floating point precision issues.
|
|
</member>
|
|
<member name="bounce_indirect_energy" type="float" setter="set_bounce_indirect_energy" getter="get_bounce_indirect_energy" default="1.0">
|
|
The energy multiplier for each bounce. Higher values will make indirect lighting brighter. A value of [code]1.0[/code] represents physically accurate behavior, but higher values can be used to make indirect lighting propagate more visibly when using a low number of bounces. This can be used to speed up bake times by lowering the number of [member bounces] then increasing [member bounce_indirect_energy]. Unlike [member BakedLightmapData.energy], this property does not affect direct lighting emitted by light nodes, emissive materials and the environment.
|
|
[b]Note:[/b] [member bounce_indirect_energy] only has an effect if [member bounces] is set to a value greater than or equal to [code]1[/code].
|
|
</member>
|
|
<member name="bounces" type="int" setter="set_bounces" getter="get_bounces" default="3">
|
|
Number of light bounces that are taken into account during baking. See also [member bounce_indirect_energy].
|
|
</member>
|
|
<member name="capture_cell_size" type="float" setter="set_capture_cell_size" getter="get_capture_cell_size" default="0.5">
|
|
Grid size used for real-time capture information on dynamic objects.
|
|
</member>
|
|
<member name="capture_enabled" type="bool" setter="set_capture_enabled" getter="get_capture_enabled" default="true">
|
|
When enabled, an octree containing the scene's lighting information will be computed. This octree will then be used to light dynamic objects in the scene.
|
|
</member>
|
|
<member name="capture_propagation" type="float" setter="set_capture_propagation" getter="get_capture_propagation" default="1.0">
|
|
Bias value to reduce the amount of light proagation in the captured octree.
|
|
</member>
|
|
<member name="capture_quality" type="int" setter="set_capture_quality" getter="get_capture_quality" enum="BakedLightmap.BakeQuality" default="1">
|
|
Bake quality of the capture data.
|
|
</member>
|
|
<member name="default_texels_per_unit" type="float" setter="set_default_texels_per_unit" getter="get_default_texels_per_unit" default="16.0">
|
|
If a baked mesh doesn't have a UV2 size hint, this value will be used to roughly compute a suitable lightmap size.
|
|
</member>
|
|
<member name="environment_custom_color" type="Color" setter="set_environment_custom_color" getter="get_environment_custom_color">
|
|
The environment color when [member environment_mode] is set to [constant ENVIRONMENT_MODE_CUSTOM_COLOR].
|
|
</member>
|
|
<member name="environment_custom_energy" type="float" setter="set_environment_custom_energy" getter="get_environment_custom_energy">
|
|
The energy scaling factor when when [member environment_mode] is set to [constant ENVIRONMENT_MODE_CUSTOM_COLOR] or [constant ENVIRONMENT_MODE_CUSTOM_SKY].
|
|
</member>
|
|
<member name="environment_custom_sky" type="Sky" setter="set_environment_custom_sky" getter="get_environment_custom_sky">
|
|
The [Sky] resource to use when [member environment_mode] is set o [constant ENVIRONMENT_MODE_CUSTOM_SKY].
|
|
</member>
|
|
<member name="environment_custom_sky_rotation_degrees" type="Vector3" setter="set_environment_custom_sky_rotation_degrees" getter="get_environment_custom_sky_rotation_degrees">
|
|
The rotation of the baked custom sky.
|
|
</member>
|
|
<member name="environment_min_light" type="Color" setter="set_environment_min_light" getter="get_environment_min_light" default="Color( 0, 0, 0, 1 )">
|
|
Minimum ambient light for all the lightmap texels. This doesn't take into account any occlusion from the scene's geometry, it simply ensures a minimum amount of light on all the lightmap texels. Can be used for artistic control on shadow color.
|
|
</member>
|
|
<member name="environment_mode" type="int" setter="set_environment_mode" getter="get_environment_mode" enum="BakedLightmap.EnvironmentMode" default="0">
|
|
Decides which environment to use during baking.
|
|
</member>
|
|
<member name="extents" type="Vector3" setter="set_extents" getter="get_extents" default="Vector3( 10, 10, 10 )">
|
|
Size of the baked lightmap. Only meshes inside this region will be included in the baked lightmap, also used as the bounds of the captured region for dynamic lighting.
|
|
</member>
|
|
<member name="image_path" type="String" setter="set_image_path" getter="get_image_path">
|
|
Deprecated, in previous versions it determined the location where lightmaps were be saved.
|
|
</member>
|
|
<member name="light_data" type="BakedLightmapData" setter="set_light_data" getter="get_light_data">
|
|
The calculated light data.
|
|
</member>
|
|
<member name="quality" type="int" setter="set_bake_quality" getter="get_bake_quality" enum="BakedLightmap.BakeQuality" default="1">
|
|
Determines the amount of samples per texel used in indrect light baking. The amount of samples for each quality level can be configured in the project settings.
|
|
</member>
|
|
<member name="use_color" type="bool" setter="set_use_color" getter="is_using_color" default="true">
|
|
Store full color values in the lightmap textures. When disabled, lightmap textures will store a single brightness channel. Can be disabled to reduce disk usage if the scene contains only white lights or you don't mind losing color information in indirect lighting.
|
|
</member>
|
|
<member name="use_denoiser" type="bool" setter="set_use_denoiser" getter="is_using_denoiser" default="true">
|
|
When enabled, a lightmap denoiser will be used to reduce the noise inherent to Monte Carlo based global illumination.
|
|
</member>
|
|
<member name="use_hdr" type="bool" setter="set_use_hdr" getter="is_using_hdr" default="true">
|
|
If [code]true[/code], stores the lightmap textures in a high dynamic range format (EXR). If [code]false[/code], stores the lightmap texture in a low dynamic range PNG image. This can be set to [code]false[/code] to reduce disk usage, but light values over 1.0 will be clamped and you may see banding caused by the reduced precision.
|
|
[b]Note:[/b] Setting [member use_hdr] to [code]true[/code] will decrease lightmap banding even when using the GLES2 backend or if [member ProjectSettings.rendering/quality/depth/hdr] is [code]false[/code].
|
|
</member>
|
|
</members>
|
|
<constants>
|
|
<constant name="BAKE_QUALITY_LOW" value="0" enum="BakeQuality">
|
|
The lowest bake quality mode. Fastest to calculate.
|
|
</constant>
|
|
<constant name="BAKE_QUALITY_MEDIUM" value="1" enum="BakeQuality">
|
|
The default bake quality mode.
|
|
</constant>
|
|
<constant name="BAKE_QUALITY_HIGH" value="2" enum="BakeQuality">
|
|
A higher bake quality mode. Takes longer to calculate.
|
|
</constant>
|
|
<constant name="BAKE_QUALITY_ULTRA" value="3" enum="BakeQuality">
|
|
The highest bake quality mode. Takes the longest to calculate.
|
|
</constant>
|
|
<constant name="BAKE_ERROR_OK" value="0" enum="BakeError">
|
|
Baking was successful.
|
|
</constant>
|
|
<constant name="BAKE_ERROR_NO_SAVE_PATH" value="1" enum="BakeError">
|
|
Returns if no viable save path is found. This can happen where an [member image_path] is not specified or when the save location is invalid.
|
|
</constant>
|
|
<constant name="BAKE_ERROR_NO_MESHES" value="2" enum="BakeError">
|
|
Currently unused.
|
|
</constant>
|
|
<constant name="BAKE_ERROR_CANT_CREATE_IMAGE" value="3" enum="BakeError">
|
|
Returns when the baker cannot save per-mesh textures to file.
|
|
</constant>
|
|
<constant name="BAKE_ERROR_LIGHTMAP_SIZE" value="4" enum="BakeError">
|
|
The size of the generated lightmaps is too large.
|
|
</constant>
|
|
<constant name="BAKE_ERROR_INVALID_MESH" value="5" enum="BakeError">
|
|
Some mesh contains UV2 values outside the [code][0,1][/code] range.
|
|
</constant>
|
|
<constant name="BAKE_ERROR_USER_ABORTED" value="6" enum="BakeError">
|
|
Returns if user cancels baking.
|
|
</constant>
|
|
<constant name="BAKE_ERROR_NO_LIGHTMAPPER" value="7" enum="BakeError">
|
|
Returns if lightmapper can't be created. Unless you are using a custom lightmapper, please report this as bug.
|
|
</constant>
|
|
<constant name="BAKE_ERROR_NO_ROOT" value="8" enum="BakeError">
|
|
There is no root node to start baking from. Either provide [code]from_node[/code] argument or attach this node to a parent that should be used as root.
|
|
</constant>
|
|
<constant name="ENVIRONMENT_MODE_DISABLED" value="0" enum="EnvironmentMode">
|
|
No environment is used during baking.
|
|
</constant>
|
|
<constant name="ENVIRONMENT_MODE_SCENE" value="1" enum="EnvironmentMode">
|
|
The baked environment is automatically picked from the current scene.
|
|
</constant>
|
|
<constant name="ENVIRONMENT_MODE_CUSTOM_SKY" value="2" enum="EnvironmentMode">
|
|
A custom sky is used as environment during baking.
|
|
</constant>
|
|
<constant name="ENVIRONMENT_MODE_CUSTOM_COLOR" value="3" enum="EnvironmentMode">
|
|
A custom solid color is used as environment during baking.
|
|
</constant>
|
|
</constants>
|
|
</class>
|