ایجاد ارائه‌ها در پایتون از طریق جاوا
بررسی کلی
این مقاله نشان می‌دهد چگونه می‌توانید با Aspose.Slides for Python via Java یک ارائه بسازید، شکل متنی به اسلاید اول اضافه کنید و نتیجه را به صورت فایل PPTX ذخیره کنید. بخش پرسش‌های متداول شامل قالب‌های خروجی، قالب‌ها، اندازه اسلاید، مصرف حافظه، چندنخی بودن، لایسنس، امضای دیجیتال و پشتیبانی از VBA است.
پیش از شروع، Python، JDK، JPype و Aspose.Slides for Python via Java را نصب کنید. برای مراحل نصب در ویندوز، لینوکس و macOS به Installation مراجعه کنید.
ایجاد یک ارائه
ساخت یک فایل PowerPoint از ابتدا در Aspose.Slides for Python via Java به آسانیِ نمونه‌سازی کلاس Presentation است. سازنده به‌طور خودکار یک دک خالی با یک اسلاید می‌سازد و بوم فوری برای اضافه‌کردن شکل‌ها، متن، نمودارها یا هر محتوای دیگری که برنامه‌تان نیاز دارد، فراهم می‌کند. پس از تغییر آن اسلاید یا افزودن اسلایدهای جدید می‌توانید نتیجه را به PPTX، PPT قدیمی یا حتی قالب‌های OpenDocument ذخیره کنید. نمونه کد کوتاه زیر این فرآیند را با افزودن یک شکل ساده به اسلاید اول نشان می‌دهد.
- یک نمونه از کلاس Presentation ایجاد کنید.
- اسلاید اول را با شاخص 0 دریافت کنید.
- یک AutoShape از نوع ShapeType.Cloud با استفاده از ShapeCollection.addAutoShape اضافه کنید.
- متن شکل را با TextFrame.setText تنظیم کنید.
- ارائه را با Presentation.save و SaveFormat.Pptx ذخیره کنید.
مثال زیر JVM را در صورت عدم اجرا راه‌اندازی می‌کند، یک شکل ابری با متن به اسلاید اول اضافه می‌کند و ارائه را ذخیره می‌نماید. آن را به نام create_presentation.py ذخیره کنید:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat, ShapeType
# یک ارائه با یک اسلاید خالی ایجاد کنید.
presentation = Presentation()
try:
# اسلاید اول را دریافت کنید.
slide = presentation.getSlides().get_Item(0)
# یک شکل ابری اضافه کنید و متن آن را تنظیم کنید.
auto_shape = slide.getShapes().addAutoShape(ShapeType.Cloud, 20, 20, 200, 80)
auto_shape.getTextFrame().setText("Hello, Aspose!")
# ارائه را به عنوان فایل PPTX ذخیره کنید.
presentation.save("new_presentation.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
اسکریپٹ را در محیطی که بسته‌ها را نصب کرده‌اید اجرا کنید:
python create_presentation.py
گوشه بالای چپ ابر 20 نقطه از لبه‌های چپ و بالا اسلاید فاصله دارد و ابعاد ابر 200 نقطه عرض و 80 نقطه ارتفاع است. اسکریپت new_presentation.pptx را در پوشهٔ کاری فعلی ذخیره می‌کند، با یک اسلاید که شامل ابر و متن آن است. JVM تا خروجی پردازش Python فعال می‌ماند؛ برای جزئیات به Limitations and API Differences مراجعه کنید. بدون لایسنس، Aspose.Slides یک جعبه متن علامت آب‌نشان ارزیابی را به هر اسلاید ذخیره‌شده اضافه می‌کند؛ برای اطلاعات بیشتر به Licensing نگاه کنید.
نتیجه:
پرسش‌های متداول
چه قالب‌هایی می‌توانم برای ذخیرهٔ یک ارائه جدید استفاده کنم؟
می‌توانید به PPTX، PPT و ODP ذخیره کنید و به PDF، XPS، HTML، SVG و تصاویر صادر کنید.
آیا می‌توانم از یک قالب (POTX/POTM) شروع کنم و به صورت PPTX معمولی ذخیره کنم؟
بله. قالب را بارگیری کنید و به قالب دلخواه ذخیره کنید؛ قالب‌های POTX/POTM/PPTM و مشابه آن‌ها پشتیبانی می‌شوند.
چگونه می‌توانم اندازه/نسبت تصویر اسلاید را هنگام ایجاد ارائه کنترل کنم؟
اندازهٔ اسلاید را تنظیم کنید (از پیش‌تنظیم‌های 4:3 و 16:9 یا ابعاد دلخواه) و نحوهٔ مقیاس‌بندی محتوا را انتخاب کنید.
اندازه‌ها و مختصات به چه واحدی اندازه‌گیری می‌شوند؟
به نقطه: 1 اینچ برابر 72 نقطه است.
چگونه می‌توانم ارائه‌های بسیار بزرگ (با فایل‌های رسانه‌ای زیاد) را برای کاهش مصرف حافظه بهینه کنم؟
از استراتژی‌های مدیریت BLOB استفاده کنید، ذخیره‌سازی در حافظه را با بهره‌گیری از فایل‌های موقت محدود کنید و جریان‌های مبتنی بر فایل را نسبت به جریان‌های صرفاً در‑حافظه ترجیح دهید.
آیا می‌توانم ارائه‌ها را به صورت موازی ایجاد/ذخیره کنم؟
نمی‌توانید به همان نمونهٔ Presentation از چندین نخ دسترسی داشته باشید. برای هر نخ یا پردازش یک نمونهٔ جداگانه ایجاد کنید.
چگونه می‌توانم علامت آب‌نشان آزمایشی و محدودیت‌ها را حذف کنم؟
یک بار برای هر فرآیند لایسنس اعمال کنید. فایل XML لایسنس باید دست‌نخورده بماند و تنظیم لایسنس در صورت استفاده از چندین نخ همگام‌سازی شود.
آیا می‌توانم PPTX ایجادشده را دیجیتally امضا کنم؟
بله. امضاهای دیجیتال (اضافه و تأیید) برای ارائه‌ها پشتیبانی می‌شود.
آیا ماکروها (VBA) در ارائه‌های ساخته‌شده پشتیبانی می‌شوند؟
بله. می‌توانید پروژه‌های VBA را ایجاد/ویرایش کنید و فایل‌های فعال‌سازی‌دار مانند PPTM/PPSM را ذخیره کنید.