godot-docs/classes/class_environment.rst

:github_url: hide

.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
.. DO NOT EDIT THIS FILE, but the Environment.xml source instead.
.. The source is found in doc/classes or modules/<name>/doc_classes.

.. _class_Environment:

Environment
===========

**Inherits:** :ref:`Resource<class_Resource>` **<** :ref:`Reference<class_Reference>` **<** :ref:`Object<class_Object>`

**Category:** Core

Brief Description
-----------------

Resource for environment nodes (like :ref:`WorldEnvironment<class_WorldEnvironment>`) that define multiple rendering options.

Properties
----------

+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`adjustment_brightness<class_Environment_property_adjustment_brightness>`                     | 1.0                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`Texture<class_Texture>`                          | :ref:`adjustment_color_correction<class_Environment_property_adjustment_color_correction>`         |                                    |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`adjustment_contrast<class_Environment_property_adjustment_contrast>`                         | 1.0                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`bool<class_bool>`                                | :ref:`adjustment_enabled<class_Environment_property_adjustment_enabled>`                           | false                              |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`adjustment_saturation<class_Environment_property_adjustment_saturation>`                     | 1.0                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`Color<class_Color>`                              | :ref:`ambient_light_color<class_Environment_property_ambient_light_color>`                         | Color( 0, 0, 0, 1 )                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`ambient_light_energy<class_Environment_property_ambient_light_energy>`                       | 1.0                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`ambient_light_sky_contribution<class_Environment_property_ambient_light_sky_contribution>`   | 1.0                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`bool<class_bool>`                                | :ref:`auto_exposure_enabled<class_Environment_property_auto_exposure_enabled>`                     | false                              |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`auto_exposure_max_luma<class_Environment_property_auto_exposure_max_luma>`                   | 8.0                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`auto_exposure_min_luma<class_Environment_property_auto_exposure_min_luma>`                   | 0.05                               |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`auto_exposure_scale<class_Environment_property_auto_exposure_scale>`                         | 0.4                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`auto_exposure_speed<class_Environment_property_auto_exposure_speed>`                         | 0.5                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`int<class_int>`                                  | :ref:`background_camera_feed_id<class_Environment_property_background_camera_feed_id>`             | 1                                  |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`int<class_int>`                                  | :ref:`background_canvas_max_layer<class_Environment_property_background_canvas_max_layer>`         | 0                                  |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`Color<class_Color>`                              | :ref:`background_color<class_Environment_property_background_color>`                               | Color( 0, 0, 0, 1 )                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`background_energy<class_Environment_property_background_energy>`                             | 1.0                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`BGMode<enum_Environment_BGMode>`                 | :ref:`background_mode<class_Environment_property_background_mode>`                                 | 0                                  |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`Sky<class_Sky>`                                  | :ref:`background_sky<class_Environment_property_background_sky>`                                   |                                    |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`background_sky_custom_fov<class_Environment_property_background_sky_custom_fov>`             | 0.0                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`Basis<class_Basis>`                              | :ref:`background_sky_orientation<class_Environment_property_background_sky_orientation>`           | Basis( 1, 0, 0, 0, 1, 0, 0, 0, 1 ) |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`Vector3<class_Vector3>`                          | :ref:`background_sky_rotation<class_Environment_property_background_sky_rotation>`                 | Vector3( 0, 0, 0 )                 |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`Vector3<class_Vector3>`                          | :ref:`background_sky_rotation_degrees<class_Environment_property_background_sky_rotation_degrees>` | Vector3( 0, 0, 0 )                 |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`dof_blur_far_amount<class_Environment_property_dof_blur_far_amount>`                         | 0.1                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`dof_blur_far_distance<class_Environment_property_dof_blur_far_distance>`                     | 10.0                               |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`bool<class_bool>`                                | :ref:`dof_blur_far_enabled<class_Environment_property_dof_blur_far_enabled>`                       | false                              |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`DOFBlurQuality<enum_Environment_DOFBlurQuality>` | :ref:`dof_blur_far_quality<class_Environment_property_dof_blur_far_quality>`                       | 1                                  |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`dof_blur_far_transition<class_Environment_property_dof_blur_far_transition>`                 | 5.0                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`dof_blur_near_amount<class_Environment_property_dof_blur_near_amount>`                       | 0.1                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`dof_blur_near_distance<class_Environment_property_dof_blur_near_distance>`                   | 2.0                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`bool<class_bool>`                                | :ref:`dof_blur_near_enabled<class_Environment_property_dof_blur_near_enabled>`                     | false                              |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`DOFBlurQuality<enum_Environment_DOFBlurQuality>` | :ref:`dof_blur_near_quality<class_Environment_property_dof_blur_near_quality>`                     | 1                                  |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`dof_blur_near_transition<class_Environment_property_dof_blur_near_transition>`               | 1.0                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`Color<class_Color>`                              | :ref:`fog_color<class_Environment_property_fog_color>`                                             | Color( 0.5, 0.6, 0.7, 1 )          |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`fog_depth_begin<class_Environment_property_fog_depth_begin>`                                 | 10.0                               |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`fog_depth_curve<class_Environment_property_fog_depth_curve>`                                 | 1.0                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`bool<class_bool>`                                | :ref:`fog_depth_enabled<class_Environment_property_fog_depth_enabled>`                             | true                               |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`fog_depth_end<class_Environment_property_fog_depth_end>`                                     | 0.0                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`bool<class_bool>`                                | :ref:`fog_enabled<class_Environment_property_fog_enabled>`                                         | false                              |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`fog_height_curve<class_Environment_property_fog_height_curve>`                               | 1.0                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`bool<class_bool>`                                | :ref:`fog_height_enabled<class_Environment_property_fog_height_enabled>`                           | false                              |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`fog_height_max<class_Environment_property_fog_height_max>`                                   | 100.0                              |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`fog_height_min<class_Environment_property_fog_height_min>`                                   | 0.0                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`fog_sun_amount<class_Environment_property_fog_sun_amount>`                                   | 0.0                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`Color<class_Color>`                              | :ref:`fog_sun_color<class_Environment_property_fog_sun_color>`                                     | Color( 1, 0.9, 0.7, 1 )            |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`fog_transmit_curve<class_Environment_property_fog_transmit_curve>`                           | 1.0                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`bool<class_bool>`                                | :ref:`fog_transmit_enabled<class_Environment_property_fog_transmit_enabled>`                       | false                              |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`bool<class_bool>`                                | :ref:`glow_bicubic_upscale<class_Environment_property_glow_bicubic_upscale>`                       | false                              |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`GlowBlendMode<enum_Environment_GlowBlendMode>`   | :ref:`glow_blend_mode<class_Environment_property_glow_blend_mode>`                                 | 2                                  |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`glow_bloom<class_Environment_property_glow_bloom>`                                           | 0.0                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`bool<class_bool>`                                | :ref:`glow_enabled<class_Environment_property_glow_enabled>`                                       | false                              |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`glow_hdr_luminance_cap<class_Environment_property_glow_hdr_luminance_cap>`                   | 12.0                               |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`glow_hdr_scale<class_Environment_property_glow_hdr_scale>`                                   | 2.0                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`glow_hdr_threshold<class_Environment_property_glow_hdr_threshold>`                           | 1.0                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`glow_intensity<class_Environment_property_glow_intensity>`                                   | 0.8                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`bool<class_bool>`                                | :ref:`glow_levels/1<class_Environment_property_glow_levels/1>`                                     | false                              |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`bool<class_bool>`                                | :ref:`glow_levels/2<class_Environment_property_glow_levels/2>`                                     | false                              |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`bool<class_bool>`                                | :ref:`glow_levels/3<class_Environment_property_glow_levels/3>`                                     | true                               |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`bool<class_bool>`                                | :ref:`glow_levels/4<class_Environment_property_glow_levels/4>`                                     | false                              |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`bool<class_bool>`                                | :ref:`glow_levels/5<class_Environment_property_glow_levels/5>`                                     | true                               |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`bool<class_bool>`                                | :ref:`glow_levels/6<class_Environment_property_glow_levels/6>`                                     | false                              |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`bool<class_bool>`                                | :ref:`glow_levels/7<class_Environment_property_glow_levels/7>`                                     | false                              |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`glow_strength<class_Environment_property_glow_strength>`                                     | 1.0                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`ss_reflections_depth_tolerance<class_Environment_property_ss_reflections_depth_tolerance>`   | 0.2                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`bool<class_bool>`                                | :ref:`ss_reflections_enabled<class_Environment_property_ss_reflections_enabled>`                   | false                              |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`ss_reflections_fade_in<class_Environment_property_ss_reflections_fade_in>`                   | 0.15                               |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`ss_reflections_fade_out<class_Environment_property_ss_reflections_fade_out>`                 | 2.0                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`int<class_int>`                                  | :ref:`ss_reflections_max_steps<class_Environment_property_ss_reflections_max_steps>`               | 64                                 |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`bool<class_bool>`                                | :ref:`ss_reflections_roughness<class_Environment_property_ss_reflections_roughness>`               | true                               |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`ssao_ao_channel_affect<class_Environment_property_ssao_ao_channel_affect>`                   | 0.0                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`ssao_bias<class_Environment_property_ssao_bias>`                                             | 0.01                               |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`SSAOBlur<enum_Environment_SSAOBlur>`             | :ref:`ssao_blur<class_Environment_property_ssao_blur>`                                             | 3                                  |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`Color<class_Color>`                              | :ref:`ssao_color<class_Environment_property_ssao_color>`                                           | Color( 0, 0, 0, 1 )                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`ssao_edge_sharpness<class_Environment_property_ssao_edge_sharpness>`                         | 4.0                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`bool<class_bool>`                                | :ref:`ssao_enabled<class_Environment_property_ssao_enabled>`                                       | false                              |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`ssao_intensity<class_Environment_property_ssao_intensity>`                                   | 1.0                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`ssao_intensity2<class_Environment_property_ssao_intensity2>`                                 | 1.0                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`ssao_light_affect<class_Environment_property_ssao_light_affect>`                             | 0.0                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`SSAOQuality<enum_Environment_SSAOQuality>`       | :ref:`ssao_quality<class_Environment_property_ssao_quality>`                                       | 1                                  |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`ssao_radius<class_Environment_property_ssao_radius>`                                         | 1.0                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`ssao_radius2<class_Environment_property_ssao_radius2>`                                       | 0.0                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`tonemap_exposure<class_Environment_property_tonemap_exposure>`                               | 1.0                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`ToneMapper<enum_Environment_ToneMapper>`         | :ref:`tonemap_mode<class_Environment_property_tonemap_mode>`                                       | 0                                  |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+
| :ref:`float<class_float>`                              | :ref:`tonemap_white<class_Environment_property_tonemap_white>`                                     | 1.0                                |
+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------+

