ImageSaveOptions

ImageSaveOptions class

Ermöglicht die Angabe zusätzlicher Optionen beim Rendern von Dokumentseiten oder Formen in Bilder.

Um mehr zu erfahren, besuchen Sie dieGeben Sie Speicheroptionen an Dokumentationsartikel.

public class ImageSaveOptions : FixedPageSaveOptions

Konstrukteure

NameBeschreibung
ImageSaveOptions(SaveFormat)Initialisiert eine neue Instanz dieser Klasse, die zum Speichern gerenderter Bilder im verwendet werden kann.Tiff ,Png ,Bmp , Jpeg ,Emf ,Eps oderSvg format.

Eigenschaften

NameBeschreibung
AllowEmbeddingPostScriptFonts { get; set; }Ruft einen booleschen Wert ab oder legt diesen fest, der angibt, ob das Einbetten von Schriftarten mit PostScript-Umrissen zulässig ist , wenn TrueType-Schriftarten in ein Dokument eingebettet werden, sobald es gespeichert wird. Der Standardwert istFALSCH .
ColorMode { get; set; }Ruft einen Wert ab oder legt ihn fest, der bestimmt, wie Farben gerendert werden.
CustomTimeZoneInfo { get; set; }Ruft die benutzerdefinierte lokale Zeitzone ab, die für Datums-/Uhrzeitfelder verwendet wird, oder legt diese fest.
DefaultTemplate { get; set; }Ruft den Pfad zur Standardvorlage (einschließlich Dateiname) ab oder legt diesen fest. Der Standardwert für diese Eigenschaft istleerer String (Empty).
Dml3DEffectsRenderingMode { get; set; }Ruft einen Wert ab oder legt diesen fest, der bestimmt, wie 3D-Effekte gerendert werden.
virtual DmlEffectsRenderingMode { get; set; }Ruft einen Wert ab oder legt diesen fest, der bestimmt, wie DrawingML-Effekte gerendert werden.
DmlRenderingMode { get; set; }Ruft einen Wert ab oder legt diesen fest, der bestimmt, wie DrawingML-Formen gerendert werden.
ExportGeneratorName { get; set; }WannWAHR , bewirkt, dass der Name und die Version von Aspose.Words in erzeugte Dateien eingebettet werden. Der Standardwert istWAHR .
GraphicsQualityOptions { get; set; }Ermöglicht die Angabe des Rendering-Modus und der Qualität fürGraphics Objekt.
HorizontalResolution { get; set; }Ruft die horizontale Auflösung für die generierten Bilder in Punkten pro Zoll ab oder legt diese fest.
ImageBrightness { get; set; }Ruft die Helligkeit für die generierten Bilder ab oder legt sie fest.
ImageColorMode { get; set; }Ruft den Farbmodus für die generierten Bilder ab oder legt diesen fest.
ImageContrast { get; set; }Ruft den Kontrast für die generierten Bilder ab oder legt diesen fest.
ImageSize { get; set; }Ruft die Größe eines generierten Bildes in Pixel ab oder legt diese fest.
ImlRenderingMode { get; set; }Ruft einen Wert ab oder legt diesen fest, der bestimmt, wie Ink-Objekte (InkML) gerendert werden.
JpegQuality { get; set; }Ruft einen Wert ab oder legt diesen fest, der die Qualität der generierten JPEG-Bilder bestimmt.
MemoryOptimization { get; set; }Ruft einen Wert ab oder legt diesen fest, der bestimmt, ob vor dem Speichern des Dokuments eine Speicheroptimierung durchgeführt werden soll. Der Standardwert für diese Eigenschaft istFALSCH .
MetafileRenderingOptions { get; }Ermöglicht die Angabe, wie Metadateien in der gerenderten Ausgabe behandelt werden.
NumeralFormat { get; set; }Ruft ab oder legt festNumeralFormat Wird zur Darstellung von Ziffern verwendet. Standardmäßig werden europäische Ziffern verwendet.
virtual OptimizeOutput { get; set; }Flag gibt an, ob es zur Optimierung der Ausgabe erforderlich ist. Wenn dieses Flag gesetzt ist, werden redundante verschachtelte Leinwände und leere Leinwände entfernt, auch benachbarte Glyphen mit derselben Formatierung werden verkettet. Hinweis: Die Genauigkeit der Inhaltsanzeige kann beeinträchtigt werden, wenn Diese Eigenschaft ist auf festgelegtWAHR . Standard istFALSCH .
PageSavingCallback { get; set; }Ermöglicht die Steuerung, wie einzelne Seiten gespeichert werden, wenn ein Dokument in ein festes Seitenformat exportiert wird.
PageSet { get; set; }Ruft die zu rendernden Seiten ab oder legt diese fest. Standard sind alle Seiten im Dokument.
PaperColor { get; set; }Ruft die Hintergrundfarbe (Papierfarbe) für die generierten Bilder ab oder legt diese fest.
PixelFormat { get; set; }Ruft das Pixelformat für die generierten Bilder ab oder legt es fest.
PrettyFormat { get; set; }WannWAHR hübsche Ausgabeformate, sofern zutreffend. Der Standardwert istFALSCH .
ProgressCallback { get; set; }Wird beim Speichern eines Dokuments aufgerufen und akzeptiert Daten über den Speicherfortschritt.
Resolution { set; }Legt sowohl die horizontale als auch die vertikale Auflösung für die generierten Bilder in Punkten pro Zoll fest.
override SaveFormat { get; set; }Gibt das Format an, in dem die gerenderten Dokumentseiten oder Formen gespeichert werden, wenn dieses Speicheroptionsobjekt verwendet wird. Kann ein Raster sein Tiff ,Png ,Bmp , Jpeg oder VektorEmf ,Eps , Svg .
Scale { get; set; }Ruft den Zoomfaktor für die generierten Bilder ab oder legt diesen fest.
TempFolder { get; set; }Gibt den Ordner für temporäre Dateien an, die beim Speichern in einer DOC- oder DOCX-Datei verwendet werden. Standardmäßig ist diese EigenschaftNull und es werden keine temporären Dateien verwendet.
ThresholdForFloydSteinbergDithering { get; set; }Ruft den Schwellenwert ab oder legt diesen fest, der den Wert des Binärisierungsfehlers in der Floyd-Steinberg-Methode bestimmt. wannImageBinarizationMethod IstFloydSteinbergDithering .
TiffBinarizationMethod { get; set; }Ruft die beim Konvertieren von Bildern in das 1-bpp-Format verwendete Methode ab oder legt diese fest. wannSaveFormat IstTiff and TiffCompression ist gleichCcitt3 oderCcitt4 .
TiffCompression { get; set; }Ruft den Komprimierungstyp ab, der beim Speichern generierter Bilder im TIFF-Format angewendet werden soll, oder legt diesen fest.
UpdateCreatedTimeProperty { get; set; }Ruft einen Wert ab oder legt ihn fest, der bestimmt, ob dieCreatedTime Die Eigenschaft wird vor dem Speichern aktualisiert. Der Standardwert istFALSCH ;
UpdateFields { get; set; }Ruft einen Wert ab oder legt diesen fest, der bestimmt, ob Felder bestimmter Typen aktualisiert werden sollen, bevor das Dokument in einem festen Seitenformat gespeichert wird. Der Standardwert für diese Eigenschaft istWAHR .
UpdateLastPrintedProperty { get; set; }Ruft einen Wert ab oder legt ihn fest, der bestimmt, ob dieLastPrinted Eigenschaft wird vor dem Speichern aktualisiert.
UpdateLastSavedTimeProperty { get; set; }Ruft einen Wert ab oder legt ihn fest, der bestimmt, ob dieLastSavedTime Eigenschaft wird vor dem Speichern aktualisiert.
UseAntiAliasing { get; set; }Ruft einen Wert ab oder legt diesen fest, der bestimmt, ob Anti-Aliasing für das Rendering verwendet werden soll oder nicht.
UseGdiEmfRenderer { get; set; }Ruft einen Wert ab oder legt diesen fest, der bestimmt, ob beim Speichern in EMF der Metadatei-Renderer GDI+ oder Aspose.Words verwendet werden soll.
UseHighQualityRendering { get; set; }Ruft einen Wert ab oder legt diesen fest, der bestimmt, ob hochwertige (d. h. langsame) Rendering-Algorithmen verwendet werden sollen oder nicht.
VerticalResolution { get; set; }Ruft die vertikale Auflösung für die generierten Bilder in Punkten pro Zoll ab oder legt diese fest.

