Класс JpegImage

Summary: Efficiently manipulate JPEG raster images with our API, offering support
for various color profiles such as RGB and CMYK, customizable bits per pixel
resolution, and processing of EXIF, JFIF, and XMP metadata containers.
Enjoy automated rotation based on orientation data and choose from different
compression levels, including lossless JPEG, to achieve optimal image quality
and file size balance for your projects.

Module: aspose.imaging.fileformats.jpeg

Full Name: aspose.imaging.fileformats.jpeg.JpegImage

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

Constructors

NameDescription
JpegImage(jpeg_options, width, height)Инициализируйте новый объект JpegImage с предоставленными параметрами JPEG.
Этот конструктор позволяет настроить различные параметры JPEG‑изображения, такие
как уровень сжатия, качество и дополнительные параметры, обеспечивая точный контроль
над получаемым форматом изображения.
JpegImage(path)Класс JpegImage инициализируется без усилий при вызове его
конструктора с указанным параметром пути. Этот конструктор обеспечивает бесшовное
создание JPEG‑изображений, гарантируя быструю интеграцию в ваши проекты с легкостью.
JpegImage(raster_image)Инициализируйте новый экземпляр класса JpegImage с параметром растрового изображения
. Этот конструктор предоставляет удобный способ создания JPEG‑изображений
непосредственно из растровых изображений, упрощая рабочий процесс работы с JPEG‑изображениями
в ваших приложениях.
JpegImage(stream)Инициализируйте объект JPEG‑изображения с помощью класса JpegImage используя параметр
потока. Этот конструктор упрощает процесс работы с JPEG‑изображениями, предлагая простой подход для их интеграции в ваши проекты
без усилий.
JpegImage(width, height)Создайте новый экземпляр класса JpegImage с указанными параметрами ширины
и высоты. Этот конструктор позволяет создавать JPEG‑изображения с
пользовательскими размерами, предоставляя гибкость в управлении размерами изображений в вашем приложении.

Properties

