PyMuPDF中的IRect类详解：整数矩形操作指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00484/article/details/148464410

PyMuPDF中的IRect类详解：整数矩形操作指南

PyMuPDF PyMuPDF is a high performance Python library for data extraction, analysis, conversion & manipulation of PDF (and other) documents. 项目地址: https://gitcode.com/gh_mirrors/py/PyMuPDF

什么是IRect？

IRect是PyMuPDF库中用于表示整数矩形区域的类，它与常规的Rect类非常相似，但所有坐标值都是整数类型。IRect特别适合处理像素级的操作，比如在图像渲染过程中指定接收图像数据的区域。

IRect的核心特性

IRect具有以下重要特性：

所有坐标值均为整数（int类型）
可以表示有效矩形、空矩形和无限矩形
支持多种构造方式
提供丰富的属性和方法用于矩形操作

构造IRect对象

IRect提供多种构造方式，满足不同场景需求：

# 空构造
irect1 = IRect()

# 通过四个坐标值构造
irect2 = IRect(x0, y0, x1, y1)

# 通过另一个IRect复制构造
irect3 = IRect(irect2)

# 通过序列构造（列表、元组等）
irect4 = IRect([x0, y0, x1, y1])

需要注意的是，当使用序列构造时，非整数值会被截断为整数，非数值类型会引发异常。

常用属性详解

IRect提供了丰富的属性来访问和操作矩形：

基础属性

x0, y0: 左上角坐标
x1, y1: 右下角坐标
width: 矩形宽度（绝对值）
height: 矩形高度（绝对值）

状态属性

is_empty: 判断矩形是否为空
is_infinite: 判断矩形是否为无限大

角点属性

top_left/tl: 左上角点
top_right/tr: 右上角点
bottom_left/bl: 左下角点
bottom_right/br: 右下角点

转换属性

rect: 转换为浮点型Rect对象
quad: 转换为四边形对象

核心方法解析

包含判断（contains）

检查一个点或矩形是否在当前矩形内：

point = (10, 20)
if irect.contains(point):
    print("点在矩形内")

面积计算（get_area）

计算矩形面积，支持不同单位：

area_px = irect.get_area()  # 默认像素单位
area_cm = irect.get_area("cm")  # 平方厘米

矩形相交（intersect）

计算两个矩形的交集：

irect1.intersect(irect2)  # 结果保存在irect1中

相交判断（intersects）

判断两个矩形是否有交集：

if irect1.intersects(irect2):
    print("矩形有交集")

矩阵变换（torect）

计算将当前矩形变换到目标矩形的变换矩阵：

matrix = irect1.torect(irect2)  # 获取变换矩阵

规范化（normalize）

确保矩形坐标是"规范化"的（左上角坐标小于右下角）：

irect.normalize()

使用场景示例

图像处理

# 定义一个图像区域
image_area = IRect(0, 0, 800, 600)

# 检查鼠标点击位置是否在图像区域内
mouse_click = (400, 300)
if image_area.contains(mouse_click):
    print("点击在图像区域内")

文档分析

# 获取页面中的特定区域
page_rect = page.rect  # 获取页面矩形
content_area = IRect(page_rect.x0 + 50, page_rect.y0 + 50, 
                     page_rect.x1 - 50, page_rect.y1 - 50)

# 只处理内容区域内的元素
for annot in page.annots():
    if content_area.intersects(annot.rect):
        process_annot(annot)