Aspose::Words::Saving::ImageSaveOptions class
Содержание
[
Скрывать
]ImageSaveOptions class
Позволяет указать дополнительные параметры при рендеринге страниц документа или фигур в изображения. Чтобы узнать больше, посетите статью документации Specify Save Options.
class ImageSaveOptions : public Aspose::Words::Saving::FixedPageSaveOptions
Методы
| Метод | Описание |
|---|---|
| Clone() | Создаёт глубокую копию этого объекта. |
| static CreateSaveOptions(Aspose::Words::SaveFormat) | Создаёт объект параметров сохранения класса, подходящего для указанного формата сохранения. |
| static CreateSaveOptions(const System::String&) | Создаёт объект параметров сохранения класса, подходящего для расширения файла, указанного в данном имени файла. |
| Equals(System::SharedPtr<System::Object>) override | Определяет, равен ли указанный объект по значению текущему объекту. |
| get_AllowEmbeddingPostScriptFonts() const | Получает или задаёт логическое значение, указывающее, разрешено ли встраивание шрифтов с контурами PostScript при встраивании TrueType‑шрифтов в документ при его сохранении. Значение по умолчанию — false. |
| get_ColorMode() const | Получает значение, определяющее способ отображения цветов. |
| get_CustomTimeZoneInfo() const | Получает или задает пользовательский локальный часовой пояс, используемый для полей даты/времени. |
| get_DefaultTemplate() const | Получает или задает путь к шаблону по умолчанию (включая имя файла). Значение по умолчанию для этого свойства — empty string. |
| get_Dml3DEffectsRenderingMode() const | Получает значение, определяющее, как рендерятся 3D‑эффекты. |
| virtual get_DmlEffectsRenderingMode() | Получает или задает значение, определяющее, как рендерятся эффекты DrawingML. |
| get_DmlRenderingMode() const | Получает или задает значение, определяющее, как рендерятся фигуры DrawingML. |
| get_ExportGeneratorName() const | Когда true, имя и версия Aspose.Words встраиваются в создаваемые файлы. Значение по умолчанию — true. |
| get_GraphicsQualityOptions() const | Позволяет указать режим рендеринга и качество для объекта Graphics. |
| get_HorizontalResolution() const | Получает или задаёт горизонтальное разрешение генерируемых изображений в точках на дюйм. |
| get_ImageBrightness() const | Получает или задаёт яркость генерируемых изображений. |
| get_ImageColorMode() const | Получает или задаёт режим цвета генерируемых изображений. |
| get_ImageContrast() const | Получает или задаёт контраст генерируемых изображений. |
| get_ImageSize() const | Получает или задаёт размер генерируемого изображения в пикселях. |
| get_ImlRenderingMode() const | Получает или задает значение, определяющее, как отображаются объекты чернил (InkML). |
| get_JpegQuality() | Получает или задаёт значение, определяющее качество генерируемых JPEG‑изображений. |
| get_JpegQuality() const | Получает или задает значение, определяющее качество JPEG‑изображений в HTML‑документе. |
| get_MemoryOptimization() const | Получает значение, определяющее, следует ли выполнять оптимизацию памяти перед сохранением документа. Значение по умолчанию для этого свойства false. |
| get_MetafileRenderingOptions() | Позволяет указать, как метафайлы обрабатываются в результирующем выводе. |
| get_MetafileRenderingOptions() const | Позволяет указать параметры рендеринга метафайлов. |
| get_NumeralFormat() const | Получает NumeralFormat, используемый для отображения цифр. По умолчанию используются европейские цифры. |
| virtual get_OptimizeOutput() | Флаг указывает, требуется ли оптимизировать вывод. Если этот флаг установлен, избыточные вложенные канвасы и пустые канвасы удаляются, также соседние глифы с одинаковым форматированием объединяются. Примечание: Точность отображения содержимого может быть снижена, если это свойство установлено в true. По умолчанию — false. |
| get_PageLayout() const | Получает или задаёт макет, используемый при рендеринге нескольких страниц в один вывод. |
| get_PageSavingCallback() const | Позволяет управлять тем, как отдельные страницы сохраняются при экспорте документа в фиксированный формат страниц. |
| get_PageSet() | Получает или задает страницы для рендеринга. По умолчанию — все страницы документа. |
| get_PageSet() const | Получает или задает страницы для рендеринга. По умолчанию — все страницы документа. |
| get_PaperColor() | Получает или задаёт цвет фона (бумаги) генерируемых изображений. Значение по умолчанию — White. |
| get_PixelFormat() const | Получает или задаёт пиксельный формат генерируемых изображений. |
| get_PrettyFormat() const | Когда true, вывод форматируется красиво, где это применимо. Значение по умолчанию false. |
| get_ProgressCallback() const | Вызывается во время сохранения документа и принимает данные о прогрессе сохранения. |
| get_SaveFormat() override | Указывает формат, в котором будут сохраняться отрендеренные страницы документа или фигуры, если используется этот объект параметров сохранения. Может быть растровым Tiff, Png, Bmp, Jpeg или векторным Emf, Eps, WebP, Svg. |
| get_Scale() const | Получает или задаёт коэффициент масштабирования генерируемых изображений. |
| get_TempFolder() const | Указывает папку для временных файлов, используемых при сохранении в файл DOC или DOCX. По умолчанию это свойство равно null, и временные файлы не используются. |
| get_ThresholdForFloydSteinbergDithering() const | Получает или задаёт порог, определяющий значение ошибки бинаризации в методе Флойда‑Штейнберга, когда ImageBinarizationMethod установлен в FloydSteinbergDithering. |
| get_TiffBinarizationMethod() const | Получает или задает метод, используемый при преобразовании изображений в формат 1 bpp, когда SaveFormat равен Tiff и TiffCompression равен Ccitt3 или Ccitt4. |
| get_TiffCompression() const | Получает или задает тип сжатия, применяемый при сохранении сгенерированных изображений в формат TIFF. |
| get_UpdateAmbiguousTextFont() const | Определяет, будут ли атрибуты шрифта изменяться в соответствии с используемым кодом символа. |
| get_UpdateCreatedTimeProperty() const | Получает или задаёт значение, определяющее, будет ли свойство CreatedTime обновлено перед сохранением. Значение по умолчанию — false;. |
| get_UpdateFields() const | Получает значение, определяющее, следует ли обновлять поля определённых типов перед сохранением документа в фиксированный формат страниц. Значение по умолчанию для этого свойства — true. |
| get_UpdateLastPrintedProperty() const | Получает или задаёт значение, определяющее, будет ли свойство LastPrinted обновлено перед сохранением. |
| get_UpdateLastSavedTimeProperty() const | Получает или задаёт значение, определяющее, будет ли свойство LastSavedTime обновлено перед сохранением. |
| get_UpdateOleControlImages() const | Получает значение, определяющее, будет ли обновлено изображение представления OLE‑элементов. |
| get_UseAntiAliasing() const | Получает или задаёт значение, определяющее, использовать ли сглаживание при рендеринге. |
| get_UseGdiEmfRenderer() const | Получает или задает значение, определяющее, использовать ли GDI+ или рендерер метафайлов Aspose.Words при сохранении в EMF. |
| get_UseHighQualityRendering() const | Получает или задаёт значение, определяющее, использовать ли высококачественные (т.е. медленные) алгоритмы рендеринга. |
| get_VerticalResolution() const | Получает или задает вертикальное разрешение сгенерированных изображений в точках на дюйм. |
| GetType() const override | |
| ImageSaveOptions(Aspose::Words::SaveFormat) | Инициализирует новый экземпляр этого класса, который можно использовать для сохранения отрисованных изображений в форматах Tiff, Png, Bmp, Jpeg, Emf, Eps, WebP или Svg. |
| Is(const System::TypeInfo&) const override | |
| set_AllowEmbeddingPostScriptFonts(bool) | Сеттер для Aspose::Words::Saving::SaveOptions::get_AllowEmbeddingPostScriptFonts. |
| set_ColorMode(Aspose::Words::Saving::ColorMode) | Устанавливает значение, определяющее, как отображаются цвета. |
| set_CustomTimeZoneInfo(const System::SharedPtr<System::TimeZoneInfo>&) | Сеттер для Aspose::Words::Saving::SaveOptions::get_CustomTimeZoneInfo. |
| set_DefaultTemplate(const System::String&) | Сеттер для Aspose::Words::Saving::SaveOptions::get_DefaultTemplate. |
| set_Dml3DEffectsRenderingMode(Aspose::Words::Saving::Dml3DEffectsRenderingMode) | Устанавливает значение, определяющее, как рендерятся 3D‑эффекты. |
| virtual set_DmlEffectsRenderingMode(Aspose::Words::Saving::DmlEffectsRenderingMode) | Сеттер для Aspose::Words::Saving::SaveOptions::get_DmlEffectsRenderingMode. |
| set_DmlRenderingMode(Aspose::Words::Saving::DmlRenderingMode) | Сеттер для Aspose::Words::Saving::SaveOptions::get_DmlRenderingMode. |
| set_ExportGeneratorName(bool) | Сеттер для Aspose::Words::Saving::SaveOptions::get_ExportGeneratorName. |
| set_GraphicsQualityOptions(const System::SharedPtr<Aspose::Words::Saving::GraphicsQualityOptions>&) | Сеттер для Aspose::Words::Saving::ImageSaveOptions::get_GraphicsQualityOptions. |
| set_HorizontalResolution(float) | Сеттер для Aspose::Words::Saving::ImageSaveOptions::get_HorizontalResolution. |
| set_ImageBrightness(float) | Сеттер для Aspose::Words::Saving::ImageSaveOptions::get_ImageBrightness. |
| set_ImageColorMode(Aspose::Words::Saving::ImageColorMode) | Сеттер для Aspose::Words::Saving::ImageSaveOptions::get_ImageColorMode. |
| set_ImageContrast(float) | Сеттер для Aspose::Words::Saving::ImageSaveOptions::get_ImageContrast. |
| set_ImageSize(System::Drawing::Size) | Сеттер для Aspose::Words::Saving::ImageSaveOptions::get_ImageSize. |
| set_ImlRenderingMode(Aspose::Words::Saving::ImlRenderingMode) | Сеттер для Aspose::Words::Saving::SaveOptions::get_ImlRenderingMode. |
| set_JpegQuality(int32_t) | Сеттер для Aspose::Words::Saving::ImageSaveOptions::get_JpegQuality. |
| set_MemoryOptimization(bool) | Устанавливает значение, определяющее, следует ли выполнять оптимизацию памяти перед сохранением документа. Значение по умолчанию для этого свойства — false. |
| set_MetafileRenderingOptions(const System::SharedPtr<Aspose::Words::Saving::MetafileRenderingOptions>&) | Позволяет указать параметры рендеринга метафайлов. |
| set_NumeralFormat(Aspose::Words::Saving::NumeralFormat) | Устанавливает NumeralFormat, используемый для отображения цифр. По умолчанию используются европейские цифры. |
| virtual set_OptimizeOutput(bool) | Сеттер для Aspose::Words::Saving::FixedPageSaveOptions::get_OptimizeOutput. |
| set_PageLayout(const System::SharedPtr<Aspose::Words::Saving::MultiPageLayout>&) | Сеттер для Aspose::Words::Saving::ImageSaveOptions::get_PageLayout. |
| set_PageSavingCallback(const System::SharedPtr<Aspose::Words::Saving::IPageSavingCallback>&) | Позволяет управлять тем, как отдельные страницы сохраняются при экспорте документа в фиксированный формат страниц. |
| set_PageSet(const System::SharedPtr<Aspose::Words::Saving::PageSet>&) | Сеттер для Aspose::Words::Saving::ImageSaveOptions::get_PageSet. |
| set_PaperColor(System::Drawing::Color) | Сеттер для Aspose::Words::Saving::ImageSaveOptions::get_PaperColor. |
| set_PixelFormat(Aspose::Words::Saving::ImagePixelFormat) | Сеттер для Aspose::Words::Saving::ImageSaveOptions::get_PixelFormat. |
| set_PrettyFormat(bool) | Сеттер для Aspose::Words::Saving::SaveOptions::get_PrettyFormat. |
| set_ProgressCallback(const System::SharedPtr<Aspose::Words::Saving::IDocumentSavingCallback>&) | Сеттер для Aspose::Words::Saving::SaveOptions::get_ProgressCallback. |
| set_Resolution(float) | Устанавливает горизонтальное и вертикальное разрешение сгенерированных изображений в точках на дюйм. |
| set_SaveFormat(Aspose::Words::SaveFormat) override | Сеттер для Aspose::Words::Saving::ImageSaveOptions::get_SaveFormat. |
| set_Scale(float) | Сеттер для Aspose::Words::Saving::ImageSaveOptions::get_Scale. |
| set_TempFolder(const System::String&) | Сеттер для Aspose::Words::Saving::SaveOptions::get_TempFolder. |
| set_ThresholdForFloydSteinbergDithering(uint8_t) | Сеттер для Aspose::Words::Saving::ImageSaveOptions::get_ThresholdForFloydSteinbergDithering. |
| set_TiffBinarizationMethod(Aspose::Words::Saving::ImageBinarizationMethod) | Сеттер для Aspose::Words::Saving::ImageSaveOptions::get_TiffBinarizationMethod. |
| set_TiffCompression(Aspose::Words::Saving::TiffCompression) | Сеттер для Aspose::Words::Saving::ImageSaveOptions::get_TiffCompression. |
| set_UpdateAmbiguousTextFont(bool) | Сеттер для Aspose::Words::Saving::SaveOptions::get_UpdateAmbiguousTextFont. |
| set_UpdateCreatedTimeProperty(bool) | Сеттер для Aspose::Words::Saving::SaveOptions::get_UpdateCreatedTimeProperty. |
| set_UpdateFields(bool) | Устанавливает значение, определяющее, следует ли обновлять поля определённых типов перед сохранением документа в фиксированный формат страниц. Значение по умолчанию для этого свойства — true. |
| set_UpdateLastPrintedProperty(bool) | Сеттер для Aspose::Words::Saving::SaveOptions::get_UpdateLastPrintedProperty. |
| set_UpdateLastSavedTimeProperty(bool) | Сеттер для Aspose::Words::Saving::SaveOptions::get_UpdateLastSavedTimeProperty. |
| set_UpdateOleControlImages(bool) | Устанавливает значение, определяющее, будет ли обновлено изображение представления OLE‑элементов управления. |
| set_UseAntiAliasing(bool) | Сеттер для Aspose::Words::Saving::SaveOptions::get_UseAntiAliasing. |
| set_UseGdiEmfRenderer(bool) | Сеттер для Aspose::Words::Saving::ImageSaveOptions::get_UseGdiEmfRenderer. |
| set_UseHighQualityRendering(bool) | Сеттер для Aspose::Words::Saving::SaveOptions::get_UseHighQualityRendering. |
| set_VerticalResolution(float) | Сеттер для Aspose::Words::Saving::ImageSaveOptions::get_VerticalResolution. |
| static Type() |
Примеры
Отрисовывает страницу документа Word в изображение с прозрачным или цветным фоном.
auto doc = System::MakeObject<Aspose::Words::Document>();
auto builder = System::MakeObject<Aspose::Words::DocumentBuilder>(doc);
builder->get_Font()->set_Name(u"Times New Roman");
builder->get_Font()->set_Size(24);
builder->Writeln(u"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.");
builder->InsertImage(get_ImageDir() + u"Logo.jpg");
// Создайте объект "ImageSaveOptions", который мы можем передать методу "Save" документа
// чтобы изменить способ, которым этот метод отображает документ в изображение.
auto imgOptions = System::MakeObject<Aspose::Words::Saving::ImageSaveOptions>(Aspose::Words::SaveFormat::Png);
// Установите свойство "PaperColor" в прозрачный цвет, чтобы применить прозрачный
// фон документа при рендеринге его в изображение.
imgOptions->set_PaperColor(System::Drawing::Color::get_Transparent());
doc->Save(get_ArtifactsDir() + u"ImageSaveOptions.PaperColor.Transparent.png", imgOptions);
// Установите свойство "PaperColor" в непрозрачный цвет, чтобы применить этот цвет
// в качестве фона документа при его рендеринге в изображение.
imgOptions->set_PaperColor(System::Drawing::Color::get_LightCoral());
doc->Save(get_ArtifactsDir() + u"ImageSaveOptions.PaperColor.LightCoral.png", imgOptions);
Показывает, как настроить сжатие при сохранении документа в формате JPEG.
auto doc = System::MakeObject<Aspose::Words::Document>();
auto builder = System::MakeObject<Aspose::Words::DocumentBuilder>(doc);
builder->InsertImage(get_ImageDir() + u"Logo.jpg");
// Создайте объект "ImageSaveOptions", который мы можем передать методу "Save" документа
// чтобы изменить способ, которым этот метод отображает документ в изображение.
auto imageOptions = System::MakeObject<Aspose::Words::Saving::ImageSaveOptions>(Aspose::Words::SaveFormat::Jpeg);
// Установите свойство "JpegQuality" в "10", чтобы использовать более сильное сжатие при рендеринге документа.
// Это уменьшит размер файла документа, но изображение будет показывать более заметные артефакты сжатия.
imageOptions->set_JpegQuality(10);
doc->Save(get_ArtifactsDir() + u"ImageSaveOptions.JpegQuality.HighCompression.jpg", imageOptions);
// Установите свойство "JpegQuality" в "100", чтобы использовать более слабое сжатие при рендеринге документа.
// Это улучшит качество изображения за счёт увеличения размера файла.
imageOptions->set_JpegQuality(100);
doc->Save(get_ArtifactsDir() + u"ImageSaveOptions.JpegQuality.HighQuality.jpg", imageOptions);
Показывает, как указать разрешение при рендеринге документа в PNG.
auto doc = System::MakeObject<Aspose::Words::Document>();
auto builder = System::MakeObject<Aspose::Words::DocumentBuilder>(doc);
builder->get_Font()->set_Name(u"Times New Roman");
builder->get_Font()->set_Size(24);
builder->Writeln(u"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.");
builder->InsertImage(get_ImageDir() + u"Logo.jpg");
// Создайте объект "ImageSaveOptions", который мы можем передать методу "Save" документа
// чтобы изменить способ, которым этот метод отображает документ в изображение.
auto options = System::MakeObject<Aspose::Words::Saving::ImageSaveOptions>(Aspose::Words::SaveFormat::Png);
// Установите свойство "Resolution" в "72", чтобы отрендерить документ с разрешением 72 dpi.
options->set_Resolution(72.0f);
doc->Save(get_ArtifactsDir() + u"ImageSaveOptions.Resolution.72dpi.png", options);
// Установите свойство "Resolution" в "300", чтобы отрендерить документ с разрешением 300 dpi.
options->set_Resolution(300.0f);
doc->Save(get_ArtifactsDir() + u"ImageSaveOptions.Resolution.300dpi.png", options);
См. также
- Class FixedPageSaveOptions
- Namespace Aspose::Words::Saving
- Library Aspose.Words for C++
