文档 · PDF 工具包
MediaBox、CropBox 和 /Rotate: PDF 如何定义其页面
· 背景
pdf 页面几何 旋转
PDF 页面在日常意义上没有固定的“大小”；它有观众解读的方框、单位和旋转值。这篇文章解释了这些属性以及当您合并、旋转或为不同形状的页面添加水印时它们的含义。
为什么合并的文件具有两种尺寸的页面 - 混合 A4 和 Letter 文档并在结果中看到两种形状
合并 A4 和 US Letter 源不会强制将每张纸合并为一个矩形。 ToolAcre 会复制每个页面的现有尺寸和旋转，因此输出可以明显地改变尺寸。该行为会保留源几何图形，而不是将内容拉伸到公共工作表。
混合尺寸影响打印、缩略图布局、水印位置和光栅输出。检查页面边界处的合并文件并仔细选择打印机缩放比例。合并不是标准化工具，文件为 PDF 并不意味着每个页面都具有相同的宽度或高度。
该工具包使用 PDF 点，但不提供一般单元历史课程
图像到 PDF 操作公开了应用程序代码实际使用的单位：边距以点为单位测量。适合的图像页面可以匹配嵌入图像尺寸加上两倍的边距，而预设纸张使用配置的点宽度和高度。消息来源并未建立该单位更广泛的历史。
像素进入不同的路径。 PDF-to-image 向 pdf.js 请求选定比例的视口，并从这些像素尺寸分配画布。因此，页面可以具有稳定的 PDF 几何形状，同时根据比例和内存保护生成更大或更小的光栅。点和输出像素不是可互换的设置。
此接口未公开 MediaBox 和 CropBox 的区别
工作簿区分 MediaBox 和 CropBox，但此界面不显示、编辑或让用户在这些框之间进行选择。应用程序操作向库页面对象询问宽度和高度，并按提供的方式复制页面。详细的框优先级解释需要这些来源之外的直接规范证据。
实际指导是检查可见结果。如果源查看器裁剪标记或显示意外的空白，则合并会保留页面而不是修复其框。水印放置使用库显示的尺寸，PDF-to-image 渲染 pdf.js 提供的视口。
该工具读取并添加页面旋转，而不断言继承节点行为
旋转存储为操作通过 pdf-lib 读取的页面角度。 ToolAcre 添加请求的四分之一圈并将结果标准化为 0、90、180 或 270。它不会暴露输入值是直接源自页面还是通过继承的内部结构。
该省略并不会削弱使用规则：旋转是相对的。将 90 度应用于当前在 270 处报告的页面会产生 0。该工具保持存储的尺寸不变，并且不转换内容流。第二遍再次添加，因此在选择另一回合之前请检查当前输出。
纵向和横向 - 为什么方向是盒子尺寸和旋转共同的结果，而不是单独的标志
纵向和横向是页面尺寸、内容和应用旋转的结果，而不是此界面中的单独控件。 0 度的宽页面和旋转 90 度的高页面都可以显示为横向。该工具包不会重新标记方向；它根据所选操作复制尺寸或更新旋转。
这解释了为什么混合扫描需要特定于页面的处理。根据可见内容而不是猜测的方向标志来选择物理位置。对于图像到 PDF 预设，纵向和横向是明确的纸张尺寸，而“匹配每个图像”会根据每个图片自身的宽度和高度创建页面。
页面级工具的后果 - 合并保留每个页面自己的框，并且必须相对于每个页面的框放置水印
合并保留每个页面自己的尺寸和旋转。水印根据每个页面的宽度和高度计算位置，将图像标记缩放为页面宽度的一部分，并在选定的锚点处绘制文本。因此，固定的文本大小在小纸张和大绘图上可能会感觉不同。
有角度的标记围绕其锚点旋转，并根据未旋转的标记测量值进行定位，因此对角标记可能不会占据直观中心。测试混合页面大小和现有旋转。当源页面不同时，即使在一种选定的比例下，PDF-to-image 同样会产生混合像素尺寸。
印前框和统一页面缩放不属于此工具包
BleedBox、TrimBox、ArtBox、印前拼版和统一页面缩放此处未实现选项。该工具包也不会在合并期间将页面裁剪到选定的框或调整复制页面的大小。这些工作流程需要明确记录几何控制和输出保证的软件。
避免将成功的合并描述为打印规范化。对于专业生产，请在页面工作后使用印前工具检查盒子并缩放。 ToolAcre 适用于在其规定的行为下进行复制、排序、四分之一转动、标记和转换，而不是用于验证可印刷的页面定义。
每页尺寸和附加旋转预测发货操作
最有用的几何模型是基于源的：每个页面都包含尺寸和当前旋转；合并复制它们，旋转添加到角度，水印读取放置尺寸，光栅转换将渲染的视口转换为像素。这些事实预测了用户会看到什么。
他们还确定什么不会自动发生。页面不统一，框不暴露以供编辑，并且内容在旋转期间不重新绘制。在最终查看器中检查混合尺寸输出，保留原件，并在作业超出这些页面级操作时使用专门的几何工具。对于打印，请单独检查缩放设置，因为在 PDF 工具包忠实保留混合源尺寸后，打印机可以强加自己的适合行为。打印预览可以显示由目标设置而不是本地页面副本本身引起的剪裁或意外居中。在打印整个混合数据包之前，对最大和最小纸张的额外检查通常会暴露缩放假设。