mirror of
https://github.com/godotengine/godot-docs-l10n.git
synced 2025-12-31 09:49:22 +03:00
773 lines
36 KiB
ReStructuredText
773 lines
36 KiB
ReStructuredText
:github_url: hide
|
|
|
|
.. _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>` = [], type\: :ref:`MonitorType<enum_Performance_MonitorType>` = 0\ ) |
|
|
+------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :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:`PackedInt32Array<class_PackedInt32Array>` | :ref:`get_custom_monitor_types<class_Performance_method_get_custom_monitor_types>`\ (\ ) |
|
|
+------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :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``
|
|
|
|
Number of orphan nodes, i.e. nodes which are not parented to a node of the scene tree. *Lower is better.*\
|
|
|
|
\ **Note:** This is only available in debug mode and will always return ``0`` when used in a project exported in release mode.
|
|
|
|
.. _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 empty default navigation maps created by :ref:`World2D<class_World2D>` and :ref:`World3D<class_World3D>` instances.
|
|
|
|
.. _class_Performance_constant_NAVIGATION_REGION_COUNT:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_REGION_COUNT** = ``25``
|
|
|
|
Numero di regioni di navigazione attive nel :ref:`NavigationServer2D<class_NavigationServer2D>` e :ref:`NavigationServer3D<class_NavigationServer3D>`.
|
|
|
|
.. _class_Performance_constant_NAVIGATION_AGENT_COUNT:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_AGENT_COUNT** = ``26``
|
|
|
|
Numero di agenti di navigazione attivi che stanno elaborando l'evasione nel :ref:`NavigationServer2D<class_NavigationServer2D>` e :ref:`NavigationServer3D<class_NavigationServer3D>`.
|
|
|
|
.. _class_Performance_constant_NAVIGATION_LINK_COUNT:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_LINK_COUNT** = ``27``
|
|
|
|
Numero di collegamenti di navigazione attivi nel :ref:`NavigationServer2D<class_NavigationServer2D>` e :ref:`NavigationServer3D<class_NavigationServer3D>`.
|
|
|
|
.. _class_Performance_constant_NAVIGATION_POLYGON_COUNT:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_POLYGON_COUNT** = ``28``
|
|
|
|
Numero di poligoni delle mesh di navigazione nel :ref:`NavigationServer2D<class_NavigationServer2D>` e :ref:`NavigationServer3D<class_NavigationServer3D>`.
|
|
|
|
.. _class_Performance_constant_NAVIGATION_EDGE_COUNT:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_EDGE_COUNT** = ``29``
|
|
|
|
Numero dei bordi dei poligoni delle mesh di navigazione nel :ref:`NavigationServer2D<class_NavigationServer2D>` e :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``
|
|
|
|
Numero di ostacoli di navigazione attivi nel :ref:`NavigationServer2D<class_NavigationServer2D>` e :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``
|
|
|
|
Numero di compilazioni delle pipeline che sono state attivate creando la cache delle superfici prima di renderizzare la scena. Queste compilazioni appariranno come uno stutter quando viene caricata una scena la prima volta che un utente esegue il gioco e la pipeline viene richiesta.
|
|
|
|
.. _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 empty default navigation maps created by :ref:`World2D<class_World2D>` instances.
|
|
|
|
.. _class_Performance_constant_NAVIGATION_2D_REGION_COUNT:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`Monitor<enum_Performance_Monitor>` **NAVIGATION_2D_REGION_COUNT** = ``40``
|
|
|
|
Numero di regioni di navigazione attive nel :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``
|
|
|
|
Numero di agenti di navigazione attivi che stanno elaborando l'evasione nel :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``
|
|
|
|
Numero di collegamenti di navigazione attivi nel :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``
|
|
|
|
Numero di poligoni delle mesh di navigazione nel :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``
|
|
|
|
Numero dei bordi dei poligoni delle mesh di navigazione nel :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``
|
|
|
|
Numero di ostacoli di navigazione attivi nel :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 empty default navigation maps created by :ref:`World3D<class_World3D>` instances.
|
|
|
|
.. _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 stanno elaborando 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 delle 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 dei bordi dei poligoni delle 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``
|
|
|
|
Number of navigation mesh polygon edges that were merged due to edge key overlap in the :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-item-separator
|
|
|
|
----
|
|
|
|
.. _enum_Performance_MonitorType:
|
|
|
|
.. rst-class:: classref-enumeration
|
|
|
|
enum **MonitorType**: :ref:`🔗<enum_Performance_MonitorType>`
|
|
|
|
.. _class_Performance_constant_MONITOR_TYPE_QUANTITY:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`MonitorType<enum_Performance_MonitorType>` **MONITOR_TYPE_QUANTITY** = ``0``
|
|
|
|
Monitor output is formatted as an integer value.
|
|
|
|
.. _class_Performance_constant_MONITOR_TYPE_MEMORY:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`MonitorType<enum_Performance_MonitorType>` **MONITOR_TYPE_MEMORY** = ``1``
|
|
|
|
Monitor output is formatted as computer memory. Submitted values should represent a number of bytes.
|
|
|
|
.. _class_Performance_constant_MONITOR_TYPE_TIME:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`MonitorType<enum_Performance_MonitorType>` **MONITOR_TYPE_TIME** = ``2``
|
|
|
|
Monitor output is formatted as time in milliseconds. Submitted values should represent a time in seconds (not milliseconds).
|
|
|
|
.. _class_Performance_constant_MONITOR_TYPE_PERCENTAGE:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`MonitorType<enum_Performance_MonitorType>` **MONITOR_TYPE_PERCENTAGE** = ``3``
|
|
|
|
Monitor output is formatted as a percentage. Submitted values should represent a fractional value rather than the percentage directly, e.g. ``0.5`` for ``50.00%``.
|
|
|
|
.. 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>` = [], type\: :ref:`MonitorType<enum_Performance_MonitorType>` = 0\ ) :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_custom_monitor_types:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
:ref:`PackedInt32Array<class_PackedInt32Array>` **get_custom_monitor_types**\ (\ ) :ref:`🔗<class_Performance_method_get_custom_monitor_types>`
|
|
|
|
Returns the :ref:`MonitorType<enum_Performance_MonitorType>` values of active custom monitors in an :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.)`
|