Environment

Inherits: Resource < Reference < Object

Recurso para nodos del entorno (como WorldEnvironment) que definen múltiples opciones de renderización.

Descripción

Resource for environment nodes (like WorldEnvironment) that define multiple environment operations (such as background Sky or 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

These effects will only apply when the Viewport's intended usage is "3D" or "3D Without Effects". This can be configured for the root Viewport with ProjectSettings.rendering/quality/intended_usage/framebuffer_allocation, or for specific Viewports via the Viewport.usage property.

Tutoriales

Propiedades

float

adjustment_brightness

1.0

Texture

adjustment_color_correction

float

adjustment_contrast

1.0

bool

adjustment_enabled

false

float

adjustment_saturation

1.0

Color

ambient_light_color

Color( 0, 0, 0, 1 )

float

ambient_light_energy

1.0

float

ambient_light_sky_contribution

1.0

bool

auto_exposure_enabled

false

float

auto_exposure_max_luma

8.0

float

auto_exposure_min_luma

0.05

float

auto_exposure_scale

0.4

float

auto_exposure_speed

0.5

int

background_camera_feed_id

1

int

background_canvas_max_layer

0

Color

background_color

Color( 0, 0, 0, 1 )

float

background_energy

1.0

BGMode

background_mode

0

Sky

background_sky

float

background_sky_custom_fov

0.0

Basis

background_sky_orientation

Basis( 1, 0, 0, 0, 1, 0, 0, 0, 1 )

Vector3

background_sky_rotation

Vector3( 0, 0, 0 )

Vector3

background_sky_rotation_degrees

Vector3( 0, 0, 0 )

float

dof_blur_far_amount

0.1

float

dof_blur_far_distance

10.0

bool

dof_blur_far_enabled

false

DOFBlurQuality

dof_blur_far_quality

1

float

dof_blur_far_transition

5.0

float

dof_blur_near_amount

0.1

float

dof_blur_near_distance

2.0

bool

dof_blur_near_enabled

false

DOFBlurQuality

dof_blur_near_quality

1

float

dof_blur_near_transition

1.0

Color

fog_color

Color( 0.5, 0.6, 0.7, 1 )

float

fog_depth_begin

10.0

float

fog_depth_curve

1.0

bool

fog_depth_enabled

true

float

fog_depth_end

100.0

bool

fog_enabled

false

float

fog_height_curve

1.0

bool

fog_height_enabled

false

float

fog_height_max

0.0

float

fog_height_min

10.0

float

fog_sun_amount

0.0

Color

fog_sun_color

Color( 1, 0.9, 0.7, 1 )

float

fog_transmit_curve

1.0

bool

fog_transmit_enabled

false

bool

glow_bicubic_upscale

false

GlowBlendMode

glow_blend_mode

2

float

glow_bloom

0.0

bool

glow_enabled

false

float

glow_hdr_luminance_cap

12.0

float

glow_hdr_scale

2.0

float

glow_hdr_threshold

1.0

bool

glow_high_quality

false

float

glow_intensity

0.8

bool

glow_levels/1

false

bool

glow_levels/2

false

bool

glow_levels/3

true

bool

glow_levels/4

false

bool

glow_levels/5

true

bool

glow_levels/6

false

bool

glow_levels/7

false

float

glow_strength

1.0

float

ss_reflections_depth_tolerance

0.2

bool

ss_reflections_enabled

false

float

ss_reflections_fade_in

0.15

float

ss_reflections_fade_out

2.0

int

ss_reflections_max_steps

64

bool

ss_reflections_roughness

true

float

ssao_ao_channel_affect

0.0

float

ssao_bias

0.01

SSAOBlur

ssao_blur

3

Color

ssao_color

Color( 0, 0, 0, 1 )

float

ssao_edge_sharpness

4.0

bool

ssao_enabled

false

float

ssao_intensity

1.0

float

ssao_intensity2

1.0

float

ssao_light_affect

0.0

SSAOQuality

ssao_quality

1

float

ssao_radius

1.0

float

ssao_radius2

0.0

float

tonemap_exposure

1.0

ToneMapper

tonemap_mode

0

float

tonemap_white

1.0

Métodos

bool

is_glow_level_enabled ( int idx ) const

void

set_glow_level ( int idx, bool enabled )

Enumeraciones

enum BGMode:

  • BG_KEEP = 5 --- Mantiene en pantalla cada píxel dibujado en el fondo. Este es el modo de fondo más rápido, pero sólo puede ser usado con seguridad en escenas de interior (sin reflejos visibles en el cielo o en el cielo). Si se activa en una escena en la que el fondo es visible, los artefactos de "rastro fantasma" serán visibles al mover la cámara.

  • BG_CLEAR_COLOR = 0 --- Borra el fondo usando el color claro definido en ProjectSettings.rendering/environment/default_clear_color.

  • BG_COLOR = 1 --- Despeja el fondo usando un color claro personalizado.

  • BG_SKY = 2 --- Muestra un cielo definido por el usuario en el fondo.

  • BG_COLOR_SKY = 3 --- Clears the background using a custom clear color and allows defining a sky for shading and reflection. This mode is slightly faster than BG_SKY and should be preferred in scenes where reflections can be visible, but the sky itself never is (e.g. top-down camera).

  • BG_CANVAS = 4 --- Muestra una CanvasLayer en el fondo.

  • BG_CAMERA_FEED = 6 --- Muestra un feed de una cámara en el fondo.

  • BG_MAX = 7 --- Representa el tamaño del enum BGMode.


enum GlowBlendMode:

  • GLOW_BLEND_MODE_ADDITIVE = 0 --- Modo de mezcla de brillo aditivo. Se utiliza principalmente para partículas, brillos (florecimiento), destellos de lentes, fuentes brillantes.

  • GLOW_BLEND_MODE_SCREEN = 1 --- Modo de mezcla de brillo de pantalla. Aumenta el brillo, se usa frecuentemente con el bloom.

  • GLOW_BLEND_MODE_SOFTLIGHT = 2 --- Modo de mezcla de brillo de luz suave. Modifica el contraste, expone sombras y luces (bloom vivo).

  • GLOW_BLEND_MODE_REPLACE = 3 --- Reemplazar el modo de mezcla de brillo. Reemplaza el color de todos los píxeles por el valor de brillo. Puede utilizarse para simular un efecto de desenfoque en pantalla completa ajustando los parámetros de brillo para que coincidan con el brillo de la imagen original.


enum ToneMapper:

  • TONE_MAPPER_LINEAR = 0 --- Operador lineal de mapas de tonos. Lee los datos lineales y los transmite sin modificar.

  • TONE_MAPPER_REINHARDT = 1 --- Operador de mapeado de tonos Reinhardt. Realiza una variación de los colores de los píxeles renderizados por esta fórmula: color = color / (1 + color).

  • TONE_MAPPER_FILMIC = 2 --- Operador de mazos fílmicos.

  • TONE_MAPPER_ACES = 3 --- Academy Color Encoding System tonemapper operator. Performs an aproximation of the ACES tonemapping curve.

  • TONE_MAPPER_ACES_FITTED = 4 --- High quality Academy Color Encoding System tonemapper operator that matches the industry standard. Performs a more physically accurate curve fit which better simulates how light works in the real world. The color of lights and emissive materials will become lighter as the emissive energy increases, and will eventually become white if the light is bright enough to saturate the camera sensor.


enum DOFBlurQuality:

  • DOF_BLUR_QUALITY_LOW = 0 --- Low depth-of-field blur quality (fastest).

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

  • DOF_BLUR_QUALITY_HIGH = 2 --- High depth-of-field blur quality (slowest).


enum SSAOBlur:

  • SSAO_BLUR_DISABLED = 0 --- No hay desenfoque para el efecto de oclusión ambiental del espacio de la pantalla (más rápido).

  • SSAO_BLUR_1x1 = 1 --- Desenfoque de 1×1 para el efecto de oclusión ambiental del espacio de la pantalla.

  • SSAO_BLUR_2x2 = 2 --- Desenfoque de 2×2 para el efecto de oclusión ambiental del espacio de la pantalla.

  • SSAO_BLUR_3x3 = 3 --- 3×3 blur for the screen-space ambient occlusion effect (slowest).


enum SSAOQuality:

  • SSAO_QUALITY_LOW = 0 --- Low quality for the screen-space ambient occlusion effect (fastest).

  • SSAO_QUALITY_MEDIUM = 1 --- Low quality for the screen-space ambient occlusion effect.

  • SSAO_QUALITY_HIGH = 2 --- Low quality for the screen-space ambient occlusion effect (slowest).

Descripciones de Propiedades

  • float adjustment_brightness

Default

1.0

Setter

set_adjustment_brightness(value)

Getter

get_adjustment_brightness()

El valor de brillo global de la escena renderizada. Efectivo sólo si adjustment_enabled es true.


  • Texture adjustment_color_correction

Setter

set_adjustment_color_correction(value)

Getter

get_adjustment_color_correction()

Applies the provided Texture resource to affect the global color aspect of the rendered scene. Effective only if adjustment_enabled is true.


  • float adjustment_contrast

Default

1.0

Setter

set_adjustment_contrast(value)

Getter

get_adjustment_contrast()

El valor de contraste global de la escena renderizada (el valor por defecto es 1). Efectivo sólo si adjustment_enabled es true.


  • bool adjustment_enabled

Default

false

Setter

set_adjustment_enable(value)

Getter

is_adjustment_enabled()

Si true, activa las propiedades adjustment_* proporcionadas por este recurso. Si false, las modificaciones de las propiedades de adjustment_* no tendrán ningún efecto en la escena renderizada.


  • float adjustment_saturation

Default

1.0

Setter

set_adjustment_saturation(value)

Getter

get_adjustment_saturation()

El valor de saturación de color global de la escena renderizada (el valor por defecto es 1). Efectivo sólo si adjustment_enabled es true.


  • Color ambient_light_color

Default

Color( 0, 0, 0, 1 )

Setter

set_ambient_light_color(value)

Getter

get_ambient_light_color()

El Color de la luz ambiental.


  • float ambient_light_energy

Default

1.0

Setter

set_ambient_light_energy(value)

Getter

get_ambient_light_energy()

La energía de la luz ambiental. Cuanto más alto es el valor, más fuerte es la luz.


  • float ambient_light_sky_contribution

Default

1.0

Setter

set_ambient_light_sky_contribution(value)

Getter

get_ambient_light_sky_contribution()

Define la cantidad de luz que el cielo trae a la escena. Un valor de 0 significa que la emisión de luz del cielo no tiene efecto en la iluminación de la escena, por lo tanto toda la iluminación ambiental es proporcionada por la luz ambiental. Por el contrario, un valor de 1 significa que toda la luz que afecta a la escena es proporcionada por el cielo, por lo tanto el parámetro de luz ambiental no tiene efecto en la escena.


  • bool auto_exposure_enabled

Default

false

Setter

set_tonemap_auto_exposure(value)

Getter

get_tonemap_auto_exposure()

Si true, habilita el modo de exposición automática del mapa de tonos del renderizador de escenas. Si true, el renderizador determinará automáticamente el ajuste de exposición para adaptarse a la iluminación de la escena y a la luz observada.


  • float auto_exposure_max_luma

Default

8.0

Setter

set_tonemap_auto_exposure_max(value)

Getter

get_tonemap_auto_exposure_max()

El valor máximo de luminosidad para la exposición automática.


  • float auto_exposure_min_luma

Default

0.05

Setter

set_tonemap_auto_exposure_min(value)

Getter

get_tonemap_auto_exposure_min()

El valor mínimo de luminosidad para la exposición automática.


  • float auto_exposure_scale

Default

0.4

Setter

set_tonemap_auto_exposure_grey(value)

Getter

get_tonemap_auto_exposure_grey()

La escala del efecto de la exposición automática. Afecta a la intensidad de la exposición automática.


  • float auto_exposure_speed

Default

0.5

Setter

set_tonemap_auto_exposure_speed(value)

Getter

get_tonemap_auto_exposure_speed()

La velocidad del efecto de la exposición automática. Afecta al tiempo necesario para que la cámara realice la exposición automática.


  • int background_camera_feed_id

Default

1

Setter

set_camera_feed_id(value)

Getter

get_camera_feed_id()

La identificación de la feed de la cámara para mostrarla en el fondo.


  • int background_canvas_max_layer

Default

0

Setter

set_canvas_max_layer(value)

Getter

get_canvas_max_layer()

El ID de la capa maxima a mostrar. Sólo es efectivo cuando se utiliza el modo de fondo BG_CANVAS.


Default

Color( 0, 0, 0, 1 )

Setter

set_bg_color(value)

Getter

get_bg_color()

The Color displayed for clear areas of the scene. Only effective when using the BG_COLOR or BG_COLOR_SKY background modes).


  • float background_energy

