WmfImage Class

Summary: Manipulate Microsoft Windows Metafile (WMF) images with our API, seamlessly
handling both vector and bitmap data stored within variable-length records.
Resize, rotate, and flip images with ease while setting custom image palettes.
Convert WMF files to compressed WMZ formats or save them in raster image formats
for versatile usage across platforms and applications.

Module: aspose.imaging.fileformats.wmf

Full Name: aspose.imaging.fileformats.wmf.WmfImage

Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, IObjectWithSizeF, MetaImage

Constructors

NameDescription
WmfImage()Создайте новый экземпляр класса WmfImage, инициализируя его для
дальнейшей манипуляции и обработки данных изображений Windows Metafile (WMF). Этот
конструктор предоставляет базовый объект для работы с изображениями WMF, позволяя
бесшовную интеграцию возможностей обработки изображений WMF в функциональность вашего приложения.
WmfImage(width, height)Создайте новый экземпляр класса WmfImage с настраиваемыми
параметрами ширины и высоты, облегчая создание пустых изображений WMF, адаптированных к конкретным размерам. Используйте этот конструктор для динамического создания
изображений WMF с точными размерами, обеспечивая гибкое создание и
манипуляцию изображениями в вашем приложении.

Properties

NameTypeAccessDescription
auto_adjust_paletteboolr/wПолучает или задает значение, указывающее, следует ли автоматически корректировать палитру.
background_colorColorr/wПолучает или задает значение цвета фона.
bits_per_pixelintrПолучите количество бит на пиксель изображения, указывающее уровень цветовой
глубины или гранулярности. Используйте это свойство для определения цветового представления и точности изображения, облегчая проверку совместимости и обработку, связанной с цветом, в вашем приложении.
boundsRectanglerПолучает границы объекта.
buffer_size_hintintr/wПолучает или задает подсказку о размере буфера, определяющую максимальный допустимый размер для всех внутренних буферов.
containerImagerПолучает контейнер Image.
data_stream_containerStreamContainerrПолучает поток данных объекта.
disposedboolrПолучает значение, указывающее, удалён ли этот экземпляр.
exif_dataExifDatar/wПолучает или задаёт экземпляр Exif.
file_formatFileFormatrПолучите значение формата файла, связанное с изображением, предоставляя информацию
о формате, в котором хранится изображение. Используйте это свойство для определения
формата файла изображения, облегчая проверки совместимости и
специфическую для формата обработку в вашем приложении.
frame_boundsRectanglerПолучите границы кадра, указывающие его положение и размеры внутри
изображения. Используйте это свойство для получения подробной информации о пространственном расположении кадра, позволяя точную манипуляцию и рендеринг в вашем приложении.
has_background_colorboolr/wПолучает или задает значение, указывающее, имеет ли изображение фоновый цвет.
heightintrПолучает высоту объекта.
height_ffloatrПолучите высоту изображения, представляющую количество пикселей по его вертикальной
оси. Используйте это свойство для определения пространственных размеров и соотношения сторон изображения, обеспечивая точную настройку макета и рендеринга в вашем приложении.
дюймintr/wПолучите или измените свойство дюйм, представляющее единицу измерения, обычно
используемую для указания физических размеров при печати или отображении. Используйте это
свойство для установки или получения значений дюймов, связанных с изображением,
обеспечивая точное представление физических размеров в вашем приложении.
interrupt_monitorInterruptMonitorr/wПолучает или задает монитор прерываний.
is_cachedboolrПолучите логическое значение, указывающее, кэшированы ли данные объекта в данный момент,
устраняя необходимость дополнительных операций чтения данных. Используйте это свойство
для оптимизации производительности, определяя, доступны ли данные объекта сразу
без необходимости затратных процессов получения данных в вашем приложении.
metadataImageMetadatarПолучает метаданные изображения.
paletteIColorPaletter/wПолучает или задает цветовую палитру. Цветовая палитра не используется, когда пиксели представлены напрямую.
recordsMetaObjectListr/wПолучает или задает записи.
sizeSizerПолучает размер объекта.
size_fSizeFrПолучает размер объекта в дюймах.
use_paletteboolrПолучает значение, указывающее, используется ли палитра изображения.
widthintrПолучает ширину объекта.
width_ffloatrПолучите ширину изображения, указывающую количество пикселей по его
горизонтальной оси. Используйте это свойство для определения пространственных размеров
и соотношения сторон изображения, обеспечивая точную настройку макета и рендеринга в вашем
приложении.
xmp_dataXmpPacketWrapperr/wПолучает или задает данные Xmp.

Methods

