إنشاء تأثيرات ثلاثية الأبعاد في العروض التقديمية باستخدام بايثون
نظرة عامة
Aspose.Slides for Python via .NET يمكنه إنشاء وتحرير وحفظ وعرض تنسيق ثلاثي الأبعاد بنمط PowerPoint للأشكال والنص. يغطي هذا المقال تأثيرات ثلاثية الأبعاد مثل الدوران، البثق، الحواف المحدبة، الإضاءة، المادة، التعبئة بالتدرج أو الصورة، والنص ثلاثي الأبعاد.
Note
هذه المقالة تتناول تأثيرات تنسيق ثلاثي الأبعاد على أشكال ونص PowerPoint. لا تتعلق بإدراج أو تحرير ملفات نماذج ثلاثية الأبعاد مستقلة. عند تصدير شريحة إلى صورة أو PDF أو HTML، يقوم Aspose.Slides بتحويل تلك التأثيرات ثلاثية الأبعاد إلى ناتج ثنائي الأبعاد مُصدَّر.مفاهيم تنسيق ثلاثي الأبعاد
استخدم الخاصية Shape.three_d_format لتطبيق تنسيق ثلاثي الأبعاد على شكل. تكشف الخاصية عن ThreeDFormat، الذي يتحكم في المشهد الثلاثي الأبعاد لذلك الشكل.
للنص، استخدم الخاصية TextFrameFormat.three_d_format . هذا يطبق تنسيق ثلاثي الأبعاد على إطار النص بدلاً من جسم الشكل.
أهم الخصائص هي:
| الخاصية | ما الذي تتحكم فيه | متى يتم استخدامها |
|---|---|---|
| camera | نقطة المشهد، نوع الكاميرا المسبق، الدوران، التكبير، والمنظور. | تدوير الكائن في الفضاء الثلاثي الأبعاد أو محاكاة إعداد دوران ثلاثي الأبعاد مسبق في PowerPoint. |
| light_rig | إعداد إضاءة مسبق، الاتجاه، ودوران الضوء. | تعديل مظهر الإضاءات والظلال على السطح الثلاثي الأبعاد. |
| material | مادة السطح، مثل مسطح، مطفي، بلاستيك أو معدن. | جعل الشكل نفسه يبدو أكثر تسطحًا أو نعومة أو لمعانًا أو معدنًا. |
| extrusion_height | مقدار امتداد الشكل إلى الخلف من وجهه الأمامي. | تحويل شكل مسطح إلى كائن ثلاثي الأبعاد سميك مرئي. |
| extrusion_color | لون الجوانب المُبثقة. | إظهار العمق أو توحيد لون الجوانب مع التعبئة الأمامية. |
| depth | عمق ثلاثي أبعاد إضافي يستخدمه تنسيق ثلاثي الأبعاد في PowerPoint. | ضبط العمق بدقة للأشكال أو النص، خاصةً مع إعدادات الحافة والمادة. |
| bevel_top و bevel_bottom | حواف مرتفعة أو مستديرة على الوجوه الأمامية والخلفية. | إضافة حافة ناعمة أو مُقوَّسة بدلاً من وجه مسطح حاد. |
| contour_color و contour_width | الخط الخارجي حول الكائن الثلاثي الأبعاد. | توضيح حدود الكائن في المخرجات المُرسَّمة. |
إنشاء شكل ثلاثي الأبعاد
عادةً ما يحتاج الشكل إلى أربعة أنواع من الإعدادات قبل أن يبدو ثلاثيًا بشكل مقنع:
- إعدادات الكاميرا، لأن العرض الأمامي الافتراضي قد يخفي البثق.
- إعدادات الإضاءة، لأن الإضاءة تجعل الوجوه والجوانب مقروءة.
- إعدادات المادة، لأن السطح يؤثر على كيفية إظهار الضوء.
- إعدادات البثق أو العمق، لأن الشكل المسطح يحتاج إلى سماكة.
المثال التالي يُنشئ مستطيلًا، يضيف نصًا إلى وجهه الأمامي، ويطبق تنسيقًا ثلاثيًا الأبعاد. قيم دوران الكاميرا بالدرجة، وارتفاع البثق 100 نقطة. يقوم المثال برسم الشريحة إلى صورة PNG بمقاس مرتين الأبعاد الافتراضية ويحفظ العرض التقديمي كملف PPTX.
import aspose.pydrawing as drawing
import aspose.slides as slides
image_scale = 2
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 150, 200, 200)
shape.text_frame.text = "3D"
shape.text_frame.paragraphs[0].paragraph_format.default_portion_format.font_height = 64
shape.fill_format.fill_type = slides.FillType.SOLID
shape.fill_format.solid_fill_color.color = drawing.Color.cornflower_blue
shape.three_d_format.camera.camera_type = slides.CameraPresetType.ORTHOGRAPHIC_FRONT
shape.three_d_format.camera.set_rotation(20, 30, 40)
shape.three_d_format.light_rig.light_type = slides.LightRigPresetType.FLAT
shape.three_d_format.light_rig.direction = slides.LightingDirection.TOP
shape.three_d_format.material = slides.MaterialPresetType.FLAT
shape.three_d_format.extrusion_height = 100
shape.three_d_format.extrusion_color.color = drawing.Color.blue
with slide.get_image(image_scale, image_scale) as thumbnail:
thumbnail.save("shape_3d.png")
presentation.save("shape_3d.pptx", slides.export.SaveFormat.PPTX)
الصورة المرسومة للشرائح تُظهر المستطيل ككتلة ثلاثية الأبعاد سميكة:

دوران الشكل باستخدام الكاميرا
في PowerPoint، يتم تكوين الدوران الثلاثي الأبعاد من خلال لوحة 3‑D Rotation. قيم الدوران X وY وZ تقابل ما تُحدده عبر واجهة برمجة تطبيقات الكاميرا.

في Aspose.Slides، يتم الوصول إلى الكاميرا عبر ThreeDFormat.camera. هذا المثال يُنشئ مستطيلًا، يختار عرضًا أماميًا أورثوغرافيًا، ويضبط دورانات X وY وZ إلى 20 و30 و40 درجة على الترتيب. يكوّن الشكل في الذاكرة دون حفظ ملف:
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 150, 200, 200)
shape.three_d_format.camera.camera_type = slides.CameraPresetType.ORTHOGRAPHIC_FRONT
shape.three_d_format.camera.set_rotation(20, 30, 40)
استخدم الكاميرا عندما تحتاج لتغيير طريقة رؤية المشاهد للكائن. لا يغيّر ذلك هندسة الشكل الثنائي الأبعاد على الشريحة؛ بل يغيّر منظور العرض الثلاثي الأبعاد الذي يستخدمه PowerPoint وAspose.Slides عند الرسم.
نسخ توجيه الكاميرا من شكل قالب
لمطابقة توجيه شكل القالب، انسخ إعداد camera_type المسبق واقرأ دورانه باستخدام get_rotation. يفتح المثال template.pptx وينسخ توجيه الكاميرا من الشكل الأول على الشريحة الأولى إلى الشكل الثاني. كلا الشكلين لديهما إضاءة ثلاثية الأبعاد مسبقة، والشكل الثاني لا يملك دوران كاميرا صريح.
القيم بالدرجة. الفهارس 0 و1 و2 تمثل العرض، الطول، والثورة على الترتيب. مرّرها إلى set_rotation بهذا الترتيب. إذا لم يكن للمصدر دوران صريح، يُعيد get_rotation القيمة None، لذا اترك الزوايا الوجهة غير مُحددة. إذا عيّن المصدر جميع الزوايا الثلاثة إلى صفر صراحةً، انسخ تلك الصفرات.
import aspose.slides as slides
with slides.Presentation("template.pptx") as presentation:
shapes = presentation.slides[0].shapes
source_camera = shapes[0].three_d_format.camera
destination_camera = shapes[1].three_d_format.camera
destination_camera.camera_type = source_camera.camera_type
angles = source_camera.get_rotation()
if angles is not None:
destination_camera.set_rotation(angles[0], angles[1], angles[2])
presentation.save("camera-copy.pptx", slides.export.SaveFormat.PPTX)
عند إعادة فتح camera-copy.pptx في PowerPoint، يحمل الشكلان نفس إعداد الكاميرا والدوران. السهم على اليمين يستخدم التوجيه المنسوخ من المستطيل على اليسار. كلا الشكلين يستخدمان نفس الإضاءة وعمق البثق.

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

