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

这两个方法分属不同技术路径，前者基于 PDF 文档结构分析，后者依赖图像像素检测，适用场景差异显著。以下是详细对比与选择建议：

技术逻辑：
通过解析 PDF 页面的内容流（Content Stream），提取所有可见对象（文本、路径、图像等）的几何坐标，计算其最小包围矩形。
关键特点：
- 直接操作 PDF 原始数据，无需栅格化（转图片）。
- 受 PDF 渲染特性影响，透明对象（如透明文本、半透明线条）会被计入边界，即使其视觉上不可见。

技术逻辑：
1. 将 PDF 页面转换为位图（如 PNG/JPG）；
2. 检测非背景色像素的分布范围，计算其最小包围矩形。
关键特点：
- 结果与人眼视觉完全一致，仅包含实际可见内容（透明 / 背景色区域被排除）。
- 需处理 PDF→图片的坐标系转换（PDF 左下原点→图片左上原点）。

维度	calcContentBBox	calculateBBoxByColor
核心优势	– 处理速度快，无需图片转换 – 适合纯矢量 PDF（无透明元素）	– 结果与视觉效果完全一致 – 抗透明元素干扰
核心劣势	– 透明对象会扩大边界 – 无法处理图像蒙板等复杂效果	– 需额外图片转换步骤，耗时较长 – 受 DPI 影响精度
适用场景	– 工程图纸、无透明元素的文本 PDF – 对速度要求高的批量处理	– 含透明效果的设计稿、电子签章 PDF – 需要与人眼所见一致的场景
典型误差案例	透明水印文本被计入边界，导致边距计算偏大	低 DPI 转换时，细小文字边缘被误判为背景色