pdfbox - 尽管移除了 PDAnnotation，但文本显示为蓝色

Question

我们有一个要求，我们需要在某些匹配的条件检查中删除注释。当我执行 allPageAnnotationsList.remove(annotationTobeRemoved) 时，PDAnnotion 被删除陈述。
但相应的文本仅以蓝色显示。如何将文本颜色更新为正常(黑色)？

Answer 1

最初我以为您要求将页面上的所有非黑色文本更改为黑色。这导致了我的原始答案，现在是第一部分“将所有文本更新为黑色”。然后您澄清说，您只希望将已删除注释区域中的文本设为黑色。这显示在第二部分“将区域中的文本更新为黑色”中。
将所有文本更新为黑色
首先，正如 Tilman 在评论中已经描述的那样，删除链接注释通常只会删除该链接的交互性，但链接注释区域中的文本保持原样。因此，如果要将文本颜色更新为正常(黑色)，则必须添加第二步并操作静态页面内容中的颜色。
静态页面内容由改变图形状态或绘制某些内容的指令流定义。用于绘制的颜色是图形状态的一部分，由显式颜色设置指令设置。因此，人们可能会认为您可以简单地通过选择正常(黑色)的说明替换所有颜色设置说明。
不幸的是，这并不容易，因为颜色也可能会改变以绘制其他东西。例如。在您的文档开始时，整个页面都填充为白色；如果您在填充指令之前替换颜色设置指令，您的整个页面将是黑色的。不完全是你想要的。
要将文本颜色更新为正常(黑色)但不更改其他颜色，因此，您必须考虑要更改的指令的上下文。
PDFBox 解析框架可以帮助您在这里迭代内容流并跟踪图形状态。
此外，基于该框架，在 this answer 中创建了一个通用的内容流编辑器助手类。 , PdfContentStreamEditor . (有关详细信息和示例用途，请参阅该答案。)现在您只需为您的用例自定义它，例如像这样:

PDDocument document = ...;
for (PDPage page : document.getDocumentCatalog().getPages()) {
    PdfContentStreamEditor editor = new PdfContentStreamEditor(document, page) {
        @Override
        protected void write(ContentStreamWriter contentStreamWriter, Operator operator, List<COSBase> operands) throws IOException {
            String operatorString = operator.getName();

            if (TEXT_SHOWING_OPERATORS.contains(operatorString)) {
                if (currentlyReplacedColor == null)
                {
                    PDColor currentFillColor = getGraphicsState().getNonStrokingColor();
                    if (!isBlack(currentFillColor))
                    {
                        currentlyReplacedColor = currentFillColor;
                        super.write(contentStreamWriter, SET_NON_STROKING_GRAY, GRAY_BLACK_VALUES);
                    }
                }
            } else if (currentlyReplacedColor != null) {
                PDColorSpace replacedColorSpace = currentlyReplacedColor.getColorSpace();
                List<COSBase> replacedColorValues = new ArrayList<>();
                for (float f : currentlyReplacedColor.getComponents())
                    replacedColorValues.add(new COSFloat(f));
                if (replacedColorSpace instanceof PDDeviceCMYK)
                    super.write(contentStreamWriter, SET_NON_STROKING_CMYK, replacedColorValues);
                else if (replacedColorSpace instanceof PDDeviceGray)
                    super.write(contentStreamWriter, SET_NON_STROKING_GRAY, replacedColorValues);
                else if (replacedColorSpace instanceof PDDeviceRGB)
                    super.write(contentStreamWriter, SET_NON_STROKING_RGB, replacedColorValues);
                else {
                    //TODO
                }
                currentlyReplacedColor = null;
            }

            super.write(contentStreamWriter, operator, operands);
        }

        PDColor currentlyReplacedColor = null;

        final List<String> TEXT_SHOWING_OPERATORS = Arrays.asList("Tj", "'", "\"", "TJ");
        final Operator SET_NON_STROKING_CMYK = Operator.getOperator("k");
        final Operator SET_NON_STROKING_RGB = Operator.getOperator("rg");
        final Operator SET_NON_STROKING_GRAY = Operator.getOperator("g");
        final List<COSBase> GRAY_BLACK_VALUES = Arrays.asList(COSInteger.ZERO);
    };
    editor.processPage(page);
}
document.save("withBlackText.pdf");

( ChangeTextColor 测试 testMakeTextBlackTestAfterRemovingAnnotation )
这里我们检查当前指令是否为文本绘制指令。如果是，并且当前颜色还没有被替换，我们检查当前颜色是否已经是黑色的。如果它不是黑色，我们将它存储起来并添加一条指令，用黑色替换当前的填充颜色。
否则，即如果当前指令不是文本绘制指令，我们检查当前颜色是否已被黑色替换。如果有，我们恢复原来的颜色。
要检查给定颜色是否为黑色，我们使用以下辅助方法。