NameDescription
add_record(record)Включите указанный объект записи в изображение, обогащая его содержимое
дополнительными данными или метаданными. Используйте этот метод для бесшовной интеграции объектов записи
в изображение, облегчая комплексное хранение и организацию данных в вашем приложении.
cache_data()Эффективно кэшируйте данные, устраняя необходимость дополнительной загрузки из
базового DataStreamSupporter.data_stream_container. Используйте этот
метод для оптимизации производительности и снижения использования ресурсов в вашем приложении
путем хранения и доступа к локальному кэшу данных.
can_load(file_path)Определяет, можно ли загрузить изображение из указанного пути к файлу.
can_load(file_path, load_options)Определяет, можно ли загрузить изображение из указанного пути к файлу и, при желании, используя указанные параметры открытия.
can_load(stream)Определяет, можно ли загрузить изображение из указанного потока.
can_load(stream, load_options)Определяет, можно ли загрузить изображение из указанного потока и, при желании, используя указанные loadOptions.
can_load_stream(stream)Определяет, можно ли загрузить изображение из указанного потока.
can_load_stream_with_options(stream, load_options)Определяет, можно ли загрузить изображение из указанного потока и, при желании, используя указанные loadOptions.
can_load_with_options(file_path, load_options)Определяет, можно ли загрузить изображение из указанного пути к файлу и, при желании, используя указанные параметры открытия.
can_save(options)Определяет, можно ли сохранить изображение в указанный формат файла, представленный переданными параметрами сохранения.
create(files)Создаёт многостраничное изображение, содержащее указанные файлы.
create(files, throw_exception_on_load_error)Создаёт многостраничное изображение, содержащее указанные файлы.
create(image_options, width, height)Создаёт новое изображение с использованием указанных параметров создания.
create(image_options, width, height, pixels)Создаёт экземпляр RasterImage из предоставленного массива пикселей.

Проверяет, что указанные ширина и высота соответствуют размерам пиксельных данных.
Этот метод может использоваться только в лицензированном режиме библиотеки.
create(images)Создаёт новое изображение, используя указанные изображения в качестве страниц
create(images, dispose_images)Создает новое изображение из указанных изображений в виде страниц.
create(multipage_create_options)Создает указанные параметры создания многостраничного изображения.
create_from_files(files)Создает многостраничное изображение, содержащее указанные файлы в виде страниц с отложенной загрузкой.
create_from_files(files, throw_exception_on_load_error)Создает многостраничное изображение, содержащее указанные файлы в виде страниц с отложенной загрузкой.
create_from_images(images)Создаёт новое изображение, используя указанные изображения в качестве страниц
create_from_images(images, dispose_images)Создает новое изображение из указанных изображений в виде страниц.
crop(left_shift, right_shift, top_shift, bottom_shift)Обрезать изображение со смещениями.
crop(rectangle)Обрезает указанный прямоугольник.
get_default_options(args)Получает параметры изображения по умолчанию.
get_embedded_images()Получает встроенные изображения.
get_file_format(file_path)Получает формат файла.
get_file_format(stream)Получает формат файла.
get_file_format_of_stream(stream)Получает формат файла.
get_fitting_rectangle(rectangle, pixels, width, height)Получает прямоугольник, соответствующий текущему изображению.
get_fitting_rectangle(rectangle, width, height)Получает прямоугольник, соответствующий текущему изображению.
get_missed_fonts()Возвращает список шрифтов, использованных внутри метафайла, но не найденных.
get_original_options()Получает исходные параметры изображения.
get_post_script()Получить данные PostScript, связанные с изображением, предоставляя подробную
информацию о его структуре или содержимом. Используйте этот метод для получения
данных PostScript для дальнейшего анализа или обработки в вашем приложении,
позволяя использовать расширенные возможности, связанные с рендерингом или манипуляцией PostScript.
get_proportional_height(width, height, new_width)Получает пропорциональную высоту.
get_proportional_width(width, height, new_height)Получает пропорциональную ширину.
get_serialized_stream(image_options, clipping_rectangle, page_number)Преобразует в aps.
get_used_fonts()Получить список шрифтов, использованных в метафайле, предоставляя информацию о
ресурсах шрифтов, используемых в изображении. Используйте этот метод для анализа использования шрифтов
и обеспечения их доступности для рендеринга или дальнейшей обработки в вашем приложении.
load(file_path)Загружает новое изображение из указанного пути к файлу или URL.
Если filePath — путь к файлу, метод просто открывает файл.
Если filePath — URL, метод загружает файл, сохраняет его как временный и открывает.
load(file_path, load_options)Загружает новое изображение из указанного пути к файлу или URL.
Если filePath — путь к файлу, метод просто открывает файл.
Если filePath — URL, метод загружает файл, сохраняет его как временный и открывает.
load(stream)Загружает новое изображение из указанного потока.
load(stream, load_options)Загружает новое изображение из указанного потока.
load_stream(stream)Загружает новое изображение из указанного потока.
load_stream_with_options(stream, load_options)Загружает новое изображение из указанного потока.
load_with_options(file_path, load_options)Загружает новое изображение из указанного пути к файлу или URL.
Если filePath — путь к файлу, метод просто открывает файл.
Если filePath — URL, метод загружает файл, сохраняет его как временный и открывает.
remove_background()Удаляет фон.
remove_background(settings)Удаляет фон.
remove_metadata()Удаляет метаданные.
resize(new_width, new_height)Изменяет размер изображения. По умолчанию используется ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.
resize(new_width, new_height, resize_type)Изменяет размер до указанной новой ширины.
resize(new_width, new_height, settings)Изменяет размер изображения с расширенными параметрами.
resize_by_settings(new_width, new_height, settings)Изменяет размер изображения.
resize_by_type(new_width, new_height, resize_type)Изменяет размер изображения.
resize_canvas(new_rectangle)Изменить размер холста изображения, корректируя его размеры, сохраняя содержимое изображения
. Используйте этот метод для изменения размеров холста без изменения
содержимого, облегчая настройку макета и изменения композиции в вашем
приложении.
resize_height_proportionally(new_height)Пропорционально изменяет высоту. По умолчанию используется ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.
resize_height_proportionally(new_height, resize_type)Пропорционально изменяет высоту.
resize_height_proportionally(new_height, settings)Пропорционально изменяет высоту.
resize_height_proportionally_settings(new_height, settings)Пропорционально изменяет высоту.
resize_width_proportionally(new_width)Пропорционально изменяет ширину. По умолчанию используется ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.
resize_width_proportionally(new_width, resize_type)Пропорционально изменяет ширину.
resize_width_proportionally(new_width, settings)Пропорционально изменяет ширину.
resize_width_proportionally_settings(new_width, settings)Пропорционально изменяет ширину.
rotate(angle)Повернуть изображение вокруг центра.
rotate_flip(rotate_flip_type)Вращает, отражает или вращает и отражает изображение.
save()Сохраняет данные изображения в базовый поток.
save(file_path)Сохраняет изображение в указанное расположение файла.
save(file_path, options)Сохраняет данные объекта в указанное расположение файла в заданном формате файла согласно параметрам сохранения.
save(file_path, options, bounds_rectangle)Сохраняет данные объекта в указанное расположение файла в заданном формате файла согласно параметрам сохранения.
save(file_path, over_write)Сохраняет данные объекта в указанное расположение файла.
save(stream)Сохраняет данные в указанный stream.
save(stream, options_base)Сохраняет данные изображения в указанный поток в заданном формате файла согласно параметрам сохранения.
save(stream, options_base, bounds_rectangle)Сохраняет данные изображения в указанный поток в заданном формате файла согласно параметрам сохранения.
save_to_stream(stream)Сохраняет данные объекта в указанный поток.
save_to_stream_with_options(stream, options_base)Сохраняет данные изображения в указанный поток в заданном формате файла согласно параметрам сохранения.
save_to_stream_with_options_rect(stream, options_base, bounds_rectangle)Сохраняет данные изображения в указанный поток в заданном формате файла согласно параметрам сохранения.
save_with_options(file_path, options)Сохраняет данные объекта в указанное расположение файла в заданном формате файла согласно параметрам сохранения.
save_with_options_rect(file_path, options, bounds_rectangle)Сохраняет данные объекта в указанное расположение файла в заданном формате файла согласно параметрам сохранения.
set_palette(palette, update_colors)Применить указанную палитру к изображению, позволяя настраивать представление цветов
. Используйте этот метод для улучшения визуального рендеринга и достижения
определённых цветовых эффектов в вашем приложении.
try_set_metadata(metadata)Пытается установить экземпляр metadata, если этот экземпляр Image поддерживает и реализует экземпляр IImageMetadataFormat.

