عمليات العرض التقديمي منخفضة الكود في بايثون
نظرة عامة
توفر وحدة aspose.slides.lowcode فئات مساعدية للعمليات الشائعة على العروض التقديمية. تُغلف هذه المساعدات سير عمل نموذج الكائنات المستخدم بشكل متكرر في طرق مركّزة، مما يتيح لك تحويل أو دمج الملفات، جمع الأشكال، وإزالة المحتوى غير المستخدم بكمية أقل من الشيفرة.
تكون المساعدات منخفضة الكود أكثر فائدة عندما ينطبق العملية على ملف أو عرض تقديمي كامل ويتطابق سير العمل الافتراضي مع متطلباتك. استخدم نموذج كائنات Aspose.Slides الكامل عندما تحتاج إلى تحكم دقيق في الشرائح الفردية، القوالب الرئيسية، التخطيطات، الأشكال، إعدادات التصدير، أو العلاقات بين عناصر العرض التقديمي.
الجدول التالي يلخّص المساعدات المتاحة:
| المساعد | يستخدم لـ |
|---|---|
| Convert | تحويل عرض تقديمي إلى صيغة أخرى باستخدام استدعاء مباشر من ملف إلى ملف. |
| Merger | دمج ملفات عروض تقديمية كاملة ذات نفس الصيغة. |
| Collect | استخراج الأشكال من العرض التقديمي كاملًا للمعالجة أو التحليل المتكرر. |
| Compress | إزالة القوالب والتخطيطات غير المستخدمة وتقليل بيانات الخطوط المدمجة. |
تحويل عرض تقديمي
استخدم Convert.auto_by_extension عندما يكون امتداد ملف الإخراج كافيًا لتحديد صيغة التصدير. تقوم الطريقة بفتح العرض التقديمي المصدر، وتحديد الصيغة المطلوبة من مسار الإخراج، وكتابة النتيجة.
import aspose.slides as slides
slides.lowcode.Convert.auto_by_extension("input.pptx", "output.pdf")
توفر فئة Convert أيضًا طرقًا مخصصة للإخراج بصيغة PDF وSVG وJPEG وPNG وTIFF. استخدم نموذج الكائن الكامل عندما تحتاج إلى فحص أو تعديل العرض التقديمي قبل التصدير أو تهيئة خيار تصدير غير متاح عبر المساعدة المختارة. راجع Convert Presentation للحصول على سير عمل وخيارات محددة لكل صيغة.
دمج العروض التقديمية
استخدم Merger.process لدمج ملفات عروض تقديمية كاملة باستدعاء واحد. يجب أن تكون العروض التقديمية المدخلة بنفس صيغة الملف.
import aspose.slides as slides
input_files = ["part-1.pptx", "part-2.pptx"]
slides.lowcode.Merger.process(input_files, "merged.pptx")
المساعدة مناسبة عندما يجب إلحاق جميع الشرائح بنتيجة واحدة دون اختيارها أو إعادة تعيينها بشكل فردي. استخدم نموذج الكائن الكامل عندما تحتاج إلى دمج شرائح مختارة، تطبيق قالب رئيس أو تخطيط وجهة، الحفاظ على الأقسام صراحة، أو التوفيق بين أحجام الشرائح المختلفة. راجع Merge Presentations لهذه السيناريوهات.
جمع الأشكال
استخدم Collect.shapes عندما تحتاج إلى مجموعة جميع الأشكال في عرض تقديمي. هذا مفيد عندما سيتم تصفية المجموعة نفسها أو عدّها أو معالجتها أكثر من مرة.
import aspose.slides as slides
with slides.Presentation("input.pptx") as presentation:
shapes = slides.lowcode.Collect.shapes(presentation)
for shape in shapes:
print(f"{shape.name}: {type(shape).__name__}")
استخدم حلقات جمع مباشرة عندما يكون ترتيب الاستعراض، الخروج المبكر، التصفية قبل المعالجة، أو التحكم التفصيلي في العلاقة بين الأصل والفرع مهمًا.
ضغط محتوى العرض التقديمي
يمكن لفئة Compress إزالة العناصر الهيكلية غير المستخدمة وتقليل بيانات الخطوط المدمجة:
- Compress.remove_unused_layout_slides يزيل شرائح التخطيط التي لا تشير إليها أي شريحة عادية.
- Compress.remove_unused_master_slides يزيل شرائح القالب الرئيسي التي لم تعد مستخدمة.
- Compress.compress_embedded_fonts يزيل الأحرف غير المستخدمة من الخطوط المدمجة.
import aspose.slides as slides
with slides.Presentation("input.pptx") as presentation:
slides.lowcode.Compress.remove_unused_layout_slides(presentation)
slides.lowcode.Compress.remove_unused_master_slides(presentation)
slides.lowcode.Compress.compress_embedded_fonts(presentation)
presentation.save("compressed.pptx", slides.export.SaveFormat.PPTX)
قم بإزالة التخطيطات غير المستخدمة قبل القوالب غير المستخدمة بحيث يمكن إزالة القالب الذي يصبح غير مُشار إليه بعد تنظيف التخطيطات. احفظ العرض التقديمي المُحسّن في ملف جديد إذا كنت قد تحتاج إلى القوالب أو التخطيطات الأصلية أو بيانات الخط المدمج الكاملة لاحقًا. للمزيد من التفاصيل، راجع Slide Master وEmbedded Font.
الأسئلة المتكررة
متى ينبغي علي استخدام API منخفض الكود بدلاً من نموذج الكائن الكامل؟
استخدم المساعدات منخفضة الكود عندما تنطبق عملية قياسية على ملف أو عرض تقديمي كامل ولا تتطلب تحكمًا تفصيليًا في العناصر الفردية. استخدم نموذج الكائن الكامل عندما تحتاج إلى اختيار شرائح محددة، التحكم في علاقات القالب الرئيسي والتخطيط، فحص الحالة المتوسطة، أو تهيئة سلوك لا تكشف عنه المساعدة.
هل يمكن لـ Merger دمج عروض تقديمية بصيغ ملفات مختلفة؟
لا. يتطلب Merger.process أن تكون العروض التقديمية المدخلة بنفس الصيغة. حوّل الملفات المدخلة إلى صيغة مشتركة أولاً، على سبيل المثال باستخدام Convert.auto_by_extension، ثم دمج الملفات المحوّلة.
ماذا يتضمن Collect.shapes؟
Collect.shapes يستخرج الأشكال من العرض التقديمي بحيث يمكن الاحتفاظ بها، تصفيتها، عدّها، أو استعراضها عدة مرات. استخدم حلقات جمع مباشرة عندما تحتاج إلى تحكم دقيق في أنواع الشرائح أو الكائنات المتداخلة التي يتم زيارتها.
هل Compress يقلل دائمًا حجم ملف العرض التقديمي؟
ليس بالضرورة. تعتمد النتيجة على ما إذا كان العرض التقديمي يحتوي على تخطيطات غير مستخدمة، قوالب رئيسية غير مستخدمة، أو خطوط مدمجة بها أحرف غير مستخدمة. إذا لم يتوفر أي من هذه العناصر، قد لا تقلل عمليات Compress حجم الملف.
هل تُحفظ التغييرات التي يجريها Compress تلقائيًا؟
لا. تعمل هذه المساعدات على كائن Presentation المحمَّل في الذاكرة. بعد تشغيل Compress، استدعِ Presentation.save لكتابة النتيجة.