mirror of
https://github.com/godotengine/godot-docs.git
synced 2026-01-05 22:09:56 +03:00
122 lines
4.6 KiB
ReStructuredText
122 lines
4.6 KiB
ReStructuredText
.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
|
|
.. DO NOT EDIT THIS FILE, but the BakedLightmap.xml source instead.
|
|
.. The source is found in doc/classes or modules/<name>/doc_classes.
|
|
|
|
.. _class_BakedLightmap:
|
|
|
|
BakedLightmap
|
|
=============
|
|
|
|
**Inherits:** :ref:`VisualInstance<class_VisualInstance>` **<** :ref:`Spatial<class_Spatial>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
|
|
**Category:** Core
|
|
|
|
Brief Description
|
|
-----------------
|
|
|
|
Prerendered indirect light map for a scene.
|
|
|
|
Methods
|
|
-------
|
|
|
|
+-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`BakeError<enum_BakedLightmap_BakeError>` | :ref:`bake<class_BakedLightmap_bake>` **(** :ref:`Node<class_Node>` from_node=null, :ref:`bool<class_bool>` create_visual_debug=false **)** |
|
|
+-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`debug_bake<class_BakedLightmap_debug_bake>` **(** **)** |
|
|
+-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+
|
|
|
|
Enumerations
|
|
------------
|
|
|
|
.. _enum_BakedLightmap_BakeQuality:
|
|
|
|
enum **BakeQuality**
|
|
|
|
- **BAKE_QUALITY_LOW** = **0** --- Lowest bake quality mode. Fastest to calculate.
|
|
- **BAKE_QUALITY_MEDIUM** = **1** --- Default bake quality mode.
|
|
- **BAKE_QUALITY_HIGH** = **2** --- Highest bake quality mode. Takes longer to calculate.
|
|
|
|
.. _enum_BakedLightmap_BakeError:
|
|
|
|
enum **BakeError**
|
|
|
|
- **BAKE_ERROR_OK** = **0**
|
|
- **BAKE_ERROR_NO_SAVE_PATH** = **1**
|
|
- **BAKE_ERROR_NO_MESHES** = **2**
|
|
- **BAKE_ERROR_CANT_CREATE_IMAGE** = **3**
|
|
- **BAKE_ERROR_USER_ABORTED** = **4**
|
|
|
|
.. _enum_BakedLightmap_BakeMode:
|
|
|
|
enum **BakeMode**
|
|
|
|
- **BAKE_MODE_CONE_TRACE** = **0** --- Less precise but faster bake mode.
|
|
- **BAKE_MODE_RAY_TRACE** = **1** --- More precise bake mode but can take considerably longer to bake.
|
|
|
|
|
|
Description
|
|
-----------
|
|
|
|
Baked lightmaps are an alternative workflow for adding indirect (or baked) lighting to a scene. Unlike the :ref:`GIProbe<class_GIProbe>` approach, baked lightmaps work fine on low-end PCs and mobile devices as they consume almost no resources in run-time.
|
|
|
|
Tutorials
|
|
---------
|
|
|
|
- :doc:`../tutorials/3d/baked_lightmaps`
|
|
|
|
Property Descriptions
|
|
---------------------
|
|
|
|
.. _class_BakedLightmap_bake_cell_size:
|
|
|
|
- :ref:`float<class_float>` **bake_cell_size** - Grid subdivision size for lightmapper calculation. Default value of ``0.25`` will work for most cases. Increase for better lighting on small details or if your scene is very large.
|
|
|
|
.. _class_BakedLightmap_bake_energy:
|
|
|
|
- :ref:`float<class_float>` **bake_energy**
|
|
|
|
.. _class_BakedLightmap_bake_extents:
|
|
|
|
- :ref:`Vector3<class_Vector3>` **bake_extents** - Size of affected area.
|
|
|
|
.. _class_BakedLightmap_bake_hdr:
|
|
|
|
- :ref:`bool<class_bool>` **bake_hdr** - If ``true`` lightmap can capture light values greater than ``1.0``. Turning this off will result in a smaller lightmap. Default value:``false``.
|
|
|
|
.. _class_BakedLightmap_bake_mode:
|
|
|
|
- :ref:`BakeMode<enum_BakedLightmap_BakeMode>` **bake_mode** - Lightmapping mode. See :ref:`BakeMode<enum_@GlobalScope_BakeMode>`.
|
|
|
|
.. _class_BakedLightmap_bake_propagation:
|
|
|
|
- :ref:`float<class_float>` **bake_propagation**
|
|
|
|
.. _class_BakedLightmap_bake_quality:
|
|
|
|
- :ref:`BakeQuality<enum_BakedLightmap_BakeQuality>` **bake_quality** - Three quality modes are available. Higher quality requires more rendering time. See :ref:`BakeQuality<enum_@GlobalScope_BakeQuality>`.
|
|
|
|
.. _class_BakedLightmap_capture_cell_size:
|
|
|
|
- :ref:`float<class_float>` **capture_cell_size** - Grid size used for real-time capture information on dynamic objects. Cannot be larger than :ref:`bake_cell_size<class_BakedLightmap_bake_cell_size>`.
|
|
|
|
.. _class_BakedLightmap_image_path:
|
|
|
|
- :ref:`String<class_String>` **image_path** - Location where lightmaps will be saved.
|
|
|
|
.. _class_BakedLightmap_light_data:
|
|
|
|
- :ref:`BakedLightmapData<class_BakedLightmapData>` **light_data** - The calculated light data.
|
|
|
|
|
|
Method Descriptions
|
|
-------------------
|
|
|
|
.. _class_BakedLightmap_bake:
|
|
|
|
- :ref:`BakeError<enum_BakedLightmap_BakeError>` **bake** **(** :ref:`Node<class_Node>` from_node=null, :ref:`bool<class_bool>` create_visual_debug=false **)**
|
|
|
|
.. _class_BakedLightmap_debug_bake:
|
|
|
|
- void **debug_bake** **(** **)**
|
|
|
|
|