Methods
-------

+-------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`is_glow_level_enabled<class_Environment_method_is_glow_level_enabled>` **(** :ref:`int<class_int>` idx **)** const              |
+-------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
| void                    | :ref:`set_glow_level<class_Environment_method_set_glow_level>` **(** :ref:`int<class_int>` idx, :ref:`bool<class_bool>` enabled **)** |
+-------------------------+---------------------------------------------------------------------------------------------------------------------------------------+

Enumerations
------------

.. _enum_Environment_BGMode:

.. _class_Environment_constant_BG_KEEP:

.. _class_Environment_constant_BG_CLEAR_COLOR:

.. _class_Environment_constant_BG_COLOR:

.. _class_Environment_constant_BG_SKY:

.. _class_Environment_constant_BG_COLOR_SKY:

.. _class_Environment_constant_BG_CANVAS:

.. _class_Environment_constant_BG_CAMERA_FEED:

.. _class_Environment_constant_BG_MAX:

enum **BGMode**:

- **BG_KEEP** = **5** --- Keep on screen every pixel drawn in the background.

- **BG_CLEAR_COLOR** = **0** --- Clear the background using the project's clear color.

- **BG_COLOR** = **1** --- Clear the background using a custom clear color.

- **BG_SKY** = **2** --- Display a user-defined sky in the background.

- **BG_COLOR_SKY** = **3** --- Clear the background using a custom clear color and allows defining a sky for shading and reflection.

- **BG_CANVAS** = **4** --- Display a :ref:`CanvasLayer<class_CanvasLayer>` in the background.

- **BG_CAMERA_FEED** = **6** --- Display a camera feed in the background.

- **BG_MAX** = **7** --- Represents the size of the :ref:`BGMode<enum_Environment_BGMode>` enum.

.. _enum_Environment_GlowBlendMode:

.. _class_Environment_constant_GLOW_BLEND_MODE_ADDITIVE:

.. _class_Environment_constant_GLOW_BLEND_MODE_SCREEN:

.. _class_Environment_constant_GLOW_BLEND_MODE_SOFTLIGHT:

.. _class_Environment_constant_GLOW_BLEND_MODE_REPLACE:

enum **GlowBlendMode**:

- **GLOW_BLEND_MODE_ADDITIVE** = **0** --- Additive glow blending mode. Mostly used for particles, glows (bloom), lens flare, bright sources.

- **GLOW_BLEND_MODE_SCREEN** = **1** --- Screen glow blending mode. Increases brightness, used frequently with bloom.

