Shader

Eredita: Resource < RefCounted < Object

Ereditato da: VisualShader

Uno shader implementato nel linguaggio di shading Godot.

Descrizione

Un programma di shader personalizzato implementato nel linguaggio di shading Godot, salvato con l'estensione .gdshader.

Questa classe è utilizzata da uno ShaderMaterial e consente di scrivere il proprio comportamento personalizzato per il rendering di elementi visivi o l'aggiornamento delle informazioni sulle particelle. Per una spiegazione dettagliata e l'utilizzo, consultare i tutorial collegati di seguito.

Tutorial

Indice di documentazione sugli Shader

Proprietà

String

code

""

Metodi

Texture	get_default_texture_parameter(name: StringName, index: int = 0) const
Mode	get_mode() const
Array	get_shader_uniform_list(get_groups: bool = false)
void	inspect_native_shader_code()
void	set_default_texture_parameter(name: StringName, texture: Texture, index: int = 0)

Enumerazioni

enum Mode: 🔗

Mode MODE_SPATIAL = 0

Modalità utilizzata per disegnare tutti gli oggetti 3D.

Mode MODE_CANVAS_ITEM = 1

Modalità utilizzata per disegnare tutti gli oggetti 2D.

Mode MODE_PARTICLES = 2

Modalità utilizzata per calcolare le informazioni su ciascuna particella individualmente. Non utilizzata per il disegno.

Mode MODE_SKY = 3

Modalità utilizzata per disegnare i cieli. Funziona solo con gli shader assegnati agli oggetti Sky.

Mode MODE_FOG = 4

Modalità utilizzata per impostare il colore e la densità dell'effetto nebbia volumetrica.

Descrizioni delle proprietà

String code = "" 🔗

void set_code(value: String)
String get_code()

Restituisce il codice dello shader così come è stato scritto dall'utente, non il codice generato completo utilizzato internamente.

Descrizioni dei metodi

Texture get_default_texture_parameter(name: StringName, index: int = 0) const 🔗

Restituisce la texture impostata come predefinita per il parametro specificato.

Nota: name deve corrispondere esattamente al nome dell'uniforme nel codice.

Nota: Se viene utilizzato l'array del campionatore, usa index per accedere alla texture specificata.

Mode get_mode() const 🔗

Restituisce la modalità di shader per lo shader.

Array get_shader_uniform_list(get_groups: bool = false) 🔗

Ottiene la lista delle uniformi dello shader che è possibile assegnare a uno ShaderMaterial, per l'uso con ShaderMaterial.set_shader_parameter() e ShaderMaterial.get_shader_parameter(). I parametri restituiti sono contenuti in dizionari in un formato simile a quelli restituiti da Object.get_property_list().

Se l'argomento get_groups è true, saranno fornite indicazioni per il raggruppamento dei parametri.

void inspect_native_shader_code() 🔗

Disponibile solo quando è in esecuzione nell'editor. Apre un popup che visualizza il codice dello shader generato, incluse tutte le varianti e il codice di shader interno. Vedi anche Material.inspect_native_shader_code().

void set_default_texture_parameter(name: StringName, texture: Texture, index: int = 0) 🔗

Imposta la texture predefinita da utilizzare con l'uniforme di texture.

Nota: name deve corrispondere esattamente al nome dell'uniforme nel codice.

Nota: Se viene utilizzato l'array del campionatore, usa index per accedere alla texture specificata.