ImageSaveOptions
Contenu
[
Cacher
]ImageSaveOptions class
Permet de spécifier des options supplémentaires lors du rendu des pages ou des formes du document en images.
Pour en savoir plus, visitez leSpécifier les options d’enregistrement article documentaire.
public class ImageSaveOptions : FixedPageSaveOptions
Constructeurs
| Nom | La description |
|---|---|
| ImageSaveOptions(SaveFormat) | Initialise une nouvelle instance de cette classe qui peut être utilisée pour enregistrer les images rendues dans le Tiff ,Png ,Bmp , Jpeg ,Emf ,Eps ouSvg format. |
Propriétés
| Nom | La description |
|---|---|
| AllowEmbeddingPostScriptFonts { get; set; } | Obtient ou définit une valeur booléenne indiquant s’il faut autoriser l’incorporation de polices avec des contours PostScript lors de l’incorporation de polices TrueType dans un document lors de son enregistrement. La valeur par défaut estFAUX . |
| ColorMode { get; set; } | Obtient ou définit une valeur déterminant la manière dont les couleurs sont rendues. |
| CustomTimeZoneInfo { get; set; } | Obtient ou définit le fuseau horaire local personnalisé utilisé pour les champs de date/heure. |
| DefaultTemplate { get; set; } | Obtient ou définit le chemin d’accès au modèle par défaut (y compris le nom de fichier). La valeur par défaut de cette propriété estchaîne vide (Empty). |
| Dml3DEffectsRenderingMode { get; set; } | Obtient ou définit une valeur déterminant la manière dont les effets 3D sont rendus. |
| virtual DmlEffectsRenderingMode { get; set; } | Obtient ou définit une valeur déterminant la façon dont les effets DrawingML sont rendus. |
| DmlRenderingMode { get; set; } | Obtient ou définit une valeur déterminant la façon dont les formes DrawingML sont rendues. |
| ExportGeneratorName { get; set; } | Quandvrai , entraîne l’intégration du nom et de la version d’Aspose.Words dans les fichiers produits. La valeur par défaut estvrai . |
| GraphicsQualityOptions { get; set; } | Permet de spécifier le mode et la qualité du rendu pour leGraphics objet. |
| HorizontalResolution { get; set; } | Obtient ou définit la résolution horizontale des images générées, en points par pouce. |
| ImageBrightness { get; set; } | Obtient ou définit la luminosité des images générées. |
| ImageColorMode { get; set; } | Obtient ou définit le mode de couleur pour les images générées. |
| ImageContrast { get; set; } | Obtient ou définit le contraste des images générées. |
| ImageSize { get; set; } | Obtient ou définit la taille d’une image générée en pixels. |
| ImlRenderingMode { get; set; } | Obtient ou définit une valeur déterminant la manière dont les objets Ink (InkML) sont rendus. |
| JpegQuality { get; set; } | Obtient ou définit une valeur déterminant la qualité des images JPEG générées. |
| MemoryOptimization { get; set; } | Obtient ou définit la valeur déterminant si l’optimisation de la mémoire doit être effectuée avant d’enregistrer le document. La valeur par défaut de cette propriété estFAUX . |
| MetafileRenderingOptions { get; } | Permet de spécifier comment les métafichiers sont traités dans la sortie rendue. |
| NumeralFormat { get; set; } | Obtient ou définitNumeralFormat utilisé pour le rendu des chiffres. Les chiffres européens sont utilisés par défaut. |
| virtual OptimizeOutput { get; set; } | L’indicateur indique s’il est nécessaire d’optimiser la sortie. Si cet indicateur est défini, les canevas imbriqués redondants et les canevas vides sont supprimés, également les glyphes voisins avec le même formatage sont concaténés. Remarque : la précision de l’affichage du contenu peut être affectée si cette propriété est définie survrai . La valeur par défaut estFAUX . |
| PageSavingCallback { get; set; } | Permet de contrôler la façon dont les pages séparées sont enregistrées lorsqu’un document est exporté au format de page fixe. |
| PageSet { get; set; } | Obtient ou définit les pages à restituer. La valeur par défaut est toutes les pages du document. |
| PaperColor { get; set; } | Obtient ou définit la couleur d’arrière-plan (papier) des images générées. |
| PixelFormat { get; set; } | Obtient ou définit le format de pixel pour les images générées. |
| PrettyFormat { get; set; } | Quandvrai jolis formats de sortie le cas échéant. La valeur par défaut estFAUX . |
| ProgressCallback { get; set; } | Appelé lors de l’enregistrement d’un document et accepte les données sur la progression de l’enregistrement. |
| Resolution { set; } | Définit la résolution horizontale et verticale des images générées, en points par pouce. |
| override SaveFormat { get; set; } | Spécifie le format dans lequel les pages ou formes du document rendues seront enregistrées si cet objet d’options d’enregistrement est utilisé. Peut être un raster Tiff ,Png ,Bmp , Jpeg ou vecteurEmf ,Eps , Svg . |
| Scale { get; set; } | Obtient ou définit le facteur de zoom pour les images générées. |
| TempFolder { get; set; } | Spécifie le dossier des fichiers temporaires utilisé lors de l’enregistrement dans un fichier DOC ou DOCX. Par défaut, cette propriété estnul et aucun fichier temporaire n’est utilisé. |
| ThresholdForFloydSteinbergDithering { get; set; } | Obtient ou définit le seuil qui détermine la valeur de l’erreur de binarisation dans la méthode Floyd-Steinberg. lorsqueImageBinarizationMethod estFloydSteinbergDithering . |
| TiffBinarizationMethod { get; set; } | Obtient ou définit la méthode utilisée lors de la conversion des images au format 1 bpp lorsqueSaveFormat estTiff et TiffCompression est égal àCcitt3 ouCcitt4 . |
| TiffCompression { get; set; } | Obtient ou définit le type de compression à appliquer lors de l’enregistrement des images générées au format TIFF. |
| UpdateCreatedTimeProperty { get; set; } | Obtient ou définit une valeur déterminant si leCreatedTime la propriété est mise à jour avant l’enregistrement. La valeur par défaut estFAUX ; |
| UpdateFields { get; set; } | Obtient ou définit une valeur déterminant si les champs de certains types doivent être mis à jour avant d’enregistrer le document dans un format de page fixe. La valeur par défaut de cette propriété estvrai . |
| UpdateLastPrintedProperty { get; set; } | Obtient ou définit une valeur déterminant si leLastPrinted la propriété est mise à jour avant l’enregistrement. |
| UpdateLastSavedTimeProperty { get; set; } | Obtient ou définit une valeur déterminant si leLastSavedTime la propriété est mise à jour avant l’enregistrement. |
| UseAntiAliasing { get; set; } | Obtient ou définit une valeur déterminant s’il faut ou non utiliser l’anticrénelage pour le rendu. |
| UseGdiEmfRenderer { get; set; } | Obtient ou définit une valeur déterminant s’il faut utiliser le moteur de rendu de métafichier GDI+ ou Aspose.Words lors de l’enregistrement dans EMF. |
| UseHighQualityRendering { get; set; } | Obtient ou définit une valeur déterminant s’il faut ou non utiliser des algorithmes de rendu de haute qualité (c’est-à-dire lents). |
| VerticalResolution { get; set; } | Obtient ou définit la résolution verticale des images générées, en points par pouce. |
Méthodes
| Nom | La description |
|---|---|
| Clone() | Crée un clone profond de cet objet. |
| override Equals(object) | Détermine si l’objet spécifié a une valeur égale à l’objet actuel. |
Exemples
Rend une page d’un document Word dans une image avec un arrière-plan transparent ou coloré.
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");
// Crée un objet "ImageSaveOptions" que l'on peut passer à la méthode "Save" du document
// pour modifier la manière dont cette méthode restitue le document en image.
ImageSaveOptions imgOptions = new ImageSaveOptions(SaveFormat.Png);
// Définissez la propriété "PaperColor" sur une couleur transparente pour appliquer un
// l'arrière-plan du document tout en le rendant en image.
imgOptions.PaperColor = Color.Transparent;
doc.Save(ArtifactsDir + "ImageSaveOptions.PaperColor.Transparent.png", imgOptions);
// Définit la propriété "PaperColor" sur une couleur opaque pour appliquer cette couleur
// comme arrière-plan du document lorsque nous le rendons en image.
imgOptions.PaperColor = Color.LightCoral;
doc.Save(ArtifactsDir + "ImageSaveOptions.PaperColor.LightCoral.png", imgOptions);
Montre comment configurer la compression lors de l’enregistrement d’un document au format JPEG.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.InsertImage(ImageDir + "Logo.jpg");
// Crée un objet "ImageSaveOptions" que l'on peut passer à la méthode "Save" du document
// pour modifier la manière dont cette méthode restitue le document en image.
ImageSaveOptions imageOptions = new ImageSaveOptions(SaveFormat.Jpeg);
// Définissez la propriété "JpegQuality" sur "10" pour utiliser une compression plus forte lors du rendu du document.
// Cela réduira la taille du fichier du document, mais l'image affichera des artefacts de compression plus importants.
imageOptions.JpegQuality = 10;
doc.Save(ArtifactsDir + "ImageSaveOptions.JpegQuality.HighCompression.jpg", imageOptions);
Assert.That(20000, Is.AtLeast(new FileInfo(ArtifactsDir + "ImageSaveOptions.JpegQuality.HighCompression.jpg").Length));
// Définissez la propriété "JpegQuality" sur "100" pour utiliser une compression plus faible lors du rendu du document.
// Cela améliorera la qualité de l'image au prix d'une taille de fichier accrue.
imageOptions.JpegQuality = 100;
doc.Save(ArtifactsDir + "ImageSaveOptions.JpegQuality.HighQuality.jpg", imageOptions);
Assert.That(60000, Is.LessThan(new FileInfo(ArtifactsDir + "ImageSaveOptions.JpegQuality.HighQuality.jpg").Length));
Montre comment spécifier une résolution lors du rendu d’un document au format 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");
// Crée un objet "ImageSaveOptions" que l'on peut passer à la méthode "Save" du document
// pour modifier la manière dont cette méthode restitue le document en image.
ImageSaveOptions options = new ImageSaveOptions(SaveFormat.Png);
// Définissez la propriété "Résolution" sur "72" pour rendre le document en 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
// Définissez la propriété "Résolution" sur "300" pour rendre le document en 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
Voir également
- class FixedPageSaveOptions
- espace de noms Aspose.Words.Saving
- Assemblée Aspose.Words
