点#
Point 表示平面上的一个点,由其 x 和 y 坐标定义。
属性 / 方法 |
描述 |
---|---|
计算与点或矩形的距离 |
|
欧几里得范数 |
|
使用矩阵变换点 |
|
与 unit 相同,但坐标为正值 |
|
点坐标除以 abs(point) |
|
X 坐标 |
|
Y 坐标 |
类 API
- class Point#
- __init__(self)#
- __init__(self, x, y)#
- __init__(self, point)#
- __init__(self, sequence)#
重载的构造函数。
如果没有参数,将创建 Point(0, 0)。
如果指定另一个点,将创建新副本,“sequence” 是一个包含 2 个数字的 Python 序列(详见在 PyMuPDF 中使用 Python 序列作为参数)。
- 参数:
x (float) – 点的 x 坐标
y (float) – 点的 y 坐标
- distance_to(x[, unit])#
计算到 x 的距离,x 可以是
point_like
或rect_like
。距离单位可以是像素(默认)、英寸、厘米或毫米。- 参数:
x (point_like,rect_like) – 计算距离的对象。
unit (str) – 测量单位。可以是“px”、“in”、“cm”、“mm”之一。
- 返回类型:
float
- 返回值:
到 x 的距离。如果 x 是
rect_like
,则距离是连接到矩形任意一侧的最短线的长度
是计算到其有限版本的距离
如果矩形包含该点,则距离为零
- norm()#
1.16.0 版本新增
返回点的欧几里得范数(长度)作为一个向量。等于函数 abs() 的结果。
- unit#
将每个坐标除以 norm(point) 的结果,即点到 (0,0) 的距离。这是一个长度为 1 的向量,指向与该点相同的方向。其 x 和 y 值分别等于该向量(和点本身)与 x 轴夹角的余弦和正弦。
- 类型:
- x#
x 坐标
- 类型:
float
- y#
y 坐标
- 类型:
float
注意
此类遵循 Python 序列协议,因此组件也可以通过索引访问。另请参阅 在 PyMuPDF 中使用 Python 序列作为参数。
矩形可以使用算术运算符 – 参见 几何对象的运算符代数 一章。