ImageSaveOptions

ImageSaveOptions class

Consente di specificare opzioni aggiuntive durante il rendering di pagine o forme di documenti in immagini.

Per saperne di più, visita ilSpecificare le opzioni di salvataggio articolo di documentazione.

public class ImageSaveOptions : FixedPageSaveOptions

Costruttori

Nome	Descrizione
ImageSaveOptions(SaveFormat)	Inizializza una nuova istanza di questa classe che può essere utilizzata per salvare le immagini renderizzate in Tiff ,Png ,Bmp , Jpeg ,Emf ,Eps , WebP OSvg formato.

Proprietà

Nome	Descrizione
AllowEmbeddingPostScriptFonts { get; set; }	Ottiene o imposta un valore booleano che indica se consentire l’incorporamento di font con contorni PostScript quando si incorporano font TrueType in un documento al momento del salvataggio. Il valore predefinito èfalso .
ColorMode { get; set; }	Ottiene o imposta un valore che determina come vengono resi i colori.
CustomTimeZoneInfo { get; set; }	Ottiene o imposta il fuso orario locale personalizzato utilizzato per i campi data/ora.
DefaultTemplate { get; set; }	Ottiene o imposta il percorso al modello predefinito (incluso il nome del file). Il valore predefinito per questa proprietà èstringa vuota (Empty ).
Dml3DEffectsRenderingMode { get; set; }	Ottiene o imposta un valore che determina come vengono renderizzati gli effetti 3D.
virtual DmlEffectsRenderingMode { get; set; }	Ottiene o imposta un valore che determina come vengono renderizzati gli effetti DrawingML.
DmlRenderingMode { get; set; }	Ottiene o imposta un valore che determina come vengono renderizzate le forme DrawingML.
ExportGeneratorName { get; set; }	QuandoVERO , fa sì che il nome e la versione di Aspose.Words vengano incorporati nei file prodotti. Il valore predefinito èVERO .
GraphicsQualityOptions { get; set; }	Consente di specificare la modalità di rendering e la qualità per ilGraphics oggetto.
HorizontalResolution { get; set; }	Ottiene o imposta la risoluzione orizzontale per le immagini generate, in punti per pollice.
ImageBrightness { get; set; }	Ottiene o imposta la luminosità per le immagini generate.
ImageColorMode { get; set; }	Ottiene o imposta la modalità colore per le immagini generate.
ImageContrast { get; set; }	Ottiene o imposta il contrasto per le immagini generate.
ImageSize { get; set; }	Ottiene o imposta la dimensione di un’immagine generata in pixel.
ImlRenderingMode { get; set; }	Ottiene o imposta un valore che determina come vengono renderizzati gli oggetti ink (InkML).
JpegQuality { get; set; }	Ottiene o imposta un valore che determina la qualità delle immagini JPEG generate.
MemoryOptimization { get; set; }	Ottiene o imposta il valore che determina se l’ottimizzazione della memoria deve essere eseguita prima di salvare il documento. Il valore predefinito per questa proprietà èfalso .
MetafileRenderingOptions { get; }	Consente di specificare come vengono trattati i metafile nell’output renderizzato.
NumeralFormat { get; set; }	Ottiene o impostaNumeralFormat utilizzato per il rendering dei numeri. Per impostazione predefinita vengono utilizzati i numeri europei.
virtual OptimizeOutput { get; set; }	Il flag indica se è necessario ottimizzare l’output. Se questo flag è impostato, le tele nidificate ridondanti e le tele vuote vengono rimosse, anche i glifi vicini con la stessa formattazione vengono concatenati. Nota: la precisione della visualizzazione del contenuto potrebbe essere influenzata se questa proprietà è impostata suVERO . Il valore predefinito èfalso .
PageSavingCallback { get; set; }	Consente di controllare come vengono salvate le singole pagine quando un documento viene esportato in un formato di pagina fisso.
PageSet { get; set; }	Ottiene o imposta le pagine da visualizzare. L’impostazione predefinita è tutte le pagine del documento.
PaperColor { get; set; }	Ottiene o imposta il colore di sfondo (carta) per le immagini generate.
PixelFormat { get; set; }	Ottiene o imposta il formato pixel per le immagini generate.
PrettyFormat { get; set; }	QuandoVERO , formatta bene l’output dove applicabile. Il valore predefinito èfalso .
ProgressCallback { get; set; }	Viene chiamato durante il salvataggio di un documento e accetta dati sullo stato di avanzamento del salvataggio.
Resolution { set; }	Imposta la risoluzione orizzontale e verticale per le immagini generate, in punti per pollice.
override SaveFormat { get; set; }	Specifica il formato in cui verranno salvate le pagine o le forme del documento renderizzato se viene utilizzato questo oggetto di opzioni di salvataggio. Può essere un raster Tiff ,Png ,Bmp , Jpeg o vettoreEmf ,Eps , WebP ,Svg .
Scale { get; set; }	Ottiene o imposta il fattore di zoom per le immagini generate.
TempFolder { get; set; }	Specifica la cartella per i file temporanei utilizzati durante il salvataggio in un file DOC o DOCX. Per impostazione predefinita, questa proprietà ènull e non vengono utilizzati file temporanei.
ThresholdForFloydSteinbergDithering { get; set; }	Ottiene o imposta la soglia che determina il valore dell’errore di binarizzazione nel metodo Floyd-Steinberg. quandoImageBinarizationMethod ÈFloydSteinbergDithering .
TiffBinarizationMethod { get; set; }	Ottiene o imposta il metodo utilizzato durante la conversione delle immagini nel formato 1 bpp quandoSaveFormat ÈTiff e TiffCompression è uguale aCcitt3 OCcitt4 .
TiffCompression { get; set; }	Ottiene o imposta il tipo di compressione da applicare durante il salvataggio delle immagini generate nel formato TIFF.
UpdateAmbiguousTextFont { get; set; }	Determina se gli attributi del font verranno modificati in base al codice carattere utilizzato.
UpdateCreatedTimeProperty { get; set; }	Ottiene o imposta un valore che determina se ilCreatedTime la proprietà viene aggiornata prima del salvataggio. Il valore predefinito èfalso ;
UpdateFields { get; set; }	Ottiene o imposta un valore che determina se i campi di determinati tipi devono essere aggiornati prima di salvare il documento in un formato di pagina fisso. Il valore predefinito per questa proprietà èVERO .
UpdateLastPrintedProperty { get; set; }	Ottiene o imposta un valore che determina se ilLastPrinted la proprietà viene aggiornata prima del salvataggio.
UpdateLastSavedTimeProperty { get; set; }	Ottiene o imposta un valore che determina se ilLastSavedTime la proprietà viene aggiornata prima del salvataggio.
UseAntiAliasing { get; set; }	Ottiene o imposta un valore che determina se utilizzare o meno l’anti-aliasing per il rendering.
UseGdiEmfRenderer { get; set; }	Ottiene o imposta un valore che determina se utilizzare il renderer metafile GDI+ o Aspose.Words durante il salvataggio in EMF.
UseHighQualityRendering { get; set; }	Ottiene o imposta un valore che determina se utilizzare o meno algoritmi di rendering di alta qualità (ad esempio lenti).
VerticalResolution { get; set; }	Ottiene o imposta la risoluzione verticale per le immagini generate, in punti per pollice.

