如何通过Apache PDFBox为PDF元素添加混合模式及设置PDExtendedGraphicsState

要在PdfContentStreamEditor中应用你配置好的PDExtendedGraphicsState，核心是通过PDF的图形状态操作符将其注入到内容流中，具体实现步骤如下：

• 自定义PdfContentStreamEditor子类
  重写processOperator方法，在需要应用混合模式的内容前后插入图形状态的保存、设置与恢复逻辑——通常可以选择在页面内容开始前全局设置，或者针对特定图形元素（如路径、图像、文本）单独处理。

• 处理图形状态操作
  PDF通过q操作符保存当前图形状态，gs操作符应用扩展图形状态，Q操作符恢复之前的状态。你需要先将自定义的PDExtendedGraphicsState添加到页面的资源字典中，再通过gs操作符引用它。

下面是完整的可运行代码示例：

import org.apache.pdfbox.contentstream.operator.Operator;
import org.apache.pdfbox.cos.COSName;
import org.apache.pdfbox.pdmodel.PDDocument;
import org.apache.pdfbox.pdmodel.PDPage;
import org.apache.pdfbox.pdmodel.PDResources;
import org.apache.pdfbox.pdmodel.graphics.blend.BlendMode;
import org.apache.pdfbox.pdmodel.graphics.state.PDExtendedGraphicsState;

import java.io.IOException;
import java.util.List;

public class BlendModeEditor extends PdfContentStreamEditor {
    private final PDExtendedGraphicsState customGState;
    private final COSName gStateName;

    public BlendModeEditor(PDDocument document, PDPage page) {
        super(document, page);
        // 初始化并配置扩展图形状态
        customGState = new PDExtendedGraphicsState();
        customGState.setBlendMode(BlendMode.MULTIPLY);
        // 将自定义图形状态注册到页面资源字典，获取引用名称
        PDResources resources = page.getResources();
        gStateName = resources.addExtendedGraphicsState(customGState);
    }

    @Override
    protected void processOperator(Operator operator, List<String> operands) throws IOException {
        String operatorName = operator.getName();
        // 针对文本绘制操作，先设置混合模式
        if ("BT".equals(operatorName)) {
            getCanvas().saveGraphicsState();
            getCanvas().setGraphicsStateParameters(gStateName);
        }
        // 针对路径绘制操作，先设置混合模式
        if ("re".equals(operatorName)) {
            getCanvas().saveGraphicsState();
            getCanvas().setGraphicsStateParameters(gStateName);
        }
        
        // 执行原操作逻辑
        super.processOperator(operator, operands);
        
        // 文本绘制结束后恢复原图形状态
        if ("ET".equals(operatorName)) {
            getCanvas().restoreGraphicsState();
        }
        // 路径填充/描边结束后恢复原图形状态
        if ("f".equals(operatorName) || "S".equals(operatorName)) {
            getCanvas().restoreGraphicsState();
        }
    }
}

// 使用示例
public class PdfBlendModeDemo {
    public static void main(String[] args) throws IOException {
        try (PDDocument document = PDDocument.load("input.pdf")) {
            PDPage targetPage = document.getPage(0);
            BlendModeEditor editor = new BlendModeEditor(document, targetPage);
            editor.processPage(targetPage);
            document.save("output_blend_mode.pdf");
        }
    }
}

• 代码关键点说明：
  1. 构造方法中完成PDExtendedGraphicsState的配置与资源注册，确保PDF能识别这个自定义图形状态。
  2. processOperator方法中，通过监听特定操作符（如文本开始BT、矩形绘制re）触发混合模式设置，操作完成后（如文本结束ET、路径填充f）恢复原状态，避免影响页面其他内容。
  3. 你可以根据需求调整监听的操作符，比如针对图像绘制Do操作单独设置混合模式。

内容的提问来源于stack exchange，提问作者Shorty123