From f9fa182abc5209671cb4fbadc2dc173157d6f939 Mon Sep 17 00:00:00 2001
From: Yaohua Xiong <xiongyaohua@gmail.com>
Date: Wed, 23 Nov 2022 11:11:58 +0800
Subject: Refactor Curve3D::_bake() method

The main change is to caculate tangent directly from bezier curve, without going
through discretized polyline, avoiding pitfalls of discretization.

Other changes are:
1. Add an bezier_derivative() method for Vector3, Vector2, and Math;
2. Add an tesselate_even_length() method to Curve3D, which tesselate bezier curve to even length segments adaptively;
3. Cache the tangent vectors in baked_tangent_vector_cache;
---
 doc/classes/@GlobalScope.xml | 11 +++++++++++
 1 file changed, 11 insertions(+)

(limited to 'doc/classes/@GlobalScope.xml')

diff --git a/doc/classes/@GlobalScope.xml b/doc/classes/@GlobalScope.xml
index 34f706b6f9..a85532dba6 100644
--- a/doc/classes/@GlobalScope.xml
+++ b/doc/classes/@GlobalScope.xml
@@ -106,6 +106,17 @@
 				[/codeblock]
 			</description>
 		</method>
+		<method name="bezier_derivative">
+			<return type="float" />
+			<param index="0" name="start" type="float" />
+			<param index="1" name="control_1" type="float" />
+			<param index="2" name="control_2" type="float" />
+			<param index="3" name="end" type="float" />
+			<param index="4" name="t" type="float" />
+			<description>
+				Returns the derivative at the given [param t] on a one-dimensional [url=https://en.wikipedia.org/wiki/B%C3%A9zier_curve]Bezier curve[/url] defined by the given [param control_1], [param control_2], and [param end] points.
+			</description>
+		</method>
 		<method name="bezier_interpolate">
 			<return type="float" />
 			<param index="0" name="start" type="float" />
-- 
cgit v1.2.3