Default

1.0

Setter

set_bg_energy(value)

Getter

get_bg_energy()

El poder de la luz emitida por el fondo.


Default

0

Setter

set_background(value)

Getter

get_background()

El modo de fondo. Ver BGMode para los posibles valores.


  • Sky background_sky

Setter

set_sky(value)

Getter

get_sky()

The Sky resource defined as background.


  • float background_sky_custom_fov

Default

0.0

Setter

set_sky_custom_fov(value)

Getter

get_sky_custom_fov()

The Sky resource's custom field of view.


  • Basis background_sky_orientation

Default

Basis( 1, 0, 0, 0, 1, 0, 0, 0, 1 )

Setter

set_sky_orientation(value)

Getter

get_sky_orientation()

The Sky resource's rotation expressed as a Basis.


Default

Vector3( 0, 0, 0 )

Setter

set_sky_rotation(value)

Getter

get_sky_rotation()

The Sky resource's rotation expressed as Euler angles in radians.


  • Vector3 background_sky_rotation_degrees

Default

Vector3( 0, 0, 0 )

Setter

set_sky_rotation_degrees(value)

Getter

get_sky_rotation_degrees()

The Sky resource's rotation expressed as Euler angles in degrees.


  • float dof_blur_far_amount

Default

0.1

Setter

