Documentation – Trabajar con gráficos PDF en Java

Java: Agregar formas de arco a PDF en Java

Tue, 29 Sep 2026 00:00:00 +0000

Aspose.PDF for Java utiliza Graph junto con objetos de forma como Arc y Line para renderizar gráficos vectoriales.

Agregar contornos de arco

Cree un nuevo PDF Document.
Agregue un Page al documento.
Cree un Graph contenedor y añádalo a la página.
Cree el Arc forma y configure su geometría.
Agregue el Arc al Graph contenedor.
Establezca las propiedades de forma requeridas por el ejemplo, incluyendo Color.
Guarde el PDF de salida Document.

public static void addArc(Path outputFile) {
    try (Document document = new Document()) {
        Page page = document.getPages().add();
        Graph graph = new Graph(400.0, 400.0);
        graph.setBorder(new BorderInfo(BorderSide.All, Color.getGreen()));

        Arc arc1 = new Arc(100, 100, 95, 0, 90);
        arc1.getGraphInfo().setColor(Color.getGreenYellow());
        graph.getShapes().addItem(arc1);

        page.getParagraphs().add(graph);
        document.save(outputFile.toString());
    }
}

El ejemplo completo agrega tres arcos con diferentes radios, ángulos y colores al mismo gráfico.

Agregar un segmento de arco relleno

Cree un nuevo PDF Document.
Agregue un Page al documento.
Cree un Graph contenedor y añádalo a la página.
Cree el Line forma y configure sus coordenadas.
Cree el Arc forma y configure su geometría.
Agregue el Line y Arc al Graph contenedor.
Guarde el PDF de salida Document.

public static void addArcFilled(Path outputFile) {
    try (Document document = new Document()) {
        Page page = document.getPages().add();
        Graph graph = new Graph(400.0, 400.0);
        graph.setBorder(new BorderInfo(BorderSide.All, Color.getGreen()));

        Arc arc = new Arc(100, 100, 95, 0, 90);
        arc.getGraphInfo().setFillColor(Color.getGreenYellow());
        graph.getShapes().addItem(arc);

        Line line = new Line(new float[]{195, 100, 100, 100, 100, 195});
        line.getGraphInfo().setFillColor(Color.getGreenYellow());
        graph.getShapes().addItem(line);

        page.getParagraphs().add(graph);
        document.save(outputFile.toString());
    }
}

Java: Agregar formas de círculo a PDF en Java

Tue, 29 Sep 2026 00:00:00 +0000

Agregar un contorno de círculo

Cree un nuevo PDF Document.
Agregue un Page al documento.
Cree un Graph contenedor y añádalo a la página.
Cree el Circle forma y configure su geometría.
Añada el Circle al Graph contenedor.
Establezca las propiedades de forma requeridas por el ejemplo, incluyendo Color.
Guarde el PDF de salida Document.

public static void addCircle(Path outputFile) {
    try (Document document = new Document()) {
        Page page = document.getPages().add();
        Graph graph = new Graph(400.0, 200.0);
        graph.setBorder(new BorderInfo(BorderSide.All, Color.getGreen()));

        Circle circle = new Circle(100, 100, 40);
        circle.getGraphInfo().setColor(Color.getGreenYellow());
        graph.getShapes().addItem(circle);

        page.getParagraphs().add(graph);
        document.save(outputFile.toString());
    }
}

Agregar un círculo relleno con texto

Cree un nuevo PDF Document.
Agregue un Page al documento.
Cree un Graph contenedor y añádalo a la página.
Cree el Circle forma y configure su geometría.
Añada el Circle al Graph contenedor.
Establezca las propiedades de forma requeridas por el ejemplo, incluyendo Color y TextFragment.
Guarde el PDF de salida Document.

public static void addCircleFilled(Path outputFile) {
    try (Document document = new Document()) {
        Page page = document.getPages().add();
        Graph graph = new Graph(400.0, 200.0);
        graph.setBorder(new BorderInfo(BorderSide.All, Color.getGreen()));

        Circle circle = new Circle(100, 100, 40);
        circle.getGraphInfo().setColor(Color.getGreenYellow());
        circle.getGraphInfo().setFillColor(Color.getGreen());
        circle.setText(new TextFragment("Circle"));
        graph.getShapes().addItem(circle);

        page.getParagraphs().add(graph);
        document.save(outputFile.toString());
    }
}

Java: Agregar formas de curva a PDF en Java

Tue, 29 Sep 2026 00:00:00 +0000

Las curvas en Aspose.PDF for Java se definen mediante una matriz de coordenadas float que se pasa a Curve.

