إطار الصورة

إطار الصورة هو شكل يحتوي على صورة—يشبه الصورة في إطار.

يمكنك إضافة صورة إلى شريحة من خلال إطار الصورة. بهذه الطريقة، يمكنك تنسيق الصورة من خلال تنسيق إطار الصورة.

نصيحة

تقدم Aspose محولات مجانية—JPEG إلى PowerPoint وPNG إلى PowerPoint—تسمح للناس بإنشاء عروض تقديمية بسرعة من الصور.

إنشاء إطار صورة

أنشئ مثيلاً لفئة Presentation .
احصل على مرجع الشريحة من خلال فهرسها.
أنشئ كائن IPPImage من خلال إضافة صورة إلى مجموعة IImagescollection المرتبطة بكائن العرض التقديمي الذي سيتم استخدامه لملء الشكل.
حدد عرض الصورة وارتفاعها.
أنشئ PictureFrame بناءً على عرض الصورة وارتفاعها من خلال طريقة AddPictureFrame المعروضة بواسطة كائن الشكل المرتبط بالشريحة المرجعية.
أضف إطار صورة (يحتوي على الصورة) إلى الشريحة.
اكتب العرض التقديمي المعدل كملف PPTX.

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

import aspose.slides as slides
import aspose.pydrawing as draw

# أنشئ مثيلاً لفئة Presentation التي تمثل ملف PPTX
with slides.Presentation() as pres:
    # احصل على الشريحة الأولى
    sld = pres.slides[0]

    # أنشئ مثيلاً لفئة ImageEx
    with open("img.jpeg", "rb") as in_file:
        image = pres.images.add_image(in_file)

        # أضف إطارًا بارتفاع الصورة وعرضها المكافئ
        pf = sld.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 50, 150, image.width, image.height, image)

        # طبق بعض التنسيق على PictureFrameEx
        pf.line_format.fill_format.fill_type = slides.FillType.SOLID
        pf.line_format.fill_format.solid_fill_color.color = draw.Color.blue
        pf.line_format.width = 20
        pf.rotation = 45

        # اكتب ملف PPTX إلى القرص
        pres.save("RectPicFrameFormat_out.pptx", slides.export.SaveFormat.PPTX)

تسمح لك إطارات الصور بإنشاء شرائح تقديمية بسرعة بناءً على الصور. عند دمج إطار الصورة مع خيارات الحفظ في Aspose.Slides، يمكنك معالجة عمليات الإدخال / الإخراج لتحويل الصور من تنسيق إلى آخر. قد ترغب في رؤية هذه الصفحات: تحويل صورة إلى JPG; تحويل JPG إلى صورة; تحويل JPG إلى PNG، تحويل PNG إلى JPG; تحويل PNG إلى SVG، تحويل SVG إلى PNG.

إنشاء إطار صورة مع مقياس نسبي

من خلال تغيير النسبة المئوية للصورة، يمكنك إنشاء إطار صورة أكثر تعقيدًا.

أنشئ مثيلاً لفئة Presentation.
احصل على مرجع الشريحة من خلال فهرسها.
أضف صورة إلى مجموعة الصور في العرض التقديمي.
أنشئ كائن IPPImage من خلال إضافة صورة إلى مجموعة IImagescollection المرتبطة بكائن العرض التقديمي الذي سيتم استخدامه لملء الشكل.
حدد عرض الصورة وارتفاعها النسبي في إطار الصورة.
اكتب العرض التقديمي المعدل كملف PPTX.

هذا الكود بلغة بايثون يوضح لك كيفية إنشاء إطار صورة مع مقياس نسبي:

import aspose.slides as slides

