إدارة إطارات الصور في العروض التقديمية باستخدام .NET

المقدمة

الإطار هو شكل يحتوي على صورة—وهو مثل صورة داخل إطار.

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

Tip

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

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

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

يعرض لك هذا الكود C# كيفية إنشاء إطار صورة:

// يقوم بإنشاء مثيل لفئة Presentation التي تمثل ملف PPTX
using (Presentation pres = new Presentation())
{
    // يحصل على الشريحة الأولى
    ISlide slide = pres.Slides[0];

    // يحمل صورة ويضيفها إلى مجموعة صور العرض
    IImage image = Images.FromFile("aspose-logo.jpg");
    IPPImage ppImage = pres.Images.AddImage(image);
    image.Dispose();

    // يضيف إطار صورة بالارتفاع والعرض نفسه
    IPictureFrame pictureFrame = slide.Shapes.AddPictureFrame(ShapeType.Rectangle, 50, 150, ppImage.Width, ppImage.Height, ppImage);

    // يطبق بعض التنسيق على إطار الصورة
    pictureFrame.LineFormat.FillFormat.FillType = FillType.Solid;
    pictureFrame.LineFormat.FillFormat.SolidFillColor.Color = Color.Blue;
    pictureFrame.LineFormat.Width = 20;
    pictureFrame.Rotation = 45;

    // يكتب العرض إلى ملف PPTX
    pres.Save("RectPicFrameFormat_out.pptx", SaveFormat.Pptx);
}

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

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

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

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

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

// ينشئ فئة Presentation التي تمثل ملف PPTX
using (Presentation presentation = new Presentation())
{
    // يحمل صورة ويضيفها إلى مجموعة صور العرض
    IImage image = Images.FromFile("aspose-logo.jpg");
    IPPImage ppImage = presentation.Images.AddImage(image);
    image.Dispose();

    // يضيف إطار صورة إلى الشريحة
    IPictureFrame pictureFrame = presentation.Slides[0].Shapes.AddPictureFrame(ShapeType.Rectangle, 50, 50, 100, 100, ppImage);

    // يحدد عرض وارتفاع المقياس النسبي
    pictureFrame.RelativeScaleHeight = 0.8f;
    pictureFrame.RelativeScaleWidth = 1.35f;

    // يحفظ العرض
    presentation.Save("Adding Picture Frame with Relative Scale_out.pptx", SaveFormat.Pptx);
}

استخراج الصور النقطية من أطر الصورة

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

using (var presentation = new Presentation("sample.pptx"))
{
    var firstSlide = presentation.Slides[0];
    var firstShape = firstSlide.Shapes[0];

    if (firstShape is IPictureFrame pictureFrame)
    {
        var image = pictureFrame.PictureFormat.Picture.Image.SystemImage;
        image.Save("slide_1_shape_1.png", ImageFormat.Png);
    }
}

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

عندما يحتوي عرض على رسومات SVG موضوعة داخل أشكال PictureFrame، تسمح لك Aspose.Slides for .NET باستعادة الصور المتجهة الأصلية مع الحفاظ الكامل على الجودة. من خلال استعراض مجموعة أشكال الشريحة، يمكنك تحديد كل PictureFrame، والتحقق مما إذا كان IPPImage الأساسي يحتوي على محتوى SVG، ثم حفظ تلك الصورة إلى قرص أو تدفق بصيغتها الأصلية SVG.

الكود التالي يوضح كيفية استخراج صورة SVG من إطار صورة:

using var presentation = new Presentation("sample.pptx");

var slide = presentation.Slides[0];
var shape = slide.Shapes[0];

if (shape is IPictureFrame pictureFrame)
{
    var svgImage = pictureFrame.PictureFormat.Picture.Image.SvgImage;
    if (svgImage != null)
    {
        File.WriteAllText("output.svg", svgImage.SvgContent);
    }
}

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

تتيح لك Aspose.Slides الحصول على تأثير الشفافية المطبق على صورة. يوضح هذا الكود C# العملية:

