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...
Sky
Eredita: Resource < RefCounted < Object
Definisce lo sfondo di un ambiente 3D utilizzando un Material.
Descrizione
La classe Sky utilizza un Material per renderizzare lo sfondo di un ambiente 3D e la luce che emette aggiornando le cubemap di riflessione e di radianza.
Proprietà
|
||
|
||
Enumerazioni
enum RadianceSize: 🔗
RadianceSize RADIANCE_SIZE_32 = 0
Le dimensioni della texture di radianza sono 32×32 pixel.
RadianceSize RADIANCE_SIZE_64 = 1
Le dimensioni della texture di radianza sono 64×64 pixel.
RadianceSize RADIANCE_SIZE_128 = 2
Le dimensioni della texture di radianza sono 128×128 pixel.
RadianceSize RADIANCE_SIZE_256 = 3
Le dimensioni della texture di radianza sono 256×256 pixel.
RadianceSize RADIANCE_SIZE_512 = 4
Le dimensioni della texture di radianza sono 512×512 pixel.
RadianceSize RADIANCE_SIZE_1024 = 5
Le dimensioni della texture di radianza sono 1024×1024 pixel.
RadianceSize RADIANCE_SIZE_2048 = 6
Le dimensioni della texture di radianza sono 2048×2048 pixel.
RadianceSize RADIANCE_SIZE_MAX = 7
Rappresenta la dimensione dell'enumerazione RadianceSize.
enum ProcessMode: 🔗
ProcessMode PROCESS_MODE_AUTOMATIC = 0
Seleziona automaticamente la modalità di processo appropriata in base al proprio shader del cielo. Se il proprio shader usa TIME o POSITION, questo userà PROCESS_MODE_REALTIME. Se il proprio shader usa una qualsiasi delle variabili LIGHT_* o uniformi personalizzate, questo usa PROCESS_MODE_INCREMENTAL. Altrimenti, il valore predefinito è PROCESS_MODE_QUALITY.
ProcessMode PROCESS_MODE_QUALITY = 1
Utilizza un campionamento di importanza di alta qualità per elaborare la mappa di radianza. In generale, questo risulta in una qualità molto più elevata di PROCESS_MODE_REALTIME ma richiede molto più tempo per essere generato. Non dovrebbe essere usato se si prevede di modificare il cielo in fase di esecuzione. Se si scopre che il riflesso non è abbastanza sfocato e mostra scintille o lucciole, prova ad aumentare ProjectSettings.rendering/reflections/sky_reflections/ggx_samples.
ProcessMode PROCESS_MODE_INCREMENTAL = 2
Utilizza lo stesso campionamento di importanza di alta qualità per elaborare la mappa di radianza come PROCESS_MODE_QUALITY, ma si aggiorna su più frame. Il numero di frame è determinato da ProjectSettings.rendering/reflections/sky_reflections/roughness_layers. Usalo quando hai bisogno di mappe di radianza di qualità più elevata, ma hai un cielo che si aggiorna lentamente.
ProcessMode PROCESS_MODE_REALTIME = 3
Utilizza l'algoritmo di filtraggio veloce per elaborare la mappa di radianza. In generale, questo risulta in una qualità inferiore, ma tempi di esecuzione sostanzialmente più rapidi. Se hai bisogno di una qualità migliore, ma devi comunque aggiornare il cielo ogni frame, considera di attivare ProjectSettings.rendering/reflections/sky_reflections/fast_filter_high_quality.
Nota: L'algoritmo di filtraggio veloce è limitato a cubemap di dimensioni 256×256, quindi radiance_size deve essere impostato su RADIANCE_SIZE_256. Altrimenti, viene visualizzato un avviso e la dimensione di radianza sovrascritta verrà ignorata.
Descrizioni delle proprietà
ProcessMode process_mode = 0 🔗
void set_process_mode(value: ProcessMode)
ProcessMode get_process_mode()
Il metodo per generare la mappa di radianza dal cielo. La mappa di radianza è una cubemap con versioni gradualmente più sfocate del cielo corrispondenti a diversi livelli di ruvidità. Le mappe di radianza possono essere costose da calcolare.
RadianceSize radiance_size = 3 🔗
void set_radiance_size(value: RadianceSize)
RadianceSize get_radiance_size()
La dimensione della mappa di radianza dello Sky. Maggiore è la dimensione della mappa di radianza, più dettagliata sarà l'illuminazione dello Sky.
Nota: Alcuni hardware avranno problemi con dimensioni di radianza più elevate, in particolare RADIANCE_SIZE_512 e superiori. Usa valori così elevati solo su hardware di fascia alta.
Il Material utilizzato per disegnare lo sfondo. Può essere PanoramaSkyMaterial, ProceduralSkyMaterial, PhysicalSkyMaterial o anche uno ShaderMaterial se si desidera usare uno shader personalizzato.