Класс SvgImage

Summary: Manipulate Scalar Vector Graphics (SVG) image files with our API, utilizing
the power of XML-based text format for seamless customization and scalability.
Easily load SVG images, rasterize vector elements, and convert to other formats,
while controlling compression levels to optimize file size and quality for your projects.

Module: aspose.imaging.fileformats.svg

Full Name: aspose.imaging.fileformats.svg.SvgImage

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

Constructors

Name	Description
SvgImage(path)	Создает новый объект класса SvgImage, используя указанный путь для поиска и загрузки изображения. Этот конструктор облегчает создание экземпляров изображений SVG из внешних файлов, обеспечивая бесшовную интеграцию в программные системы и рабочие процессы.
SvgImage(stream)	Создает новый экземпляр класса SvgImage, загружая изображение из предоставленного потока. Этот конструктор позволяет напрямую загружать изображения SVG из потоков, повышая гибкость и эффективность при работе с ресурсами изображений в программных приложениях.
SvgImage(svg_options, width, height)	Создает новый экземпляр класса SvgImage с указанными параметрами SVG опций, ширины и высоты изображения. Этот конструктор позволяет разработчикам инициализировать изображения SVG с пользовательскими опциями и размерами, обеспечивая гибкость при управлении содержимым и макетом SVG.
SvgImage(width, height)	Создает новый объект SvgImage с указанными шириной и высотой. Этот конструктор позволяет разработчикам создавать изображения SVG с предопределенными размерами, облегчая точный контроль над размером изображения во время инициализации.

Properties

Name	Type	Access	Description
auto_adjust_palette	bool	r/w	Получает или задает значение, указывающее, следует ли автоматически корректировать палитру.
background_color	Color	r/w	Получает или задает значение цвета фона.
bits_per_pixel	int	r	Возвращает количество бит на пиксель изображения. Важно отметить, что этот параметр не применяется к векторным изображениям, поскольку они не измеряются в пикселях. Это свойство предоставляет важную информацию о глубине цвета изображения, помогая в задачах обработки и манипуляции.
bounds	Rectangle	r	Получает границы объекта.
buffer_size_hint	int	r/w	Получает или задает подсказку о размере буфера, определяющую максимальный допустимый размер для всех внутренних буферов.
container	Image	r	Получает контейнер Image.
data_stream_container	StreamContainer	r	Получает поток данных объекта.
disposed	bool	r	Получает значение, указывающее, удалён ли этот экземпляр.
exif_data	ExifData	r/w	Получает или задаёт экземпляр Exif.
file_format	FileFormat	r	Возвращает формат файла изображения, предоставляя важные метаданные для обработки и проверки совместимости. Это свойство играет ключевую роль в определении подходящих стратегий декодирования и кодирования для эффективного управления данными изображения в разных системах и приложениях.
has_background_color	bool	r/w	Получает или задает значение, указывающее, имеет ли изображение фоновый цвет.
height	int	r	Получает высоту изображения.
height_f	float	r	Получает высоту объекта в дюймах.
interrupt_monitor	InterruptMonitor	r/w	Получает или задает монитор прерываний.
is_cached	bool	r	Возвращает логическое значение, указывающее, кэшированы ли данные объекта в данный момент , устраняя необходимость дополнительных операций чтения данных. Это свойство дает представление о текущем состоянии кэширования, оптимизируя получение данных и процессы обработки для повышения производительности и эффективности.
metadata	ImageMetadata	r	Получает метаданные изображения.
palette	IColorPalette	r/w	Получает или задает цветовую палитру. Цветовая палитра не используется, когда пиксели представлены напрямую.
size	Size	r	Получает размер объекта.
size_f	SizeF	r	Получает размер объекта в дюймах.
use_palette	bool	r	Получает значение, указывающее, используется ли палитра изображения.
width	int	r	Получает ширину изображения.
width_f	float	r	Получает ширину объекта в дюймах.
xmp_data	XmpPacketWrapper	r/w	Получает или задает данные Xmp.

