#

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

属性 / 方法

描述

Point.distance_to()

计算到点或矩形的距离

Point.norm()

欧几里得范数

Point.transform()

用矩阵转换点

Point.abs_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序列作为参数)。

Parameters:
  • x (float) – 点的x坐标

  • y (float) – 点的 y 坐标

distance_to(x[, unit])#

计算与 x 的距离,x 可能是 point_likerect_like。距离的单位可以是像素(默认)、英寸、厘米或毫米。

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

  • 单位 (str) – 要测量的单位。可以是“px”、“in”、“cm”、“mm”中的一个。

Return type:

浮点数

Returns:

x的距离。如果这是rect_like,那么距离

  • 是连接到矩形边之一的最短线段的长度

  • 计算为它的有限版本

  • 如果包含该点,则为零

norm()#
  • 版本 1.16.0 中的新功能

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

transform(m)#

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

Parameters:

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

Return type:

unit#

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

_images/img-point-unit.jpg
Type:

abs_unit#

与上面的 unit 相同,将坐标替换为它们的绝对值。

Type:

x#

x坐标

Type:

浮点数

y#

y坐标

Type:

浮点数

注意


本软件按原样提供,不作任何明示或暗示的担保。该软件根据许可证分发,除非按照该许可证的条款明确授权,否则不得复制、修改或分发。有关许可信息,请参阅artifex.com或联系Artifex Software Inc.,地址:39 Mesa Street, Suite 108A, San Francisco CA 94129, United States以获取更多信息。