CompressImage

CompressImage(bool, PicturesCompression)

Comprime la imagen reduciendo su tamaño según el tamaño de la forma y la resolución especificada. Opcionalmente, también elimina las áreas recortadas.

public bool CompressImage(bool deleteCroppedAreasOfImage, PicturesCompression resolution)
ParámetroTipoDescripción
deleteCroppedAreasOfImageBooleanoSi es verdadero, el método eliminará las áreas recortadas de la imagen, reduciendo potencialmente aún más su tamaño.
resolutionPicturesCompressionLa resolución objetivo para la compresión, especificada como un valor de la enumeración PicturesCompression.

Valor de retorno

Un booleano que indica si la imagen fue comprimida con éxito. Devuelve true si la imagen fue redimensionada o recortada, de lo contrario, false.

Excepciones

excepcióncondición
ArgumentExceptionSe lanza cuando la resolución no es un valor válido.

Observaciones

Este método cambia el tamaño y la resolución de la imagen de manera similar a la función “Formato de imagen -> Comprimir imágenes” de PowerPoint.

Ejemplos

El siguiente ejemplo demuestra cómo usar el método CompressImage para reducir el tamaño de una imagen en una presentación estableciendo una resolución objetivo y eliminando áreas recortadas:

using (Presentation presentation = new Presentation("demo.pptx"))
{
    ISlide slide = presentation.Slides[0];
    IPictureFrame picFrame = slide.Shapes[0] as IPictureFrame;
    // Comprimir la imagen con una resolución objetivo de 150 DPI (resolución web) y eliminar áreas recortadas
    bool result = picFrame.PictureFormat.CompressImage(true, PicturesCompression.Dpi150);
}

Véase también


CompressImage(bool, float)

Comprime la imagen reduciendo su tamaño según el tamaño de la forma y la resolución especificada. Opcionalmente, también elimina las áreas recortadas.

public bool CompressImage(bool deleteCroppedAreasOfImage, float resolution)
ParámetroTipoDescripción
deleteCroppedAreasOfImageBooleanoSi es verdadero, el método eliminará las áreas recortadas de la imagen, reduciendo potencialmente aún más su tamaño.
resolutionSimpleLa resolución objetivo en DPI. Este valor debe ser positivo y define cómo se redimensionará la imagen.

Valor de retorno

Un booleano que indica si la imagen fue comprimida con éxito. Devuelve true si la imagen fue redimensionada o recortada, de lo contrario, false.

Excepciones

excepcióncondición
ArgumentExceptionSe lanza cuando la resolución no es un valor positivo.

Observaciones

Este método cambia el tamaño y la resolución de la imagen de manera similar a la función “Formato de imagen -> Comprimir imágenes” de PowerPoint.

Ejemplos

El siguiente ejemplo demuestra cómo usar el método CompressImage para reducir el tamaño de una imagen en una presentación estableciendo una resolución objetivo y eliminando áreas recortadas:

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

    // Obtiene el PictureFrame
    IPictureFrame picFrame = slide.Shapes[0] as IPictureFrame;

    // Comprimir la imagen con una resolución objetivo de 150 DPI (resolución web) y eliminar áreas recortadas
    bool result=picFrame.PictureFormat.CompressImage(true, 150f); // Resolución web
}

Véase también