Documentation – Trabalhar com gráficos PDF em Java

Java: Adicionar formas de arco ao PDF em Java

Tue, 06 Oct 2026 00:00:00 +0000

Aspose.PDF for Java usa Graph juntamente com objetos de forma como Arc e Line para renderizar gráficos vetoriais.

Adicionar contornos de arco

Crie um novo documento PDF Document.
Adicione um Page ao documento.
Crie um Graph contêiner e adicione-o à página.
Crie o Arc forma e configure sua geometria.
Adicione o Arc para o Graph contêiner.
Defina as propriedades da forma exigidas pelo exemplo, incluindo Color.
Salve o PDF de saída 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());
    }
}

O exemplo completo adiciona três arcos com diferentes raios, ângulos e cores ao mesmo gráfico.

Adicionar um segmento de arco preenchido

Crie um novo documento PDF Document.
Adicione um Page ao documento.
Crie um Graph contêiner e adicione-o à página.
Crie o Line forma e configure suas coordenadas.
Crie o Arc forma e configure sua geometria.
Adicione o Line e Arc para o Graph contêiner.
Salve o PDF de saída 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: Adicionar formas de círculo ao PDF em Java

Tue, 06 Oct 2026 00:00:00 +0000

Adicionar um contorno de círculo

Crie um novo documento PDF Document.
Adicione um Page ao documento.
Crie um Graph contêiner e adicione-o à página.
Crie o Circle forma e configure sua geometria.
Adicione o Circle para o Graph contêiner.
Defina as propriedades de forma exigidas pelo exemplo, incluindo Color.
Salve o PDF de saída 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());
    }
}

Adicionar um círculo preenchido com texto

Crie um novo documento PDF Document.
Adicione um Page ao documento.
Crie um Graph contêiner e adicione-o à página.
Crie o Circle forma e configure sua geometria.
Adicione o Circle para o Graph contêiner.
Defina as propriedades de forma exigidas pelo exemplo, incluindo Color e TextFragment.
Salve o PDF de saída 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: Adicionar formas de curva ao PDF em Java

Tue, 06 Oct 2026 00:00:00 +0000

Curvas em Aspose.PDF for Java são definidas por um array de coordenadas float passado para Curve.

Adicionar um contorno de curva

Crie um novo documento PDF Document.
Adicione um Page ao documento.
Crie um Graph container e adicione-o à página.
Crie o Curve forma e configure seus pontos de controle.
Adicione o Curve para o Graph contêiner.
Defina as propriedades de forma exigidas pelo exemplo, incluindo Color.
Salve o PDF de saída 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: Adicionar formas de linha ao PDF em Java

Tue, 06 Oct 2026 00:00:00 +0000

Adicionar uma linha tracejada

Crie um novo documento PDF Document.
Adicione um Page ao documento.
Crie um Graph contêiner e adicione-o à página.
Crie o Line forma e configure suas coordenadas.
Adicione o Line para o Graph contêiner.
Salve o PDF de saída 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());
    }
}

Adicionar uma linha pontilhada ou tracejada colorida

addDottedDashedLine usa as mesmas coordenadas e configurações de traço, mas também aplica Color.getRed().

Desenhar linhas na página

Crie um novo documento PDF Document.
Adicione um Page ao documento.
Crie um Graph contêiner e adicione-o à página.
Crie o Line forma e configure suas coordenadas.
Adicione o Line para o Graph contêiner.
Salve o PDF de saída 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: Adicionar formas de retângulo ao PDF em Java

Tue, 06 Oct 2026 00:00:00 +0000

Adicionar um contorno de retângulo

Crie um novo documento PDF Document.
Adicione um Page ao documento.
Crie um Graph contêiner e adicione-o à página.
Crie o Rectangle forma e configure sua geometria.
Adicione o Rectangle para o Graph contêiner.
Salve o PDF de saída 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());
    }
}

Preencher um retângulo com cor sólida ou degradê

Os exemplos de retângulo incluem:

createRectangleFilled para um preenchimento sólido com Color.getRed()
addDrawingWithGradientFill para um GradientAxialShading preencher

Usar transparência alfa

createRectangleWithAlphaColorChannel aplica cores translúcidas com Color.fromArgb(...) para que os retângulos sobrepostos permaneçam visíveis.

Controlar a ordem z dos retângulos

Crie um novo documento PDF Document.
Adicione um Page ao documento.
Defina o necessário Page tamanho.
Adicione o configurado Rectangle formas na página de destino com a ordem z necessária.
Salve o PDF de saída 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: Adicionar formas de elipse ao PDF em Java

Tue, 06 Oct 2026 00:00:00 +0000

Adicionar contornos de elipse

Crie um novo documento PDF Document.
Adicione um Page ao documento.
Crie um Graph contêiner e adicione-o à página.
Crie o Ellipse forma e configure sua geometria.
Adicione o Ellipse para o Graph contêiner.
Defina as propriedades da forma exigidas pelo exemplo, incluindo Color e TextFragment.
Salve o PDF de saída 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());
    }
}

O exemplo completo adiciona duas elipses de contorno diferentes ao mesmo gráfico.

Adicionar elipses preenchidas

createEllipseFilled preenche duas reticências com Color.getGreenYellow() e Color.getDarkRed().

Adicionar texto dentro das elipses

Crie um novo documento PDF Document.
Adicione um Page ao documento.
Crie um TextFragment e defina as opções de formatação de texto necessárias.
Crie um Graph contêiner e adicione-o à página.
Crie o Ellipse forma e configure sua geometria.
Adicione o Ellipse para o Graph contêiner.
Salve o PDF de saída 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: Verificar limites de formas em gráficos PDF com Java

Tue, 06 Oct 2026 00:00:00 +0000

Use BoundsCheckMode quando precisar garantir que as formas cabem dentro de um contêiner de gráfico.

Validar limites da forma do gráfico

Crie um novo documento PDF Document.
Adicione um Page ao documento.
Crie um Graph contêiner e adicione-o à página.
Crie o Rectangle forma e configure sua geometria.
Habilite a verificação estrita de limites e tente adicionar a forma à coleção de gráficos com BoundsCheckMode.
Trate a exceção se a forma não couber.
Salve o PDF de saída 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());
    }
}