NameTypeAccessDescription
auto_adjust_paletteboolr/wПолучает или задает значение, указывающее, следует ли автоматически корректировать палитру.
background_colorColorr/wПолучает или задает значение цвета фона.
bits_per_pixelintrПолучайте глубину цвета изображения без усилий с помощью этого свойства, предоставляя
сведения о насыщенности цветового или градационного представления. Будь то
яркая фотография или монохромная иллюстрация, это свойство предоставляет важную
информацию о визуальной сложности изображения.
boundsRectanglerПолучает границы объекта.
buffer_size_hintintr/wПолучает или задает подсказку о размере буфера, определяющую максимальный допустимый размер для всех внутренних буферов.
cmyk_color_profileStreamSourcer/wЦветовой профиль CMYK, связанный с JPEG‑изображениями CMYK и YCCK, обеспечивает точное
преобразование цветов и достоверность. Он работает совместно с RGBColorProfile, чтобы
гарантировать точное воспроизведение цветов на различных устройствах и в приложениях.
Такое сочетание критически важно для поддержания согласованности цветопередачи и
достижения оптимального качества изображения.
commentstringr/wУправляйте комментариями JPEG‑файлов с помощью этого свойства, позволяющего добавлять или получать
описательные аннотации, связанные с изображением. Будь то пометка изображений
метаданными или добавление дополнительного контекста, это свойство обеспечивает гибкость в
организации и классификации ваших JPEG‑файлов.
containerImagerПолучает контейнер Image.
data_stream_containerStreamContainerrПолучает поток данных объекта.
destination_cmyk_color_profileStreamSourcer/wЦветовой профиль CMYK имеет решающее значение для точного преобразования цветов JPEG‑изображений CMYK и YCCK
при сохранении. Он работает в паре с RGBColorProfile
чтобы обеспечить правильное воспроизведение цветов, поддерживая согласованность и качество на разных
устройствах и программном обеспечении. Эта синхронизация критически важна для достижения
точной и надёжной цветопередачи в окончательно сохранённых изображениях.
destination_rgb_color_profileStreamSourcer/wRGBColorProfile необходим для точного преобразования цветов JPEG‑изображений CMYK и YCCK
при сохранении. В сочетании с CMYKColorProfile он
гарантирует корректное отображение цветов и поддерживает согласованность на разных
устройствах и в приложениях. Такое сочетание критически важно для сохранения
задуманного цветового представления и получения изображений высокого качества.
disposedboolrПолучает значение, указывающее, удалён ли этот экземпляр.
exif_dataJpegExifDatar/wУправляйте данными EXIF с помощью этого свойства, позволяющего добавлять или получать метаданные
, связанные с изображением. Будь то извлечение информации о настройках камеры
или изменение существующих метаданных, это свойство обеспечивает гибкость в
управлении контейнером данных EXIF.
file_formatFileFormatrПолучайте формат изображения без усилий с помощью этого свойства. Оно предоставляет
ценную информацию о файловом формате, способствуя бесшовной интеграции и
проверкам совместимости на различных платформах и в приложениях.
has_alphaboolrПолучает значение, указывающее, имеет ли этот экземпляр альфа-канал.
has_background_colorboolr/wПолучает или задает значение, указывающее, имеет ли изображение фоновый цвет.
has_transparent_colorboolr/wПолучает или задаёт значение, указывающее, имеет ли этот экземпляр RasterImage прозрачный цвет.
heightintrПолучайте высоту изображения без усилий с помощью этого свойства. Оно обеспечивает быстрый
доступ к вертикальному измерению изображения, позволяя эффективно
определить его размер и соотношение сторон без необходимости в сложных вычислениях или
дополнительных методах.
horizontal_resolutionfloatr/wЭто свойство предоставляет вам доступ к горизонтальному разрешению
RasterImage, измеряемому в пикселях на дюйм. Устанавливая или получая
это значение, вы можете точно контролировать разрешение изображения, гарантируя, что оно
соответствует вашим конкретным требованиям к качеству и чёткости.
ignore_embedded_color_profileboolr/wПолучает или изменяет флаг, указывающий, игнорируется ли встроенный цветовой профиль
. Устанавливая этот флаг, пользователи могут указать, следует ли использовать профиль цвета по умолчанию вместо встроенного. Эта опция обеспечивает более высокий
контроль над управлением цветом, облегчая настройку для согласованности и
совместимости на различных платформах и в приложениях.
image_opacityfloatrПолучает непрозрачность этого изображения.
interrupt_monitorInterruptMonitorr/wПолучает или задает монитор прерываний.
is_cachedboolrПолучает значение, указывающее, кэшируются ли данные изображения в данный момент.
is_raw_data_availableboolrПолучает значение, указывающее, поддерживается ли загрузка необработанных данных.
jfifJFIFDatar/wЭто свойство позволяет вам получить доступ к данным JFIF (JPEG File Interchange
Format), связанным с JPEG‑изображением, или изменить их. JFIF — это стандартный формат для
обмена JPEG‑сжатыми изображениями между компьютерами и другими устройствами. Получая
или устанавливая это свойство, вы можете работать с данными JFIF, которые могут включать
информацию, такую как разрешение изображения, соотношение сторон и миниатюру.
jpeg_optionsJpegOptionsrЛегко получите доступ к параметрам JPEG, используемым при создании или загрузке этого
JpegImage экземпляра. Это свойство предоставляет ценные детали
о конкретных применённых настройках, позволяя пользователям понять и воспроизвести
процессы обработки изображений эффективно. Будь то уровни сжатия, настройки качества
или другие параметры, это свойство предоставляет необходимую информацию для
беспроблемного манипулирования изображениями.
metadataImageMetadatarПолучает метаданные изображения.
paletteIColorPaletter/wПолучает или задает цветовую палитру. Цветовая палитра не используется, когда пиксели представлены напрямую.
premultiply_componentsboolr/wПолучает или задает значение, указывающее, должны ли компоненты изображения быть предварительно умножены.
raw_custom_color_converterIColorConverterr/wПолучает или задает пользовательский конвертер цветов
raw_data_formatPixelDataFormatrЭто свойство получает формат необработанных данных изображения, который указывает, как
данные изображения структурированы и закодированы. Понимание формата необработанных данных
необходимо для эффективной обработки или манипулирования данными изображения. Оно предоставляет
сведения о внутреннем представлении изображения, например, сжато ли оно, закодировано в определённом цветовом пространстве или сохранено в конкретном файловом
формате. Доступ к этому свойству позволяет получить ценную информацию о
структуре данных изображения, позволяя выполнять различные операции или оптимизации
, адаптированные к его конкретному формату.
raw_data_settingsRawDataSettingsrПолучает текущие настройки необработанных данных. Обратите внимание, что при использовании этих настроек данные загружаются без конвертации.
raw_fallback_indexintr/wПолучает или задает резервный индекс, используемый, когда индекс палитры выходит за пределы.
raw_indexed_color_converterIIndexedColorConverterr/wПолучает или задает индексированный конвертер цветов
raw_line_sizeintrПолучает размер необработанной строки в байтах.
rgb_color_profileStreamSourcer/wRGB‑цветовой профиль для JPEG‑изображений CMYK и YCCK обеспечивает точное преобразование и представление цветов
. Он должен использоваться вместе с CMYKColorProfile для
поддержания согласованности и точности цветовой визуализации. Такое сочетание необходимо для
приложений, требующих точного управления цветом и воспроизведения изображений,
гарантируя правильную интерпретацию и отображение RGB‑данных.
sizeSizerПолучает размер объекта.
transparent_colorColorr/wПолучает прозрачный цвет изображения.
update_xmp_databoolr/wПолучает или задает значение, указывающее, следует ли обновлять метаданные XMP.
use_paletteboolrПолучает значение, указывающее, используется ли палитра изображения.
use_raw_databoolr/wПолучает или задает значение, указывающее, следует ли использовать загрузку необработанных данных, когда такая загрузка доступна.
vertical_resolutionfloatr/wЭто свойство управляет вертикальным разрешением, выраженным в пикселях на дюйм, для
связанного RasterImage. Регулировка этого разрешения влияет на
размер и качество изображения при печати или отображении в фиксированном физическом размере.
Устанавливая это свойство, вы контролируете плотность вертикального размещения пикселей изображения,
что сказывается на общей чёткости и ясности.
widthintrЭто свойство получает ширину изображения, выраженную в пикселях. Оно предоставляет
важную информацию о размерах изображения, позволяя точно отображать,
манипулировать или показывать данные изображения.
xmp_dataXmpPacketWrapperr/wПолучает или задает данные Xmp.

