godotengine/godot-docs-l10n
1
0
Fork 0
mirror of https://github.com/godotengine/godot-docs-l10n.git synced 2026-01-05 14:10:19 +03:00
Code Issues Packages Projects Releases Wiki Activity

Merge Sphinx translations with Weblate translations, add classref for es fr it ru uk zh_TW

Browse Source
This commit is contained in:
Rémi Verschelde
2025-09-15 11:05:15 +02:00
parent 9d91e8c01f
commit fdce63ed70
13844 changed files with 2529255 additions and 9105 deletions
Download Patch File Download Diff File Expand all files Collapse all files

719
classes/it/class_performance.rst Normal file
View File

@@ -0,0 +1,719 @@
:github_url: hide
.. DO NOT EDIT THIS FILE!!!
.. Generated automatically from Godot engine sources.
.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/Performance.xml.
.. _class_Performance:
Performance
===========
**Eredita:** :ref:`Object<class_Object>`
Espone i dati relativi alle prestazioni.
.. rst-class:: classref-introduction-group
Descrizione
----------------------
Questa classe fornisce l'accesso a diversi monitor correlati alle prestazioni, come l'utilizzo della memoria, le chiamate di disegno e gli FPS. Sono gli stessi valori visualizzati nella scheda **Monitor** nel pannello **Debugger** dell'editor. Utilizzando il metodo :ref:`get_monitor()<class_Performance_method_get_monitor>` di questa classe, puoi accedere a questi dati dal tuo codice.
Puoi aggiungere monitor personalizzati utilizzando il metodo :ref:`add_custom_monitor()<class_Performance_method_add_custom_monitor>`. I monitor personalizzati sono disponibili nella scheda **Monitor** nel pannello **Debugger** dell'editor insieme ai monitor integrati.
\ **Nota:** Alcuni dei monitor integrati sono disponibili solo in modalità debug e restituiranno sempre ``0`` quando utilizzati in un progetto esportato in modalità release.
\ **Nota:** Alcuni monitor integrati non vengono aggiornati in tempo reale per motivi di prestazioni, pertanto potrebbe verificarsi un ritardo fino a 1 secondo tra le modifiche.
\ **Nota:** I monitor personalizzati non supportano valori negativi. I valori negativi sono limitati a 0.
.. rst-class:: classref-reftable-group
Metodi
------------
.. table::
:widths: auto
+------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`add_custom_monitor<class_Performance_method_add_custom_monitor>`\ (\ id\: :ref:`StringName<class_StringName>`, callable\: :ref:`Callable<class_Callable>`, arguments\: :ref:`Array<class_Array>` = []\ ) |
+------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Variant<class_Variant>` | :ref:`get_custom_monitor<class_Performance_method_get_custom_monitor>`\ (\ id\: :ref:`StringName<class_StringName>`\ ) |
+------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Array<class_Array>`\[:ref:`StringName<class_StringName>`\] | :ref:`get_custom_monitor_names<class_Performance_method_get_custom_monitor_names>`\ (\ ) |
+------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`get_monitor<class_Performance_method_get_monitor>`\ (\ monitor\: :ref:`Monitor<enum_Performance_Monitor>`\ ) |const| |
+------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`get_monitor_modification_time<class_Performance_method_get_monitor_modification_time>`\ (\ ) |
+------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`has_custom_monitor<class_Performance_method_has_custom_monitor>`\ (\ id\: :ref:`StringName<class_StringName>`\ ) |
+------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`remove_custom_monitor<class_Performance_method_remove_custom_monitor>`\ (\ id\: :ref:`StringName<class_StringName>`\ ) |
+------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Enumerazioni
------------------------
.. _enum_Performance_Monitor:
.. rst-class:: classref-enumeration
enum **Monitor**: :ref:`🔗<enum_Performance_Monitor>`
.. _class_Performance_constant_TIME_FPS:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **TIME_FPS** = ``0``
Il numero di frame renderizzati nell'ultimo secondo. Questa metrica viene aggiornata solo una volta al secondo, anche se richiesta più spesso. *Più alto è, meglio è.*
.. _class_Performance_constant_TIME_PROCESS:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **TIME_PROCESS** = ``1``
Tempo impiegato per completare un frame, in secondi. *Più basso è, meglio è.*
.. _class_Performance_constant_TIME_PHYSICS_PROCESS:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **TIME_PHYSICS_PROCESS** = ``2``
Tempo impiegato per completare un frame di fisica, in secondi. *Più basso è, meglio è.*
.. _class_Performance_constant_TIME_NAVIGATION_PROCESS:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **TIME_NAVIGATION_PROCESS** = ``3``
Tempo impiegato per completare un passaggio di navigazione, in secondi. Include gli aggiornamenti della mappa di navigazione e i calcoli di evasione degli agenti. *Più basso è, meglio è.*
.. _class_Performance_constant_MEMORY_STATIC:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **MEMORY_STATIC** = ``4``
Memoria statica attualmente utilizzata, in byte. Non disponibile nelle build di rilascio. *Più basso è, meglio è.*
.. _class_Performance_constant_MEMORY_STATIC_MAX:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **MEMORY_STATIC_MAX** = ``5``
Memoria statica disponibile. Non disponibile nelle build di rilascio. *Più basso è, meglio è.*
.. _class_Performance_constant_MEMORY_MESSAGE_BUFFER_MAX:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **MEMORY_MESSAGE_BUFFER_MAX** = ``6``
Quantità massima di memoria che è stata utilizzata dal buffer della coda dei messaggi, in byte. La coda dei messaggi è utilizzata per le chiamate di funzioni differite e le notifiche. *Più basso è, meglio è.*
.. _class_Performance_constant_OBJECT_COUNT:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **OBJECT_COUNT** = ``7``
Numero di oggetti attualmente istanziati (inclusi i nodi). *Più basso è, meglio è.*
.. _class_Performance_constant_OBJECT_RESOURCE_COUNT:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **OBJECT_RESOURCE_COUNT** = ``8``
Numero di risorse attualmente utilizzate. *Più basso è, meglio è.*
.. _class_Performance_constant_OBJECT_NODE_COUNT:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **OBJECT_NODE_COUNT** = ``9``
Numero di nodi attualmente istanziati nell'albero di scena. Include anche il nodo radice. *Più basso è, meglio è.*
.. _class_Performance_constant_OBJECT_ORPHAN_NODE_COUNT:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **OBJECT_ORPHAN_NODE_COUNT** = ``10``
Numero di nodi orfani, ovvero nodi che non sono imparentati a un nodo dell'albero di scena. *Più basso è, meglio è.*
.. _class_Performance_constant_RENDER_TOTAL_OBJECTS_IN_FRAME:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **RENDER_TOTAL_OBJECTS_IN_FRAME** = ``11``
Il numero totale di oggetti nell'ultimo frame renderizzato. Questa metrica non include gli oggetti scartati (tramite i nodi nascosti, il frustum culling o l'occlusion culling). *Più basso è, meglio è.*
.. _class_Performance_constant_RENDER_TOTAL_PRIMITIVES_IN_FRAME:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **RENDER_TOTAL_PRIMITIVES_IN_FRAME** = ``12``
Il numero totale di vertici o indici renderizzati nell'ultimo frame renderizzato. Questa metrica non include gli oggetti scartati (tramite i nodi nascosti, il frustum culling o l'occlusion culling). A causa del pre-passaggio di profondità e dei passaggi di ombreggiatura, il numero di primitivi è sempre superiore al numero effettivo di vertici nella scena (in genere il doppio o il triplo del conteggio dei vertici originale). *Più basso è, meglio è.*
.. _class_Performance_constant_RENDER_TOTAL_DRAW_CALLS_IN_FRAME:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **RENDER_TOTAL_DRAW_CALLS_IN_FRAME** = ``13``
Il numero totale di chiamate di disegno eseguite nell'ultimo frame renderizzato. Questa metrica non include gli oggetti scartati (tramite i nodi nascosti, il frustum culling o l'occlusion culling), poiché non provocano chiamate di disegno. *Più basso è, meglio è.*
.. _class_Performance_constant_RENDER_VIDEO_MEM_USED:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **RENDER_VIDEO_MEM_USED** = ``14``
La quantità di memoria video utilizzata (memoria per le texture e i vertici combinata, in byte). Poiché questa metrica include anche varie allocazioni, questo valore è sempre maggiore della somma di :ref:`RENDER_TEXTURE_MEM_USED<class_Performance_constant_RENDER_TEXTURE_MEM_USED>` e :ref:`RENDER_BUFFER_MEM_USED<class_Performance_constant_RENDER_BUFFER_MEM_USED>`. *Più basso è, meglio è.*
.. _class_Performance_constant_RENDER_TEXTURE_MEM_USED:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **RENDER_TEXTURE_MEM_USED** = ``15``
La quantità di memoria per le texture utilizzata (in byte). *Più basso è, meglio è.*
.. _class_Performance_constant_RENDER_BUFFER_MEM_USED:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **RENDER_BUFFER_MEM_USED** = ``16``
La quantità di memoria del buffer di rendering utilizzata (in byte). *Più basso è, meglio è.*
.. _class_Performance_constant_PHYSICS_2D_ACTIVE_OBJECTS:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **PHYSICS_2D_ACTIVE_OBJECTS** = ``17``
Numero di nodi :ref:`RigidBody2D<class_RigidBody2D>` attivi nel gioco. *Più basso è, meglio è.*
.. _class_Performance_constant_PHYSICS_2D_COLLISION_PAIRS:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **PHYSICS_2D_COLLISION_PAIRS** = ``18``
Numero di coppie di collisioni nel motore fisico 2D. *Più basso è, meglio è.*
.. _class_Performance_constant_PHYSICS_2D_ISLAND_COUNT:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **PHYSICS_2D_ISLAND_COUNT** = ``19``
Numero di isole nel motore fisico 2D. *Più basso è, meglio è.*
.. _class_Performance_constant_PHYSICS_3D_ACTIVE_OBJECTS:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **PHYSICS_3D_ACTIVE_OBJECTS** = ``20``
Numero di nodi :ref:`RigidBody3D<class_RigidBody3D>` e :ref:`VehicleBody3D<class_VehicleBody3D>` attivi nel gioco. *Più basso è, meglio è.*
.. _class_Performance_constant_PHYSICS_3D_COLLISION_PAIRS:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **PHYSICS_3D_COLLISION_PAIRS** = ``21``
Numero di coppie di collisioni nel motore fisico 3D. *Più basso è, meglio è.*
.. _class_Performance_constant_PHYSICS_3D_ISLAND_COUNT:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **PHYSICS_3D_ISLAND_COUNT** = ``22``
Numero di isole nel motore fisico 3D. *Più basso è, meglio è.*
.. _class_Performance_constant_AUDIO_OUTPUT_LATENCY:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **AUDIO_OUTPUT_LATENCY** = ``23``
Latenza di output dell':ref:`AudioServer<class_AudioServer>`. Equivalente a chiamare :ref:`AudioServer.get_output_latency()<class_AudioServer_method_get_output_latency>`, ma non è consigliabile chiamarlo ogni frame.
.. _class_Performance_constant_NAVIGATION_ACTIVE_MAPS:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_ACTIVE_MAPS** = ``24``
Number of active navigation maps in :ref:`NavigationServer2D<class_NavigationServer2D>` and :ref:`NavigationServer3D<class_NavigationServer3D>`. This also includes the two empty default navigation maps created by World2D and World3D.
.. _class_Performance_constant_NAVIGATION_REGION_COUNT:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_REGION_COUNT** = ``25``
Number of active navigation regions in :ref:`NavigationServer2D<class_NavigationServer2D>` and :ref:`NavigationServer3D<class_NavigationServer3D>`.
.. _class_Performance_constant_NAVIGATION_AGENT_COUNT:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_AGENT_COUNT** = ``26``
Number of active navigation agents processing avoidance in :ref:`NavigationServer2D<class_NavigationServer2D>` and :ref:`NavigationServer3D<class_NavigationServer3D>`.
.. _class_Performance_constant_NAVIGATION_LINK_COUNT:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_LINK_COUNT** = ``27``
Number of active navigation links in :ref:`NavigationServer2D<class_NavigationServer2D>` and :ref:`NavigationServer3D<class_NavigationServer3D>`.
.. _class_Performance_constant_NAVIGATION_POLYGON_COUNT:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_POLYGON_COUNT** = ``28``
Number of navigation mesh polygons in :ref:`NavigationServer2D<class_NavigationServer2D>` and :ref:`NavigationServer3D<class_NavigationServer3D>`.
.. _class_Performance_constant_NAVIGATION_EDGE_COUNT:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_EDGE_COUNT** = ``29``
Number of navigation mesh polygon edges in :ref:`NavigationServer2D<class_NavigationServer2D>` and :ref:`NavigationServer3D<class_NavigationServer3D>`.
.. _class_Performance_constant_NAVIGATION_EDGE_MERGE_COUNT:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_EDGE_MERGE_COUNT** = ``30``
Number of navigation mesh polygon edges that were merged due to edge key overlap in :ref:`NavigationServer2D<class_NavigationServer2D>` and :ref:`NavigationServer3D<class_NavigationServer3D>`.
.. _class_Performance_constant_NAVIGATION_EDGE_CONNECTION_COUNT:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_EDGE_CONNECTION_COUNT** = ``31``
Number of polygon edges that are considered connected by edge proximity :ref:`NavigationServer2D<class_NavigationServer2D>` and :ref:`NavigationServer3D<class_NavigationServer3D>`.
.. _class_Performance_constant_NAVIGATION_EDGE_FREE_COUNT:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_EDGE_FREE_COUNT** = ``32``
Number of navigation mesh polygon edges that could not be merged in :ref:`NavigationServer2D<class_NavigationServer2D>` and :ref:`NavigationServer3D<class_NavigationServer3D>`. The edges still may be connected by edge proximity or with links.
.. _class_Performance_constant_NAVIGATION_OBSTACLE_COUNT:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_OBSTACLE_COUNT** = ``33``
Number of active navigation obstacles in the :ref:`NavigationServer2D<class_NavigationServer2D>` and :ref:`NavigationServer3D<class_NavigationServer3D>`.
.. _class_Performance_constant_PIPELINE_COMPILATIONS_CANVAS:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **PIPELINE_COMPILATIONS_CANVAS** = ``34``
Numero di compilazioni delle pipeline attivate dal motore di rendering 2D del canvas.
.. _class_Performance_constant_PIPELINE_COMPILATIONS_MESH:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **PIPELINE_COMPILATIONS_MESH** = ``35``
Numero di compilazioni delle pipeline che sono state attivate caricando le mesh. Queste compilazioni appariranno come tempi di caricamento più lunghi la prima volta che un utente esegue il gioco e la pipeline viene richiesta.
.. _class_Performance_constant_PIPELINE_COMPILATIONS_SURFACE:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **PIPELINE_COMPILATIONS_SURFACE** = ``36``
Number of pipeline compilations that were triggered by building the surface cache before rendering the scene. These compilations will show up as a stutter when loading a scene the first time a user runs the game and the pipeline is required.
.. _class_Performance_constant_PIPELINE_COMPILATIONS_DRAW:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **PIPELINE_COMPILATIONS_DRAW** = ``37``
Numero di compilazioni delle pipeline che sono state attivate disegnando la scena. Queste compilazioni appariranno come stuttering durante il gioco la prima volta che un utente esegue il gioco e la pipeline viene richiesta.
.. _class_Performance_constant_PIPELINE_COMPILATIONS_SPECIALIZATION:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **PIPELINE_COMPILATIONS_SPECIALIZATION** = ``38``
Numero di compilazioni delle pipeline che sono state attivate per ottimizzare la scena attuale. Queste compilazioni vengono eseguite in background e non dovrebbero causare alcun tipo di stuttering.
.. _class_Performance_constant_NAVIGATION_2D_ACTIVE_MAPS:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_2D_ACTIVE_MAPS** = ``39``
Number of active navigation maps in the :ref:`NavigationServer2D<class_NavigationServer2D>`. This also includes the two empty default navigation maps created by World2D.
.. _class_Performance_constant_NAVIGATION_2D_REGION_COUNT:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_2D_REGION_COUNT** = ``40``
Number of active navigation regions in the :ref:`NavigationServer2D<class_NavigationServer2D>`.
.. _class_Performance_constant_NAVIGATION_2D_AGENT_COUNT:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_2D_AGENT_COUNT** = ``41``
Number of active navigation agents processing avoidance in the :ref:`NavigationServer2D<class_NavigationServer2D>`.
.. _class_Performance_constant_NAVIGATION_2D_LINK_COUNT:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_2D_LINK_COUNT** = ``42``
Number of active navigation links in the :ref:`NavigationServer2D<class_NavigationServer2D>`.
.. _class_Performance_constant_NAVIGATION_2D_POLYGON_COUNT:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_2D_POLYGON_COUNT** = ``43``
Number of navigation mesh polygons in the :ref:`NavigationServer2D<class_NavigationServer2D>`.
.. _class_Performance_constant_NAVIGATION_2D_EDGE_COUNT:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_2D_EDGE_COUNT** = ``44``
Number of navigation mesh polygon edges in the :ref:`NavigationServer2D<class_NavigationServer2D>`.
.. _class_Performance_constant_NAVIGATION_2D_EDGE_MERGE_COUNT:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_2D_EDGE_MERGE_COUNT** = ``45``
Number of navigation mesh polygon edges that were merged due to edge key overlap in the :ref:`NavigationServer2D<class_NavigationServer2D>`.
.. _class_Performance_constant_NAVIGATION_2D_EDGE_CONNECTION_COUNT:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_2D_EDGE_CONNECTION_COUNT** = ``46``
Number of polygon edges that are considered connected by edge proximity :ref:`NavigationServer2D<class_NavigationServer2D>`.
.. _class_Performance_constant_NAVIGATION_2D_EDGE_FREE_COUNT:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_2D_EDGE_FREE_COUNT** = ``47``
Number of navigation mesh polygon edges that could not be merged in the :ref:`NavigationServer2D<class_NavigationServer2D>`. The edges still may be connected by edge proximity or with links.
.. _class_Performance_constant_NAVIGATION_2D_OBSTACLE_COUNT:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_2D_OBSTACLE_COUNT** = ``48``
Number of active navigation obstacles in the :ref:`NavigationServer2D<class_NavigationServer2D>`.
.. _class_Performance_constant_NAVIGATION_3D_ACTIVE_MAPS:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_3D_ACTIVE_MAPS** = ``49``
Number of active navigation maps in the :ref:`NavigationServer3D<class_NavigationServer3D>`. This also includes the two empty default navigation maps created by World3D.
.. _class_Performance_constant_NAVIGATION_3D_REGION_COUNT:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_3D_REGION_COUNT** = ``50``
Numero di regioni di navigazione attive nel :ref:`NavigationServer3D<class_NavigationServer3D>`.
.. _class_Performance_constant_NAVIGATION_3D_AGENT_COUNT:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_3D_AGENT_COUNT** = ``51``
Numero di agenti di navigazione attivi che elaborano l'evasione nel :ref:`NavigationServer3D<class_NavigationServer3D>`.
.. _class_Performance_constant_NAVIGATION_3D_LINK_COUNT:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_3D_LINK_COUNT** = ``52``
Numero di collegamenti di navigazione attivi nel :ref:`NavigationServer3D<class_NavigationServer3D>`.
.. _class_Performance_constant_NAVIGATION_3D_POLYGON_COUNT:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_3D_POLYGON_COUNT** = ``53``
Numero di poligoni della mesh di navigazione nel :ref:`NavigationServer3D<class_NavigationServer3D>`.
.. _class_Performance_constant_NAVIGATION_3D_EDGE_COUNT:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_3D_EDGE_COUNT** = ``54``
Numero di bordi del poligono di mesh di navigazione nel :ref:`NavigationServer3D<class_NavigationServer3D>`.
.. _class_Performance_constant_NAVIGATION_3D_EDGE_MERGE_COUNT:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_3D_EDGE_MERGE_COUNT** = ``55``
Numero di spigoli poligonali della mesh di navigazione che sono stati uniti a causa della sovrapposizione delle chiavi dei bordi in :ref:`NavigationServer3D<class_NavigationServer3D>`.
.. _class_Performance_constant_NAVIGATION_3D_EDGE_CONNECTION_COUNT:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_3D_EDGE_CONNECTION_COUNT** = ``56``
Numero di spigoli poligonali considerati connessi dalla prossimità degli spigoli :ref:`NavigationServer3D<class_NavigationServer3D>`.
.. _class_Performance_constant_NAVIGATION_3D_EDGE_FREE_COUNT:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_3D_EDGE_FREE_COUNT** = ``57``
Numero di spigoli poligonali della mesh di navigazione che non è stato possibile unire nel :ref:`NavigationServer3D<class_NavigationServer3D>`. Gli spigoli possono comunque essere collegati tramite prossimità degli spigoli o con collegamenti.
.. _class_Performance_constant_NAVIGATION_3D_OBSTACLE_COUNT:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_3D_OBSTACLE_COUNT** = ``58``
Numero di ostacoli di navigazione attivi nel :ref:`NavigationServer3D<class_NavigationServer3D>`.
.. _class_Performance_constant_MONITOR_MAX:
.. rst-class:: classref-enumeration-constant
:ref:`Monitor<enum_Performance_Monitor>` **MONITOR_MAX** = ``59``
Rappresenta la dimensione dell'enumerazione :ref:`Monitor<enum_Performance_Monitor>`.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Descrizioni dei metodi
--------------------------------------------
.. _class_Performance_method_add_custom_monitor:
.. rst-class:: classref-method
|void| **add_custom_monitor**\ (\ id\: :ref:`StringName<class_StringName>`, callable\: :ref:`Callable<class_Callable>`, arguments\: :ref:`Array<class_Array>` = []\ ) :ref:`🔗<class_Performance_method_add_custom_monitor>`
Aggiunge un monitor personalizzato con il nome ``id``. Puoi specificare la categoria del monitor usando i delimitatori barra in ``id`` (ad esempio: ``"Game/NumberOfNPCs"``). Se c'è più di un delimitatore barra, allora la categoria predefinita è usata. La categoria predefinita è ``"Custom"``. Stampa un errore se l'``id`` specificato è già presente.
.. tabs::
.. code-tab:: gdscript
func _ready():
var monitor_value = Callable(self, "get_monitor_value")
# Aggiunge un monitor con il nome "MyName" alla categoria "MyCategory".
Performance.add_custom_monitor("MyCategory/MyMonitor", monitor_value)
# Aggiunge un monitor con il nome "MyName" alla categoria "Custom".
# Nota: "MyCategory/MyMonitor" e "MyMonitor" hanno lo stesso nome ma ID diversi, quindi il codice è valido.
Performance.add_custom_monitor("MyMonitor", monitor_value)
# Aggiunge un monitor con il nome "MyName" alla categoria "Custom".
# Nota: "MyMonitor" e "Custom/MyMonitor" hanno lo stesso nome e la stessa categoria ma ID diversi, quindi il codice è valido.
Performance.add_custom_monitor("Custom/MyMonitor", monitor_value)
# Aggiunge un monitor con il nome "MyCategoryOne/MyCategoryTwo/MyMonitor" alla categoria "Custom".
Performance.add_custom_monitor("MyCategoryOne/MyCategoryTwo/MyMonitor", monitor_value)
func get_monitor_value():
return randi() % 25
.. code-tab:: csharp
public override void _Ready()
{
var monitorValue = new Callable(this, MethodName.GetMonitorValue);
// Aggiunge un monitor con il nome "MyName" alla categoria "MyCategory".
Performance.AddCustomMonitor("MyCategory/MyMonitor", monitorValue);
// Aggiunge un monitor con il nome "MyName" alla categoria "Custom".
// Nota: "MyCategory/MyMonitor" e "MyMonitor" hanno lo stesso nome ma ID diversi, quindi il codice è valido.
Performance.AddCustomMonitor("MyMonitor", monitorValue);
// Aggiunge un monitor con il nome "MyName" alla categoria "Custom".
// Nota: "MyMonitor" e "Custom/MyMonitor" hanno lo stesso nome e la stessa categoria ma ID diversi, quindi il codice è valido.
Performance.AddCustomMonitor("Custom/MyMonitor", monitorValue);
// Aggiunge un monitor con il nome "MyCategoryOne/MyCategoryTwo/MyMonitor" alla categoria "Custom".
Performance.AddCustomMonitor("MyCategoryOne/MyCategoryTwo/MyMonitor", monitorValue);
}
public int GetMonitorValue()
{
return GD.Randi() % 25;
}
Il debugger chiama il chiamabile per ottenere il valore del monitor personalizzato. Il chiamabile deve restituire un numero intero positivo o zero oppure un numero in virgola mobile.
I chiamabili sono chiamati con argomenti forniti nell'array di argomenti.
.. rst-class:: classref-item-separator
----
.. _class_Performance_method_get_custom_monitor:
.. rst-class:: classref-method
:ref:`Variant<class_Variant>` **get_custom_monitor**\ (\ id\: :ref:`StringName<class_StringName>`\ ) :ref:`🔗<class_Performance_method_get_custom_monitor>`
Restituisce il valore del monitor personalizzato con l'``id`` specificato. Il chiamabile viene chiamato per ottenere il valore del monitor personalizzato. Vedi anche :ref:`has_custom_monitor()<class_Performance_method_has_custom_monitor>`. Stampa un errore se l'``id`` specificato non esiste.
.. rst-class:: classref-item-separator
----
.. _class_Performance_method_get_custom_monitor_names:
.. rst-class:: classref-method
:ref:`Array<class_Array>`\[:ref:`StringName<class_StringName>`\] **get_custom_monitor_names**\ (\ ) :ref:`🔗<class_Performance_method_get_custom_monitor_names>`
Restituisce i nomi dei monitor personalizzati attivi in un :ref:`Array<class_Array>`.
.. rst-class:: classref-item-separator
----
.. _class_Performance_method_get_monitor:
.. rst-class:: classref-method
:ref:`float<class_float>` **get_monitor**\ (\ monitor\: :ref:`Monitor<enum_Performance_Monitor>`\ ) |const| :ref:`🔗<class_Performance_method_get_monitor>`
Restituisce il valore di uno dei monitor integrati disponibili. Dovresti fornire una delle costanti di :ref:`Monitor<enum_Performance_Monitor>` come argomento, in questo modo:
.. tabs::
.. code-tab:: gdscript
print(Performance.get_monitor(Performance.TIME_FPS)) # Stampa gli FPS sulla console.
.. code-tab:: csharp
GD.Print(Performance.GetMonitor(Performance.Monitor.TimeFps)); // Stampa gli FPS sulla console.
Vedi :ref:`get_custom_monitor()<class_Performance_method_get_custom_monitor>` per richiedere i valori dei monitor personalizzati delle prestazioni.
.. rst-class:: classref-item-separator
----
.. _class_Performance_method_get_monitor_modification_time:
.. rst-class:: classref-method
:ref:`int<class_int>` **get_monitor_modification_time**\ (\ ) :ref:`🔗<class_Performance_method_get_monitor_modification_time>`
Restituisce l'ultimo tick in cui è stato aggiunto/rimosso il monitor personalizzato (in microsecondi dall'avvio del motore). Questo è impostato su :ref:`Time.get_ticks_usec()<class_Time_method_get_ticks_usec>` quando il monitor viene aggiornato.
.. rst-class:: classref-item-separator
----
.. _class_Performance_method_has_custom_monitor:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **has_custom_monitor**\ (\ id\: :ref:`StringName<class_StringName>`\ ) :ref:`🔗<class_Performance_method_has_custom_monitor>`
Restituisce ``true`` se il monitor personalizzato con l'``id`` fornito è presente, altrimenti ``false``.
.. rst-class:: classref-item-separator
----
.. _class_Performance_method_remove_custom_monitor:
.. rst-class:: classref-method
|void| **remove_custom_monitor**\ (\ id\: :ref:`StringName<class_StringName>`\ ) :ref:`🔗<class_Performance_method_remove_custom_monitor>`
Rimuove il monitor personalizzato con l'``id`` specificato. Stampa un errore se l'``id`` specificato non esiste già.
.. |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.)`