在获取 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 坐标（左下原点）转换为图片坐标（左上原点）时，需浮点运算保证精度。

相关内容

解决自定义Item添加铅笔注释后保存内容丢失的问题

如何在WebSDK中设置选中文本后不显示选择提示控件

如何设置Word/Excel/PPT转PDF的默认引擎（微软Office或WPS）？

福昕PDF编辑器（移动端）常用功能指南：编辑、高亮、标注、新建页面……

多个PDF文档搜索同一关键词，并导出数据，如何操作？

如何一次性修改PDF文档中的字体？

PDF书签跳转后缩放被重置？承前缩放：一招锁定阅读比例！

如何获取服务器ID以更新福昕管理后台授权？

PDFViewCtrl移动端集成：禁用WebViewer双击注释弹窗的代码实现

安装时提示无法访问 Windows Installer 服务

推荐内容

解决自定义Item添加铅笔注释后保存内容丢失的问题

如何在WebSDK中设置选中文本后不显示选择提示控件

如何设置Word/Excel/PPT转PDF的默认引擎（微软Office或WPS）？

福昕PDF编辑器（移动端）常用功能指南：编辑、高亮、标注、新建页面……

多个PDF文档搜索同一关键词，并导出数据，如何操作？

如何一次性修改PDF文档中的字体？

PDF书签跳转后缩放被重置？承前缩放：一招锁定阅读比例！

如何获取服务器ID以更新福昕管理后台授权？

PDFViewCtrl移动端集成：禁用WebViewer双击注释弹窗的代码实现

安装时提示无法访问 Windows Installer 服务