Methods

NameDescription
adjust_brightness(brightness)Регулировка яркости изображения.
adjust_contrast(contrast)Контрастирование изображения
adjust_gamma(gamma)Гамма‑коррекция изображения.
adjust_gamma(gamma_red, gamma_green, gamma_blue)Гамма‑коррекция изображения.
analyze_percentage_digital_signature(password)Вычисляет процентное сходство между извлечёнными данными и оригинальным паролем.
auto_brightness_contrast()Выполняет автоматическую адаптивную нормализацию яркости и контраста для всего изображения.
auto_rotate()Автоматически вращает изображение на основе данных ориентации, извлечённых из Exif
метаданных. Этот метод гарантирует, что изображения отображаются в правильной ориентации,
улучшая пользовательский опыт и устраняя необходимость ручных корректировок. Путём
анализа информации Exif изображение вращается соответствующим образом, обеспечивая бесшовный
просмотр на разных платформах и устройствах. Этот автоматизированный процесс вращения
упрощает работу с изображениями и повышает общую удобность, особенно при
работе с большими партиями изображений с различными ориентациями.
binarize_bradley(brightness_difference)Бинаризация изображения с использованием адаптивного порогового алгоритма Брэдли, основанного на интегральном порогировании изображения
binarize_bradley(brightness_difference, window_size)Бинаризация изображения с использованием адаптивного порогового алгоритма Брэдли, основанного на интегральном порогировании изображения
binarize_fixed(threshold)Бинаризация изображения с предопределённым порогом
binarize_otsu()Бинаризация изображения с порогом Оцу
blend(origin, overlay, overlay_alpha)Смешивает этот экземпляр изображения с изображением overlay.
blend(origin, overlay, overlay_area, overlay_alpha)Смешивает этот экземпляр изображения с изображением overlay.
cache_data()Кеширует данные и гарантирует, что из базового DataStreamSupporter.data_stream_container не будет выполнена дополнительная загрузка данных.
can_load(file_path)Определяет, можно ли загрузить изображение из указанного пути к файлу.
can_load(file_path, load_options)Определяет, можно ли загрузить изображение из указанного пути к файлу и, при желании, используя указанные параметры открытия.
can_load(stream)Определяет, можно ли загрузить изображение из указанного потока.
can_load(stream, load_options)Определяет, можно ли загрузить изображение из указанного потока и, при желании, используя указанные loadOptions.
can_load_stream(stream)Определяет, можно ли загрузить изображение из указанного потока.
can_load_stream_with_options(stream, load_options)Определяет, можно ли загрузить изображение из указанного потока и, при желании, используя указанные loadOptions.
can_load_with_options(file_path, load_options)Определяет, можно ли загрузить изображение из указанного пути к файлу и, при желании, используя указанные параметры открытия.
can_save(options)Определяет, можно ли сохранить изображение в указанный формат файла, представленный переданными параметрами сохранения.
create(files)Создаёт многостраничное изображение, содержащее указанные файлы.
create(files, throw_exception_on_load_error)Создаёт многостраничное изображение, содержащее указанные файлы.
create(image_options, width, height)Создаёт новое изображение с использованием указанных параметров создания.
create(image_options, width, height, pixels)Создаёт экземпляр RasterImage из предоставленного массива пикселей.

