Класс 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
| 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_alpha | bool | r | Получает значение, указывающее, имеет ли этот экземпляр альфа-канал. |
| has_background_color | bool | r/w | Получает или задает значение, указывающее, имеет ли изображение фоновый цвет. |
| has_transparent_color | bool | r/w | Получает или задаёт значение, указывающее, имеет ли этот экземпляр RasterImage прозрачный цвет. |
| height | int | r | Получает высоту объекта. |
| horizontal_resolution | float | r/w | Получает или задает горизонтальное разрешение в пикселях на дюйм для этого RasterImage. |
| image_opacity | float | r | Получает непрозрачность этого изображения. |
| interrupt_monitor | InterruptMonitor | r/w | Получает или задает монитор прерываний. |
| is_cached | bool | r | Получает значение, указывающее, кэшируются ли данные изображения в данный момент. |
| is_raw_data_available | bool | r | Получает значение, указывающее, доступна ли загрузка необработанных данных. |
| metadata | ImageMetadata | r | Получает метаданные изображения. |
| palette | IColorPalette | r/w | Получает или задает цветовую палитру. Цветовая палитра не используется, когда пиксели представлены напрямую. |
| premultiply_components | bool | r/w | Получает или задает значение, указывающее, должны ли компоненты изображения быть предварительно умножены. |
| raw_custom_color_converter | IColorConverter | r/w | Получает или задает пользовательский конвертер цветов |
| raw_data_format | PixelDataFormat | r | Получает формат необработанных данных. |
| raw_data_settings | RawDataSettings | r | Получает текущие настройки необработанных данных. Обратите внимание, что при использовании этих настроек данные загружаются без конвертации. |
| raw_fallback_index | int | r/w | Получает или задает резервный индекс, используемый, когда индекс палитры выходит за пределы. |
| raw_indexed_color_converter | IIndexedColorConverter | r/w | Получает или задает индексированный конвертер цветов |
| raw_line_size | int | r | Получает размер необработанной строки в байтах. |
| size | Size | r | Получает размер объекта. |
| transparent_color | Color | r/w | Получает прозрачный цвет изображения. |
| update_xmp_data | bool | r/w | Получает или задает значение, указывающее, следует ли обновлять метаданные XMP. |
| use_palette | bool | r | Получает значение, указывающее, используется ли палитра изображения. |
| use_raw_data | bool | r/w | Получает или задает значение, указывающее, следует ли использовать загрузку необработанных данных, когда такая загрузка доступна. |
| vertical_resolution | float | r/w | Получает или задает вертикальное разрешение в пикселях на дюйм для этого RasterImage. |
| width | int | r | Получает ширину объекта. |
| xmp_data | XmpPacketWrapper | r/w | Получает или задает данные Xmp. |
Methods
| Name | Description |
|---|---|
| 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_red | float | Коэффициент гаммы для красного канала |
| gamma_green | float | Коэффициент гаммы для зелёного канала |
| gamma_blue | float | Коэффициент гаммы для синего канала |
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_difference | float | Разница яркости между пикселем и средним значением окна 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_difference | float | Разница яркости между пикселем и средним значением окна s × s пикселей, центрированного вокруг этого пикселя. |
| window_size | int | Размер окна 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:
| Параметр | Тип | Описание |
|---|---|---|
| origin | Point | Источник наложения фонового изображения. |
| overlay | RasterImage | Изображение наложения. |
| overlay_alpha | System.Byte | Прозрачность наложения. |
Method: blend(origin, overlay, overlay_area, overlay_alpha)
blend(origin, overlay, overlay_area, overlay_alpha)
Смешивает этот экземпляр изображения с изображением overlay.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| origin | Point | Источник наложения фонового изображения. |
| overlay | RasterImage | Изображение наложения. |
| overlay_area | Rectangle | Область наложения. |
| overlay_alpha | System.Byte | Прозрачность наложения. |
Method: can_load(file_path) [static]
can_load(file_path)
Определяет, можно ли загрузить изображение из указанного пути к файлу.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| file_path | string | Путь к файлу. |
Returns
| Тип | Описание |
|---|---|
| bool |
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 |
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 |
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 | Новосозданное изображение. |
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 | Прямоугольник. |
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_method | DitheringMethod | Метод дизеринга. |
| bits_count | int | Окончательное количество бит для дизеринга. |
Method: dither(dithering_method, bits_count, custom_palette)
dither(dithering_method, bits_count, custom_palette)
Выполняет дизеринг текущего изображения.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| dithering_method | DitheringMethod | Метод дизеринга. |
| bits_count | int | Окончательное количество бит для дизеринга. |
| custom_palette | IColorPalette | Пользовательская палитра для дизеринга. |
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:
| Параметр | Тип | Описание |
|---|---|---|
| rectangle | Rectangle | Прямоугольник. |
| options | FilterOptionsBase | Параметры. |
Method: get_argb_32_pixel(x, y)
get_argb_32_pixel(x, y)
Получает 32-битный ARGB‑пиксель изображения.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| x | int | Координата x пикселя. |
| y | int | Координата y пикселя. |
Returns
| Тип | Описание |
|---|---|
| int | 32-битный ARGB‑пиксель для указанного местоположения. |
Method: get_default_argb_32_pixels(rectangle)
get_default_argb_32_pixels(rectangle)
Получает массив пикселей по умолчанию в формате 32‑бит ARGB.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| rectangle | Rectangle | Прямоугольник, для которого получаются пиксели. |
Returns
| Тип | Описание |
|---|---|
| int[] | Массив пикселей по умолчанию |
Method: get_default_options(args)
get_default_options(args)
Получает параметры по умолчанию.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| args | System.Object | Аргументы. |
Returns
| Тип | Описание |
|---|---|
| ImageOptionsBase | Параметры по умолчанию |
Method: get_default_pixels(rectangle, partial_pixel_loader)
get_default_pixels(rectangle, partial_pixel_loader)
Получает массив пикселей по умолчанию с использованием частичного загрузчика пикселей.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| rectangle | Rectangle | Прямоугольник, для которого получаются пиксели. |
| partial_pixel_loader | IPartialArgb32PixelLoader | Частичный загрузчик пикселей. |
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:
| Параметр | Тип | Описание |
|---|---|---|
| rectangle | Rectangle | Прямоугольник, для которого получаются пиксели. |
| partial_raw_data_loader | IPartialRawDataLoader | Частичный загрузчик необработанных данных. |
| raw_data_settings | RawDataSettings | Настройки необработанных данных. |
Method: get_default_raw_data(rectangle, raw_data_settings)
get_default_raw_data(rectangle, raw_data_settings)
Получает массив необработанных данных по умолчанию.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| rectangle | Rectangle | Прямоугольник, для которого получаются необработанные данные. |
| raw_data_settings | RawDataSettings | Настройки необработанных данных. |
Returns
| Тип | Описание |
|---|---|
| System.Byte | Массив необработанных данных по умолчанию |
Method: get_file_format(file_path) [static]
get_file_format(file_path)
Получает формат файла.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| file_path | string | Путь к файлу. |
Returns
| Тип | Описание |
|---|---|
| FileFormat | Определённый формат файла. |
Method: get_file_format(stream) [static]
get_file_format(stream)
Получает формат файла.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| поток | _io.BufferedRandom | Поток. |
Returns
| Тип | Описание |
|---|---|
| FileFormat | Определённый формат файла. |
Method: get_file_format_of_stream(stream) [static]
get_file_format_of_stream(stream)
Получает формат файла.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| поток | _io.BufferedRandom | Поток. |
Returns
| Тип | Описание |
|---|---|
| FileFormat | Определённый формат файла. |
Method: get_fitting_rectangle(rectangle, pixels, width, height) [static]
get_fitting_rectangle(rectangle, pixels, width, height)
Получает прямоугольник, соответствующий текущему изображению.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| rectangle | Rectangle | Прямоугольник, для которого определяется подходящий прямоугольник. |
| пиксели | int[] | 32‑битные ARGB пиксели. |
| width | int | Ширина объекта. |
| height | int | Высота объекта. |
Returns
| Тип | Описание |
|---|---|
| Rectangle | Подходящий прямоугольник или исключение, если подходящий прямоугольник не найден. |
Method: get_fitting_rectangle(rectangle, width, height) [static]
get_fitting_rectangle(rectangle, width, height)
Получает прямоугольник, соответствующий текущему изображению.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| rectangle | Rectangle | Прямоугольник, для которого определяется подходящий прямоугольник. |
| width | int | Ширина объекта. |
| height | int | Высота объекта. |
Returns
| Тип | Описание |
|---|---|
| Rectangle | Подходящий прямоугольник или исключение, если подходящий прямоугольник не найден. |
Method: get_modify_date(use_default)
get_modify_date(use_default)
Получает дату и время последнего изменения ресурса изображения.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| use_default | bool | если установлено в |
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:
| Параметр | Тип | Описание |
|---|---|---|
| x | int | Координата x пикселя. |
| y | int | Координата y пикселя. |
Returns
| Тип | Описание |
|---|---|
| Color | Цвет пикселя для указанного местоположения. |
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: get_skew_angle()
get_skew_angle()
Получает угол наклона.
Этот метод применим к отсканированным текстовым документам для определения угла наклона при сканировании.
Returns
| Тип | Описание |
|---|---|
| float | Угол наклона в градусах. |
Method: is_digital_signed(password, percentage_threshold)
is_digital_signed(password, percentage_threshold)
Выполняет быструю проверку, чтобы определить, подписано ли изображение цифровой подписью, используя предоставленный пароль и пороговое значение.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| пароль | string | Пароль для проверки подписи. |
| percentage_threshold | int | Порог (в процентах)[0-100], определяющий, считается ли изображение подписанным. Если не указано, будет применён порог по умолчанию ( |
Returns
| Тип | Описание |
|---|---|
| bool | True, если изображение подписано, иначе 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_path | string | Путь к файлу или URL для загрузки изображения. |
Returns
| Тип | Описание |
|---|---|
| Image | Загруженное изображение. |
Method: load(file_path, load_options) [static]
load(file_path, load_options)
Загружает новое изображение из указанного пути к файлу или URL.
Если filePath — путь к файлу, метод просто открывает файл.
Если filePath — URL, метод загружает файл, сохраняет его как временный и открывает.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| file_path | string | Путь к файлу или URL для загрузки изображения. |
| load_options | LoadOptions | Опции загрузки. |
Returns
| Тип | Описание |
|---|---|
| Image | Загруженное изображение. |
Method: load(stream) [static]
load(stream)
Загружает новое изображение из указанного потока.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| поток | _io.BufferedRandom | Поток для загрузки изображения. |
Returns
| Тип | Описание |
|---|---|
| Image | Загруженное изображение. |
Method: load(stream, load_options) [static]
load(stream, load_options)
Загружает новое изображение из указанного потока.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| поток | _io.BufferedRandom | Поток для загрузки изображения. |
| load_options | LoadOptions | Опции загрузки. |
Returns
| Тип | Описание |
|---|---|
| Image | Загруженное изображение. |
Method: load_argb_32_pixels(rectangle)
load_argb_32_pixels(rectangle)
Загружает 32‑битные ARGB‑пиксели.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| rectangle | Rectangle | Прямоугольник, из которого загружать пиксели. |
Returns
| Тип | Описание |
|---|---|
| int[] | Загруженный массив 32‑битных ARGB пикселей. |
Method: load_argb_64_pixels(rectangle)
load_argb_64_pixels(rectangle)
Загружает 64‑битные ARGB‑пиксели.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| rectangle | Rectangle | Прямоугольник, из которого загружать пиксели. |
Returns
| Тип | Описание |
|---|---|
| int[] | Загруженный массив пикселей ARGB 64‑бит. |
Method: load_cmyk_32_pixels(rectangle)
load_cmyk_32_pixels(rectangle)
Загружает пиксели в формате CMYK.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| rectangle | Rectangle | Прямоугольник, из которого загружать пиксели. |
Returns
| Тип | Описание |
|---|---|
| int[] | Загруженный массив пикселей CMYK, представленных как 32‑битные целочисленные значения. |
Method: load_cmyk_pixels(rectangle)
load_cmyk_pixels(rectangle)
Загружает пиксели в формате CMYK.
Этот метод устарел. Пожалуйста, используйте более эффективный метод RasterImage.load_cmyk_32_pixels(rectangle).
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| rectangle | Rectangle | Прямоугольник, из которого загружать пиксели. |
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:
| Параметр | Тип | Описание |
|---|---|---|
| rectangle | Rectangle | Желаемый прямоугольник. |
| partial_pixel_loader | IPartialArgb32PixelLoader | Загрузчик 32‑битных ARGB‑пикселей. |
Method: load_partial_argb_64_pixels(rectangle, partial_pixel_loader)
load_partial_argb_64_pixels(rectangle, partial_pixel_loader)
Частично загружает 64‑битные ARGB‑пиксели пакетами.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| rectangle | Rectangle | Желаемый прямоугольник. |
| partial_pixel_loader | IPartialArgb64PixelLoader | Загрузчик пикселей ARGB 64‑бит. |
Method: load_partial_pixels(desired_rectangle, pixel_loader)
load_partial_pixels(desired_rectangle, pixel_loader)
Частично загружает пиксели пакетами.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| desired_rectangle | Rectangle | Желаемый прямоугольник. |
| pixel_loader | IPartialPixelLoader | Загрузчик пикселей. |
Method: load_pixels(rectangle)
load_pixels(rectangle)
Загружает пиксели.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| rectangle | Rectangle | Прямоугольник, из которого загружать пиксели. |
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:
| Параметр | Тип | Описание |
|---|---|---|
| rectangle | Rectangle | Прямоугольник, из которого загружать необработанные данные. |
| dest_image_bounds | Rectangle | Границы целевого изображения. |
| raw_data_settings | RawDataSettings | Настройки необработанных данных, используемые для загруженных данных. Обратите внимание, что если данные не в указанном формате, будет выполнено их преобразование. |
| raw_data_loader | IPartialRawDataLoader | Загрузчик необработанных данных. |
Method: load_raw_data(rectangle, raw_data_settings, raw_data_loader)
load_raw_data(rectangle, raw_data_settings, raw_data_loader)
Загружает необработанные данные.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| rectangle | Rectangle | Прямоугольник, из которого загружать необработанные данные. |
| raw_data_settings | RawDataSettings | Настройки необработанных данных, используемые для загруженных данных. Обратите внимание, что если данные не в указанном формате, будет выполнено их преобразование. |
| raw_data_loader | IPartialRawDataLoader | Загрузчик необработанных данных. |
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: 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_proportionally | bool | если установить значение |
| background_color | Color | Цвет фона. |
Method: read_argb_32_scan_line(scan_line_index)
read_argb_32_scan_line(scan_line_index)
Считывает всю строку сканирования по указанному индексу строки сканирования.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| scan_line_index | int | Индекс строки сканирования, начинающийся с нуля. |
Returns
| Тип | Описание |
|---|---|
| int[] | Массив 32‑битных значений цветов ARGB строки сканирования. |
Method: read_scan_line(scan_line_index)
read_scan_line(scan_line_index)
Считывает всю строку сканирования по указанному индексу строки сканирования.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| scan_line_index | int | Индекс строки сканирования, начинающийся с нуля. |
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_argb | int | Значение ARGB старого цвета, которое будет заменено. |
| old_color_diff | System.Byte | Допустимая разница в старом цвете, позволяющая расширить заменённый тон цвета. |
| new_color_argb | int | Новое значение ARGB цвета для замены старого цвета. |
Method: replace_color(old_color, old_color_diff, new_color)
replace_color(old_color, old_color_diff, new_color)
Заменяет один цвет другим с допустимой разницей и сохраняет исходное альфа‑значение для сохранения плавных краёв.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| old_color | Color | Старый цвет, который будет заменён. |
| old_color_diff | System.Byte | Допустимая разница в старом цвете, позволяющая расширить заменённый тон цвета. |
| new_color | Color | Новый цвет, которым заменяется старый цвет. |
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_argb | int | Значение ARGB старого цвета, которое будет заменено. |
| old_color_diff | System.Byte | Допустимая разница в старом цвете, позволяющая расширить заменённый тон цвета. |
| new_color_argb | int | Новое значение ARGB цвета для замены старого цвета. |
Method: replace_non_transparent_colors(new_color)
replace_non_transparent_colors(new_color)
Заменяет все непрозрачные цвета новым цветом и сохраняет исходное значение альфа‑канала, чтобы сохранить плавные края.
Примечание: если использовать его на изображениях без прозрачности, все цвета будут заменены одним цветом.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| new_color | Color | Новый цвет, которым заменяются непрозрачные цвета. |
Method: replace_non_transparent_colors(new_color_argb)
replace_non_transparent_colors(new_color_argb)
Заменяет все непрозрачные цвета новым цветом и сохраняет исходное значение альфа‑канала, чтобы сохранить плавные края.
Примечание: если использовать его на изображениях без прозрачности, все цвета будут заменены одним цветом.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| new_color_argb | int | Новое значение ARGB цвета для замены непрозрачных цветов. |
Method: resize(new_width, new_height)
resize(new_width, new_height)
Изменяет размер изображения. По умолчанию используется ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| new_width | int | Новая ширина. |
| new_height | int | Новая высота. |
Method: resize(new_width, new_height, resize_type)
resize(new_width, new_height, resize_type)
Изменяет размер изображения.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| new_width | int | Новая ширина. |
| new_height | int | Новая высота. |
| resize_type | ResizeType | The resize type. |
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_width | int | Новая ширина. |
| new_height | int | Новая высота. |
| settings | ImageResizeSettings | The 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_width | int | Новая ширина. |
| new_height | int | Новая высота. |
| settings | ImageResizeSettings | The resize settings. |
Method: resize_by_type(new_width, new_height, resize_type)
resize_by_type(new_width, new_height, resize_type)
Изменяет размер изображения.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| new_width | int | Новая ширина. |
| new_height | int | Новая высота. |
| resize_type | ResizeType | The resize type. |
Method: resize_height_proportionally(new_height)
resize_height_proportionally(new_height)
Пропорционально изменяет высоту. По умолчанию используется ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| new_height | int | Новая высота. |
Method: resize_height_proportionally(new_height, resize_type)
resize_height_proportionally(new_height, resize_type)
Пропорционально изменяет высоту.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| new_height | int | Новая высота. |
| resize_type | ResizeType | Type of the resize. |
Method: resize_height_proportionally(new_height, settings)
resize_height_proportionally(new_height, settings)
Пропорционально изменяет высоту.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| new_height | int | Новая высота. |
| settings | ImageResizeSettings | The image resize settings. |
Method: resize_height_proportionally_settings(new_height, settings)
resize_height_proportionally_settings(new_height, settings)
Пропорционально изменяет высоту.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| new_height | int | Новая высота. |
| settings | ImageResizeSettings | The image resize settings. |
Method: resize_width_proportionally(new_width)
resize_width_proportionally(new_width)
Пропорционально изменяет ширину. По умолчанию используется ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| new_width | int | Новая ширина. |
Method: resize_width_proportionally(new_width, resize_type)
resize_width_proportionally(new_width, resize_type)
Пропорционально изменяет ширину.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| new_width | int | Новая ширина. |
| resize_type | ResizeType | Type of the resize. |
Method: resize_width_proportionally(new_width, settings)
resize_width_proportionally(new_width, settings)
Пропорционально изменяет ширину.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| new_width | int | Новая ширина. |
| settings | ImageResizeSettings | The image resize settings. |
Method: resize_width_proportionally_settings(new_width, settings)
resize_width_proportionally_settings(new_width, settings)
Пропорционально изменяет ширину.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| new_width | int | Новая ширина. |
| settings | ImageResizeSettings | The image resize settings. |
Method: rotate(angle)
rotate(angle)
Повернуть изображение вокруг центра.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| угол | float | The rotate angle in degrees. Positive values will rotate clockwise. |
Method: rotate(angle, resize_proportionally, background_color)
rotate(angle, resize_proportionally, background_color)
Повернуть изображение вокруг центра.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| угол | float | The rotate angle in degrees. Positive values will rotate clockwise. |
| resize_proportionally | bool | если установить значение |
| background_color | Color | Цвет фона. |
Method: rotate_flip(rotate_flip_type)
rotate_flip(rotate_flip_type)
Вращает, отражает или вращает и отражает изображение.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| rotate_flip_type | RotateFlipType | The 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_path | string | The file path to save the image to. |
Method: save(file_path, options)
save(file_path, options)
Сохраняет данные объекта в указанное расположение файла в заданном формате файла согласно параметрам сохранения.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| file_path | string | Путь к файлу. |
| options | ImageOptionsBase | Параметры. |
Method: save(file_path, options, bounds_rectangle)
save(file_path, options, bounds_rectangle)
Сохраняет данные объекта в указанное расположение файла в заданном формате файла согласно параметрам сохранения.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| file_path | string | Путь к файлу. |
| options | ImageOptionsBase | Параметры. |
| bounds_rectangle | Rectangle | The destination image bounds rectangle. Set the empty rectangle for use sourse bounds. |
Method: save(file_path, over_write)
save(file_path, over_write)
Сохраняет данные объекта в указанное расположение файла.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| file_path | string | The file path to save the object’s data to. |
| over_write | bool | если установлено |
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. |
Method: save(stream, options_base, bounds_rectangle)
save(stream, options_base, bounds_rectangle)
Сохраняет данные изображения в указанный поток в заданном формате файла согласно параметрам сохранения.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| поток | _io.BufferedRandom | The stream to save the image’s data to. |
| options_base | ImageOptionsBase | The save options. |
| bounds_rectangle | Rectangle | Прямоугольник границ целевого изображения. Установите пустой прямоугольник для использования границ источника. |
Method: save_argb_32_pixels(rectangle, pixels)
save_argb_32_pixels(rectangle, pixels)
Сохраняет 32-битные ARGB‑пиксели.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| rectangle | Rectangle | The 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:
| Параметр | Тип | Описание |
|---|---|---|
| rectangle | Rectangle | The 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:
| Параметр | Тип | Описание |
|---|---|---|
| rectangle | Rectangle | The rectangle to save pixels to. |
| pixels | CmykColor[] | The CMYK pixels array. |
Method: save_pixels(rectangle, pixels)
save_pixels(rectangle, pixels)
Сохраняет пиксели (метод, специфичный для формата).
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| rectangle | Rectangle | The rectangle to save pixels to. |
| pixels | Color[] | 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.Byte | The raw data. |
| data_offset | int | The starting raw data offset. |
| rectangle | Rectangle | The raw data rectangle. |
| raw_data_settings | RawDataSettings | Настройки необработанных данных, в которых находятся данные. |
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_argb_32_pixel(x, y, argb_32_color)
set_argb_32_pixel(x, y, argb_32_color)
Устанавливает 32‑битный ARGB‑пиксель изображения для указанной позиции.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| x | int | Координата x пикселя. |
| y | int | Координата y пикселя. |
| argb_32_color | int | 32‑битный ARGB‑пиксель для указанной позиции. |
Method: set_palette(palette, update_colors)
set_palette(palette, update_colors)
Устанавливает палитру изображения.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| palette | IColorPalette | Палитра для установки. |
| update_colors | bool | Если установить значение |
Method: set_pixel(x, y, color)
set_pixel(x, y, color)
Устанавливает пиксель изображения для указанной позиции.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| x | int | Координата x пикселя. |
| y | int | Координата y пикселя. |
| color | Color | Цвет пикселя для указанной позиции. |
Method: set_resolution(dpi_x, dpi_y)
set_resolution(dpi_x, dpi_y)
Устанавливает разрешение для этого RasterImage.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| dpi_x | float | Горизонтальное разрешение в точках на дюйм для RasterImage. |
| dpi_y | float | Вертикальное разрешение в точках на дюйм для RasterImage. |
Method: try_set_metadata(metadata)
try_set_metadata(metadata)
Пытается установить экземпляр metadata, если этот экземпляр Image поддерживает и реализует экземпляр IImageMetadataFormat.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| metadata | IImageMetadataFormat | Метаданные. |
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_index | int | Индекс строки сканирования, начинающийся с нуля. |
| argb_32_pixels | int[] | Массив 32‑битных ARGB‑цветов для записи. |
Method: write_scan_line(scan_line_index, pixels)
write_scan_line(scan_line_index, pixels)
Записывает всю строку сканирования в указанный индекс строки сканирования.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| scan_line_index | int | Индекс строки сканирования, начинающийся с нуля. |
| pixels | Color[] | Массив цветов пикселей для записи. |
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)