了解 PDPageContentStream.setTextMatrix() 的参数

Question

我无法理解PDPageContentStream.setTextMatrix(Matrix m) 的参数矩阵m 中的6 个值表示什么。以前它使用 6 个值，但现在它需要一个包含所有值的矩阵。

是的，我已阅读文档，但发现解释完全没用 -

public void setTextMatrix(double a,
             double b,
             double c,
             double d,
             double e,
             double f)
               throws IOException

The Tm operator. Sets the text matrix to the given values. A current text matrix will be replaced with the new one.

Parameters:
a - The a value of the matrix.
b - The b value of the matrix.
c - The c value of the matrix.
d - The d value of the matrix.
e - The e value of the matrix.
f - The f value of the matrix.

我也搜索了示例，但我没有找到对这些值的解释。另外，奇怪的是，当我对 2 个不同的 PDF 文件尝试相同的值时，结果不同，所以我假设这与边距和距离等有关。

我觉得我在做猜测工作是在浪费时间。对论点的直接解释将非常好。

编辑

我知道矩阵以及如何传递值。我不知道矩阵中的值实际上是什么意思。

Answer 1

您可以尝试绕过新方法要求，使用 Matrix constructors 之一

setTextMatrix(new Matrix(Double.valueOf(a).floatValue(),
                             Double.valueOf(b).floatValue(),
                             Double.valueOf(c).floatValue(),
                             Double.valueOf(d).floatValue(),
                             Double.valueOf(e).floatValue(),
                             Double.valueOf(f).floatValue()))

损失一些double 准确性的风险很小。

编辑：
你可以看看这个例子 - UsingTextMatrix。

Per PDPageContentStream.java这是已弃用的setTextMethod，您查询过：

@Deprecated
public void setTextMatrix(double a, double b, double c, double d, double e, double f) throws IOException
{
    setTextMatrix(new Matrix((float)a, (float)b, (float)c, (float)d, (float)e, (float)f));
} 

这基本上可以满足我上面的尝试。因此，除了更紧凑的用法之外，不应该有任何重大差异。有关更多信息，请访问 org.apache.pdfbox.pdmodel.PDPageContentStream 类。

关于单浮点/双精度值的含义：

a, b, c, d, e, f 定义一个org.apache.pdfbox.cos.COSArray 的形式：

 static final float[] DEFAULT_SINGLE =
 {
        a,b,0,  
        c,d,0, 
        e,f,1 
 };

在哪里

a stands for ScaleX
b stands for ShearY
c stands for ShearX
d stands for ScaleY
e stands for TranslateX
f stands for TranslateY

在Wiki about Affine Transformations 中，您可以阅读到您可以使用这些值做什么。下面直观地表示了可能的操作：

注意：tX和tY在org.apache.pdfbox.util.Matrix和上图中的位置略有不同。

希望这能解决问题。