using (var presentation = new Presentation("Test.pptx"))
{
    var pictureFrame = (IPictureFrame)presentation.Slides[0].Shapes[0];
    var imageTransform = pictureFrame.PictureFormat.Picture.ImageTransform;
    foreach (var effect in imageTransform)
    {
        if (effect is IAlphaModulateFixed alphaModulateFixed)
        {
            var transparencyValue = 100 - alphaModulateFixed.Amount;
            Console.WriteLine("Picture transparency: " + transparencyValue);
        }
    }
}

الحصول على السطوع والتباين للصورة

تتيح لك Aspose.Slides الحصول على تأثير السطوع والتباين المطبق على صورة. تمثل الواجهة ILuminance هذا التأثير التحويلي للصورة.

يظهر هذا الكود C# كيفية الحصول على إعدادات السطوع والتباين من إطار صورة:

using (var presentation = new Presentation("sample.pptx"))
{
    var slide = presentation.Slides[0];
    var shape = slide.Shapes[0];
    var pictureFrame = (IPictureFrame)shape;

    var imageTransform = pictureFrame.PictureFormat.Picture.ImageTransform;
    foreach (var effect in imageTransform)
    {
        if (effect is ILuminance luminanceEffect)
        {
            var luminance = luminanceEffect.GetEffective();
            var brightness = luminance.Brightness;
            var contrast = luminance.Contrast;

            Console.WriteLine("Brightness: " + brightness);
            Console.WriteLine("Contrast: " + contrast);
        }
    }
}

يمكن العثور على جميع التأثيرات المطبقة على الصور في Aspose.Slides.Effects.

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

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

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

يعرض لك هذا الكود C# عملية تنسيق إطار الصورة:

// ينشئ كائن فئة Presentation التي تمثل ملف PPTX
using (Presentation presentation = new Presentation())
{
    // يحصل على الشريحة الأولى
    ISlide slide = presentation.Slides[0];

    // يحمل صورة ويضيفها إلى مجموعة صور العرض
    IImage image = Images.FromFile("aspose-logo.jpg");
    IPPImage ppImage = presentation.Images.AddImage(image);
    image.Dispose();

    // يضيف إطار صورة بارتفاع وعرض الصورة المتطابقين
    IPictureFrame pictureFrame = slide.Shapes.AddPictureFrame(ShapeType.Rectangle, 50, 150, ppImage.Width, ppImage.Height, ppImage);

    // يطبق بعض التنسيق على إطار الصورة
    pictureFrame.LineFormat.FillFormat.FillType = FillType.Solid;
    pictureFrame.LineFormat.FillFormat.SolidFillColor.Color = Color.Blue;
    pictureFrame.LineFormat.Width = 20;
    pictureFrame.Rotation = 45;

    // يحفظ العرض إلى ملف PPTX
    presentation.Save("RectPicFrameFormat_out.pptx", SaveFormat.Pptx);
}

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

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

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

using (var presentation = new Presentation("input.pptx"))
{
    var shapesToRemove = new List<IShape>();
    int shapesCount = presentation.Slides[0].Shapes.Count;

    for (var i = 0; i < shapesCount; i++)
    {
        var autoShape = presentation.Slides[0].Shapes[i];

        if (autoShape.Placeholder == null)
        {
            continue;
        }

        switch (autoShape.Placeholder.Type)
        {
            case PlaceholderType.Picture:
                var pictureFrame = presentation.Slides[0].Shapes.AddPictureFrame(ShapeType.Rectangle,
                        autoShape.X, autoShape.Y, autoShape.Width, autoShape.Height, null);

                pictureFrame.PictureFormat.Picture.LinkPathLong =
                    "https://upload.wikimedia.org/wikipedia/commons/3/3a/I.M_at_Old_School_Public_Broadcasting_in_October_2016_02.jpg";

                shapesToRemove.Add(autoShape);
                break;

            case PlaceholderType.Media:
                var videoFrame = presentation.Slides[0].Shapes.AddVideoFrame(
                    autoShape.X, autoShape.Y, autoShape.Width, autoShape.Height, "");

                videoFrame.PictureFormat.Picture.LinkPathLong =
                    "https://upload.wikimedia.org/wikipedia/commons/3/3a/I.M_at_Old_School_Public_Broadcasting_in_October_2016_02.jpg";

                videoFrame.LinkPathLong = "https://youtu.be/t_1LYZ102RA";

                shapesToRemove.Add(autoShape);
                break;
        }
    }

    foreach (var shape in shapesToRemove)
    {
        presentation.Slides[0].Shapes.Remove(shape);
    }

    presentation.Save("output.pptx", SaveFormat.Pptx);
}