Constructor: WmfImage()

 WmfImage() 

Создайте новый экземпляр класса WmfImage, инициализируя его для
дальнейшей манипуляции и обработки данных изображений Windows Metafile (WMF). Этот
конструктор предоставляет базовый объект для работы с изображениями WMF, позволяя
бесшовную интеграцию возможностей обработки изображений WMF в функциональность вашего приложения.

Constructor: WmfImage(width, height)

 WmfImage(width, height) 

Создайте новый экземпляр класса WmfImage с настраиваемыми
параметрами ширины и высоты, облегчая создание пустых изображений WMF, адаптированных к конкретным размерам. Используйте этот конструктор для динамического создания
изображений WMF с точными размерами, обеспечивая гибкое создание и
манипуляцию изображениями в вашем приложении.

Parameters:

ПараметрТипОписание
widthintШирина.
heightintВысота.

Method: add_record(record)

 add_record(record) 

Включите указанный объект записи в изображение, обогащая его содержимое
дополнительными данными или метаданными. Используйте этот метод для бесшовной интеграции объектов записи
в изображение, облегчая комплексное хранение и организацию данных в вашем приложении.

Parameters:

ПараметрТипОписание
recordWmfObjectЗапись.

Returns

ТипОписание
intКоличество записей.

Method: can_load(file_path) [static]

 can_load(file_path) 

Определяет, можно ли загрузить изображение из указанного пути к файлу.

Parameters:

ПараметрТипОписание
file_pathstringПуть к файлу.

Returns

ТипОписание
booltrue если изображение может быть загружено из указанного файла; в противном случае false.

Method: can_load(file_path, load_options) [static]

 can_load(file_path, load_options) 

Определяет, можно ли загрузить изображение из указанного пути к файлу и, при желании, используя указанные параметры открытия.

Parameters:

ПараметрТипОписание
file_pathstringПуть к файлу.
load_optionsLoadOptionsОпции загрузки.

Returns

ТипОписание
booltrue если изображение может быть загружено из указанного файла; в противном случае false.

Method: can_load(stream) [static]

 can_load(stream) 

Определяет, можно ли загрузить изображение из указанного потока.

Parameters:

ПараметрТипОписание
поток_io.BufferedRandomПоток, из которого загружать.

Returns

ТипОписание
booltrue если изображение может быть загружено из указанного потока; в противном случае false.

Method: can_load(stream, load_options) [static]

 can_load(stream, load_options) 

Определяет, можно ли загрузить изображение из указанного потока и, при желании, используя указанные loadOptions.

Parameters:

ПараметрТипОписание
поток_io.BufferedRandomПоток, из которого загружать.
load_optionsLoadOptionsОпции загрузки.

