:github_url: hide .. _class_RenderSceneBuffersRD: RenderSceneBuffersRD ==================== **Eredita:** :ref:`RenderSceneBuffers` **<** :ref:`RefCounted` **<** :ref:`Object` Implementazione del buffer della scena di rendering per i renderer basati su RenderingDevice. .. rst-class:: classref-introduction-group Descrizione ---------------------- Questo oggetto gestisce tutti i buffer di rendering 3D per i renderer basati sul dispositivo di rendering. Un'istanza di questo oggetto viene creata per ogni viewport che ha il rendering 3D abilitato. Tutti i buffer sono organizzati in **contesti**. Il contesto predefinito è detto **render_buffers** e può contenere, tra altri, i buffer di colore, di profondità e di velocità, la mappa della densità VRS e le variazioni per il MSAA di questi buffer. I buffer sono garantiti solo durante il rendering della viewport. \ **Nota:** Questo è un oggetto interno nel server di rendering, non istanziarlo da script. .. rst-class:: classref-reftable-group Metodi ------------ .. table:: :widths: auto +--------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`clear_context`\ (\ context\: :ref:`StringName`\ ) | +--------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`RID` | :ref:`create_texture`\ (\ context\: :ref:`StringName`, name\: :ref:`StringName`, data_format\: :ref:`DataFormat`, usage_bits\: :ref:`int`, texture_samples\: :ref:`TextureSamples`, size\: :ref:`Vector2i`, layers\: :ref:`int`, mipmaps\: :ref:`int`, unique\: :ref:`bool`, discardable\: :ref:`bool`\ ) | +--------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`RID` | :ref:`create_texture_from_format`\ (\ context\: :ref:`StringName`, name\: :ref:`StringName`, format\: :ref:`RDTextureFormat`, view\: :ref:`RDTextureView`, unique\: :ref:`bool`\ ) | +--------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`RID` | :ref:`create_texture_view`\ (\ context\: :ref:`StringName`, name\: :ref:`StringName`, view_name\: :ref:`StringName`, view\: :ref:`RDTextureView`\ ) | +--------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`RID` | :ref:`get_color_layer`\ (\ layer\: :ref:`int`, msaa\: :ref:`bool` = false\ ) | +--------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`RID` | :ref:`get_color_texture`\ (\ msaa\: :ref:`bool` = false\ ) | +--------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`RID` | :ref:`get_depth_layer`\ (\ layer\: :ref:`int`, msaa\: :ref:`bool` = false\ ) | +--------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`RID` | :ref:`get_depth_texture`\ (\ msaa\: :ref:`bool` = false\ ) | +--------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`get_fsr_sharpness`\ (\ ) |const| | +--------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2i` | :ref:`get_internal_size`\ (\ ) |const| | +--------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`ViewportMSAA` | :ref:`get_msaa_3d`\ (\ ) |const| | +--------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`RID` | :ref:`get_render_target`\ (\ ) |const| | +--------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`ViewportScaling3DMode` | :ref:`get_scaling_3d_mode`\ (\ ) |const| | +--------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`ViewportScreenSpaceAA` | :ref:`get_screen_space_aa`\ (\ ) |const| | +--------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2i` | :ref:`get_target_size`\ (\ ) |const| | +--------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`RID` | :ref:`get_texture`\ (\ context\: :ref:`StringName`, name\: :ref:`StringName`\ ) |const| | +--------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`RDTextureFormat` | :ref:`get_texture_format`\ (\ context\: :ref:`StringName`, name\: :ref:`StringName`\ ) |const| | +--------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`TextureSamples` | :ref:`get_texture_samples`\ (\ ) |const| | +--------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`RID` | :ref:`get_texture_slice`\ (\ context\: :ref:`StringName`, name\: :ref:`StringName`, layer\: :ref:`int`, mipmap\: :ref:`int`, layers\: :ref:`int`, mipmaps\: :ref:`int`\ ) | +--------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2i` | :ref:`get_texture_slice_size`\ (\ context\: :ref:`StringName`, name\: :ref:`StringName`, mipmap\: :ref:`int`\ ) | +--------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`RID` | :ref:`get_texture_slice_view`\ (\ context\: :ref:`StringName`, name\: :ref:`StringName`, layer\: :ref:`int`, mipmap\: :ref:`int`, layers\: :ref:`int`, mipmaps\: :ref:`int`, view\: :ref:`RDTextureView`\ ) | +--------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`get_use_debanding`\ (\ ) |const| | +--------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`get_use_taa`\ (\ ) |const| | +--------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`RID` | :ref:`get_velocity_layer`\ (\ layer\: :ref:`int`, msaa\: :ref:`bool` = false\ ) | +--------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`RID` | :ref:`get_velocity_texture`\ (\ msaa\: :ref:`bool` = false\ ) | +--------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_view_count`\ (\ ) |const| | +--------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`has_texture`\ (\ context\: :ref:`StringName`, name\: :ref:`StringName`\ ) |const| | +--------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Descrizioni dei metodi -------------------------------------------- .. _class_RenderSceneBuffersRD_method_clear_context: .. rst-class:: classref-method |void| **clear_context**\ (\ context\: :ref:`StringName`\ ) :ref:`🔗` Libera tutti i buffer correlati a questo contesto. .. rst-class:: classref-item-separator ---- .. _class_RenderSceneBuffersRD_method_create_texture: .. rst-class:: classref-method :ref:`RID` **create_texture**\ (\ context\: :ref:`StringName`, name\: :ref:`StringName`, data_format\: :ref:`DataFormat`, usage_bits\: :ref:`int`, texture_samples\: :ref:`TextureSamples`, size\: :ref:`Vector2i`, layers\: :ref:`int`, mipmaps\: :ref:`int`, unique\: :ref:`bool`, discardable\: :ref:`bool`\ ) :ref:`🔗` Crea una nuova texture con la definizione specificata e la memorizza nella cache con il nome specificato. Restituirà la texture esistente se esiste già. .. rst-class:: classref-item-separator ---- .. _class_RenderSceneBuffersRD_method_create_texture_from_format: .. rst-class:: classref-method :ref:`RID` **create_texture_from_format**\ (\ context\: :ref:`StringName`, name\: :ref:`StringName`, format\: :ref:`RDTextureFormat`, view\: :ref:`RDTextureView`, unique\: :ref:`bool`\ ) :ref:`🔗` Crea una nuova texture usando il formato e la vista specificati e la memorizza nella cache con il nome specificato. Restituirà la texture esistente se esiste già. .. rst-class:: classref-item-separator ---- .. _class_RenderSceneBuffersRD_method_create_texture_view: .. rst-class:: classref-method :ref:`RID` **create_texture_view**\ (\ context\: :ref:`StringName`, name\: :ref:`StringName`, view_name\: :ref:`StringName`, view\: :ref:`RDTextureView`\ ) :ref:`🔗` Crea una nuova vista di texture per una texture esistente e la memorizza nella cache sotto il ``view_name`` specificato. Restituirà la vista di texture esistente se esiste già. Genera un errore se la texture sorgente non esiste. .. rst-class:: classref-item-separator ---- .. _class_RenderSceneBuffersRD_method_get_color_layer: .. rst-class:: classref-method :ref:`RID` **get_color_layer**\ (\ layer\: :ref:`int`, msaa\: :ref:`bool` = false\ ) :ref:`🔗` Restituisce il livello specificato dalla texture di colore su cui stiamo renderizzando il contenuto 3D. Se ``msaa`` è ``true`` e il MSAA è abilitato, restituisce la variazione per il MSAA del buffer. .. rst-class:: classref-item-separator ---- .. _class_RenderSceneBuffersRD_method_get_color_texture: .. rst-class:: classref-method :ref:`RID` **get_color_texture**\ (\ msaa\: :ref:`bool` = false\ ) :ref:`🔗` Restituisce la texture di colore su cui stiamo renderizzando il contenuto 3D. Se si utilizza multiview, esso sarà un array di texture con tutte le viste. Se ``msaa`` è ``true`` e il MSAA è abilitato, restituisce la variazione per il MSAA del buffer. .. rst-class:: classref-item-separator ---- .. _class_RenderSceneBuffersRD_method_get_depth_layer: .. rst-class:: classref-method :ref:`RID` **get_depth_layer**\ (\ layer\: :ref:`int`, msaa\: :ref:`bool` = false\ ) :ref:`🔗` Restituisce il livello specificato dalla texture di profondità su cui stiamo renderizzando il contenuto 3D. Se ``msaa`` è ``true`` e il MSAA è abilitato, restituisce la variazione per il MSAA del buffer. .. rst-class:: classref-item-separator ---- .. _class_RenderSceneBuffersRD_method_get_depth_texture: .. rst-class:: classref-method :ref:`RID` **get_depth_texture**\ (\ msaa\: :ref:`bool` = false\ ) :ref:`🔗` Restituisce la texture di profondità su cui stiamo renderizzando il contenuto 3D. Se si utilizza multiview, esso sarà un array di texture con tutte le viste. Se ``msaa`` è ``true`` e il MSAA è abilitato, restituisce la variazione per il MSAA del buffer. .. rst-class:: classref-item-separator ---- .. _class_RenderSceneBuffersRD_method_get_fsr_sharpness: .. rst-class:: classref-method :ref:`float` **get_fsr_sharpness**\ (\ ) |const| :ref:`🔗` Restituisce il valore di nitidezza del FSR utilizzato per renderizzare il contenuto 3D (se :ref:`get_scaling_3d_mode()` è una modalità FSR). .. rst-class:: classref-item-separator ---- .. _class_RenderSceneBuffersRD_method_get_internal_size: .. rst-class:: classref-method :ref:`Vector2i` **get_internal_size**\ (\ ) |const| :ref:`🔗` Restituisce la dimensione interna del buffer di rendering (dimensione prima del sovracampionamento) con cui le texture vengono create come predefinito. .. rst-class:: classref-item-separator ---- .. _class_RenderSceneBuffersRD_method_get_msaa_3d: .. rst-class:: classref-method :ref:`ViewportMSAA` **get_msaa_3d**\ (\ ) |const| :ref:`🔗` Restituisce la modalità MSAA 3D applicata per questa viewport. .. rst-class:: classref-item-separator ---- .. _class_RenderSceneBuffersRD_method_get_render_target: .. rst-class:: classref-method :ref:`RID` **get_render_target**\ (\ ) |const| :ref:`🔗` Restituisce la destinazione di rendering associata a questo oggetto del buffer. .. rst-class:: classref-item-separator ---- .. _class_RenderSceneBuffersRD_method_get_scaling_3d_mode: .. rst-class:: classref-method :ref:`ViewportScaling3DMode` **get_scaling_3d_mode**\ (\ ) |const| :ref:`🔗` Restituisce la modalità di ridimensionamento utilizzata per l'upscaling. .. rst-class:: classref-item-separator ---- .. _class_RenderSceneBuffersRD_method_get_screen_space_aa: .. rst-class:: classref-method :ref:`ViewportScreenSpaceAA` **get_screen_space_aa**\ (\ ) |const| :ref:`🔗` Restituisce il modo dell'antialiasing nello spazio dello schermo applicato. .. rst-class:: classref-item-separator ---- .. _class_RenderSceneBuffersRD_method_get_target_size: .. rst-class:: classref-method :ref:`Vector2i` **get_target_size**\ (\ ) |const| :ref:`🔗` Restituisce le dimensioni di destinazione del buffer di rendering (dimensioni dopo l'upscaling). .. rst-class:: classref-item-separator ---- .. _class_RenderSceneBuffersRD_method_get_texture: .. rst-class:: classref-method :ref:`RID` **get_texture**\ (\ context\: :ref:`StringName`, name\: :ref:`StringName`\ ) |const| :ref:`🔗` Restituisce una texture dalla cache con questo nome. .. rst-class:: classref-item-separator ---- .. _class_RenderSceneBuffersRD_method_get_texture_format: .. rst-class:: classref-method :ref:`RDTextureFormat` **get_texture_format**\ (\ context\: :ref:`StringName`, name\: :ref:`StringName`\ ) |const| :ref:`🔗` Restituisce le informazioni sul formato texture con cui è stata creata una texture memorizzata nella cache. .. rst-class:: classref-item-separator ---- .. _class_RenderSceneBuffersRD_method_get_texture_samples: .. rst-class:: classref-method :ref:`TextureSamples` **get_texture_samples**\ (\ ) |const| :ref:`🔗` Restituisce il numero di campioni MSAA utilizzati. .. rst-class:: classref-item-separator ---- .. _class_RenderSceneBuffersRD_method_get_texture_slice: .. rst-class:: classref-method :ref:`RID` **get_texture_slice**\ (\ context\: :ref:`StringName`, name\: :ref:`StringName`, layer\: :ref:`int`, mipmap\: :ref:`int`, layers\: :ref:`int`, mipmaps\: :ref:`int`\ ) :ref:`🔗` Restituisce una porzione specifica (livello o mipmap) per una texture memorizzata nella cache. .. rst-class:: classref-item-separator ---- .. _class_RenderSceneBuffersRD_method_get_texture_slice_size: .. rst-class:: classref-method :ref:`Vector2i` **get_texture_slice_size**\ (\ context\: :ref:`StringName`, name\: :ref:`StringName`, mipmap\: :ref:`int`\ ) :ref:`🔗` Restituisce le dimensioni della texture di una data sezione di una texture nella cache. .. rst-class:: classref-item-separator ---- .. _class_RenderSceneBuffersRD_method_get_texture_slice_view: .. rst-class:: classref-method :ref:`RID` **get_texture_slice_view**\ (\ context\: :ref:`StringName`, name\: :ref:`StringName`, layer\: :ref:`int`, mipmap\: :ref:`int`, layers\: :ref:`int`, mipmaps\: :ref:`int`, view\: :ref:`RDTextureView`\ ) :ref:`🔗` Restituisce una vista specifica di una porzione (livello o mipmap) per una texture memorizzata nella cache. .. rst-class:: classref-item-separator ---- .. _class_RenderSceneBuffersRD_method_get_use_debanding: .. rst-class:: classref-method :ref:`bool` **get_use_debanding**\ (\ ) |const| :ref:`🔗` Restituisce ``true`` se il debanding è abilitato. .. rst-class:: classref-item-separator ---- .. _class_RenderSceneBuffersRD_method_get_use_taa: .. rst-class:: classref-method :ref:`bool` **get_use_taa**\ (\ ) |const| :ref:`🔗` Restituisce ``true`` se TAA è abilitato. .. rst-class:: classref-item-separator ---- .. _class_RenderSceneBuffersRD_method_get_velocity_layer: .. rst-class:: classref-method :ref:`RID` **get_velocity_layer**\ (\ layer\: :ref:`int`, msaa\: :ref:`bool` = false\ ) :ref:`🔗` Restituisce il livello specificato dalla texture di velocità su cui stiamo renderizzando il contenuto 3D. .. rst-class:: classref-item-separator ---- .. _class_RenderSceneBuffersRD_method_get_velocity_texture: .. rst-class:: classref-method :ref:`RID` **get_velocity_texture**\ (\ msaa\: :ref:`bool` = false\ ) :ref:`🔗` Restituisce la texture di velocità su cui stiamo renderizzando il contenuto 3D. Se si utilizza multiview, esso sarà un array di texture con tutte le viste. Se ``msaa`` è **true** e il MSAA è abilitato, restituisce la variazione per il MSAA del buffer. .. rst-class:: classref-item-separator ---- .. _class_RenderSceneBuffersRD_method_get_view_count: .. rst-class:: classref-method :ref:`int` **get_view_count**\ (\ ) |const| :ref:`🔗` Restituisce il numero delle viste per la viewport associata. .. rst-class:: classref-item-separator ---- .. _class_RenderSceneBuffersRD_method_has_texture: .. rst-class:: classref-method :ref:`bool` **has_texture**\ (\ context\: :ref:`StringName`, name\: :ref:`StringName`\ ) |const| :ref:`🔗` Restituisce ``true`` se esiste una texture con questo nome nella cache. .. |virtual| replace:: :abbr:`virtual (Questo metodo dovrebbe solitamente essere sovrascritto dall'utente per aver un effetto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` .. |const| replace:: :abbr:`const (Questo metodo non ha effetti collaterali. Non modifica alcuna variabile appartenente all'istanza.)` .. |vararg| replace:: :abbr:`vararg (Questo metodo accetta qualsiasi numero di argomenti oltre a quelli descritti qui.)` .. |constructor| replace:: :abbr:`constructor (Questo metodo è utilizzato per creare un tipo.)` .. |static| replace:: :abbr:`static (Questo metodo non necessita di alcun'istanza per essere chiamato, quindi può essere chiamato direttamente usando il nome della classe.)` .. |operator| replace:: :abbr:`operator (Questo metodo descrive un operatore valido da usare con questo tipo come operando di sinistra.)` .. |bitfield| replace:: :abbr:`BitField (Questo valore è un intero composto da una maschera di bit dei seguenti flag.)` .. |void| replace:: :abbr:`void (Nessun valore restituito.)`