pandemonium_engine_docs/classes/class_sky.rst

98 lines
3.9 KiB
ReStructuredText
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

:github_url: hide
.. DO NOT EDIT THIS FILE!!!
.. Generated automatically from Godot engine sources.
.. Generator: https://github.com/godotengine/godot/tree/3.5/doc/tools/make_rst.py.
.. XML source: https://github.com/godotengine/godot/tree/3.5/doc/classes/Sky.xml.
.. _class_Sky:
Sky
===
**Inherits:** :ref:`Resource<class_Resource>` **<** :ref:`Reference<class_Reference>` **<** :ref:`Object<class_Object>`
**Inherited By:** :ref:`PanoramaSky<class_PanoramaSky>`, :ref:`ProceduralSky<class_ProceduralSky>`
The base class for :ref:`PanoramaSky<class_PanoramaSky>` and :ref:`ProceduralSky<class_ProceduralSky>`.
Description
-----------
The base class for :ref:`PanoramaSky<class_PanoramaSky>` and :ref:`ProceduralSky<class_ProceduralSky>`.
Properties
----------
+--------------------------------------------+--------------------------------------------------------+-------+
| :ref:`RadianceSize<enum_Sky_RadianceSize>` | :ref:`radiance_size<class_Sky_property_radiance_size>` | ``2`` |
+--------------------------------------------+--------------------------------------------------------+-------+
Enumerations
------------
.. _enum_Sky_RadianceSize:
.. _class_Sky_constant_RADIANCE_SIZE_32:
.. _class_Sky_constant_RADIANCE_SIZE_64:
.. _class_Sky_constant_RADIANCE_SIZE_128:
.. _class_Sky_constant_RADIANCE_SIZE_256:
.. _class_Sky_constant_RADIANCE_SIZE_512:
.. _class_Sky_constant_RADIANCE_SIZE_1024:
.. _class_Sky_constant_RADIANCE_SIZE_2048:
.. _class_Sky_constant_RADIANCE_SIZE_MAX:
enum **RadianceSize**:
- **RADIANCE_SIZE_32** = **0** --- Radiance texture size is 32×32 pixels.
- **RADIANCE_SIZE_64** = **1** --- Radiance texture size is 64×64 pixels.
- **RADIANCE_SIZE_128** = **2** --- Radiance texture size is 128×128 pixels.
- **RADIANCE_SIZE_256** = **3** --- Radiance texture size is 256×256 pixels.
- **RADIANCE_SIZE_512** = **4** --- Radiance texture size is 512×512 pixels.
- **RADIANCE_SIZE_1024** = **5** --- Radiance texture size is 1024×1024 pixels.
\ **Note:** :ref:`RADIANCE_SIZE_1024<class_Sky_constant_RADIANCE_SIZE_1024>` is not exposed in the inspector as it is known to cause GPU hangs on certain systems.
- **RADIANCE_SIZE_2048** = **6** --- Radiance texture size is 2048×2048 pixels.
\ **Note:** :ref:`RADIANCE_SIZE_2048<class_Sky_constant_RADIANCE_SIZE_2048>` is not exposed in the inspector as it is known to cause GPU hangs on certain systems.
- **RADIANCE_SIZE_MAX** = **7** --- Represents the size of the :ref:`RadianceSize<enum_Sky_RadianceSize>` enum.
Property Descriptions
---------------------
.. _class_Sky_property_radiance_size:
- :ref:`RadianceSize<enum_Sky_RadianceSize>` **radiance_size**
+-----------+--------------------------+
| *Default* | ``2`` |
+-----------+--------------------------+
| *Setter* | set_radiance_size(value) |
+-----------+--------------------------+
| *Getter* | get_radiance_size() |
+-----------+--------------------------+
The ``Sky``'s radiance map size. The higher the radiance map size, the more detailed the lighting from the ``Sky`` will be.
See :ref:`RadianceSize<enum_Sky_RadianceSize>` constants for values.
\ **Note:** You will only benefit from high radiance sizes if you have perfectly sharp reflective surfaces in your project and are not using :ref:`ReflectionProbe<class_ReflectionProbe>`\ s or :ref:`GIProbe<class_GIProbe>`\ s. For most projects, keeping :ref:`radiance_size<class_Sky_property_radiance_size>` to the default value is the best compromise between visuals and performance. Be careful when using high radiance size values as these can cause crashes on low-end GPUs.
.. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
.. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
.. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`