BakedLightmap.xml 3.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990
  1. <?xml version="1.0" encoding="UTF-8" ?>
  2. <class name="BakedLightmap" inherits="VisualInstance" category="Core" version="3.1">
  3. <brief_description>
  4. Prerendered indirect light map for a scene.
  5. </brief_description>
  6. <description>
  7. 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.
  8. </description>
  9. <tutorials>
  10. <link>https://docs.godotengine.org/en/latest/tutorials/3d/baked_lightmaps.html</link>
  11. </tutorials>
  12. <demos>
  13. </demos>
  14. <methods>
  15. <method name="bake">
  16. <return type="int" enum="BakedLightmap.BakeError">
  17. </return>
  18. <argument index="0" name="from_node" type="Node" default="null">
  19. </argument>
  20. <argument index="1" name="create_visual_debug" type="bool" default="false">
  21. </argument>
  22. <description>
  23. </description>
  24. </method>
  25. <method name="debug_bake">
  26. <return type="void">
  27. </return>
  28. <description>
  29. </description>
  30. </method>
  31. </methods>
  32. <members>
  33. <member name="bake_cell_size" type="float" setter="set_bake_cell_size" getter="get_bake_cell_size">
  34. Grid subdivision size for lightmapper calculation. Default value of [code]0.25[/code] will work for most cases. Increase for better lighting on small details or if your scene is very large.
  35. </member>
  36. <member name="bake_energy" type="float" setter="set_energy" getter="get_energy">
  37. </member>
  38. <member name="bake_extents" type="Vector3" setter="set_extents" getter="get_extents">
  39. Size of affected area.
  40. </member>
  41. <member name="bake_hdr" type="bool" setter="set_hdr" getter="is_hdr">
  42. If [code]true[/code], lightmap can capture light values greater than [code]1.0[/code]. Turning this off will result in a smaller lightmap. Default value:[code]false[/code].
  43. </member>
  44. <member name="bake_mode" type="int" setter="set_bake_mode" getter="get_bake_mode" enum="BakedLightmap.BakeMode">
  45. Lightmapping mode. See [enum BakeMode].
  46. </member>
  47. <member name="bake_propagation" type="float" setter="set_propagation" getter="get_propagation">
  48. </member>
  49. <member name="bake_quality" type="int" setter="set_bake_quality" getter="get_bake_quality" enum="BakedLightmap.BakeQuality">
  50. Three quality modes are available. Higher quality requires more rendering time. See [enum BakeQuality].
  51. </member>
  52. <member name="capture_cell_size" type="float" setter="set_capture_cell_size" getter="get_capture_cell_size">
  53. Grid size used for real-time capture information on dynamic objects. Cannot be larger than [member bake_cell_size].
  54. </member>
  55. <member name="image_path" type="String" setter="set_image_path" getter="get_image_path">
  56. Location where lightmaps will be saved.
  57. </member>
  58. <member name="light_data" type="BakedLightmapData" setter="set_light_data" getter="get_light_data">
  59. The calculated light data.
  60. </member>
  61. </members>
  62. <constants>
  63. <constant name="BAKE_QUALITY_LOW" value="0" enum="BakeQuality">
  64. Lowest bake quality mode. Fastest to calculate.
  65. </constant>
  66. <constant name="BAKE_QUALITY_MEDIUM" value="1" enum="BakeQuality">
  67. Default bake quality mode.
  68. </constant>
  69. <constant name="BAKE_QUALITY_HIGH" value="2" enum="BakeQuality">
  70. Highest bake quality mode. Takes longer to calculate.
  71. </constant>
  72. <constant name="BAKE_MODE_CONE_TRACE" value="0" enum="BakeMode">
  73. Less precise but faster bake mode.
  74. </constant>
  75. <constant name="BAKE_MODE_RAY_TRACE" value="1" enum="BakeMode">
  76. More precise bake mode but can take considerably longer to bake.
  77. </constant>
  78. <constant name="BAKE_ERROR_OK" value="0" enum="BakeError">
  79. </constant>
  80. <constant name="BAKE_ERROR_NO_SAVE_PATH" value="1" enum="BakeError">
  81. </constant>
  82. <constant name="BAKE_ERROR_NO_MESHES" value="2" enum="BakeError">
  83. </constant>
  84. <constant name="BAKE_ERROR_CANT_CREATE_IMAGE" value="3" enum="BakeError">
  85. </constant>
  86. <constant name="BAKE_ERROR_USER_ABORTED" value="4" enum="BakeError">
  87. </constant>
  88. </constants>
  89. </class>