Metodi

Nome	Descrizione
Clone()	Crea un clone profondo di questo oggetto.
override Equals(object)	Determina se l’oggetto specificato ha un valore uguale all’oggetto corrente.

Esempi

Mostra come specificare una risoluzione durante il rendering di un documento in 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");

// Creiamo un oggetto "ImageSaveOptions" che possiamo passare al metodo "Save" del documento
// per modificare il modo in cui quel metodo trasforma il documento in un'immagine.
ImageSaveOptions options = new ImageSaveOptions(SaveFormat.Png);

// Impostare la proprietà "Risoluzione" su "72" per visualizzare il documento a 72 dpi.
options.Resolution = 72;
doc.Save(ArtifactsDir + "ImageSaveOptions.Resolution.72dpi.png", options);

// Impostare la proprietà "Risoluzione" su "300" per visualizzare il documento a 300 dpi.
options.Resolution = 300;
doc.Save(ArtifactsDir + "ImageSaveOptions.Resolution.300dpi.png", options);

Mostra come configurare la compressione durante il salvataggio di un documento in formato JPEG.

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

// Creiamo un oggetto "ImageSaveOptions" che possiamo passare al metodo "Save" del documento
// per modificare il modo in cui quel metodo trasforma il documento in un'immagine.
ImageSaveOptions imageOptions = new ImageSaveOptions(SaveFormat.Jpeg);
// Impostare la proprietà "JpegQuality" su "10" per utilizzare una compressione più forte durante il rendering del documento.
// Ciò ridurrà le dimensioni del file del documento, ma l'immagine presenterà artefatti di compressione più evidenti.
imageOptions.JpegQuality = 10;
doc.Save(ArtifactsDir + "ImageSaveOptions.JpegQuality.HighCompression.jpg", imageOptions);

// Impostare la proprietà "JpegQuality" su "100" per utilizzare una compressione più debole durante il rendering del documento.
// Ciò migliorerà la qualità dell'immagine a scapito delle dimensioni del file.
imageOptions.JpegQuality = 100;
doc.Save(ArtifactsDir + "ImageSaveOptions.JpegQuality.HighQuality.jpg", imageOptions);

Converte una pagina di un documento Word in un’immagine con sfondo trasparente o colorato.

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");

// Creiamo un oggetto "ImageSaveOptions" che possiamo passare al metodo "Save" del documento
// per modificare il modo in cui quel metodo trasforma il documento in un'immagine.
ImageSaveOptions imgOptions = new ImageSaveOptions(SaveFormat.Png);
// Imposta la proprietà "PaperColor" su un colore trasparente per applicare un colore trasparente
// sfondo del documento durante il rendering in un'immagine.
imgOptions.PaperColor = Color.Transparent;

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

// Imposta la proprietà "PaperColor" su un colore opaco per applicare quel colore
// come sfondo del documento mentre lo trasformiamo in un'immagine.
imgOptions.PaperColor = Color.LightCoral;

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

Guarda anche

• class FixedPageSaveOptions
• spazio dei nomi Aspose.Words.Saving
• assemblea Aspose.Words