Returns

ТипОписание
booltrue если изображение может быть загружено из указанного потока; в противном случае false.

Method: can_load_stream(stream) [static]

 can_load_stream(stream) 

Определяет, можно ли загрузить изображение из указанного потока.

Parameters:

ПараметрТипОписание
поток_io.BufferedRandomПоток, из которого загружать.

Returns

ТипОписание
booltrue если изображение может быть загружено из указанного потока; в противном случае false.

Method: can_load_stream_with_options(stream, load_options) [static]

 can_load_stream_with_options(stream, load_options) 

Определяет, можно ли загрузить изображение из указанного потока и, при желании, используя указанные loadOptions.

Parameters:

ПараметрТипОписание
поток_io.BufferedRandomПоток, из которого загружать.
load_optionsLoadOptionsОпции загрузки.

Returns

ТипОписание
booltrue если изображение может быть загружено из указанного потока; в противном случае false.

Method: can_load_with_options(file_path, load_options) [static]

 can_load_with_options(file_path, load_options) 

Определяет, можно ли загрузить изображение из указанного пути к файлу и, при желании, используя указанные параметры открытия.

Parameters:

ПараметрТипОписание
file_pathstringПуть к файлу.
load_optionsLoadOptionsОпции загрузки.

Returns

ТипОписание
booltrue если изображение может быть загружено из указанного файла; в противном случае false.

Method: can_save(options)

 can_save(options) 

Определяет, можно ли сохранить изображение в указанный формат файла, представленный переданными параметрами сохранения.

Parameters:

ПараметрТипОписание
optionsImageOptionsBaseПараметры сохранения, которые следует использовать.

Returns

ТипОписание
booltrue если изображение может быть сохранено в указанный формат файла, представленный переданными параметрами сохранения; в противном случае false.

Method: create(files) [static]

 create(files) 

Создаёт многостраничное изображение, содержащее указанные файлы.

Parameters:

ПараметрТипОписание
файлыstring[]Файлы.

Returns

ТипОписание
ImageМногостраничное изображение

Method: create(files, throw_exception_on_load_error) [static]

 create(files, throw_exception_on_load_error) 

Создаёт многостраничное изображение, содержащее указанные файлы.

Parameters:

ПараметрТипОписание
файлыstring[]Файлы.
throw_exception_on_load_errorboolесли установлено true [выбросить исключение при ошибке загрузки].

Returns

ТипОписание
ImageМногостраничное изображение

Method: create(image_options, width, height) [static]

 create(image_options, width, height) 

Создаёт новое изображение с использованием указанных параметров создания.

Parameters:

ПараметрТипОписание
image_optionsImageOptionsBaseПараметры изображения.
widthintШирина.
heightintВысота.

Returns

ТипОписание
ImageНовосозданное изображение.

Method: create(image_options, width, height, pixels) [static]

 create(image_options, width, height, pixels) 

Создаёт экземпляр RasterImage из предоставленного массива пикселей.

Проверяет, что указанные ширина и высота соответствуют размерам пиксельных данных.
Этот метод может использоваться только в лицензированном режиме библиотеки.

Parameters:

ПараметрТипОписание
image_optionsImageOptionsBaseПараметры, используемые для создания RasterImage.
widthintШирина RasterImage.
heightintВысота RasterImage.
пикселиint[]Массив значений пикселей, используемый для заполнения изображения.

Returns

ТипОписание
ImageОбъект RasterImage заполненный предоставленными данными пикселей.

Method: create(images) [static]

 create(images) 

Создаёт новое изображение, используя указанные изображения в качестве страниц

Parameters:

ПараметрТипОписание
imagesImage[]Изображения.

Returns

ТипОписание
ImageИзображение как IMultipageImage

Method: create(images, dispose_images) [static]

 create(images, dispose_images) 

Создает новое изображение из указанных изображений в виде страниц.

Parameters:

ПараметрТипОписание
imagesImage[]Изображения.
dispose_imagesboolесли установлено true [освободить изображения].

Returns

ТипОписание
ImageИзображение как IMultipageImage

Method: create(multipage_create_options) [static]

 create(multipage_create_options) 

Создает указанные параметры создания многостраничного изображения.

Parameters:

ПараметрТипОписание
multipage_create_optionsMultipageCreateOptionsПараметры создания многостраничного изображения.

Returns

ТипОписание
ImageМногостраничное изображение

Method: create_from_files(files) [static]

 create_from_files(files) 

Создает многостраничное изображение, содержащее указанные файлы в виде страниц с отложенной загрузкой.

Parameters:

ПараметрТипОписание
файлыstring[]Файлы.

Returns

ТипОписание
ImageМногостраничное изображение

Method: create_from_files(files, throw_exception_on_load_error) [static]

 create_from_files(files, throw_exception_on_load_error) 

Создает многостраничное изображение, содержащее указанные файлы в виде страниц с отложенной загрузкой.

Parameters:

ПараметрТипОписание
файлыstring[]Файлы.
throw_exception_on_load_errorboolесли установлено true выбросить исключение при ошибке загрузки.

Returns

ТипОписание
ImageМногостраничное изображение

Method: create_from_images(images) [static]

 create_from_images(images) 

Создаёт новое изображение, используя указанные изображения в качестве страниц

Parameters:

ПараметрТипОписание
imagesImage[]Изображения.

