Класс RasterCachedImage

Summary: Represents a raster image supporting raster graphics operations. This image caches pixel data when required.

Module: aspose.imaging

Full Name: aspose.imaging.RasterCachedImage

Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, IRasterImageArgb32PixelLoader, IRasterImageRawDataLoader, RasterImage

Properties

NameTypeAccessDescription
auto_adjust_paletteboolr/wПолучает или задает значение, указывающее, следует ли автоматически корректировать палитру.
background_colorColorr/wПолучает или задает значение цвета фона.
bits_per_pixelintrПолучает количество бит на пиксель изображения.
boundsRectanglerПолучает границы объекта.
buffer_size_hintintr/wПолучает или задает подсказку о размере буфера, определяющую максимальный допустимый размер для всех внутренних буферов.
containerImagerПолучает контейнер Image.
data_stream_containerStreamContainerrПолучает поток данных объекта.
disposedboolrПолучает значение, указывающее, удалён ли этот экземпляр.
exif_dataExifDatar/wПолучает или задаёт экземпляр Exif.
file_formatFileFormatrПолучает значение формата файла
has_alphaboolrПолучает значение, указывающее, имеет ли этот экземпляр альфа-канал.
has_background_colorboolr/wПолучает или задает значение, указывающее, имеет ли изображение фоновый цвет.
has_transparent_colorboolr/wПолучает или задаёт значение, указывающее, имеет ли этот экземпляр RasterImage прозрачный цвет.
heightintrПолучает высоту объекта.
horizontal_resolutionfloatr/wПолучает или задает горизонтальное разрешение в пикселях на дюйм для этого RasterImage.
image_opacityfloatrПолучает непрозрачность этого изображения.
interrupt_monitorInterruptMonitorr/wПолучает или задает монитор прерываний.
is_cachedboolrПолучает значение, указывающее, кэшируются ли данные изображения в данный момент.
is_raw_data_availableboolrПолучает значение, указывающее, доступна ли загрузка необработанных данных.
metadataImageMetadatarПолучает метаданные изображения.
paletteIColorPaletter/wПолучает или задает цветовую палитру. Цветовая палитра не используется, когда пиксели представлены напрямую.
premultiply_componentsboolr/wПолучает или задает значение, указывающее, должны ли компоненты изображения быть предварительно умножены.
raw_custom_color_converterIColorConverterr/wПолучает или задает пользовательский конвертер цветов
raw_data_formatPixelDataFormatrПолучает формат необработанных данных.
raw_data_settingsRawDataSettingsrПолучает текущие настройки необработанных данных. Обратите внимание, что при использовании этих настроек данные загружаются без конвертации.
raw_fallback_indexintr/wПолучает или задает резервный индекс, используемый, когда индекс палитры выходит за пределы.
raw_indexed_color_converterIIndexedColorConverterr/wПолучает или задает индексированный конвертер цветов
raw_line_sizeintrПолучает размер необработанной строки в байтах.
sizeSizerПолучает размер объекта.
transparent_colorColorr/wПолучает прозрачный цвет изображения.
update_xmp_databoolr/wПолучает или задает значение, указывающее, следует ли обновлять метаданные XMP.
use_paletteboolrПолучает значение, указывающее, используется ли палитра изображения.
use_raw_databoolr/wПолучает или задает значение, указывающее, следует ли использовать загрузку необработанных данных, когда такая загрузка доступна.
vertical_resolutionfloatr/wПолучает или задает вертикальное разрешение в пикселях на дюйм для этого RasterImage.
widthintrПолучает ширину объекта.
xmp_dataXmpPacketWrapperr/wПолучает или задает данные Xmp.

Methods

