Класс PngImage

Summary: Manipulate Portable Network Graphics (PNG) raster images with our versatile API,
featuring support for compression levels and various color depths including
Grayscale, Indexed Color, TrueColor, and alpha channels. Seamlessly process XMP metadata,
enabling comprehensive image metadata management, while easily loading PNG images,
performing diverse manipulations, applying filters, and converting images to other file
formats for optimal versatility and customization.

Module: aspose.imaging.fileformats.png

Full Name: aspose.imaging.fileformats.png.PngImage

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

Constructors

Name	Description
PngImage(path)	Создаёт новый экземпляр класса PngImage с использованием параметра path для указания расположения файла изображения, которое нужно загрузить. Этот конструктор позволяет разработчикам удобно создавать PNG‑изображения, загружая их из файла, упрощая процесс работы с PNG‑изображениями в их приложениях.
PngImage(path, color_type)	Инициализирует новый экземпляр класса PngImage путем указания пути к файлу изображения и типа цвета. Этот конструктор обеспечивает удобное создание PNG‑изображений из файлов с различными типами цвета, предоставляя гибкость при работе с различными форматами изображений.
PngImage(png_options, width, height)	Инициализирует новый экземпляр класса PngImage, включая параметры PNG вместе с шириной и высотой. Этот конструктор даёт разработчикам возможность создавать PNG‑изображения с настраиваемыми параметрами и размерами, обеспечивая гибкость при генерации изображений для различных сценариев использования.
PngImage(raster_image)	Создаёт новый экземпляр класса PngImage путём предоставления растрового изображения в качестве параметра. Этот конструктор позволяет разработчикам напрямую инициализировать объект PNG‑изображения, используя существующее растровое изображение, упрощая процесс работы с PNG‑изображениями в их приложениях.
PngImage(raster_image, color_type)	Создаёт новый экземпляр класса PngImage путём указания растрового изображения и типа цвета. Этот конструктор позволяет разработчикам напрямую преобразовывать растровые изображения в формат PNG, указывая желаемый тип цвета, обеспечивая гибкость в представлении цветов.
PngImage(stream)	Создаёт новый экземпляр класса PngImage путём инициализации его потоком. Этот конструктор позволяет разработчикам загружать PNG‑изображения напрямую из потока, обеспечивая гибкость получения изображений из различных источников.
PngImage(width, height)	Инициализирует новый объект класса PngImage путём предоставления параметров ширины и высоты. Этот конструктор упрощает создание PNG‑изображений, позволяя разработчикам напрямую указывать размеры, способствуя эффективному управлению данными PNG‑изображений в их приложениях.
PngImage(width, height, color_type)	Создаёт новый экземпляр класса PngImage, указывая желаемые параметры ширины, высоты и типа цвета. Этот конструктор обеспечивает быстрое создание PNG‑изображений с индивидуальными размерами и цветовыми настройками, способствуя упрощённой генерации изображений для различных приложений и рабочих процессов.

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	Предоставляет логическое значение, указывающее, содержит ли изображение прозрачный цвет. Это свойство критически важно для приложений, которым необходимо работать с прозрачностью, позволяя разработчикам определить, требуется ли дополнительная обработка для управления прозрачными областями изображения.
height	int	r	Получить высоту изображения. Это свойство возвращает вертикальный размер изображения, позволяя разработчикам определить его размер в пикселях по вертикальной оси.
horizontal_resolution	float	r/w	Получить или изменить горизонтальное разрешение изображения. Это свойство представляет количество пикселей на дюйм по горизонтальной оси изображения. Регулировка этого разрешения может влиять на физический размер изображения при печати или отображении.
image_opacity	float	r	Получает непрозрачность этого изображения.
interlaced	bool	r	Возвращает логическое значение, указывающее, является ли PngImage чересстрочным, что определяет, хранится ли данные изображения прогрессивно для более быстрой загрузки или передачи.
interrupt_monitor	InterruptMonitor	r/w	Получает или задает монитор прерываний.
is_cached	bool	r	Получает значение, указывающее, кэшируются ли данные изображения в данный момент.
is_interlaced	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	Обеспечивает доступ к вертикальному разрешению изображения. Разработчики могут использовать это свойство для получения или изменения настройки разрешения, которое указывает количество пикселей на дюйм (PPI) по вертикальной оси изображения.
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_file_with_color_type(path, color_type)	Инициализирует новый экземпляр класса PngImage.
create_from_files(files)	Создает многостраничное изображение, содержащее указанные файлы в виде страниц с отложенной загрузкой.
create_from_files(files, throw_exception_on_load_error)	Создает многостраничное изображение, содержащее указанные файлы в виде страниц с отложенной загрузкой.
create_from_image(raster_image)	Инициализирует новый экземпляр класса PngImage.
create_from_image_with_color_type(raster_image, color_type)	Инициализирует новый экземпляр класса PngImage.
create_from_images(images)	Создаёт новое изображение, используя указанные изображения в качестве страниц
create_from_images(images, dispose_images)	Создает новое изображение из указанных изображений в виде страниц.
create_from_stream(stream)	Инициализирует новый экземпляр класса PngImage.
create_with_width_height(width, height)	Инициализирует новый экземпляр класса PngImage.
create_with_width_height_color_type(width, height, color_type)	Инициализирует новый экземпляр класса PngImage.
create_with_width_height_options(png_options, width, height)	Инициализирует новый экземпляр класса PngImage.
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)	Записывает всю строку сканирования в указанный индекс строки сканирования.