Returns

ТипОписание
ImageИзображение как IMultipageImage

Method: create_from_images(images, dispose_images) [static]

 create_from_images(images, dispose_images) 

Создает новое изображение из указанных изображений в виде страниц.

Parameters:

ПараметрТипОписание
imagesImage[]Изображения.
dispose_imagesboolесли установлено true [освободить изображения].

Returns

ТипОписание
ImageИзображение как IMultipageImage

Method: crop(left_shift, right_shift, top_shift, bottom_shift)

 crop(left_shift, right_shift, top_shift, bottom_shift) 

Обрезать изображение со смещениями.

Parameters:

ПараметрТипОписание
left_shiftintСдвиг влево.
right_shiftintСдвиг вправо.
top_shiftintСдвиг вверх.
bottom_shiftintСдвиг вниз.

Method: crop(rectangle)

 crop(rectangle) 

Обрезает указанный прямоугольник.

Parameters:

ПараметрТипОписание
rectangleRectangleПрямоугольник.

Method: get_default_options(args)

 get_default_options(args) 

Получает параметры изображения по умолчанию.

Parameters:

ПараметрТипОписание
argsSystem.ObjectАргументы.

Returns

ТипОписание
ImageOptionsBaseПараметры изображения по умолчанию.

Method: get_embedded_images()

 get_embedded_images() 

Получает встроенные изображения.

Returns

ТипОписание
EmbeddedImage[]Массив изображений

Method: get_file_format(file_path) [static]

 get_file_format(file_path) 

Получает формат файла.

Parameters:

ПараметрТипОписание
file_pathstringПуть к файлу.

Returns

ТипОписание
FileFormatОпределённый формат файла.

Method: get_file_format(stream) [static]

 get_file_format(stream) 

Получает формат файла.

Parameters:

ПараметрТипОписание
поток_io.BufferedRandomПоток.

Returns

ТипОписание
FileFormatОпределённый формат файла.

Method: get_file_format_of_stream(stream) [static]

 get_file_format_of_stream(stream) 

Получает формат файла.

Parameters:

ПараметрТипОписание
поток_io.BufferedRandomПоток.

Returns

ТипОписание
FileFormatОпределённый формат файла.

Method: get_fitting_rectangle(rectangle, pixels, width, height) [static]

 get_fitting_rectangle(rectangle, pixels, width, height) 

Получает прямоугольник, соответствующий текущему изображению.

Parameters:

ПараметрТипОписание
rectangleRectangleПрямоугольник, для которого определяется подходящий прямоугольник.
пикселиint[]32‑битные ARGB пиксели.
widthintШирина объекта.
heightintВысота объекта.

Returns

ТипОписание
RectangleПодходящий прямоугольник или исключение, если подходящий прямоугольник не найден.

Method: get_fitting_rectangle(rectangle, width, height) [static]

 get_fitting_rectangle(rectangle, width, height) 

Получает прямоугольник, соответствующий текущему изображению.

Parameters:

ПараметрТипОписание
rectangleRectangleПрямоугольник, для которого определяется подходящий прямоугольник.
widthintШирина объекта.
heightintВысота объекта.

Returns

ТипОписание
RectangleПодходящий прямоугольник или исключение, если подходящий прямоугольник не найден.

Method: get_missed_fonts()

 get_missed_fonts() 

Возвращает список шрифтов, использованных внутри метафайла, но не найденных.

Returns

ТипОписание
string[]Список шрифтов

Method: get_original_options()

 get_original_options() 

Получает исходные параметры изображения.

Returns

ТипОписание
ImageOptionsBaseИсходные параметры изображения.

Method: get_post_script()

 get_post_script() 

Получить данные PostScript, связанные с изображением, предоставляя подробную
информацию о его структуре или содержимом. Используйте этот метод для получения
данных PostScript для дальнейшего анализа или обработки в вашем приложении,
позволяя использовать расширенные возможности, связанные с рендерингом или манипуляцией PostScript.

Returns

ТипОписание
stringPostScript

Method: get_proportional_height(width, height, new_width) [static]

 get_proportional_height(width, height, new_width) 

Получает пропорциональную высоту.

Parameters:

ПараметрТипОписание
widthintШирина.
heightintВысота.
new_widthintНовая ширина.

Returns

ТипОписание
intПропорциональная высота.

Method: get_proportional_width(width, height, new_height) [static]

 get_proportional_width(width, height, new_height) 

Получает пропорциональную ширину.

Parameters:

ПараметрТипОписание
widthintШирина.
heightintВысота.
new_heightintНовая высота.

Returns

ТипОписание
intПропорциональная ширина.

Method: get_serialized_stream(image_options, clipping_rectangle, page_number)

 get_serialized_stream(image_options, clipping_rectangle, page_number) 

Преобразует в aps.

Parameters:

ПараметрТипОписание
image_optionsImageOptionsBaseПараметры изображения.
clipping_rectangleRectangleПрямоугольник обрезки.
page_numberint[]Номер страницы.

Returns

ТипОписание
_io.BufferedRandomСериализованный поток

Method: get_used_fonts()

 get_used_fonts() 

Получить список шрифтов, использованных в метафайле, предоставляя информацию о
ресурсах шрифтов, используемых в изображении. Используйте этот метод для анализа использования шрифтов
и обеспечения их доступности для рендеринга или дальнейшей обработки в вашем приложении.