Проверяет, что указанные ширина и высота соответствуют размерам пиксельных данных.
Этот метод может использоваться только в лицензированном режиме библиотеки.
create(images)Создаёт новое изображение, используя указанные изображения в качестве страниц
create(images, dispose_images)Создает новое изображение из указанных изображений в виде страниц.
create(multipage_create_options)Создает указанные параметры создания многостраничного изображения.
create_from_files(files)Создает многостраничное изображение, содержащее указанные файлы в виде страниц с отложенной загрузкой.
create_from_files(files, throw_exception_on_load_error)Создает многостраничное изображение, содержащее указанные файлы в виде страниц с отложенной загрузкой.
create_from_image(raster_image)Инициализирует новый экземпляр класса JpegImage.
create_from_images(images)Создаёт новое изображение, используя указанные изображения в качестве страниц
create_from_images(images, dispose_images)Создает новое изображение из указанных изображений в виде страниц.
create_from_stream(stream)Инициализирует новый экземпляр класса JpegImage.
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()Получает исходные параметры изображения данного экземпляра Image.
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 и IHasExifData.exif_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: JpegImage(jpeg_options, width, height)

 JpegImage(jpeg_options, width, height) 

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

Parameters:

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

Constructor: JpegImage(path)

 JpegImage(path) 

Класс JpegImage инициализируется без усилий при вызове его
конструктора с указанным параметром пути. Этот конструктор обеспечивает бесшовное
создание JPEG‑изображений, гарантируя быструю интеграцию в ваши проекты с легкостью.

Parameters:

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

See also:

Example # 1: The example shows how to load a JpegImage from a file.

Constructor: JpegImage(raster_image)

 JpegImage(raster_image) 

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

Parameters:

ПараметрТипОписание
raster_imageRasterImageИзображение, с которым инициализируются данные пикселей и палитры.

See also:

Example # 1: The example shows how to load a JpegImage from another RasterImage.

Constructor: JpegImage(stream)

 JpegImage(stream) 

Инициализируйте объект JPEG‑изображения с помощью класса JpegImage используя параметр
потока. Этот конструктор упрощает процесс работы с JPEG‑изображениями, предлагая простой подход для их интеграции в ваши проекты
без усилий.

Parameters:

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

Constructor: JpegImage(width, height)

 JpegImage(width, height) 

Создайте новый экземпляр класса JpegImage с указанными параметрами ширины
и высоты. Этот конструктор позволяет создавать JPEG‑изображения с
пользовательскими размерами, предоставляя гибкость в управлении размерами изображений в вашем приложении.

Parameters:

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

See also:

Example # 1: The following example shows how to create JPEG image of the specified size.

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

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_differencefloatРазница яркости между пикселем и средним значением окна s × s пикселей, центрированного вокруг этого пикселя.