- **GLOW_BLEND_MODE_SOFTLIGHT** = **2** --- Soft light glow blending mode. Modifies contrast, exposes shadows and highlights, vivid bloom.

- **GLOW_BLEND_MODE_REPLACE** = **3** --- Replace glow blending mode. Replaces all pixels' color by the glow value.

.. _enum_Environment_ToneMapper:

.. _class_Environment_constant_TONE_MAPPER_LINEAR:

.. _class_Environment_constant_TONE_MAPPER_REINHARDT:

.. _class_Environment_constant_TONE_MAPPER_FILMIC:

.. _class_Environment_constant_TONE_MAPPER_ACES:

enum **ToneMapper**:

- **TONE_MAPPER_LINEAR** = **0** --- Linear tonemapper operator. Reads the linear data and performs an exposure adjustment.

- **TONE_MAPPER_REINHARDT** = **1** --- Reinhardt tonemapper operator. Performs a variation on rendered pixels' colors by this formula: ``color = color / (1 + color)``.

- **TONE_MAPPER_FILMIC** = **2** --- Filmic tonemapper operator.

- **TONE_MAPPER_ACES** = **3** --- Academy Color Encoding System tonemapper operator.

.. _enum_Environment_DOFBlurQuality:

.. _class_Environment_constant_DOF_BLUR_QUALITY_LOW:

.. _class_Environment_constant_DOF_BLUR_QUALITY_MEDIUM:

.. _class_Environment_constant_DOF_BLUR_QUALITY_HIGH:

enum **DOFBlurQuality**:

- **DOF_BLUR_QUALITY_LOW** = **0** --- Low depth-of-field blur quality.

- **DOF_BLUR_QUALITY_MEDIUM** = **1** --- Medium depth-of-field blur quality.

- **DOF_BLUR_QUALITY_HIGH** = **2** --- High depth-of-field blur quality.

.. _enum_Environment_SSAOBlur:

.. _class_Environment_constant_SSAO_BLUR_DISABLED:

.. _class_Environment_constant_SSAO_BLUR_1x1:

.. _class_Environment_constant_SSAO_BLUR_2x2:

.. _class_Environment_constant_SSAO_BLUR_3x3:

enum **SSAOBlur**:

- **SSAO_BLUR_DISABLED** = **0**

- **SSAO_BLUR_1x1** = **1**

- **SSAO_BLUR_2x2** = **2**

- **SSAO_BLUR_3x3** = **3**

.. _enum_Environment_SSAOQuality:

.. _class_Environment_constant_SSAO_QUALITY_LOW:

.. _class_Environment_constant_SSAO_QUALITY_MEDIUM:

.. _class_Environment_constant_SSAO_QUALITY_HIGH:

enum **SSAOQuality**:

- **SSAO_QUALITY_LOW** = **0**

- **SSAO_QUALITY_MEDIUM** = **1**

- **SSAO_QUALITY_HIGH** = **2**

Description
-----------

Resource for environment nodes (like :ref:`WorldEnvironment<class_WorldEnvironment>`) that define multiple environment operations (such as background :ref:`Sky<class_Sky>` or :ref:`Color<class_Color>`, ambient light, fog, depth-of-field...). These parameters affect the final render of the scene. The order of these operations is:

- Depth of Field Blur

- Glow

- Tonemap (Auto Exposure)

- Adjustments

Tutorials
---------

- :doc:`../tutorials/3d/environment_and_post_processing`

- :doc:`../tutorials/3d/high_dynamic_range`

Property Descriptions
---------------------

.. _class_Environment_property_adjustment_brightness:

- :ref:`float<class_float>` **adjustment_brightness**

+-----------+----------------------------------+
| *Default* | 1.0                              |
+-----------+----------------------------------+
| *Setter*  | set_adjustment_brightness(value) |
+-----------+----------------------------------+
| *Getter*  | get_adjustment_brightness()      |
+-----------+----------------------------------+

Global brightness value of the rendered scene (default value is 1).

.. _class_Environment_property_adjustment_color_correction:

- :ref:`Texture<class_Texture>` **adjustment_color_correction**

+----------+----------------------------------------+
| *Setter* | set_adjustment_color_correction(value) |
+----------+----------------------------------------+
| *Getter* | get_adjustment_color_correction()      |
+----------+----------------------------------------+

Applies the provided :ref:`Texture<class_Texture>` resource to affect the global color aspect of the rendered scene.

.. _class_Environment_property_adjustment_contrast:

- :ref:`float<class_float>` **adjustment_contrast**

+-----------+--------------------------------+
| *Default* | 1.0                            |
+-----------+--------------------------------+
| *Setter*  | set_adjustment_contrast(value) |
+-----------+--------------------------------+
| *Getter*  | get_adjustment_contrast()      |
+-----------+--------------------------------+

Global contrast value of the rendered scene (default value is 1).

.. _class_Environment_property_adjustment_enabled:

- :ref:`bool<class_bool>` **adjustment_enabled**

+-----------+------------------------------+
| *Default* | false                        |
+-----------+------------------------------+
| *Setter*  | set_adjustment_enable(value) |
+-----------+------------------------------+
| *Getter*  | is_adjustment_enabled()      |
+-----------+------------------------------+

Enables the adjustment\_\* options provided by this resource. If ``false``, adjustments modifications will have no effect on the rendered scene.

.. _class_Environment_property_adjustment_saturation:

- :ref:`float<class_float>` **adjustment_saturation**

+-----------+----------------------------------+
| *Default* | 1.0                              |
+-----------+----------------------------------+
| *Setter*  | set_adjustment_saturation(value) |
+-----------+----------------------------------+
| *Getter*  | get_adjustment_saturation()      |
+-----------+----------------------------------+

Global color saturation value of the rendered scene (default value is 1).

.. _class_Environment_property_ambient_light_color:

- :ref:`Color<class_Color>` **ambient_light_color**

+-----------+--------------------------------+
| *Default* | Color( 0, 0, 0, 1 )            |
+-----------+--------------------------------+
| *Setter*  | set_ambient_light_color(value) |
+-----------+--------------------------------+
| *Getter*  | get_ambient_light_color()      |
+-----------+--------------------------------+

:ref:`Color<class_Color>` of the ambient light.

.. _class_Environment_property_ambient_light_energy:

- :ref:`float<class_float>` **ambient_light_energy**

+-----------+---------------------------------+
| *Default* | 1.0                             |
+-----------+---------------------------------+
| *Setter*  | set_ambient_light_energy(value) |
+-----------+---------------------------------+
| *Getter*  | get_ambient_light_energy()      |
+-----------+---------------------------------+