# أنشئ مثيل لفئة Presentation التي تمثل ملف PPTX
with slides.Presentation() as presentation:
    # يحمل الصورة التي ستضاف إلى مجموعة الصور في العرض التقديمي
    with open("img.jpeg", "rb") as in_file:
        image = presentation.images.add_image(in_file)

        # أضف إطار صورة إلى الشريحة
        pf = presentation.slides[0].shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 50, 50, 100, 100, image)

        # حدد نسبة العرض والارتفاع النسبية
        pf.relative_scale_height = 0.8
        pf.relative_scale_width = 1.35

        # احفظ العرض التقديمي
        presentation.save("Adding Picture Frame with Relative Scale_out.pptx", slides.export.SaveFormat.PPTX)

استخراج صورة من إطار الصورة

يمكنك استخراج الصور من كائنات PictureFrame وحفظها في تنسيقات PNG و JPG وأخرى. المثال البرمجي أدناه يوضح كيفية استخراج صورة من الوثيقة “sample.pptx” وحفظها بتنسيق PNG.

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    first_slide = presentation.slides[0]
    first_shape = first_slide.shapes[0]

    if isinstance(first_shape, slides.PictureFrame):
        image = first_shape.picture_format.picture.image.image
        image.save("slide_1_shape_1.png", slides.ImageFormat.PNG)

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

تسمح لك Aspose.Slides بالحصول على شفافية الصورة. يقوم هذا الكود بلغة بايثون بتوضيح العملية:

import aspose.slides as slides

with slides.Presentation("pres.pptx") as presentation:
    pictureFrame = presentation.slides[0].shapes[0]
    imageTransform = pictureFrame.picture_format.picture.image_transform
    for effect in imageTransform:
        if type(effect) is slides.AlphaModulateFixed:
            transparencyValue = 100 - effect.amount
            print("شفافية الصورة: " + str(transparencyValue))

تنسيق إطار الصورة

تقدم Aspose.Slides العديد من خيارات التنسيق التي يمكن تطبيقها على إطار الصورة. باستخدام هذه الخيارات، يمكنك تعديل إطار الصورة ليطابق متطلبات محددة.

أنشئ مثيل لفئة Presentation .
احصل على مرجع الشريحة من خلال فهرسها.
أنشئ كائن IPPImage من خلال إضافة صورة إلى مجموعة IImagescollection المرتبطة بكائن العرض التقديمي الذي سيتم استخدامه لملء الشكل.
حدد عرض الصورة وارتفاعها.
أنشئ PictureFrame بناءً على عرض الصورة وارتفاعها من خلال طريقة AddPictureFrame المعروضة بواسطة كائن IShapes المرتبط بالشريحة المرجعية.
أضف إطار الصورة (يحتوي على الصورة) إلى الشريحة.
حدد لون خط إطار الصورة.
حدد عرض خط إطار الصورة.
قم بتدوير إطار الصورة بإعطائه قيمة إيجابية أو سلبية.
- القيمة الإيجابية تدور الصورة في اتجاه عقارب الساعة.
- القيمة السلبية تدور الصورة في الاتجاه العكسي.
أضف إطار الصورة (يحتوي على الصورة) إلى الشريحة.
اكتب العرض التقديمي المعدل كملف PPTX.

هذا الكود بلغة بايثون يوضح عملية تنسيق إطار الصورة:

import aspose.slides as slides
import aspose.pydrawing as draw

# أنشئ مثيل لفئة Presentation التي تمثل ملف PPTX
with slides.Presentation() as pres:
    # احصل على الشريحة الأولى
    sld = pres.slides[0]

    with open("img.jpeg", "rb") as in_file:
        imgx = pres.images.add_image(in_file)

        # أضف إطار صورة مع ارتفاع الصورة وعرضها المكافئ
        pf = sld.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 50, 150, imgx.width, imgx.height, imgx)

        # طبق بعض التنسيق على PictureFrameEx
        pf.line_format.fill_format.fill_type = slides.FillType.SOLID
        pf.line_format.fill_format.solid_fill_color.color = draw.Color.blue
        pf.line_format.width = 20
        pf.rotation = 45

    # اكتب ملف PPTX إلى القرص
    pres.save("RectPicFrameFormat_out.pptx", slides.export.SaveFormat.PPTX)