Method: binarize_bradley(brightness_difference, window_size)

 binarize_bradley(brightness_difference, window_size) 

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

Parameters:

ПараметрТипОписание
brightness_differencefloatРазница яркости между пикселем и средним значением окна s × s пикселей, центрированного вокруг этого пикселя.
window_sizeintРазмер окна 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:

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

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

 blend(origin, overlay, overlay_area, overlay_alpha) 

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

Parameters:

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

Method: can_load(file_path) [static]

 can_load(file_path) 

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

Parameters:

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

Returns

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

Method: can_load(file_path, load_options) [static]

 can_load(file_path, load_options) 

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

Parameters:

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

Returns

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

Method: can_load(stream) [static]

 can_load(stream) 

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

Parameters:

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

Returns

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

Method: can_load(stream, load_options) [static]

 can_load(stream, load_options) 

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

Parameters:

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

Returns

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

Method: can_load_stream(stream) [static]

 can_load_stream(stream) 

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

Parameters:

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

Returns

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

Method: can_load_stream_with_options(stream, load_options) [static]

 can_load_stream_with_options(stream, load_options) 

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

Parameters:

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

Returns

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

Method: can_load_with_options(file_path, load_options) [static]

 can_load_with_options(file_path, load_options) 

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

Parameters:

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

Returns

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

Method: can_save(options)

 can_save(options) 

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

Parameters:

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

Returns

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

Method: create(files) [static]

 create(files) 

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

Parameters:

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

Returns

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

Method: create(files, throw_exception_on_load_error) [static]

 create(files, throw_exception_on_load_error) 

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

Parameters:

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

Returns

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

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

 create(image_options, width, height) 

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

Parameters:

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

Returns

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

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

 create(image_options, width, height, pixels) 

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

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

Parameters:

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

Returns

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

Method: create(images) [static]

 create(images) 

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

Parameters:

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

Returns

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

Method: create(images, dispose_images) [static]

 create(images, dispose_images) 

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

Parameters:

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

Returns

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

Method: create(multipage_create_options) [static]

 create(multipage_create_options) 

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

Parameters:

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

Returns

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

Method: create_from_files(files) [static]

 create_from_files(files) 

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

Parameters:

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

Returns

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

Method: create_from_files(files, throw_exception_on_load_error) [static]

 create_from_files(files, throw_exception_on_load_error) 

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

Parameters:

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

Returns

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

Method: create_from_image(raster_image) [static]

 create_from_image(raster_image) 

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

Parameters:

ПараметрТипОписание
raster_imageRasterImageИзображение, с которым инициализируются данные пикселей и палитры.

Returns

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

Method: create_from_images(images) [static]

 create_from_images(images) 

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

Parameters:

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

Returns

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

Method: create_from_images(images, dispose_images) [static]

 create_from_images(images, dispose_images) 

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

Parameters:

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

Returns

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

Method: create_from_stream(stream) [static]

 create_from_stream(stream) 

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

Parameters:

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

Returns

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

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

 crop(left_shift, right_shift, top_shift, bottom_shift) 

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

Parameters:

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

Method: crop(rectangle)

 crop(rectangle) 

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

Parameters:

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

Method: dither(dithering_method, bits_count)

 dither(dithering_method, bits_count) 

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

Parameters:

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

Method: dither(dithering_method, bits_count, custom_palette)

 dither(dithering_method, bits_count, custom_palette) 

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

Parameters:

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

Method: embed_digital_signature(password)

 embed_digital_signature(password) 

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

Parameters:

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

Method: filter(rectangle, options)

 filter(rectangle, options) 

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

Parameters:

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

Method: get_argb_32_pixel(x, y)

 get_argb_32_pixel(x, y) 

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

Parameters:

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

Returns

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

Method: get_default_argb_32_pixels(rectangle)

 get_default_argb_32_pixels(rectangle) 

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

Parameters:

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

Returns

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

Method: get_default_options(args)

 get_default_options(args) 

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

Parameters:

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

Returns

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

Method: get_default_pixels(rectangle, partial_pixel_loader)

 get_default_pixels(rectangle, partial_pixel_loader) 

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

Parameters:

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

