diff options
| author | Rémi Verschelde <rverschelde@gmail.com> | 2023-07-09 23:54:21 +0200 |
|---|---|---|
| committer | Rémi Verschelde <rverschelde@gmail.com> | 2023-07-09 23:54:21 +0200 |
| commit | e4be11b2733f2cbb213a2146d606d0839b38a236 (patch) | |
| tree | b8a93bc7bb5cdd5da3496b764c27c13fe0c72a40 | |
| parent | 1b8cbfe6e3dce27ea3c1c8d065c0186549ac3f5c (diff) | |
| parent | 976f5338c598fe2995e0444ca861b8e4f92da2f5 (diff) | |
| download | redot-engine-e4be11b2733f2cbb213a2146d606d0839b38a236.tar.gz | |
Merge pull request #79252 from smix8/parse_perf_warning_4.x
Add performance note for parsing source geometry
| -rw-r--r-- | doc/classes/NavigationMeshGenerator.xml | 1 | ||||
| -rw-r--r-- | doc/classes/NavigationServer3D.xml | 1 |
2 files changed, 2 insertions, 0 deletions
diff --git a/doc/classes/NavigationMeshGenerator.xml b/doc/classes/NavigationMeshGenerator.xml index 0b9e67b0fa..dc9b7dc3b2 100644 --- a/doc/classes/NavigationMeshGenerator.xml +++ b/doc/classes/NavigationMeshGenerator.xml @@ -47,6 +47,7 @@ <description> Parses the [SceneTree] for source geometry according to the properties of [param navigation_mesh]. Updates the provided [param source_geometry_data] resource with the resulting data. The resource can then be used to bake a navigation mesh with [method bake_from_source_geometry_data]. After the process is finished the optional [param callback] will be called. [b]Note:[/b] This function needs to run on the main thread or with a deferred call as the SceneTree is not thread-safe. + [b]Performance:[/b] While convenient, reading data arrays from [Mesh] resources can affect the frame rate negatively. The data needs to be received from the GPU, stalling the [RenderingServer] in the process. For performance prefer the use of e.g. collision shapes or creating the data arrays entirely in code. </description> </method> </methods> diff --git a/doc/classes/NavigationServer3D.xml b/doc/classes/NavigationServer3D.xml index f925e7a8fe..7dc3179e6b 100644 --- a/doc/classes/NavigationServer3D.xml +++ b/doc/classes/NavigationServer3D.xml @@ -685,6 +685,7 @@ <description> Parses the [SceneTree] for source geometry according to the properties of [param navigation_mesh]. Updates the provided [param source_geometry_data] resource with the resulting data. The resource can then be used to bake a navigation mesh with [method bake_from_source_geometry_data]. After the process is finished the optional [param callback] will be called. [b]Note:[/b] This function needs to run on the main thread or with a deferred call as the SceneTree is not thread-safe. + [b]Performance:[/b] While convenient, reading data arrays from [Mesh] resources can affect the frame rate negatively. The data needs to be received from the GPU, stalling the [RenderingServer] in the process. For performance prefer the use of e.g. collision shapes or creating the data arrays entirely in code. </description> </method> <method name="query_path" qualifiers="const"> |