Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

CameraAttributesPhysical

Eredita: CameraAttributes < Resource < RefCounted < Object

Impostazioni di telecamera basate sulla fisica.

Descrizione

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.

Note: Auto-exposure is only supported in the Forward+ rendering method, not Mobile or Compatibility.

Tutorial

Luce fisica e unità di telecamera

Proprietà

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`

Metodi

float

get_fov() const

Descrizioni delle proprietà

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 luminanza massima (in EV100) utilizzata per il calcolo dell'esposizione automatica. Quando si calcola la luminanza media della scena, i valori del colore saranno limitati ad almeno questo valore. Ciò limita l'esposizione automatica al di sotto di una certa luminosità, risultando in un punto di interruzione in cui la scena rimarrà luminosa.

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 luminanza minima (in EV100) utilizzata per il calcolo dell'esposizione automatica. Quando si calcola la luminanza media della scena, i valori del colore saranno limitati ad almeno questo valore. Ciò limita l'esposizione automatica al di sopra di una certa luminosità, risultando in un punto di interruzione in cui la scena rimarrà scura.

float exposure_aperture = 16.0 🔗

void set_aperture(value: float)
float get_aperture()

Dimensione dell'apertura della telecamera, misurata in f-stop. Un f-stop è un rapporto senza unità tra la lunghezza focale della telecamera e il diametro dell'apertura. Un valore di apertura elevato risulterà in un'apertura più piccola che porta a un'immagine più buia e a una messa a fuoco più nitida. Un'apertura bassa risulta in un'apertura ampia che lascia entrare più luce, risultando in un'immagine più luminosa e meno a fuoco. L'impostazione predefinita è appropriata per gli esterni durante il giorno (ossia per l'uso con un DirectionalLight3D predefinito), per l'illuminazione di interni, un valore compreso tra 2 e 4 è più appropriato.

Disponibile solo quando ProjectSettings.rendering/lights_and_shadows/use_physical_light_units è abilitato.

float exposure_shutter_speed = 100.0 🔗

void set_shutter_speed(value: float)
float get_shutter_speed()

Tempo necessario per l'apertura e la chiusura dell'otturatore, valutato come 1 / velocità_otturatore secondi. Un valore più alto permetterà meno luce (portando a un'immagine più scura), mentre un valore più basso permetterà più luce (portando a un'immagine più luminosa).

Disponibile solo quando ProjectSettings.rendering/lights_and_shadows/use_physical_light_units è abilitato.

float frustum_far = 4000.0 🔗

void set_far(value: float)
float get_far()

Valore di sostituzione per Camera3D.far. Usato internamente per il calcolo della profondità di campo. Se associato a un Camera3D come suo Camera3D.attributes, sovrascriverà la proprietà Camera3D.far.

float frustum_focal_length = 35.0 🔗

void set_focal_length(value: float)
float get_focal_length()

Distanza tra l'obiettivo e l'apertura della telecamera, misurata in millimetri. Controlla il campo visivo e la profondità di campo. Una lunghezza focale maggiore risulterà in un campo visivo più piccolo e in una profondità di campo più ristretta, il che significa che meno oggetti saranno a fuoco. Una lunghezza focale inferiore risulterà in un campo visivo più ampio e in una maggiore profondità di campo, il che significa che più oggetti saranno a fuoco. Se associato a un Camera3D come suo Camera3D.attributes, sovrascriverà la proprietà Camera3D.fov e la proprietà Camera3D.keep_aspect.

float frustum_focus_distance = 10.0 🔗

void set_focus_distance(value: float)
float get_focus_distance()

Distanza dalla fotocamera dell'oggetto che sarà messo a fuoco, misurata in metri. Internamente questo verrà limitato per essere almeno 1 millimetro più grande di frustum_focal_length.

float frustum_near = 0.05 🔗

void set_near(value: float)
float get_near()

Valore di sostituzione per Camera3D.near. Usato internamente per il calcolo della profondità di campo. Se associato a un Camera3D come suo Camera3D.attributes, sovrascriverà la proprietà Camera3D.near.

Descrizioni dei metodi

float get_fov() const 🔗

Restituisce il campo visivo verticale che corrisponde a frustum_focal_length. Questo valore viene calcolato internamente ogni volta che frustum_focal_length viene modificato.