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

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

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

Совет

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

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

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

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

// Создает экземпляр класса Presentation, который представляет файл PPTX
Presentation pres = new Presentation();
try {
    // Получает первый слайд
    ISlide sld = pres.getSlides().get_Item(0);
    
    // Создает экземпляр класса Image
    IPPImage imgx = pres.getImages().addImage(new FileInputStream(new File("asp1.jpg")));
    
    // Добавляет рамку для изображения с высотой и шириной, эквивалентными изображению
    sld.getShapes().addPictureFrame(ShapeType.Rectangle, 50, 150, imgx.getWidth(), imgx.getHeight(), imgx);
    
    // Записывает файл PPTX на диск
    pres.save("RectPicFrame.pptx", SaveFormat.Pptx);
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

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

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

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

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

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

// Создает экземпляр класса Presentation, который представляет PPTX
Presentation pres = new Presentation();
try {
    // Получает первый слайд
    ISlide sld = pres.getSlides().get_Item(0);
    
    // Создает экземпляр класса Image
    IPPImage imgx = pres.getImages().addImage(new FileInputStream(new File("asp1.jpg")));
    
    
    // Добавляет рамку для изображения с высотой и шириной, эквивалентными изображению
    IPictureFrame pf = sld.getShapes().addPictureFrame(ShapeType.Rectangle, 50, 150, imgx.getWidth(), imgx.getHeight(), imgx);
    
    // Устанавливает относительное масштабирование ширины и высоты
    pf.setRelativeScaleHeight(0.8f);
    pf.setRelativeScaleWidth(1.35f);
    
    // Записывает файл PPTX на диск
    pres.save("RectPicFrame.pptx", SaveFormat.Pptx);
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

Извлечение изображения из рамки для изображения

Вы можете извлекать изображения из объектов PictureFrame и сохранять их в формате PNG, JPG и других форматах. Пример кода ниже демонстрирует, как извлечь изображение из документа “sample.pptx” и сохранить его в формате PNG.

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

try {
    ISlide firstSlide = presentation.getSlides().get_Item(0);
    IShape firstShape = firstSlide.getShapes().get_Item(0);

    if (firstShape instanceof IPictureFrame) {
        IPictureFrame pictureFrame = (IPictureFrame) firstShape;
        try {
                IImage slideImage = pictureFrame.getPictureFormat().getPicture().getImage().getImage();
                slideImage.save("slide_1_shape_1.png", ImageFormat.Png);
            } finally {
                     if (slideImage != null) slideImage.dispose();
                 }
    }
} catch (IOException e) {
} finally {
    presentation.dispose();
}

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

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

Presentation presentation = new Presentation(folderPath + "Test.pptx");

var pictureFrame = (IPictureFrame) presentation.getSlides().get_Item(0).getShapes().get_Item(0);
var imageTransform = pictureFrame.getPictureFormat().getPicture().getImageTransform();
for (var effect : imageTransform) {
    if (effect instanceof IAlphaModulateFixed) {
        var alphaModulateFixed = (IAlphaModulateFixed) effect;
        var transparencyValue = 100 - alphaModulateFixed.getAmount();
        System.out.println("Прозрачность картинки: " + transparencyValue);
    }
}

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

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

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

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

// Создает экземпляр класса Presentation, который представляет PPTX
Presentation pres = new Presentation();
try {
    // Получает первый слайд
    ISlide sld = pres.getSlides().get_Item(0);
    
    // Создает экземпляр класса Image
    IPPImage imgx = pres.getImages().addImage(new FileInputStream(new File("asp1.jpg")));
    
    // Добавляет рамку для изображения с высотой и шириной, эквивалентными изображению
    IPictureFrame pf = sld.getShapes().addPictureFrame(ShapeType.Rectangle, 50, 150, imgx.getWidth(), imgx.getHeight(), imgx);
    
    // Применяет некоторые форматы к PictureFrameEx
    pf.getLineFormat().getFillFormat().setFillType(FillType.Solid);
    pf.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.BLUE);
    pf.getLineFormat().setWidth(20);
    pf.setRotation(45);
    
    // Записывает файл PPTX на диск
    pres.save("RectPicFrame.pptx", SaveFormat.Pptx);
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

Совет

Aspose недавно разработала бесплатный Коллаж Maker. Если вам когда-либо нужно будет объединить JPG/JPEG или PNG изображения, создать сетки из фото, вы можете воспользоваться этим сервисом.

Добавить изображение как ссылку

Чтобы избежать большого размера презентации, вы можете добавлять изображения (или видео) через ссылки вместо того, чтобы вставлять файлы непосредственно в презентации. Этот Java-код показывает, как добавить изображение и видео в заполнителю:

Presentation presentation = new Presentation("input.pptx");
try {
    ArrayList<IShape> shapesToRemove = new ArrayList<IShape>();
    int shapesCount = presentation.getSlides().get_Item(0).getShapes().size();

    for (int i = 0; i < shapesCount; i++)
    {
        IShape autoShape = presentation.getSlides().get_Item(0).getShapes().get_Item(i);

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

        switch (autoShape.getPlaceholder().getType())
        {
            case PlaceholderType.Picture:
                IPictureFrame pictureFrame = presentation.getSlides().get_Item(0).getShapes().addPictureFrame(ShapeType.Rectangle,
                        autoShape.getX(), autoShape.getY(), autoShape.getWidth(), autoShape.getHeight(), null);

                pictureFrame.getPictureFormat().getPicture().setLinkPathLong(
                        "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:
                IVideoFrame videoFrame = presentation.getSlides().get_Item(0).getShapes().addVideoFrame(
                        autoShape.getX(), autoShape.getY(), autoShape.getWidth(), autoShape.getHeight(), "");

                videoFrame.getPictureFormat().getPicture().setLinkPathLong(
                        "https://upload.wikimedia.org/wikipedia/commons/3/3a/I.M_at_Old_School_Public_Broadcasting_in_October_2016_02.jpg");

                videoFrame.setLinkPathLong("https://youtu.be/t_1LYZ102RA");

                shapesToRemove.add(autoShape);
                break;
        }
    }

    for (IShape shape : shapesToRemove)
    {
        presentation.getSlides().get_Item(0).getShapes().remove(shape);
    }

    presentation.save("output.pptx", SaveFormat.Pptx);
} finally {
    if (presentation != null) presentation.dispose();
}

Обрезка изображения

Этот Java-код показывает, как обрезать существующее изображение на слайде:

Presentation pres = new Presentation();
// Создает новый объект изображения
try {
    IPPImage picture;
    IImage image = Images.fromFile(imagePath);
    try {
        picture = pres.getImages().addImage(image);
    } finally {
        if (image != null) image.dispose();
    }

    // Добавляет рамку для изображения на слайд
    IPictureFrame picFrame = pres.getSlides().get_Item(0).getShapes().addPictureFrame(
            ShapeType.Rectangle, 100, 100, 420, 250, picture);

    // Обрезает изображение (значения в процентах)
    picFrame.getPictureFormat().setCropLeft(23.6f);
    picFrame.getPictureFormat().setCropRight(21.5f);
    picFrame.getPictureFormat().setCropTop(3);
    picFrame.getPictureFormat().setCropBottom(31);

    // Сохраняет результат
    pres.save(outPptxFile, SaveFormat.Pptx);
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

Удалите обрезанные области изображения

Если вы хотите удалить обрезанные области изображения, содержащегося в рамке, вы можете использовать метод deletePictureCroppedAreas(). Этот метод возвращает обрезанное изображение или исходное изображение, если обрезка не требуется.

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

Presentation presentation = new Presentation("PictureFrameCrop.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    // Получает PictureFrame с первого слайда
    IPictureFrame picFrame = (IPictureFrame)slide.getShapes().get_Item(0);

    // Удаляет обрезанные области изображения PictureFrame и возвращает обрезанное изображение
    IPPImage croppedImage = picFrame.getPictureFormat().deletePictureCroppedAreas();

    // Сохраняет результат
    presentation.save("PictureFrameDeleteCroppedAreas.pptx", SaveFormat.Pptx);
} finally {
    if (presentation != null) presentation.dispose();
}

ЗАМЕТКА

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

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

Блокировка соотношения сторон

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

Этот Java-код показывает, как заблокировать соотношение сторон фигуры:

Presentation pres = new Presentation("pres.pptx");
try {
    ILayoutSlide layout = pres.getLayoutSlides().getByType(SlideLayoutType.Custom);
    ISlide emptySlide = pres.getSlides().addEmptySlide(layout);
    IPPImage picture;
    IImage image = Images.fromFile("image.png");
    try {
        picture = pres.getImages().addImage(image);
    } finally {
        if (image != null) image.dispose();
    }
    IPictureFrame pictureFrame = emptySlide.getShapes().addPictureFrame(
            ShapeType.Rectangle, 50, 150, presImage.getWidth(), presImage.getHeight(), picture);

    // Устанавливает фигуру, чтобы сохранить соотношение сторон при изменении размера
    pictureFrame.getPictureFrameLock().setAspectRatioLocked(true);
} catch(IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

ЗАМЕТКА

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

Использовать свойство StretchOff

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

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

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

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

// Создает экземпляр класса Presentation, который представляет файл PPTX
Presentation pres = new Presentation();
try {
    // Получает первый слайд
    ISlide slide = pres.getSlides().get_Item(0);

    // Создает экземпляр класса ImageEx
    IPPImage picture;
    IImage image = Images.fromFile("aspose-logo.jpg");
    try {
        picture = pres.getImages().addImage(image);
    } finally {
        if (image != null) image.dispose();
    }

    // Добавляет AutoShape, установлено на Rectangle
    IAutoShape aShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 300, 300);

    // Устанавливает тип заполнения фигуры
    aShape.getFillFormat().setFillType(FillType.Picture);

    // Устанавливает режим заполнения изображения фигуры
    aShape.getFillFormat().getPictureFillFormat().setPictureFillMode(PictureFillMode.Stretch);

    // Устанавливает изображение для заполнения фигуры
    aShape.getFillFormat().getPictureFillFormat().getPicture().setImage(picture);

    // Указывает смещения изображения от соответствующего края рамки фигуры
    aShape.getFillFormat().getPictureFillFormat().setStretchOffsetLeft(25);
    aShape.getFillFormat().getPictureFillFormat().setStretchOffsetRight(25);
    aShape.getFillFormat().getPictureFillFormat().setStretchOffsetTop(-20);
    aShape.getFillFormat().getPictureFillFormat().setStretchOffsetBottom(-10);
    
    // Записывает файл PPTX на диск
    pres.save("StretchOffsetLeftForPictureFrame_out.pptx", SaveFormat.Pptx);
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}