set_dof_blur_far_amount(value)

Getter

get_dof_blur_far_amount()

The amount of far blur for the depth-of-field effect.


  • float dof_blur_far_distance

Default

10.0

Setter

set_dof_blur_far_distance(value)

Getter

get_dof_blur_far_distance()

La distancia desde la cámara en la que el efecto de borrosidad afecta a la representación.


  • bool dof_blur_far_enabled

Default

false

Setter

set_dof_blur_far_enabled(value)

Getter

is_dof_blur_far_enabled()

If true, enables the depth-of-field far blur effect.


Default

1

Setter

set_dof_blur_far_quality(value)

Getter

get_dof_blur_far_quality()

The depth-of-field far blur's quality. Higher values can mitigate the visible banding effect seen at higher strengths, but are much slower.


  • float dof_blur_far_transition

Default

5.0

Setter

set_dof_blur_far_transition(value)

Getter

get_dof_blur_far_transition()

La longitud de la transición entre la zona no borrosa y la borrosa lejana.


  • float dof_blur_near_amount

Default

0.1

Setter

set_dof_blur_near_amount(value)

Getter

get_dof_blur_near_amount()

The amount of near blur for the depth-of-field effect.


  • float dof_blur_near_distance

Default

2.0

Setter

set_dof_blur_near_distance(value)

