Рамка для изображения

Рамка для изображения — это фигура, которая содержит изображение, она как картина в рамке.

Вы можете добавить изображение на слайд через рамку для изображения. Таким образом, вы можете отформатировать изображение, отформатировав рамку для изображения.

Совет

Aspose предоставляет бесплатные конвертеры — JPEG в PowerPoint и PNG в PowerPoint, которые позволяют людям быстро создавать презентации из изображений.

Создание рамки для изображения

Создайте экземпляр класса Presentation.
Получите ссылку на слайд по индексу.
Создайте объект IPPImage, добавив изображение в IImagescollection, связанную с объектом презентации, который будет использован для заливки фигуры.
Укажите ширину и высоту изображения.
Создайте PictureFrame на основе ширины и высоты изображения через метод AddPictureFrame, предоставленный объектом фигуры, связанным с указным слайдом.
Добавьте рамку для изображения (содержит картинку) на слайд.
Запишите измененную презентацию в файл PPTX.

Этот код на C# показывает, как создать рамку для изображения:

// Создает экземпляр класса Presentation, представляющего файл PPTX
using (Presentation pres = new Presentation())
{

    // Получает первый слайд
    ISlide sld = pres.Slides[0];

    // Создает экземпляр класса ImageEx
    System.Drawing.Image img = (System.Drawing.Image)new Bitmap("aspose-logo.jpg");
    IPPImage imgx = pres.Images.AddImage(img);

    // Добавляет рамку для изображения с эквивалентной высотой и шириной изображения
    IPictureFrame pf = sld.Shapes.AddPictureFrame(ShapeType.Rectangle, 50, 150, imgx.Width, imgx.Height, imgx);

    // Применяет некоторое форматирование к PictureFrameEx
    pf.LineFormat.FillFormat.FillType = FillType.Solid;
    pf.LineFormat.FillFormat.SolidFillColor.Color = Color.Blue;
    pf.LineFormat.Width = 20;
    pf.Rotation = 45;

    // Записывает PPTX файл на диск
    pres.Save("RectPicFrameFormat_out.pptx", SaveFormat.Pptx);
}

Рамки для изображений позволяют быстро создавать слайды презентаций на основе изображений. Когда вы комбинируете рамку для изображения с параметрами сохранения Aspose.Slides, вы можете манипулировать вводом/выводом, чтобы преобразовывать изображения из одного формата в другой. Вы можете ознакомиться с этими страницами: конвертировать изображение в JPG; конвертировать JPG в изображение; конвертировать JPG в PNG, конвертировать PNG в JPG; конвертировать PNG в SVG, конвертировать SVG в PNG.

Создание рамки для изображения с относительным масштабом

Изменив относительное масштабирование изображения, вы можете создать более сложную рамку для изображения.

Создайте экземпляр класса Presentation.
Получите ссылку на слайд по индексу.
Добавьте изображение в коллекцию изображений презентации.
Создайте объект IPPImage, добавив изображение в IImagescollection, связанную с объектом презентации, который будет использован для заливки фигуры.
Укажите относительную ширину и высоту изображения в рамке для изображения.
Запишите измененную презентацию в файл PPTX.

Этот код на C# показывает, как создать рамку для изображения с относительным масштабом:

// Создает экземпляр класса Presentation, представляющего файл PPTX
using (Presentation presentation = new Presentation())
{

    // Загружает изображение, которое будет добавлено в коллекцию изображений презентации
    Image img = new Bitmap("aspose-logo.jpg");
    IPPImage image = presentation.Images.AddImage(img);

    // Добавляет рамку для изображения на слайд
    IPictureFrame pf = presentation.Slides[0].Shapes.AddPictureFrame(ShapeType.Rectangle, 50, 50, 100, 100, image);

    // Устанавливает относительное значение ширины и высоты
    pf.RelativeScaleHeight = 0.8f;
    pf.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);
    }
}

Получение прозрачности изображения

Aspose.Slides позволяет вам получить прозрачность изображения. Этот код на C# демонстрирует эту операцию:

using (var presentation = new Presentation(folderPath + "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("Прозрачность изображения: " + transparencyValue);
        }
    }
}

Форматирование рамки для изображения

Aspose.Slides предоставляет множество параметров форматирования, которые можно применять к рамке для изображения. Используя эти параметры, вы можете изменить рамку для изображения так, чтобы она соответствовала определенным требованиям.

Создайте экземпляр класса Presentation.
Получите ссылку на слайд по индексу.
Создайте объект IPPImage, добавив изображение в IImagescollection, связанную с объектом презентации, который будет использован для заливки фигуры.
Укажите ширину и высоту изображения.
Создайте PictureFrame на основе ширины и высоты изображения через метод AddPictureFrame, предоставленный объектом IShapes, связанным с указным слайдом.
Добавьте рамку для изображения (содержит картинку) на слайд.
Установите цвет линии рамки для изображения.
Установите ширину линии рамки для изображения.
Поверните рамку для изображения, задав ей положительное или отрицательное значение.
- Положительное значение поворачивает изображение по часовой стрелке.
- Отрицательное значение поворачивает изображение против часовой стрелки.
Добавьте рамку для изображения (содержит картинку) на слайд.
Запишите измененную презентацию в файл PPTX.