Constructor: PngImage(path)

 PngImage(path)

Создаёт новый экземпляр класса PngImage с использованием параметра path
для указания расположения файла изображения, которое нужно загрузить. Этот конструктор
позволяет разработчикам удобно создавать PNG‑изображения, загружая их из файла,
упрощая процесс работы с PNG‑изображениями в их приложениях.

Parameters:

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

See also:

Example # 1: This example shows how to load a PNG image from a file.

Constructor: PngImage(path, color_type)

 PngImage(path, color_type)

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

Parameters:

Параметр	Тип	Описание
путь	string	Путь для загрузки изображения.
color_type	PngColorType	Тип цвета.

See also:

Example # 1: This example shows how to load a PNG image from a file with the specified col…

Constructor: PngImage(png_options, width, height)

 PngImage(png_options, width, height)

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

Parameters:

Параметр	Тип	Описание
png_options	PngOptions	Параметры PNG.
width	int	Ширина.
height	int	Высота.

Constructor: PngImage(raster_image)

 PngImage(raster_image)

Создаёт новый экземпляр класса PngImage путём предоставления растрового
изображения в качестве параметра. Этот конструктор позволяет разработчикам напрямую инициализировать
объект PNG‑изображения, используя существующее растровое изображение, упрощая процесс
работы с PNG‑изображениями в их приложениях.

Parameters:

Параметр	Тип	Описание
raster_image	RasterImage	Растровое изображение.

See also:

Example # 1: This example shows how to load PNG image from a BMP image.

Constructor: PngImage(raster_image, color_type)

 PngImage(raster_image, color_type)

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

Parameters:

Параметр	Тип	Описание
raster_image	RasterImage	Растровое изображение.
color_type	PngColorType	Тип цвета.

See also:

Example # 1: This example shows how to load PNG image from a BMP image with the specified …

Constructor: PngImage(stream)

 PngImage(stream)

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

Parameters:

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

See also:

Example # 1: This example shows how to load a PNG image from a file or a file stream.

Constructor: PngImage(width, height)

 PngImage(width, height)

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

Parameters:

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

See also:

Example # 1: This example shows how to create a PNG image of the specified size, fill it w…

Constructor: PngImage(width, height, color_type)

 PngImage(width, height, color_type)

Создаёт новый экземпляр класса PngImage, указывая
желаемые параметры ширины, высоты и типа цвета. Этот конструктор обеспечивает
быстрое создание PNG‑изображений с индивидуальными размерами и цветовыми настройками,
способствуя упрощённой генерации изображений для различных приложений и рабочих процессов.

Parameters:

Параметр	Тип	Описание
width	int	Ширина.
height	int	Высота.
color_type	PngColorType	Тип цвета.

See also:

Example # 1: This example shows how to create a PNG image of the specified size with the s…

Property: has_alpha

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

See also:

Example # 1: The following example shows how to check if a PNG image supports alpha-channel.

Method: adjust_brightness(brightness)

 adjust_brightness(brightness)

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

Parameters:

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

Method: adjust_contrast(contrast)

 adjust_contrast(contrast)

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

Parameters:

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

Method: adjust_gamma(gamma)

 adjust_gamma(gamma)

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

Parameters:

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

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	Коэффициент гаммы для синего канала

Method: analyze_percentage_digital_signature(password)

 analyze_percentage_digital_signature(password)

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

Parameters:

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

Returns

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

Method: binarize_bradley(brightness_difference)

 binarize_bradley(brightness_difference)

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

Parameters:

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

Method: binarize_bradley(brightness_difference, window_size)

 binarize_bradley(brightness_difference, window_size)

Parameters:

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

Method: binarize_fixed(threshold)

 binarize_fixed(threshold)

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

Parameters:

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

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	true если изображение может быть загружено из указанного файла; в противном случае false.

Method: can_load(file_path, load_options) [static]

 can_load(file_path, load_options)

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

Parameters:

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

Returns

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

Method: can_load(stream) [static]

 can_load(stream)

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

Parameters:

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

Returns

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

Method: can_load(stream, load_options) [static]

 can_load(stream, load_options)

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

Parameters:

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

Returns

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

Method: can_load_stream(stream) [static]

 can_load_stream(stream)

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

Parameters:

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

Returns

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

Method: can_load_stream_with_options(stream, load_options) [static]

 can_load_stream_with_options(stream, load_options)

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

Parameters:

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

Returns

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

Method: can_load_with_options(file_path, load_options) [static]

 can_load_with_options(file_path, load_options)

Parameters:

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

Returns

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

Method: can_save(options)

 can_save(options)

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

Parameters:

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

Returns

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

Method: create(files) [static]

 create(files)

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

Parameters:

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

Returns

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

Method: create(files, throw_exception_on_load_error) [static]

 create(files, throw_exception_on_load_error)

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

Parameters:

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

Returns

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

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

 create(image_options, width, height)

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

Parameters:

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

Returns

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

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

 create(image_options, width, height, pixels)

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

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

Parameters:

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

Returns

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

Method: create(images) [static]

 create(images)

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

Parameters:

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

Returns

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

Method: create(images, dispose_images) [static]

 create(images, dispose_images)

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

Parameters:

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

Returns

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

Method: create(multipage_create_options) [static]

 create(multipage_create_options)

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

Parameters:

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

Returns

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

Method: create_from_file_with_color_type(path, color_type) [static]

 create_from_file_with_color_type(path, color_type)

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

Parameters:

Параметр	Тип	Описание
путь	string	Путь для загрузки изображения.
color_type	PngColorType	Тип цвета.

Returns

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

Method: create_from_files(files) [static]

 create_from_files(files)

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

Parameters:

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

Returns

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

Method: create_from_files(files, throw_exception_on_load_error) [static]

 create_from_files(files, throw_exception_on_load_error)

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

Parameters:

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

Returns

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

Method: create_from_image(raster_image) [static]

 create_from_image(raster_image)

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

Parameters:

Параметр	Тип	Описание
raster_image	RasterImage	Растровое изображение.

Returns

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

Method: create_from_image_with_color_type(raster_image, color_type) [static]

 create_from_image_with_color_type(raster_image, color_type)

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

Parameters:

Параметр	Тип	Описание
raster_image	RasterImage	Растровое изображение.
color_type	PngColorType	Тип цвета.

Returns

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

Method: create_from_images(images) [static]

 create_from_images(images)

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

Parameters:

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

Returns

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

Method: create_from_images(images, dispose_images) [static]

 create_from_images(images, dispose_images)

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

Parameters:

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

Returns

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

Method: create_from_stream(stream) [static]

 create_from_stream(stream)

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