Returns

ТипОписание
string[]Список шрифтов

Method: load(file_path) [static]

 load(file_path) 

Загружает новое изображение из указанного пути к файлу или URL.
Если filePath — путь к файлу, метод просто открывает файл.
Если filePath — URL, метод загружает файл, сохраняет его как временный и открывает.

Parameters:

ПараметрТипОписание
file_pathstringПуть к файлу или URL для загрузки изображения.

Returns

ТипОписание
ImageЗагруженное изображение.

Method: load(file_path, load_options) [static]

 load(file_path, load_options) 

Загружает новое изображение из указанного пути к файлу или URL.
Если filePath — путь к файлу, метод просто открывает файл.
Если filePath — URL, метод загружает файл, сохраняет его как временный и открывает.

Parameters:

ПараметрТипОписание
file_pathstringПуть к файлу или URL для загрузки изображения.
load_optionsLoadOptionsОпции загрузки.

Returns

ТипОписание
ImageЗагруженное изображение.

Method: load(stream) [static]

 load(stream) 

Загружает новое изображение из указанного потока.

Parameters:

ПараметрТипОписание
поток_io.BufferedRandomПоток для загрузки изображения.

Returns

ТипОписание
ImageЗагруженное изображение.

Method: load(stream, load_options) [static]

 load(stream, load_options) 

Загружает новое изображение из указанного потока.

Parameters:

ПараметрТипОписание
поток_io.BufferedRandomПоток для загрузки изображения.
load_optionsLoadOptionsОпции загрузки.

Returns

ТипОписание
ImageЗагруженное изображение.

Method: load_stream(stream) [static]

 load_stream(stream) 

Загружает новое изображение из указанного потока.

Parameters:

ПараметрТипОписание
поток_io.BufferedRandomПоток для загрузки изображения.

Returns

ТипОписание
ImageЗагруженное изображение.

Method: load_stream_with_options(stream, load_options) [static]

 load_stream_with_options(stream, load_options) 

Загружает новое изображение из указанного потока.

Parameters:

ПараметрТипОписание
поток_io.BufferedRandomПоток для загрузки изображения.
load_optionsLoadOptionsОпции загрузки.

Returns

ТипОписание
ImageЗагруженное изображение.

Method: load_with_options(file_path, load_options) [static]

 load_with_options(file_path, load_options) 

Загружает новое изображение из указанного пути к файлу или URL.
Если filePath — путь к файлу, метод просто открывает файл.
Если filePath — URL, метод загружает файл, сохраняет его как временный и открывает.

Parameters:

ПараметрТипОписание
file_pathstringПуть к файлу или URL для загрузки изображения.
load_optionsLoadOptionsОпции загрузки.

Returns

ТипОписание
ImageЗагруженное изображение.

Method: remove_background(settings)

 remove_background(settings) 

Удаляет фон.

Parameters:

ПараметрТипОписание
settingsRemoveBackgroundSettingsНастройки.

Method: resize(new_width, new_height)

 resize(new_width, new_height) 

Изменяет размер изображения. По умолчанию используется ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.

Parameters:

ПараметрТипОписание
new_widthintНовая ширина.
new_heightintНовая высота.

Method: resize(new_width, new_height, resize_type)

 resize(new_width, new_height, resize_type) 

Изменяет размер до указанной новой ширины.

Parameters:

ПараметрТипОписание
new_widthintНовая ширина.
new_heightintНовая высота.
resize_typeResizeTypeType of the resize.

Method: resize(new_width, new_height, settings)

 resize(new_width, new_height, settings) 

Изменяет размер изображения с расширенными параметрами.

Parameters:

ПараметрТипОписание
new_widthintНовая ширина.
new_heightintНовая высота.
settingsImageResizeSettingsThe resize settings.

Method: resize_by_settings(new_width, new_height, settings)

 resize_by_settings(new_width, new_height, settings) 

Изменяет размер изображения.

Parameters:

ПараметрТипОписание
new_widthintНовая ширина.
new_heightintНовая высота.
settingsImageResizeSettingsThe resize settings.

Method: resize_by_type(new_width, new_height, resize_type)

 resize_by_type(new_width, new_height, resize_type) 

Изменяет размер изображения.

Parameters:

ПараметрТипОписание
new_widthintНовая ширина.
new_heightintНовая высота.
resize_typeResizeTypeThe resize type.

Method: resize_canvas(new_rectangle)

 resize_canvas(new_rectangle) 

Изменить размер холста изображения, корректируя его размеры, сохраняя содержимое изображения
. Используйте этот метод для изменения размеров холста без изменения
содержимого, облегчая настройку макета и изменения композиции в вашем
приложении.

Parameters:

ПараметрТипОписание
new_rectangleRectangleНовый прямоугольник.

Method: resize_height_proportionally(new_height)

 resize_height_proportionally(new_height) 

Пропорционально изменяет высоту. По умолчанию используется ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.

Parameters:

ПараметрТипОписание
new_heightintНовая высота.

Method: resize_height_proportionally(new_height, resize_type)

 resize_height_proportionally(new_height, resize_type) 

Пропорционально изменяет высоту.

Parameters:

ПараметрТипОписание
new_heightintНовая высота.
resize_typeResizeTypeType of the resize.

Method: resize_height_proportionally(new_height, settings)

 resize_height_proportionally(new_height, settings) 

