From 4750b77d2d52a2ba0b6fe79ddb5f27bdc051cbe1 Mon Sep 17 00:00:00 2001 From: Haoyu Qiu Date: Mon, 27 Mar 2023 19:29:19 +0800 Subject: Fix typos and inconsistencies in classref * Typo fixes. * Navigation agent's `velocity_computed` signal is not emitted by `set_velocity`, but at the end of that frame if `set_velocity` is called. * Simplify link in navigation agent's `avoidance_enabled` description. * Unify `navigation_layers` description across `NavigationAgent{2,3}D`. * Unify `is_normalized()` description across `Vector2`, `Vector3`, and `Vector4` (cherry picked from commit ff97c481d367a8c4e72b6548095ce33c98e4ef33) --- doc/classes/NavigationAgent2D.xml | 4 ++-- doc/classes/NavigationAgent3D.xml | 6 +++--- doc/classes/RenderingServer.xml | 2 +- doc/classes/TextServer.xml | 2 +- doc/classes/Vector2.xml | 2 +- doc/classes/Vector3.xml | 2 +- doc/classes/Vector4.xml | 2 +- 7 files changed, 10 insertions(+), 10 deletions(-) (limited to 'doc') diff --git a/doc/classes/NavigationAgent2D.xml b/doc/classes/NavigationAgent2D.xml index 06ce32597f..4433e73547 100644 --- a/doc/classes/NavigationAgent2D.xml +++ b/doc/classes/NavigationAgent2D.xml @@ -109,7 +109,7 @@ - If [code]true[/code] the agent is registered for an RVO avoidance callback on the [NavigationServer2D]. When [method NavigationAgent2D.set_velocity] is used and the processing is completed a [code]safe_velocity[/code] Vector2 is received with a signal connection to [signal velocity_computed]. Avoidance processing with many registered agents has a significant performance cost and should only be enabled on agents that currently require it. + If [code]true[/code] the agent is registered for an RVO avoidance callback on the [NavigationServer2D]. When [method set_velocity] is used and the processing is completed a [code]safe_velocity[/code] Vector2 is received with a signal connection to [signal velocity_computed]. Avoidance processing with many registered agents has a significant performance cost and should only be enabled on agents that currently require it. If [code]true[/code] shows debug visuals for this agent. @@ -193,7 +193,7 @@ - Notifies when the collision avoidance velocity is calculated. Emitted by [method set_velocity]. Only emitted when [member avoidance_enabled] is true. + Notifies when the collision avoidance velocity is calculated. Emitted at the end of the physics frame in which [method set_velocity] is called. Only emitted when [member avoidance_enabled] is true. diff --git a/doc/classes/NavigationAgent3D.xml b/doc/classes/NavigationAgent3D.xml index d2151773da..962573ea5a 100644 --- a/doc/classes/NavigationAgent3D.xml +++ b/doc/classes/NavigationAgent3D.xml @@ -112,7 +112,7 @@ The NavigationAgent height offset is subtracted from the y-axis value of any vector path position for this NavigationAgent. The NavigationAgent height offset does not change or influence the navigation mesh or pathfinding query result. Additional navigation maps that use regions with navigation meshes that the developer baked with appropriate agent radius or height values are required to support different-sized agents. - If [code]true[/code] the agent is registered for an RVO avoidance callback on the [NavigationServer3D]. When [method NavigationAgent3D.set_velocity] is used and the processing is completed a [code]safe_velocity[/code] Vector3 is received with a signal connection to [signal velocity_computed]. Avoidance processing with many registered agents has a significant performance cost and should only be enabled on agents that currently require it. + If [code]true[/code] the agent is registered for an RVO avoidance callback on the [NavigationServer3D]. When [method set_velocity] is used and the processing is completed a [code]safe_velocity[/code] Vector3 is received with a signal connection to [signal velocity_computed]. Avoidance processing with many registered agents has a significant performance cost and should only be enabled on agents that currently require it. If [code]true[/code] shows debug visuals for this agent. @@ -136,7 +136,7 @@ The maximum speed that an agent can move. - A bitfield determining what navigation layers of navigation regions this NavigationAgent will use to calculate path. Changing it runtime will clear current navigation path and generate new one, according to new navigation layers. + A bitfield determining what navigation layers of navigation regions this agent will use to calculate path. Changing it runtime will clear current navigation path and generate new one, according to new navigation layers. The distance to search for other agents. @@ -196,7 +196,7 @@ - Notifies when the collision avoidance velocity is calculated. Emitted by [method set_velocity]. Only emitted when [member avoidance_enabled] is true. + Notifies when the collision avoidance velocity is calculated. Emitted at the end of the physics frame in which [method set_velocity] is called. Only emitted when [member avoidance_enabled] is true. diff --git a/doc/classes/RenderingServer.xml b/doc/classes/RenderingServer.xml index e5ab3271dc..2ba8e40ce2 100644 --- a/doc/classes/RenderingServer.xml +++ b/doc/classes/RenderingServer.xml @@ -587,7 +587,7 @@ - Creates a light occluder and adds it to the RenderingServer. It can be accessed with the RID that is returned. This RID will be used in all [code]canvas_light_ocluder_*[/code] RenderingServer functions. + Creates a light occluder and adds it to the RenderingServer. It can be accessed with the RID that is returned. This RID will be used in all [code]canvas_light_occluder_*[/code] RenderingServer functions. Once finished with your RID, you will want to free the RID using the RenderingServer's [method free_rid] static method. diff --git a/doc/classes/TextServer.xml b/doc/classes/TextServer.xml index ad37cf5c86..6d71578488 100644 --- a/doc/classes/TextServer.xml +++ b/doc/classes/TextServer.xml @@ -1154,7 +1154,7 @@ - Adjusts text with to fit to specified width, returns new text width. + Adjusts text width to fit to specified width, returns new text width. diff --git a/doc/classes/Vector2.xml b/doc/classes/Vector2.xml index 8b48bd4c88..fe85ad7df6 100644 --- a/doc/classes/Vector2.xml +++ b/doc/classes/Vector2.xml @@ -226,7 +226,7 @@ - Returns [code]true[/code] if the vector is normalized, [code]false[/code] otherwise. + Returns [code]true[/code] if the vector is normalized, i.e. its length is approximately equal to 1. diff --git a/doc/classes/Vector3.xml b/doc/classes/Vector3.xml index 91553c3acd..2f55e6a2c6 100644 --- a/doc/classes/Vector3.xml +++ b/doc/classes/Vector3.xml @@ -194,7 +194,7 @@ - Returns [code]true[/code] if the vector is [method normalized], [code]false[/code] otherwise. + Returns [code]true[/code] if the vector is normalized, i.e. its length is approximately equal to 1. diff --git a/doc/classes/Vector4.xml b/doc/classes/Vector4.xml index 880e6e4e19..7f71dc23ec 100644 --- a/doc/classes/Vector4.xml +++ b/doc/classes/Vector4.xml @@ -145,7 +145,7 @@ - Returns [code]true[/code] if the vector is normalized, i.e. its length is equal to 1. + Returns [code]true[/code] if the vector is normalized, i.e. its length is approximately equal to 1. -- cgit v1.2.3