ImageSaveOptions

ImageSaveOptions class

Permite especificar opciones adicionales al representar páginas de documentos o formas en imágenes.

Para obtener más información, visite elEspecificar opciones de guardar artículo de documentación.

public class ImageSaveOptions : FixedPageSaveOptions

Constructores

NombreDescripción
ImageSaveOptions(SaveFormat)Inicializa una nueva instancia de esta clase que se puede usar para guardar imágenes renderizadas en Tiff ,Png ,Bmp , Jpeg ,Emf ,Eps oSvg formato.

Propiedades

NombreDescripción
AllowEmbeddingPostScriptFonts { get; set; }Obtiene o establece un valor booleano que indica si se permite incrustar fuentes con contornos PostScript al incrustar fuentes TrueType en un documento una vez guardado. El valor predeterminado esFALSO .
ColorMode { get; set; }Obtiene o establece un valor que determina cómo se representan los colores.
CustomTimeZoneInfo { get; set; }Obtiene o establece la zona horaria local personalizada utilizada para los campos de fecha/hora.
DefaultTemplate { get; set; }Obtiene o establece la ruta a la plantilla predeterminada (incluido el nombre del archivo). El valor predeterminado para esta propiedad escuerda vacía (Empty).
Dml3DEffectsRenderingMode { get; set; }Obtiene o establece un valor que determina cómo se representan los efectos 3D.
virtual DmlEffectsRenderingMode { get; set; }Obtiene o establece un valor que determina cómo se representan los efectos de DrawingML.
DmlRenderingMode { get; set; }Obtiene o establece un valor que determina cómo se representan las formas de DrawingML.
ExportGeneratorName { get; set; }cuandoverdadero , hace que el nombre y la versión de Aspose.Words se incrusten en los archivos producidos. El valor predeterminado esverdadero .
GraphicsQualityOptions { get; set; }Permite especificar el modo de renderizado y la calidad delGraphics objeto.
HorizontalResolution { get; set; }Obtiene o establece la resolución horizontal de las imágenes generadas, en puntos por pulgada.
ImageBrightness { get; set; }Obtiene o establece el brillo de las imágenes generadas.
ImageColorMode { get; set; }Obtiene o establece el modo de color para las imágenes generadas.
ImageContrast { get; set; }Obtiene o establece el contraste de las imágenes generadas.
ImageSize { get; set; }Obtiene o establece el tamaño de una imagen generada en píxeles.
ImlRenderingMode { get; set; }Obtiene o establece un valor que determina cómo se representan los objetos de tinta (InkML).
JpegQuality { get; set; }Obtiene o establece un valor que determina la calidad de las imágenes JPEG generadas.
MemoryOptimization { get; set; }Obtiene o establece el valor que determina si se debe realizar la optimización de la memoria antes de guardar el documento. El valor predeterminado para esta propiedad esFALSO .
MetafileRenderingOptions { get; }Permite especificar cómo se tratan los metarchivos en la salida renderizada.
NumeralFormat { get; set; }Obtiene o estableceNumeralFormat se utiliza para representar números. Los números europeos se utilizan de forma predeterminada.
virtual OptimizeOutput { get; set; }El indicador indica si es necesario optimizar la salida. Si este indicador se establece en lienzos anidados redundantes y se eliminan los lienzos vacíos, también se concatenan los glifos vecinos con el mismo formato. Nota: La precisión de la visualización del contenido puede verse afectada si esta propiedad está establecida enverdadero . El valor predeterminado esFALSO .
PageSavingCallback { get; set; }Permite controlar cómo se guardan las páginas separadas cuando un documento se exporta a formato de página fija.
PageSet { get; set; }Obtiene o establece las páginas que se van a representar. El valor predeterminado son todas las páginas del documento.
PaperColor { get; set; }Obtiene o establece el color de fondo (papel) para las imágenes generadas.
PixelFormat { get; set; }Obtiene o establece el formato de píxeles de las imágenes generadas.
PrettyFormat { get; set; }cuandoverdadero salida con bonitos formatos cuando corresponda. El valor predeterminado esFALSO .
ProgressCallback { get; set; }Se llama durante el guardado de un documento y acepta datos sobre el progreso del guardado.
Resolution { set; }Establece la resolución horizontal y vertical de las imágenes generadas, en puntos por pulgada.
override SaveFormat { get; set; }Especifica el formato en el que se guardarán las páginas o formas del documento renderizado si se utiliza este objeto de opciones de guardado. Puede ser un ráster Tiff ,Png ,Bmp , Jpeg o vectorEmf ,Eps , Svg .
Scale { get; set; }Obtiene o establece el factor de zoom para las imágenes generadas.
TempFolder { get; set; }Especifica la carpeta para archivos temporales utilizados al guardar en un archivo DOC o DOCX. De forma predeterminada, esta propiedad esnulo y no se utilizan archivos temporales.
ThresholdForFloydSteinbergDithering { get; set; }Obtiene o establece el umbral que determina el valor del error de binarización en el método Floyd-Steinberg. cuandoImageBinarizationMethod esFloydSteinbergDithering .
TiffBinarizationMethod { get; set; }Obtiene o establece el método utilizado al convertir imágenes al formato de 1 bpp cuandoSaveFormat esTiff y TiffCompression es igual aCcitt3 oCcitt4 .
TiffCompression { get; set; }Obtiene o establece el tipo de compresión que se aplicará al guardar imágenes generadas en formato TIFF.
UpdateCreatedTimeProperty { get; set; }Obtiene o establece un valor que determina si elCreatedTime La propiedad se actualiza antes de guardar. El valor predeterminado esFALSO ;
UpdateFields { get; set; }Obtiene o establece un valor que determina si los campos de ciertos tipos deben actualizarse antes de guardar el documento en un formato de página fijo. El valor predeterminado para esta propiedad esverdadero .
UpdateLastPrintedProperty { get; set; }Obtiene o establece un valor que determina si elLastPrinted la propiedad se actualiza antes de guardar.
UpdateLastSavedTimeProperty { get; set; }Obtiene o establece un valor que determina si elLastSavedTime la propiedad se actualiza antes de guardar.
UseAntiAliasing { get; set; }Obtiene o establece un valor que determina si se utiliza o no el suavizado para la representación.
UseGdiEmfRenderer { get; set; }Obtiene o establece un valor que determina si se debe usar el procesador de metarchivos GDI+ o Aspose.Words al guardar en EMF.
UseHighQualityRendering { get; set; }Obtiene o establece un valor que determina si se utilizan o no algoritmos de renderizado de alta calidad (es decir, lentos).
VerticalResolution { get; set; }Obtiene o establece la resolución vertical de las imágenes generadas, en puntos por pulgada.

