将链接注释添加到 PDF 文档

Question

如何向 PDF 添加注释（以特定形状）？

我希望能够控制：

• 链接目标
• 颜色
• 链接注释的形状
• 链接注释的位置

Answer 1

免责声明：我是此答案中使用的库的作者

为了展示这种行为，本示例将使用“像素艺术”重新创建一个形状。

这个数组和这些颜色一起定义了超级玛丽的形状：

    m = [
        [0, 0, 0, 0, 1, 1, 1, 1, 1, 0, 0, 0, 0, 0],
        [0, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0],
        [0, 0, 0, 2, 2, 2, 3, 3, 2, 3, 0, 0, 0, 0],
        [0, 0, 2, 3, 2, 3, 3, 3, 2, 3, 3, 3, 0, 0],
        [0, 0, 2, 3, 2, 2, 3, 3, 3, 2, 3, 3, 3, 0],
        [0, 0, 2, 2, 3, 3, 3, 3, 2, 2, 2, 2, 0, 0],
        [0, 0, 0, 0, 3, 3, 3, 3, 3, 3, 3, 0, 0, 0],
        [0, 0, 0, 1, 1, 4, 1, 1, 1, 1, 1, 0, 0, 0],
        [0, 0, 1, 1, 1, 4, 1, 1, 4, 1, 1, 1, 0, 0],
        [0, 1, 1, 1, 1, 4, 4, 4, 4, 1, 1, 1, 1, 0],
        [0, 3, 3, 1, 4, 5, 4, 4, 5, 4, 1, 3, 3, 0],
        [0, 3, 3, 3, 4, 4, 4, 4, 4, 4, 3, 3, 3, 0],
        [0, 3, 3, 4, 4, 4, 4, 4, 4, 4, 4, 3, 3, 0],
        [0, 0, 0, 4, 4, 4, 0, 0, 4, 4, 4, 0, 0, 0],
        [0, 0, 2, 2, 2, 0, 0, 0, 0, 2, 2, 2, 0, 0],
        [0, 2, 2, 2, 2, 0, 0, 0, 0, 2, 2, 2, 2, 0],
    ]
    c = [
        None,
        X11Color("Red"),
        X11Color("Black"),
        X11Color("Tan"),
        X11Color("Blue"),
        X11Color("White"),
    ]

要操作 PDF，我将使用 pText。
首先，我们将阅读现有的 PDF：

    # attempt to read PDF
    doc = None
    with open("boring-input.pdf", "rb") as in_file_handle:
        print("\treading (1) ..")
        doc = PDF.loads(in_file_handle)

然后我们将添加注释，使用数组索引作为参考（并记住 PDF 的坐标系从左下角开始）：

    # add annotation
    pixel_size = 2
    for i in range(0, len(m)):
        for j in range(0, len(m[i])):
            if m[i][j] == 0:
                continue
            x = pixel_size * j
            y = pixel_size * (len(m) - i)
            doc.get_page(0).append_link_annotation(
                page=Decimal(0),
                color=c[m[i][j]],
                location_on_page="Fit",
                rectangle=(
                    Decimal(x),
                    Decimal(y),
                    Decimal(x + pixel_size),
                    Decimal(y + pixel_size),
                ),
            )

然后我们存储输出的PDF：

    # attempt to store PDF
    with open("its-a-me.pdf, "wb") as out_file_handle:
        PDF.dumps(out_file_handle, doc)

这是 Okular 打开 PDF 的截图：