class_worldenvironment.rst 2.1 KB

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