Métodos

NombreDescripción
Clone()Crea un clon profundo de este objeto.
override Equals(object)Determina si el objeto especificado tiene el mismo valor que el objeto actual.

Ejemplos

Representa una página de un documento de Word en una imagen con fondo transparente o coloreado.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.Font.Name = "Times New Roman";
builder.Font.Size = 24;
builder.Writeln("Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.");

builder.InsertImage(ImageDir + "Logo.jpg");

// Crea un objeto "ImageSaveOptions" que podemos pasar al método "Guardar" del documento
// para modificar la forma en que ese método convierte el documento en una imagen.
ImageSaveOptions imgOptions = new ImageSaveOptions(SaveFormat.Png);

// Establece la propiedad "PaperColor" en un color transparente para aplicar un color transparente
// fondo del documento mientras lo representa en una imagen.
imgOptions.PaperColor = Color.Transparent;

doc.Save(ArtifactsDir + "ImageSaveOptions.PaperColor.Transparent.png", imgOptions);

// Establece la propiedad "PaperColor" en un color opaco para aplicar ese color
// como fondo del documento cuando lo representamos en una imagen.
imgOptions.PaperColor = Color.LightCoral;

doc.Save(ArtifactsDir + "ImageSaveOptions.PaperColor.LightCoral.png", imgOptions);