Parameters:

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

Returns

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

Method: create_with_width_height(width, height) [static]

 create_with_width_height(width, height)

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

Parameters:

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

Returns

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

Method: create_with_width_height_color_type(width, height, color_type) [static]

 create_with_width_height_color_type(width, height, color_type)

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

Parameters:

Параметр	Тип	Описание
width	int	Ширина.
height	int	Высота.
color_type	PngColorType	Тип цвета.

Returns

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

Method: create_with_width_height_options(png_options, width, height) [static]

 create_with_width_height_options(png_options, width, height)

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

Parameters:

Параметр	Тип	Описание
png_options	PngOptions	Параметры PNG.
width	int	Ширина.
height	int	Высота.

Returns

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

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

 crop(left_shift, right_shift, top_shift, bottom_shift)

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

Parameters:

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

Method: crop(rectangle)

 crop(rectangle)

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

Parameters:

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

Method: 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	Пароль, используемый для генерации данных цифровой подписи.

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	если установлено в 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:

Параметр	Тип	Описание
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], определяющий, считается ли изображение подписанным. Если не указано, будет применён порог по умолчанию (75).

Returns

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

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)

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	Частичный загрузчик пикселей.

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)

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	если установить значение true, размер изображения будет изменён в соответствии с проекциями повернутого прямоугольника (угловых точек); в противном случае размеры останутся неизменными, и будет вращено только внутреннее содержимое изображения.
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.

Method: resize(new_width, new_height, settings)

 resize(new_width, new_height, settings)

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

Parameters:

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

Method: resize_by_settings(new_width, new_height, settings)

 resize_by_settings(new_width, new_height, settings)

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

Parameters:

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

Method: resize_by_type(new_width, new_height, resize_type)

 resize_by_type(new_width, new_height, resize_type)

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

Parameters:

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

Method: resize_height_proportionally(new_height)

 resize_height_proportionally(new_height)

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

Parameters:

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

Method: resize_height_proportionally(new_height, resize_type)

 resize_height_proportionally(new_height, resize_type)

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

Parameters:

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

Method: resize_height_proportionally(new_height, settings)

 resize_height_proportionally(new_height, settings)

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

Parameters:

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

Method: resize_height_proportionally_settings(new_height, settings)

 resize_height_proportionally_settings(new_height, settings)

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

Parameters:

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

Method: resize_width_proportionally(new_width)

 resize_width_proportionally(new_width)

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

Parameters:

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

Method: resize_width_proportionally(new_width, resize_type)

 resize_width_proportionally(new_width, resize_type)

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

Parameters:

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

Method: resize_width_proportionally(new_width, settings)

 resize_width_proportionally(new_width, settings)

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

Parameters:

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

Method: resize_width_proportionally_settings(new_width, settings)

 resize_width_proportionally_settings(new_width, settings)

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

Parameters:

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

Method: rotate(angle)

 rotate(angle)

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

Parameters:

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

