class_worldenvironment.rst 2.1 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556
  1. :github_url: hide
  2. .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
  3. .. DO NOT EDIT THIS FILE, but the WorldEnvironment.xml source instead.
  4. .. The source is found in doc/classes or modules/<name>/doc_classes.
  5. .. _class_WorldEnvironment:
  6. WorldEnvironment
  7. ================
  8. **Inherits:** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
  9. **Category:** Core
  10. Brief Description
  11. -----------------
  12. Default environment properties for the entire scene (post-processing effects, lighting and background settings).
  13. Properties
  14. ----------
  15. +---------------------------------------+-----------------------------------------------------------------+
  16. | :ref:`Environment<class_Environment>` | :ref:`environment<class_WorldEnvironment_property_environment>` |
  17. +---------------------------------------+-----------------------------------------------------------------+
  18. Description
  19. -----------
  20. The ``WorldEnvironment`` node is used to configure the default :ref:`Environment<class_Environment>` for the scene.
  21. 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.
  22. 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.
  23. Tutorials
  24. ---------
  25. - :doc:`../tutorials/3d/environment_and_post_processing`
  26. Property Descriptions
  27. ---------------------
  28. .. _class_WorldEnvironment_property_environment:
  29. - :ref:`Environment<class_Environment>` **environment**
  30. +----------+------------------------+
  31. | *Setter* | set_environment(value) |
  32. +----------+------------------------+
  33. | *Getter* | get_environment() |
  34. +----------+------------------------+
  35. The :ref:`Environment<class_Environment>` resource used by this ``WorldEnvironment``, defining the default properties.