class_panoramaskymaterial.rst 3.3 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970
  1. :github_url: hide
  2. .. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
  3. .. DO NOT EDIT THIS FILE, but the PanoramaSkyMaterial.xml source instead.
  4. .. The source is found in doc/classes or modules/<name>/doc_classes.
  5. .. _class_PanoramaSkyMaterial:
  6. PanoramaSkyMaterial
  7. ===================
  8. **Inherits:** :ref:`Material<class_Material>` **<** :ref:`Resource<class_Resource>` **<** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`
  9. A :ref:`Material<class_Material>` used with :ref:`Sky<class_Sky>` to draw a background texture.
  10. Description
  11. -----------
  12. A resource referenced in a :ref:`Sky<class_Sky>` that is used to draw a background. The Panorama sky material functions similar to skyboxes in other engines, except it uses an equirectangular sky map instead of a cube map.
  13. Using an HDR panorama is strongly recommended for accurate, high-quality reflections. Godot supports the Radiance HDR (``.hdr``) and OpenEXR (``.exr``) image formats for this purpose.
  14. You can use `this tool <https://danilw.github.io/GLSL-howto/cubemap_to_panorama_js/cubemap_to_panorama.html>`__ to convert a cube map to an equirectangular sky map.
  15. Properties
  16. ----------
  17. +-----------------------------------+--------------------------------------------------------------+----------+
  18. | :ref:`bool<class_bool>` | :ref:`filter<class_PanoramaSkyMaterial_property_filter>` | ``true`` |
  19. +-----------------------------------+--------------------------------------------------------------+----------+
  20. | :ref:`Texture2D<class_Texture2D>` | :ref:`panorama<class_PanoramaSkyMaterial_property_panorama>` | |
  21. +-----------------------------------+--------------------------------------------------------------+----------+
  22. Property Descriptions
  23. ---------------------
  24. .. _class_PanoramaSkyMaterial_property_filter:
  25. - :ref:`bool<class_bool>` **filter**
  26. +-----------+------------------------------+
  27. | *Default* | ``true`` |
  28. +-----------+------------------------------+
  29. | *Setter* | set_filtering_enabled(value) |
  30. +-----------+------------------------------+
  31. | *Getter* | is_filtering_enabled() |
  32. +-----------+------------------------------+
  33. A boolean value to determine if the background texture should be filtered or not.
  34. ----
  35. .. _class_PanoramaSkyMaterial_property_panorama:
  36. - :ref:`Texture2D<class_Texture2D>` **panorama**
  37. +----------+---------------------+
  38. | *Setter* | set_panorama(value) |
  39. +----------+---------------------+
  40. | *Getter* | get_panorama() |
  41. +----------+---------------------+
  42. :ref:`Texture2D<class_Texture2D>` to be applied to the ``PanoramaSkyMaterial``.
  43. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  44. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  45. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
  46. .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
  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.)`
  48. .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`