Getter

get_dof_blur_near_distance()

Distancia desde la cámara donde el efecto de casi borrosidad afecta al renderizado.


  • bool dof_blur_near_enabled

Default

false

Setter

set_dof_blur_near_enabled(value)

Getter

is_dof_blur_near_enabled()

If true, enables the depth-of-field near blur effect.


Default

1

Setter

set_dof_blur_near_quality(value)

Getter

get_dof_blur_near_quality()

The depth-of-field near blur's quality. Higher values can mitigate the visible banding effect seen at higher strengths, but are much slower.


  • float dof_blur_near_transition

Default

1.0

Setter

set_dof_blur_near_transition(value)

Getter

get_dof_blur_near_transition()

La longitud de la transición entre la zona casi borrosa y la zona no borrosa.


Default

Color( 0.5, 0.6, 0.7, 1 )

Setter

set_fog_color(value)

Getter

get_fog_color()

El Color de la niebla.


Default

10.0

Setter

set_fog_depth_begin(value)

Getter

get_fog_depth_begin()

La profundidad de la niebla es la distancia inicial de la cámara.


Default

1.0

Setter

set_fog_depth_curve(value)

Getter

get_fog_depth_curve()

La curva de intensidad de la profundidad de la niebla. En el Inspector se puede acceder a una serie de preajustes haciendo clic con el botón derecho del ratón en la curva.


  • bool fog_depth_enabled

