Documentation – العمل مع الرسوم البيانية PDF في بايثون

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

Thu, 11 Jun 2026 00:00:00 +0000

إضافة كائن قوس

Aspose.PDF لبيثون عبر .NET يتيح لك إضافة قوس الأشكال إلى صفحات PDF باستخدام رسم بياني فئة. يمكنك رسم الأقواس المحددة ومقاطع القوس المملوءة للمخططات والرسوم التوضيحية الفنية.

اتبع الخطوات أدناه:

ابتكر مستند مثال.
ابتكر كائن الرسم البياني بأبعاد معينة.
مجموعة الحدود لكائن الرسم البياني.
قم بإنشاء كائن قوس مطابق.
أضف هذا الكائن إلى مجموعة الأشكال في كائن الرسم البياني.
أضِف رسم بياني الاعتراض على مجموعة الفقرات من الصفحة.
احفظ ملف PDF الخاص بنا.

يعرض مقتطف الشفرة التالي كيفية إضافة قوس كائن.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_arc(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 400)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    arc1 = drawing.Arc(100, 100, 95, 0, 90)
    arc1.graph_info.color = ap.Color.green_yellow
    graph.shapes.add(arc1)

    arc2 = drawing.Arc(100, 100, 90, 70, 180)
    arc2.graph_info.color = ap.Color.dark_blue
    graph.shapes.add(arc2)

    arc3 = drawing.Arc(100, 100, 85, 120, 210)
    arc3.graph_info.color = ap.Color.red
    graph.shapes.add(arc3)

    page.paragraphs.add(graph)
    document.save(outfile)

إنشاء كائن القوس المملوء

يوضح هذا المثال كيفية إضافة مقطع قوس مليء بالألوان.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_arc_filled(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 400)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    arc = drawing.Arc(100, 100, 95, 0, 90)

    arc.graph_info.fill_color = ap.Color.green_yellow
    graph.shapes.add(arc)

    line = drawing.Line([195, 100, 100, 100, 100, 195])
    line.graph_info.fill_color = ap.Color.green_yellow
    graph.shapes.add(line)

    page.paragraphs.add(graph)
    document.save(outfile)

نتيجة إضافة قوس مملوء:

موضوعات الرسم البياني ذات الصلة

Python-Net: أضف أشكال الدائرة إلى PDF في Python

Thu, 11 Jun 2026 00:00:00 +0000

إضافة كائن الدائرة

Aspose.PDF لبيثون عبر .NET يتيح لك إضافة دائرة الأشكال إلى صفحات PDF من خلال رسم بياني فئة. استخدم الدوائر للرسوم التخطيطية والتعليقات التوضيحية والعناصر المرئية البسيطة.

اتبع الخطوات أدناه:

ابتكر مستند مثال.
ابتكر كائن الرسم البياني بأبعاد معينة.
مجموعة الحدود لكائن الرسم البياني.
أضِف رسم بياني الاعتراض على مجموعة الفقرات من الصفحة.
احفظ ملف PDF الخاص بنا.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_circle(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 200)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    circle = drawing.Circle(100, 100, 40)
    circle.graph_info.color = ap.Color.green_yellow
    graph.shapes.add(circle)

    page.paragraphs.add(graph)
    document.save(outfile)

ستبدو دائرتنا المرسومة كما يلي:

إنشاء كائن الدائرة المملوءة

يوضح هذا المثال كيفية إضافة دائرة وتعبئتها بالألوان.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_circle_filled(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 200)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    circle = drawing.Circle(100, 100, 40)
    circle.graph_info.color = ap.Color.green_yellow
    circle.graph_info.fill_color = ap.Color.green
    circle.text = ap.text.TextFragment("Circle")
    graph.shapes.add(circle)

    page.paragraphs.add(graph)
    document.save(outfile)

نتيجة إضافة دائرة مملوءة:

موضوعات الرسم البياني ذات الصلة

Python-Net: إضافة أشكال منحنية إلى PDF في Python

Thu, 11 Jun 2026 00:00:00 +0000

إضافة كائن منحنى

Aspose.PDF لبيثون عبر .NET يتيح لك إضافة منحنى الأشكال إلى صفحات PDF من خلال رسم بياني فئة.

توضح هذه المقالة كيفية إنشاء كل من المنحنيات المحددة والمملوءة.

اتبع الخطوات أدناه:

ابتكر مستند مثال.
ابتكر كائن الرسم البياني بأبعاد معينة.
مجموعة الحدود لكائن الرسم البياني.
أضِف رسم بياني الاعتراض على مجموعة الفقرات من الصفحة.
احفظ ملف PDF الخاص بنا.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_curve(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 200)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    curve1 = drawing.Curve([10, 10, 50, 60, 70, 10, 100, 120])
    curve1.graph_info.color = ap.Color.green_yellow
    graph.shapes.add(curve1)

    page.paragraphs.add(graph)
    document.save(outfile)

تعرض الصورة التالية النتيجة التي تم تنفيذها باستخدام مقتطف الشفرة الخاص بنا:

إنشاء كائن منحنى معبأ

يوضح هذا المثال كيفية إضافة كائن Curve المليء بالألوان.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing


def add_curve_filled(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 200)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    curve1 = drawing.Curve([10, 10, 50, 60, 70, 10, 100, 120])
    curve1.graph_info.fill_color = ap.Color.green_yellow
    graph.shapes.add(curve1)

    page.paragraphs.add(graph)
    document.save(outfile)

نتيجة إضافة منحنى معبأ:

موضوعات الرسم البياني ذات الصلة

Python-Net: إضافة أشكال خطية إلى PDF في Python

Thu, 11 Jun 2026 00:00:00 +0000

إضافة كائن سطر

Aspose.PDF لبيثون عبر .NET يتيح لك إضافة خط الأشكال إلى صفحات PDF باستخدام رسم بياني فئة. يمكنك التحكم في لون الخط ونمط لوحة القيادة والموضع.

اتبع الخطوات أدناه:

ابتكر مستند مثال.
إنشاء كائن رسم بياني
أضِف رسم بياني الاعتراض على مجموعة الفقرات من الصفحة.
إنشاء الخط وتكوينه
أضف خط إلى الرسم البياني
احفظ ملف PDF الخاص بنا.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing


def add_line(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(100, 400)
    page.paragraphs.add(graph)

    line = drawing.Line([100, 100, 200, 100])
    line.graph_info.dash_array = [0, 1, 0]
    line.graph_info.dash_phase = 1
    graph.shapes.add(line)

    document.save(outfile)

كيفية إضافة خط متقطع إلى مستند PDF الخاص بك

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_dotted_dashed_line(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(100, 400)
    page.paragraphs.add(graph)

    line = drawing.Line([100, 100, 200, 100])
    line.graph_info.color = ap.Color.red
    line.graph_info.dash_array = [0, 1, 0]
    line.graph_info.dash_phase = 1
    graph.shapes.add(line)

    document.save(outfile)

نتيجة إضافة خط متقطع منقط:

ارسم خطًا عبر الصفحة

يمكنك أيضًا رسم خطوط عبر الصفحة لتشكيل تقاطع.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def draw_line_across_page(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    page.page_info.margin.left = 0
    page.page_info.margin.right = 0
    page.page_info.margin.bottom = 0
    page.page_info.margin.top = 0

    graph = drawing.Graph(page.page_info.width, page.page_info.height)
    line = drawing.Line([page.rect.llx, 0, page.page_info.width, page.rect.ury])
    graph.shapes.add(line)
    line2 = drawing.Line([0, page.rect.ury, page.page_info.width, page.rect.llx])
    graph.shapes.add(line2)
    page.paragraphs.add(graph)

    document.save(outfile)

موضوعات الرسم البياني ذات الصلة

Python-Net: إضافة أشكال مستطيلة إلى PDF في Python

Thu, 11 Jun 2026 00:00:00 +0000

إضافة كائن مستطيل

Aspose.PDF لبيثون عبر .NET يتيح لك إضافة المستطيل الأشكال إلى صفحات PDF من خلال رسم بياني فئة. يمكنك رسم مستطيلات مخططة وتطبيق حشوات صلبة أو متدرجة أو شفافة.

اتبع الخطوات أدناه:

قم بإنشاء ملف PDF جديد مستند.
أضِف صفحة إلى مجموعة صفحات من ملف PDF.
أضِف جزء من النص إلى مجموعة فقرات مثيل الصفحة.
ابتكر رسم بياني مثال.
تعيين الحدود لـ كائن الرسم البياني.
أضِف المستطيل كائن إلى مجموعة أشكال من كائن الرسم البياني.
أضف كائن رسم بياني إلى مجموعة فقرات مثيل الصفحة.
أضِف جزء من النص إلى مجموعة فقرات مثيل الصفحة.
واحفظ ملف PDF الخاص بك

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_rectangle(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    text_fragment = ap.text.TextFragment("Rectangle")
    page.paragraphs.add(text_fragment)

    graph = drawing.Graph(400, 300)
    page.paragraphs.add(graph)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.red)

    rect = drawing.Rectangle(20, 20, 350, 250)
    graph.shapes.add(rect)
    page.paragraphs.add(text_fragment)

    document.save(outfile)

إنشاء كائن مستطيل معبأ

يوفر Aspose.PDF لـ Python عبر .NET أيضًا ميزة ملء كائن مستطيل بلون معين.

يعرض مقتطف الشفرة التالي كيفية إضافة المستطيل كائن مليء بالألوان.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def create_rectangle_filled(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(100, 400)
    page.paragraphs.add(graph)

    rect = drawing.Rectangle(100, 100, 200, 120)
    rect.graph_info.fill_color = ap.Color.red
    graph.shapes.add(rect)

    document.save(outfile)

نتيجة المستطيل المملوء بلون صلب:

إضافة رسم باستخدام تعبئة متدرجة

يدعم Aspose.PDF لـ Python عبر .NET ميزة إضافة كائنات الرسم البياني إلى مستندات PDF وأحيانًا يكون مطلوبًا ملء كائنات الرسم البياني باستخدام Gradient Color.

يعرض مقتطف الشفرة التالي كيفية إضافة المستطيل كائن مملوء بلون متدرج.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_drawing_with_gradient_fill(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 400)
    page.paragraphs.add(graph)

    rect = drawing.Rectangle(0, 0, 300, 300)
    gradient_color = ap.Color()
    gradient_settings = drawing.GradientAxialShading(ap.Color.red, ap.Color.blue)
    gradient_settings.start = ap.Point(0, 0)
    gradient_settings.end = ap.Point(350, 350)
    gradient_color.pattern_color_space = gradient_settings
    rect.graph_info.fill_color = gradient_color
    graph.shapes.add(rect)

    document.save(outfile)

إنشاء مستطيل باستخدام قناة ألوان ألفا

يدعم Aspose.PDF لـ Python عبر .NET أيضًا الشفافية من خلال قناة ألوان ألفا.

يعرض مقتطف الشفرة التالي كيفية إضافة المستطيل كائن بقيم ألفا.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def create_rectangle_with_alpha_color_channel(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(100, 400)
    page.paragraphs.add(graph)

    rect = drawing.Rectangle(100, 100, 200, 120)
    rect.graph_info.fill_color = ap.Color.from_argb(128, 244, 180, 0)
    graph.shapes.add(rect)

    rect1 = drawing.Rectangle(200, 150, 200, 100)
    rect1.graph_info.fill_color = ap.Color.from_argb(160, 120, 0, 120)
    graph.shapes.add(rect1)

    document.save(outfile)

التحكم في ترتيب الأشكال Z

يدعم Aspose.PDF لـ .NET ميزة إضافة كائنات الرسم البياني (على سبيل المثال الرسم البياني والخط والمستطيل وما إلى ذلك) إلى مستندات PDF. عند إضافة أكثر من مثيل لنفس الكائن داخل ملف PDF، يمكننا التحكم في عرضها من خلال تحديد Z-Order. يتم استخدام Z-Order أيضًا عندما نحتاج إلى عرض الكائنات فوق بعضها البعض.

يعرض مقتطف الشفرة التالي خطوات العرض المستطيل الكائنات فوق بعضها البعض.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing


def _add_rectangle_to_page(
    page: ap.Page,
    x: float,
    y: float,
    width: float,
    height: float,
    color: ap.Color,
    zindex: int,
):
    graph = drawing.Graph(width, height)
    graph.is_change_position = False
    graph.left = x
    graph.top = y
    rect = drawing.Rectangle(0, 0, width, height)
    rect.graph_info.fill_color = color
    rect.graph_info.color = color
    graph.shapes.add(rect)
    graph.z_index = zindex
    page.paragraphs.add(graph)


def control_z_order_of_rectangle(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    page.set_page_size(375, 300)
    page.page_info.margin.left = 0
    page.page_info.margin.top = 0

    _add_rectangle_to_page(page, 50, 40, 60, 40, ap.Color.red, 2)
    _add_rectangle_to_page(page, 20, 20, 30, 30, ap.Color.blue, 1)
    _add_rectangle_to_page(page, 40, 40, 60, 30, ap.Color.green, 0)

    document.save(outfile)

موضوعات الرسم البياني ذات الصلة

Python-Net: إضافة أشكال بيضاوية إلى PDF في Python

Thu, 11 Jun 2026 00:00:00 +0000

إضافة كائن بيضاوي

Aspose.PDF لبيثون عبر .NET يتيح لك إضافة الشكل البيضاوي الأشكال إلى صفحات PDF باستخدام رسم بياني فئة. يمكنك رسم الخطوط العريضة للقطع الناقص وتطبيق ألوان التعبئة ووضع النص داخل كائنات القطع الناقص.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_ellipse(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 400)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    ellipse1 = drawing.Ellipse(150, 100, 120, 60)
    ellipse1.graph_info.color = ap.Color.green_yellow
    ellipse1.text = ap.text.TextFragment("Ellipse")
    graph.shapes.add(ellipse1)

    ellipse2 = drawing.Ellipse(50, 50, 18, 300)
    ellipse2.graph_info.color = ap.Color.dark_red
    graph.shapes.add(ellipse2)

    page.paragraphs.add(graph)
    document.save(outfile)

إنشاء كائن بيضاوي معبأ

يعرض مقتطف الشفرة التالي كيفية إضافة الشكل البيضاوي كائن مليء بالألوان.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def create_ellipse_filled(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 400)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    ellipse1 = drawing.Ellipse(100, 100, 120, 180)
    ellipse1.graph_info.fill_color = ap.Color.green_yellow
    graph.shapes.add(ellipse1)

    ellipse2 = drawing.Ellipse(200, 150, 180, 120)
    ellipse2.graph_info.fill_color = ap.Color.dark_red
    graph.shapes.add(ellipse2)

    page.paragraphs.add(graph)
    document.save(outfile)

إضافة نص داخل الشكل البيضاوي

يتيح لك Aspose.PDF لـ Python عبر .NET أيضًا وضع نص داخل كائنات الشكل. يضيف المثال التالي نصًا إلى الأشكال البيضاوية.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_text_inside_ellipse(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 400)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    text_fragment = ap.text.TextFragment("Ellipse")
    text_fragment.text_state.font = ap.text.FontRepository.find_font("Helvetica")
    text_fragment.text_state.font_size = 24

    ellipse1 = ap.drawing.Ellipse(100, 100, 120, 180)
    ellipse1.graph_info.fill_color = ap.Color.green_yellow
    ellipse1.text = text_fragment
    graph.shapes.add(ellipse1)

    ellipse2 = ap.drawing.Ellipse(200, 150, 180, 120)
    ellipse2.graph_info.fill_color = ap.Color.dark_red
    ellipse2.text = text_fragment
    graph.shapes.add(ellipse2)

    page.paragraphs.add(graph)
    document.save(outfile)

موضوعات الرسم البياني ذات الصلة

Python-Net: تحقق من حدود الشكل في رسوم PDF باستخدام Python

Thu, 11 Jun 2026 00:00:00 +0000

تحقق من حدود الشكل في الرسم البياني

عند إضافة أشكال إلى رسم بياني، يمكنك تمكين التحقق من الحدود للتأكد من أن كل شكل يناسب منطقة الرسم البياني.

استخدم وضع التحقق من الحدود لتحديد السلوك عندما يكون الشكل خارج النطاق. في هذا المثال، THROW_EXCEPTION_IF_DOES_NOT_FIT يتم استخدامه لرفع استثناء.

اتبع الخطوات أدناه:

قم بإنشاء ملف PDF جديد مستند.
إضافة صفحة.
قم بإنشاء رسم بياني وأضفها إلى الصفحة.
قم بإنشاء المستطيل يمتد خارج حدود الرسم البياني.
قم بتعيين وضع فحص الحدود إلى THROW_EXCEPTION_IF_DOES_NOT_FIT.
أضف المستطيل وعالج الاستثناء.
احفظ المستند.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing


def check_shape_bounds(outfile: str):
    document = ap.Document()
    page = document.pages.add()

    graph = drawing.Graph(100, 100)
    graph.top = 10
    graph.left = 15
    graph.border = ap.BorderInfo(ap.BorderSide.BOX, 1, ap.Color.black)
    page.paragraphs.add(graph)

    rect = drawing.Rectangle(-1, 0, 50, 50)
    rect.graph_info.fill_color = ap.Color.tomato

    try:
        graph.shapes.update_bounds_check_mode(
            ap.BoundsCheckMode.THROW_EXCEPTION_IF_DOES_NOT_FIT
        )
        graph.shapes.add(rect)
    except Exception as e:
        print(e)

    document.save(outfile)

ملاحظات

استخدم THROW_EXCEPTION_IF_DOES_NOT_FIT عندما يكون التحقق الصارم من التخطيط مطلوبًا.
بالنسبة للسلوك المتساهل، اختر سلوكًا آخر BoundsCheckMode خيار يعتمد على احتياجات التخطيط الخاصة بك.