CameraAttributesPhysical

Hereda: CameraAttributes < Resource < RefCounted < Object

Configuración de la cámara basada en la física.

Descripción

CameraAttributesPhysical is used to set rendering settings based on a physically-based camera's settings. It is responsible for exposure, auto-exposure, and depth of field.

When used in a WorldEnvironment it provides default settings for exposure, auto-exposure, and depth of field that will be used by all cameras without their own CameraAttributes, including the editor camera. When used in a Camera3D it will override any CameraAttributes set in the WorldEnvironment and will override the Camera3Ds Camera3D.far, Camera3D.near, Camera3D.fov, and Camera3D.keep_aspect properties. When used in VoxelGI or LightmapGI, only the exposure settings will be used.

The default settings are intended for use in an outdoor environment, tips for settings for use in an indoor environment can be found in each setting's documentation.

Note: Depth of field blur is only supported in the Forward+ and Mobile rendering methods, not Compatibility.

Tutoriales

Unidades físicas de luz y cámara

Propiedades

float	auto_exposure_max_exposure_value	`10.0`
float	auto_exposure_min_exposure_value	`-8.0`
float	exposure_aperture	`16.0`
float	exposure_shutter_speed	`100.0`
float	frustum_far	`4000.0`
float	frustum_focal_length	`35.0`
float	frustum_focus_distance	`10.0`
float	frustum_near	`0.05`

Métodos

float

get_fov() const

Descripciones de Propiedades

float auto_exposure_max_exposure_value = 10.0 🔗

void set_auto_exposure_max_exposure_value(value: float)
float get_auto_exposure_max_exposure_value()

La luminancia máxima (en EV100) utilizada al calcular la exposición automática. Al calcular la luminancia media de la escena, los valores de color se limitarán a este valor como mínimo. Esto limita la exposición automática a exponer por debajo de un cierto brillo, lo que resulta en un punto de corte donde la escena permanecerá brillante.

float auto_exposure_min_exposure_value = -8.0 🔗

void set_auto_exposure_min_exposure_value(value: float)
float get_auto_exposure_min_exposure_value()

La luminancia mínima (en EV100) utilizada al calcular la exposición automática. Al calcular la luminancia media de la escena, los valores de color se limitarán a este valor como mínimo. Esto limita la exposición automática a exponer por encima de un cierto brillo, lo que resulta en un punto de corte donde la escena permanecerá oscura.

float exposure_aperture = 16.0 🔗

void set_aperture(value: float)
float get_aperture()

Size of the aperture of the camera, measured in f-stops. An f-stop is a unitless ratio between the focal length of the camera and the diameter of the aperture. A high aperture setting will result in a smaller aperture which leads to a dimmer image and sharper focus. A low aperture results in a wide aperture which lets in more light resulting in a brighter, less-focused image. Default is appropriate for outdoors at daytime (i.e. for use with a default DirectionalLight3D), for indoor lighting, a value between 2 and 4 is more appropriate.

Only available when ProjectSettings.rendering/lights_and_shadows/use_physical_light_units is enabled.

float exposure_shutter_speed = 100.0 🔗

void set_shutter_speed(value: float)
float get_shutter_speed()

Tiempo para que el obturador se abra y se cierre, evaluado como 1 / velocidad_de_obturación segundos. Un valor más alto permitirá menos luz (lo que conducirá a una imagen más oscura), mientras que un valor más bajo permitirá más luz (lo que conducirá a una imagen más brillante).

Solo disponible cuando ProjectSettings.rendering/lights_and_shadows/use_physical_light_units está habilitado.

float frustum_far = 4000.0 🔗

void set_far(value: float)
float get_far()

Valor de reemplazo para Camera3D.far. Se usa internamente al calcular la profundidad de campo. Cuando se adjunta a una Camera3D como sus Camera3D.attributes, reemplazará la propiedad Camera3D.far.

float frustum_focal_length = 35.0 🔗

void set_focal_length(value: float)
float get_focal_length()

Distancia entre la lente de la cámara y la apertura de la cámara, medida en milímetros. Controla el campo de visión y la profundidad de campo. Una distancia focal mayor resultará en un campo de visión más pequeño y una profundidad de campo más estrecha, lo que significa que menos objetos estarán enfocados. Una distancia focal más pequeña resultará en un campo de visión más amplio y una profundidad de campo mayor, lo que significa que más objetos estarán enfocados. Cuando se adjunta a una Camera3D como sus Camera3D.attributes, sobrescribirá la propiedad Camera3D.fov y la propiedad Camera3D.keep_aspect.

float frustum_focus_distance = 10.0 🔗

void set_focus_distance(value: float)
float get_focus_distance()

Distancia desde la cámara del objeto que estará enfocado, medida en metros. Internamente, esto se sujetará para que sea al menos 1 milímetro más grande que frustum_focal_length.

float frustum_near = 0.05 🔗

void set_near(value: float)
float get_near()

Valor de reemplazo para Camera3D.near. Se usa internamente al calcular la profundidad de campo. Cuando se adjunta a una Camera3D como sus Camera3D.attributes, reemplazará la propiedad Camera3D.near.

Descripciones de Métodos

float get_fov() const 🔗

Devuelve el campo de visión vertical que corresponde a frustum_focal_length. Este valor se calcula internamente cada vez que se cambia frustum_focal_length.