ImageSaveOptions

ImageSaveOptions class

Позволяет указать дополнительные параметры при рендеринге страниц документа или фигур в изображения.

Чтобы узнать больше, посетитеУкажите параметры сохранения статья документации.

public class ImageSaveOptions : FixedPageSaveOptions

Конструкторы

Имя	Описание
ImageSaveOptions(SaveFormat)	Инициализирует новый экземпляр этого класса, который можно использовать для сохранения визуализированных изображений в .Tiff ,Png ,Bmp , Jpeg ,Emf ,Eps илиSvg формат.

Характеристики

Имя	Описание
AllowEmbeddingPostScriptFonts { get; set; }	Получает или задает логическое значение, указывающее, разрешено ли встраивание шрифтов PostScript в контуры PostScript при встраивании шрифтов TrueType в документ после его сохранения. Значение по умолчанию:`ЛОЖЬ` .
ColorMode { get; set; }	Получает или задает значение, определяющее способ отображения цветов.
CustomTimeZoneInfo { get; set; }	Получает или задает пользовательский часовой пояс, используемый для полей даты и времени.
DefaultTemplate { get; set; }	Получает или задает путь к шаблону по умолчанию (включая имя файла). Значение по умолчанию для этого свойства:пустая строка (Empty).
Dml3DEffectsRenderingMode { get; set; }	Получает или задает значение, определяющее способ визуализации 3D-эффектов.
virtual DmlEffectsRenderingMode { get; set; }	Получает или задает значение, определяющее способ визуализации эффектов DrawingML.
DmlRenderingMode { get; set; }	Получает или задает значение, определяющее способ отрисовки фигур DrawingML.
ExportGeneratorName { get; set; }	Когда`истинный` , приводит к внедрению имени и версии Aspose.Words в создаваемые файлы. Значение по умолчанию:`истинный` .
GraphicsQualityOptions { get; set; }	Позволяет указать режим и качество рендеринга дляGraphics объект.
HorizontalResolution { get; set; }	Получает или задает горизонтальное разрешение для созданных изображений (в точках на дюйм).
ImageBrightness { get; set; }	Получает или задает яркость сгенерированных изображений.
ImageColorMode { get; set; }	Получает или задает цветовой режим для создаваемых изображений.
ImageContrast { get; set; }	Получает или задает контрастность созданных изображений.
ImageSize { get; set; }	Получает или задает размер созданного изображения в пикселях.
ImlRenderingMode { get; set; }	Получает или задает значение, определяющее способ визуализации объектов рукописного ввода (InkML).
JpegQuality { get; set; }	Получает или задает значение, определяющее качество создаваемых изображений JPEG.
MemoryOptimization { get; set; }	Получает или задает значение, определяющее, следует ли выполнять оптимизацию памяти перед сохранением документа. Значение по умолчанию для этого свойства:`ЛОЖЬ` .
MetafileRenderingOptions { get; }	Позволяет указать, как метафайлы обрабатываются при визуализации.
NumeralFormat { get; set; }	Получает или устанавливает`NumeralFormat` используется для отрисовки цифр. По умолчанию используются европейские цифры.
virtual OptimizeOutput { get; set; }	Флаг указывает, требуется ли оптимизировать вывод. Если этот флаг установлен, избыточные вложенные холсты и пустые холсты удаляются, также объединяются соседние глифы с одинаковым форматированием. Примечание. На точность отображения содержимого может повлиять, если для этого свойства установлено значение`истинный` . По умолчанию:`ЛОЖЬ` .
PageSavingCallback { get; set; }	Позволяет контролировать сохранение отдельных страниц при экспорте документа в фиксированный формат страницы.
PageSet { get; set; }	Получает или задает страницы для рендеринга. По умолчанию — все страницы в документе.
PaperColor { get; set; }	Получает или задает цвет фона (бумаги) для сгенерированных изображений.
PixelFormat { get; set; }	Получает или задает формат пикселей для создаваемых изображений.
PrettyFormat { get; set; }	Когда`истинный` вывод в красивых форматах, где это применимо. Значение по умолчанию:`ЛОЖЬ` .
ProgressCallback { get; set; }	Вызывается при сохранении документа и принимает данные о ходе сохранения.
Resolution { set; }	Устанавливает горизонтальное и вертикальное разрешение для сгенерированных изображений в точках на дюйм.
override SaveFormat { get; set; }	Указывает формат, в котором будут сохранены обработанные страницы или фигуры документа, если используется этот объект параметров сохранения. Может быть raster Tiff ,Png ,Bmp , Jpeg или векторEmf ,Eps , Svg .
Scale { get; set; }	Получает или задает коэффициент масштабирования для созданных изображений.
TempFolder { get; set; }	Указывает папку для временных файлов, используемых при сохранении в файл DOC или DOCX. По умолчанию это свойство имеет значение`нулевой` и никакие временные файлы не используются.
ThresholdForFloydSteinbergDithering { get; set; }	Получает или задает порог, определяющий значение ошибки бинаризации в методе Флойда-Стейнберга. , когда`ImageBinarizationMethod` являетсяFloydSteinbergDithering .
TiffBinarizationMethod { get; set; }	Получает или задает метод, используемый при преобразовании изображений в формат 1 бит/пиксель , когда`SaveFormat` являетсяTiff and `TiffCompression` равноCcitt3 илиCcitt4 .
TiffCompression { get; set; }	Получает или задает тип сжатия, применяемый при сохранении созданных изображений в формате TIFF.
UpdateCreatedTimeProperty { get; set; }	Получает или задает значение, определяющее, будет ли`CreatedTime` свойство обновляется перед сохранением. Значение по умолчанию:`ЛОЖЬ` ;
UpdateFields { get; set; }	Получает или задает значение, определяющее, следует ли обновлять поля определенных типов перед сохранением документа в фиксированном формате страницы. Значение по умолчанию для этого свойства:`истинный` .
UpdateLastPrintedProperty { get; set; }	Получает или задает значение, определяющее, будет ли`LastPrinted` свойство обновляется перед сохранением.
UpdateLastSavedTimeProperty { get; set; }	Получает или задает значение, определяющее, будет ли`LastSavedTime` свойство обновляется перед сохранением.
UseAntiAliasing { get; set; }	Получает или задает значение, определяющее, использовать ли сглаживание для рендеринга.
UseGdiEmfRenderer { get; set; }	Получает или задает значение, определяющее, использовать ли средство визуализации метафайлов GDI+ или Aspose.Words при сохранении в EMF.
UseHighQualityRendering { get; set; }	Получает или задает значение, определяющее, следует ли использовать алгоритмы высококачественного (т. е. медленного) рендеринга.
VerticalResolution { get; set; }	Получает или задает вертикальное разрешение для созданных изображений (в точках на дюйм).

