ImageSaveOptions

ImageSaveOptions class

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

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

public class ImageSaveOptions : FixedPageSaveOptions

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

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

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

ИмяОписание
AllowEmbeddingPostScriptFonts { get; set; }Возвращает или задает логическое значение, указывающее, разрешать ли встраивание шрифтов с контурами 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; }Указывает формат, в котором будут сохранены отрисованные страницы документа или формы, если используется этот объект параметров сохранения. Может быть растровым Tiff ,Png ,Bmp , Jpeg или векторEmf ,Eps , WebP ,Svg .
Scale { get; set; }Получает или задает коэффициент масштабирования для созданных изображений.
TempFolder { get; set; }Указывает папку для временных файлов, используемых при сохранении в файл DOC или DOCX. По умолчанию это свойствонулевой и временные файлы не используются.
ThresholdForFloydSteinbergDithering { get; set; }Возвращает или задает пороговое значение, определяющее значение ошибки бинаризации в методе Флойда-Стейнберга. когдаImageBinarizationMethod являетсяFloydSteinbergDithering .
TiffBinarizationMethod { get; set; }Возвращает или задает метод, используемый при преобразовании изображений в формат 1 bpp , когдаSaveFormat являетсяTiff и TiffCompression равноCcitt3 илиCcitt4 .
TiffCompression { get; set; }Возвращает или задает тип сжатия, применяемый при сохранении созданных изображений в формате TIFF.
UpdateAmbiguousTextFont { get; set; }Определяет, будут ли изменяться атрибуты шрифта в соответствии с используемым кодом символа.
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)Определяет, равен ли указанный объект по значению текущему объекту.

Примеры

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

// Установите свойство «Разрешение» на «300», чтобы отобразить документ с разрешением 300 точек на дюйм.
options.Resolution = 300;
doc.Save(ArtifactsDir + "ImageSaveOptions.Resolution.300dpi.png", options);

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

// Установите свойство «JpegQuality» на «100», чтобы использовать более слабое сжатие при визуализации документа.
// Это улучшит качество изображения за счет увеличения размера файла.
imageOptions.JpegQuality = 100;
doc.Save(ArtifactsDir + "ImageSaveOptions.JpegQuality.HighQuality.jpg", imageOptions);

Преобразует страницу документа 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);

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

ImagePixelFormat Enum ImageSavingArgs Class