Muestra cómo configurar la compresión al guardar un documento como JPEG.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.InsertImage(ImageDir + "Logo.jpg");

// Crea un objeto "ImageSaveOptions" que podemos pasar al método "Guardar" del documento
// para modificar la forma en que ese método convierte el documento en una imagen.
ImageSaveOptions imageOptions = new ImageSaveOptions(SaveFormat.Jpeg);

// Establece la propiedad "JpegQuality" en "10" para utilizar una compresión más fuerte al renderizar el documento.
// Esto reducirá el tamaño del archivo del documento, pero la imagen mostrará artefactos de compresión más destacados.
imageOptions.JpegQuality = 10;

doc.Save(ArtifactsDir + "ImageSaveOptions.JpegQuality.HighCompression.jpg", imageOptions);

Assert.That(20000, Is.AtLeast(new FileInfo(ArtifactsDir + "ImageSaveOptions.JpegQuality.HighCompression.jpg").Length));

// Establece la propiedad "JpegQuality" en "100" para utilizar una compresión más débil al renderizar el documento.
// Esto mejorará la calidad de la imagen a costa de un mayor tamaño de archivo.
imageOptions.JpegQuality = 100;

doc.Save(ArtifactsDir + "ImageSaveOptions.JpegQuality.HighQuality.jpg", imageOptions);

Assert.That(60000, Is.LessThan(new FileInfo(ArtifactsDir + "ImageSaveOptions.JpegQuality.HighQuality.jpg").Length));

Muestra cómo especificar una resolución al renderizar un documento en PNG.

Document doc = new Document();
            DocumentBuilder builder = new DocumentBuilder(doc);

            builder.Font.Name = "Times New Roman";
            builder.Font.Size = 24;
            builder.Writeln("Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.");

            builder.InsertImage(ImageDir + "Logo.jpg");

            // Crea un objeto "ImageSaveOptions" que podemos pasar al método "Guardar" del documento
            // para modificar la forma en que ese método convierte el documento en una imagen.
            ImageSaveOptions options = new ImageSaveOptions(SaveFormat.Png);

            // Establezca la propiedad "Resolución" en "72" para representar el documento en 72 ppp.
            options.Resolution = 72;

            doc.Save(ArtifactsDir + "ImageSaveOptions.Resolution.72dpi.png", options);

            Assert.That(120000, Is.AtLeast(new FileInfo(ArtifactsDir + "ImageSaveOptions.Resolution.72dpi.png").Length));

#if NET48 || JAVA
            Image image = Image.FromFile(ArtifactsDir + "ImageSaveOptions.Resolution.72dpi.png");

            Assert.AreEqual(612, image.Width);
            Assert.AreEqual(792, image.Height);
#elif NET5_0_OR_GREATER || __MOBILE__
            using (SKBitmap image = SKBitmap.Decode(ArtifactsDir + "ImageSaveOptions.Resolution.72dpi.png")) 
            {
                Assert.AreEqual(612, image.Width);
                Assert.AreEqual(792, image.Height);
            }
#endif
            // Establezca la propiedad "Resolución" en "300" para representar el documento en 300 ppp.
            options.Resolution = 300;

            doc.Save(ArtifactsDir + "ImageSaveOptions.Resolution.300dpi.png", options);

            Assert.That(700000, Is.LessThan(new FileInfo(ArtifactsDir + "ImageSaveOptions.Resolution.300dpi.png").Length));

#if NET48 || JAVA
            image = Image.FromFile(ArtifactsDir + "ImageSaveOptions.Resolution.300dpi.png");

            Assert.AreEqual(2550, image.Width);
            Assert.AreEqual(3300, image.Height);
#elif NET5_0_OR_GREATER || __MOBILE__
            using (SKBitmap image = SKBitmap.Decode(ArtifactsDir + "ImageSaveOptions.Resolution.300dpi.png")) 
            {
                Assert.AreEqual(2550, image.Width);
                Assert.AreEqual(3300, image.Height);
            }
#endif

Ver también

ImagePixelFormat Enum ImageSavingArgs Class