Method: get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings)

 get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings) 

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

Parameters:

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

Method: get_default_raw_data(rectangle, raw_data_settings)

 get_default_raw_data(rectangle, raw_data_settings) 

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

Parameters:

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

Returns

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

Method: get_file_format(file_path) [static]

 get_file_format(file_path) 

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

Parameters:

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

Returns

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

Method: get_file_format(stream) [static]

 get_file_format(stream) 

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

Parameters:

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

Returns

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

Method: get_file_format_of_stream(stream) [static]

 get_file_format_of_stream(stream) 

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

Parameters:

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

Returns

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

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

 get_fitting_rectangle(rectangle, pixels, width, height) 

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

Parameters:

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

Returns

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

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

 get_fitting_rectangle(rectangle, width, height) 

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

Parameters:

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

Returns

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

Method: get_modify_date(use_default)

 get_modify_date(use_default) 

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

Parameters:

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

Returns

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

Method: get_original_options()

 get_original_options() 

Получает исходные параметры изображения данного экземпляра Image.

Returns

ТипОписание
ImageOptionsBaseКлон исходных параметров изображения.

Method: get_pixel(x, y)

 get_pixel(x, y) 

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

Parameters:

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

Returns

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

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

 get_proportional_height(width, height, new_width) 

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

Parameters:

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

Returns

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

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

 get_proportional_width(width, height, new_height) 

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

Parameters:

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

Returns

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

Method: get_serialized_stream(image_options, clipping_rectangle, page_number)

 get_serialized_stream(image_options, clipping_rectangle, page_number) 

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

Parameters:

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

Returns

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

Method: get_skew_angle()

 get_skew_angle() 

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

Returns

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

Method: is_digital_signed(password, percentage_threshold)

 is_digital_signed(password, percentage_threshold) 

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

Parameters:

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

Returns

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

Method: load(file_path) [static]

 load(file_path) 

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

Parameters:

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

Returns

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

Method: load(file_path, load_options) [static]

 load(file_path, load_options) 

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

Parameters:

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

Returns

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

Method: load(stream) [static]

 load(stream) 

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

Parameters:

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

Returns

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

Method: load(stream, load_options) [static]

 load(stream, load_options) 

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

Parameters:

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

Returns

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

Method: load_argb_32_pixels(rectangle)

 load_argb_32_pixels(rectangle) 

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

Parameters:

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

Returns

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

Method: load_argb_64_pixels(rectangle)

 load_argb_64_pixels(rectangle) 

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

Parameters:

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

Returns

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

Method: load_cmyk_32_pixels(rectangle)

 load_cmyk_32_pixels(rectangle) 

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

Parameters:

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

Returns

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

Method: load_cmyk_pixels(rectangle)

 load_cmyk_pixels(rectangle) 

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

Parameters:

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

Returns

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

Method: load_partial_argb_32_pixels(rectangle, partial_pixel_loader)

 load_partial_argb_32_pixels(rectangle, partial_pixel_loader) 

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

Parameters:

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

Method: load_partial_argb_64_pixels(rectangle, partial_pixel_loader)

 load_partial_argb_64_pixels(rectangle, partial_pixel_loader) 

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

Parameters:

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

Method: load_partial_pixels(desired_rectangle, pixel_loader)

 load_partial_pixels(desired_rectangle, pixel_loader) 

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

Parameters:

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

Method: load_pixels(rectangle)

 load_pixels(rectangle) 

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

Parameters:

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

Returns

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

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

 load_raw_data(rectangle, dest_image_bounds, raw_data_settings, raw_data_loader) 

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

Parameters:

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

Method: load_raw_data(rectangle, raw_data_settings, raw_data_loader)

 load_raw_data(rectangle, raw_data_settings, raw_data_loader) 

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

Parameters:

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

Method: load_stream(stream) [static]

 load_stream(stream) 

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

Parameters:

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

Returns

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

Method: load_stream_with_options(stream, load_options) [static]

 load_stream_with_options(stream, load_options) 

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

Parameters:

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

Returns

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

Method: load_with_options(file_path, load_options) [static]

 load_with_options(file_path, load_options) 

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

Parameters:

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

Returns

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

