ImageSaveOptions

ImageSaveOptions class

Gör det möjligt att ange ytterligare alternativ vid rendering av dokumentsidor eller former till bilder.

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

public class ImageSaveOptions : FixedPageSaveOptions

Konstruktörer

namnBeskrivning
ImageSaveOptions(SaveFormat)Initierar en ny instans av den här klassen som kan användas för att spara renderade bilder i Tiff ,Png ,Bmp , Jpeg ,Emf ,Eps , WebP ellerSvg format.

Egenskaper

namnBeskrivning
AllowEmbeddingPostScriptFonts { get; set; }Hämtar eller ställer in ett booleskt värde som anger om inbäddning av teckensnitt med PostScript-konturer ska tillåtas när TrueType-teckensnitt bäddas in i ett dokument när det sparas. Standardvärdet ärfalsk .
ColorMode { get; set; }Hämtar eller ställer in ett värde som avgör hur färger återges.
CustomTimeZoneInfo { get; set; }Hämtar eller ställer in en anpassad lokal tidszon som används för datum-/tidsfält.
DefaultTemplate { get; set; }Hämtar eller anger sökvägen till standardmallen (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 avgör hur 3D-effekter renderas.
virtual DmlEffectsRenderingMode { get; set; }Hämtar eller ställer in ett värde som avgör hur DrawingML-effekter renderas.
DmlRenderingMode { get; set; }Hämtar eller ställer in ett värde som avgör 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; }Gör det möjligt 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 avgör 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 anger värde som avgör om minnesoptimering ska utföras innan dokumentet sparas. Standardvärdet för den här egenskapen ärfalsk .
MetafileRenderingOptions { get; }Gör det möjligt att ange hur metafiler behandlas i den renderade utdatan.
NumeralFormat { get; set; }Hämtar eller sätterNumeralFormat används för rendering av siffror. Europeiska siffror används som standard.
virtual OptimizeOutput { get; set; }Flaggan anger om det är nödvändigt att optimera utdata. Om denna flagga är inställd tas redundanta kapslade arbetsytor och tomma arbetsytor bort, sammanfogas även angränsande tecken med samma formatering. Obs! Noggrannheten i innehållsvisningen kan påverkas om 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 ett fast sidformat.
PageSet { get; set; }Hämtar eller ställer in sidorna som ska renderas. Standard är alla sidor i dokumentet.
PaperColor { get; set; }Hämtar eller ställer in bakgrundsfärgen (pappersfärgen) 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 , pretty formats output där det är tillämpligt. Standardvärdet ärfalsk .
ProgressCallback { get; set; }Anropas när ett dokument sparas och accepterar data om sparningsförloppet.
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 i vilket de renderade dokumentsidorna eller formerna sparas om det här objektet för sparade alternativ används. Kan vara ett raster Tiff ,Png ,Bmp , Jpeg eller vektorEmf ,Eps , WebP ,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 man sparar till en DOC- eller DOCX-fil. Som standard är den här egenskapennull och inga temporära filer används.
ThresholdForFloydSteinbergDithering { get; set; }Hämtar eller ställer in tröskelvärdet som bestämmer värdet för binariseringsfelet i Floyd-Steinberg-metoden. närImageBinarizationMethod ärFloydSteinbergDithering .
TiffBinarizationMethod { get; set; }Hämtar eller ställer in metoden 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-format.
UpdateAmbiguousTextFont { get; set; }Avgör om teckensnittsattributen ska ändras beroende på den teckenkod som används.
UpdateCreatedTimeProperty { get; set; }Hämtar eller ställer in ett värde som avgör omCreatedTime egenskapen uppdateras innan den sparas. Standardvärdet ärfalsk ;
UpdateFields { get; set; }Hämtar eller anger 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 den sparas.
UpdateLastSavedTimeProperty { get; set; }Hämtar eller ställer in ett värde som avgör omLastSavedTime egenskapen uppdateras innan den sparas.
UseAntiAliasing { get; set; }Hämtar eller ställer in ett värde som avgör om antialiasing ska användas för rendering.
UseGdiEmfRenderer { get; set; }Hämtar eller anger ett värde som avgör om GDI+ eller Aspose.Words metafilrenderare ska användas vid sparning till EMF.
UseHighQualityRendering { get; set; }Hämtar eller ställer in ett värde som avgör om 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

namnBeskrivning
Clone()Skapar en djup klon av detta objekt.
override Equals(object)Avgör om det angivna objektet har samma värde som det aktuella objektet.

Exempel

Visar hur man anger en upplösning när man renderar ett dokument 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 "Save"-metod
// för att modifiera hur metoden renderar dokumentet till en bild.
ImageSaveOptions options = new ImageSaveOptions(SaveFormat.Png);

// Ställ in egenskapen "Upplösning" till "72" för att rendera dokumentet i 72 dpi.
options.Resolution = 72;
doc.Save(ArtifactsDir + "ImageSaveOptions.Resolution.72dpi.png", options);

// Ställ in egenskapen "Upplösning" till "300" för att rendera dokumentet i 300 dpi.
options.Resolution = 300;
doc.Save(ArtifactsDir + "ImageSaveOptions.Resolution.300dpi.png", options);

Visar hur man konfigurerar komprimering när man sparar ett dokument som 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 "Save"-metod
// för att modifiera hur metoden renderar dokumentet till en bild.
ImageSaveOptions imageOptions = new ImageSaveOptions(SaveFormat.Jpeg);
// Sätt egenskapen "JpegQuality" till "10" för att använda starkare komprimering vid rendering av dokumentet.
// Detta minskar dokumentets filstorlek, men bilden kommer att visa mer framträdande komprimeringsartefakter.
imageOptions.JpegQuality = 10;
doc.Save(ArtifactsDir + "ImageSaveOptions.JpegQuality.HighCompression.jpg", imageOptions);

// Sätt egenskapen "JpegQuality" till "100" för att använda svagare komprimering vid rendering av dokumentet.
// Detta kommer att förbättra bildens kvalitet till bekostnad av en ökad filstorlek.
imageOptions.JpegQuality = 100;
doc.Save(ArtifactsDir + "ImageSaveOptions.JpegQuality.HighQuality.jpg", imageOptions);

Återger en sida från 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 "Save"-metod
// för att modifiera hur 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 färg
// bakgrund till dokumentet när det renderas 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);

Se även

ImagePixelFormat Enum ImageSavingArgs Class