NameDescription
adjust_brightness(brightness)Регулировка яркости изображения.
adjust_contrast(contrast)Контрастирование изображения
adjust_gamma(gamma)Гамма‑коррекция изображения.
adjust_gamma(gamma_red, gamma_green, gamma_blue)Гамма‑коррекция изображения.
analyze_percentage_digital_signature(password)Вычисляет процентное сходство между извлечёнными данными и оригинальным паролем.
auto_brightness_contrast()Выполняет автоматическую адаптивную нормализацию яркости и контраста для всего изображения.
auto_rotate()Автоматически вращает изображение на основе данных ориентации, извлечённых из Exif
метаданных. Этот метод гарантирует, что изображения отображаются в правильной ориентации,
улучшая пользовательский опыт и устраняя необходимость ручных корректировок. Путём
анализа информации Exif изображение вращается соответствующим образом, обеспечивая бесшовный
просмотр на разных платформах и устройствах. Этот автоматизированный процесс вращения
упрощает работу с изображениями и повышает общую удобность, особенно при
работе с большими партиями изображений с различными ориентациями.
binarize_bradley(brightness_difference)Бинаризация изображения с использованием адаптивного порогового алгоритма Брэдли, основанного на интегральном порогировании изображения
binarize_bradley(brightness_difference, window_size)Бинаризация изображения с использованием адаптивного порогового алгоритма Брэдли, основанного на интегральном порогировании изображения
binarize_fixed(threshold)Бинаризация изображения с предопределённым порогом
binarize_otsu()Бинаризация изображения с порогом Оцу
blend(origin, overlay, overlay_alpha)Смешивает этот экземпляр изображения с изображением overlay.
blend(origin, overlay, overlay_area, overlay_alpha)Смешивает этот экземпляр изображения с изображением overlay.
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)Обрезка изображения.
dither(dithering_method, bits_count)Выполняет дизеринг текущего изображения.
dither(dithering_method, bits_count, custom_palette)Выполняет дизеринг текущего изображения.
embed_digital_signature(password)Встроить цифровую подпись, основанную на предоставленном пароле, в изображение с помощью стеганографии.
filter(rectangle, options)Фильтрует указанный прямоугольник.
get_argb_32_pixel(x, y)Получает 32-битный ARGB‑пиксель изображения.
get_default_argb_32_pixels(rectangle)Получает массив пикселей по умолчанию в формате 32‑бит ARGB.
get_default_options(args)Получает параметры по умолчанию.
get_default_pixels(rectangle, partial_pixel_loader)Получает массив пикселей по умолчанию с использованием частичного загрузчика пикселей.
get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings)Получает массив необработанных данных по умолчанию с использованием частичного загрузчика пикселей.
get_default_raw_data(rectangle, raw_data_settings)Получает массив необработанных данных по умолчанию.
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_modify_date(use_default)Получает дату и время последнего изменения ресурса изображения.
get_original_options()Получает параметры на основе настроек оригинального файла.
Это может быть полезно для сохранения глубины цвета и других параметров оригинального изображения без изменений.
Например, если мы загружаем черно‑белое PNG‑изображение с 1 битом на пиксель и затем сохраняем его с помощью
DataStreamSupporter.save(file_path) метода, будет получено PNG‑изображение с 8‑битами на пиксель.
Чтобы избежать этого и сохранить PNG‑изображение с 1‑битом на пиксель, используйте этот метод для получения соответствующих параметров сохранения и передайте их
в метод Image.save(file_path, options) в качестве второго параметра.
get_pixel(x, y)Получает пиксель изображения.
get_proportional_height(width, height, new_width)Получает пропорциональную высоту.
get_proportional_width(width, height, new_height)Получает пропорциональную ширину.
get_serialized_stream(image_options, clipping_rectangle, page_number)Преобразует в aps.
get_skew_angle()Получает угол наклона.
Этот метод применим к отсканированным текстовым документам для определения угла наклона при сканировании.
grayscale()Преобразование изображения в его градации серого
is_digital_signed(password, percentage_threshold)Выполняет быструю проверку, чтобы определить, подписано ли изображение цифровой подписью, используя предоставленный пароль и пороговое значение.
load(file_path)Загружает новое изображение из указанного пути к файлу или URL.
Если filePath — путь к файлу, метод просто открывает файл.
Если filePath — URL, метод загружает файл, сохраняет его как временный и открывает.
load(file_path, load_options)Загружает новое изображение из указанного пути к файлу или URL.
Если filePath — путь к файлу, метод просто открывает файл.
Если filePath — URL, метод загружает файл, сохраняет его как временный и открывает.
load(stream)Загружает новое изображение из указанного потока.
load(stream, load_options)Загружает новое изображение из указанного потока.
load_argb_32_pixels(rectangle)Загружает 32‑битные ARGB‑пиксели.
load_argb_64_pixels(rectangle)Загружает 64‑битные ARGB‑пиксели.
load_cmyk_32_pixels(rectangle)Загружает пиксели в формате CMYK.
load_cmyk_pixels(rectangle)Загружает пиксели в формате CMYK.
Этот метод устарел. Пожалуйста, используйте более эффективный метод RasterImage.load_cmyk_32_pixels(rectangle).
load_partial_argb_32_pixels(rectangle, partial_pixel_loader)Загружает 32-битные ARGB‑пиксели частично пакетами.
load_partial_argb_64_pixels(rectangle, partial_pixel_loader)Частично загружает 64‑битные ARGB‑пиксели пакетами.
load_partial_pixels(desired_rectangle, pixel_loader)Частично загружает пиксели пакетами.
load_pixels(rectangle)Загружает пиксели.
load_raw_data(rectangle, dest_image_bounds, raw_data_settings, raw_data_loader)Загружает необработанные данные.
load_raw_data(rectangle, raw_data_settings, raw_data_loader)Загружает необработанные данные.
load_stream(stream)Загружает новое изображение из указанного потока.
load_stream_with_options(stream, load_options)Загружает новое изображение из указанного потока.
load_with_options(file_path, load_options)Загружает новое изображение из указанного пути к файлу или URL.
Если filePath — путь к файлу, метод просто открывает файл.
Если filePath — URL, метод загружает файл, сохраняет его как временный и открывает.
normalize_angle()Нормализует угол.
Этот метод применим к отсканированным текстовым документам для устранения наклона сканирования.
Метод использует функции RasterImage.get_skew_angle() и RasterImage.rotate(angle).
normalize_angle(resize_proportionally, background_color)Нормализует угол.
Этот метод применим к отсканированным текстовым документам, чтобы избавиться от наклона скана.
Этот метод использует методы RasterImage.get_skew_angle() и RasterImage.rotate(angle, resize_proportionally, background_color).
normalize_histogram()Нормализует гистограмму изображения — корректирует значения пикселей, чтобы использовать весь доступный диапазон.
read_argb_32_scan_line(scan_line_index)Считывает всю строку сканирования по указанному индексу строки сканирования.
read_scan_line(scan_line_index)Считывает всю строку сканирования по указанному индексу строки сканирования.
remove_metadata()Удаляет метаданные этого экземпляра изображения, устанавливая значение IHasXmpData.xmp_data в None.
replace_argb(old_color_argb, old_color_diff, new_color_argb)Заменяет один цвет другим с допустимой разницей и сохраняет исходное альфа‑значение для сохранения плавных краёв.
replace_color(old_color, old_color_diff, new_color)Заменяет один цвет другим с допустимой разницей и сохраняет исходное альфа‑значение для сохранения плавных краёв.
replace_color(old_color_argb, old_color_diff, new_color_argb)Заменяет один цвет другим с допустимой разницей и сохраняет исходное альфа‑значение для сохранения плавных краёв.
replace_non_transparent_colors(new_color)Заменяет все непрозрачные цвета новым цветом и сохраняет исходное значение альфа‑канала, чтобы сохранить плавные края.
Примечание: если использовать его на изображениях без прозрачности, все цвета будут заменены одним цветом.
replace_non_transparent_colors(new_color_argb)Заменяет все непрозрачные цвета новым цветом и сохраняет исходное значение альфа‑канала, чтобы сохранить плавные края.
Примечание: если использовать его на изображениях без прозрачности, все цвета будут заменены одним цветом.
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(angle, resize_proportionally, background_color)Повернуть изображение вокруг центра.
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_argb_32_pixels(rectangle, pixels)Сохраняет 32-битные ARGB‑пиксели.
save_cmyk_32_pixels(rectangle, pixels)Сохраняет пиксели.
save_cmyk_pixels(rectangle, pixels)Сохраняет пиксели.
Этот метод устарел. Пожалуйста, используйте более эффективный метод RasterImage.save_cmyk_32_pixels(rectangle, pixels).
save_pixels(rectangle, pixels)Сохраняет пиксели (метод, специфичный для формата).
save_raw_data(data, data_offset, rectangle, raw_data_settings)Сохраняет необработанные данные.
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_argb_32_pixel(x, y, argb_32_color)Устанавливает 32‑битный ARGB‑пиксель изображения для указанной позиции.
set_palette(palette, update_colors)Устанавливает палитру изображения.
set_pixel(x, y, color)Устанавливает пиксель изображения для указанной позиции.
set_resolution(dpi_x, dpi_y)Устанавливает разрешение для этого RasterImage.
try_set_metadata(metadata)Пытается установить экземпляр metadata, если этот экземпляр Image поддерживает и реализует экземпляр IImageMetadataFormat.
write_argb_32_scan_line(scan_line_index, argb_32_pixels)Записывает всю строку сканирования в указанный индекс строки сканирования.
write_scan_line(scan_line_index, pixels)Записывает всю строку сканирования в указанный индекс строки сканирования.