Методы

Имя	Описание
Clone()	Создает глубокую копию этого объекта.
override Equals(object)	Определяет, равен ли указанный объект по значению текущему объекту.

Примеры

Преобразует страницу документа Word в изображение с прозрачным или цветным фоном.

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

// Создаем объект ImageSaveOptions, который мы можем передать методу Save документа.
// чтобы изменить способ, которым этот метод преобразует документ в изображение.
ImageSaveOptions imgOptions = new ImageSaveOptions(SaveFormat.Png);

// Установите для свойства PaperColor прозрачный цвет, чтобы применить прозрачный цвет.
// фон документа при его рендеринге в изображение.
imgOptions.PaperColor = Color.Transparent;

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

// Установите для свойства PaperColor непрозрачный цвет, чтобы применить этот цвет
// в качестве фона документа при его рендеринге в изображение.
imgOptions.PaperColor = Color.LightCoral;

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

Показывает, как настроить сжатие при сохранении документа в формате JPEG.

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

// Создаем объект ImageSaveOptions, который мы можем передать методу Save документа.
// чтобы изменить способ, которым этот метод преобразует документ в изображение.
ImageSaveOptions imageOptions = new ImageSaveOptions(SaveFormat.Jpeg);

// Установите для свойства «JpegQuality» значение «10», чтобы использовать более сильное сжатие при рендеринге документа.
// Это уменьшит размер файла документа, но изображение будет отображать более заметные артефакты сжатия.
imageOptions.JpegQuality = 10;

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

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

// Установите для свойства «JpegQuality» значение «100», чтобы использовать более слабое сжатие при рендеринге документа.
// Это улучшит качество изображения за счет увеличения размера файла.
imageOptions.JpegQuality = 100;

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

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

Показывает, как указать разрешение при рендеринге документа в 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");

            // Создаем объект ImageSaveOptions, который мы можем передать методу Save документа.
            // чтобы изменить способ, которым этот метод преобразует документ в изображение.
            ImageSaveOptions options = new ImageSaveOptions(SaveFormat.Png);

            // Установите для свойства «Разрешение» значение «72», чтобы отобразить документ с разрешением 72 точки на дюйм.
            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
            // Установите для свойства «Разрешение» значение «300», чтобы отобразить документ с разрешением 300 точек на дюйм.
            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

Смотрите также

class FixedPageSaveOptions
пространство имен Aspose.Words.Saving
сборка Aspose.Words

ImagePixelFormat Enum ImageSavingArgs Class