Energy of the ambient light. The higher the value, the stronger the light.

.. _class_Environment_property_ambient_light_sky_contribution:

- :ref:`float<class_float>` **ambient_light_sky_contribution**

+-----------+-------------------------------------------+
| *Default* | 1.0                                       |
+-----------+-------------------------------------------+
| *Setter*  | set_ambient_light_sky_contribution(value) |
+-----------+-------------------------------------------+
| *Getter*  | get_ambient_light_sky_contribution()      |
+-----------+-------------------------------------------+

Defines the amount of light that the sky brings on the scene. A value of 0 means that the sky's light emission has no effect on the scene illumination, thus all ambient illumination is provided by the ambient light. On the contrary, a value of 1 means that all the light that affects the scene is provided by the sky, thus the ambient light parameter has no effect on the scene.

.. _class_Environment_property_auto_exposure_enabled:

- :ref:`bool<class_bool>` **auto_exposure_enabled**

+-----------+----------------------------------+
| *Default* | false                            |
+-----------+----------------------------------+
| *Setter*  | set_tonemap_auto_exposure(value) |
+-----------+----------------------------------+
| *Getter*  | get_tonemap_auto_exposure()      |
+-----------+----------------------------------+

Enables the tonemapping auto exposure mode of the scene renderer. If activated, the renderer will automatically determine the exposure setting to adapt to the illumination of the scene and the observed light.

.. _class_Environment_property_auto_exposure_max_luma:

- :ref:`float<class_float>` **auto_exposure_max_luma**

+-----------+--------------------------------------+
| *Default* | 8.0                                  |
+-----------+--------------------------------------+
| *Setter*  | set_tonemap_auto_exposure_max(value) |
+-----------+--------------------------------------+
| *Getter*  | get_tonemap_auto_exposure_max()      |
+-----------+--------------------------------------+

Maximum luminance value for the auto exposure.

.. _class_Environment_property_auto_exposure_min_luma:

- :ref:`float<class_float>` **auto_exposure_min_luma**

+-----------+--------------------------------------+
| *Default* | 0.05                                 |
+-----------+--------------------------------------+
| *Setter*  | set_tonemap_auto_exposure_min(value) |
+-----------+--------------------------------------+
| *Getter*  | get_tonemap_auto_exposure_min()      |
+-----------+--------------------------------------+

Minimum luminance value for the auto exposure.

.. _class_Environment_property_auto_exposure_scale:

- :ref:`float<class_float>` **auto_exposure_scale**

+-----------+---------------------------------------+
| *Default* | 0.4                                   |
+-----------+---------------------------------------+
| *Setter*  | set_tonemap_auto_exposure_grey(value) |
+-----------+---------------------------------------+
| *Getter*  | get_tonemap_auto_exposure_grey()      |
+-----------+---------------------------------------+

Scale of the auto exposure effect. Affects the intensity of auto exposure.

.. _class_Environment_property_auto_exposure_speed:

- :ref:`float<class_float>` **auto_exposure_speed**

+-----------+----------------------------------------+
| *Default* | 0.5                                    |
+-----------+----------------------------------------+
| *Setter*  | set_tonemap_auto_exposure_speed(value) |
+-----------+----------------------------------------+
| *Getter*  | get_tonemap_auto_exposure_speed()      |
+-----------+----------------------------------------+

Speed of the auto exposure effect. Affects the time needed for the camera to perform auto exposure.

.. _class_Environment_property_background_camera_feed_id:

- :ref:`int<class_int>` **background_camera_feed_id**

+-----------+---------------------------+
| *Default* | 1                         |
+-----------+---------------------------+
| *Setter*  | set_camera_feed_id(value) |
+-----------+---------------------------+
| *Getter*  | get_camera_feed_id()      |
+-----------+---------------------------+

The id of the camera feed to show in the background.

.. _class_Environment_property_background_canvas_max_layer:

- :ref:`int<class_int>` **background_canvas_max_layer**

+-----------+-----------------------------+
| *Default* | 0                           |
+-----------+-----------------------------+
| *Setter*  | set_canvas_max_layer(value) |
+-----------+-----------------------------+
| *Getter*  | get_canvas_max_layer()      |
+-----------+-----------------------------+

Maximum layer id (if using Layer background mode).

.. _class_Environment_property_background_color:

- :ref:`Color<class_Color>` **background_color**

+-----------+---------------------+
| *Default* | Color( 0, 0, 0, 1 ) |
+-----------+---------------------+
| *Setter*  | set_bg_color(value) |
+-----------+---------------------+
| *Getter*  | get_bg_color()      |
+-----------+---------------------+

Color displayed for clear areas of the scene (if using Custom color or Color+Sky background modes).

.. _class_Environment_property_background_energy:

- :ref:`float<class_float>` **background_energy**

+-----------+----------------------+
| *Default* | 1.0                  |
+-----------+----------------------+
| *Setter*  | set_bg_energy(value) |
+-----------+----------------------+
| *Getter*  | get_bg_energy()      |
+-----------+----------------------+

Power of light emitted by the background.

.. _class_Environment_property_background_mode:

- :ref:`BGMode<enum_Environment_BGMode>` **background_mode**

+-----------+-----------------------+
| *Default* | 0                     |
+-----------+-----------------------+
| *Setter*  | set_background(value) |
+-----------+-----------------------+
| *Getter*  | get_background()      |
+-----------+-----------------------+

Defines the mode of background.

.. _class_Environment_property_background_sky:

- :ref:`Sky<class_Sky>` **background_sky**

+----------+----------------+
| *Setter* | set_sky(value) |
+----------+----------------+
| *Getter* | get_sky()      |
+----------+----------------+

:ref:`Sky<class_Sky>` resource defined as background.

.. _class_Environment_property_background_sky_custom_fov:

- :ref:`float<class_float>` **background_sky_custom_fov**

+-----------+---------------------------+
| *Default* | 0.0                       |
+-----------+---------------------------+
| *Setter*  | set_sky_custom_fov(value) |
+-----------+---------------------------+
| *Getter*  | get_sky_custom_fov()      |
+-----------+---------------------------+

:ref:`Sky<class_Sky>` resource's custom field of view.

.. _class_Environment_property_background_sky_orientation:

- :ref:`Basis<class_Basis>` **background_sky_orientation**

+-----------+------------------------------------+
| *Default* | Basis( 1, 0, 0, 0, 1, 0, 0, 0, 1 ) |
+-----------+------------------------------------+
| *Setter*  | set_sky_orientation(value)         |
+-----------+------------------------------------+
| *Getter*  | get_sky_orientation()              |
+-----------+------------------------------------+

