class_worldenvironment.rst 3.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778
  1. :github_url: hide
  2. .. DO NOT EDIT THIS FILE!!!
  3. .. Generated automatically from Godot engine sources.
  4. .. Generator: https://github.com/godotengine/godot/tree/3.6/doc/tools/make_rst.py.
  5. .. XML source: https://github.com/godotengine/godot/tree/3.6/doc/classes/WorldEnvironment.xml.
  6. .. _class_WorldEnvironment:
  7. WorldEnvironment
  8. ================
  9. **Inherits:** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
  10. Default environment properties for the entire scene (post-processing effects, lighting and background settings).
  11. .. rst-class:: classref-introduction-group
  12. Description
  13. -----------
  14. The **WorldEnvironment** node is used to configure the default :ref:`Environment<class_Environment>` for the scene.
  15. The parameters defined in the **WorldEnvironment** can be overridden by an :ref:`Environment<class_Environment>` node set on the current :ref:`Camera<class_Camera>`. Additionally, only one **WorldEnvironment** may be instanced in a given scene at a time.
  16. The **WorldEnvironment** allows the user to specify default lighting parameters (e.g. ambient lighting), various post-processing effects (e.g. SSAO, DOF, Tonemapping), and how to draw the background (e.g. solid color, skybox). Usually, these are added in order to improve the realism/color balance of the scene.
  17. .. rst-class:: classref-introduction-group
  18. Tutorials
  19. ---------
  20. - :doc:`Environment and post-processing <../tutorials/3d/environment_and_post_processing>`
  21. - `3D Material Testers Demo <https://godotengine.org/asset-library/asset/123>`__
  22. - `2D HDR Demo <https://godotengine.org/asset-library/asset/110>`__
  23. - `Third Person Shooter Demo <https://godotengine.org/asset-library/asset/678>`__
  24. .. rst-class:: classref-reftable-group
  25. Properties
  26. ----------
  27. .. table::
  28. :widths: auto
  29. +---------------------------------------+-----------------------------------------------------------------+
  30. | :ref:`Environment<class_Environment>` | :ref:`environment<class_WorldEnvironment_property_environment>` |
  31. +---------------------------------------+-----------------------------------------------------------------+
  32. .. rst-class:: classref-section-separator
  33. ----
  34. .. rst-class:: classref-descriptions-group
  35. Property Descriptions
  36. ---------------------
  37. .. _class_WorldEnvironment_property_environment:
  38. .. rst-class:: classref-property
  39. :ref:`Environment<class_Environment>` **environment**
  40. .. rst-class:: classref-property-setget
  41. - void **set_environment** **(** :ref:`Environment<class_Environment>` value **)**
  42. - :ref:`Environment<class_Environment>` **get_environment** **(** **)**
  43. The :ref:`Environment<class_Environment>` resource used by this **WorldEnvironment**, defining the default properties.
  44. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  45. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  46. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
  47. .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`