static boolean isBlack(PDColor pdColor) {
    PDColorSpace pdColorSpace = pdColor.getColorSpace();
    float[] components = pdColor.getComponents();
    if (pdColorSpace instanceof PDDeviceCMYK)
        return (components[0] > .9f && components[1] > .9f && components[2] > .9f) || components[3] > .9f;
    else if (pdColorSpace instanceof PDDeviceGray)
        return components[0] < .1f;
    else if (pdColorSpace instanceof PDDeviceRGB)
        return components[0] < .1f && components[1] < .1f && components[2] < .1f;
    else
        return false;
}

( ChangeTextColor 辅助方法)
将区域中的文本更新为黑色
在评论中，您澄清说您只希望已删除注释区域中的文本变为黑色。
为此，您必须收集您删除的注释的矩形，然后在切换颜色之前检查位置是否在这些矩形之一内。
这可以通过扩展上面的代码来完成，如下所示。在这里，我仅删除所有其他注释并收集它们的矩形以供稍后检查。我也覆盖了 PDFStreamEngine方法 showText(byte[])存储当前文本绘制指令中显示的文本位置。

PDDocument document = ...;
for (PDPage page : document.getDocumentCatalog().getPages()) {
    List<PDRectangle> areas = new ArrayList<>();
    // Remove every other annotation, collect their areas
    List<PDAnnotation> annotations = new ArrayList<>();
    boolean remove = true;
    for (PDAnnotation annotation : page.getAnnotations()) {
        if (remove)
            areas.add(annotation.getRectangle());
        else
            annotations.add(annotation);
        remove = !remove;
    }
    page.setAnnotations(annotations);

    PdfContentStreamEditor editor = new PdfContentStreamEditor(document, page) {
        @Override
        protected void write(ContentStreamWriter contentStreamWriter, Operator operator, List<COSBase> operands) throws IOException {
            String operatorString = operator.getName();

            if (TEXT_SHOWING_OPERATORS.contains(operatorString) && isInAreas()) {
                if (currentlyReplacedColor == null)
                {
                    PDColor currentFillColor = getGraphicsState().getNonStrokingColor();
                    if (!isBlack(currentFillColor))
                    {
                        currentlyReplacedColor = currentFillColor;
                        super.write(contentStreamWriter, SET_NON_STROKING_GRAY, GRAY_BLACK_VALUES);
                    }
                }
            } else if (currentlyReplacedColor != null) {
                PDColorSpace replacedColorSpace = currentlyReplacedColor.getColorSpace();
                List<COSBase> replacedColorValues = new ArrayList<>();
                for (float f : currentlyReplacedColor.getComponents())
                    replacedColorValues.add(new COSFloat(f));
                if (replacedColorSpace instanceof PDDeviceCMYK)
                    super.write(contentStreamWriter, SET_NON_STROKING_CMYK, replacedColorValues);
                else if (replacedColorSpace instanceof PDDeviceGray)
                    super.write(contentStreamWriter, SET_NON_STROKING_GRAY, replacedColorValues);
                else if (replacedColorSpace instanceof PDDeviceRGB)
                    super.write(contentStreamWriter, SET_NON_STROKING_RGB, replacedColorValues);
                else {
                    //TODO
                }
                currentlyReplacedColor = null;
            }

            super.write(contentStreamWriter, operator, operands);

            before = null;
            after = null;
        }

        PDColor currentlyReplacedColor = null;

        final List<String> TEXT_SHOWING_OPERATORS = Arrays.asList("Tj", "'", "\"", "TJ");
        final Operator SET_NON_STROKING_CMYK = Operator.getOperator("k");
        final Operator SET_NON_STROKING_RGB = Operator.getOperator("rg");
        final Operator SET_NON_STROKING_GRAY = Operator.getOperator("g");
        final List<COSBase> GRAY_BLACK_VALUES = Arrays.asList(COSInteger.ZERO);

        @Override
        protected void showText(byte[] string) throws IOException {
            Matrix ctm = getGraphicsState().getCurrentTransformationMatrix();
            if (before == null)
                before = getTextMatrix().multiply(ctm);
            super.showText(string);
            after = getTextMatrix().multiply(ctm);
        }

        Matrix before = null;
        Matrix after = null;

        boolean isInAreas() {
            return isInAreas(before) || isInAreas(after);
        }
        boolean isInAreas(Matrix m) {
            return m != null && areas.stream().anyMatch(rect -> rect.contains(m.getTranslateX(), m.getTranslateY()));
        }
    };
    editor.processPage(page);
}
document.save("WithoutSomeAnnotation-withBlackTextThere.pdf");