Methoden

NameBeschreibung
Clone()Erstellt einen tiefen Klon dieses Objekts.
override Equals(object)Bestimmt, ob das angegebene Objekt den gleichen Wert wie das aktuelle Objekt hat.

Beispiele

Rendert eine Seite eines Word-Dokuments in ein Bild mit transparentem oder farbigem Hintergrund.

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

// Erstellen Sie ein „ImageSaveOptions“-Objekt, das wir an die „Save“-Methode des Dokuments übergeben können
// um die Art und Weise zu ändern, wie diese Methode das Dokument in ein Bild rendert.
ImageSaveOptions imgOptions = new ImageSaveOptions(SaveFormat.Png);

// Setzen Sie die Eigenschaft „PaperColor“ auf eine transparente Farbe, um eine transparente Farbe anzuwenden
// Hintergrund des Dokuments beim Rendern in ein Bild.
imgOptions.PaperColor = Color.Transparent;

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

// Setzen Sie die Eigenschaft „PaperColor“ auf eine undurchsichtige Farbe, um diese Farbe anzuwenden
// als Hintergrund des Dokuments, während wir es in ein Bild rendern.
imgOptions.PaperColor = Color.LightCoral;

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

Zeigt, wie die Komprimierung beim Speichern eines Dokuments als JPEG konfiguriert wird.

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