Пропорционально изменяет высоту.

Parameters:

ПараметрТипОписание
new_heightintНовая высота.
settingsImageResizeSettingsThe image resize settings.

Method: resize_height_proportionally_settings(new_height, settings)

 resize_height_proportionally_settings(new_height, settings) 

Пропорционально изменяет высоту.

Parameters:

ПараметрТипОписание
new_heightintНовая высота.
settingsImageResizeSettingsThe image resize settings.

Method: resize_width_proportionally(new_width)

 resize_width_proportionally(new_width) 

Пропорционально изменяет ширину. По умолчанию используется ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.

Parameters:

ПараметрТипОписание
new_widthintНовая ширина.

Method: resize_width_proportionally(new_width, resize_type)

 resize_width_proportionally(new_width, resize_type) 

Пропорционально изменяет ширину.

Parameters:

ПараметрТипОписание
new_widthintНовая ширина.
resize_typeResizeTypeType of the resize.

Method: resize_width_proportionally(new_width, settings)

 resize_width_proportionally(new_width, settings) 

Пропорционально изменяет ширину.

Parameters:

ПараметрТипОписание
new_widthintНовая ширина.
settingsImageResizeSettingsThe image resize settings.

Method: resize_width_proportionally_settings(new_width, settings)

 resize_width_proportionally_settings(new_width, settings) 

Пропорционально изменяет ширину.

Parameters:

ПараметрТипОписание
new_widthintНовая ширина.
settingsImageResizeSettingsThe image resize settings.

Method: rotate(angle)

 rotate(angle) 

Повернуть изображение вокруг центра.

Parameters:

ПараметрТипОписание
уголfloatThe rotate angle in degrees. Positive values will rotate clockwise.

Method: rotate_flip(rotate_flip_type)

 rotate_flip(rotate_flip_type) 

Вращает, отражает или вращает и отражает изображение.

Parameters:

ПараметрТипОписание
rotate_flip_typeRotateFlipTypeТип поворота и отражения.

Method: save(file_path)

 save(file_path) 

Сохраняет изображение в указанное расположение файла.

Parameters:

ПараметрТипОписание
file_pathstringThe file path to save the image to.

Method: save(file_path, options)

 save(file_path, options) 

Сохраняет данные объекта в указанное расположение файла в заданном формате файла согласно параметрам сохранения.

Parameters:

ПараметрТипОписание
file_pathstringПуть к файлу.
optionsImageOptionsBaseПараметры.

Method: save(file_path, options, bounds_rectangle)

 save(file_path, options, bounds_rectangle) 

Сохраняет данные объекта в указанное расположение файла в заданном формате файла согласно параметрам сохранения.

Parameters:

ПараметрТипОписание
file_pathstringПуть к файлу.
optionsImageOptionsBaseПараметры.
bounds_rectangleRectangleThe destination image bounds rectangle. Set the empty rectangle for use sourse bounds.

Method: save(file_path, over_write)

 save(file_path, over_write) 

Сохраняет данные объекта в указанное расположение файла.

Parameters:

ПараметрТипОписание
file_pathstringThe file path to save the object’s data to.
over_writeboolесли установлено true, перезаписать содержимое файла, иначе будет выполнено добавление.

Method: save(stream)

 save(stream) 

Сохраняет данные в указанный stream.

Parameters:

ПараметрТипОписание
поток_io.BufferedRandomПоток.

Method: save(stream, options_base)

 save(stream, options_base) 

Сохраняет данные изображения в указанный поток в заданном формате файла согласно параметрам сохранения.

Parameters:

ПараметрТипОписание
поток_io.BufferedRandomThe stream to save the image’s data to.
options_baseImageOptionsBaseThe save options.

Method: save(stream, options_base, bounds_rectangle)

 save(stream, options_base, bounds_rectangle) 

Сохраняет данные изображения в указанный поток в заданном формате файла согласно параметрам сохранения.

Parameters:

ПараметрТипОписание
поток_io.BufferedRandomThe stream to save the image’s data to.
options_baseImageOptionsBaseThe save options.
bounds_rectangleRectangleПрямоугольник границ целевого изображения. Установите пустой прямоугольник для использования границ источника.

Method: save_to_stream(stream)

 save_to_stream(stream) 

Сохраняет данные объекта в указанный поток.

Parameters:

ПараметрТипОписание
поток_io.BufferedRandomПоток, в который сохраняются данные объекта.

Method: save_to_stream_with_options(stream, options_base)

 save_to_stream_with_options(stream, options_base) 

Сохраняет данные изображения в указанный поток в заданном формате файла согласно параметрам сохранения.

Parameters:

ПараметрТипОписание
поток_io.BufferedRandomThe stream to save the image’s data to.
options_baseImageOptionsBaseThe save options.

Method: save_to_stream_with_options_rect(stream, options_base, bounds_rectangle)

 save_to_stream_with_options_rect(stream, options_base, bounds_rectangle) 

Сохраняет данные изображения в указанный поток в заданном формате файла согласно параметрам сохранения.

Parameters:

ПараметрТипОписание
поток_io.BufferedRandomThe stream to save the image’s data to.
options_baseImageOptionsBaseThe save options.
bounds_rectangleRectangleПрямоугольник границ целевого изображения. Установите пустой прямоугольник для использования границ источника.