Agregar un contorno de curva

Cree un nuevo PDF Document.
Agregue un Page al documento.
Cree un Graph contenedor y añádalo a la página.
Cree el Curve forma y configure sus puntos de control.
Agregue el Curve al Graph contenedor.
Establezca las propiedades de forma requeridas por el ejemplo, incluyendo Color.
Guarde el PDF de salida Document.

public static void addCurve(Path outputFile) {
    try (Document document = new Document()) {
        Page page = document.getPages().add();
        Graph graph = new Graph(400.0, 200.0);
        graph.setBorder(new BorderInfo(BorderSide.All, Color.getGreen()));

        Curve curve1 = new Curve(new float[]{10, 10, 50, 60, 70, 10, 100, 120});
        curve1.getGraphInfo().setColor(Color.getGreenYellow());
        graph.getShapes().addItem(curve1);

        page.getParagraphs().add(graph);
        document.save(outputFile.toString());
    }
}

Java: Agregar formas de línea a PDF en Java

Tue, 29 Sep 2026 00:00:00 +0000

Agregar una línea discontinua

Cree un nuevo PDF Document.
Agregue un Page al documento.
Cree un Graph contenedor y añádalo a la página.
Cree el Line forma y configure sus coordenadas.
Añada el Line al Graph contenedor.
Guarde el PDF de salida Document.

public static void addLine(Path outputFile) {
    try (Document document = new Document()) {
        Page page = document.getPages().add();
        Graph graph = new Graph(100.0, 400.0);
        page.getParagraphs().add(graph);

        Line line = new Line(new float[]{100, 100, 200, 100});
        line.getGraphInfo().setDashArray(new int[]{0, 1, 0});
        line.getGraphInfo().setDashPhase(1);
        graph.getShapes().addItem(line);

        document.save(outputFile.toString());
    }
}

Agregar una línea punteada o discontinua de color

addDottedDashedLine utiliza las mismas coordenadas y configuraciones de guiones, pero también aplica Color.getRed().

Dibujar líneas a través de la página

Cree un nuevo PDF Document.
Agregue un Page al documento.
Cree un Graph contenedor y añádalo a la página.
Cree el Line forma y configure sus coordenadas.
Añada el Line al Graph contenedor.
Guarde el PDF de salida Document.

public static void drawLineAcrossPage(Path outputFile) {
    try (Document document = new Document()) {
        Page page = document.getPages().add();
        page.getPageInfo().getMargin().setLeft(0);
        page.getPageInfo().getMargin().setRight(0);
        page.getPageInfo().getMargin().setBottom(0);
        page.getPageInfo().getMargin().setTop(0);

        Graph graph = new Graph(page.getPageInfo().getWidth(), page.getPageInfo().getHeight());
        Line line = new Line(new float[]{
                (float) page.getRect().getLLX(),
                0,
                (float) page.getPageInfo().getWidth(),
                (float) page.getRect().getURY()
        });
        graph.getShapes().addItem(line);
        page.getParagraphs().add(graph);

        document.save(outputFile.toString());
    }
}

Java: Agregar formas de rectángulo a PDF en Java

Tue, 29 Sep 2026 00:00:00 +0000

Agregar un contorno de rectángulo

Cree un nuevo PDF Document.
Agregue un Page al documento.
Cree un Graph contenedor y añádalo a la página.
Cree el Rectangle forma y configure su geometría.
Añada el Rectangle al Graph contenedor.
Guarde el PDF de salida Document.

public static void addRectangle(Path outputFile) {
    try (Document document = new Document()) {
        Page page = document.getPages().add();
        Graph graph = new Graph(400.0, 300.0);
        page.getParagraphs().add(graph);
        graph.setBorder(new BorderInfo(BorderSide.All, Color.getRed()));

        Rectangle rectangle = new Rectangle(20, 20, 350, 250);
        graph.getShapes().addItem(rectangle);

        document.save(outputFile.toString());
    }
}

Rellenar un rectángulo con color sólido o degradado

Los ejemplos de rectángulos incluyen:

createRectangleFilled para un relleno sólido con Color.getRed()
addDrawingWithGradientFill para un GradientAxialShading llenar

Utilizar transparencia alfa

createRectangleWithAlphaColorChannel aplica colores translúcidos con Color.fromArgb(...) para que los rectángulos superpuestos permanezcan visibles.

Controlar el orden z de los rectángulos

Cree un nuevo PDF Document.
Agregue un Page al documento.
Establezca lo requerido Page tamaño.
Agregue lo configurado Rectangle formas a la página de destino con el orden z requerido.
Guarde el PDF de salida Document.