:ref:`Sky<class_Sky>` resource's rotation expressed as a :ref:`Basis<class_Basis>`

.. _class_Environment_property_background_sky_rotation:

- :ref:`Vector3<class_Vector3>` **background_sky_rotation**

+-----------+-------------------------+
| *Default* | Vector3( 0, 0, 0 )      |
+-----------+-------------------------+
| *Setter*  | set_sky_rotation(value) |
+-----------+-------------------------+
| *Getter*  | get_sky_rotation()      |
+-----------+-------------------------+

:ref:`Sky<class_Sky>` resource's rotation expressed as euler angles in radians

.. _class_Environment_property_background_sky_rotation_degrees:

- :ref:`Vector3<class_Vector3>` **background_sky_rotation_degrees**

+-----------+---------------------------------+
| *Default* | Vector3( 0, 0, 0 )              |
+-----------+---------------------------------+
| *Setter*  | set_sky_rotation_degrees(value) |
+-----------+---------------------------------+
| *Getter*  | get_sky_rotation_degrees()      |
+-----------+---------------------------------+

:ref:`Sky<class_Sky>` resource's rotation expressed as euler angles in degrees

.. _class_Environment_property_dof_blur_far_amount:

- :ref:`float<class_float>` **dof_blur_far_amount**

+-----------+--------------------------------+
| *Default* | 0.1                            |
+-----------+--------------------------------+
| *Setter*  | set_dof_blur_far_amount(value) |
+-----------+--------------------------------+
| *Getter*  | get_dof_blur_far_amount()      |
+-----------+--------------------------------+

Amount of far blur.

.. _class_Environment_property_dof_blur_far_distance:

- :ref:`float<class_float>` **dof_blur_far_distance**

+-----------+----------------------------------+
| *Default* | 10.0                             |
+-----------+----------------------------------+
| *Setter*  | set_dof_blur_far_distance(value) |
+-----------+----------------------------------+
| *Getter*  | get_dof_blur_far_distance()      |
+-----------+----------------------------------+

Distance from the camera where the far blur effect affects the rendering.

.. _class_Environment_property_dof_blur_far_enabled:

- :ref:`bool<class_bool>` **dof_blur_far_enabled**

+-----------+---------------------------------+
| *Default* | false                           |
+-----------+---------------------------------+
| *Setter*  | set_dof_blur_far_enabled(value) |
+-----------+---------------------------------+
| *Getter*  | is_dof_blur_far_enabled()       |
+-----------+---------------------------------+

Enables the far blur effect.

.. _class_Environment_property_dof_blur_far_quality:

- :ref:`DOFBlurQuality<enum_Environment_DOFBlurQuality>` **dof_blur_far_quality**

+-----------+---------------------------------+
| *Default* | 1                               |
+-----------+---------------------------------+
| *Setter*  | set_dof_blur_far_quality(value) |
+-----------+---------------------------------+
| *Getter*  | get_dof_blur_far_quality()      |
+-----------+---------------------------------+

Quality of the far blur quality.

.. _class_Environment_property_dof_blur_far_transition:

- :ref:`float<class_float>` **dof_blur_far_transition**

+-----------+------------------------------------+
| *Default* | 5.0                                |
+-----------+------------------------------------+
| *Setter*  | set_dof_blur_far_transition(value) |
+-----------+------------------------------------+
| *Getter*  | get_dof_blur_far_transition()      |
+-----------+------------------------------------+

Transition between no-blur area and far blur.

.. _class_Environment_property_dof_blur_near_amount:

- :ref:`float<class_float>` **dof_blur_near_amount**

+-----------+---------------------------------+
| *Default* | 0.1                             |
+-----------+---------------------------------+
| *Setter*  | set_dof_blur_near_amount(value) |
+-----------+---------------------------------+
| *Getter*  | get_dof_blur_near_amount()      |
+-----------+---------------------------------+

Amount of near blur.

.. _class_Environment_property_dof_blur_near_distance:

- :ref:`float<class_float>` **dof_blur_near_distance**

+-----------+-----------------------------------+
| *Default* | 2.0                               |
+-----------+-----------------------------------+
| *Setter*  | set_dof_blur_near_distance(value) |
+-----------+-----------------------------------+
| *Getter*  | get_dof_blur_near_distance()      |
+-----------+-----------------------------------+

Distance from the camera where the near blur effect affects the rendering.

.. _class_Environment_property_dof_blur_near_enabled:

- :ref:`bool<class_bool>` **dof_blur_near_enabled**

+-----------+----------------------------------+
| *Default* | false                            |
+-----------+----------------------------------+
| *Setter*  | set_dof_blur_near_enabled(value) |
+-----------+----------------------------------+
| *Getter*  | is_dof_blur_near_enabled()       |
+-----------+----------------------------------+

Enables the near blur effect.

.. _class_Environment_property_dof_blur_near_quality:

- :ref:`DOFBlurQuality<enum_Environment_DOFBlurQuality>` **dof_blur_near_quality**

+-----------+----------------------------------+
| *Default* | 1                                |
+-----------+----------------------------------+
| *Setter*  | set_dof_blur_near_quality(value) |
+-----------+----------------------------------+
| *Getter*  | get_dof_blur_near_quality()      |
+-----------+----------------------------------+

Quality of the near blur quality.

.. _class_Environment_property_dof_blur_near_transition:

- :ref:`float<class_float>` **dof_blur_near_transition**

+-----------+-------------------------------------+
| *Default* | 1.0                                 |
+-----------+-------------------------------------+
| *Setter*  | set_dof_blur_near_transition(value) |
+-----------+-------------------------------------+
| *Getter*  | get_dof_blur_near_transition()      |
+-----------+-------------------------------------+

Transition between near blur and no-blur area.

.. _class_Environment_property_fog_color:

- :ref:`Color<class_Color>` **fog_color**

+-----------+---------------------------+
| *Default* | Color( 0.5, 0.6, 0.7, 1 ) |
+-----------+---------------------------+
| *Setter*  | set_fog_color(value)      |
+-----------+---------------------------+
| *Getter*  | get_fog_color()           |
+-----------+---------------------------+

Fog's :ref:`Color<class_Color>`.

.. _class_Environment_property_fog_depth_begin:

- :ref:`float<class_float>` **fog_depth_begin**

+-----------+----------------------------+
| *Default* | 10.0                       |
+-----------+----------------------------+
| *Setter*  | set_fog_depth_begin(value) |
+-----------+----------------------------+
| *Getter*  | get_fog_depth_begin()      |
+-----------+----------------------------+

Fog's depth starting distance from the camera.

.. _class_Environment_property_fog_depth_curve:

- :ref:`float<class_float>` **fog_depth_curve**