قص الصور

يظهر هذا الكود C# كيفية قص صورة موجودة على شريحة:

using (Presentation presentation = new Presentation())
{
    // ينشئ كائن صورة جديد
    IImage image = Images.FromFile(imagePath);
    IPPImage newImage = presentation.Images.AddImage(image);
    image.Dispose();

    // يضيف إطار صورة إلى شريحة
    IPictureFrame picFrame = presentation.Slides[0].Shapes.AddPictureFrame(
        ShapeType.Rectangle, 100, 100, 420, 250, newImage);

    // يقص الصورة (قيم النسب المئوية)
    picFrame.PictureFormat.CropLeft = 23.6f;
    picFrame.PictureFormat.CropRight = 21.5f;
    picFrame.PictureFormat.CropTop = 3;
    picFrame.PictureFormat.CropBottom = 31;

    // يحفظ النتيجة
    presentation.Save("PictureFrameCrop.pptx", SaveFormat.Pptx);
}

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

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

using (Presentation presentation = new Presentation("PictureFrameCrop.pptx"))
{
    ISlide slide = presentation.Slides[0];

    // يحصل على إطار الصورة من الشريحة الأولى
    IPictureFrame picFrame = slide.Shapes[0] as IPictureFrame;

    // يحذف المناطق المقصوصة من صورة إطار الصورة ويعيد الصورة المقصوصة
    IPPImage croppedImage = picFrame.PictureFormat.DeletePictureCroppedAreas();

    // يحفظ النتيجة
    presentation.Save("PictureFrameDeleteCroppedAreas.pptx", SaveFormat.Pptx);
}

NOTE

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

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

ضغط الصور

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

تقوم بتعديل حجم الصورة ودقتها بطريقة مماثلة لميزة PowerPoint Picture Format → Compress Pictures → Resolution.

توضح الأمثلة التالية بلغة C# كيفية ضغط صورة في عرض عن طريق تحديد دقة مستهدفة وحذف المناطق المقصوصة اختياريًا:

using (Presentation presentation = new Presentation("demo.pptx"))
{
    ISlide slide = presentation.Slides[0];
    IPictureFrame pictureFrame = slide.Shapes[0] as IPictureFrame;

    // ضغط الصورة بدقة مستهدفة 150 DPI (دقة الويب) وإزالة المناطق المقصوصة.
    bool result = pictureFrame.PictureFormat.CompressImage(true, PicturesCompression.Dpi150);

    // تحقق من نتيجة الضغط.
    if (result)
    {
        Console.WriteLine("Image successfully compressed.");
    }
    else
    {
        Console.WriteLine("Image compression failed or no changes were necessary.");
    }

    presentation.Save("CompressedImage.pptx", SaveFormat.Pptx);
}

أو باستخدام قيمة DPI مخصصة مباشرةً:

using (Presentation presentation = new Presentation("demo.pptx"))
{
    ISlide slide = presentation.Slides[0];
    IPictureFrame pictureFrame = slide.Shapes[0] as IPictureFrame;

    // ضغط الصورة إلى 150 DPI (دقة الويب)، وإزالة المناطق المقصوصة.
    pictureFrame.PictureFormat.CompressImage(true, 150f);

    presentation.Save("CompressedImage.pptx", SaveFormat.Pptx);
}

NOTE

تحول الطريقة الصورة إلى دقة أقل استنادًا إلى حجم الشكل وDPI المقدم. يمكن أيضًا حذف المناطق المقصوصة لتحسين حجم الملف. إذا كانت الصورة ملفًا ميتاً (WMF/EMF) أو SVG، لن يتم تطبيق الضغط. كما يتم الحفاظ على جودة JPEG أو تقليلها قليلاً وفقًا للدقة، كما هو الحال في PowerPoint عند معالجة JPEG عالي الدقة.

قفل نسبة الأبعاد

إذا رغبت في أن يحتفظ الشكل الذي يحتوي على صورة بنسبة أبعاده حتى بعد تغيير أبعاد الصورة، يمكنك استخدام الخاصية IPictureFrameLock.AspectRatioLocked لضبط إعداد Lock Aspect Ratio.