عيّن ThreeDFormat.extrusion_height للسُمك وThreeDFormat.extrusion_color للون الجوانب. المثال التالي يمنح المستطيل بُثقًا بارتفاع 100 نقطة وجوانب بنفسجية ويُدوّر الكاميرا لإظهار السمك. يكوّن الشكل في الذاكرة دون حفظ ملف:
import aspose.pydrawing as drawing
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 150, 200, 200)
shape.three_d_format.camera.camera_type = slides.CameraPresetType.ORTHOGRAPHIC_FRONT
shape.three_d_format.camera.set_rotation(20, 30, 40)
shape.three_d_format.light_rig.light_type = slides.LightRigPresetType.FLAT
shape.three_d_format.light_rig.direction = slides.LightingDirection.TOP
shape.three_d_format.material = slides.MaterialPresetType.FLAT
shape.three_d_format.extrusion_height = 100
shape.three_d_format.extrusion_color.color = drawing.Color.purple
خاصية ThreeDFormat.depth تُحدد عمق الشكل الثلاثي الأبعاد. خاصية extrusion_height تتحكم في ارتفاع تأثير البثق، كما هو موضح في هذا المثال.
استخدام تعبئة بالتدرج أو صورة مع تأثيرات ثلاثية الأبعاد
تنسيق ثلاثي الأبعاد مستقل عن تعبئة الشكل. يمكنك تطبيق لون صلب أو تدرج أو نمط أو تعبئة صورة على الوجه الأمامي مع الاستمرار في استخدام نفس إعدادات الكاميرا والإضاءة والمادة والبثق.
هذا المثال يطبق تدرجًا من الأزرق إلى البرتقالي على الوجه الأمامي ولونًا برتقاليًا داكنًا على البثق بارتفاع 150 نقطة. توقِّفات التدرج عند 0 و100 تمثل بداية ونهاية التدرج. قيم دوران الكاميرا بالدرجة. تُرسم الشريحة إلى صورة PNG بمقاس مرتين الأبعاد الافتراضية:
import aspose.pydrawing as drawing
import aspose.slides as slides
image_scale = 2
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 150, 250, 250)
shape.text_frame.text = "3D Gradient"
shape.text_frame.paragraphs[0].paragraph_format.default_portion_format.font_height = 64
shape.fill_format.fill_type = slides.FillType.GRADIENT
shape.fill_format.gradient_format.gradient_stops.add(0, drawing.Color.blue)
shape.fill_format.gradient_format.gradient_stops.add(100, drawing.Color.orange)
shape.three_d_format.camera.camera_type = slides.CameraPresetType.ORTHOGRAPHIC_FRONT
shape.three_d_format.camera.set_rotation(10, 20, 30)
shape.three_d_format.light_rig.light_type = slides.LightRigPresetType.FLAT
shape.three_d_format.light_rig.direction = slides.LightingDirection.TOP
shape.three_d_format.material = slides.MaterialPresetType.FLAT
shape.three_d_format.extrusion_height = 150
shape.three_d_format.extrusion_color.color = drawing.Color.dark_orange
with slide.get_image(image_scale, image_scale) as thumbnail:
thumbnail.save("gradient_3d.png")
الناتج المرسوم يحتفظ بالتدرج على الوجه الأمامي ويُظهر البثق بشكل منفصل:

لاستخدام تعبئة صورة، أضف الصورة إلى العرض التقديمي وعينها كملء للشكل. يتطلب المثال وجود ملف اسمه “image.jpg” في دليل العمل. يُمدّ الصورة لتملأ المستطيل، يضيف بُثقًا بارتفاع 150 نقطة، ويُعيّن دوران الكاميرا بالدرجة. يكوّن الشكل في الذاكرة دون حفظ أو رسم ملف:
import aspose.pydrawing as drawing
import aspose.slides as slides
with open("image.jpg", "rb") as image_file:
image_data = image_file.read()
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 150, 250, 250)
image = presentation.images.add_image(image_data)
shape.fill_format.fill_type = slides.FillType.PICTURE
shape.fill_format.picture_fill_format.picture.image = image
shape.fill_format.picture_fill_format.picture_fill_mode = slides.PictureFillMode.STRETCH
shape.three_d_format.camera.camera_type = slides.CameraPresetType.ORTHOGRAPHIC_FRONT
shape.three_d_format.camera.set_rotation(10, 20, 30)
shape.three_d_format.light_rig.light_type = slides.LightRigPresetType.FLAT
shape.three_d_format.light_rig.direction = slides.LightingDirection.TOP
shape.three_d_format.material = slides.MaterialPresetType.FLAT
shape.three_d_format.extrusion_height = 150
shape.three_d_format.extrusion_color.color = drawing.Color.dark_orange
الصورة تُرسم على الوجه الأمامي، بينما يُرسم البثق كسطح جانبي ثلاثي الأبعاد:

تطبيق تنسيق ثلاثي الأبعاد على النص
تنسيق ثلاثي الأبعاد للشكل يؤثر على جسم الشكل. تنسيق ثلاثي الأبعاد للنص يؤثر على إطار النص. هذا مفيد لتأثيرات WordArt حيث تحتاج الحروف نفسها إلى بُثق، مادة، إضاءة، وإعدادات كاميرا.
المثال التالي يُنشئ نصًا بنمط شبكة برتقالي-أبيض، يضيف قوسًا صاعدًا، ويكوّن إعدادات ثلاثية الأبعاد عبر TextFrameFormat.three_d_format. ارتفاع البثق والعمق بالنقاط، ودوران الضوء بالدرجة. يُخفى ملء الشكل والحد لتظهر النص فقط. يرسم المثال صورة PNG بمقاس مرتين أبعاد الشريحة الافتراضية ويحفظ العرض التقديمي كـ PPTX:
import aspose.pydrawing as drawing
import aspose.slides as slides
image_scale = 2
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 150, 250, 250)
shape.fill_format.fill_type = slides.FillType.NO_FILL
shape.line_format.fill_format.fill_type = slides.FillType.NO_FILL
shape.text_frame.text = "3D Text"
portion = shape.text_frame.paragraphs[0].portions[0]
portion.portion_format.fill_format.fill_type = slides.FillType.PATTERN
portion.portion_format.fill_format.pattern_format.fore_color.color = drawing.Color.dark_orange
portion.portion_format.fill_format.pattern_format.back_color.color = drawing.Color.white
portion.portion_format.fill_format.pattern_format.pattern_style = slides.PatternStyle.LARGE_GRID
shape.text_frame.paragraphs[0].paragraph_format.default_portion_format.font_height = 128
text_frame_format = shape.text_frame.text_frame_format
text_frame_format.transform = slides.TextShapeType.ARCH_UP
text_frame_format.three_d_format.extrusion_height = 3.5
text_frame_format.three_d_format.depth = 3
text_frame_format.three_d_format.material = slides.MaterialPresetType.PLASTIC
text_frame_format.three_d_format.light_rig.direction = slides.LightingDirection.TOP
text_frame_format.three_d_format.light_rig.light_type = slides.LightRigPresetType.BALANCED
text_frame_format.three_d_format.light_rig.set_rotation(0, 0, 40)
text_frame_format.three_d_format.camera.camera_type = slides.CameraPresetType.PERSPECTIVE_CONTRASTING_RIGHT_FACING
with slide.get_image(image_scale, image_scale) as thumbnail:
thumbnail.save("text_3d.png")
presentation.save("text_3d.pptx", slides.export.SaveFormat.PPTX)
النص يُرسم كحروف ثلاثية الأبعاد منحنية ومبثقة:

الحفاظ على نص مسطح على شكل ثلاثي الأبعاد
للحفاظ على قابلية قراءة النص مع الحفاظ على مظهر الشكل الثلاثي الأبعاد، عيّن TextFrameFormat.keep_text_flat عبر TextFrame.text_frame_format. عندما تكون القيمة True، يبقى النص خارج المشهد الثلاثي الأبعاد. عندما تكون False، يشارك النص في المشهد ويتبع توجيه 3D.
هذا الإعداد لا يزيل تنسيق ثلاثي الأبعاد للشكل: الكاميرا، الإضاءة، المادة، والبثق لا يزالون مكوَّنين عبر Shape.three_d_format. وهو مختلف عن الدوران العادي. Shape.rotation يدور الشكل في مستوى الشريحة، بينما TextFrameFormat.rotation_angle يتحكم في دوران النص داخل الصندوق المحيط به. إبقاء النص خارج المشهد لا يعيد ضبط أي من تلك الزوايا.
المثال المستقل التالي يُنشئ مستطيلًا أزرقًا بنص، ثم ينسخه بجانب الأصل. كلا الشكلين لهما نفس تنسيق 3D؛ الاختلاف فقط في إعداد النص: False على اليسار وTrue على اليمين. زوايا الكاميرا بالدرجة، وارتفاع البثق 40 نقطة. يحفظ المثال العرض التقديمي كـ PPTX ويرسم شريحة المقارنة إلى PNG بمقاس مرتين الأبعاد الافتراضية.
import aspose.pydrawing as drawing
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 70, 160, 240, 140)
shape.text_frame.text = "Readable text"
shape.text_frame.paragraphs[0].paragraph_format.default_portion_format.font_height = 28
shape.text_frame.paragraphs[0].paragraph_format.alignment = slides.TextAlignment.CENTER
shape.text_frame.text_frame_format.anchoring_type = slides.TextAnchorType.CENTER
shape.fill_format.fill_type = slides.FillType.SOLID
shape.fill_format.solid_fill_color.color = drawing.Color.cornflower_blue
shape.three_d_format.camera.camera_type = slides.CameraPresetType.ORTHOGRAPHIC_FRONT
shape.three_d_format.camera.set_rotation(30, 30, 0)
shape.three_d_format.light_rig.light_type = slides.LightRigPresetType.FLAT
shape.three_d_format.light_rig.direction = slides.LightingDirection.TOP
shape.three_d_format.material = slides.MaterialPresetType.FLAT
shape.three_d_format.extrusion_height = 40
shape.three_d_format.extrusion_color.color = drawing.Color.royal_blue
shape.text_frame.text_frame_format.keep_text_flat = False
flat_text_shape = slide.shapes.add_clone(shape, 400, 160)
flat_text_shape.text_frame.text_frame_format.keep_text_flat = True
presentation.save("keep_text_flat.pptx", slides.export.SaveFormat.PPTX)
with slide.get_image(2, 2) as image:
image.save("keep_text_flat.png")
على اليسار، يتبع النص توجيه 3D. على اليمين يبقى مسطحًا وأسهل قراءة. كلا المستطيلين يحتفظان بنفس البثق المرئي وتوجيه 3D.

