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 Xcoordinate 
Point.y 
the Ycoordinate 
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
orrect_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.
Type: Point

x
¶ The x coordinate
Type: float

y
¶ The y coordinate
Type: float

Note
 This class adheres to the Python sequence protocol, so components can be accessed via their index, too. Also refer to Using Python Sequences as Arguments in PyMuPDF.
 Rectangles can be used with arithmetic operators – see chapter Operator Algebra for Geometry Objects.