Method: rotate(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	если установить значение true, размер изображения будет изменён в соответствии с проекциями повернутого прямоугольника (угловых точек); в противном случае размеры останутся неизменными, и будет вращено только внутреннее содержимое изображения.
background_color	Color	Цвет фона.

Method: rotate_flip(rotate_flip_type)

 rotate_flip(rotate_flip_type)

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

Parameters:

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

Method: save(file_path)

 save(file_path)

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

Parameters:

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

Method: save(file_path, options)

 save(file_path, options)

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

Parameters:

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

Method: save(file_path, options, bounds_rectangle)

 save(file_path, options, bounds_rectangle)

Parameters:

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

Method: save(file_path, over_write)

 save(file_path, over_write)

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

Parameters:

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

Method: save(stream)

 save(stream)

Данные сохранения.

Parameters:

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

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	Если установить значение true, цвета будут обновлены в соответствии с новой палитрой; в противном случае индексы цветов останутся неизменными. Обратите внимание, что неизменные индексы могут привести к сбою загрузки изображения, если некоторые индексы не имеют соответствующих записей в палитре.

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

This example shows how to load a PNG image from a file.


from aspose.pycore import as_of
from aspose.imaging import Image
from aspose.imaging.fileformats.png import PngImage

# Загрузить PNG‑изображение из файла.
with as_of(Image.load("sample.png"), PngImage) as pngImage:
	# Преобразовать изображение в градации серого
	pngImage.grayscale()
	# Сохранить в файл.
	pngImage.save("sample.grayscale.png")

This example shows how to load a PNG image from a file with the specified color type.


import aspose.pycore as aspycore
from aspose.imaging.fileformats.png import PngImage, PngColorType
from os.path import join

dir_ = "c:\\temp"
# Загрузить PNG‑изображение из файла.
# Обратите внимание, что цветное изображение будет автоматически преобразовано в градации серого.
with PngImage(join(dir_, "sample.png"), PngColorType.GRAYSCALE) as png_image:
	# Сохранить в файл.
	png_image.save(join(dir_, "sample.grayscale.png"))

This example shows how to load a PNG image from a file or a file stream.

import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.png import PngImage
from os.path import join


dir_: str = "c:\\temp"
# Загрузить PNG‑изображение из потока файла.
with open(join(dir_, "sample.png"), "rb") as stream:
	with PngImage(stream) as png_image:
		# Преобразовать изображение в градации серого
		png_image.grayscale()
		# Сохранить в файл.
		png_image.save(join(dir_, "sample.grayscale.png"))

This example shows how to load PNG image from a BMP image.

from aspose.imaging.fileformats.bmp import BmpImage
from aspose.imaging.fileformats.png import PngImage
from aspose.imaging import Graphics, Color
from aspose.imaging.brushes import SolidBrush
from os.path import join

dir_: str = "c:\\temp"
# Загрузить TrueColor PNG‑изображение из BMP‑изображения.
# Сначала создайте временное BMP‑изображение, которое будет основой для создания PNG‑изображения.
# Вы также можете загрузить BMP‑изображение из файла или использовать изображение любого другого растрового формата.
with BmpImage(100, 100) as bmp_image:
	# Заполните всё BMP‑изображение красным цветом.
	gr = Graphics(bmp_image)
	brush = SolidBrush(Color.red)
	gr.fill_rectangle(brush, bmp_image.bounds)
	with PngImage(bmp_image) as png_image:
		png_image.save(join(dir_, "output.png"))

This example shows how to load PNG image from a BMP image with the specified color type.


from aspose.imaging import LoadOptions, Graphics, Color
from aspose.imaging.brushes import SolidBrush
from aspose.imaging.imageoptions import PngOptions
from aspose.imaging.fileformats.bmp import BmpImage
from aspose.imaging.fileformats.png import PngImage, PngColorType
from os.path import join as path_join


dir_ = "c:\\temp"
# Загрузить PNG‑изображение в градациях серого из цветного BMP‑изображения.
# Сначала создайте временное BMP‑изображение, которое будет основой для создания PNG‑изображения.
# Вы также можете загрузить BMP‑изображение из файла или использовать изображение любого другого растрового формата.
with BmpImage(100, 100) as bmp_image:
	# Заполните всё BMP‑изображение красным цветом.
	gr = Graphics(bmp_image)
	brush = SolidBrush(Color.red)
	gr.fill_rectangle(brush, bmp_image.bounds)
	# Цвета пикселей изображения будут преобразованы в их аналоги в градациях серого.
	with PngImage(bmp_image, PngColorType.GRAYSCALE) as png_image:
		png_image.save(path_join(dir_, "output.grayscale.png"))

This example shows how to create a PNG image of the specified size, fill it with a solid color and save it to a file.


import aspose.pycore as aspycore
from aspose.imaging import Graphics, Color
from aspose.imaging.brushes import SolidBrush
from aspose.imaging.fileformats.png import PngImage
from os.path import join


dir_ = "c:\\temp"
# Создать PNG‑изображение размером 100 × 100 px.
with PngImage(100, 100) as png_image:
	# Выполнить обработку изображения, например, заполнить всё изображение красным.
	graphics = Graphics(png_image)
	brush = SolidBrush(Color.red)
	graphics.fill_rectangle(brush, png_image.bounds)
	# Сохранить в файл.
	png_image.save(join(dir_, "output.png"))

This example shows how to create a PNG image of the specified size with the specified color type, fill it with a solid color and save it to a file.

from aspose.imaging.fileformats.png import PngImage, PngColorType
from aspose.imaging import Graphics, Color
from aspose.imaging.brushes import SolidBrush
from os.path import join

dir_: str = "c:\\temp"
# Создать PNG‑изображение в градациях серого размером 100×100 пикселей.
# Все цвета будут автоматически преобразованы в формат градаций серого.
with PngImage(100, 100, PngColorType.GRAYSCALE) as png_image:
	# Выполнить обработку изображения, например, заполнить всё изображение красным.
	graphics = Graphics(png_image)
	brush = SolidBrush(Color.red)
	graphics.fill_rectangle(brush, png_image.bounds)
	# Сохранить в файл.
	png_image.save(join(dir_, "output.grayscale.png"))

The following example shows how to check if a PNG image supports alpha-channel.


from aspose.imaging import Image
from aspose.imaging.imageoptions import PngOptions
from aspose.imaging.fileformats.png import PngColorType, PngImage


# Получить все поддерживаемые типы цветов PNG.
color_types = [it for it in PngColorType]
for color_type in color_types:
	create_options = PngOptions()
	create_options.color_type = color_type
	with Image.create(create_options, 100, 100) as image:
		png_image = aspycore.as_of(image, PngImage)
		if png_image.has_alpha:
			print("A {0} PNG image supports alpha channel".format(create_options.color_type))
		else:
			print("A {0} PNG image doesn't support alpha channel".format(create_options.color_type))

# Вывод выглядит так:
# PNG‑изображение в градациях серого не поддерживает альфа‑канал
# PNG‑изображение TrueColor не поддерживает альфа‑канал
# PNG‑изображение IndexedColor не поддерживает альфа‑канал
# Изображение PNG GrayscaleWithAlpha поддерживает альфа‑канал
# Изображение PNG TruecolorWithAlpha поддерживает альфа‑канал

The example shows how to remove any object from the image using Graphics Path with Content Aware fill algorithm.

from aspose.imaging import Image, Figure, GraphicsPath, RectangleF
from aspose.imaging.shapes import EllipseShape
from aspose.imaging.watermark import WatermarkRemover
from aspose.imaging.watermark.options import ContentAwareFillWatermarkOptions
from aspose.imaging.fileformats.png import PngImage
import aspose.pycore import as_of

image_file_path = "ball.png"; 
with Image.load(image_file_path) as image:
	pngImage = as_of(image, PngImage)
	mask = GraphicsPath()
	firstFigure = Figure()
	firstFigure.add_shape(EllipseShape(RectangleF(350, 170, 570 - 350, 400 - 170)))
	mask.add_figure(firstFigure)

	options = ContentAwareFillWatermarkOptions(mask)
	options.max_painting_attempts = 4
	with WatermarkRemover.paint_over(pngImage, options) as result:
		result.save(outputPath)

The example shows how to remove any object from the image using Graphics Path with Telea algorithm.

from aspose.imaging import Image, Figure, GraphicsPath, RectangleF
from aspose.imaging.shapes import EllipseShape
from aspose.imaging.watermark import WatermarkRemover
from aspose.imaging.watermark.options import TeleaWatermarkOptions
from aspose.imaging.fileformats.png import PngImage
import aspose.pycore import as_of

image_file_path = "ball.png"; 
with Image.load(image_file_path) as image:
	pngImage = as_of(image, PngImage)
	mask = GraphicsPath()
	firstFigure = Figure()
	firstFigure.add_shape(EllipseShape(RectangleF(350, 170, 570 - 350, 400 - 170)))
	mask.add_figure(firstFigure);
	options = TeleaWatermarkOptions(mask)
	with WatermarkRemover.paint_over(pngImage, options) as result:
		result.save(outputPath)

Перечисление PngColorType