+-----------+----------------------------+
| *Default* | 1.0                        |
+-----------+----------------------------+
| *Setter*  | set_fog_depth_curve(value) |
+-----------+----------------------------+
| *Getter*  | get_fog_depth_curve()      |
+-----------+----------------------------+

Value defining the fog depth intensity.

.. _class_Environment_property_fog_depth_enabled:

- :ref:`bool<class_bool>` **fog_depth_enabled**

+-----------+------------------------------+
| *Default* | true                         |
+-----------+------------------------------+
| *Setter*  | set_fog_depth_enabled(value) |
+-----------+------------------------------+
| *Getter*  | is_fog_depth_enabled()       |
+-----------+------------------------------+

Enables the fog depth.

.. _class_Environment_property_fog_depth_end:

- :ref:`float<class_float>` **fog_depth_end**

+-----------+--------------------------+
| *Default* | 0.0                      |
+-----------+--------------------------+
| *Setter*  | set_fog_depth_end(value) |
+-----------+--------------------------+
| *Getter*  | get_fog_depth_end()      |
+-----------+--------------------------+

.. _class_Environment_property_fog_enabled:

- :ref:`bool<class_bool>` **fog_enabled**

+-----------+------------------------+
| *Default* | false                  |
+-----------+------------------------+
| *Setter*  | set_fog_enabled(value) |
+-----------+------------------------+
| *Getter*  | is_fog_enabled()       |
+-----------+------------------------+

Enables the fog. Needs fog_height_enabled and/or for_depth_enabled to actually display fog.

.. _class_Environment_property_fog_height_curve:

- :ref:`float<class_float>` **fog_height_curve**

+-----------+-----------------------------+
| *Default* | 1.0                         |
+-----------+-----------------------------+
| *Setter*  | set_fog_height_curve(value) |
+-----------+-----------------------------+
| *Getter*  | get_fog_height_curve()      |
+-----------+-----------------------------+

Value defining the fog height intensity.

.. _class_Environment_property_fog_height_enabled:

- :ref:`bool<class_bool>` **fog_height_enabled**

+-----------+-------------------------------+
| *Default* | false                         |
+-----------+-------------------------------+
| *Setter*  | set_fog_height_enabled(value) |
+-----------+-------------------------------+
| *Getter*  | is_fog_height_enabled()       |
+-----------+-------------------------------+

Enables the fog height.

.. _class_Environment_property_fog_height_max:

- :ref:`float<class_float>` **fog_height_max**

+-----------+---------------------------+
| *Default* | 100.0                     |
+-----------+---------------------------+
| *Setter*  | set_fog_height_max(value) |
+-----------+---------------------------+
| *Getter*  | get_fog_height_max()      |
+-----------+---------------------------+

Maximum height of fog.

.. _class_Environment_property_fog_height_min:

- :ref:`float<class_float>` **fog_height_min**

+-----------+---------------------------+
| *Default* | 0.0                       |
+-----------+---------------------------+
| *Setter*  | set_fog_height_min(value) |
+-----------+---------------------------+
| *Getter*  | get_fog_height_min()      |
+-----------+---------------------------+

Minimum height of fog.

.. _class_Environment_property_fog_sun_amount:

- :ref:`float<class_float>` **fog_sun_amount**

+-----------+---------------------------+
| *Default* | 0.0                       |
+-----------+---------------------------+
| *Setter*  | set_fog_sun_amount(value) |
+-----------+---------------------------+
| *Getter*  | get_fog_sun_amount()      |
+-----------+---------------------------+

Amount of sun that affects the fog rendering.

.. _class_Environment_property_fog_sun_color:

- :ref:`Color<class_Color>` **fog_sun_color**

+-----------+--------------------------+
| *Default* | Color( 1, 0.9, 0.7, 1 )  |
+-----------+--------------------------+
| *Setter*  | set_fog_sun_color(value) |
+-----------+--------------------------+
| *Getter*  | get_fog_sun_color()      |
+-----------+--------------------------+

Sun :ref:`Color<class_Color>`.

.. _class_Environment_property_fog_transmit_curve:

- :ref:`float<class_float>` **fog_transmit_curve**

+-----------+-------------------------------+
| *Default* | 1.0                           |
+-----------+-------------------------------+
| *Setter*  | set_fog_transmit_curve(value) |
+-----------+-------------------------------+
| *Getter*  | get_fog_transmit_curve()      |
+-----------+-------------------------------+

Amount of light that the fog transmits.

.. _class_Environment_property_fog_transmit_enabled:

- :ref:`bool<class_bool>` **fog_transmit_enabled**

+-----------+---------------------------------+
| *Default* | false                           |
+-----------+---------------------------------+
| *Setter*  | set_fog_transmit_enabled(value) |
+-----------+---------------------------------+
| *Getter*  | is_fog_transmit_enabled()       |
+-----------+---------------------------------+

Enables fog's light transmission. If enabled, lets reflections light to be transmitted by the fog.

.. _class_Environment_property_glow_bicubic_upscale:

- :ref:`bool<class_bool>` **glow_bicubic_upscale**

+-----------+-----------------------------------+
| *Default* | false                             |
+-----------+-----------------------------------+
| *Setter*  | set_glow_bicubic_upscale(value)   |
+-----------+-----------------------------------+
| *Getter*  | is_glow_bicubic_upscale_enabled() |
+-----------+-----------------------------------+

.. _class_Environment_property_glow_blend_mode:

- :ref:`GlowBlendMode<enum_Environment_GlowBlendMode>` **glow_blend_mode**

+-----------+----------------------------+
| *Default* | 2                          |
+-----------+----------------------------+
| *Setter*  | set_glow_blend_mode(value) |
+-----------+----------------------------+
| *Getter*  | get_glow_blend_mode()      |
+-----------+----------------------------+

Glow blending mode.

.. _class_Environment_property_glow_bloom:

- :ref:`float<class_float>` **glow_bloom**

+-----------+-----------------------+
| *Default* | 0.0                   |
+-----------+-----------------------+
| *Setter*  | set_glow_bloom(value) |
+-----------+-----------------------+
| *Getter*  | get_glow_bloom()      |
+-----------+-----------------------+

Bloom value (global glow).

.. _class_Environment_property_glow_enabled:

- :ref:`bool<class_bool>` **glow_enabled**

+-----------+-------------------------+
| *Default* | false                   |
+-----------+-------------------------+
| *Setter*  | set_glow_enabled(value) |
+-----------+-------------------------+
| *Getter*  | is_glow_enabled()       |
+-----------+-------------------------+

Enables glow rendering.

.. _class_Environment_property_glow_hdr_luminance_cap:

- :ref:`float<class_float>` **glow_hdr_luminance_cap**

+-----------+-----------------------------------+
| *Default* | 12.0                              |
+-----------+-----------------------------------+
| *Setter*  | set_glow_hdr_luminance_cap(value) |
+-----------+-----------------------------------+
| *Getter*  | get_glow_hdr_luminance_cap()      |
+-----------+-----------------------------------+

.. _class_Environment_property_glow_hdr_scale:

- :ref:`float<class_float>` **glow_hdr_scale**

+-----------+---------------------------------+
| *Default* | 2.0                             |
+-----------+---------------------------------+
| *Setter*  | set_glow_hdr_bleed_scale(value) |
+-----------+---------------------------------+
| *Getter*  | get_glow_hdr_bleed_scale()      |
+-----------+---------------------------------+

Bleed scale of the HDR glow.

.. _class_Environment_property_glow_hdr_threshold:

- :ref:`float<class_float>` **glow_hdr_threshold**

+-----------+-------------------------------------+
| *Default* | 1.0                                 |
+-----------+-------------------------------------+
| *Setter*  | set_glow_hdr_bleed_threshold(value) |
+-----------+-------------------------------------+
| *Getter*  | get_glow_hdr_bleed_threshold()      |
+-----------+-------------------------------------+

Bleed threshold of the HDR glow.

.. _class_Environment_property_glow_intensity:

- :ref:`float<class_float>` **glow_intensity**

+-----------+---------------------------+
| *Default* | 0.8                       |
+-----------+---------------------------+
| *Setter*  | set_glow_intensity(value) |
+-----------+---------------------------+
| *Getter*  | get_glow_intensity()      |
+-----------+---------------------------+

Glow intensity.

.. _class_Environment_property_glow_levels/1:

- :ref:`bool<class_bool>` **glow_levels/1**

+-----------+-------------------------+
| *Default* | false                   |
+-----------+-------------------------+
| *Setter*  | set_glow_level(value)   |
+-----------+-------------------------+
| *Getter*  | is_glow_level_enabled() |
+-----------+-------------------------+

First level of glow (most local).

.. _class_Environment_property_glow_levels/2:

- :ref:`bool<class_bool>` **glow_levels/2**

+-----------+-------------------------+
| *Default* | false                   |
+-----------+-------------------------+
| *Setter*  | set_glow_level(value)   |
+-----------+-------------------------+
| *Getter*  | is_glow_level_enabled() |
+-----------+-------------------------+

Second level of glow.

.. _class_Environment_property_glow_levels/3:

- :ref:`bool<class_bool>` **glow_levels/3**

+-----------+-------------------------+
| *Default* | true                    |
+-----------+-------------------------+
| *Setter*  | set_glow_level(value)   |
+-----------+-------------------------+
| *Getter*  | is_glow_level_enabled() |
+-----------+-------------------------+

Third level of glow.

.. _class_Environment_property_glow_levels/4:

- :ref:`bool<class_bool>` **glow_levels/4**

+-----------+-------------------------+
| *Default* | false                   |
+-----------+-------------------------+
| *Setter*  | set_glow_level(value)   |
+-----------+-------------------------+
| *Getter*  | is_glow_level_enabled() |
+-----------+-------------------------+

Fourth level of glow.

.. _class_Environment_property_glow_levels/5:

- :ref:`bool<class_bool>` **glow_levels/5**

+-----------+-------------------------+
| *Default* | true                    |
+-----------+-------------------------+
| *Setter*  | set_glow_level(value)   |
+-----------+-------------------------+
| *Getter*  | is_glow_level_enabled() |
+-----------+-------------------------+

Fifth level of glow.

.. _class_Environment_property_glow_levels/6:

- :ref:`bool<class_bool>` **glow_levels/6**

+-----------+-------------------------+
| *Default* | false                   |
+-----------+-------------------------+
| *Setter*  | set_glow_level(value)   |
+-----------+-------------------------+
| *Getter*  | is_glow_level_enabled() |
+-----------+-------------------------+

Sixth level of glow.

.. _class_Environment_property_glow_levels/7:

- :ref:`bool<class_bool>` **glow_levels/7**

+-----------+-------------------------+
| *Default* | false                   |
+-----------+-------------------------+
| *Setter*  | set_glow_level(value)   |
+-----------+-------------------------+
| *Getter*  | is_glow_level_enabled() |
+-----------+-------------------------+

Seventh level of glow (most global).

.. _class_Environment_property_glow_strength:

- :ref:`float<class_float>` **glow_strength**

+-----------+--------------------------+
| *Default* | 1.0                      |
+-----------+--------------------------+
| *Setter*  | set_glow_strength(value) |
+-----------+--------------------------+
| *Getter*  | get_glow_strength()      |
+-----------+--------------------------+

Glow strength.

.. _class_Environment_property_ss_reflections_depth_tolerance:

- :ref:`float<class_float>` **ss_reflections_depth_tolerance**

+-----------+--------------------------------+
| *Default* | 0.2                            |
+-----------+--------------------------------+
| *Setter*  | set_ssr_depth_tolerance(value) |
+-----------+--------------------------------+
| *Getter*  | get_ssr_depth_tolerance()      |
+-----------+--------------------------------+

.. _class_Environment_property_ss_reflections_enabled:

- :ref:`bool<class_bool>` **ss_reflections_enabled**

+-----------+------------------------+
| *Default* | false                  |
+-----------+------------------------+
| *Setter*  | set_ssr_enabled(value) |
+-----------+------------------------+
| *Getter*  | is_ssr_enabled()       |
+-----------+------------------------+

.. _class_Environment_property_ss_reflections_fade_in:

- :ref:`float<class_float>` **ss_reflections_fade_in**

+-----------+------------------------+
| *Default* | 0.15                   |
+-----------+------------------------+
| *Setter*  | set_ssr_fade_in(value) |
+-----------+------------------------+
| *Getter*  | get_ssr_fade_in()      |
+-----------+------------------------+

.. _class_Environment_property_ss_reflections_fade_out:

- :ref:`float<class_float>` **ss_reflections_fade_out**

+-----------+-------------------------+
| *Default* | 2.0                     |
+-----------+-------------------------+
| *Setter*  | set_ssr_fade_out(value) |
+-----------+-------------------------+
| *Getter*  | get_ssr_fade_out()      |
+-----------+-------------------------+

.. _class_Environment_property_ss_reflections_max_steps:

- :ref:`int<class_int>` **ss_reflections_max_steps**

+-----------+--------------------------+
| *Default* | 64                       |
+-----------+--------------------------+
| *Setter*  | set_ssr_max_steps(value) |
+-----------+--------------------------+
| *Getter*  | get_ssr_max_steps()      |
+-----------+--------------------------+