Этот код на C# демонстрирует процесс форматирования рамки для изображения:

// Создает экземпляр класса Presentation, представляющего файл PPTX
using (Presentation pres = new Presentation())
{

    // Получает первый слайд
    ISlide sld = pres.Slides[0];

    // Создает экземпляр класса ImageEx
    System.Drawing.Image img = (System.Drawing.Image)new Bitmap("aspose-logo.jpg");
    IPPImage imgx = pres.Images.AddImage(img);

    // Добавляет рамку для изображения с эквивалентной высотой и шириной изображения
    IPictureFrame pf = sld.Shapes.AddPictureFrame(ShapeType.Rectangle, 50, 150, imgx.Width, imgx.Height, imgx);

    // Применяет некоторое форматирование к PictureFrameEx
    pf.LineFormat.FillFormat.FillType = FillType.Solid;
    pf.LineFormat.FillFormat.SolidFillColor.Color = Color.Blue;
    pf.LineFormat.Width = 20;
    pf.Rotation = 45;

    // Записывает PPTX файл на диск
    pres.Save("RectPicFrameFormat_out.pptx", SaveFormat.Pptx);
}

Aspose недавно разработал бесплатный Конструктор Коллажей. Если вам когда-либо нужно будет объединить изображения 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())
{
    // Создает новый объект изображения
    IPPImage newImage = presentation.Images.AddImage(Image.FromFile(imagePath));

    // Добавляет рамку для изображения на слайд
    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. Этот метод возвращает обрезанное изображение или исходное изображение, если обрезка не необходима.

Этот код на C# демонстрирует операцию:

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

    // Получает PictureFrame с первого слайда
    IPictureFrame picFrame = slide.Shapes[0] as IPictureFrame;

    // Удаляет обрезанные области изображения рамки и возвращает обрезанное изображение
    IPPImage croppedImage = picFrame.PictureFormat.DeletePictureCroppedAreas();

    // Сохраняет результат
    presentation.Save("PictureFrameDeleteCroppedAreas.pptx", SaveFormat.Pptx);
}

ПРИМЕЧАНИЕ

Метод IPictureFillFormat.DeletePictureCroppedAreas добавляет обрезанное изображение в коллекцию изображений презентации. Если изображение используется только в обработанной PictureFrame, эта настройка может уменьшить размер презентации. В противном случае количество изображений в результирующей презентации увеличится.

Этот метод преобразует метафайлы WMF/EMF в растровое изображение PNG в процессе обрезки.

Закрепить соотношение сторон

Если вы хотите, чтобы фигура, содержащая изображение, сохраняла свое соотношение сторон даже после изменения размеров изображения, вы можете использовать свойство IPictureFrameLock.AspectRatioLocked для установки параметра Закрепить соотношение сторон.

Этот код на C# показывает, как зафиксировать соотношение сторон фигуры:

using (Presentation pres = new Presentation("pres.pptx"))
{
    ILayoutSlide layout = pres.LayoutSlides.GetByType(SlideLayoutType.Custom);
    ISlide emptySlide = pres.Slides.AddEmptySlide(layout);
    using Image image = Image.FromFile(Path.Combine("image.png"));
    IPPImage presImage = pres.Images.AddImage(image);

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

    // Устанавливает форму для сохранения соотношения сторон при изменении размера
    pictureFrame.PictureFrameLock.AspectRatioLocked = true;
}

ПРИМЕЧАНИЕ

Этот параметр Закрепить соотношение сторон сохраняет только соотношение сторон фигуры, а не изображения, которое она содержит.

Используйте свойство StretchOff

Используя свойства StretchOffsetLeft, StretchOffsetTop, StretchOffsetRight и StretchOffsetBottom интерфейса IPictureFillFormat и класса PictureFillFormat, вы можете задать заполнение прямоугольника.

Когда для изображения установлено масштабирование, исходный прямоугольник масштабируется, чтобы соответствовать указанному прямоугольнику заполнения. Каждый край прямоугольника заполнения определяется процентным смещением от соответствующего края ограничивающей рамки фигуры. Положительный процент указывает на внутреннее смещение, а отрицательный процент — на внешнее смещение.

Создайте экземпляр класса Presentation.
Получите ссылку на слайд по индексу.
Добавьте прямоугольник AutoShape.
Создайте изображение.
Установите тип заливки фигуры.
Установите режим заливки изображения фигуры.
Добавьте установленное изображение для заполнения фигуры.
Укажите смещения изображения от соответствующего края ограничивающей рамки фигуры.
Запишите измененную презентацию в файл PPTX.

Этот код на C# демонстрирует процесс, в котором используется свойство StretchOff:

using (Presentation pres = new Presentation())
{
    IPPImage ppImage;
    using (Image bitmap = new Bitmap("image.png"))
    {
        ppImage = pres.Images.AddImage(bitmap);
    }

    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);
}