چگونه اشکال را به پاورپوینت در پایتون اضافه کنیم

چگونه اشکال را به پاورپوینت در پایتون اضافه کنیم

Aspose.Slides FOSS for Python از افزودن AutoShapes، Tables، Connectors و PictureFrames به اسلایدهای ارائه پشتیبانی می‌کند. تمام انواع شکل‌ها از طریق مجموعه slide.shapes اضافه می‌شوند.

راهنمای گام به گام

مرحله ۱: نصب بسته

pip install aspose-slides-foss

نصب را تأیید کنید:

import aspose.slides_foss as slides
print("Ready")

مرحله ۲: ایجاد یک ارائه

همیشه از Presentation به عنوان مدیر زمینه استفاده کنید.

import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    slide = prs.slides[0]
    # ... add shapes ...
    prs.save("output.pptx", SaveFormat.PPTX)

مرحله ۳: افزودن یک AutoShape

slide.shapes.add_auto_shape(shape_type, x, y, width, height) یک شکل را در موقعیت و اندازهٔ داده‌شده (همه به نقطه) قرار می‌دهد. برای انتخاب شکل از ثابت‌های ShapeType استفاده کنید.

import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    slide = prs.slides[0]

    # Rectangle
    rect = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 300, 100)
    rect.add_text_frame("Rectangle shape")

    # Ellipse
    ellipse = slide.shapes.add_auto_shape(ShapeType.ELLIPSE, 400, 50, 200, 100)
    ellipse.add_text_frame("Ellipse shape")

    prs.save("autoshapes.pptx", SaveFormat.PPTX)

مرحله ۴: افزودن جدول

slide.shapes.add_table(x, y, col_widths, row_heights) یک جدول در موقعیت مشخص ایجاد می‌کند. عرض ستون‌ها و ارتفاع ردیف‌ها لیست‌هایی از مقادیر نقطه‌ای هستند.

import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    slide = prs.slides[0]

    col_widths = [150.0, 150.0, 150.0]
    row_heights = [40.0, 40.0, 40.0]
    table = slide.shapes.add_table(50, 200, col_widths, row_heights)

    # Set header row text
    headers = ["Product", "Units", "Revenue"]
    for col, text in enumerate(headers):
        table.rows[0][col].text_frame.text = text

    # Set data rows
    rows = [
        ["Widget A", "120", "$2,400"],
        ["Widget B", "85", "$1,700"],
    ]
    for row_idx, row_data in enumerate(rows):
        for col, text in enumerate(row_data):
            table.rows[row_idx + 1][col].text_frame.text = text

    prs.save("table.pptx", SaveFormat.PPTX)

مرحله 5: افزودن یک کانکتور

اتصالات دو شکل را به صورت بصری به هم متصل می‌کنند. ابتدا شکل‌ها را ایجاد کنید، سپس یک اتصال اضافه کنید و نقاط اتصال شروع و پایان آن را تنظیم کنید.

import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    slide = prs.slides[0]

    box1 = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 100, 150, 60)
    box1.add_text_frame("Start")

    box2 = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 350, 100, 150, 60)
    box2.add_text_frame("End")

    conn = slide.shapes.add_connector(ShapeType.BENT_CONNECTOR3, 0, 0, 10, 10)
    conn.start_shape_connected_to = box1
    conn.start_shape_connection_site_index = 3  # right side of box1
    conn.end_shape_connected_to = box2
    conn.end_shape_connection_site_index = 1    # left side of box2

    prs.save("connector.pptx", SaveFormat.PPTX)

شاخص‌های نقاط اتصال برای یک مستطیل به صورت 0–3 شماره‌گذاری می‌شوند: بالا=0، چپ=1، پایین=2، راست=3.


مرحله ۶: افزودن قاب تصویر

یک تصویر را جاسازی کنید و به اسلاید به عنوان PictureFrame اضافه کنید. ابتدا بایت‌های تصویر را بخوانید، آن‌ها را به مجموعهٔ تصاویر ارائه اضافه کنید، سپس فریم را ایجاد کنید.

import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    with open("logo.png", "rb") as f:
        image_data = f.read()

    image = prs.images.add_image(image_data)

    slide = prs.slides[0]
    slide.shapes.add_picture_frame(
        ShapeType.RECTANGLE,  # bounding shape type
        50, 50,               # x, y in points
        200, 150,             # width, height in points
        image
    )

    prs.save("with-image.pptx", SaveFormat.PPTX)

مسائل رایج و راه‌حل‌ها

شکل خارج از ناحیه قابل مشاهده اسلاید ظاهر می‌شود

اسلایدها به‌صورت پیش‌فرض 720 × 540 نقطه هستند. مقادیر x یا y که خارج از این محدوده باشند، شکل را از اسلاید خارج می‌کنند. x < 720 و y < 540 را نگه دارید و اطمینان حاصل کنید x + width <= 720 و y + height <= 540.

AttributeError: 'NoneType' object has no attribute 'text_frame'

add_auto_shape() به‌صورت مستقیم شیء شکل را برمی‌گرداند. اگر None را می‌بینید، بررسی کنید که مقدار بازگشتی را دور نمی‌اندازید.

متن سلول جدول پس از اختصاص خالی است

ویژگی صحیح .text_frame.text (نه .text مستقیماً روی سلول) است. سلول‌ها را به صورت table.rows[row_index][col_index].text_frame.text = "value" دسترسی پیدا کنید.


سوالات متداول

چند شکل می‌توانم به یک اسلاید اضافه کنم؟

هیچ محدودیتی توسط کتابخانه اعمال نمی‌شود. محدودیت‌های عملی به اندازهٔ فایل و قابلیت رندرینگ نمایشگر PPTX هدف شما بستگی دارد.

آیا می‌توانم موقعیت یک شکل را پس از افزودن آن تغییر دهم؟

بله. شیء shape که توسط add_auto_shape() برگردانده می‌شود، دارای ویژگی‌های x، y، width و height است که می‌توانید تنظیم کنید:

shape.x = 100
shape.y = 200
shape.width = 400
shape.height = 80

آیا می‌توانم رنگ خط‌مرز (حاشیه) شکل را تنظیم کنم؟

بله، از طریق shape.line_format:

from aspose.slides_foss.drawing import Color
shape.line_format.fill_format.solid_fill_color.color = Color.from_argb(255, 200, 0, 0)

آیا نمودارها پشتیبانی می‌شوند؟

خیر. نمودارها، SmartArt و اشیاء OLE در این نسخه پیاده‌سازی نشده‌اند و NotImplementedError را ایجاد می‌کنند.


همچنین ببینید

 فارسی