Methods

Name	Description
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)	Создает новое изображение из указанных изображений в виде страниц.
create_from_stream(stream)	Инициализирует новый экземпляр класса SvgImage.
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_original_options()	Получает параметры на основе настроек оригинального файла. Это может быть полезно для сохранения глубины цвета и других параметров оригинального изображения без изменений. Например, если мы загружаем черно‑белое PNG‑изображение с 1 битом на пиксель и затем сохраняем его с помощью DataStreamSupporter.save(file_path) метода, будет получено PNG‑изображение с 8‑битами на пиксель. Чтобы избежать этого и сохранить PNG‑изображение с 1‑битом на пиксель, используйте этот метод для получения соответствующих параметров сохранения и передайте их в метод Image.save(file_path, options) в качестве второго параметра.
get_proportional_height(width, height, new_width)	Получает пропорциональную высоту.
get_proportional_width(width, height, new_height)	Получает пропорциональную ширину.
get_serialized_stream(image_options, clipping_rectangle, page_number)	Преобразует в aps.
load(file_path)	Загружает новое изображение из указанного пути к файлу или URL. Если filePath — путь к файлу, метод просто открывает файл. Если filePath — URL, метод загружает файл, сохраняет его как временный и открывает.
load(file_path, load_options)	Загружает новое изображение из указанного пути к файлу или URL. Если filePath — путь к файлу, метод просто открывает файл. Если filePath — URL, метод загружает файл, сохраняет его как временный и открывает.
load(stream)	Загружает раздел SVG.
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_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)	Сохраняет данные.
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: SvgImage(path)

 SvgImage(path) 

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

Parameters:

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

Constructor: SvgImage(stream)

 SvgImage(stream) 

Создает новый экземпляр класса SvgImage, загружая изображение
из предоставленного потока. Этот конструктор позволяет напрямую загружать изображения SVG
из потоков, повышая гибкость и эффективность при работе с ресурсами изображений в
программных приложениях.

Parameters:

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

See also:

Example # 1: This example shows how to load an SVG image from a file stream and rasterize …

Constructor: SvgImage(svg_options, width, height)

 SvgImage(svg_options, width, height) 

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

Parameters:

Параметр	Тип	Описание
svg_options	SvgOptions	Параметры SVG.
width	int	Ширина изображения.
height	int	Высота изображения.

Constructor: SvgImage(width, height)

 SvgImage(width, height) 

Создает новый объект SvgImage с указанными шириной и
высотой. Этот конструктор позволяет разработчикам создавать изображения SVG с предопределенными
размерами, облегчая точный контроль над размером изображения во время
инициализации.

Parameters:

Параметр	Тип	Описание
width	int	Ширина изображения.
height	int	Высота изображения.

Method: can_load(file_path) [static]

 can_load(file_path) 

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

Parameters:

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

Returns

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

Method: can_load(file_path, load_options) [static]

 can_load(file_path, load_options) 

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

Parameters:

Параметр	Тип	Описание
file_path	string	Путь к файлу.
load_options	LoadOptions	Опции загрузки.

Returns

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

Method: can_load(stream) [static]

 can_load(stream) 

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

Parameters:

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

Returns

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

Method: can_load(stream, load_options) [static]

 can_load(stream, load_options) 

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

Parameters:

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

Returns

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

Method: can_load_stream(stream) [static]

 can_load_stream(stream) 

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

Parameters:

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

Returns

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

Method: can_load_stream_with_options(stream, load_options) [static]

 can_load_stream_with_options(stream, load_options) 

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

Parameters:

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

Returns

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

Method: can_load_with_options(file_path, load_options) [static]

 can_load_with_options(file_path, load_options) 

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

Parameters:

Параметр	Тип	Описание
file_path	string	Путь к файлу.
load_options	LoadOptions	Опции загрузки.

Returns

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

Method: can_save(options)

 can_save(options) 

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

Parameters:

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

Returns

