Skip to content

# 模块 `mbcp.mp_math.point` ​

本模块定义了三维空间中点的类。

### class `Point3` ​

#### method `__init__(self, x: float, y: float, z: float)` ​

说明: 笛卡尔坐标系中的点。

参数:

> - x (`float`): x 坐标
> - y (`float`): y 坐标
> - z (`float`): z 坐标

源代码 或 在GitHub上查看
python

    def __init__(self, x: float, y: float, z: float):
        self.x = x
        self.y = y
        self.z = z

#### method `approx(self, other: Point3, epsilon: float = APPROX) -> bool` ​

说明: 判断两个点是否近似相等。

参数:

> - other (`Point3`): 另一个点
> - epsilon (`float`): 误差

返回: `bool`: 是否近似相等

源代码 或 在GitHub上查看
python

    def approx(self, other: 'Point3', epsilon: float=APPROX) -> bool:
        return all([abs(self.x - other.x) < epsilon, abs(self.y - other.y) < epsilon, abs(self.z - other.z) < epsilon])

`@overload`

#### method `self + other: Vector3 => Point3` ​

源代码 或 在GitHub上查看
python

    @overload
    def __add__(self, other: 'Vector3') -> 'Point3':
        ...

`@overload`

#### method `self + other: Point3 => Point3` ​

源代码 或 在GitHub上查看
python

    @overload
    def __add__(self, other: 'Point3') -> 'Point3':
        ...

#### method `self + other` ​

说明: P + V -> P P + P -> P

参数:

> - other (`Vector3` | `Point3`): 另一个点或向量

返回: `Point3`: 新的点

源代码 或 在GitHub上查看
python

    def __add__(self, other):
        return Point3(self.x + other.x, self.y + other.y, self.z + other.z)

#### method `self == other` ​

说明: 判断两个点是否相等。

参数:

> - other (`Point3`): 另一个点

返回: `bool`: 是否相等

源代码 或 在GitHub上查看
python

    def __eq__(self, other):
        return approx(self.x, other.x) and approx(self.y, other.y) and approx(self.z, other.z)

#### method `self - other: Point3 => Vector3` ​

说明: P - P -> V

P - V -> P 已在 `Vector3` 中实现

参数:

> - other (`Point3`): 另一个点

返回: `Vector3`: 新的向量

源代码 或 在GitHub上查看
python

    def __sub__(self, other: 'Point3') -> 'Vector3':
        from .vector import Vector3
        return Vector3(self.x - other.x, self.y - other.y, self.z - other.z)