السلوك عند التصدير والرسم
يحافظ Aspose.Slides على تنسيق ثلاثي الأبعاد عند الحفظ بصيغ PowerPoint مثل PPTX. عند الرسم أو التصدير إلى صيغ ثابتة، يتم تحويل المشهد الثلاثي الأبعاد إلى صورة ثنائية الأبعاد في الناتج. ينطبق ذلك عندما تُرسم الشرائح إلى PNG، أو تُصدّر إلى PDF، أو إلى HTML، أو تُولّد إطارات لتحويل الفيديو.
احرص على ما يلي:
- الصور وملفات PDF المُصدَّرة غير تفاعلية. لا يمكن للمستخدم تدوير الكائن بعد التصدير.
- المظهر النهائي يعتمد على مزيج الكاميرا، مجموعة الإضاءة، المادة، البثق، التعبئة، وتكبير الشريحة.
- إذا احتجت لقراءة القيم الموروثة أو المستندة إلى السمة، استخدم effective shape properties.
- بعض صيغ الإخراج لا يمكنها تخزين تنسيق 3D القابل للتحرير في PowerPoint. في تلك الصيغ، يُرسم الناتج بصريًا بدلاً من حفظه كإعدادات 3D قابلة للتعديل.
الأسئلة المتكررة
هل يمكن لـ Aspose.Slides إنشاء عروض تقديمية ثلاثية الأبعاد تفاعلية؟
يُنشئ Aspose.Slides ويُظهر تأثيرات 3D في PowerPoint للأشكال والنص. لا يجعل الصور أو ملفات PDF أو صفحات HTML مشاهد 3D تفاعلية يمكن للمستخدم تدويرها. في PPTX، يبقى تنسيق 3D قابلًا للتحرير في PowerPoint حيث تدعم الصيغة ذلك.
ما الفرق بين النموذج ثلاثي الأبعاد والتأثير ثلاثي الأبعاد؟
النموذج ثلاثي الأبعاد هو كائن ثلاثي أبعاد مستقل يُدرج في العرض. التأثير ثلاثي الأبعاد هو تنسيق يُطبق على شكل أو نص PowerPoint عادي، مثل الدوران، البثق، الحافة، الإضاءة، والمادة. تغطي هذه المقالة تأثيرات 3D.
ما الإعدادات المطلوبة للحصول على شكل ثلاثي الأبعاد مرئي؟
على الأقل، عيّن دوران كاميرا وإما بُثق أو عمق. عمليًا، يُفضَّل أيضًا تعيين مجموعة إضاءة ومادة لكي تظهر الوجوه المُرسَّمة بوضوح مع إضاءات وظلال.
هل يمكنني تطبيق تأثيرات 3D على الأشكال والنص معًا؟
نعم. استخدم Shape.three_d_format لجسم الشكل وTextFrameFormat.three_d_format للنص.
هل ستظهر تأثيرات 3D عند التصدير إلى صور أو PDF أو HTML أو إطارات الفيديو؟
نعم. يرسم Aspose.Slides تأثيرات 3D عند إنتاج صور الشرائح، مخرجات PDF، مخرجات HTML، وإطارات الفيديو. يحتوي الناتج المُصدَّر على المظهر المرسوم، وليس كائنًا ثلاثيًا قابلاً للتحرير.
هل يمكنني قراءة القيم النهائية لـ 3D بعد تطبيق الوراثة وإعدادات السمة؟
نعم. استخدم واجهات برمجة التطبيقات للتنسيق الفعّال الواردة في Shape Effective Properties لقراءة الكاميرا النهائية، مجموعة الإضاءة، الحافة، والقيم الثلاثية الأبعاد ذات الصلة.