Тип	Описание
bool	true если изображение может быть сохранено в указанный формат файла, представленный переданными параметрами сохранения; в противном случае 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_error	bool	если установлено true [выбросить исключение при ошибке загрузки].

Returns

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

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

 create(image_options, width, height) 

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

Parameters:

Параметр	Тип	Описание
image_options	ImageOptionsBase	Параметры изображения.
width	int	Ширина.
height	int	Высота.

Returns

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

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

 create(image_options, width, height, pixels) 

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

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

Parameters:

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

Returns

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

Method: create(images) [static]

 create(images) 

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

Parameters:

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

Returns

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

Method: create(images, dispose_images) [static]

 create(images, dispose_images) 

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

Parameters:

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

Returns

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

Method: create(multipage_create_options) [static]

 create(multipage_create_options) 

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

Parameters:

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

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_error	bool	если установлено true выбросить исключение при ошибке загрузки.

Returns

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

Method: create_from_images(images) [static]

 create_from_images(images) 

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

Parameters:

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

Returns

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

Method: create_from_images(images, dispose_images) [static]

 create_from_images(images, dispose_images) 

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

Parameters:

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

Returns

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

Method: create_from_stream(stream) [static]

 create_from_stream(stream) 

Инициализирует новый экземпляр класса SvgImage.

Parameters:

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

Returns

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

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

 crop(left_shift, right_shift, top_shift, bottom_shift) 

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

Parameters:

Параметр	Тип	Описание
left_shift	int	Сдвиг влево.
right_shift	int	Сдвиг вправо.
top_shift	int	Сдвиг вверх.
bottom_shift	int	Сдвиг вниз.

Method: crop(rectangle)

 crop(rectangle) 

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

Parameters:

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

Method: get_default_options(args)

 get_default_options(args) 

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

Parameters:

Параметр	Тип	Описание
args	System.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_path	string	Путь к файлу.

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:

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

Returns

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

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

 get_fitting_rectangle(rectangle, width, height) 

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

Parameters:

Параметр	Тип	Описание
rectangle	Rectangle	Прямоугольник, для которого определяется подходящий прямоугольник.
width	int	Ширина объекта.
height	int	Высота объекта.

Returns

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

Method: get_original_options()

 get_original_options() 

Получает параметры на основе настроек оригинального файла.
Это может быть полезно для сохранения глубины цвета и других параметров оригинального изображения без изменений.
Например, если мы загружаем черно‑белое PNG‑изображение с 1 битом на пиксель и затем сохраняем его с помощью
DataStreamSupporter.save(file_path) метода, будет получено PNG‑изображение с 8‑битами на пиксель.
Чтобы избежать этого и сохранить PNG‑изображение с 1‑битом на пиксель, используйте этот метод для получения соответствующих параметров сохранения и передайте их
в метод Image.save(file_path, options) в качестве второго параметра.

Returns

Тип	Описание
ImageOptionsBase	Параметры, основанные на настройках исходного файла.

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

 get_proportional_height(width, height, new_width) 

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

Parameters:

Параметр	Тип	Описание
width	int	Ширина.
height	int	Высота.
new_width	int	Новая ширина.

Returns

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

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

 get_proportional_width(width, height, new_height) 

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

Parameters:

Параметр	Тип	Описание
width	int	Ширина.
height	int	Высота.
new_height	int	Новая высота.

Returns

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

Method: get_serialized_stream(image_options, clipping_rectangle, page_number)

 get_serialized_stream(image_options, clipping_rectangle, page_number) 

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

Parameters:

Параметр	Тип	Описание
image_options	ImageOptionsBase	Параметры изображения.
clipping_rectangle	Rectangle	Прямоугольник обрезки.
page_number	int[]	Номер страницы.

Returns

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

Method: load(file_path) [static]

 load(file_path) 

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

Parameters:

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

Returns

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

Method: load(file_path, load_options) [static]

 load(file_path, load_options) 

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

Parameters:

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

Returns

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

Method: load(stream) [static]

 load(stream) 

Загружает раздел SVG.