نصيحة

طورت Aspose مؤخرًا صانع الكولاج المجاني. إذا كنت بحاجة إلى دمج صور JPG/JPEG أو صور PNG، إنشاء شبكات من الصور، يمكنك استخدام هذه الخدمة.

إضافة صورة كارتباط

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

import aspose.slides as slides

with slides.Presentation("input.pptx") as presentation:
    shapesToRemove = []

    for autoShape in presentation.slides[0].shapes:
        if autoShape.placeholder is None:
            continue
        
        if autoShape.placeholder.type == slides.PlaceholderType.PICTURE:
            pictureFrame = presentation.slides[0].shapes.add_picture_frame(slides.ShapeType.RECTANGLE,
                    autoShape.x, autoShape.y, autoShape.width, autoShape.height, None)

            pictureFrame.picture_format.picture.link_path_long = \
                "https://upload.wikimedia.org/wikipedia/commons/3/3a/I.M_at_Old_School_Public_Broadcasting_in_October_2016_02.jpg"

            shapesToRemove.append(autoShape)

        elif autoShape.placeholder.type == slides.PlaceholderType.MEDIA:
            videoFrame = presentation.slides[0].shapes.add_video_frame(
                autoShape.X, autoShape.Y, autoShape.width, autoShape.height, "")

            videoFrame.picture_format.picture.link_path_long = \
                "https://upload.wikimedia.org/wikipedia/commons/3/3a/I.M_at_Old_School_Public_Broadcasting_in_October_2016_02.jpg"

            videoFrame.link_path_long = "https://youtu.be/t_1LYZ102RA"
            shapesToRemove.append(autoShape)
        
    

    for shape in shapesToRemove:
        presentation.slides[0].shapes.remove(shape)

    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

قص الصورة

هذا الكود بلغة بايثون يوضح لك كيفية قص صورة موجودة على شريحة:

import aspose.slides as slides

with slides.Presentation() as presentation:
    # إنشاء كائن صورة جديدة
    newImage = presentation.images.add_image(slides.Images.from_file(imagePath))

    # إضافة إطار صورة إلى الشريحة
    picFrame = presentation.slides[0].shapes.add_picture_frame(
        slides.ShapeType.RECTANGLE, 100, 100, 420, 250, newImage)

    # قص الصورة (قيم النسبة المئوية)
    picFrame.picture_format.crop_left = 23.6
    picFrame.picture_format.crop_right = 21.5
    picFrame.picture_format.crop_top = 3
    picFrame.picture_format.crop_bottom = 31

    # احفظ النتيجة
    presentation.save(outPptxFile, slides.export.SaveFormat.PPTX)

حذف المناطق المقصوصة من الصورة

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

هذا الكود بلغة بايثون يوضح العملية:

import aspose.slides as slides

with slides.Presentation(path + "PictureFrameCrop.pptx") as pres:
    slide = pres.slides[0]

    # يحصل على PictureFrame من الشريحة الأولى
    picture_frame = slide.shapes[0]

    # يحذف المناطق المقصوصة من صورة PictureFrame ويعيد الصورة المقصوصة
    cropped_image = picture_frame.picture_format.delete_picture_cropped_areas()

    # احفظ النتيجة
    pres.save(path + "PictureFrameDeleteCroppedAreas.pptx", slides.export.SaveFormat.PPTX)

ملاحظة

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

تقوم هذه الطريقة بتحويل ملفات WMF/EMF إلى صورة PNG نقطية أثناء عملية القص.

قفل نسبة العرض إلى الارتفاع

إذا كنت ترغب في الحفاظ على نسبة العرض إلى الارتفاع لشكل يحتوي على صورة حتى بعد تغيير أبعاد الصورة، يمكنك استخدام خاصية aspect_ratio_locked لتعيين إعداد قفل نسبة العرض إلى الارتفاع.

