ImageSaveOptions
Contenuti
[
Nascondere
]ImageSaveOptions class
Consente di specificare opzioni aggiuntive durante il rendering delle pagine o delle forme del documento 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 oSvg formato. |
Proprietà
| Nome | Descrizione |
|---|---|
| AllowEmbeddingPostScriptFonts { get; set; } | Ottiene o imposta un valore booleano che indica se consentire l’incorporamento di caratteri con contorni PostScript quando si incorporano caratteri TrueType in un documento al momento del salvataggio. Il valore predefinito èfalso . |
| ColorMode { get; set; } | Ottiene o imposta un valore che determina la modalità di rendering dei 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 del modello predefinito (incluso il nome file). Il valore predefinito per questa proprietà èstringa vuota (Empty). |
| Dml3DEffectsRenderingMode { get; set; } | Ottiene o imposta un valore che determina la modalità di rendering degli effetti 3D. |
| virtual DmlEffectsRenderingMode { get; set; } | Ottiene o imposta un valore che determina la modalità di rendering degli effetti DrawingML. |
| DmlRenderingMode { get; set; } | Ottiene o imposta un valore che determina la modalità di rendering delle 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; } | Permette di specificare la modalità di rendering e la qualità per il fileGraphics 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 la modalità di rendering degli oggetti input penna (InkML). |
| JpegQuality { get; set; } | Ottiene o imposta un valore che determina la qualità delle immagini JPEG generate. |
| MemoryOptimization { get; set; } | Ottiene o imposta un 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; } | Permette di specificare come vengono trattati i metafile nell’output renderizzato. |
| NumeralFormat { get; set; } | Ottiene o impostaNumeralFormat utilizzato per il rendering dei numeri. I numeri europei vengono utilizzati per impostazione predefinita. |
| 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, vengono concatenati anche i glifi vicini con la stessa formattazione. Nota: la precisione della visualizzazione del contenuto potrebbe essere influenzata se questa proprietà è impostata suVERO . L’impostazione predefinita èfalso . |
| PageSavingCallback { get; set; } | Permette di controllare come vengono salvate le pagine separate 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 nel 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 formati di output graziosi dove applicabile. Il valore predefinito èfalso . |
| ProgressCallback { get; set; } | Chiamato durante il salvataggio di un documento e accetta i dati sull’avanzamento del salvataggio. |
| Resolution { set; } | Imposta la risoluzione sia orizzontale che 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 delle opzioni di salvataggio. Può essere un raster Tiff ,Png ,Bmp , Jpeg o vettoreEmf ,Eps , 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 utilizzata durante il salvataggio in un file DOC o DOCX. Per impostazione predefinita questa proprietà ènullo 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 quando si salvano le immagini generate nel formato TIFF. |
| 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’antialiasing per il rendering. |
| UseGdiEmfRenderer { get; set; } | Ottiene o imposta un valore che determina se utilizzare il renderer di 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à (ovvero 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
Trasforma 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");
// Crea un oggetto "ImageSaveOptions" che possiamo passare al metodo "Save" del documento
// per modificare il modo in cui il 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);
Mostra come configurare la compressione durante il salvataggio di un documento come JPEG.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.InsertImage(ImageDir + "Logo.jpg");
// Crea un oggetto "ImageSaveOptions" che possiamo passare al metodo "Save" del documento
// per modificare il modo in cui il metodo trasforma il documento in un'immagine.
ImageSaveOptions imageOptions = new ImageSaveOptions(SaveFormat.Jpeg);
// Imposta la proprietà "JpegQuality" su "10" per utilizzare una compressione più forte durante il rendering del documento.
// Ciò ridurrà la dimensione del file del documento, ma l'immagine mostrerà artefatti di compressione più evidenti.
imageOptions.JpegQuality = 10;
doc.Save(ArtifactsDir + "ImageSaveOptions.JpegQuality.HighCompression.jpg", imageOptions);
Assert.That(20000, Is.AtLeast(new FileInfo(ArtifactsDir + "ImageSaveOptions.JpegQuality.HighCompression.jpg").Length));
// Imposta la proprietà "JpegQuality" su "100" per utilizzare una compressione più debole durante il rendering del documento.
// Ciò migliorerà la qualità dell'immagine al costo di un aumento delle dimensioni del file.
imageOptions.JpegQuality = 100;
doc.Save(ArtifactsDir + "ImageSaveOptions.JpegQuality.HighQuality.jpg", imageOptions);
Assert.That(60000, Is.LessThan(new FileInfo(ArtifactsDir + "ImageSaveOptions.JpegQuality.HighQuality.jpg").Length));
Mostra come specificare una risoluzione durante il rendering di un documento in 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 oggetto "ImageSaveOptions" che possiamo passare al metodo "Save" del documento
// per modificare il modo in cui il metodo trasforma il documento in un'immagine.
ImageSaveOptions options = new ImageSaveOptions(SaveFormat.Png);
// Imposta la proprietà "Risoluzione" su "72" per eseguire il rendering del documento a 72 dpi.
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
// Imposta la proprietà "Risoluzione" su "300" per visualizzare il documento a 300 dpi.
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
Guarda anche
- class FixedPageSaveOptions
- spazio dei nomi Aspose.Words.Saving
- assemblea Aspose.Words