.. _class_Environment_property_ss_reflections_roughness:

- :ref:`bool<class_bool>` **ss_reflections_roughness**

+-----------+----------------------+
| *Default* | true                 |
+-----------+----------------------+
| *Setter*  | set_ssr_rough(value) |
+-----------+----------------------+
| *Getter*  | is_ssr_rough()       |
+-----------+----------------------+

.. _class_Environment_property_ssao_ao_channel_affect:

- :ref:`float<class_float>` **ssao_ao_channel_affect**

+-----------+-----------------------------------+
| *Default* | 0.0                               |
+-----------+-----------------------------------+
| *Setter*  | set_ssao_ao_channel_affect(value) |
+-----------+-----------------------------------+
| *Getter*  | get_ssao_ao_channel_affect()      |
+-----------+-----------------------------------+

.. _class_Environment_property_ssao_bias:

- :ref:`float<class_float>` **ssao_bias**

+-----------+----------------------+
| *Default* | 0.01                 |
+-----------+----------------------+
| *Setter*  | set_ssao_bias(value) |
+-----------+----------------------+
| *Getter*  | get_ssao_bias()      |
+-----------+----------------------+

.. _class_Environment_property_ssao_blur:

- :ref:`SSAOBlur<enum_Environment_SSAOBlur>` **ssao_blur**

+-----------+----------------------+
| *Default* | 3                    |
+-----------+----------------------+
| *Setter*  | set_ssao_blur(value) |
+-----------+----------------------+
| *Getter*  | get_ssao_blur()      |
+-----------+----------------------+

.. _class_Environment_property_ssao_color:

- :ref:`Color<class_Color>` **ssao_color**

+-----------+-----------------------+
| *Default* | Color( 0, 0, 0, 1 )   |
+-----------+-----------------------+
| *Setter*  | set_ssao_color(value) |
+-----------+-----------------------+
| *Getter*  | get_ssao_color()      |
+-----------+-----------------------+

.. _class_Environment_property_ssao_edge_sharpness:

- :ref:`float<class_float>` **ssao_edge_sharpness**

+-----------+--------------------------------+
| *Default* | 4.0                            |
+-----------+--------------------------------+
| *Setter*  | set_ssao_edge_sharpness(value) |
+-----------+--------------------------------+
| *Getter*  | get_ssao_edge_sharpness()      |
+-----------+--------------------------------+

.. _class_Environment_property_ssao_enabled:

- :ref:`bool<class_bool>` **ssao_enabled**

+-----------+-------------------------+
| *Default* | false                   |
+-----------+-------------------------+
| *Setter*  | set_ssao_enabled(value) |
+-----------+-------------------------+
| *Getter*  | is_ssao_enabled()       |
+-----------+-------------------------+

.. _class_Environment_property_ssao_intensity:

- :ref:`float<class_float>` **ssao_intensity**

+-----------+---------------------------+
| *Default* | 1.0                       |
+-----------+---------------------------+
| *Setter*  | set_ssao_intensity(value) |
+-----------+---------------------------+
| *Getter*  | get_ssao_intensity()      |
+-----------+---------------------------+

.. _class_Environment_property_ssao_intensity2:

- :ref:`float<class_float>` **ssao_intensity2**

+-----------+----------------------------+
| *Default* | 1.0                        |
+-----------+----------------------------+
| *Setter*  | set_ssao_intensity2(value) |
+-----------+----------------------------+
| *Getter*  | get_ssao_intensity2()      |
+-----------+----------------------------+

.. _class_Environment_property_ssao_light_affect:

- :ref:`float<class_float>` **ssao_light_affect**

+-----------+-------------------------------------+
| *Default* | 0.0                                 |
+-----------+-------------------------------------+
| *Setter*  | set_ssao_direct_light_affect(value) |
+-----------+-------------------------------------+
| *Getter*  | get_ssao_direct_light_affect()      |
+-----------+-------------------------------------+

.. _class_Environment_property_ssao_quality:

- :ref:`SSAOQuality<enum_Environment_SSAOQuality>` **ssao_quality**

+-----------+-------------------------+
| *Default* | 1                       |
+-----------+-------------------------+
| *Setter*  | set_ssao_quality(value) |
+-----------+-------------------------+
| *Getter*  | get_ssao_quality()      |
+-----------+-------------------------+

.. _class_Environment_property_ssao_radius:

- :ref:`float<class_float>` **ssao_radius**

+-----------+------------------------+
| *Default* | 1.0                    |
+-----------+------------------------+
| *Setter*  | set_ssao_radius(value) |
+-----------+------------------------+
| *Getter*  | get_ssao_radius()      |
+-----------+------------------------+

.. _class_Environment_property_ssao_radius2:

- :ref:`float<class_float>` **ssao_radius2**

+-----------+-------------------------+
| *Default* | 0.0                     |
+-----------+-------------------------+
| *Setter*  | set_ssao_radius2(value) |
+-----------+-------------------------+
| *Getter*  | get_ssao_radius2()      |
+-----------+-------------------------+

.. _class_Environment_property_tonemap_exposure:

- :ref:`float<class_float>` **tonemap_exposure**

+-----------+-----------------------------+
| *Default* | 1.0                         |
+-----------+-----------------------------+
| *Setter*  | set_tonemap_exposure(value) |
+-----------+-----------------------------+
| *Getter*  | get_tonemap_exposure()      |
+-----------+-----------------------------+

Default exposure for tonemap.

.. _class_Environment_property_tonemap_mode:

- :ref:`ToneMapper<enum_Environment_ToneMapper>` **tonemap_mode**

+-----------+-----------------------+
| *Default* | 0                     |
+-----------+-----------------------+
| *Setter*  | set_tonemapper(value) |
+-----------+-----------------------+
| *Getter*  | get_tonemapper()      |
+-----------+-----------------------+

Tonemapping mode.

.. _class_Environment_property_tonemap_white:

- :ref:`float<class_float>` **tonemap_white**

+-----------+--------------------------+
| *Default* | 1.0                      |
+-----------+--------------------------+
| *Setter*  | set_tonemap_white(value) |
+-----------+--------------------------+
| *Getter*  | get_tonemap_white()      |
+-----------+--------------------------+

White reference value for tonemap.

Method Descriptions
-------------------

.. _class_Environment_method_is_glow_level_enabled:

- :ref:`bool<class_bool>` **is_glow_level_enabled** **(** :ref:`int<class_int>` idx **)** const

.. _class_Environment_method_set_glow_level:

- void **set_glow_level** **(** :ref:`int<class_int>` idx, :ref:`bool<class_bool>` enabled **)**