ImageSaveOptions

ImageSaveOptions class

Gör det möjligt att ange ytterligare alternativ när du renderar dokumentsidor eller former till bilder.

För att lära dig mer, besökAnge Spara alternativ dokumentationsartikel.

public class ImageSaveOptions : FixedPageSaveOptions

Konstruktörer

namn	Beskrivning
ImageSaveOptions(SaveFormat)	Initierar en ny instans av denna klass som kan användas för att spara renderade bilder i Tiff ,Png ,Bmp , Jpeg ,Emf ,Eps ellerSvg format.

Egenskaper

namn	Beskrivning
AllowEmbeddingPostScriptFonts { get; set; }	Hämtar eller ställer in ett booleskt värde som indikerar om man ska tillåta inbäddning av teckensnitt med PostScript outlines när inbäddning av TrueType-teckensnitt i ett dokument på det sparas. Standardvärdet ärfalsk .
ColorMode { get; set; }	Hämtar eller ställer in ett värde som bestämmer hur färger återges.
CustomTimeZoneInfo { get; set; }	Hämtar eller ställer in anpassad lokal tidszon som används för datum-/tidsfält.
DefaultTemplate { get; set; }	Hämtar eller ställer in sökvägen till standardmall (inklusive filnamn). Standardvärdet för den här egenskapen ärtom sträng (Empty).
Dml3DEffectsRenderingMode { get; set; }	Hämtar eller ställer in ett värde som bestämmer hur 3D-effekter renderas.
virtual DmlEffectsRenderingMode { get; set; }	Hämtar eller ställer in ett värde som bestämmer hur DrawingML-effekter renderas.
DmlRenderingMode { get; set; }	Hämtar eller ställer in ett värde som bestämmer hur DrawingML-former renderas.
ExportGeneratorName { get; set; }	NärSann , gör att namnet och versionen av Aspose.Words bäddas in i producerade filer. Standardvärdet ärSann .
GraphicsQualityOptions { get; set; }	Tillåter att ange renderingsläge och kvalitet förGraphics objekt.
HorizontalResolution { get; set; }	Hämtar eller ställer in den horisontella upplösningen för de genererade bilderna, i punkter per tum.
ImageBrightness { get; set; }	Hämtar eller ställer in ljusstyrkan för de genererade bilderna.
ImageColorMode { get; set; }	Hämtar eller ställer in färgläget för de genererade bilderna.
ImageContrast { get; set; }	Hämtar eller ställer in kontrasten för de genererade bilderna.
ImageSize { get; set; }	Hämtar eller ställer in storleken på en genererad bild i pixlar.
ImlRenderingMode { get; set; }	Hämtar eller ställer in ett värde som bestämmer hur bläckobjekt (InkML) renderas.
JpegQuality { get; set; }	Hämtar eller ställer in ett värde som bestämmer kvaliteten på de genererade JPEG-bilderna.
MemoryOptimization { get; set; }	Hämtar eller ställer in värde som avgör om minnesoptimering ska utföras innan dokumentet sparas. Standardvärdet för den här egenskapen ärfalsk .
MetafileRenderingOptions { get; }	Tillåter att ange hur metafiler behandlas i den renderade utdata.
NumeralFormat { get; set; }	Hämtar eller sätterNumeralFormat används för återgivning av siffror. Europeiska siffror används som standard.
virtual OptimizeOutput { get; set; }	Flagga indikerar om det krävs för att optimera utdata. Om denna flagga ställs in redundanta kapslade dukar och tomma dukar tas bort, sammanlänkas även grannglyfer med samma formatering. Obs! Noggrannheten i innehållsvisningen kan påverkas den här egenskapen är inställd påSann . Standard ärfalsk .
PageSavingCallback { get; set; }	Gör det möjligt att styra hur separata sidor sparas när ett dokument exporteras till fast sidformat.
PageSet { get; set; }	Hämtar eller ställer in sidorna att rendera. Standard är alla sidor i dokumentet.
PaperColor { get; set; }	Hämtar eller ställer in bakgrundsfärgen (papper) för de genererade bilderna.
PixelFormat { get; set; }	Hämtar eller ställer in pixelformatet för de genererade bilderna.
PrettyFormat { get; set; }	NärSann snygga format utdata där tillämpligt. Standardvärdet ärfalsk .
ProgressCallback { get; set; }	Anropas när ett dokument sparas och accepterar data om lagringsförlopp.
Resolution { set; }	Ställer in både horisontell och vertikal upplösning för de genererade bilderna, i punkter per tum.
override SaveFormat { get; set; }	Anger formatet som de renderade dokumentsidorna eller formerna kommer att sparas i om detta sparaalternativ-objekt används. Kan vara ett raster Tiff ,Png ,Bmp , Jpeg eller vektorEmf ,Eps , Svg .
Scale { get; set; }	Hämtar eller ställer in zoomfaktorn för de genererade bilderna.
TempFolder { get; set; }	Anger mappen för temporära filer som används när du sparar till en DOC- eller DOCX-fil. Som standard är denna egenskapnull och inga temporära filer används.
ThresholdForFloydSteinbergDithering { get; set; }	Hämtar eller ställer in tröskeln som bestämmer värdet för binariseringsfelet i Floyd-Steinberg-metoden. närImageBinarizationMethod ärFloydSteinbergDithering .
TiffBinarizationMethod { get; set; }	Hämtar eller ställer in metod som används vid konvertering av bilder till 1 bpp format närSaveFormat ärTiff och TiffCompression är lika medCcitt3 ellerCcitt4 .
TiffCompression { get; set; }	Hämtar eller ställer in vilken typ av komprimering som ska tillämpas när genererade bilder sparas i TIFF-formatet.
UpdateCreatedTimeProperty { get; set; }	Hämtar eller ställer in ett värde som avgör omCreatedTime egenskapen uppdateras innan du sparar. Standardvärdet ärfalsk ;
UpdateFields { get; set; }	Hämtar eller ställer in ett värde som avgör om fält av vissa typer ska uppdateras innan dokumentet sparas till ett fast sidformat. Standardvärdet för den här egenskapen ärSann .
UpdateLastPrintedProperty { get; set; }	Hämtar eller ställer in ett värde som avgör omLastPrinted egenskapen uppdateras innan du sparar.
UpdateLastSavedTimeProperty { get; set; }	Hämtar eller ställer in ett värde som avgör omLastSavedTime egenskapen uppdateras innan du sparar.
UseAntiAliasing { get; set; }	Hämtar eller ställer in ett värde som avgör om kantutjämning ska användas eller inte för rendering.
UseGdiEmfRenderer { get; set; }	Hämtar eller ställer in ett värde som avgör om GDI+ eller Aspose.Words-metafilrenderare ska användas när du sparar till EMF.
UseHighQualityRendering { get; set; }	Hämtar eller ställer in ett värde som avgör huruvida högkvalitativa (dvs långsamma) renderingsalgoritmer ska användas eller inte.
VerticalResolution { get; set; }	Hämtar eller ställer in den vertikala upplösningen för de genererade bilderna, i punkter per tum.

