2024-08-28 10:52:17 +08:00
|
|
|
---
|
2024-08-28 12:02:30 +08:00
|
|
|
title: mbcp.mp_math.point
|
2024-08-28 10:52:17 +08:00
|
|
|
---
|
|
|
|
### ***class*** `Point3`
|
|
|
|
|
2024-08-28 12:02:30 +08:00
|
|
|
- #### *def* `__init__(self, x: float, y: float, z: float)`
|
2024-08-28 10:52:17 +08:00
|
|
|
|
|
|
|
|
2024-08-28 12:02:30 +08:00
|
|
|
笛卡尔坐标系中的点。
|
2024-08-28 10:52:17 +08:00
|
|
|
|
2024-08-28 12:02:30 +08:00
|
|
|
参数:
|
2024-08-28 10:52:17 +08:00
|
|
|
|
2024-08-28 12:02:30 +08:00
|
|
|
x: x 坐标
|
2024-08-28 10:52:17 +08:00
|
|
|
|
2024-08-28 12:02:30 +08:00
|
|
|
y: y 坐标
|
2024-08-28 10:52:17 +08:00
|
|
|
|
2024-08-28 12:02:30 +08:00
|
|
|
z: z 坐标
|
2024-08-28 10:52:17 +08:00
|
|
|
|
|
|
|
|
2024-08-28 12:02:30 +08:00
|
|
|
- #
|
2024-08-28 10:52:17 +08:00
|
|
|
<details>
|
2024-08-28 12:02:30 +08:00
|
|
|
<summary>源码</summary>
|
2024-08-28 10:52:17 +08:00
|
|
|
|
|
|
|
```python
|
|
|
|
def __init__(self, x: float, y: float, z: float):
|
|
|
|
"""
|
|
|
|
笛卡尔坐标系中的点。
|
|
|
|
Args:
|
|
|
|
x: x 坐标
|
|
|
|
y: y 坐标
|
|
|
|
z: z 坐标
|
|
|
|
"""
|
|
|
|
self.x = x
|
|
|
|
self.y = y
|
|
|
|
self.z = z
|
|
|
|
```
|
|
|
|
</details>
|
|
|
|
|
2024-08-28 12:02:30 +08:00
|
|
|
- #### *def* `approx(self, other: 'Point3', epsilon: float = APPROX)`
|
2024-08-28 10:52:17 +08:00
|
|
|
|
|
|
|
|
2024-08-28 12:02:30 +08:00
|
|
|
判断两个点是否近似相等。
|
2024-08-28 10:52:17 +08:00
|
|
|
|
2024-08-28 12:02:30 +08:00
|
|
|
参数:
|
2024-08-28 10:52:17 +08:00
|
|
|
|
2024-08-28 12:02:30 +08:00
|
|
|
other:
|
2024-08-28 10:52:17 +08:00
|
|
|
|
2024-08-28 12:02:30 +08:00
|
|
|
epsilon:
|
2024-08-28 10:52:17 +08:00
|
|
|
|
|
|
|
|
2024-08-28 12:02:30 +08:00
|
|
|
- #
|
2024-08-28 10:52:17 +08:00
|
|
|
<details>
|
2024-08-28 12:02:30 +08:00
|
|
|
<summary>源码</summary>
|
2024-08-28 10:52:17 +08:00
|
|
|
|
|
|
|
```python
|
|
|
|
def approx(self, other: 'Point3', epsilon: float=APPROX) -> bool:
|
|
|
|
"""
|
|
|
|
判断两个点是否近似相等。
|
|
|
|
Args:
|
|
|
|
other:
|
|
|
|
epsilon:
|
|
|
|
|
|
|
|
Returns:
|
|
|
|
是否近似相等
|
|
|
|
"""
|
|
|
|
return all([abs(self.x - other.x) < epsilon, abs(self.y - other.y) < epsilon, abs(self.z - other.z) < epsilon])
|
|
|
|
```
|
|
|
|
</details>
|
|
|
|
|
2024-08-28 12:02:30 +08:00
|
|
|
- #### *def* `__str__(self)`
|
|
|
|
|
|
|
|
- #
|
|
|
|
<details>
|
|
|
|
<summary>源码</summary>
|
|
|
|
|
|
|
|
```python
|
|
|
|
def __str__(self):
|
|
|
|
return f'Point3({self.x}, {self.y}, {self.z})'
|
|
|
|
```
|
|
|
|
</details>
|
|
|
|
|
|
|
|
- #### `@overload`
|
|
|
|
- #### *def* `__add__(self, other: 'Vector3')`
|
|
|
|
|
|
|
|
- #
|
|
|
|
<details>
|
|
|
|
<summary>源码</summary>
|
|
|
|
|
|
|
|
```python
|
|
|
|
@overload
|
|
|
|
def __add__(self, other: 'Vector3') -> 'Point3':
|
|
|
|
...
|
|
|
|
```
|
|
|
|
</details>
|
|
|
|
|
|
|
|
- #### `@overload`
|
|
|
|
- #### *def* `__add__(self, other: 'Point3')`
|
|
|
|
|
|
|
|
- #
|
|
|
|
<details>
|
|
|
|
<summary>源码</summary>
|
|
|
|
|
|
|
|
```python
|
|
|
|
@overload
|
|
|
|
def __add__(self, other: 'Point3') -> 'Point3':
|
|
|
|
...
|
|
|
|
```
|
|
|
|
</details>
|
|
|
|
|
|
|
|
- #### *def* `__add__(self, other)`
|
|
|
|
|
|
|
|
|
|
|
|
P + V -> P
|
|
|
|
P + P -> P
|
|
|
|
|
|
|
|
参数:
|
|
|
|
|
|
|
|
other:
|
|
|
|
|
|
|
|
|
|
|
|
- #
|
|
|
|
<details>
|
|
|
|
<summary>源码</summary>
|
|
|
|
|
|
|
|
```python
|
|
|
|
def __add__(self, other):
|
|
|
|
"""
|
|
|
|
P + V -> P
|
|
|
|
P + P -> P
|
|
|
|
Args:
|
|
|
|
other:
|
|
|
|
Returns:
|
|
|
|
"""
|
|
|
|
return Point3(self.x + other.x, self.y + other.y, self.z + other.z)
|
|
|
|
```
|
|
|
|
</details>
|
|
|
|
|
|
|
|
- #### *def* `__eq__(self, other)`
|
|
|
|
|
|
|
|
|
|
|
|
判断两个点是否相等。
|
|
|
|
|
|
|
|
参数:
|
|
|
|
|
|
|
|
other:
|
|
|
|
|
|
|
|
|
|
|
|
- #
|
|
|
|
<details>
|
|
|
|
<summary>源码</summary>
|
|
|
|
|
|
|
|
```python
|
|
|
|
def __eq__(self, other):
|
|
|
|
"""
|
|
|
|
判断两个点是否相等。
|
|
|
|
Args:
|
|
|
|
other:
|
|
|
|
Returns:
|
|
|
|
"""
|
|
|
|
return approx(self.x, other.x) and approx(self.y, other.y) and approx(self.z, other.z)
|
|
|
|
```
|
|
|
|
</details>
|
|
|
|
|