Documentation – 在 Java 中使用 PDF 图形

Java: 在 Java 中向 PDF 添加弧形

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

Aspose.PDF for Java 使用 Graph 以及形状对象，例如 Arc 和 Line 渲染矢量图形。

添加弧线轮廓

创建新的 PDF Document。
将一个 Page 添加到文档。
创建一个 Graph 容器并将其添加到页面。
创建 Arc 形状并配置其几何属性。
添加 Arc 到 Graph 容器。
设置示例所需的形状属性，包括 Color。
保存输出 PDF 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());
    }
}

完整示例向同一图形添加了三个具有不同半径、角度和颜色的弧。

添加一个已填充的弧段

创建新的 PDF Document。
将一个 Page 添加到文档。
创建一个 Graph 容器并将其添加到页面。
创建 Line 形状并配置其坐标。
创建 Arc 形状并配置其几何属性。
添加 Line 和 Arc 到 Graph 容器。
保存输出 PDF 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: 在 Java 中向 PDF 添加圆形形状

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

添加圆形轮廓

创建一个新的 PDF Document。
将一个 Page 添加到文档。
创建一个 Graph 容器并将其添加到页面。
创建 Circle 形状并配置其几何属性。
添加 Circle 到 Graph 容器。
设置示例所需的形状属性，包括 Color。
保存输出 PDF 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());
    }
}

添加一个带文本的实心圆

创建一个新的 PDF Document。
将一个 Page 添加到文档。
创建一个 Graph 容器并将其添加到页面。
创建 Circle 形状并配置其几何属性。
添加 Circle 到 Graph 容器。
设置示例所需的形状属性，包括 Color 和 TextFragment。
保存输出 PDF 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: 在 Java 中向 PDF 添加曲线形状

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

在 Aspose.PDF for Java 中，曲线是通过传递给的 float 坐标数组来定义的 Curve。

添加曲线轮廓

创建新 PDF Document。
添加 Page 到文档。
创建一个 Graph 容器并将其添加到页面。
创建 Curve 形状并配置其控制点。
添加 Curve 到 Graph 容器。
设置示例所需的形状属性，包括 Color。
保存输出的 PDF 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: 在 Java 中向 PDF 添加线形状

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

添加虚线

创建一个新的 PDF Document。
将一个 Page 添加到文档。
创建一个 Graph 容器并将其添加到页面。
创建 Line 形状并配置其坐标。
添加 Line 到 Graph 容器。
保存输出的 PDF 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());
    }
}

添加彩色点线或虚线

addDottedDashedLine 使用相同的坐标和虚线设置，但也应用 Color.getRed()。

在页面上绘制线条

创建一个新的 PDF Document。
将一个 Page 添加到文档。
创建一个 Graph 容器并将其添加到页面。
创建 Line 形状并配置其坐标。
添加 Line 到 Graph 容器。
保存输出的 PDF 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: 在 Java 中向 PDF 添加矩形形状

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

添加矩形轮廓

创建一个新的 PDF Document。
将一个 Page 添加到文档。
创建一个 Graph 容器并将其添加到页面。
创建 Rectangle 形状并配置其几何。
添加 Rectangle 到 Graph 容器。
保存输出 PDF 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());
    }
}

使用实心或渐变颜色填充矩形

矩形示例包括:

createRectangleFilled 用于实心填充 Color.getRed()
addDrawingWithGradientFill 对于一个 GradientAxialShading 填充

使用 alpha 透明度

createRectangleWithAlphaColorChannel 应用半透明颜色 Color.fromArgb(...) 因此，重叠的矩形保持可见。

控制矩形的 z-order

创建一个新的 PDF Document。
将一个 Page 添加到文档。
设置所需的 Page 大小。
添加已配置的 Rectangle 形状到目标页面，并使用所需的 z-order。
保存输出 PDF 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: 在 Java 中向 PDF 添加椭圆形状

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

添加椭圆轮廓

创建新的 PDF Document。
将一个 Page 添加到文档。
创建一个 Graph 容器并将其添加到页面。
创建 Ellipse 形状并配置其几何。
添加 Ellipse 到 Graph 容器。
设置示例所需的形状属性，包括 Color 和 TextFragment。
保存输出 PDF 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());
    }
}

完整示例向同一图形添加了两个不同的轮廓椭圆。

添加填充椭圆

createEllipseFilled 用…填充两个省略号 Color.getGreenYellow() 和 Color.getDarkRed()。

在椭圆内部添加文本

创建新的 PDF Document。
将一个 Page 添加到文档。
创建一个 TextFragment 并设置所需的文本格式选项。
创建一个 Graph 容器并将其添加到页面。
创建 Ellipse 形状并配置其几何。
添加 Ellipse 到 Graph 容器。
保存输出 PDF 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: 使用 Java 检查 PDF 图形中的形状边界

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

当需要确保形状适合放入图形容器时，使用 BoundsCheckMode。

验证图形形状边界

创建一个新的 PDF Document。
将一个 Page 添加到文档。
创建一个 Graph 容器并将其添加到页面。
创建 Rectangle 形状并配置其几何属性。
启用严格的边界检查并尝试将形状添加到图形集合中 BoundsCheckMode。
如果形状不适合，请处理异常。
保存输出 PDF 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());
    }
}