راهنمای توسعه‌دهنده

این راهنما قابلیت‌های اصلی Aspose.Slides FOSS برای Python را با مثال‌های کد قابل اجرا برای هر حوزه ویژگی پوشش می‌دهد.

در این بخش

PageDescription
قابلیت‌ها و ویژگی‌هافهرست کامل ویژگی‌های پشتیبانی‌شده: اسلایدها، اشکال، متن، پر کردن، افکت‌ها، قالب‌بندی سه‌بعدی، یادداشت‌ها، نظرات، تصاویر و ویژگی‌های سند.
کار با تصاویرتصاویر را به‌عنوان فریم‌های تصویری از فایل یا بایت‌ها در اسلایدها جاسازی کنید؛ حالت پر کردن (کشیدگی، کاشی) را کنترل کنید.
کار با کانکتورهاکانکتورهای خمیده، زانو دار و مستقیم را بین اشکال اضافه کنید؛ نقاط اتصال و سبک خط را تنظیم کنید.
کار با افکت‌های سه‌بعدیسایه خارجی، درخشندگی، تاری، برجستگی، پیش‌تنظیمات دوربین، نورپردازی و مواد را بر روی اشکال اعمال کنید.
کار با نظراتنظرات بررسی به‌صورت رشته‌ای و یادداشت‌های گوینده را اضافه کنید؛ نویسندگان نظرات را مدیریت کنید؛ حاشیه‌نویسی‌ها را بخوانید.

نقطه ورودی API

هر عملیات با یک شیء Presentation شروع می‌شود. همیشه از آن به عنوان یک مدیر زمینه استفاده کنید:

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

# Open existing
with slides.Presentation("input.pptx") as prs:
    # work with prs
    prs.save("output.pptx", SaveFormat.PPTX)

# Create new
with slides.Presentation() as prs:
    # work with prs
    prs.save("new.pptx", SaveFormat.PPTX)

مدیر زمینه تضمین می‌کند که منابع داخلی COM/XML هنگام خروج از بلوک آزاد شوند. از ذخیرهٔ یک ارجاع Presentation خارج از بلوک with خودداری کنید.

قالب خروجی پشتیبانی‌شده

تنها قالب ذخیره‌سازی پشتیبانی‌شده PPTX (SaveFormat.PPTX) است. خروجی به PDF، HTML، SVG یا فرمت‌های تصویری در این نسخه موجود نیست.

کلاس‌های کلیدی

Class / EnumImport PathDescription
Presentationaspose.slides_fossمحفظه ریشه؛ به عنوان مدیر زمینه استفاده شود
ShapeTypeaspose.slides_fossشمارش برای انواع شکل (RECTANGLE، ELLIPSE، …)
FillTypeaspose.slides_fossشمارش برای انواع پرکردن (SOLID، GRADIENT، …)
NullableBoolaspose.slides_fossبولی سه‌حالی برای قالب‌بندی (TRUE، FALSE، NOT_DEFINED)
SaveFormataspose.slides_foss.exportشمارش فرمت خروجی (فقط PPTX پشتیبانی می‌شود)
Coloraspose.slides_foss.drawingسازنده رنگ ARGB
PointFaspose.slides_foss.drawingنقطه دو‑بعدی شناور (برای موقعیت‌های نظرات استفاده می‌شود)

محدودیت‌های شناخته‌شده

مناطق زیر در این نسخه NotImplementedError را ایجاد می‌کنند:

  • Charts: ایجاد یا ویرایش نمودارها امکان‌پذیر نیست
  • SmartArt: پشتیبانی نمی‌شود
  • Animations and transitions: انتقال اسلایدها و انیمیشن‌های اشیاء قابل تنظیم نیست
  • Export formats: فقط ذخیره به‌صورت PPTX پشتیبانی می‌شود؛ خروجی PDF، HTML، SVG یا تصویر وجود ندارد
  • Hyperlinks and action settings: اشیاء پیوند قابل تغییر نیستند
  • VBA macros and digital signatures: در دسترس نیست

بخش‌های ناشناخته XML که در هنگام بارگذاری مواجه می‌شوند، به‌صورت دقیق حفظ می‌شوند و در زمان ذخیره‌سازی، همان‌گونه باقی می‌مانند؛ بنابراین دور زدن (round‑tripping) هرگز محتوایی را که کتابخانه هنوز درک نمی‌کند حذف نمی‌کند.

موارد مرتبط

 فارسی