Point

Point represents a point in the plane, defined by its x and y coordinates.

Attribute / Method

Description

Point.distance_to()

calculate distance to point or rect

Point.norm()

the Euclidean norm

Point.transform()

transform point with a matrix

Point.abs_unit

same as unit, but positive coordinates

Point.unit

point coordinates divided by abs(point)

Point.x

the X-coordinate

Point.y

the Y-coordinate

Class API

class Point
__init__(self)
__init__(self, x, y)
__init__(self, point)
__init__(self, sequence)

Overloaded constructors.

Without parameters, Point(0, 0) will be created.

With another point specified, a new copy will be crated, “sequence” is a Python sequence of 2 numbers (see Using Python Sequences as Arguments in PyMuPDF).

Parameters
  • x (float) – x coordinate of the point

  • y (float) – y coordinate of the point

distance_to(x[, unit])

Calculate the distance to x, which may be point_like or rect_like. The distance is given in units of either pixels (default), inches, centimeters or millimeters.

Parameters
  • x (point_like,rect_like) – to which to compute the distance.

  • unit (str) – the unit to be measured in. One of “px”, “in”, “cm”, “mm”.

Return type

float

Returns

the distance to x. If this is rect_like, then the distance

  • is the length of the shortest line connecting to one of the rectangle sides

  • is calculated to the finite version of it

  • is zero if it contains the point

norm()
  • New in version 1.16.0

Return the Euclidean norm (the length) of the point as a vector. Equals result of function abs().

transform(m)

Apply a matrix to the point and replace it with the result.

Parameters

m (matrix_like) – The matrix to be applied.

Return type

Point

unit

Result of dividing each coordinate by norm(point), the distance of the point to (0,0). This is a vector of length 1 pointing in the same direction as the point does. Its x, resp. y values are equal to the cosine, resp. sine of the angle this vector (and the point itself) has with the x axis.

_images/img-point-unit.jpg
Type

Point

abs_unit

Same as unit above, replacing the coordinates with their absolute values.

Type

Point

x

The x coordinate

Type

float

y

The y coordinate

Type

float

Note