Method: save_with_options(file_path, options)

 save_with_options(file_path, options) 

Сохраняет данные объекта в указанное расположение файла в заданном формате файла согласно параметрам сохранения.

Parameters:

ПараметрТипОписание
file_pathstringПуть к файлу.
optionsImageOptionsBaseПараметры.

Method: save_with_options_rect(file_path, options, bounds_rectangle)

 save_with_options_rect(file_path, options, bounds_rectangle) 

Сохраняет данные объекта в указанное расположение файла в заданном формате файла согласно параметрам сохранения.

Parameters:

ПараметрТипОписание
file_pathstringПуть к файлу.
optionsImageOptionsBaseПараметры.
bounds_rectangleRectangleThe destination image bounds rectangle. Set the empty rectangle for use sourse bounds.

Method: set_palette(palette, update_colors)

 set_palette(palette, update_colors) 

Применить указанную палитру к изображению, позволяя настраивать представление цветов
. Используйте этот метод для улучшения визуального рендеринга и достижения
определённых цветовых эффектов в вашем приложении.

Parameters:

ПараметрТипОписание
paletteIColorPaletteПалитра для установки.
update_colorsboolесли установить в true, цвета будут обновлены в соответствии с новой палитрой; иначе индексы цветов останутся без изменений.
Обратите внимание, что неизменённые индексы могут привести к сбою изображения при загрузке, если некоторые индексы не имеют
соответствующих записей в палитре.

Method: try_set_metadata(metadata)

 try_set_metadata(metadata) 

Пытается установить экземпляр metadata, если этот экземпляр Image поддерживает и реализует экземпляр IImageMetadataFormat.

Parameters:

ПараметрТипОписание
metadataIImageMetadataFormatМетаданные.

Returns

ТипОписание
boolИстина, если metadata не равно null и экземпляр IMetadataContainer
поддерживает и/или реализует экземпляр IImageMetadataFormat; в противном случае — ложь.

Examples

This example shows how to load a WMF image from a file and convert it to SVG using WmfRasterizationOptions.


from aspose.pycore import as_of, cast
from aspose.imaging import Image, Color, SizeF
from aspose.imaging.fileformats.wmf import WmfImage, WmfRenderMode
from aspose.imaging.imageoptions import SvgOptions, WmfRasterizationOptions

# Использование Aspose.Imaging.Image.Load — единый способ загрузки всех типов изображений, включая WMF.
with as_of(Image.load("test.wmf") as image:
	saveOptions = SvgOptions()
	# Текст будет преобразован в фигуры.
	saveOptions.text_as_shapes = True
	rasterizationOptions = WmfRasterizationOptions()
	# Цвет фона поверхности рисования.
	rasterizationOptions.background_color = Color.white_smoke
	# Размер страницы.
	rasterizationOptions.page_size = cast(SizeF, wmfImage.size)
	# Если встроенный emf существует, то рендерить emf; иначе рендерить wmf.
	rasterizationOptions.render_mode = WmfRenderMode.AUTO
	saveOptions.vector_rasterization_options = rasterizationOptions
	wmfImage.save("test.output.svg", saveOptions)

The following example shows how to convert compressed images (.emz,.wmz, *.svgz) to a raster format

from aspose.imaging import Image, Color
from aspose.imaging.imageoptions import PngOptions, VectorRasterizationOptions
from os.path import join
from aspose.pycore import as_of

files = ["example.emz", "example.wmz", "example.svgz"]
base_folder: str = join("D:", "Compressed")
for file in files:
	input_file: str = join(base_folder, file)
	out_file: str = input_file + ".png"
	with Image.load(input_file) as image:
		vector_rasterization_options = aspycore.as_of(image.get_default_options([Color.white, image.width, image.height]), VectorRasterizationOptions)
		obj_init = PngOptions()
		obj_init.vector_rasterization_options = vector_rasterization_options
		image.save(out_file, obj_init)

The following example shows how to convert a wmz images to wmf fromat

import aspose.pycore as aspycore
from aspose.imaging import Image, SizeF
from aspose.imaging.imageoptions import WmfRasterizationOptions, WmfOptions
from os.path import join

file: str = "example.wmz"
base_folder: str = join("D:", "Compressed")
input_file: str = join(base_folder, file)
out_file: str = input_file + ".wmf"
with Image.load(input_file) as image:
	obj_init = WmfRasterizationOptions()
	obj_init.page_size = aspycore.cast(SizeF, image.size)
	obj_init2 = WmfOptions()
	obj_init2.vector_rasterization_options = obj_init
	image.save(out_file, obj_init2)

The following example shows how to convert a wmf images to wmz format


from os.path import join as path_combine
import aspose.pycore as aspycore
from aspose.imaging import Image, SizeF
from aspose.imaging.imageoptions import WmfRasterizationOptions, WmfOptions

file = "castle.wmf"
base_folder = path_combine("D:", "Compressed")
input_file = path_combine(base_folder, file)
out_file = input_file + ".wmz"
with Image.load(input_file) as image:
	vector_rasterization_options = WmfRasterizationOptions()
	vector_rasterization_options.page_size = aspycore.cast(SizeF, image.size)
	obj_init2 = WmfOptions()
	obj_init2.vector_rasterization_options = vector_rasterization_options
	obj_init2.compress = True
	image.save(out_file, obj_init2)