هذا الكود بلغة بايثون يوضح لك كيفية قفل نسبة العرض إلى الارتفاع لشكل:

from aspose.slides import SlideLayoutType, Presentation, ShapeType
from aspose.pydrawing import Image

with Presentation("pres.pptx") as pres:
    layout = pres.layout_slides.get_by_type(SlideLayoutType.CUSTOM)
    emptySlide = pres.slides.add_empty_slide(layout)
    image = Image.from_file("image.png")
    presImage = pres.images.add_image(image)

    pictureFrame = emptySlide.shapes.add_picture_frame(ShapeType.RECTANGLE, 50, 150, presImage.width, presImage.height, presImage)

    # تعيين الشكل للحفاظ على نسبة العرض إلى الارتفاع عند تغيير الحجم
    pictureFrame.picture_frame_lock.aspect_ratio_locked = True

ملاحظة

يقوم إعداد قفل نسبة العرض إلى الارتفاع بالحفاظ على نسبة العرض إلى الارتفاع فقط للشكل وليس للصورة التي يحتوي عليها.

استخدام خاصية StretchOff

باستخدام خاصيات StretchOffsetLeft و StretchOffsetTop و StretchOffsetRight و StretchOffsetBottom من واجهة IPictureFillFormat وفئة PictureFillFormat ، يمكنك تحديد مستطيل التعبئة.

عند تحديد التجديد لصورة، يتم تغيير حجم المستطيل المصدر ليتناسب مع المستطيل المحدد. يتم تحديد كل حافة من المستطيل التعبوي بواسطة نسبة مئوية من الحافة المقابلة لمربع الشكل. تحدد النسبة المئوية الإيجابية حواف داخلية بينما تحدد النسبة المئوية السلبية حواف خارجية.

أنشئ مثيلاً لفئة Presentation .
احصل على مرجع الشريحة من خلال فهرسها.
أضف شكل AutoShape.
أنشئ صورة.
حدد نوع التعبئة للشكل.
حدد وضع ملء الصورة للشكل.
أضف صورة محددة لملء الشكل.
حدد انزلاقات الصورة من الحافة المقابلة لمربع جوانب الشكل.
اكتب العرض التقديمي المعدل كملف PPTX.

هذا الكود بلغة بايثون يوضح عملية استخدام خاصية StretchOff:

import aspose.slides as slides

# أنشئ مثيل لفئة Presentation التي تمثل ملف PPTX
with slides.Presentation() as pres:

    # احصل على الشريحة الأولى
    slide = pres.slides[0]

    # أنشئ مثيل لفئة ImageEx
    with open("img.jpeg", "rb") as in_file:
        imgx = pres.images.add_image(in_file)

        # أضف إطار صورة مع ارتفاع الصورة وعرضها المكافئ
        shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 100, 100, 300, 300)

        # حدد نوع التعبئة للشكل
        shape.fill_format.fill_type = slides.FillType.PICTURE

        # حدد وضع ملء الصورة للشكل
        shape.fill_format.picture_fill_format.picture_fill_mode = slides.PictureFillMode.STRETCH

        # حدد الصورة لملء الشكل
        shape.fill_format.picture_fill_format.picture.image = imgx

        # حدد انزلاقات الصورة من الحافة المقابلة لمربع جوانب الشكل
        shape.fill_format.picture_fill_format.stretch_offset_left = 25
        shape.fill_format.picture_fill_format.stretch_offset_right = 25
        shape.fill_format.picture_fill_format.stretch_offset_top = -20
        shape.fill_format.picture_fill_format.stretch_offset_bottom = -10
    
    # اكتب ملف PPTX إلى القرص
    pres.save("StretchOffsetLeftForPictureFrame_out.pptx", slides.export.SaveFormat.PPTX)