// Erstellen Sie ein „ImageSaveOptions“-Objekt, das wir an die „Save“-Methode des Dokuments übergeben können
// um die Art und Weise zu ändern, wie diese Methode das Dokument in ein Bild rendert.
ImageSaveOptions imageOptions = new ImageSaveOptions(SaveFormat.Jpeg);

// Setzen Sie die Eigenschaft „JpegQuality“ auf „10“, um beim Rendern des Dokuments eine stärkere Komprimierung zu verwenden.
// Dadurch wird die Dateigröße des Dokuments verringert, das Bild weist jedoch deutlichere Komprimierungsartefakte auf.
imageOptions.JpegQuality = 10;

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

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

// Setzen Sie die Eigenschaft „JpegQuality“ auf „100“, um beim Rendern des Dokuments eine schwächere Komprimierung zu verwenden.
// Dies verbessert die Qualität des Bildes auf Kosten einer größeren Dateigröße.
imageOptions.JpegQuality = 100;

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

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

Zeigt, wie man beim Rendern eines Dokuments in PNG eine Auflösung angibt.

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

            // Erstellen Sie ein „ImageSaveOptions“-Objekt, das wir an die „Save“-Methode des Dokuments übergeben können
            // um die Art und Weise zu ändern, wie diese Methode das Dokument in ein Bild rendert.
            ImageSaveOptions options = new ImageSaveOptions(SaveFormat.Png);

            // Setzen Sie die Eigenschaft „Resolution“ auf „72“, um das Dokument mit 72 dpi darzustellen.
            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
            // Setzen Sie die Eigenschaft „Resolution“ auf „300“, um das Dokument mit 300 dpi darzustellen.
            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

Siehe auch

ImagePixelFormat Enum ImageSavingArgs Class