Method: adjust_brightness(brightness)

 adjust_brightness(brightness) 

Регулировка яркости изображения.

Parameters:

ПараметрТипОписание
яркостьintЗначение яркости.

See also:

Example # 1: The following example performs brightness correction of a raster cached image.

Method: adjust_contrast(contrast)

 adjust_contrast(contrast) 

Контрастирование изображения

Parameters:

ПараметрТипОписание
контрастfloatЗначение контраста (в диапазоне [-100; 100])

See also:

Example # 1: The following example performs contrast correction of a raster cached image.

Method: adjust_gamma(gamma)

 adjust_gamma(gamma) 

Гамма‑коррекция изображения.

Parameters:

ПараметрТипОписание
гаммаfloatКоэффициент гаммы для красного, зелёного и синего каналов

See also:

Example # 1: The following example performs gamma-correction of a raster cached image.

Method: adjust_gamma(gamma_red, gamma_green, gamma_blue)

 adjust_gamma(gamma_red, gamma_green, gamma_blue) 

Гамма‑коррекция изображения.

Parameters:

ПараметрТипОписание
gamma_redfloatКоэффициент гаммы для красного канала
gamma_greenfloatКоэффициент гаммы для зелёного канала
gamma_bluefloatКоэффициент гаммы для синего канала

See also:

Example # 1: The following example performs gamma-correction of a raster cached image appl…

Method: analyze_percentage_digital_signature(password)

 analyze_percentage_digital_signature(password) 

Вычисляет процентное сходство между извлечёнными данными и оригинальным паролем.

Parameters:

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

Returns

ТипОписание
intЗначение процента сходства.

See also:

Example # 1: The example illustrates how to determine the probability (from 0% to 100%) th…

Method: binarize_bradley(brightness_difference)

 binarize_bradley(brightness_difference) 

Бинаризация изображения с использованием адаптивного порогового алгоритма Брэдли, основанного на интегральном порогировании изображения

Parameters:

ПараметрТипОписание
brightness_differencefloatРазница яркости между пикселем и средним значением окна s × s пикселей, центрированного вокруг этого пикселя.

See also:

Example # 1: The following example binarizes a raster cached image with Bradley’s adaptive…

Method: binarize_bradley(brightness_difference, window_size)

 binarize_bradley(brightness_difference, window_size) 

Бинаризация изображения с использованием адаптивного порогового алгоритма Брэдли, основанного на интегральном порогировании изображения

Parameters:

ПараметрТипОписание
brightness_differencefloatРазница яркости между пикселем и средним значением окна s × s пикселей, центрированного вокруг этого пикселя.
window_sizeintРазмер окна s × s пикселей, центрированного вокруг этого пикселя

See also:

Example # 1: The following example binarizes a raster cached image with Bradley’s adaptive…

Method: binarize_fixed(threshold)

 binarize_fixed(threshold) 

Бинаризация изображения с предопределённым порогом

Parameters:

ПараметрТипОписание
порогSystem.ByteЗначение порога. Если соответствующее серое значение пикселя больше порога, ему будет присвоено значение 255, иначе — 0.

See also:

Example # 1: The following example binarizes a raster cached image with the predefined thr…

Method: blend(origin, overlay, overlay_alpha)

 blend(origin, overlay, overlay_alpha) 

Смешивает этот экземпляр изображения с изображением overlay.

Parameters:

ПараметрТипОписание
originPointИсточник наложения фонового изображения.
overlayRasterImageИзображение наложения.
overlay_alphaSystem.ByteПрозрачность наложения.

Method: blend(origin, overlay, overlay_area, overlay_alpha)

 blend(origin, overlay, overlay_area, overlay_alpha) 

Смешивает этот экземпляр изображения с изображением overlay.

Parameters:

ПараметрТипОписание
originPointИсточник наложения фонового изображения.
overlayRasterImageИзображение наложения.
overlay_areaRectangleОбласть наложения.
overlay_alphaSystem.ByteПрозрачность наложения.

Method: can_load(file_path) [static]

 can_load(file_path) 

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

Parameters:

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

Returns

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

Method: can_load(file_path, load_options) [static]

 can_load(file_path, load_options) 

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

Parameters:

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

Returns

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

Method: can_load(stream) [static]

 can_load(stream) 

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

Parameters:

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

Returns

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

Method: can_load(stream, load_options) [static]

 can_load(stream, load_options) 

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

Parameters:

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

Returns

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

Method: can_load_stream(stream) [static]

 can_load_stream(stream) 

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

Parameters:

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

Returns

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

Method: can_load_stream_with_options(stream, load_options) [static]

 can_load_stream_with_options(stream, load_options) 

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

Parameters:

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

Returns

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

Method: can_load_with_options(file_path, load_options) [static]

 can_load_with_options(file_path, load_options) 

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

Parameters:

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

Returns

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

Method: can_save(options)

 can_save(options) 

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

Parameters:

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

Returns

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

Method: create(files) [static]

 create(files) 

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

Parameters:

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

Returns

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

Method: create(files, throw_exception_on_load_error) [static]

 create(files, throw_exception_on_load_error) 

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

Parameters:

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

Returns

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

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

 create(image_options, width, height) 

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

Parameters:

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

Returns

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

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

 create(image_options, width, height, pixels) 

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

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

Parameters:

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

Returns

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

Method: create(images) [static]

 create(images) 

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

Parameters:

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

Returns

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

Method: create(images, dispose_images) [static]

 create(images, dispose_images) 

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

Parameters:

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

Returns

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

Method: create(multipage_create_options) [static]

 create(multipage_create_options) 

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

Parameters:

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

Returns

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

Method: create_from_files(files) [static]

 create_from_files(files) 

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