Parameters:

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

Returns

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

Method: load(stream, load_options) [static]

 load(stream, load_options) 

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

Parameters:

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

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_options	LoadOptions	Опции загрузки.

Returns

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

Method: load_with_options(file_path, load_options) [static]

 load_with_options(file_path, load_options) 

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

Parameters:

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

Returns

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

Method: remove_background(settings)

 remove_background(settings) 

Удаляет фон.

Parameters:

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

Method: resize(new_width, new_height)

 resize(new_width, new_height) 

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

Parameters:

Параметр	Тип	Описание
new_width	int	Новая ширина.
new_height	int	Новая высота.

Method: resize(new_width, new_height, resize_type)

 resize(new_width, new_height, resize_type) 

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

Parameters:

Параметр	Тип	Описание
new_width	int	Новая ширина.
new_height	int	Новая высота.
resize_type	ResizeType	The resize type.

Method: resize(new_width, new_height, settings)

 resize(new_width, new_height, settings) 

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

Parameters:

Параметр	Тип	Описание
new_width	int	Новая ширина.
new_height	int	Новая высота.
settings	ImageResizeSettings	The resize settings.

Method: resize_by_settings(new_width, new_height, settings)

 resize_by_settings(new_width, new_height, settings) 

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

Parameters:

Параметр	Тип	Описание
new_width	int	Новая ширина.
new_height	int	Новая высота.
settings	ImageResizeSettings	The resize settings.

Method: resize_by_type(new_width, new_height, resize_type)

 resize_by_type(new_width, new_height, resize_type) 

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

Parameters:

Параметр	Тип	Описание
new_width	int	Новая ширина.
new_height	int	Новая высота.
resize_type	ResizeType	The resize type.

Method: resize_height_proportionally(new_height)

 resize_height_proportionally(new_height) 

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

Parameters:

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

Method: resize_height_proportionally(new_height, resize_type)

 resize_height_proportionally(new_height, resize_type) 

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

Parameters:

Параметр	Тип	Описание
new_height	int	Новая высота.
resize_type	ResizeType	Type of the resize.

Method: resize_height_proportionally(new_height, settings)

 resize_height_proportionally(new_height, settings) 

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

Parameters:

Параметр	Тип	Описание
new_height	int	Новая высота.
settings	ImageResizeSettings	The image resize settings.

Method: resize_height_proportionally_settings(new_height, settings)

 resize_height_proportionally_settings(new_height, settings) 

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

Parameters:

Параметр	Тип	Описание
new_height	int	Новая высота.
settings	ImageResizeSettings	The image resize settings.

Method: resize_width_proportionally(new_width)

 resize_width_proportionally(new_width) 

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

Parameters:

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

Method: resize_width_proportionally(new_width, resize_type)

 resize_width_proportionally(new_width, resize_type) 

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

Parameters:

Параметр	Тип	Описание
new_width	int	Новая ширина.
resize_type	ResizeType	Type of the resize.

Method: resize_width_proportionally(new_width, settings)

 resize_width_proportionally(new_width, settings) 

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

Parameters:

Параметр	Тип	Описание
new_width	int	Новая ширина.
settings	ImageResizeSettings	The image resize settings.

Method: resize_width_proportionally_settings(new_width, settings)

 resize_width_proportionally_settings(new_width, settings) 

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

Parameters:

Параметр	Тип	Описание
new_width	int	Новая ширина.
settings	ImageResizeSettings	The image resize settings.

Method: rotate(angle)

 rotate(angle) 

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

Parameters:

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

Method: rotate_flip(rotate_flip_type)

 rotate_flip(rotate_flip_type) 

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

Parameters:

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

Method: save(file_path)

 save(file_path) 

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

Parameters:

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

Method: save(file_path, options)

 save(file_path, options) 

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

Parameters:

Параметр	Тип	Описание
file_path	string	Путь к файлу.
options	ImageOptionsBase	Параметры.

Method: save(file_path, options, bounds_rectangle)

 save(file_path, options, bounds_rectangle) 

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