يظهر لك هذا الكود C# كيفية قفل نسبة أبعاد الشكل:

using (Presentation pres = new Presentation("pres.pptx"))
{
    ILayoutSlide layout = pres.LayoutSlides.GetByType(SlideLayoutType.Custom);
    ISlide emptySlide = pres.Slides.AddEmptySlide(layout);

    IImage image = Images.FromFile("image.png");
    IPPImage presImage = pres.Images.AddImage(image);
    image.Dispose();

    IPictureFrame pictureFrame = emptySlide.Shapes.AddPictureFrame(ShapeType.Rectangle, 50, 150, presImage.Width, presImage.Height, presImage);

    // يضبط الشكل للحفاظ على نسبة الأبعاد عند التحجيم
    pictureFrame.PictureFrameLock.AspectRatioLocked = true;
}

NOTE

يحافظ هذا الإعداد Lock Aspect Ratio على نسبة أبعاد الشكل فقط ولا يؤثر على الصورة التي يحتويها.

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

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

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

إنشاء نسخة من فئة Presentationclass.
احصل على مرجع الشريحة عبر فهرستها.
إضافة مستطيل AutoShape.
إنشاء صورة.
تعيين نوع ملء الشكل.
تعيين وضع ملء صورة الشكل.
إضافة صورة للملء.
تحديد إزاحات الصورة من الحافة المقابلة لمربع حدود الشكل.
احفظ العرض المعدل كملف PPTX.

يعرض لك هذا الكود C# عملية استخدام خاصية StretchOff:

using (Presentation pres = new Presentation())
{
    IImage image = Images.FromFile("image.png");
    IPPImage ppImage = pres.Images.AddImage(image);
    image.Dispose();

    IPictureFrame pictureFrame = pres.Slides[0].Shapes.AddPictureFrame(ShapeType.Rectangle, 10, 10, 400, 400, ppImage);

    // يضبط تمديد الصورة من كل جانب في جسم الشكل
    pictureFrame.PictureFormat.PictureFillMode = PictureFillMode.Stretch;
    pictureFrame.PictureFormat.StretchOffsetLeft = 24;
    pictureFrame.PictureFormat.StretchOffsetRight = 24;
    pictureFrame.PictureFormat.StretchOffsetTop = 24;
    pictureFrame.PictureFormat.StretchOffsetBottom = 24;

    pres.Save("imageStretch.pptx", SaveFormat.Pptx);
}

الأسئلة المتكررة

كيف يمكنني معرفة صيغ الصور المدعومة لإطار الصورة؟
يدعم Aspose.Slides كلًا من الصور النقطية (PNG، JPEG، BMP، GIF، إلخ) والصور المتجهة (مثل SVG) عبر كائن الصورة المخصص لـPictureFrame. تتقاطع قائمة الصيغ المدعومة عمومًا مع إمكانات محرك تحويل الشرائح والصور.

كيف سيؤثر إضافة عشرات الصور الكبيرة على حجم وأداء ملف PPTX؟
تزيد تضمين الصور الكبيرة من حجم الملف واستهلاك الذاكرة؛ بينما يساعد ربط الصور على تقليل حجم العرض لكنه يتطلب بقاء الملفات الخارجية متوفرة. يوفر Aspose.Slides إمكانية إضافة الصور عبر روابط لتقليل حجم الملف.

كيف يمكنني قفل كائن صورة لمنع التحريك/إعادة التحجيم غير المقصود؟
استخدم قفل الأشكال لـPictureFrame (مثال: تعطيل التحريك أو التحجيم). يُشرح آلية القفل للأشكال في مقالة الحماية المستقلة [/slides/ar/net/applying-protection-to-presentation/] وتدعم أنواعًا متعددة من الأشكال بما فيها PictureFrame.

هل يتم الحفاظ على دقة SVG المتجهة عند تصدير العرض إلى PDF/الصور؟
تتيح Aspose.Slides استخراج SVG من PictureFrame كمتجه أصلي. عند التصدير إلى PDF أو الصيغ النقطية، قد يتم تحويله إلى نقطية اعتمادًا على إعدادات التصدير؛ لكن سلوك الاستخراج يؤكد أن SVG الأصلي يبقى متجهًا.