Parameters:

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

Returns

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

Method: create_from_files(files, throw_exception_on_load_error) [static]

 create_from_files(files, throw_exception_on_load_error) 

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

Parameters:

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

Returns

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

Method: create_from_images(images) [static]

 create_from_images(images) 

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

Parameters:

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

Returns

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

Method: create_from_images(images, dispose_images) [static]

 create_from_images(images, dispose_images) 

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

Parameters:

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

Returns

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

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

 crop(left_shift, right_shift, top_shift, bottom_shift) 

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

Parameters:

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

Method: crop(rectangle)

 crop(rectangle) 

Обрезка изображения.

Parameters:

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

See also:

Example # 1: The following example crops a raster cached image. The cropping area is be sp…

Method: dither(dithering_method, bits_count)

 dither(dithering_method, bits_count) 

Выполняет дизеринг текущего изображения.

Parameters:

ПараметрТипОписание
dithering_methodDitheringMethodМетод дизеринга.
bits_countintОкончательное количество бит для дизеринга.

Method: dither(dithering_method, bits_count, custom_palette)

 dither(dithering_method, bits_count, custom_palette) 

Выполняет дизеринг текущего изображения.

Parameters:

ПараметрТипОписание
dithering_methodDitheringMethodМетод дизеринга.
bits_countintОкончательное количество бит для дизеринга.
custom_paletteIColorPaletteПользовательская палитра для дизеринга.

Method: embed_digital_signature(password)

 embed_digital_signature(password) 

Встроить цифровую подпись, основанную на предоставленном пароле, в изображение с помощью стеганографии.

Parameters:

ПараметрТипОписание
парольstringПароль, используемый для генерации данных цифровой подписи.

See also:

Example # 1: The example shows how to embed digital signature based on provided password i…

Method: filter(rectangle, options)

 filter(rectangle, options) 

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

Parameters:

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

Method: get_argb_32_pixel(x, y)

 get_argb_32_pixel(x, y) 

Получает 32-битный ARGB‑пиксель изображения.

Parameters:

ПараметрТипОписание
xintКоордината x пикселя.
yintКоордината y пикселя.

Returns

ТипОписание
int32-битный ARGB‑пиксель для указанного местоположения.

Method: get_default_argb_32_pixels(rectangle)

 get_default_argb_32_pixels(rectangle) 

Получает массив пикселей по умолчанию в формате 32‑бит ARGB.

Parameters:

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

Returns

ТипОписание
int[]Массив пикселей по умолчанию

Method: get_default_options(args)

 get_default_options(args) 

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

Parameters:

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

Returns

ТипОписание
ImageOptionsBaseПараметры по умолчанию

Method: get_default_pixels(rectangle, partial_pixel_loader)

 get_default_pixels(rectangle, partial_pixel_loader) 

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

Parameters:

ПараметрТипОписание
rectangleRectangleПрямоугольник, для которого получаются пиксели.
partial_pixel_loaderIPartialArgb32PixelLoaderЧастичный загрузчик пикселей.

Method: get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings)

 get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings) 

Получает массив необработанных данных по умолчанию с использованием частичного загрузчика пикселей.

Parameters:

ПараметрТипОписание
rectangleRectangleПрямоугольник, для которого получаются пиксели.
partial_raw_data_loaderIPartialRawDataLoaderЧастичный загрузчик необработанных данных.
raw_data_settingsRawDataSettingsНастройки необработанных данных.

Method: get_default_raw_data(rectangle, raw_data_settings)

 get_default_raw_data(rectangle, raw_data_settings) 

Получает массив необработанных данных по умолчанию.

Parameters:

ПараметрТипОписание
rectangleRectangleПрямоугольник, для которого получаются необработанные данные.
raw_data_settingsRawDataSettingsНастройки необработанных данных.

Returns

ТипОписание
System.ByteМассив необработанных данных по умолчанию

Method: get_file_format(file_path) [static]

 get_file_format(file_path) 

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

Parameters:

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

Returns

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

Method: get_file_format(stream) [static]

 get_file_format(stream) 

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

Parameters:

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

Returns

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

Method: get_file_format_of_stream(stream) [static]

 get_file_format_of_stream(stream) 

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

Parameters:

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

Returns

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

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

 get_fitting_rectangle(rectangle, pixels, width, height) 

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

Parameters:

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

Returns

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

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

 get_fitting_rectangle(rectangle, width, height) 

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

Parameters:

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

Returns

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

Method: get_modify_date(use_default)

 get_modify_date(use_default) 

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

Parameters:

ПараметрТипОписание
use_defaultboolесли установлено в true, использует информацию из FileInfo в качестве значения по умолчанию.

Returns

ТипОписание
System.DateTimeДата и время последнего изменения изображения ресурса.

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_pixel(x, y)

 get_pixel(x, y) 

Получает пиксель изображения.

Parameters:

ПараметрТипОписание
xintКоордината x пикселя.
yintКоордината y пикселя.

Returns

ТипОписание
ColorЦвет пикселя для указанного местоположения.

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

 get_proportional_height(width, height, new_width) 

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

Parameters:

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

Returns

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

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

 get_proportional_width(width, height, new_height) 

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

Parameters:

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

Returns

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

Method: get_serialized_stream(image_options, clipping_rectangle, page_number)

 get_serialized_stream(image_options, clipping_rectangle, page_number) 

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

Parameters:

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

Returns

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

Method: get_skew_angle()

 get_skew_angle() 

Получает угол наклона.
Этот метод применим к отсканированным текстовым документам для определения угла наклона при сканировании.

Returns

ТипОписание
floatУгол наклона в градусах.

Method: is_digital_signed(password, percentage_threshold)

 is_digital_signed(password, percentage_threshold) 

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

Parameters:

ПараметрТипОписание
парольstringПароль для проверки подписи.
percentage_thresholdintПорог (в процентах)[0-100], определяющий, считается ли изображение подписанным.
Если не указано, будет применён порог по умолчанию (75).

Returns

ТипОписание
boolTrue, если изображение подписано, иначе false.

See also:

Example # 1: The example shows how to validate that the embedded digital signature matches…

Example # 2: The example demonstrates how to verify that the embedded digital signature ma…

Method: load(file_path) [static]

 load(file_path) 

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

Parameters:

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

Returns

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