public static void controlZOrderOfRectangle(Path outputFile) {
    try (Document document = new Document()) {
        Page page = document.getPages().add();
        page.setPageSize(375, 300);
        page.getPageInfo().getMargin().setLeft(0);
        page.getPageInfo().getMargin().setTop(0);

        addRectangleToPage(page, 50, 40, 60, 40, Color.getRed(), 2);
        addRectangleToPage(page, 20, 20, 30, 30, Color.getBlue(), 1);
        addRectangleToPage(page, 40, 40, 60, 30, Color.getGreen(), 0);

        document.save(outputFile.toString());
    }
}

Java: Agregar formas de elipse a PDF en Java

Tue, 29 Sep 2026 00:00:00 +0000

Agregar contornos de elipse

Cree un nuevo PDF Document.
Agregue un Page al documento.
Cree un Graph contenedor y añádalo a la página.
Cree el Ellipse forma y configure su geometría.
Añada el Ellipse al Graph contenedor.
Establezca las propiedades de forma requeridas por el ejemplo, incluyendo Color y TextFragment.
Guarde el PDF de salida Document.

public static void addEllipse(Path outputFile) {
    try (Document document = new Document()) {
        Page page = document.getPages().add();
        Graph graph = new Graph(400.0, 400.0);
        graph.setBorder(new BorderInfo(BorderSide.All, Color.getGreen()));

        Ellipse ellipse1 = new Ellipse(150, 100, 120, 60);
        ellipse1.getGraphInfo().setColor(Color.getGreenYellow());
        ellipse1.setText(new TextFragment("Ellipse"));
        graph.getShapes().addItem(ellipse1);

        page.getParagraphs().add(graph);
        document.save(outputFile.toString());
    }
}

El ejemplo completo agrega dos elipses de contorno diferentes al mismo gráfico.

Agregar elipses rellenas

createEllipseFilled rellena dos elipsis con Color.getGreenYellow() y Color.getDarkRed().

Agregar texto dentro de las elipses

Cree un nuevo PDF Document.
Agregue un Page al documento.
Cree un TextFragment y establezca las opciones de formato de texto requeridas.
Cree un Graph contenedor y añádalo a la página.
Cree el Ellipse forma y configure su geometría.
Añada el Ellipse al Graph contenedor.
Guarde el PDF de salida Document.

public static void addTextInsideEllipse(Path outputFile) {
    try (Document document = new Document()) {
        Page page = document.getPages().add();
        Graph graph = new Graph(400.0, 400.0);
        graph.setBorder(new BorderInfo(BorderSide.All, Color.getGreen()));

        TextFragment textFragment = new TextFragment("Ellipse");
        textFragment.getTextState().setFont(FontRepository.findFont("Helvetica"));
        textFragment.getTextState().setFontSize(24);

        Ellipse ellipse1 = new Ellipse(100, 100, 120, 180);
        ellipse1.getGraphInfo().setFillColor(Color.getGreenYellow());
        ellipse1.setText(textFragment);
        graph.getShapes().addItem(ellipse1);

        page.getParagraphs().add(graph);
        document.save(outputFile.toString());
    }
}

Java: Comprobar los límites de forma en gráficos PDF con Java

Tue, 29 Sep 2026 00:00:00 +0000

Utilice BoundsCheckMode cuando necesita asegurarse de que las formas encajen dentro de un contenedor de gráfico.

Validar los límites de la forma del gráfico

Cree un nuevo PDF Document.
Agregue un Page al documento.
Cree un Graph contenedor y añádalo a la página.
Cree el Rectangle forma y configure su geometría.
Habilite la comprobación estricta de límites y intente agregar la forma a la colección de gráficos con BoundsCheckMode.
Maneje la excepción si la forma no encaja.
Guarde el PDF de salida Document.

public static void checkShapeBounds(Path outputFile) {
    try (Document document = new Document()) {
        Page page = document.getPages().add();
        Graph graph = new Graph(100.0, 100.0);
        graph.setTop(10);
        graph.setLeft(15);
        graph.setBorder(new BorderInfo(BorderSide.Box, 1, Color.getBlack()));
        page.getParagraphs().add(graph);

        Rectangle rectangle = new Rectangle(-1, 0, 50, 50);
        rectangle.getGraphInfo().setFillColor(Color.getTomato());
        try {
            graph.getShapes().updateBoundsCheckMode(BoundsCheckMode.ThrowExceptionIfDoesNotFit);
            graph.getShapes().addItem(rectangle);
        } catch (Exception ex) {
            System.out.println(ex.getMessage());
        }

        document.save(outputFile.toString());
    }
}