模块 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上查看

def __init__(self, x: float, y: float, z: float):
    """
        笛卡尔坐标系中的点。
        Args:
            x ([`float`](https://docs.python.org/3/library/functions.html#float)): x 坐标
            y (`float`): y 坐标
            z (`float`): z 坐标
        """
    self.x = x
    self.y = y
    self.z = z

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

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

参数:

• other (Point3): 另一个点
• epsilon (float): 误差

返回: bool: 是否近似相等

源代码 或 在GitHub上查看

def approx(self, other: 'Point3', epsilon: float=APPROX) -> bool:
    """
        判断两个点是否近似相等。
        Args:
            other ([`Point3`](./point#class-point3)): 另一个点
            epsilon ([`float`](https://docs.python.org/3/library/functions.html#float)): 误差
        Returns:
            [`bool`](https://docs.python.org/3/library/functions.html#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上查看

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

@overload

method self + other: Point3 => Point3

源代码 或 在GitHub上查看

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

method self + other

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

参数:

• other (Vector3 | Point3): 另一个点或向量

返回: Point3: 新的点

源代码 或 在GitHub上查看

def __add__(self, other):
    """
        P + V -> P
        P + P -> P
        Args:
            other ([`Vector3`](./vector#class-vector3) | [`Point3`](./point#class-point3)): 另一个点或向量
        Returns:
            [`Point3`](./point#class-point3): 新的点
        """
    return Point3(self.x + other.x, self.y + other.y, self.z + other.z)

method __eq__(self, other)

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

参数:

• other (Point3): 另一个点

返回: bool: 是否相等

源代码 或 在GitHub上查看

def __eq__(self, other):
    """
        判断两个点是否相等。
        Args:
            other ([`Point3`](./point#class-point3)): 另一个点
        Returns:
            [`bool`](https://docs.python.org/3/library/functions.html#bool): 是否相等
        """
    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上查看

def __sub__(self, other: 'Point3') -> 'Vector3':
    """
        P - P -> V

        P - V -> P  已在 [`Vector3`](./vector#class-vector3) 中实现
        Args:
            other ([`Point3`](./point#class-point3)): 另一个点
        Returns:
            [`Vector3`](./vector#class-vector3): 新的向量
        """
    from .vector import Vector3
    return Vector3(self.x - other.x, self.y - other.y, self.z - other.z)