PDFBox将英寸或厘米转换为坐标系

Question

我是PDFBox（和PDF生成）的新手，很难生成自己的PDF。

我确实有以英寸/厘米为单位的某些坐标的文本，我需要将它们转换为PDFBox使用的单位。任何建议/实用程序都可以自动执行此操作吗？

PDPageContentStream。moveTextPositionByAmount（x，y）对我来说毫无意义。

Answer 1

通常，PDFBox在创建PDF时使用PDF用户空间坐标。这意味着：

>

页面的坐标由CropBox分隔，CropBox默认为MediaBox，值从左到右、从下到上递增。因此，如果使用new PDPage（）或new PDPage（PDPage.page\u SIZE\u*）创建页面，坐标系的原点从页面的左下角开始。

用户空间中的单位以默认用户空间单位开始，该单位由页面的用户单位定义。大多数情况下（例如，如果您使用任何构造函数创建页面，并且没有显式更改该值），它没有显式设置，因此，其默认值为1⁄72英寸。

通过将一些矩阵连接到当前变换矩阵，可以非常任意地改变用户空间坐标系。当前变换矩阵以单位矩阵开始。

在PDFBox中，您可以使用PDPageContentStream.concatenate2CTM（）重载之一来执行此操作。

只要您使用PDPageContentStream切换到文本模式。beginText（），使用的坐标系还受到文本矩阵引入的变换的影响。

在PDFBox中，使用PDPageContentStream中的一个设置文本矩阵。setTextMatrix（）重载。

由于您是PDFBox的新手（如您所说）和一般的PDF新手（因为我假设，否则您可能会认识到坐标），我建议您最初尽可能使用转换副歌，因此，保持坐标系从左下角开始的状态，既不旋转也不倾斜，单位长度为1/72英寸。

在这种情况下，您实际上可以使用PDFBox提供的常量进行转换：

• 将坐标以英寸为单位乘以PDPage。DEFAULT_USER_SPACE_UNIT_DPI以获取默认的用户空间坐标。
• 将坐标以mm为单位乘以PDPage。MM_TO_UNITS以获取默认的用户空间坐标。

但是，如果您想享受坐标的乐趣，请查看PDF规范ISO-32000-1并研究第8.3节坐标系统和9.4.4节文本空间详细信息。

上面指向的PDPage常量过去在早期的PDFBox 1.8. x版本中可以访问，但后来被隐藏（私有），并最终在过渡到PDFBox 2. x时被删除。

作为参考，常数定义如下

private static final int DEFAULT_USER_SPACE_UNIT_DPI = 72;

private static final float MM_TO_UNITS = 1/(10*2.54f)*DEFAULT_USER_SPACE_UNIT_DPI;