在获取 PDF 内容边距时，rectI和rectF这两种坐标表示方式有什么区别？ - 福昕PDF支持中心

福昕PDF SDK 软件开发工具包 | 福昕PDF SDK 软件开发工具包 > 福昕PDF SDK(桌面/服务器)

标签:
RectF,RectI,坐标

在获取 PDF 内容边距时，rectI和rectF这两种坐标表示方式有什么区别？

福昕知识库
2025-06-23

rectI和rectF是 PDF 处理中用于表示矩形区域的两种数据结构，主要区别体现在坐标精度、应用场景和坐标系定义上。以下是详细对比与使用说明：

核心区别解析

1. 坐标值类型与精度

类型	坐标值类型	精度特点	适用场景
rectI	整数（int）	坐标值为整数，无小数部分	对精度要求不高的像素级操作
rectF	浮点数（float/double）	可包含小数，精度更高	需精确计算的排版、测量或渲染场景

2. 坐标系定义差异

图片 / UI 坐标系（rectI 常用场景）：
以左上角为原点 (0,0)，横向向右为 X 轴正方向，纵向向下为 Y 轴正方向。
▶ 示例：矩形区域(10, 20, 100, 200)表示左上角 X=10、Y=20，右下角 X=100、Y=200。
PDF 坐标系（rectF 常用场景）：
以左下角为原点 (0,0)，横向向右为 X 轴正方向，纵向向上为 Y 轴正方向。
▶ 示例：矩形区域(10, 20, 100, 200)表示左下角 X=10、Y=20，右上角 X=100、Y=200。

3. rectI：整数坐标的典型场景

图片处理与显示

PDF 页面缩略图生成：
生成低精度预览图时，可用整数坐标快速定位页面区域，减少计算开销。

4. rectF：浮点坐标的典型场景

PDF 内容测量与排版：
PDF 的页面单位为点（point，1pt=1/72 英寸），需浮点精度表示边距、文本位置等。
示例：某 PDF 页面边距为(36.0f, 72.0f, 36.0f, 72.0f)（左、右、下、上），对应 1 英寸边距（36pt=0.5 英寸，72pt=1 英寸）。
坐标转换与精确计算：
当需要将 PDF 坐标（左下原点）转换为图片坐标（左上原点）时，需浮点运算保证精度。

相关内容

如何在权限受限的PDF文档中实现水印插入？

WebSDK 富文本设置指南：为注释内容添加下划线/斜体样式

Conversion SDK Python 版本对 Python 3.12 的兼容性说明

在 PDF 处理中，calcContentBBox和calculateBBoxByColor这两个方法的核心区别是什么？若要计算内容边距，该如何选择？

如何从一个PDF文件中提取第 2 页到第 3 页，生成一个新的PDF文件？

PDF打印时，如何在每张纸上放置多页？

扫描件如何转为可编辑的Word？

如何批量OCR文档？

PDF文档中如何添加下划线？

如何在PDF中添加超链接？

推荐内容

如何在权限受限的PDF文档中实现水印插入？

WebSDK 富文本设置指南：为注释内容添加下划线/斜体样式

Conversion SDK Python 版本对 Python 3.12 的兼容性说明

在 PDF 处理中，calcContentBBox和calculateBBoxByColor这两个方法的核心区别是什么？若要计算内容边距，该如何选择？

在获取 PDF 内容边距时，rectI和rectF这两种坐标表示方式有什么区别？

如何从一个PDF文件中提取第 2 页到第 3 页，生成一个新的PDF文件？

PDF打印时，如何在每张纸上放置多页？

扫描件如何转为可编辑的Word？

如何批量OCR文档？

PDF文档中如何添加下划线？