Parameters:

Параметр	Тип	Описание
file_path	string	Путь к файлу.
options	ImageOptionsBase	Параметры.
bounds_rectangle	Rectangle	The 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_path	string	The file path to save the object’s data to.
over_write	bool	если установлено true, перезаписать содержимое файла, иначе будет выполнено добавление.

Method: save(stream)

 save(stream) 

Сохраняет данные.

Parameters:

Параметр	Тип	Описание
поток	_io.BufferedRandom	The stream to save data to.

Method: save(stream, options_base)

 save(stream, options_base) 

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

Parameters:

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

Method: save(stream, options_base, bounds_rectangle)

 save(stream, options_base, bounds_rectangle) 

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

Parameters:

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

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.BufferedRandom	The stream to save the image’s data to.
options_base	ImageOptionsBase	The 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.BufferedRandom	The stream to save the image’s data to.
options_base	ImageOptionsBase	The save options.
bounds_rectangle	Rectangle	Прямоугольник границ целевого изображения. Установите пустой прямоугольник для использования границ источника.

Method: save_with_options(file_path, options)

 save_with_options(file_path, options) 

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

Parameters:

Параметр	Тип	Описание
file_path	string	Путь к файлу.
options	ImageOptionsBase	Параметры.

Method: save_with_options_rect(file_path, options, bounds_rectangle)

 save_with_options_rect(file_path, options, bounds_rectangle) 

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

Parameters:

Параметр	Тип	Описание
file_path	string	Путь к файлу.
options	ImageOptionsBase	Параметры.
bounds_rectangle	Rectangle	The destination image bounds rectangle. Set the empty rectangle for use sourse bounds.

Method: set_palette(palette, update_colors)

 set_palette(palette, update_colors) 

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

Parameters:

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

Method: try_set_metadata(metadata)

 try_set_metadata(metadata) 

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

Parameters:

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

Returns

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

Examples

This example shows how to load an SVG image from a file stream and rasterize it to PNG.

import aspose.pycore as aspycore
from os.path import join
from aspose.imaging.fileformats.svg import SvgImage
from aspose.imaging.imageoptions import PngOptions, SvgRasterizationOptions

dir_: str = "c:\\temp"
# Загрузите SVG‑изображение из файлового потока.
with open(join(dir_, "test.svg"), "rb") as stream:
	with SvgImage(stream) as svg_image:
		# Чтобы растеризовать SVG, необходимо указать параметры растеризации.
		rasterization_options = SvgRasterizationOptions()
		save_options = PngOptions()
		save_options.vector_rasterization_options = rasterization_options
		svg_image.save(join(dir_, "test.output.png"), save_options)

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 svgz images to svg fromat

import aspose.pycore as aspycore
from aspose.imaging import Image, SizeF
from aspose.imaging.imageoptions import SvgRasterizationOptions, SvgOptions
from os.path import join

file: str = "example.svgz"
base_folder: str = join("D:", "Compressed")
input_file: str = join(base_folder, file)
out_file: str = input_file + ".svg"
with Image.load(input_file) as image:
	obj_init = SvgRasterizationOptions()
	obj_init.page_size = aspycore.cast(SizeF, image.size)
	obj_init2 = SvgOptions()
	obj_init2.vector_rasterization_options = obj_init
	image.save(out_file, obj_init2)

The following example shows how to convert a svg images to svgz 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 SvgRasterizationOptions, SvgOptions

file = "juanmontoya_lingerie.svg"
base_folder = path_combine("D:", "Compressed")
input_file = path_combine(base_folder, file)
out_file = input_file + ".svgz"
with Image.load(input_file) as image:
	vector_rasterization_options = SvgRasterizationOptions()
	vector_rasterization_options.page_size = aspycore.cast(SizeF, image.size)
	obj_init2 = SvgOptions()
	obj_init2.vector_rasterization_options = vector_rasterization_options
	obj_init2.compress = True
	image.save(out_file, obj_init2)