Method: load(file_path, load_options) [static]

 load(file_path, load_options) 

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

Parameters:

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

Returns

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

Method: load(stream) [static]

 load(stream) 

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

Parameters:

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

Returns

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

Method: load(stream, load_options) [static]

 load(stream, load_options) 

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

Parameters:

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

Returns

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

Method: load_argb_32_pixels(rectangle)

 load_argb_32_pixels(rectangle) 

Загружает 32‑битные ARGB‑пиксели.

Parameters:

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

Returns

ТипОписание
int[]Загруженный массив 32‑битных ARGB пикселей.

Method: load_argb_64_pixels(rectangle)

 load_argb_64_pixels(rectangle) 

Загружает 64‑битные ARGB‑пиксели.

Parameters:

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

Returns

ТипОписание
int[]Загруженный массив пикселей ARGB 64‑бит.

Method: load_cmyk_32_pixels(rectangle)

 load_cmyk_32_pixels(rectangle) 

Загружает пиксели в формате CMYK.

Parameters:

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

Returns

ТипОписание
int[]Загруженный массив пикселей CMYK, представленных как 32‑битные целочисленные значения.

Method: load_cmyk_pixels(rectangle)

 load_cmyk_pixels(rectangle) 

Загружает пиксели в формате CMYK.
Этот метод устарел. Пожалуйста, используйте более эффективный метод RasterImage.load_cmyk_32_pixels(rectangle).

Parameters:

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

Returns

ТипОписание
CmykColor[]Загруженный массив пикселей CMYK.

Method: load_partial_argb_32_pixels(rectangle, partial_pixel_loader)

 load_partial_argb_32_pixels(rectangle, partial_pixel_loader) 

Загружает 32-битные ARGB‑пиксели частично пакетами.

Parameters:

ПараметрТипОписание
rectangleRectangleЖелаемый прямоугольник.
partial_pixel_loaderIPartialArgb32PixelLoaderЗагрузчик 32‑битных ARGB‑пикселей.

Method: load_partial_argb_64_pixels(rectangle, partial_pixel_loader)

 load_partial_argb_64_pixels(rectangle, partial_pixel_loader) 

Частично загружает 64‑битные ARGB‑пиксели пакетами.

Parameters:

ПараметрТипОписание
rectangleRectangleЖелаемый прямоугольник.
partial_pixel_loaderIPartialArgb64PixelLoaderЗагрузчик пикселей ARGB 64‑бит.

Method: load_partial_pixels(desired_rectangle, pixel_loader)

 load_partial_pixels(desired_rectangle, pixel_loader) 

Частично загружает пиксели пакетами.

Parameters:

ПараметрТипОписание
desired_rectangleRectangleЖелаемый прямоугольник.
pixel_loaderIPartialPixelLoaderЗагрузчик пикселей.

Method: load_pixels(rectangle)

 load_pixels(rectangle) 

Загружает пиксели.

Parameters:

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

Returns

ТипОписание
Color[]Загруженный массив пикселей.

Method: load_raw_data(rectangle, dest_image_bounds, raw_data_settings, raw_data_loader)

 load_raw_data(rectangle, dest_image_bounds, raw_data_settings, raw_data_loader) 

Загружает необработанные данные.

Parameters:

ПараметрТипОписание
rectangleRectangleПрямоугольник, из которого загружать необработанные данные.
dest_image_boundsRectangleГраницы целевого изображения.
raw_data_settingsRawDataSettingsНастройки необработанных данных, используемые для загруженных данных. Обратите внимание, что если данные не в указанном формате, будет выполнено их преобразование.
raw_data_loaderIPartialRawDataLoaderЗагрузчик необработанных данных.

Method: load_raw_data(rectangle, raw_data_settings, raw_data_loader)

 load_raw_data(rectangle, raw_data_settings, raw_data_loader) 

Загружает необработанные данные.

Parameters:

ПараметрТипОписание
rectangleRectangleПрямоугольник, из которого загружать необработанные данные.
raw_data_settingsRawDataSettingsНастройки необработанных данных, используемые для загруженных данных. Обратите внимание, что если данные не в указанном формате, будет выполнено их преобразование.
raw_data_loaderIPartialRawDataLoaderЗагрузчик необработанных данных.

Method: load_stream(stream) [static]

 load_stream(stream) 

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

Parameters:

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

Returns

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

Method: load_stream_with_options(stream, load_options) [static]

 load_stream_with_options(stream, load_options) 

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

Parameters:

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

Returns

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

Method: load_with_options(file_path, load_options) [static]

 load_with_options(file_path, load_options) 

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

Parameters:

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

Returns

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

Method: normalize_angle(resize_proportionally, background_color)

 normalize_angle(resize_proportionally, background_color) 

Нормализует угол.
Этот метод применим к отсканированным текстовым документам, чтобы избавиться от наклона скана.
Этот метод использует методы RasterImage.get_skew_angle() и RasterImage.rotate(angle, resize_proportionally, background_color).

Parameters:

ПараметрТипОписание
resize_proportionallyboolесли установить значение true, размер изображения будет изменён в соответствии с проекциями повернутого прямоугольника (угловых точек); в противном случае размеры останутся неизменными, и будет вращено только внутреннее содержимое изображения.
background_colorColorЦвет фона.

Method: read_argb_32_scan_line(scan_line_index)

 read_argb_32_scan_line(scan_line_index) 

Считывает всю строку сканирования по указанному индексу строки сканирования.

Parameters:

ПараметрТипОписание
scan_line_indexintИндекс строки сканирования, начинающийся с нуля.

Returns

ТипОписание
int[]Массив 32‑битных значений цветов ARGB строки сканирования.

Method: read_scan_line(scan_line_index)

 read_scan_line(scan_line_index) 

Считывает всю строку сканирования по указанному индексу строки сканирования.

Parameters:

ПараметрТипОписание
scan_line_indexintИндекс строки сканирования, начинающийся с нуля.

Returns

ТипОписание
Color[]Массив значений цветов пикселей строки сканирования.

Method: replace_argb(old_color_argb, old_color_diff, new_color_argb)

 replace_argb(old_color_argb, old_color_diff, new_color_argb) 

Заменяет один цвет другим с допустимой разницей и сохраняет исходное альфа‑значение для сохранения плавных краёв.

Parameters:

ПараметрТипОписание
old_color_argbintЗначение ARGB старого цвета, которое будет заменено.
old_color_diffSystem.ByteДопустимая разница в старом цвете, позволяющая расширить заменённый тон цвета.
new_color_argbintНовое значение ARGB цвета для замены старого цвета.

Method: replace_color(old_color, old_color_diff, new_color)

 replace_color(old_color, old_color_diff, new_color) 

Заменяет один цвет другим с допустимой разницей и сохраняет исходное альфа‑значение для сохранения плавных краёв.

Parameters:

ПараметрТипОписание
old_colorColorСтарый цвет, который будет заменён.
old_color_diffSystem.ByteДопустимая разница в старом цвете, позволяющая расширить заменённый тон цвета.
new_colorColorНовый цвет, которым заменяется старый цвет.

Method: replace_color(old_color_argb, old_color_diff, new_color_argb)

 replace_color(old_color_argb, old_color_diff, new_color_argb) 

Заменяет один цвет другим с допустимой разницей и сохраняет исходное альфа‑значение для сохранения плавных краёв.

Parameters:

ПараметрТипОписание
old_color_argbintЗначение ARGB старого цвета, которое будет заменено.
old_color_diffSystem.ByteДопустимая разница в старом цвете, позволяющая расширить заменённый тон цвета.
new_color_argbintНовое значение ARGB цвета для замены старого цвета.

Method: replace_non_transparent_colors(new_color)

 replace_non_transparent_colors(new_color) 

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

Parameters:

ПараметрТипОписание
new_colorColorНовый цвет, которым заменяются непрозрачные цвета.

Method: replace_non_transparent_colors(new_color_argb)

 replace_non_transparent_colors(new_color_argb) 

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

Parameters:

ПараметрТипОписание
new_color_argbintНовое значение ARGB цвета для замены непрозрачных цветов.

Method: resize(new_width, new_height)

 resize(new_width, new_height) 

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

Parameters:

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

Method: resize(new_width, new_height, resize_type)

 resize(new_width, new_height, resize_type) 

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

Parameters:

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

See also:

Example # 1: This example loads a raster cached image and resizes it using various resizin…

Method: resize(new_width, new_height, settings)

 resize(new_width, new_height, settings) 

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

Parameters:

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

See also:

Example # 1: This example loads a raster cached image and resizes it using various resizin…

Method: resize_by_settings(new_width, new_height, settings)

 resize_by_settings(new_width, new_height, settings) 

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

Parameters:

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

Method: resize_by_type(new_width, new_height, resize_type)

 resize_by_type(new_width, new_height, resize_type) 

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

Parameters:

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

Method: resize_height_proportionally(new_height)

 resize_height_proportionally(new_height) 

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

Parameters:

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

Method: resize_height_proportionally(new_height, resize_type)

 resize_height_proportionally(new_height, resize_type) 

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

Parameters:

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

Method: resize_height_proportionally(new_height, settings)

 resize_height_proportionally(new_height, settings) 

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

Parameters:

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

Method: resize_height_proportionally_settings(new_height, settings)

 resize_height_proportionally_settings(new_height, settings) 

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

Parameters:

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

Method: resize_width_proportionally(new_width)

 resize_width_proportionally(new_width) 

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

Parameters:

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

Method: resize_width_proportionally(new_width, resize_type)

 resize_width_proportionally(new_width, resize_type) 

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

Parameters:

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

Method: resize_width_proportionally(new_width, settings)

 resize_width_proportionally(new_width, settings) 

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

Parameters:

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

Method: resize_width_proportionally_settings(new_width, settings)

 resize_width_proportionally_settings(new_width, settings) 

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

Parameters:

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

Method: rotate(angle)

 rotate(angle) 

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

Parameters:

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

Method: rotate(angle, resize_proportionally, background_color)

 rotate(angle, resize_proportionally, background_color) 

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

Parameters:

ПараметрТипОписание
уголfloatThe rotate angle in degrees. Positive values will rotate clockwise.
resize_proportionallyboolесли установить значение true, размер изображения будет изменён в соответствии с проекциями повернутого прямоугольника (угловых точек); в противном случае размеры останутся неизменными, и будет вращено только внутреннее содержимое изображения.
background_colorColorЦвет фона.

Method: rotate_flip(rotate_flip_type)

 rotate_flip(rotate_flip_type) 

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

Parameters:

ПараметрТипОписание
rotate_flip_typeRotateFlipTypeThe rotate flip type.

See also:

Example # 1: This example loads a raster cached image, rotates it by 90 degrees clockwise …

Method: save(file_path)

 save(file_path) 

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

Parameters:

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

Method: save(file_path, options)

 save(file_path, options) 

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

Parameters:

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

Method: save(file_path, options, bounds_rectangle)

 save(file_path, options, bounds_rectangle) 

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

Parameters:

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

Method: save(file_path, over_write)

 save(file_path, over_write) 

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

Parameters:

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

Method: save(stream)

 save(stream) 

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

Parameters:

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

Method: save(stream, options_base)

 save(stream, options_base) 

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

Parameters:

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

Method: save(stream, options_base, bounds_rectangle)

 save(stream, options_base, bounds_rectangle) 

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

Parameters:

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

Method: save_argb_32_pixels(rectangle, pixels)

 save_argb_32_pixels(rectangle, pixels) 

Сохраняет 32-битные ARGB‑пиксели.

Parameters:

ПараметрТипОписание
rectangleRectangleThe rectangle to save pixels to.
пикселиint[]The 32-bit ARGB pixels array.

Method: save_cmyk_32_pixels(rectangle, pixels)

 save_cmyk_32_pixels(rectangle, pixels) 

Сохраняет пиксели.

Parameters:

ПараметрТипОписание
rectangleRectangleThe rectangle to save pixels to.
пикселиint[]The CMYK pixels presented as the 32-bit integer values.

Method: save_cmyk_pixels(rectangle, pixels)

 save_cmyk_pixels(rectangle, pixels) 

Сохраняет пиксели.
Этот метод устарел. Пожалуйста, используйте более эффективный метод RasterImage.save_cmyk_32_pixels(rectangle, pixels).

Parameters:

ПараметрТипОписание
rectangleRectangleThe rectangle to save pixels to.
pixelsCmykColor[]The CMYK pixels array.

Method: save_pixels(rectangle, pixels)

 save_pixels(rectangle, pixels) 

Сохраняет пиксели (метод, специфичный для формата).

