عمليات العرض التقديمي منخفضة الشيفرة في PHP

عن ماذا تتحدث هذه الصفحة

استخدام واجهة برمجة التطبيقات منخفضة الشيفرة لـ Aspose.Slides في PHP لتحويل ودمج العروض التقديمية، وتكرار المحتوى، وجمع الأشكال، وتقليل حجم العرض التقديمي.

نظرة عامة

توفر مساحة الأسماء aspose.slides فئات مساعدة ثابتة للعمليات الشائعة على العروض التقديمية. تُغلف هذه المساعدات سير عمل نموذج الكائنات المستخدم بشكل متكرر في طرق مركزة، بحيث يمكنك تحويل أو دمج الملفات، معالجة عناصر العرض التقديمي، جمع الأشكال، وإزالة المحتوى غير المستخدم بكتابة أقل.

تكون المساعدات منخفضة الشيفرة أكثر فائدة عندما ينطبق العملية على ملف أو عرض تقديمي كامل وتطابق سير العمل الافتراضي متطلباتك. استخدم نموذج الكائن الكامل لـ Aspose.Slides object model عندما تحتاج إلى تحكم دقيق على الشرائح الفردية، الماسترز، التخطيطات، الأشكال، إعدادات التصدير، أو العلاقات بين عناصر العرض التقديمي.

الجدول التالي يلخص المساعدات المتوفرة:

المساعد	الاستخدام
Convert	تحويل عرض تقديمي إلى تنسيق آخر باستخدام استدعاء مباشر من ملف إلى ملف.
Merger	دمج ملفات عرض تقديمي كاملة ذات نفس التنسيق.
ForEach_	تشغيل دالة رد نداء لكل شريحة أو شكل أو فقرة أو جزء نصي.
Collect	استرجاع الأشكال من العرض التقديمي بالكامل لإعادة المعالجة أو التحليل المتكرر.
Compress	إزالة الماسترز والتخطيطات غير المستخدمة وتقليل بيانات الخط المضمّن.

تحويل عرض تقديمي

استخدم Convert::autoByExtension عندما تكون امتداد ملف الإخراج كافياً لاختيار تنسيق التصدير. تقوم الطريقة بفتح عرض التقديمي المصدر، تحدد التنسيق المطلوب من مسار الإخراج، وتكتب النتيجة.

use aspose\slides\Convert;

Convert::autoByExtension("input.pptx", "output.pdf");

توفر فئة Convert أيضاً طرقاً مخصصة لإنتاج PDF وSVG وJPEG وPNG وTIFF. استخدم نموذج الكائن الكامل عندما تحتاج إلى فحص أو تعديل العرض التقديمي قبل التصدير أو تكوين خيار تصدير غير معروض بواسطة المساعد المحدد. راجع Convert Presentation للحصول على سير عمل وخيارات خاصة بكل تنسيق.

دمج العروض التقديمية

استخدم Merger::process لدمج ملفات عرض تقديمي كاملة باستدعاء واحد. يجب أن تكون العروض التقديمية المدخلة ذات تنسيق ملف متماثل.

use aspose\slides\Merger;

$inputFiles = ["part-1.pptx", "part-2.pptx"];
Merger::process($inputFiles, "merged.pptx");

المساعد مناسب عندما ينبغي إلحاق جميع الشرائح إلى نتيجة واحدة دون اختيارها أو إعادة تعيينها بشكل فردي. استخدم نموذج الكائن الكامل عندما تحتاج إلى دمج شرائح مختارة، تطبيق ماستر أو تخطيط وجهة، الحفاظ على الأقسام صراحة، أو توحيد أحجام الشرائح المختلفة. راجع Merge Presentations لهذه السيناريوهات.

التنقل عبر عناصر العرض التقديمي

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

المثال التالي يستخدم ForEach_::slide، ForEach_::shape، ForEach_::paragraph، وForEach_::portion لفحص العناصر المقابلة:

use aspose\slides\ForEach_;
use aspose\slides\Presentation;

class SlideCallback {
    public function invoke($slide, $index): void {
        $slideIndex = java_values($index);
        $shapeCount = java_values($slide->getShapes()->size());
        echo sprintf("Slide %d: %d shapes", $slideIndex, $shapeCount) . PHP_EOL;
    }
}

class ShapeCallback {
    public function invoke($shape, $slide, $index): void {
        $shapeIndex = java_values($index);
        $slideType = java_values($slide->getClass()->getSimpleName());
        $shapeName = java_values($shape->getName());
        echo sprintf("Shape %d on %s: %s", $shapeIndex, $slideType, $shapeName) . PHP_EOL;
    }
}

class ParagraphCallback {
    public function invoke($paragraph, $slide, $index): void {
        $paragraphIndex = java_values($index);
        $slideType = java_values($slide->getClass()->getSimpleName());
        $text = java_values($paragraph->getText());
        echo sprintf("Paragraph %d on %s: %s", $paragraphIndex, $slideType, $text) . PHP_EOL;
    }
}

class PortionCallback {
    public function invoke($portion, $paragraph, $slide, $index): void {
        $portionIndex = java_values($index);
        $slideType = java_values($slide->getClass()->getSimpleName());
        $text = java_values($portion->getText());
        echo sprintf("Portion %d on %s: %s", $portionIndex, $slideType, $text) . PHP_EOL;
    }
}