Method: normalize_angle(resize_proportionally, background_color)

 normalize_angle(resize_proportionally, background_color) 

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

Parameters:

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

Method: read_argb_32_scan_line(scan_line_index)

 read_argb_32_scan_line(scan_line_index) 

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

Parameters:

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

Returns

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

Method: read_scan_line(scan_line_index)

 read_scan_line(scan_line_index) 

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

Parameters:

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

Returns

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

Method: replace_argb(old_color_argb, old_color_diff, new_color_argb)

 replace_argb(old_color_argb, old_color_diff, new_color_argb) 

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

Parameters:

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

Method: replace_color(old_color, old_color_diff, new_color)

 replace_color(old_color, old_color_diff, new_color) 

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

Parameters:

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

Method: replace_color(old_color_argb, old_color_diff, new_color_argb)

 replace_color(old_color_argb, old_color_diff, new_color_argb) 

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

Parameters:

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

Method: replace_non_transparent_colors(new_color)

 replace_non_transparent_colors(new_color) 

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

Parameters:

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

Method: replace_non_transparent_colors(new_color_argb)

 replace_non_transparent_colors(new_color_argb) 

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

Parameters:

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

Method: resize(new_width, new_height)

 resize(new_width, new_height) 

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

Parameters:

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

Method: resize(new_width, new_height, resize_type)

 resize(new_width, new_height, resize_type) 

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

Parameters:

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

Method: resize(new_width, new_height, settings)

 resize(new_width, new_height, settings) 

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

Parameters:

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

Method: resize_by_settings(new_width, new_height, settings)

 resize_by_settings(new_width, new_height, settings) 

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

Parameters:

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

Method: resize_by_type(new_width, new_height, resize_type)

 resize_by_type(new_width, new_height, resize_type) 

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

Parameters:

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

Method: resize_height_proportionally(new_height)

 resize_height_proportionally(new_height) 

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

Parameters:

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

Method: resize_height_proportionally(new_height, resize_type)

 resize_height_proportionally(new_height, resize_type) 

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

Parameters:

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

Method: resize_height_proportionally(new_height, settings)

 resize_height_proportionally(new_height, settings) 

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

Parameters:

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

Method: resize_height_proportionally_settings(new_height, settings)

 resize_height_proportionally_settings(new_height, settings) 

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

Parameters:

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

Method: resize_width_proportionally(new_width)

 resize_width_proportionally(new_width) 

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

Parameters:

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

Method: resize_width_proportionally(new_width, resize_type)

 resize_width_proportionally(new_width, resize_type) 

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

Parameters:

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

Method: resize_width_proportionally(new_width, settings)

 resize_width_proportionally(new_width, settings) 

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

Parameters:

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

Method: resize_width_proportionally_settings(new_width, settings)

 resize_width_proportionally_settings(new_width, settings) 

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

Parameters:

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

Method: rotate(angle)

 rotate(angle) 

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

Parameters:

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

Method: rotate(angle, resize_proportionally, background_color)

 rotate(angle, resize_proportionally, background_color) 

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

Parameters:

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

Method: rotate_flip(rotate_flip_type)

 rotate_flip(rotate_flip_type) 

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

Parameters:

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

Method: save(file_path)

 save(file_path) 

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

Parameters:

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

Method: save(file_path, options)

 save(file_path, options) 

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

Parameters:

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

Method: save(file_path, options, bounds_rectangle)

 save(file_path, options, bounds_rectangle) 

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

Parameters:

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

Method: save(file_path, over_write)

 save(file_path, over_write) 

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

Parameters:

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

Method: save(stream)

 save(stream) 

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

Parameters:

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

Method: save(stream, options_base)

 save(stream, options_base) 

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

Parameters:

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

Method: save(stream, options_base, bounds_rectangle)

 save(stream, options_base, bounds_rectangle) 

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

Parameters:

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

Method: save_argb_32_pixels(rectangle, pixels)

 save_argb_32_pixels(rectangle, pixels) 

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

Parameters:

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

Method: save_cmyk_32_pixels(rectangle, pixels)

 save_cmyk_32_pixels(rectangle, pixels) 

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

Parameters:

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