Parameters:

ПараметрТипОписание
rectangleRectangleThe rectangle to save pixels to.
pixelsColor[]The 32-bit ARGB pixels array.

Method: save_raw_data(data, data_offset, rectangle, raw_data_settings)

 save_raw_data(data, data_offset, rectangle, raw_data_settings) 

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

Parameters:

ПараметрТипОписание
данныеSystem.ByteThe raw data.
data_offsetintThe starting raw data offset.
rectangleRectangleThe raw data rectangle.
raw_data_settingsRawDataSettingsНастройки необработанных данных, в которых находятся данные.

Method: save_to_stream(stream)

 save_to_stream(stream) 

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

Parameters:

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

Method: save_to_stream_with_options(stream, options_base)

 save_to_stream_with_options(stream, options_base) 

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

Parameters:

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

Method: save_to_stream_with_options_rect(stream, options_base, bounds_rectangle)

 save_to_stream_with_options_rect(stream, options_base, bounds_rectangle) 

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

Parameters:

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

Method: save_with_options(file_path, options)

 save_with_options(file_path, options) 

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

Parameters:

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

Method: save_with_options_rect(file_path, options, bounds_rectangle)

 save_with_options_rect(file_path, options, bounds_rectangle) 

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

Parameters:

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

Method: set_argb_32_pixel(x, y, argb_32_color)

 set_argb_32_pixel(x, y, argb_32_color) 

Устанавливает 32‑битный ARGB‑пиксель изображения для указанной позиции.

Parameters:

ПараметрТипОписание
xintКоордината x пикселя.
yintКоордината y пикселя.
argb_32_colorint32‑битный ARGB‑пиксель для указанной позиции.

Method: set_palette(palette, update_colors)

 set_palette(palette, update_colors) 

Устанавливает палитру изображения.

Parameters:

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

Method: set_pixel(x, y, color)

 set_pixel(x, y, color) 

Устанавливает пиксель изображения для указанной позиции.

Parameters:

ПараметрТипОписание
xintКоордината x пикселя.
yintКоордината y пикселя.
colorColorЦвет пикселя для указанной позиции.

Method: set_resolution(dpi_x, dpi_y)

 set_resolution(dpi_x, dpi_y) 

Устанавливает разрешение для этого RasterImage.

Parameters:

ПараметрТипОписание
dpi_xfloatГоризонтальное разрешение в точках на дюйм для RasterImage.
dpi_yfloatВертикальное разрешение в точках на дюйм для RasterImage.

Method: try_set_metadata(metadata)

 try_set_metadata(metadata) 

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

Parameters:

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

Returns

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

Method: write_argb_32_scan_line(scan_line_index, argb_32_pixels)

 write_argb_32_scan_line(scan_line_index, argb_32_pixels) 

Записывает всю строку сканирования в указанный индекс строки сканирования.

Parameters:

ПараметрТипОписание
scan_line_indexintИндекс строки сканирования, начинающийся с нуля.
argb_32_pixelsint[]Массив 32‑битных ARGB‑цветов для записи.

Method: write_scan_line(scan_line_index, pixels)

 write_scan_line(scan_line_index, pixels) 

Записывает всю строку сканирования в указанный индекс строки сканирования.

Parameters:

ПараметрТипОписание
scan_line_indexintИндекс строки сканирования, начинающийся с нуля.
pixelsColor[]Массив цветов пикселей для записи.

Examples

The following example binarizes a raster cached image with Bradley’s adaptive thresholding algorithm. Binarized images contain only 2 colors - black and white.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterCachedImage
from os.path import join as join_path

directory = r"c:\temp"

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterCachedImage)
	# Бинаризуйте изображение с разницей яркости 5. 
	# Яркость — это разница между пикселем и средним значением окна s × s пикселей, центрированного вокруг этого пикселя.
	# Размер окна будет откалиброван автоматически.
	rasterImage.binarize_bradley(5.0)
	rasterImage.save(join_path(directory, "sample.BinarizeBradley5.png"))

The following example binarizes a raster cached image with Bradley’s adaptive thresholding algorithm with the specified window size. Binarized images contain only 2 colors - black and white.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterCachedImage
from os.path import join as join_path

directory = r"c:\temp"

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterCachedImage)
	# Бинаризуйте изображение с разницей яркости 5.
	# Яркость — это разница между пикселем и средним значением окна 10 × 10 пикселей, центрированного вокруг этого пикселя.
	rasterImage.binarize_bradley(5.0, 10)
	rasterImage.save(join_path(directory, "sample.BinarizeBradley5_10x10.png"))

This example loads a raster cached image and resizes it using various resizing methods.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterCachedImage, ResizeType
from aspose.imaging.imageoptions import PngOptions
from os.path import join as join_path

directory = r"c:\temp"

with Image.load(join_path(directory, "sample.png")) as image:
	raster_image = as_of(image, RasterCachedImage)
	# Увеличьте в 2 раза, используя ресамплинг ближайшего соседа.
	raster_image.resize(image.width * 2, image.height * 2, ResizeType.NEAREST_NEIGHBOUR_RESAMPLE)
	# Сохранить в PNG с параметрами по умолчанию.
	raster_image.save(join_path(directory, "upsample.nearestneighbour.png"), PngOptions())


