ImageSaveOptions

ImageSaveOptions class

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

Para obtener más información, visite elEspecificar opciones de guardado 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 , WebP oSvg formato.

Propiedades

NombreDescripción
AllowEmbeddingPostScriptFonts { get; set; }Obtiene o establece un valor booleano que indica si se debe permitir la incrustación de fuentes con contornos PostScript al incrustar fuentes TrueType en un documento al guardarlo. 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 y hora.
DefaultTemplate { get; set; }Obtiene o establece la ruta a la plantilla predeterminada (incluido el nombre del archivo). El valor predeterminado para esta propiedad escadena 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 para laGraphics 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 un 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 la representación de 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 se establece este indicador, se eliminan los lienzos anidados redundantes y 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 se establece enverdadero . El valor predeterminado esFALSO .
PageSavingCallback { get; set; }Permite controlar cómo se guardan las páginas separadas cuando un documento se exporta a un formato de página fijo.
PageSet { get; set; }Obtiene o establece las páginas que se representarán. 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íxel para las imágenes generadas.
PrettyFormat { get; set; }Cuandoverdadero , formatos bonitos de salida donde corresponda. El valor predeterminado esFALSO .
ProgressCallback { get; set; }Se llama al guardar 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 , WebP ,Svg .
Scale { get; set; }Obtiene o establece el factor de zoom para las imágenes generadas.
TempFolder { get; set; }Especifica la carpeta para los 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 las imágenes generadas en formato TIFF.
UpdateAmbiguousTextFont { get; set; }Determina si los atributos de fuente se cambiarán según el código de carácter que se esté utilizando.
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 debe utilizar o no suavizado para la representación.
UseGdiEmfRenderer { get; set; }Obtiene o establece un valor que determina si se debe utilizar el renderizador de metarchivos GDI+ o Aspose.Words al guardar en EMF.
UseHighQualityRendering { get; set; }Obtiene o establece un valor que determina si se deben utilizar 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 es igual en valor al objeto actual.

Ejemplos

Muestra cómo especificar una resolución al renderizar un documento en formato 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 renderizar el documento en 72 ppp.
options.Resolution = 72;
doc.Save(ArtifactsDir + "ImageSaveOptions.Resolution.72dpi.png", options);

// Establezca la propiedad "Resolución" en "300" para renderizar el documento en 300 ppp.
options.Resolution = 300;
doc.Save(ArtifactsDir + "ImageSaveOptions.Resolution.300dpi.png", options);

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);
// Establezca 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 prominentes.
imageOptions.JpegQuality = 10;
doc.Save(ArtifactsDir + "ImageSaveOptions.JpegQuality.HighCompression.jpg", imageOptions);

// Establezca 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);

Convierte una página de un documento de Word en una imagen con fondo transparente o de color.

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);
// Establezca la propiedad "PaperColor" en un color transparente para aplicar un color transparente.
// fondo del documento mientras lo renderizas en una imagen.
imgOptions.PaperColor = Color.Transparent;

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

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

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

Ver también