CompressImage

CompressImage(bool, PicturesCompression)

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

public bool CompressImage(bool deleteCroppedAreasOfImage, PicturesCompression resolution)
ПараметрТипОписание
deleteCroppedAreasOfImageBooleanЕсли true, метод удалит обрезанные области изображения, что может дополнительно уменьшить его размер.
resolutionPicturesCompressionЦелевое разрешение для сжатия, указанное в виде значения перечисления PicturesCompression.

Возвращаемое значение

Логическое значение, указывающее на то, было ли изображение успешно сжато. Возвращает true, если изображение было изменено в размерах или обрезано, в противном случае false.

Исключения

исключениеусловие
ArgumentExceptionВыбрасывается, когда разрешение не является допустимым значением.

Примечания

Этот метод изменяет размер и разрешение изображения аналогично функции “Формат изображения -> Сжать изображения” в PowerPoint.

Примеры

Следующий пример демонстрирует, как использовать метод CompressImage для уменьшения размера изображения в презентации, задав целевое разрешение и удалив обрезанные области:

using (Presentation presentation = new Presentation("demo.pptx"))
{
    ISlide slide = presentation.Slides[0];
    IPictureFrame picFrame = slide.Shapes[0] as IPictureFrame;
    // Сжать изображение с целевым разрешением 150 DPI (веб-разрешение) и удалить обрезанные области
    bool result = picFrame.PictureFormat.CompressImage(true, PicturesCompression.Dpi150);
}

Смотрите также


CompressImage(bool, float)

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

public bool CompressImage(bool deleteCroppedAreasOfImage, float resolution)
ПараметрТипОписание
deleteCroppedAreasOfImageBooleanЕсли true, метод удалит обрезанные области изображения, что может дополнительно уменьшить его размер.
resolutionSingleЦелевое разрешение в DPI. Это значение должно быть положительным и определяет, как изображение будет изменено в размерах.

Возвращаемое значение

Логическое значение, указывающее на то, было ли изображение успешно сжато. Возвращает true, если изображение было изменено в размерах или обрезано, в противном случае false.

Исключения

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

Примечания

Этот метод изменяет размер и разрешение изображения аналогично функции “Формат изображения -> Сжать изображения” в PowerPoint.

Примеры

Следующий пример демонстрирует, как использовать метод CompressImage для уменьшения размера изображения в презентации, задав целевое разрешение и удалив обрезанные области:

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

    // Получает PictureFrame
    IPictureFrame picFrame = slide.Shapes[0] as IPictureFrame;

    // Сжать изображение с целевым разрешением 150 DPI (веб-разрешение) и удалить обрезанные области
    bool result=picFrame.PictureFormat.CompressImage(true, 150f); // Веб-разрешение
}

Смотрите также