Default

true

Setter

set_fog_depth_enabled(value)

Getter

is_fog_depth_enabled()

Si true, se activa el efecto de niebla de profundidad. Cuando se habilita, la niebla aparecerá en la distancia (relativa a la cámara).


Default

100.0

Setter

set_fog_depth_end(value)

Getter

get_fog_depth_end()

The fog's depth end distance from the camera. If this value is set to 0, it will be equal to the current camera's Camera.far value.


Default

false

Setter

set_fog_enabled(value)

Getter

is_fog_enabled()

Si true, se activan los efectos de la niebla. fog_height_enabled y/o fog_depth_enabled deben estar ajustados a true para mostrar realmente la niebla.


Default

1.0

Setter

set_fog_height_curve(value)

Getter

get_fog_height_curve()

La intensidad de la niebla de altura. Se puede acceder a un número de preajustes en el Inspector haciendo clic derecho en la curva.


  • bool fog_height_enabled

Default

false

Setter

set_fog_height_enabled(value)

Getter

is_fog_height_enabled()

Si true, se activa el efecto de niebla de altura. Cuando se habilita, la niebla aparecerá en un rango de altura definido, independientemente de la distancia de la cámara. Esto puede utilizarse para simular efectos de "aguas profundas" con un coste de rendimiento menor en comparación con un sombreador dedicado.


Default

0.0

Setter

set_fog_height_max(value)

Getter

get_fog_height_max()

La coordenada Y donde la niebla de altura será más intensa. Si este valor es mayor que fog_height_min, la niebla se mostrará de abajo hacia arriba. De lo contrario, se mostrará de arriba a abajo.


Default

10.0

Setter

set_fog_height_min(value)

Getter

get_fog_height_min()

La coordenada Y donde la niebla de altura será menos intensa. Si este valor es mayor que fog_height_max, la niebla se mostrará de arriba a abajo. De lo contrario, se mostrará de abajo hacia arriba.


Default

0.0

Setter

set_fog_sun_amount(value)

Getter

get_fog_sun_amount()

The intensity of the depth fog color transition when looking towards the sun. The sun's direction is determined automatically using the DirectionalLight node in the scene.


Default

Color( 1, 0.9, 0.7, 1 )

Setter

set_fog_sun_color(value)

Getter

get_fog_sun_color()

El Color de la niebla profunda cuando se mira hacia el sol.


  • float fog_transmit_curve

Default

1.0

Setter

set_fog_transmit_curve(value)

Getter

get_fog_transmit_curve()

La intensidad del efecto de transmisión de la luz de la niebla. La cantidad de luz que la niebla transmite.


  • bool fog_transmit_enabled

Default

false

Setter

set_fog_transmit_enabled(value)

Getter

is_fog_transmit_enabled()

Permite el efecto de transmisión de la luz de la niebla. Si true, la luz será más visible en la niebla para simular la dispersión de la luz como en la vida real.


  • bool glow_bicubic_upscale

Default

false

Setter

set_glow_bicubic_upscale(value)

Getter

is_glow_bicubic_upscale_enabled()

Smooths out the blockiness created by sampling higher levels, at the cost of performance.

Note: When using the GLES2 renderer, this is only available if the GPU supports the GL_EXT_gpu_shader4 extension.


Default

2

Setter

set_glow_blend_mode(value)

Getter

get_glow_blend_mode()

El modo de mezcla de brillo.


Default

0.0

Setter

set_glow_bloom(value)

Getter

get_glow_bloom()

La intensidad del bloom. Si se ajusta a un valor superior a 0, esto hará que el brillo sea visible en áreas más oscuras que el glow_hdr_threshold.


Default

false

Setter

set_glow_enabled(value)

Getter

is_glow_enabled()

Si true, se activa el efecto de brillo.


  • float glow_hdr_luminance_cap

Default

12.0

Setter

set_glow_hdr_luminance_cap(value)

Getter

get_glow_hdr_luminance_cap()

El umbral más alto del brillo del HDR. Las áreas más brillantes que este umbral serán fijadas para el efecto de brillo.


Default

2.0

Setter

set_glow_hdr_bleed_scale(value)

Getter

get_glow_hdr_bleed_scale()

La escala de sangrado del brillo del HDR.


  • float glow_hdr_threshold