Method: save_cmyk_pixels(rectangle, pixels)

 save_cmyk_pixels(rectangle, pixels) 

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

Parameters:

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

Method: save_pixels(rectangle, pixels)

 save_pixels(rectangle, pixels) 

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

Parameters:

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

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

 save_raw_data(data, data_offset, rectangle, raw_data_settings) 

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

Parameters:

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

Method: save_to_stream(stream)

 save_to_stream(stream) 

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

Parameters:

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

Method: save_to_stream_with_options(stream, options_base)

 save_to_stream_with_options(stream, options_base) 

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

Parameters:

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

Method: save_to_stream_with_options_rect(stream, options_base, bounds_rectangle)

 save_to_stream_with_options_rect(stream, options_base, bounds_rectangle) 

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

Parameters:

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

Method: save_with_options(file_path, options)

 save_with_options(file_path, options) 

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

Parameters:

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

Method: save_with_options_rect(file_path, options, bounds_rectangle)

 save_with_options_rect(file_path, options, bounds_rectangle) 

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

Parameters:

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

Method: set_argb_32_pixel(x, y, argb_32_color)

 set_argb_32_pixel(x, y, argb_32_color) 

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

Parameters:

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

Method: set_palette(palette, update_colors)

 set_palette(palette, update_colors) 

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

Parameters:

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

Method: set_pixel(x, y, color)

 set_pixel(x, y, color) 

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

Parameters:

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

Method: set_resolution(dpi_x, dpi_y)

 set_resolution(dpi_x, dpi_y) 

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

Parameters:

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

Method: try_set_metadata(metadata)

 try_set_metadata(metadata) 

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

Parameters:

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

Returns

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

Method: write_argb_32_scan_line(scan_line_index, argb_32_pixels)

 write_argb_32_scan_line(scan_line_index, argb_32_pixels) 

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

Parameters:

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

Method: write_scan_line(scan_line_index, pixels)

 write_scan_line(scan_line_index, pixels) 

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

Parameters:

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

Examples

The example shows how to load a JpegImage from a file.


from aspose.imaging.fileformats.jpeg import JpegImage

# Загрузить JPEG‑изображение из файла.
with JpegImage("sample.jpg") as jpegImage:
	# Выполнить обработку изображения.
	# Сохранить в другой файл JPEG.
	jpegImage.save("sample.output.jpg")

The example shows how to load a JpegImage from another RasterImage.


import aspose.pycore as aspycore
from aspose.imaging import Image, Graphics, Color, RasterImage
from aspose.imaging.brushes import SolidBrush
from aspose.imaging.imageoptions import PngOptions
from aspose.imaging.fileformats.jpeg import JpegImage
from os.path import join as path_join


dir_ = "c:\\temp"
# Загрузить изображение JPEG из другого растрового изображения.
# Сначала создайте временное изображение PNG, которое будет основой для создания изображения JPEG.
# Вы также можете загрузить изображение PNG из файла или использовать изображение любого другого растрового формата.
with PngOptions() as create_options:
	with aspycore.as_of(Image.create(create_options, 100, 100), RasterImage) as raster_image:
		# Заполните всё изображение PNG красным цветом.
		graphics = Graphics(raster_image)
		brush = SolidBrush(Color.red)
		graphics.fill_rectangle(brush, raster_image.bounds)
		# Создайте изображение JPEG на основе изображения PNG.
		with JpegImage(raster_image) as jpeg_image:
			# Сохранить в файл JPEG
			jpeg_image.save(path_join(dir_, "output.jpg"))

The following example shows how to create JPEG image of the specified size.


from aspose.imaging.fileformats.jpeg import JpegImage

# Создайте изображение JPEG размером 100×100 пикселей.
with JpegImage(100, 100) as jpegImage:
	# Выполнить обработку изображения.
	# Сохранить в файл.
	jpegImage.save("output.jpg")

Access camera manufacturer maker notes in Jpeg image.


from aspose.pycore import as_of
from aspose.imaging import Image
from aspose.imaging.fileformats.jpeg import JpegImage

with as_of(Image.load("Sample.jpg"), JpegImage) as image:
	for makerNote in image.exif_data.maker_notes:
		print(f"Name = {makerNote.name}, Value = {makerNote.value}")