class_worldenvironment.rst 2.6 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465
  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. Default environment properties for the entire scene (post-processing effects, lighting and background settings).
  10. Description
  11. -----------
  12. The ``WorldEnvironment`` node is used to configure the default :ref:`Environment<class_Environment>` for the scene.
  13. 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.
  14. 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.
  15. Tutorials
  16. ---------
  17. - :doc:`../tutorials/3d/environment_and_post_processing`
  18. Properties
  19. ----------
  20. +-------------------------------------------+-----------------------------------------------------------------------+
  21. | :ref:`CameraEffects<class_CameraEffects>` | :ref:`camera_effects<class_WorldEnvironment_property_camera_effects>` |
  22. +-------------------------------------------+-----------------------------------------------------------------------+
  23. | :ref:`Environment<class_Environment>` | :ref:`environment<class_WorldEnvironment_property_environment>` |
  24. +-------------------------------------------+-----------------------------------------------------------------------+
  25. Property Descriptions
  26. ---------------------
  27. .. _class_WorldEnvironment_property_camera_effects:
  28. - :ref:`CameraEffects<class_CameraEffects>` **camera_effects**
  29. +----------+---------------------------+
  30. | *Setter* | set_camera_effects(value) |
  31. +----------+---------------------------+
  32. | *Getter* | get_camera_effects() |
  33. +----------+---------------------------+
  34. ----
  35. .. _class_WorldEnvironment_property_environment:
  36. - :ref:`Environment<class_Environment>` **environment**
  37. +----------+------------------------+
  38. | *Setter* | set_environment(value) |
  39. +----------+------------------------+
  40. | *Getter* | get_environment() |
  41. +----------+------------------------+
  42. The :ref:`Environment<class_Environment>` resource used by this ``WorldEnvironment``, defining the default properties.