From c79f36cfc538eb1df12c20963b514ad43659fcd6 Mon Sep 17 00:00:00 2001
From: snowykami <snowykami@outlook.com>
Date: Sat, 7 Sep 2024 02:38:49 +0800
Subject: [PATCH] =?UTF-8?q?:sparkles:=20line&plane:=20=E6=B7=BB=E5=8A=A0?=
 =?UTF-8?q?=E4=B8=80=E4=BA=9B=E7=AC=94=E8=AE=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 mbcp/mp_math/line.py  | 14 +++++++++++++-
 mbcp/mp_math/plane.py | 23 +++++++++++++++++++++--
 2 files changed, 34 insertions(+), 3 deletions(-)

diff --git a/mbcp/mp_math/line.py b/mbcp/mp_math/line.py
index 83a2147..dfbbe3f 100644
--- a/mbcp/mp_math/line.py
+++ b/mbcp/mp_math/line.py
@@ -48,8 +48,20 @@ class Line3:
         return self.direction.cal_angle(other.direction)
 
     def cal_distance(self, other: 'Line3 | Point3') -> float:
-        """
+        r"""
         计算直线和直线或点之间的距离。
+        :::tip
+        直线和直线之间的距离计算公式:
+        - 平行/重合 = 0
+        - 平行/异面 = $\frac{|\vec{P_1P_2} \times \vec{v}|}{|\vec{v}|}$
+        - 相交 = 0
+        其中，$P_1$和$P_2$分别为两条直线上的点，$\vec{v}$为直线的方向向量。
+        :::
+        :::tip
+        直线和点之间的距离计算公式:
+        $$\frac{|\vec{P_1P} \times \vec{v}|}{|\vec{v}|}$$
+        其中，$P_1$为直线上的点，$P$为点，$\vec{v}$为直线的方向向量。
+        :::
         Args:
             other ([`Line3`](./line#class-line3) | [`Point3`](./point#class-point3)): 另一条直线或点
         Returns:
diff --git a/mbcp/mp_math/plane.py b/mbcp/mp_math/plane.py
index c92e226..c9009c5 100644
--- a/mbcp/mp_math/plane.py
+++ b/mbcp/mp_math/plane.py
@@ -79,8 +79,21 @@ class Plane3:
             raise TypeError(f"Unsupported type: {type(other)}")
 
     def cal_distance(self, other: 'Plane3 | Point3') -> float:
-        """
+        r"""
         计算平面与平面或点之间的距离。
+        :::tip
+        平面和平面之间的距离计算公式:
+        暂未实现
+        - 平行 = 0
+        - 相交 = 0
+        - 不平行 = $\frac{|\vec{P_1P_2} \cdot \vec{n}|}{|\vec{n}|}$
+        其中，$P_1$和$P_2$分别为两个平面上的点，$\vec{n}$为平面的法向量。
+        :::
+        :::tip
+        平面和点之间的距离计算公式:
+        $$\frac{|\vec{P_1P} \cdot \vec{n}|}{|\vec{n}|}$$
+        其中，$P_1$为平面上的点，$P$为点，$\vec{n}$为平面的法向量。
+        :::
         Args:
             other ([`Plane3`](./plane#class-plane3) | [`Point3`](./point#class-point3)): 另一个平面或点
         Returns:
@@ -89,7 +102,7 @@ class Plane3:
             [`TypeError`](https%3A//docs.python.org/3/library/exceptions.html#TypeError): 不支持的类型
         """
         if isinstance(other, Plane3):
-            return 0
+            raise NotImplementedError("Not implemented yet.")
         elif isinstance(other, Point3):
             return abs(self.a * other.x + self.b * other.y + self.c * other.z + self.d) / (self.a ** 2 + self.b ** 2 + self.c ** 2) ** 0.5
         else:
@@ -142,6 +155,12 @@ class Plane3:
     def cal_intersection_point3(self, other: 'Line3') -> 'Point3':
         """
         计算平面与直线的交点。
+        :::tip
+        计算平面与直线交点的一般步骤:
+        1. 求直线的参数方程
+        2. 代入平面方程，解出t
+        3. 代入直线参数方程，求出交点
+        :::
         Args:
             other ([`Line3`](./line#class-line3)): 直线
         Returns: