Trabajar con operadores PDF en Java

Introducción a los operadores PDF y su uso

Un operador es una palabra clave PDF que especifica una acción que se debe realizar, como pintar una forma gráfica en la página. Una palabra clave de operador se distingue de un objeto con nombre por la ausencia de un carácter de barra inicial (2Fh). Los operadores solo tienen sentido dentro del flujo de contenido.

Un flujo de contenido es un objeto de flujo PDF cuyos datos consisten en instrucciones que describen los elementos gráficos que se deben pintar en una página. Se pueden encontrar más detalles sobre los operadores PDF en el Especificación PDF.

Utilice esta página cuando necesite un control directo sobre una secuencia de contenido PDF en Java, como colocar una imagen con matemáticas de matriz explícitas, reutilizar el mismo gráfico varias veces mediante un XForm o eliminar instrucciones de dibujo de bajo nivel de una página.

Agregar una imagen con operadores PDF

Utilice operadores de bajo nivel cuando la ubicación de la imagen deba controlarse con precisión a nivel de secuencia de contenido en lugar de mediante APIs de diseño de nivel superior.

  1. Abra el PDF de origen con Document y obtenga el objetivo Page.
  2. Agregue el flujo de imagen de entrada a los recursos de la página y conserve el nombre de recurso devuelto.
  3. Cree un Rectangle que define el área objetivo y construya un Matrix desde sus límites.
  4. Utilice GSave para preservar el estado gráfico actual, ConcatenateMatrix para posicionar la imagen, Do pintarlo, y GRestore restaurar el estado previo.
  5. Guarde el documento PDF actualizado.
public static void addImageUsingPdfOperators(Path inputFile, Path imageFile, Path outputFile) throws Exception {
    try (Document document = new Document(inputFile.toString());
         InputStream imageStream = Files.newInputStream(imageFile)) {
        Page page = document.getPages().get_Item(1);
        String imageName = page.getResources().getImages().add(imageStream);

        Rectangle rectangle = new Rectangle(100, 100, 200, 200, true);
        Matrix matrix = new Matrix(new double[]{
                rectangle.getURX() - rectangle.getLLX(),
                0,
                0,
                rectangle.getURY() - rectangle.getLLY(),
                rectangle.getLLX(),
                rectangle.getLLY()
        });

        page.getContents().add(new GSave());
        page.getContents().add(new ConcatenateMatrix(matrix));
        page.getContents().add(new Do(imageName));
        page.getContents().add(new GRestore());
        document.save(outputFile.toString());
    }
    System.out.println("Image added with PDF operators to " + outputFile);
}

Dibujar contenido XForm reutilizable en una página

Utilice este enfoque cuando la misma imagen o gráfico deba renderizarse más de una vez sin duplicar el recurso en el archivo PDF.

  1. Abra el PDF de origen con Document, obtener el objetivo Page, y acceda a su OperatorCollection.
  2. Envuelva el contenido de la página existente con GSave y GRestore para que las transformaciones posteriores no se filtren en el flujo de contenido original.
  3. Cree un XForm recurso, agrega la imagen a los recursos del formulario, y utilice ConcatenateMatrix más Do para dibujar la imagen dentro del formulario.
  4. Coloque el mismo formulario en varias coordenadas de página añadiendo una matriz de traslación y ejecutando el nombre del formulario con el Do operador.
  5. Restablezca el estado gráfico y guarde el PDF de salida.
public static void drawXFormOnPage(Path inputFile, Path imageFile, Path outputFile) throws Exception {
    try (Document document = new Document(inputFile.toString());
         InputStream imageStream = Files.newInputStream(imageFile)) {
        Page page = document.getPages().get_Item(1);
        OperatorCollection pageContents = page.getContents();

        pageContents.insert(1, new GSave());
        pageContents.add(new GRestore());
        pageContents.add(new GSave());

        XForm form = XForm.createNewForm(page, document);
        page.getResources().getForms().add(form);

        form.getContents().add(new GSave());
        form.getContents().add(new ConcatenateMatrix(200, 0, 0, 200, 0, 0));
        String imageName = form.getResources().getImages().add(imageStream);
        form.getContents().add(new Do(imageName));
        form.getContents().add(new GRestore());

        addFormAt(pageContents, form.getName(), 100, 500);
        addFormAt(pageContents, form.getName(), 100, 300);

        pageContents.add(new GRestore());
        document.save(outputFile.toString());
    }
    System.out.println("XForm drawn on page in " + outputFile);
}

private static void addFormAt(OperatorCollection pageContents, String formName, double x, double y) {
    pageContents.add(new GSave());
    pageContents.add(new ConcatenateMatrix(1, 0, 0, 1, x, y));
    pageContents.add(new Do(formName));
    pageContents.add(new GRestore());
}

Eliminar operadores gráficos de una página

Use este ejemplo cuando una página contenga operadores de dibujo vectorial que deben eliminarse directamente del flujo de contenido.

  1. Abra el PDF de origen con Document y obtenga el objetivo Page.
  2. Itere a través de los operadores de contenido de la página y recopile instancias de Stroke, ClosePathStroke, y Fill.
  3. Elimine los operadores recopilados del contenido de la página y guarde el PDF actualizado.

Esta técnica elimina solo las instrucciones de dibujo objetivo. Si la página también contiene etiquetas de texto relacionadas u otros operadores no gráficos, esos elementos permanecen en el flujo de contenido y pueden requerir una pasada de limpieza separada.

public static void removeGraphicsObjects(Path inputFile, Path outputFile) {
    try (Document document = new Document(inputFile.toString())) {
        Page page = document.getPages().get_Item(1);
        List<Operator> operatorsToRemove = new ArrayList<>();
        for (Object item : page.getContents()) {
            Operator operator = (Operator) item;
            if (operator instanceof Stroke || operator instanceof ClosePathStroke || operator instanceof Fill) {
                operatorsToRemove.add(operator);
            }
        }
        page.getContents().delete(operatorsToRemove);
        document.save(outputFile.toString());
    }
    System.out.println("Graphics operators removed in " + outputFile);
}

Temas relacionados

Trabajar con gráficos PDF en Java Anotaciones PDF en Java