$presentation = new Presentation("input.pptx");
try {
    $slideCallback = java_closure(new SlideCallback(), null, java('com.aspose.slides.ForEach_$ForEachSlideCallback'));
    $shapeCallback = java_closure(new ShapeCallback(), null, java('com.aspose.slides.ForEach_$ForEachShapeCallback'));
    $paragraphCallback = java_closure(new ParagraphCallback(), null, java('com.aspose.slides.ForEach_$ForEachParagraphCallback'));
    $portionCallback = java_closure(new PortionCallback(), null, java('com.aspose.slides.ForEach_$ForEachPortionCallback'));

    ForEach_::slide($presentation, $slideCallback);
    ForEach_::shape($presentation, $shapeCallback);
    ForEach_::paragraph($presentation, $paragraphCallback);
    ForEach_::portion($presentation, $portionCallback);
} finally {
    $presentation->dispose();
}

بشكل افتراضي، يشمل التجوال عبر الأشكال والنصوص على مستوى العرض الشرائح العادية، والماستر، والتخطيط. يمكن للتحميلات التي تتضمن معلمة includeNotes معالجة شرائح الملاحظات أيضاً. استخدم حلقات الجمع المباشرة عندما تكون ترتيب التجوال أو الخروج المبكر أو التصفية قبل استدعاء رد النداء أو التحكم التفصيلي في العلاقات الأصلية- الفرعية أمرًا مهمًا.

جمع الأشكال

استخدم Collect::shapes عندما تحتاج إلى مجموعة كل الأشكال في عرض تقديمي بدلاً من رد نداء لكل شكل. هذا مفيد عندما سيتم تصفية المجموعة نفسها أو عدّها أو معالجتها أكثر من مرة.

use aspose\slides\Collect;
use aspose\slides\Presentation;

$presentation = new Presentation("input.pptx");
try {
    $shapes = Collect::shapes($presentation);

    foreach ($shapes as $shape) {
        $shapeName = java_values($shape->getName());
        $shapeType = java_values($shape->getClass()->getSimpleName());
        echo sprintf("%s: %s", $shapeName, $shapeType) . PHP_EOL;
    }
} finally {
    $presentation->dispose();
}

استخدم ForEach_::shape بدلاً من ذلك عندما يمكن التعامل مع كل شكل فورًا ولا تحتاج إلى الاحتفاظ بالنتيجة المجموعة.

ضغط محتوى العرض التقديمي

يمكن لفئة Compress إزالة العناصر الهيكلية غير المستخدمة وتقليل بيانات الخط المضمّن:

• Compress::removeUnusedLayoutSlides يزيل شرائح التخطيط التي لا تشير إليها أي شريحة عادية.
• Compress::removeUnusedMasterSlides يزيل الماسترز التي لم تعد مستخدمة.
• Compress::compressEmbeddedFonts يزيل الأحرف غير المستخدمة من الخطوط المضمَّنة.

use aspose\slides\Compress;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation("input.pptx");
try {
    Compress::removeUnusedLayoutSlides($presentation);
    Compress::removeUnusedMasterSlides($presentation);
    Compress::compressEmbeddedFonts($presentation);

    $presentation->save("compressed.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

قم بإزالة التخطيطات غير المستخدمة قبل الماسترز غير المستخدمة حتى يتمكن ماستر يصبح غير مُشار إليه بعد تنظيف التخطيطات من الإزالة أيضاً. احفظ العرض التقديمي المُحسّن إلى ملف جديد إذا قد تحتاج إلى الماسترز الأصلية أو التخطيطات أو بيانات الخط المضمّن الكاملة لاحقًا. لمزيد من التفاصيل، راجع Slide Master وEmbedded Font.

الأسئلة الشائعة

متى يجب علي استخدام واجهة برمجة التطبيقات منخفضة الشيفرة بدلاً من نموذج الكائن الكامل؟

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

هل يمكن للمجمع (Merger) دمج العروض التقديمية ذات الصيغ المختلفة؟

لا. يتطلب Merger::process أن تكون عروض التقديمية المدخلة بنفس الصيغة. حوِّل الملفات المدخلة إلى صيغة موحدة أولًا، على سبيل المثال باستخدام Convert::autoByExtension، ثم دمج الملفات المحوَّلة.

**هل تعالج ForEach_ الشرائح الماستر، التخطيط، والملاحظات؟**

تقوم ForEach_::slide بالتنقل عبر الشرائح العادية للعرض. تشمل عمليات ForEach_::shape وForEach_::paragraph وForEach_::portion على مستوى العرض الشرائح العادية، والماستر، والتخطيط افتراضيًا. استخدم التحميلات التي يتضمن فيها includeNotes القيمة true لتضمين شرائح الملاحظات.

**ما الفرق بين ForEach_::shape وCollect::shapes؟**

استخدم ForEach_::shape لمعالجة كل شكل فورًا عبر رد نداء. استخدم Collect::shapes عندما تحتاج إلى نتيجة قابلة للتكرار يمكن الاحتفاظ بها، تصفيتها، عدّها، أو اجتيازها عدة مرات.

هل يجعل Compress دائمًا ملف العرض التقديمي أصغر؟

ليس بالضرورة. تعتمد النتيجة على ما إذا كان العرض يحتوي على تخطيطات غير مستخدمة، ماسترز غير مستخدمة، أو خطوط مضمنة بأحرف غير مستخدمة. إذا لم يتوفر أي منها، قد لا تقلل عمليات Compress الحجم الفعلي للملف.

**هل يتم حفظ التغييرات التي يجريها ForEach_ أو Compress تلقائيًا؟**

لا. تعمل هذه المساعدات على كائن Presentation المحمل في الذاكرة. بعد تعديل العناصر في رد نداء ForEach_ أو تشغيل Compress، استدعِ Presentation::save لكتابة النتيجة.

مقالات ذات صلة

• تحويل عرض تقديمي
• دمج العروض التقديمية
• ماستر الشريحة
• إدارة مربع النص
• الخط المضمّن