Documentation – العمل مع رسومات PDF في Java

Java: إضافة أشكال القوس إلى PDF في Java

Mon, 05 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: إضافة أشكال دائرة إلى PDF في Java

Mon, 05 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: إضافة أشكال المنحنيات إلى PDF في Java

Mon, 05 Oct 2026 00:00:00 +0000

يتم تعريف المنحنيات في Aspose.PDF for Java بواسطة مصفوفة إحداثيات عائمة تُمرّر إلى 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: إضافة أشكال الخط إلى PDF في Java

Mon, 05 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: إضافة أشكال المستطيلات إلى PDF في Java

Mon, 05 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 ملء

استخدام الشفافية ألفا

createRectangleWithAlphaColorChannel يطبق ألوان شفافة مع Color.fromArgb(...) حتى تظل المستطيلات المتداخلة مرئية.

التحكم بترتيب Z للمستطيلات

أنشئ 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: إضافة أشكال إهليلجية إلى PDF في Java

Mon, 05 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: تحقق من حدود الشكل في الرسوم البيانية PDF باستخدام Java

Mon, 05 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());
    }
}