with Image.load(join_path(directory, "sample.png")) as image:
	raster_image = as_of(image, RasterCachedImage)
	# Уменьшите в 2 раза, используя ресамплинг ближайшего соседа.
	raster_image.resize(image.width // 2, image.height // 2, ResizeType.NEAREST_NEIGHBOUR_RESAMPLE)
	# Сохранить в PNG с параметрами по умолчанию.
	raster_image.save(join_path(directory, "downsample.nearestneighbour.png"), PngOptions())

with Image.load(join_path(directory, "sample.png")) as image:
	raster_image = as_of(image, RasterCachedImage)
	# Увеличьте в 2 раза, используя билинейный ресамплинг.
	raster_image.resize(image.width * 2, image.height * 2, ResizeType.BILINEAR_RESAMPLE)
	# Сохранить в PNG с параметрами по умолчанию.
	raster_image.save(join_path(directory, "upsample.bilinear.png"), PngOptions())

with Image.load(join_path(directory, "sample.png")) as image:
	raster_image = as_of(image, RasterCachedImage)
	# Уменьшите в 2 раза, используя билинейный ресамплинг.
	raster_image.resize(image.width // 2, image.height // 2, ResizeType.BILINEAR_RESAMPLE)
	# Сохранить в PNG с параметрами по умолчанию.
	raster_image.save(join_path(directory, "downsample.bilinear.png"), PngOptions())

This example loads a raster cached image, rotates it by 90 degrees clockwise and optionally flips the image horizontally and(or) vertically.

from aspose.imaging import RotateFlipType, RasterCachedImage, Image
from aspose.pycore import as_of
from os.path import 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 rotate_flip_type in rotateFlipTypes:
	# Повернуть, отразить и сохранить в выходной файл.
	with as_of(Image.load(join(directory, "sample.bmp")), RasterCachedImage) as image:
		image.rotate_flip(rotate_flip_type)
		image.save(join(directory, f"sample.{rotate_flip_type.name}.bmp"))

The following example crops a raster cached image. The cropping area is be specified via aspose.imaging.Rectangle.

from aspose.imaging import Rectangle, RasterCachedImage, Image
from aspose.pycore import as_of
from os.path import join

directory = "c:\\temp\\"

with Image.load(join(directory, "sample.png")) as image:
	raster_image = as_of(image, RasterCachedImage)

	# Обрезать изображение. Область обрезки — прямоугольная центральная часть изображения.
	area = Rectangle(raster_image.width // 4, raster_image.height // 4,
					 raster_image.width // 2, raster_image.height // 2)
	raster_image.crop(area)

	# Сохранить обрезанное изображение в PNG.
	raster_image.save(join(directory, "sample.Crop.png"))
	

The following example binarizes a raster cached image with the predefined threshold. Binarized images contain only 2 colors - black and white.

from aspose.imaging import RasterCachedImage, Image
from aspose.pycore import as_of
from os.path import join

directory = "c:\\temp\\"

with Image.load(join(directory, "sample.png")) as image:
	raster_image = as_of(image, RasterCachedImage)

	# Бинаризовать изображение с пороговым значением 127.
	# Если соответствующее серое значение пикселя больше 127, ему будет присвоено значение 255, иначе 0.
	raster_image.binarize_fixed(127)
	raster_image.save(join(directory, "sample.BinarizeFixed.png"))

The following example transforms a colored raster cached image to its grayscale representation. Grayscale images are composed exclusively of shades of gray and carry only intensity information.

from aspose.imaging import RasterCachedImage, Image
from aspose.pycore import as_of
from os.path import join

directory = "c:\\temp\\"

with Image.load(join(directory, "sample.png")) as image:
	raster_image = as_of(image, RasterCachedImage)

	raster_image.grayscale()
	raster_image.save(join(directory, "sample.Grayscale.png"))

The following example performs gamma-correction of a raster cached image.

from aspose.imaging import RasterCachedImage, Image
from aspose.pycore import as_of
from os.path import join

directory = "c:\\temp\\"

with Image.load(join(directory, "sample.png")) as image:
	raster_image = as_of(image, RasterCachedImage)

	# Установить коэффициент гаммы для красного, зелёного и синего каналов.
	raster_image.adjust_gamma(2.5)
	raster_image.save(join(directory, "sample.AdjustGamma.png"))
}

The following example performs gamma-correction of a raster cached image applying different coefficients for color components.

from aspose.imaging import RasterCachedImage, Image
from aspose.pycore import as_of
from os.path import join

directory = "c:\\temp\\"

with Image.load(join(directory, "sample.png")) as image:
	raster_image = as_of(image, RasterCachedImage)

	# Установить отдельные коэффициенты гаммы для красного, зелёного и синего каналов.
	raster_image.adjust_gamma(1.5, 2.5, 3.5)
	raster_image.save(join(directory, "sample.AdjustGamma.png"))

The following example performs brightness correction of a raster cached image.

from aspose.imaging import RasterCachedImage, Image
from aspose.pycore import as_of
from os.path import join

directory = "c:\\temp\\"

with Image.load(join(directory, "sample.png")) as image:
	raster_image = as_of(image, RasterCachedImage)

	# Установить значение яркости. Допустимые значения яркости находятся в диапазоне [-255, 255].
	raster_image.adjust_brightness(50)
	raster_image.save(join(directory, "sample.AdjustBrightness.png"))

The following example performs contrast correction of a raster cached image.

from aspose.imaging import RasterCachedImage, Image
from aspose.pycore import as_of
from os.path import join

directory = "c:\\temp\\"

with Image.load(join(directory, "sample.png")) as image:
	raster_image = as_of(image, RasterCachedImage)
	# Установить значение контрастности. Допустимые значения контрастности находятся в диапазоне [-100f, 100f].
	raster_image.adjust_contrast(50)
	raster_image.save(join(directory, "sample.AdjustContrast.png"))

This example loads a raster cached image and resizes it using various resizing settings.

from aspose.imaging import RasterCachedImage, Image, ImageResizeSettings, ResizeType, ImageFilterType,\
	ColorQuantizationMethod, ColorCompareMethod
from aspose.pycore import as_of
from os.path import 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.color_compare_method = ColorCompareMethod.EUCLIDIAN

with as_of(Image.load(join(directory, "sample.png")), RasterCachedImage) as image:
	# Уменьшите в 2 раза, используя адаптивный ресамплинг.
	image.resize(image.width // 2, image.height // 2, resizeSettings)
	image.save(join(directory, "downsample.adaptive.png"), PngOptions())

The example shows how to validate that the embedded digital signature matches the provided password.


from aspose.imaging import Image

with Image.load(output_path) as image:
	is_signed = image.is_digital_signed(password, -1)

The example shows how to embed digital signature based on provided password into image pixel data.


from aspose.imaging import Image

image_file_path = "ball.png"
password = "veryStr0ngPassword"
with Image.load(image_file_path) as image:
	image.embed_digital_signature(password)
	image.save(output_path)

The example demonstrates how to verify that the embedded digital signature matches the provided password against the specified probability threshold.


from aspose.imaging import Image
  
threshold = 100
with Image.load(output_path) as image:
	is_signed = image.is_digital_signed(password, threshold)

The example illustrates how to determine the probability (from 0% to 100%) that an image contains a digital signature created with the specified password.


from aspose.imaging import Image

with Image.load(output_path) as image:
	signed_percentage = image.analyze_percentage_digital_signature(password)