Space_ops¶

manimlib/utils/space_ops.py 这个文件中主要实现了和空间坐标计算有关的函数

manimlib.utils.space_ops.get_norm(vect)¶

返回向量 vect 的模长

manimlib.utils.space_ops.quaternion_mult(*quats)¶

返回两个 四元数 q1, q2 相乘的乘积

manimlib.utils.space_ops.quaternion_from_angle_axis(angle, axis, axis_normalized=False)¶

根据 轴-角 确定用于旋转的 四元数 返回[cos(angle/2), sin(angle/2)*axis]

manimlib.utils.space_ops.angle_axis_from_quaternion(quaternion)¶

返回从四元数确定旋转的轴和角

manimlib.utils.space_ops.quaternion_conjugate(quaternion)¶

返回 quaternion 的共轭四元数

manimlib.utils.space_ops.rotate_vector(vector, angle, axis=array([0.0, 0.0, 1.0]))¶

返回将vector以axis为轴，旋转angle角度后的向量

若 vector 是二维 ndarray，则使用复数运算
若 vector 是三维 ndarray，则使用四元数运算

manimlib.utils.space_ops.thick_diagonal(dim, thickness=2)¶

返回一个 dim*dim 大小，对角线宽度为 thickness 的方阵

manimlib.utils.space_ops.rotation_matrix_transpose_from_quaternion(quat)¶

返回通过四元数确定的旋转矩阵（但是转置的）

manimlib.utils.space_ops.rotation_matrix_from_quaternion(quat)¶

返回通过四元数确定的旋转矩阵

manimlib.utils.space_ops.rotation_matrix_transpose(angle, axis)¶

返回通过角 angle 轴 axis 确定的旋转矩阵（但是转置的）

manimlib.utils.space_ops.rotation_matrix(angle, axis)¶: Rotation in R^3 about a specified axis of rotation.

返回通过角 angle 轴 axis 确定的旋转矩阵

manimlib.utils.space_ops.rotation_about_z(angle)¶

返回沿 z 轴旋转 angle 的旋转矩阵

manimlib.utils.space_ops.z_to_vector(vector)¶: Returns some matrix in SO(3) which takes the z-axis to the (normalized) vector provided as an argument

返回可以使 z 轴方向旋转到 vector 方向的变换矩阵

manimlib.utils.space_ops.angle_of_vector(vector)¶: Returns polar coordinate theta when vector is project on xy plane

返回 vector 在 xy 平面投影的极坐标系下的 theta

manimlib.utils.space_ops.angle_between_vectors(v1, v2)¶: Returns the angle between two 3D vectors. This angle will always be btw 0 and pi

返回两向量 v1, v2 的夹角

manimlib.utils.space_ops.project_along_vector(point, vector)¶

点在向量上的投影

manimlib.utils.space_ops.normalize(vect, fall_back=None)¶

返回 vect 的单位向量

若 vect 为零向量，且 fall_back=None，返回零向量
若 vect 为零向量，且 fall_back不为None，返回 fall_back

manimlib.utils.space_ops.normalize_along_axis(array, axis, fall_back=None)¶

将所有向量沿 axis 单位化

manimlib.utils.space_ops.cross(v1, v2)¶

返回两向量 v1, v2 的叉积

manimlib.utils.space_ops.get_unit_normal(v1, v2, tol=1e-06)¶

返回向量 v1, v2 确定的平面的法向量

manimlib.utils.space_ops.compass_directions(n=4, start_vect=array([1.0, 0.0, 0.0]))¶

将 TAU 分成 n 份，从 start_vect 开始返回沿每个方向的单位向量

manimlib.utils.space_ops.complex_to_R3(complex_num)¶

复数转化为坐标（z 轴为 0）

manimlib.utils.space_ops.R3_to_complex(point)¶

取坐标前两轴为复数

manimlib.utils.space_ops.complex_func_to_R3_func(complex_func)¶

将针对复数的函数转化为针对坐标的函数

manimlib.utils.space_ops.center_of_mass(points)¶

返回点集 points 的重心

manimlib.utils.space_ops.midpoint(point1, point2)¶

返回 point1，point2 的中点

manimlib.utils.space_ops.line_intersection(line1, line2)¶: return intersection point of two lines, each defined with a pair of vectors determining the end points

返回两直线交点

注意： 需要使用get_start_and_end()

p = line_intersection(
    l1.get_start_and_end(),
    l2.get_start_and_end()
)

manimlib.utils.space_ops.find_intersection(p0, v0, p1, v1, threshold=1e-05)¶: Return the intersection of a line passing through p0 in direction v0 with one passing through p1 in direction v1. (Or array of intersections from arrays of such points/directions). For 3d values, it returns the point on the ray p0 + v0 * t closest to the ray p1 + v1 * t

过 p0 点，v0 向量方向上的射线 l1，与过 p1 点，v1 的向量上的射线 l2 的交点

如果是三维的情况，则返回两射线距离最近的点

manimlib.utils.space_ops.get_closest_point_on_line(a, b, p)¶: It returns point x such that x is on line ab and xp is perpendicular to ab. If x lies beyond ab line, then it returns nearest edge(a or b).

找到点 p 到线段 ab 距离最近的点 x

如果 p 点投影在线段 ab 上，则返回垂足
如果 p 点投影不在线段 ab 上，则返回与投影最接近的线段端点

manimlib.utils.space_ops.get_winding_number(points)¶

返回卷绕数

manimlib.utils.space_ops.cross2d(a, b)¶

二阶矩阵相乘，如果 a 不是二阶矩阵，则返回 a[0] * b[1] - b[0] * a[1]

manimlib.utils.space_ops.tri_area(a, b, c)¶

manimlib.utils.space_ops.is_inside_triangle(p, a, b, c)¶: Test if point p is inside triangle abc

判断点 p 是否在点 a, b, c 构成的三角形中

manimlib.utils.space_ops.norm_squared(v)¶

三维向量模长平方

（似乎可以用其他方法计算任意维度向量模长平方，例如 (v ** 2).sum() ）

manimlib.utils.space_ops.earclip_triangulation(verts, ring_ends)¶

Returns a list of indices giving a triangulation of a polygon, potentially with holes

verts is a numpy array of points
ring_ends is a list of indices indicating where the ends of new paths are

三角剖分