Default

1.0

Setter

set_glow_hdr_bleed_threshold(value)

Getter

get_glow_hdr_bleed_threshold()

El umbral inferior del brillo del HDR. Cuando se utiliza el renderizador GLES2 (que no soporta HDR), este debe estar por debajo de 1.0 para que el brillo sea visible. Un valor de 0.9 funciona bien en este caso.


  • bool glow_high_quality

Default

false

Setter

set_glow_high_quality(value)

Getter

is_glow_high_quality_enabled()

Takes more samples during downsample pass of glow. This ensures that single pixels are captured by glow which makes the glow look smoother and more stable during movement. However, it is very expensive and makes the glow post process take twice as long.


Default

0.8

Setter

set_glow_intensity(value)

Getter

get_glow_intensity()

La intensidad del brillo. Cuando se utiliza el renderizador GLES2, debe aumentarse a 1,5 para compensar la falta de renderización HDR.


  • bool glow_levels/1

Default

false

Setter

set_glow_level(value)

Getter

is_glow_level_enabled()

Si true, el 1er nivel de brillo está activado. Este es el nivel más "local" (menos borroso).


  • bool glow_levels/2

Default

false

Setter

set_glow_level(value)

Getter

is_glow_level_enabled()

Si true, se activa el 2º nivel de brillo.


  • bool glow_levels/3

Default

true

Setter

set_glow_level(value)

Getter

is_glow_level_enabled()

Si true, se activa el 3º nivel de brillo.


  • bool glow_levels/4

Default

false

Setter

set_glow_level(value)

Getter

is_glow_level_enabled()

Si true, se activa el 4º nivel de brillo.


  • bool glow_levels/5

Default

true

Setter

set_glow_level(value)

Getter

is_glow_level_enabled()

Si true, el 5º nivel de brillo está activado.


  • bool glow_levels/6

Default

false

Setter

set_glow_level(value)

Getter

is_glow_level_enabled()

Si true, el 6º nivel de brillo está activado.


  • bool glow_levels/7

Default

false

Setter

set_glow_level(value)

Getter

is_glow_level_enabled()

Si true, el 7º nivel de brillo está activado. Este es el nivel más "global" (más borroso).


Default

1.0

Setter

set_glow_strength(value)

Getter

get_glow_strength()

La fuerza del brillo. Cuando se utiliza el renderizador GLES2, debe aumentarse a 1,3 para compensar la falta de renderización HDR.


  • float ss_reflections_depth_tolerance

Default

0.2

Setter

set_ssr_depth_tolerance(value)

Getter

get_ssr_depth_tolerance()

La tolerancia de profundidad para los reflejos del espacio de la pantalla.


  • bool ss_reflections_enabled

Default

false

Setter

set_ssr_enabled(value)

Getter

is_ssr_enabled()

Si true, se activan los reflejos en el espacio de la pantalla. Los reflejos del espacio de la pantalla son más precisos que los de GIProbes o ReflectionProbes, pero son más lentos y no pueden reflejar superficies ocluidas por otros.


  • float ss_reflections_fade_in

Default

0.15

Setter

set_ssr_fade_in(value)

Getter

get_ssr_fade_in()

La distancia de desvanecimiento para los reflejos del espacio de la pantalla. afecta al área desde el material reflejado hasta el reflejo del espacio de la pantalla).


  • float ss_reflections_fade_out

Default

2.0

Setter

set_ssr_fade_out(value)

Getter

get_ssr_fade_out()

La distancia de desvanecimiento para los reflejos del espacio de la pantalla. afecta al área que va desde el reflejo del espacio de la pantalla hasta el reflejo "global".


  • int ss_reflections_max_steps

Default

64

Setter

set_ssr_max_steps(value)

Getter

get_ssr_max_steps()

El número máximo de pasos para los reflejos en el espacio de la pantalla. Los valores más altos son más lentos.


  • bool ss_reflections_roughness

Default

true

Setter

set_ssr_rough(value)

Getter

is_ssr_rough()

If true, screen-space reflections will take the material roughness into account.


  • float ssao_ao_channel_affect

Default

0.0

Setter

set_ssao_ao_channel_affect(value)

Getter

get_ssao_ao_channel_affect()

