DngImage Класс

Summary: The API for processing DNG (Digital Negative) image file format used for digital
photography needs by providing comprehensive support for raw files and metadata.
Designed for use with digital cameras across various manufacturers, it enables
developers to manipulate aspects like bits per pixel, extract internal data,
and adjust image balance efficiently. With capabilities to update and save image
data seamlessly, this API empowers developers to work with DNG files,
ensuring high-quality results and versatile processing options.

Module: aspose.imaging.fileformats.dng

Full Name: aspose.imaging.fileformats.dng.DngImage

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

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	Получает непрозрачность этого изображения.
img_data	RawData	r/w	Управляйте данными изображения с помощью этого свойства. Независимо от того, получаете вы их или обновляете, это свойство обеспечивает беспрепятственный доступ к данным изображения для эффективного манипулирования.
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	Значение яркости.

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_files(files) [static]

 create_from_files(files) 

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

Parameters:

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

Returns

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

Method: create_from_files(files, throw_exception_on_load_error) [static]

 create_from_files(files, throw_exception_on_load_error) 

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

Parameters:

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

Returns

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

Method: create_from_images(images) [static]

 create_from_images(images) 

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

Parameters:

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

Returns

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

Method: create_from_images(images, dispose_images) [static]

 create_from_images(images, dispose_images) 

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

Parameters:

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

Returns

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

Method: 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) 

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

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	если установить значение 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	The stream to save data to.

Method: save(stream, options_base)

 save(stream, options_base) 

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

Parameters:

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

Method: save(stream, options_base, bounds_rectangle)

 save(stream, options_base, bounds_rectangle) 

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

Parameters:

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

Method: save_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 DNG image from a file, print its properties and save it to PNG.

import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.dng import DngImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join


dir_: str = "c:\\temp"
with Image.load(join(dir_, "test.dng")) as image:
	dng_image = aspycore.as_of(image, DngImage)
	raw_data = dng_image.img_data
	parameters = raw_data.image_data_parameters
	if parameters is not None:
		print("The camera manufacturer:              ", str(parameters.camera_manufacturer))
		print("The camera model:                     ", str(parameters.model))
		print("The colors count:                     ", str(parameters.colors_count))
		print("The colors description:               ", str(parameters.description))
		print("The DNG version:                      ", str(parameters.dng_version))
		print("The number of RAW images in the file: ", str(parameters.raw_count))
		print("The software:                         ", str(parameters.software))
		print("The order of the color pixels:        ", bin(parameters.filters))
		translation_cfa_dng = parameters.translation_cfa_dng
		if translation_cfa_dng is not None:
			print("The translation array for CFA mosaic :", translation_cfa_dng.length)
			for s in translation_cfa_dng:
				print("- ", s)

	other_parameters = raw_data.image_other_parameters
	if other_parameters is not None:
		print("The aperture:                         ", other_parameters.aperture)
		print("The description:                      ", other_parameters.description)
		print("The focal length:                     ", other_parameters.focal_length)
		print("The ISO sensitivity:                  ", other_parameters.iso_speed)
		print("The serial number of the image:       ", other_parameters.shot_order)
		print("The shutter speed:                    ", other_parameters.shutter_speed)
		print("The date of shooting:                 ", System.DateTime.from_file_time(other_parameters.timestamp))

	# Экспорт в PNG с настройками по умолчанию.
	dng_image.save(join(dir_, "test.png"), PngOptions())

# Производитель камеры:              Leica
# Модель камеры:                     M8 Digital Camera
# Количество цветов:                     3
# Описание цветов:               RGBG
# Версия DNG:                      16777216
# Количество RAW‑изображений в файле: 1
# Программное обеспечение:                         1.107
# Порядок цветовых пикселей:        0b10110100101101001011010010110100
# Диафрагма:                         0
# Описание:                      
# Фокусное расстояние:                     50
# Чувствительность ISO:                  160
# Серийный номер изображения:       0
# Скорость затвора:                    12
# Дата съёмки:                 8/3/2007 3:13:49 AM