Класс Image
Summary: The image is the base class for all type of images.
Module: aspose.imaging
Full Name: aspose.imaging.Image
Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, DataStreamSupporter
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 | Получает высоту изображения. |
| interrupt_monitor | InterruptMonitor | r/w | Получает или задает монитор прерываний. |
| is_cached | bool | r | Возвращает значение, указывающее, кэшированы ли данные объекта в данный момент и не требуется ли чтение данных. |
| metadata | ImageMetadata | r | Получает метаданные изображения. |
| palette | IColorPalette | r/w | Получает или задает цветовую палитру. Цветовая палитра не используется, когда пиксели представлены напрямую. |
| size | Size | r | Получает размер изображения. |
| use_palette | bool | r | Получает значение, указывающее, используется ли палитра изображения. |
| width | int | 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) | Создает новое изображение из указанных изображений в виде страниц. |
| crop(left_shift, right_shift, top_shift, bottom_shift) | Обрезать изображение со смещениями. |
| crop(rectangle) | Обрезает указанный прямоугольник. |
| get_default_options(args) | Получает параметры по умолчанию. |
| 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) | Загружает новое изображение из указанного потока. |
| 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_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. |
Property: use_palette
Получает значение, указывающее, используется ли палитра изображения.
See also:
Example # 1: Determine if the palette is used by the image.
Method: can_load(file_path) [static]
can_load(file_path)
Определяет, можно ли загрузить изображение из указанного пути к файлу.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| file_path | string | Путь к файлу. |
Returns
| Тип | Описание |
|---|---|
| bool |
See also:
Example # 1: This example determines whether image can be loaded from a file.
Method: can_load(file_path, load_options) [static]
can_load(file_path, load_options)
Определяет, можно ли загрузить изображение из указанного пути к файлу и, при желании, используя указанные параметры открытия.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| file_path | string | Путь к файлу. |
| load_options | LoadOptions | Опции загрузки. |
Returns
| Тип | Описание |
|---|---|
| bool |
Method: can_load(stream) [static]
can_load(stream)
Определяет, можно ли загрузить изображение из указанного потока.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| поток | _io.BufferedRandom | Поток, из которого загружать. |
Returns
| Тип | Описание |
|---|---|
| bool |
See also:
Example # 1: This example determines whether image can be loaded from a file stream.
Method: can_load(stream, load_options) [static]
can_load(stream, load_options)
Определяет, можно ли загрузить изображение из указанного потока и, при желании, используя указанные loadOptions.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| поток | _io.BufferedRandom | Поток, из которого загружать. |
| load_options | LoadOptions | Опции загрузки. |
Returns
| Тип | Описание |
|---|---|
| bool |
Method: can_load_stream(stream) [static]
can_load_stream(stream)
Определяет, можно ли загрузить изображение из указанного потока.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| поток | _io.BufferedRandom | Поток, из которого загружать. |
Returns
| Тип | Описание |
|---|---|
| bool |
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 |
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 |
Method: can_save(options)
can_save(options)
Определяет, можно ли сохранить изображение в указанный формат файла, представленный переданными параметрами сохранения.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| options | ImageOptionsBase | Параметры сохранения, которые следует использовать. |
Returns
| Тип | Описание |
|---|---|
| bool |
See also:
Example # 1: This example shows how to determine whether image can be saved to the specifi…
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 | если установлено |
Returns
| Тип | Описание |
|---|---|
| Image | Многостраничное изображение |
Method: create(image_options, width, height) [static]
create(image_options, width, height)
Создаёт новое изображение с использованием указанных параметров создания.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| image_options | ImageOptionsBase | Параметры изображения. |
| width | int | Ширина. |
| height | int | Высота. |
Returns
| Тип | Описание |
|---|---|
| Image | Новосозданное изображение. |
See also:
Example # 1: This example creates a new Image file at some disk location as specified by S…
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 | если установлено |
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 | если установлено |
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 | если установлено |
Returns
| Тип | Описание |
|---|---|
| Image | Изображение как IMultipageImage |
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_file_format(file_path) [static]
get_file_format(file_path)
Получает формат файла.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| file_path | string | Путь к файлу. |
Returns
| Тип | Описание |
|---|---|
| FileFormat | Определённый формат файла. |
See also:
Example # 1: This example shows how to determine the image format without loading the enti…
Method: get_file_format(stream) [static]
get_file_format(stream)
Получает формат файла.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| поток | _io.BufferedRandom | Поток. |
Returns
| Тип | Описание |
|---|---|
| FileFormat | Определённый формат файла. |
See also:
Example # 1: This example shows how to determine the image format without loading the enti…
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 | Загруженное изображение. |
See also:
Example # 1: This example demonstrates the loading of an existing Image file into an insta…
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)
Загружает новое изображение из указанного потока.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| поток | _io.BufferedRandom | Поток для загрузки изображения. |
Returns
| Тип | Описание |
|---|---|
| Image | Загруженное изображение. |
See also:
Example # 1: This example demonstrates the use of a file stream objects to load an existin…
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: resize(new_width, new_height)
resize(new_width, new_height)
Изменяет размер изображения. По умолчанию используется ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| new_width | int | Новая ширина. |
| new_height | int | Новая высота. |
See also:
Example # 1: The following example shows how to resize a metafile (WMF and EMF).
Example # 2: The following example shows how to resize SVG image and save it to PNG.
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. |
See also:
Example # 1: Resize image using specific 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. |
See also:
Example # 1: This example loads an image and resizes it using various resizing settings.
Example # 2: Resize image using specific Resize Type.
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. |
See also:
Example # 1: This example loads an image and resizes it proportionally using various resiz…
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. |
See also:
Example # 1: This example loads an image and resizes it proportionally using various resiz…
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 | Тип поворота и отражения. |
See also:
Example # 1: This example demonstrates the use of Rotate operation on an image. Example lo…
Example # 2: This example loads an image, rotates it by 90 degrees clockwise and optionall…
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 | Параметры. |
See also:
Example # 1: This example shows the simple steps to save an Image. To demonstrate this ope…
Example # 2: The following example loads a BMP image from a file, then saves the image to …
Example # 3: The following example shows how to save an entire BMP image or part of it to …
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. |
See also:
Example # 1: The following example loads a BMP image from a file, then saves a rectangular…
Example # 2: The following example shows how to save an entire BMP image or part of it to …
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 | если установлено |
Method: save(stream)
save(stream)
Сохраняет данные объекта в указанный поток.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| поток | _io.BufferedRandom | Поток, в который сохраняются данные объекта. |
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. |
See also:
Example # 1: This example shows the process of saving an Image to MemoryStream. To demonst…
Example # 2: The following example loads an image from a file, then saves the image to a P…
Example # 3: The following example shows how to save an entire BMP image or part of it to …
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 | Прямоугольник границ целевого изображения. Установите пустой прямоугольник для использования границ источника. |
See also:
Example # 1: The following example loads an image from a file, then saves a rectangular pa…
Example # 2: The following example shows how to save an entire BMP image or part of it to …
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 | Если установить значение |
Method: try_set_metadata(metadata)
try_set_metadata(metadata)
Пытается установить экземпляр metadata, если данный экземпляр Image поддерживает и реализует тип IImageMetadataFormat.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| metadata | IImageMetadataFormat | Метаданные. |
Returns
| Тип | Описание |
|---|---|
| bool | True, если экземпляр Image поддерживает и реализует тип IImageMetadataFormat; иначе false. |
Examples
This example demonstrates the loading of an existing Image file into an instance of aspose.imaging.Image using file path specified
from aspose.imaging import Image
# Создайте экземпляр Image и инициализируйте его существующим файлом изображения из расположения на диске.
with Image.load(r"C:\temp\sample.bmp") as image:
# выполнить обработку изображения.
pass
This example creates a new Image file at some disk location as specified by Source property of the BmpOptions instance. Several properties for BmpOptions instance are set before creating the actual image. Especially the Source property, that refers to the actual disk location in this case.
from aspose.imaging import Image
from aspose.imaging.imageoptions import BmpOptions
from aspose.imaging.sources import FileCreateSource
#Создайте экземпляр `BmpOptions` и задайте его различные свойства.
with BmpOptions() as bmp_options:
bmp_options.bits_per_pixel = 24
#Создайте экземпляр `FileCreateSource` и назначьте его в качестве `source` для экземпляра `BmpOptions`.
#Второй параметр типа `Boolean` определяет, является ли создаваемый файл временным (is_temporal) или нет.
bmp_options.source = FileCreateSource(r"C:\temp\output.bmp", False)
#Создайте экземпляр Image и инициализируйте его экземпляром BmpOptions, вызвав метод Create.
with Image.create(bmp_options, 500, 500) as image:
#выполнить обработку изображения.
# сохранить все изменения.
image.save()
This example demonstrates the use of a file stream objects to load an existing Image file
from aspose.imaging import Image
# Создайте экземпляр FileStream.
with open(r"C:\temp\sample.bmp", "rb"):
#Создайте экземпляр класса Image и загрузите существующий файл через объект FileStream, вызвав метод Load.
with Image.load(stream) as image:
#выполнить обработку изображений.
pass
This example demonstrates the use of Rotate operation on an image. Example loads an existing image file from some disk location and performs the Rotate operation on the image according to the value of enumeration aspose.imaging.RotateFlipType
from aspose.imaging import Image, RotateFlipType
#Создать экземпляр класса изображения и инициализировать его существующим файлом изображения через путь к файлу
with Image.load(r"C:\temp\sample.bmp") as image:
# повернуть изображение на 180 градусов вокруг оси X
image.rotate_flip(RotateFlipType.ROTATE_180_FLIP_X)
# Сохраните все изменения.
image.save()
This example shows the simple steps to save an Image. To demonstrate this operation, we load an existing file from some disk location, performs rotate operation on the image and save the image in PSD format using file path
from aspose.imaging import Image, RotateFlipType
from aspose.imaging.imageoptions import PsdOptions
from os.path import join as path_join
directory = "c:\\temp"
#Создать экземпляр класса изображения и инициализировать его существующим файлом через путь к файлу
with Image.load(path_join(directory, "sample.bmp")) as image:
#Повернуть изображение на 180 градусов вокруг оси X
image.rotate_flip(RotateFlipType.ROTATE_180_FLIP_X)
#Сохранить изображение в формате PSD по пути к файлу с настройками по умолчанию PsdOptions
image.save(path_join(directory, "output.psd"), PsdOptions())
This example shows the process of saving an Image to MemoryStream. To demonstrate this operation, example loads an existing file from some disk location, performs rotate operation on the image and save the image in PSD format
from aspose.imaging import Image, RotateFlipType
from aspose.imaging.imageoptions import PsdOptions
from aspose.imaging.extensions import StreamExtensions as stream_ext
#Создать экземпляр MemoryStream
with stream_ext.create_memory_stream() as stream:
#Создать экземпляр класса изображения и инициализировать его существующим файлом через путь к файлу
with Image.load(r"C:\temp\sample.bmp") as image:
#Повернуть изображение на 180 градусов вокруг оси X
image.rotate_flip(RotateFlipType.ROTATE_180_FLIP_X)
#Сохранить изображение в формате PSD в MemoryStream с настройками по умолчанию PsdOptions
image.save(stream, PsdOptions())
This example determines whether image can be loaded from a file.
from aspose.imaging import Image
# Использовать абсолютный путь к файлу
can_load: bool = Image.can_load(r"c:\temp\sample.gif")
This example determines whether image can be loaded from a file stream.
from aspose.imaging import Image
from aspose.imaging.extensions import StreamExtensions as strm_ext
import os.path import join
directory = r"c:\temp"
canLoad = False
# Использовать файловый поток
with open(join(directory, "sample.bmp"), "rb"):
canLoad = Image.can_load(stream)
print(f"Can load the file: {canLoad}")
# Следующие данные не являются корректным потоком изображения, поэтому CanLoad возвращает false.
imageData = [0, 0, 0, 0, 0, 0, 0, 0]
with strm_ext.create_memory_stream_from_bytes(imageData) as stream:
canLoad = Image.can_load(stream)
print(f"Can load the byte buffer: {canLoad}")
This example shows how to determine the image format without loading the entire image from a file.
from aspose.imaging import Image
from os.path import join as path_join
directory = "c:\\temp\\"
# Использовать абсолютный путь к файлу
file_format = Image.get_file_format(path_join(directory, "sample.gif"))
print(f"The file format is {file_format}")
This example shows how to determine the image format without loading the entire image from a file stream.
from aspose.imaging import Image
from aspose.imaging.extensions import StreamExtensions as strm_ex
from os.path import join as path_join
directory = "c:\\temp\\"
# Использовать файловый поток
with open(path_join(directory, "sample.bmp"), "rb") as stream:
file_format = Image.get_file_format(stream)
print(f"The file format is {file_format}")
# Следующие данные не являются корректным потоком изображения, поэтому get_file_format возвращает FileFormat.UNKNOWN
imageData = bytearray([0, 0, 0, 0, 0, 0, 0, 0])
with strm_ex.create_memory_stream_from_bytes(imageData) as stream:
file_format = Image.get_file_format(stream)
print(f"The file format is {file_format}")
This example shows how to determine whether image can be saved to the specified file format represented by the passed save options.
from aspose.imaging import Image
from aspose.imaging.imageoptions import JpegOptions
from os.path import join as path_join
directory = "c:\\temp\\"
with Image.load(path_join(directory, "sample.gif")) as image:
saveOptions = JpegOptions()
saveOptions.quality = 50
# Определить, можно ли сохранить изображение в jpeg
canSave: bool = image.can_save(saveOptions)
print(canSave)
This example loads an image and resizes it using various resizing settings.
from aspose.imaging import Image, ImageResizeSettings, ResizeType, ImageFilterType,\
ColorQuantizationMethod
from os.path import join as path_join
directory = "c:\\temp\\"
resizeSettings = ImageResizeSettings()
# Адаптивный алгоритм, основанный на взвешенной и смешанной рациональной функции и интерполяции lanczos3.
resizeSettings.mode = ResizeType.ADAPTIVE_RESAMPLE
# Небольшой прямоугольный фильтр
resizeSettings.filter_type = ImageFilterType.SMALL_RECTANGULAR
# Количество цветов в палитре.
resizeSettings.entries_count = 256
# Квантование цвета не используется
resizeSettings.color_quantization_method = ColorQuantizationMethod.NONE
# Эвклидов метод
resizeSettings.ColorCompareMethod = ColorCompareMethod.Euclidian;
with Image.load(path_join(directory, "sample.gif")) as image:
# Уменьшите в 2 раза, используя адаптивный ресамплинг.
image.resize(image.width // 2, image.height // 2, resizeSettings)
image.save(path_join(directory, "downsample.adaptive.gif"))
This example loads an image and resizes it proportionally using various resizing methods. Only the width is specified, the height is calculated automatically.
from aspose.imaging import Image, ResizeType
from os.path import join as path_join
directory = "c:\\temp\\"
with Image.load(path_join(directory, "sample.gif")) as image:
# Увеличьте в 2 раза, используя ресамплинг ближайшего соседа.
image.resize_width_proportionally(image.width * 2, ResizeType.NEAREST_NEIGHBOUR_RESAMPLE)
image.save(path_join(directory, "upsample.nearestneighbour.gif"))
with Image.load(path_join(directory, "sample.gif")) as image:
# Уменьшите в 2 раза, используя ресамплинг ближайшего соседа.
image.resize_width_proportionally(image.width // 2, ResizeType.NEAREST_NEIGHBOUR_RESAMPLE)
image.save(path_join(directory, "downsample.nearestneighbour.gif"))
with Image.load(path_join(directory, "sample.gif")) as image:
# Увеличьте в 2 раза, используя билинейный ресамплинг.
image.resize_width_proportionally(image.width * 2, ResizeType.BILINEAR_RESAMPLE)
image.save(path_join(directory, "upsample.bilinear.gif"))
with Image.load(path_join(directory, "sample.gif")) as image:
# Уменьшите в 2 раза, используя билинейный ресамплинг.
image.resize_width_proportionally(image.width // 2, ResizeType.BILINEAR_RESAMPLE);
image.save(path_join(directory, "downsample.bilinear.gif"))
This example loads an image and resizes it proportionally using various resizing methods. Only the height is specified, the width is calculated automatically.
from aspose.imaging import Image, ResizeType
from os.path import join as path_join
directory = "c:\\temp\\"
with Image.load(path_join(directory, "sample.gif")) as image:
# Увеличьте в 2 раза, используя ресамплинг ближайшего соседа.
image.resize_height_proportionally(image.height * 2, ResizeType.NEAREST_NEIGHBOUR_RESAMPLE)
image.save(path_join(directory, "upsample.nearestneighbour.gif"))
with Image.load(path_join(directory, "sample.gif")) as image:
# Уменьшите в 2 раза, используя ресамплинг ближайшего соседа.
image.resize_height_proportionally(image.height // 2, ResizeType.NEAREST_NEIGHBOUR_RESAMPLE)
image.save(path_join(directory, "downsample.nearestneighbour.gif"))
with Image.load(path_join(directory, "sample.gif")) as image:
# Увеличьте в 2 раза, используя билинейный ресамплинг.
image.resize_height_proportionally(image.height * 2, ResizeType.BILINEAR_RESAMPLE)
image.save(path_join(directory, "upsample.bilinear.gif"))
with Image.load(path_join(directory, "sample.gif")) as image:
# Уменьшите в 2 раза, используя билинейный ресамплинг.
image.resize_height_proportionally(image.height // 2, ResizeType.BILINEAR_RESAMPLE)
image.save(path_join(directory, "downsample.bilinear.gif"))
This example loads an image, rotates it by 90 degrees clockwise and optionally flips the image horizontally and(or) vertically.
from aspose.imaging import Image, RotateFlipType
from os.path import join as path_join
directory = "c:\\temp\\"
rotateFlipTypes = [RotateFlipType.ROTATE_90_FLIP_NONE, RotateFlipType.ROTATE_90_FLIP_X,
RotateFlipType.ROTATE_90_FLIP_XY, RotateFlipType.ROTATE_90_FLIP_Y]
for rotateFlipType in rotateFlipTypes:
# Повернуть, отразить и сохранить в выходной файл.
with Image.Load(path_join(directory, "sample.bmp")) as image:
image.rotate_flip(rotateFlipType)
image.save(path_join(directory, f"sample.{rotateFlipType}.bmp"))
The following example loads a BMP image from a file, then saves the image to a PNG file.
from aspose.imaging import Image
from aspose.imaging.imageoptions import PngOptions
from os.path import join as path_join
directory = r"c:\temp"
with Image.load(path_join(dir, "sample.bmp")) as image:
# Сохранить всё изображение в файл PNG.
save_options = PngOptions()
image.save(path_join(dir, "output.png"), save_options)
The following example loads a BMP image from a file, then saves a rectangular part of the image to a PNG file.
from aspose.imaging import Image, Rectangle
from aspose.imaging.imageoptions import PngOptions
from os.path import join as path_join
directory = r"c:\temp"
with Image.load(path_join(dir, "sample.bmp")) as image:
# Сохранить верхнюю половину изображения в файл PNG.
save_options = PngOptions()
bounds = Rectangle(0, 0, image.width, image.height // 2)
image.save(path_join(dir, "output.png"), save_options, bounds)
The following example loads an image from a file, then saves the image to a PNG file stream.
from aspose.imaging import Image, Rectangle
from aspose.imaging.imageoptions import PngOptions
from os.path import join as path_join
directory = r"c:\temp"
with Image.load(path_join(dir, "sample.bmp")) as image:
save_options = PngOptions()
with open(path_join(dir, "output.png"), "w+b") as output_stream:
# Сохранить всё изображение в файловый поток.
image.save(output_stream, save_options)
The following example loads an image from a file, then saves a rectangular part of the image to a PNG file stream.
from aspose.imaging import Image, Rectangle
from aspose.imaging.imageoptions import PngOptions
from os.path import join as path_join
directory = r"c:\temp"
with Image.load(path_join(dir, "sample.bmp")) as image:
save_options = PngOptions()
bounds = Rectangle(0, 0, image.width, image.height // 2)
with open(path_join(dir, "output.png"), "w+b") as output_stream:
# Сохранить верхнюю половину изображения в файловый поток.
image.save(output_stream, save_options, bounds)
The following example shows how to save an entire BMP image or part of it to a file or stream.
from os.path import join as path_join
from aspose.pycore import as_of
from aspose.imaging import Image, ColorPaletteHelper
from aspose.imaging.imageoptions import BmpOptions
from aspose.imaging.extensions import StreamExtensions as strm_ext
directory = "c:\\temp\\"
with Image.load(path_join(directory, "sample.bmp")) as image:
bmpImage = as_of(image, BmpImage)
# Преобразовать в черно-белое изображение
bmpImage.binarize_otsu()
# Сохранить в том же месте с настройками по умолчанию.
image.save()
saveOptions = BmpOptions()
# Палитра содержит только два цвета: черный и белый в данном случае.
saveOptions.palette = ColorPaletteHelper.create_monochrome()
# Для всех монохромных изображений (включая черно-белые) достаточно выделять 1 бит на пиксель.
saveOptions.bits_per_pixel = 1
# Сохранить в другое место с указанными параметрами.
image.save(path_join(directory, "sample.bw.palettized.bmp"), saveOptions)
# Сохранить только центральную часть изображения.
bounds = Rectangle(image.width // 4, image.height // 4, image.width // 2, image.height // 2)
image.save(path_join(directory, "sample.bw.palettized.part.bmp"), saveOptions, bounds)
# Сохранить всё изображение в поток памяти
with strm_ext.create_memory_stream() as stream:
image.save(stream, saveOptions);
print("The size of the whole image in bytes:", stream.tell())
# Сохраните центральную часть изображения в поток памяти
with strm_ext.create_memory_stream() as stream:
image.save(stream, saveOptions, bounds)
print("The size of the central part of the image in bytes: ", stream.tell())
#Вывод может выглядеть так:
#Размер всего изображения в байтах: 24062
#Размер центральной части изображения в байтах: 6046
The following example shows how to resize a metafile (WMF and EMF).
import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.emf import MetaImage
from os.path import join
dir_ = "c:\\temp"
file_names = ["image3.emf", "image4.wmf"]
for file_name in file_names:
input_file_path = join(dir_, file_name)
output_file_path = join(dir_, "Downscale_" + file_name)
with aspycore.as_of(Image.load(input_file_path), MetaImage) as image:
image.resize(image.width // 4, image.height // 4)
image.save(output_file_path)
The following example shows how to resize SVG image and save it to PNG.
from aspose.imaging import PointF, Image
from aspose.imaging.imageoptions import PngOptions
from os import path
dir_ = "c:\\aspose.imaging\\net\\issues\\3549"
file_names = ["Logotype.svg", "sample_car.svg", "rg1024_green_grapes.svg", "MidMarkerFigure.svg", "embeddedFonts.svg"]
scales = [PointF(0.5, 0.5), PointF(1.0, 1.0), PointF(2.0, 2.0), PointF(3.5, 9.2)]
for input_file in file_names:
for scale in scales:
output_file = "{0}_{1}_{2}.png".format(input_file, str(scale.x), str(scale.y))
with Image.load(path.join(dir_, input_file)) as image:
image.resize(int(image.width * scale.x), int(image.height * scale.y))
image.save(path.join(dir_, output_file), PngOptions())
Resize image using specific Resize Type.
from aspose.imaging import Image, ResizeType, ImageResizeSettings, ImageFilterType
with Image.load("Photo.jpg") as image:
image.resize(640, 480, ResizeType.CATMULL_ROM)
image.save("ResizedPhoto.jpg")
image.resize(1024, 768, ResizeType.CUBIC_CONVOLUTION)
image.save("ResizedPhoto2.jpg")
resize_settings = ImageResizeSettings()
resize_settings.mode = ResizeType.CUBIC_BSPLINE
resize_settings.filter_type = ImageFilterType.SMALL_RECTANGULAR
image.resize(800, 800, resize_settings)
image.save("ResizedPhoto3.jpg")
Determine if the palette is used by the image.
from aspose.imaging import Image
with Image.load("Sample.bmp") as image:
if image.use_palette:
print("The palette is used by the image")