La intensidad de la oclusión ambiental del espacio de pantalla en los materiales que tienen una textura de AO definida. Los valores superiores a 0 harán visible el efecto SSAO en las áreas oscurecidas por las texturas de AO.


Default

0.01

Setter

set_ssao_bias(value)

Getter

get_ssao_bias()

El sesgo de oclusión ambiental del espacio de la pantalla. Debe mantenerse lo suficientemente alto para evitar que las curvas "suaves" se vean afectadas por la oclusión ambiental.


Default

3

Setter

set_ssao_blur(value)

Getter

get_ssao_blur()

La calidad de la difusión de la oclusión ambiental del espacio de la pantalla. Ver SSAOBlur para los posibles valores.


Default

Color( 0, 0, 0, 1 )

Setter

set_ssao_color(value)

Getter

get_ssao_color()

The screen-space ambient occlusion color.


  • float ssao_edge_sharpness

Default

4.0

Setter

set_ssao_edge_sharpness(value)

Getter

get_ssao_edge_sharpness()

La nitidez del borde de oclusión ambiental del espacio de la pantalla.


Default

false

Setter

set_ssao_enabled(value)

Getter

is_ssao_enabled()

Si true, se activa el efecto de oclusión ambiental del espacio de pantalla. Esto oscurece las esquinas y cavidades de los objetos para simular que la luz ambiental no llega a todo el objeto como en la vida real. Esto funciona bien para objetos pequeños y dinámicos, pero la iluminación cocinada o las texturas de oclusión ambiental funcionarán mejor para mostrar la oclusión ambiental en grandes objetos estáticos. Este es un efecto costoso y debe ser desactivado primero cuando se presenten problemas de rendimiento.


Default

1.0

Setter

set_ssao_intensity(value)

Getter

get_ssao_intensity()

La intensidad de oclusión ambiental del espacio de pantalla principal. Véase también ssao_radius.


Default

1.0

Setter

set_ssao_intensity2(value)

Getter

get_ssao_intensity2()

The secondary screen-space ambient occlusion intensity. See also ssao_radius2.


  • float ssao_light_affect

Default

0.0

Setter

set_ssao_direct_light_affect(value)

Getter

get_ssao_direct_light_affect()

La intensidad de la oclusión ambiental del espacio de la pantalla en luz directa. En la vida real, la oclusión ambiental sólo se aplica a la luz indirecta, lo que significa que sus efectos no se pueden ver con luz directa. Los valores superiores a 0 harán que el efecto SSAO sea visible en luz directa.


Default

1

Setter

set_ssao_quality(value)

Getter

get_ssao_quality()

The screen-space ambient occlusion quality. Higher qualities will make better use of small objects for ambient occlusion, but are slower.


Default

1.0

Setter

set_ssao_radius(value)

Getter

get_ssao_radius()

El radio de oclusión ambiental del espacio de pantalla principal.


Default

0.0

Setter

set_ssao_radius2(value)

Getter

get_ssao_radius2()

The secondary screen-space ambient occlusion radius. If set to a value higher than 0, enables the secondary screen-space ambient occlusion effect which can be used to improve the effect's appearance (at the cost of performance).


Default

1.0

Setter

set_tonemap_exposure(value)

Getter

get_tonemap_exposure()

La exposición predeterminada que se utiliza para el mapeo de tonos.


Default

0

Setter

set_tonemapper(value)

Getter

get_tonemapper()

El modo de mapeo de tonos a utilizar. El "tonemapping" es el proceso que "convierte" los valores HDR para que sean adecuados para su representación en una pantalla LDR. (Godot todavía no soporta la renderización en pantallas HDR.)


Default

1.0

Setter

set_tonemap_white(value)

Getter

get_tonemap_white()

El valor de referencia del blanco para el mapa de tonos. Sólo es efectivo si el tonemap_mode no se establece en TONE_MAPPER_LINEAR.

Descripciones de Métodos

  • bool is_glow_level_enabled ( int idx ) const

Devuelve true si se especifica el nivel de brillo idx, false en caso contrario.


  • void set_glow_level ( int idx, bool enabled )

Activa o desactiva el nivel de brillo en el índice idx. Cada nivel se basa en el nivel anterior. Esto significa que habilitar niveles de brillo más altos ralentizará la representación del efecto de brillo, incluso si los niveles anteriores no están habilitados.