使用 iText 为标记的 pdf (PDF/UA) 中的图像添加替代文本

Question

我在http://developers.itextpdf.com/examples 下查找了一些文档和示例。

我知道 iText 能够从头开始生成带标签的 pdf，但是是否可以在现有的 带标签 pdf 中插入替代文本到图像（不更改任何其他内容）？我需要在不使用 GUI 应用程序（例如 Adob​​e Acrobat Pro）的程序中实现此功能。谢谢。

Answer 1

请查看AddAltTags 示例。

在此示例中，我们获取一个 PDF，其中包含缺少 Alt 键的狐狸和狗的图像：no_alt_attribute.pdf

代码无法识别狐狸或狗，因此我们创建了一个带有 Alt 属性的新文档，上面写着“没有 Alt 描述的图”：added_alt_attributes.pdf)

我们通过遍历结构树来添加这个描述，寻找标记为/Figure元素的结构元素：

public void manipulatePdf(String src, String dest)
    throws IOException, DocumentException {
    PdfReader reader = new PdfReader(src);
    PdfDictionary catalog = reader.getCatalog();
    PdfDictionary structTreeRoot =
        catalog.getAsDict(PdfName.STRUCTTREEROOT);
    manipulate(structTreeRoot);
    PdfStamper stamper = new PdfStamper(
        reader, new FileOutputStream(dest));
    stamper.close();
}

public void manipulate(PdfDictionary element) {
    if (element == null)
        return;
    if (PdfName.FIGURE.equals(element.get(PdfName.S))) {
        element.put(PdfName.ALT,
            new PdfString("Figure without an Alt description"));
    }
    PdfArray kids = element.getAsArray(PdfName.K);
    if (kids == null) return;
    for (int i = 0; i < kids.size(); i++)
        manipulate(kids.getAsDict(i));
}

您可以轻松地将这个 Java 示例移植到 C#：

• 从PdfReader 对象中获取根字典，
• 获取结构树的根（字典），
• 循环遍历该树每个分支的所有孩子，
• 如果潜在客户是人物，请添加 /Alt 条目。

完成后，使用PdfStamper 保存更改后的文件。