إنشاء صور مصغرة لأشكال العروض التقديمية في Python عبر Java

المقدمة

يمكن استخدام Aspose.Slides for Python via Java لإنشاء ملفات عرض حيث تتطابق كل صفحة مع شريحة. يمكن عرض الشرائح بفتح ملفات العرض باستخدام Microsoft PowerPoint. ومع ذلك، قد يحتاج المطورون أحيانًا إلى عرض صور الأشكال بشكل منفصل في عارض صور. في مثل هذه الحالات، يساعد Aspose.Slides for Python via Java على إنشاء صور مصغرة لأشكال الشرائح.

تشرح هذه المقالة كيفية إنشاء صور مصغرة للأشكال بطرق مختلفة:

  • إنشاء صورة مصغرة لشكل داخل شريحة.
  • إنشاء صورة مصغرة لشكل شريحة بأبعاد يحددها المستخدم.
  • إنشاء صورة مصغرة داخل حدود مظهر الشكل.

إنشاء صورة مصغرة لشكل من شريحة

لإنشاء صورة مصغرة لشكل من أي شريحة باستخدام Aspose.Slides for Python via Java، اتبع الخطوات التالية:

  1. إنشاء نسخة من الفئة Presentation.
  2. الحصول على مرجع إلى شريحة باستخدام معرّفها أو فهرسها.
  3. احصل على صورة مصغرة للشكل على الشريحة المشار إليها بالمقاس الافتراضي.
  4. احفظ صورة المصغرة بالتنسيق الذي تفضله.

هذا المثال يوضح كيفية إنشاء صورة مصغرة لشكل من شريحة:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import ImageFormat, Presentation

# إنشاء كائن من فئة Presentation يمثل ملف العرض التقديمي.
presentation = Presentation("Thumbnail.pptx")
try:
    # إنشاء صورة بالحجم الكامل.
    shape_image = presentation.getSlides().get_Item(0).getShapes().get_Item(0).getImage()
    try:
        # حفظ الصورة إلى القرص بتنسيق PNG.
        shape_image.save("output.png", ImageFormat.Png)
    finally:
        shape_image.dispose()
finally:
    presentation.dispose()

إنشاء صورة مصغرة بمعامل تكبير يحدده المستخدم

لإنشاء صورة مصغرة لشكل شريحة باستخدام Aspose.Slides for Python via Java، اتبع الخطوات التالية:

  1. إنشاء نسخة من الفئة Presentation.
  2. الحصول على مرجع إلى شريحة باستخدام معرّفها أو فهرسها.
  3. احصل على صورة مصغرة للشكل على الشريحة المشار إليها بأبعاد يحددها المستخدم.
  4. احفظ صورة المصغرة بالتنسيق الذي تفضله.

هذا المثال يوضح كيفية إنشاء صورة مصغرة لشكل بناءً على معامل تكبير معرف:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import ImageFormat, Presentation, ShapeThumbnailBounds

# إنشاء كائن من فئة Presentation يمثل ملف العرض التقديمي.
presentation = Presentation("Thumbnail.pptx")
try:
    # إنشاء صورة بمقياس عامل 2 في الاتجاهين.
    shape_image = presentation.getSlides().get_Item(0).getShapes().get_Item(0).getImage(ShapeThumbnailBounds.Shape, 2, 2)
    try:
        # حفظ الصورة إلى القرص بتنسيق PNG.
        shape_image.save("output.png", ImageFormat.Png)
    finally:
        shape_image.dispose()
finally:
    presentation.dispose()

إنشاء صورة مصغرة لمظهر الشكل بناءً على الحدود

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

  1. إنشاء نسخة من الفئة Presentation.
  2. الحصول على مرجع إلى شريحة باستخدام معرّفها أو فهرسها.
  3. احصل على صورة المصغرة لشكل على الشريحة المشار إليها باستخدام حدود مظهره.
  4. احفظ صورة المصغرة بالتنسيق الذي تفضله.

هذا المثال يعتمد على الخطوات السابقة:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import ImageFormat, Presentation, ShapeThumbnailBounds

# إنشاء كائن من فئة Presentation يمثل ملف العرض التقديمي.
presentation = Presentation("Thumbnail.pptx")
try:
    # إنشاء صورة بالحجم الكامل.
    shape_image = presentation.getSlides().get_Item(0).getShapes().get_Item(0).getImage(ShapeThumbnailBounds.Appearance, 1, 1)
    try:
        # حفظ الصورة إلى القرص بتنسيق PNG.
        shape_image.save("output.png", ImageFormat.Png)
    finally:
        shape_image.dispose()