Metoder

namn	Beskrivning
Clone()	Skapar en djup klon av detta objekt.
override Equals(object)	Bestämmer om det angivna objektet har samma värde som det aktuella objektet.

Exempel

Återger en sida i ett Word-dokument till en bild med transparent eller färgad bakgrund.

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

// Skapa ett "ImageSaveOptions"-objekt som vi kan skicka till dokumentets "Spara"-metod
// för att ändra sättet på vilket den metoden renderar dokumentet till en bild.
ImageSaveOptions imgOptions = new ImageSaveOptions(SaveFormat.Png);

// Ställ in egenskapen "PaperColor" till en transparent färg för att tillämpa en transparent
// bakgrund till dokumentet medan du renderar det till en bild.
imgOptions.PaperColor = Color.Transparent;

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

// Ställ in egenskapen "PaperColor" till en ogenomskinlig färg för att tillämpa den färgen
// som bakgrund för dokumentet när vi renderar det till en bild.
imgOptions.PaperColor = Color.LightCoral;

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

Visar hur du konfigurerar komprimering medan du sparar ett dokument som en JPEG.

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

// Skapa ett "ImageSaveOptions"-objekt som vi kan skicka till dokumentets "Spara"-metod
// för att ändra sättet på vilket den metoden renderar dokumentet till en bild.
ImageSaveOptions imageOptions = new ImageSaveOptions(SaveFormat.Jpeg);

// Ställ in egenskapen "JpegQuality" till "10" för att använda starkare komprimering när du renderar dokumentet.
// Detta kommer att minska filstorleken på dokumentet, men bilden kommer att visa mer framträdande komprimeringsartefakter.
imageOptions.JpegQuality = 10;

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

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

// Ställ in egenskapen "JpegQuality" till "100" för att använda svagare komprimering när du renderar dokumentet.
// Detta kommer att förbättra kvaliteten på bilden till priset av en ökad filstorlek.
imageOptions.JpegQuality = 100;

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

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

Visar hur man anger en upplösning när ett dokument renderas till 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");

            // Skapa ett "ImageSaveOptions"-objekt som vi kan skicka till dokumentets "Spara"-metod
            // för att ändra sättet på vilket den metoden renderar dokumentet till en bild.
            ImageSaveOptions options = new ImageSaveOptions(SaveFormat.Png);

            // Ställ in egenskapen "Resolution" till "72" för att återge dokumentet i 72dpi.
            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
            // Ställ in egenskapen "Resolution" till "300" för att återge dokumentet i 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

Se även

• class FixedPageSaveOptions
• namnutrymme Aspose.Words.Saving
• hopsättning Aspose.Words