#

Point 表示平面上的一个点,由其 x 和 y 坐标定义。

属性 / 方法

描述

Point.distance_to()

计算与点或矩形的距离

Point.norm()

欧几里得范数

Point.transform()

使用矩阵变换点

Point.abs_unit

与 unit 相同,但坐标为正值

Point.unit

点坐标除以 abs(point)

Point.x

X 坐标

Point.y

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_likerect_like。距离单位可以是像素(默认)、英寸、厘米或毫米。

参数
  • x (point_like,rect_like) – 计算距离的对象。

  • unit (str) – 测量单位。可以是“px”、“in”、“cm”、“mm”之一。

返回类型

float

返回值

x 的距离。如果 xrect_like,则距离

  • 是连接到矩形任意一侧的最短线的长度

  • 是计算到其有限版本的距离

  • 如果矩形包含该点,则距离为零

norm()#
  • 1.16.0 版本新增

返回点的欧几里得范数(长度)作为一个向量。等于函数 abs() 的结果。

transform(m)#

将矩阵应用于点并用结果替换它。

参数

m (matrix_like) – 要应用的矩阵。

返回类型

Point

unit#

将每个坐标除以 norm(point) 的结果,即点到 (0,0) 的距离。这是一个长度为 1 的向量,指向与该点相同的方向。其 x 和 y 值分别等于该向量(和点本身)与 x 轴夹角的余弦和正弦。

_images/img-point-unit.jpg
类型

Point

abs_unit#

与上面的 unit 相同,但坐标被其绝对值替换。

类型

Point

x#

x 坐标

类型

float

y#

y 坐标

类型

float

注意


本软件按“现状”提供,不附带任何明示或暗示的保证。本软件根据许可进行分发,除非获得该许可条款的明确授权,否则不得复制、修改或分发。有关许可信息,请访问 artifex.com 或联系 Artifex Software Inc., 39 Mesa Street, Suite 108A, San Francisco CA 94129, United States 获取更多信息。