finally:
    presentation.dispose()

الحصول على الحدود البصرية الفعلية لشكل

تصف خصائص الإطار لكائن Shape—طرق getX، getY، getWidth، وgetHeight——المستطيل المخزن في نموذج العرض. قد يمتد المحتوى المُصوّر فعليًا خارج ذلك الإطار أو يشغل مستطيلًا محاذيًا مختلفًا. يمكن أن تُغيّر الدوران، والحدود، ورؤوس السهام، وتخطيط النص وتدفقه الزائد، والهندسة المولدة لـ SmartArt، وغيرها من تأثيرات التصيير المنطقة المشغولة.

استخدم Shape.getVisualBounds لحساب تلك المنطقة المشغولة دون إنشاء صورة. تُعيد الطريقة كائن Rectangle2D.Float بإحداثيات الشريحة. المستطيل المُعاد ليس مُقتصًا على الشريحة، لذا يمكن أن تكون إحداثياته سالبة عندما يمتد المحتوى خارج أصل الشريحة.

المثال التالي يحصل على الحدود الإطارية والبصرية ويقارنهما:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation
from java.awt.geom import Rectangle2D

presentation = Presentation("example.pptx")
try:
    slide = presentation.getSlides().get_Item(0)
    shape = slide.getShapes().get_Item(0)

    visual_bounds = shape.getVisualBounds()
    frame_bounds = Rectangle2D.Float(shape.getX(), shape.getY(), shape.getWidth(), shape.getHeight())

    print("Frame bounds:", frame_bounds)
    print("Visual bounds:", visual_bounds)
finally:
    presentation.dispose()

يمكن استخدام نفس كائن Rectangle2D.Float لمحاذاة الأشكال القريبة إلى اليسار أو اليمين أو الأعلى أو الأسفل؛ حجز مساحة كافية في تخطيط مُولَّد؛ أو كشف محتوى خارج منطقة مسموح بها. تُعد الحدود البصرية مفيدة خاصةً لـ SmartArt، ومربعات النص، والأسهم، والصور، والأشكال المدورة، ومجموعات الأشكال، حيث قد لا يمثل الإطار المُخزّن النتيجة المصوَّرة بالكامل.

استخدم Shape.getVisualBounds عندما تحتاج إحداثيات للتخطيط أو التحقق ولا تحتاج إلى صورة نقطية. استخدم Shape.getImage عندما تحتاج إلى تصيير الشكل. مع ShapeThumbnailBounds، يُحدد ShapeThumbnailBounds.Shape حجم الصورة من حدود الشكل، بما في ذلك إعدادات الحد، بينما يُحدد ShapeThumbnailBounds.Appearance حجمها من مظهر الشكل ويقيد النتيجة بحدود الشريحة. بالمقابل، تُعيد Shape.getVisualBounds المستطيل المحسوب فقط ولا تقصه إلى الشريحة.

FAQ

ما هي صيغ الصور التي يمكن استخدامها عند حفظ صور مصغرة للأشكال؟

PNG, JPEG, BMP, GIF, TIFF، وغيرها. يمكن أيضًا تصدير الأشكال كـ SVG متجه عن طريق حفظ محتوى الشكل كـ SVG.

ما الفرق بين حدود Shape و Appearance عند تصيير الصورة المصغرة؟

Shape يستخدم هندسة الشكل؛ Appearance يأخذ التأثيرات البصرية (الظلال، الوهج، إلخ) في الاعتبار.

ماذا يحدث إذا تم تحديد شكل كخفي؟ هل سيظل يُصوَّر كصورة مصغرة؟

يبقى الشكل المخفي جزءًا من النموذج ويمكن تصييره؛ علم الإخفاء يؤثر على عرض الشرائح لكنه لا يمنع إنشاء صورة الشكل.

هل يتم دعم الأشكال الجماعية، والرسوم البيانية، وSmartArt، وغيرها من الكائنات المعقدة؟

نعم. أي كائن ممثل كـ Shape (بما في ذلك GroupShape، Chart، وSmartArt) يمكن حفظه كصورة مصغرة أو كـ SVG.

هل تؤثر الخطوط المثبتة على النظام على جودة الصور المصغرة للأشكال النصية؟

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

تطبيق حركات الأشكال في العروض باستخدام Python عبر Java إدارة عناصر تحكم ActiveX في العروض التقديمية باستخدام Python