Класс TiffImage

Summary: Process Tagged Image File Format (TIFF) raster images with our API, offering
comprehensive support for various resolutions and advanced editing capabilities
like EXIF data manipulation and alpha channels. Normalize angles for scanned images,
resize, transform to grayscale, and apply filters, gamma corrections and image
parameters adjustments with ease. Seamlessly handle multi-frame TIFF files,
create graphics paths, add shapes, and effortlessly save images to different formats.

Module: aspose.imaging.fileformats.tiff

Full Name: aspose.imaging.fileformats.tiff.TiffImage

Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, IRasterImageArgb32PixelLoader, IRasterImageRawDataLoader, IMultipageImage, IMultipageImageExt, RasterCachedMultipageImage

Constructors

NameDescription
TiffImage(frame)Инициализирует новый объект класса TiffImage, указывая параметр
frame. Этот конструктор облегчает создание экземпляра TiffImage
, позволяя разработчикам указывать кадр, который будет загружен или обработан,
упрощая задачи обработки Tiff‑изображений в их приложениях.
TiffImage(frames)Создает новый экземпляр класса TiffImage, предоставляя список
frames в качестве параметра. Этот конструктор позволяет инициализировать объект TiffImage
с несколькими кадрами, облегчая эффективную обработку и работу с последовательностями TIFF‑изображений в программных приложениях.

Properties

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

Methods

NameDescription
add(image)Добавьте кадры из указанного изображения бесшовно в текущий кадр,
объединяя их содержимое и повышая гибкость композиции. Интегрируйте
этот метод для упрощения управления кадрами и их манипуляции в вашем
приложении, обеспечивая эффективную работу с многокадровыми изображениями.
add_frame(frame)Внедрите указанный кадр бесшовно в изображение, расширяя его содержимое
и универсальность. Используйте этот метод для улучшения композиции и управления изображением,
обеспечивая эффективную работу с многокадровыми изображениями в вашем приложении.
add_frames(frames)Интегрируйте массив кадров бесшовно в изображение, обогащая его содержимое и
универсальность. Используйте этот метод для улучшения композиции и управления изображением,
позволяя эффективно работать с многокадровыми изображениями в вашем приложении.
add_page(page)Бесшовно добавляет новую страницу в существующее изображение, расширяя его содержимое
и возможности. Используйте этот метод для улучшения составления и
управления документами, обеспечивая эффективную работу с многостраничными изображениями в вашем приложении.
adjust_brightness(brightness)Реализуйте регулировку яркости изображения, позволяя
изменять общий уровень освещённости. Внедрите этот метод в ваш процесс обработки изображений
для повышения видимости и улучшения визуального качества
изображений в вашем приложении.
adjust_contrast(contrast)Улучшите контраст Image экземпляра,
усиливая различия между светлыми и тёмными областями. Интегрируйте эту
функцию для повышения визуальной чёткости и общего качества изображения
в вашем приложении.
adjust_gamma(gamma)Примените гамма‑коррекцию к изображению, регулируя интенсивность пикселей для достижения
желаемого цветового баланса. Включите этот метод в ваш процесс обработки изображений
чтобы улучшить визуальное качество и повысить точность последующего
анализа или отображения в вашем приложении.
adjust_gamma(gamma_red, gamma_green, gamma_blue)Выполните гамма‑коррекцию изображения, используя отдельные коэффициенты для красного,
зелёного и синего каналов, что позволяет точно настраивать цветовой баланс
и контраст. Интегрируйте этот метод в ваш конвейер обработки изображений, чтобы
получить точный контроль над отображением цветов и повысить визуальную достоверность в
вашем приложении.
align_resolutions()Реализуйте вспомогательный метод AlignResolutions для синхронизации горизонтального и
вертикального разрешения, обеспечивая единообразие размеров изображения. Эта функция
упрощает рабочие процессы обработки изображений, согласовывая параметры разрешения,
оптимизируя визуальное качество и согласованность на разных платформах и
устройствах.
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()Кеширует данные приватно.
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)Создает новое изображение из указанных изображений в виде страниц.
create_with_frame(frame)Инициализирует новый экземпляр класса TiffImage.
create_with_frames(frames)Инициализирует новый экземпляр класса TiffImage.
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()Преобразуйте изображение в его градации серого, превратив его в
одноканальное изображение, где каждый пиксель представляет интенсивность. Интегрируйте этот метод
в ваш конвейер обработки изображений, чтобы упростить анализ и повысить
совместимость с алгоритмами, основанными на градациях серого, облегчая различные задачи компьютерного
зрения и анализа изображений в вашем приложении.
insert_frame(index, frame)Вставьте новый кадр в указанную позицию внутри последовательности кадров, обеспечивая
точный контроль над расположением кадров. Используйте этот метод для эффективного управления последовательностями кадров, облегчая динамическую манипуляцию и организацию содержимого изображения в вашем приложении.
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)Используйте метод NormalizeAngle, специально разработанный для сканированных текстовых документов
для исправления наклонённых сканов, обеспечивая точное выравнивание. Бесшовно
интегрируйте эту функцию в ваши рабочие процессы обработки текста, чтобы улучшить
читаемость и качество документов, повышая общую эффективность распознавания текста
и задач анализа.
Этот метод использует функции RasterImage.get_skew_angle() и TiffImage.rotate(angle, resize_proportionally, background_color).
normalize_histogram()Нормализует гистограмму изображения — корректирует значения пикселей, чтобы использовать весь доступный диапазон.
read_argb_32_scan_line(scan_line_index)Считывает всю строку сканирования по указанному индексу строки сканирования.
read_scan_line(scan_line_index)Считывает всю строку сканирования по указанному индексу строки сканирования.
remove_frame(frame)Эффективно удалите указанный кадр из последовательности изображений, облегчая
упрощённое управление кадрами в вашем приложении. Интегрируйте эту функцию
для повышения точности и гибкости манипуляций кадрами, обеспечивая бесшовную
организацию и представление содержимого изображения.
remove_frame(index)Удаляет кадр по его индексу.
remove_frame_by_index(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_frame(index, new_frame)Замените кадр в указанной позиции другим кадром без швов,
облегчая динамическое управление кадрами в последовательности изображений. Интегрируйте этот
метод для повышения гибкости и точности манипуляций кадрами, обеспечивая
оптимальную организацию и представление содержимого изображения в вашем приложении.
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)Выполните пропорциональное изменение размера изображения, сохраняя его соотношение сторон
при корректировке размеров. Используйте этот метод для динамического масштабирования изображений
в вашем приложении, обеспечивая согласованное визуальное представление целостности содержимого
.
Пропорциональное изменение размера будет масштабировать каждый кадр согласно соотношению newWidth/width и newHeight/height.
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_proportional(new_width, new_height, resize_type)Выполните пропорциональное изменение размера изображения, сохраняя его соотношение сторон
при корректировке размеров. Используйте этот метод для динамического масштабирования изображений
в вашем приложении, обеспечивая согласованное визуальное представление целостности содержимого
.
Пропорциональное изменение размера будет масштабировать каждый кадр согласно соотношению newWidth/width и newHeight/height.
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)Выполняйте вращение, отражение или их комбинацию исключительно для
активного кадра. Этот метод позволяет точно манипулировать отдельными кадрами в
последовательности изображений, повышая гибкость редактирования и композиции изображений в
вашем приложении.
rotate_flip_all(rotate_flip)Выполняет вращение и отражение всех.
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: TiffImage(frame)

 TiffImage(frame) 

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

Parameters:

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

Constructor: TiffImage(frames)

 TiffImage(frames) 

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

Parameters:

ПараметрТипОписание
framesTiffFrame[]Кадры.

Property: has_alpha

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

See also:

Example # 1: The following example loads a TIFF image and prints information about raw dat…

Method: add(image)

 add(image) 

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

Parameters:

ПараметрТипОписание
imageTiffImageИсходное изображение.

Method: add_frame(frame)

 add_frame(frame) 

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

Parameters:

ПараметрТипОписание
frameTiffFrameКадр для добавления.

Method: add_frames(frames)

 add_frames(frames) 

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

Parameters:

ПараметрТипОписание
framesTiffFrame[]Массив кадров для добавления

Method: add_page(page)

 add_page(page) 

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

Parameters:

ПараметрТипОписание
pageRasterImageСтраница для добавления.

Method: adjust_brightness(brightness)

 adjust_brightness(brightness) 

Реализуйте регулировку яркости изображения, позволяя
изменять общий уровень освещённости. Внедрите этот метод в ваш процесс обработки изображений
для повышения видимости и улучшения визуального качества
изображений в вашем приложении.

Parameters:

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

See also:

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

Method: adjust_contrast(contrast)

 adjust_contrast(contrast) 

Улучшите контраст Image экземпляра,
усиливая различия между светлыми и тёмными областями. Интегрируйте эту
функцию для повышения визуальной чёткости и общего качества изображения
в вашем приложении.

Parameters:

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

See also:

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

Method: adjust_gamma(gamma)

 adjust_gamma(gamma) 

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

Parameters:

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

See also:

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

Method: adjust_gamma(gamma_red, gamma_green, gamma_blue)

 adjust_gamma(gamma_red, gamma_green, gamma_blue) 

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

Parameters:

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

See also:

Example # 1: The following example performs gamma-correction of a TIFF image applying diff…

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 пикселей, центрированного вокруг этого пикселя

See also:

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

Method: binarize_fixed(threshold)

 binarize_fixed(threshold) 

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

Parameters:

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

See also:

Example # 1: The following example binarizes a TIFF image with the predefined threshold. B…

Method: blend(origin, overlay, overlay_alpha)

 blend(origin, overlay, overlay_alpha) 

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

Parameters:

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

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

 blend(origin, overlay, overlay_area, overlay_alpha) 

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

Parameters:

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

Method: can_load(file_path) [static]

 can_load(file_path) 

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

Parameters:

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

Returns

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

Method: can_load(file_path, load_options) [static]

 can_load(file_path, load_options) 

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

Parameters:

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

Returns

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

Method: can_load(stream) [static]

 can_load(stream) 

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

Parameters:

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

Returns

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

Method: can_load(stream, load_options) [static]

 can_load(stream, load_options) 

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

Parameters:

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

Returns

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

Method: can_load_stream(stream) [static]

 can_load_stream(stream) 

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

Parameters:

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

Returns

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

Method: can_load_stream_with_options(stream, load_options) [static]

 can_load_stream_with_options(stream, load_options) 

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

Parameters:

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

Returns

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

Method: can_load_with_options(file_path, load_options) [static]

 can_load_with_options(file_path, load_options) 

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

Parameters:

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

Returns

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

Method: can_save(options)

 can_save(options) 

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

Parameters:

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

Returns

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

Method: create(files) [static]

 create(files) 

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

Parameters:

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

Returns

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

Method: create(files, throw_exception_on_load_error) [static]

 create(files, throw_exception_on_load_error) 

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

Parameters:

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

Returns

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

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

 create(image_options, width, height) 

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

Parameters:

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

Returns

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

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

 create(image_options, width, height, pixels) 

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

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

Parameters:

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

Returns

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

Method: create(images) [static]

 create(images) 

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

Parameters:

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

Returns

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

Method: create(images, dispose_images) [static]

 create(images, dispose_images) 

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

Parameters:

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

Returns

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

Method: create(multipage_create_options) [static]

 create(multipage_create_options) 

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

Parameters:

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

Returns

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

Method: create_from_files(files) [static]

 create_from_files(files) 

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

Parameters:

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

Returns

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

Method: create_from_files(files, throw_exception_on_load_error) [static]

 create_from_files(files, throw_exception_on_load_error) 

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

Parameters:

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

Returns

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

Method: create_from_images(images) [static]

 create_from_images(images) 

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

Parameters:

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

Returns

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

Method: create_from_images(images, dispose_images) [static]

 create_from_images(images, dispose_images) 

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

Parameters:

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

Returns

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

Method: create_with_frame(frame) [static]

 create_with_frame(frame) 

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

Parameters:

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

Returns

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

Method: create_with_frames(frames) [static]

 create_with_frames(frames) 

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

Parameters:

ПараметрТипОписание
framesTiffFrame[]Кадры.

Returns

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

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Сдвиг вниз.

See also:

Example # 1: The following example crops a TIFF image. The cropping area is specified via …

Method: crop(rectangle)

 crop(rectangle) 

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

Parameters:

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

See also:

Example # 1: The following example crops a TIFF image. The cropping area is be specified v…

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() 

Получите параметры, полученные из настроек оригинального файла, обеспечивая бесшовное
сохранение ключевых параметров, таких как глубина цвета и другие важные атрибуты
оригинального изображения. Используйте этот метод для поддержания точности и согласованности в
задачах обработки изображений, гарантируя оптимальные результаты без лишних изменений.
Например, если мы загружаем чёрно‑белое PNG‑изображение с 1 битом на пиксель и затем сохраняем его с помощью метода
DataStreamSupporter.save(file_path), будет получено PNG‑изображение с 8‑битным цветом на пиксель.
Чтобы избежать этого и сохранить PNG‑изображение с 1‑битом на пиксель, используйте этот метод для получения соответствующих параметров сохранения и передайте их
в метод Image.save(file_path, options) в качестве второго параметра.

Returns

ТипОписание
ImageOptionsBaseПараметры, основанные на настройках исходного файла.

Method: get_pixel(x, y)

 get_pixel(x, y) 

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

Parameters:

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

Returns

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

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

 get_proportional_height(width, height, new_width) 

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

Parameters:

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

Returns

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

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

 get_proportional_width(width, height, new_height) 

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

Parameters:

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

Returns

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

Method: get_serialized_stream(image_options, clipping_rectangle, page_number)

 get_serialized_stream(image_options, clipping_rectangle, page_number) 

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

Parameters:

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

Returns

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

Method: get_skew_angle()

 get_skew_angle() 

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

Returns

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

Method: insert_frame(index, frame)

 insert_frame(index, frame) 

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

Parameters:

ПараметрТипОписание
indexintИндекс frame.
frameTiffFrameКадр для вставки.

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) 

Используйте метод NormalizeAngle, специально разработанный для сканированных текстовых документов
для исправления наклонённых сканов, обеспечивая точное выравнивание. Бесшовно
интегрируйте эту функцию в ваши рабочие процессы обработки текста, чтобы улучшить
читаемость и качество документов, повышая общую эффективность распознавания текста
и задач анализа.
Этот метод использует функции RasterImage.get_skew_angle() и TiffImage.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: remove_frame(frame)

 remove_frame(frame) 

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

Parameters:

ПараметрТипОписание
frameTiffFrameКадр для удаления.

Method: remove_frame(index)

 remove_frame(index) 

Удаляет кадр по его индексу.

Parameters:

ПараметрТипОписание
indexintИндекс кадра, который будет удалён.

Returns

ТипОписание
TiffFrameУдалённый кадр.

Method: remove_frame_by_index(index)

 remove_frame_by_index(index) 

Удаляет кадр по его индексу.

Parameters:

ПараметрТипОписание
indexintИндекс кадра, который будет удалён.

Returns

ТипОписание
TiffFrameУдалённый кадр.

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_frame(index, new_frame)

 replace_frame(index, new_frame) 

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

Parameters:

ПараметрТипОписание
indexintПозиция кадра, начиная с нуля.
new_frameTiffFrameКадр, заменяющий тот, который находится по указанному index.

Returns

ТипОписание
TiffFrameУдалённый кадр.

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) 

Выполните пропорциональное изменение размера изображения, сохраняя его соотношение сторон
при корректировке размеров. Используйте этот метод для динамического масштабирования изображений
в вашем приложении, обеспечивая согласованное визуальное представление целостности содержимого
.
Пропорциональное изменение размера будет масштабировать каждый кадр согласно соотношению newWidth/width и newHeight/height.

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_proportional(new_width, new_height, resize_type)

 resize_proportional(new_width, new_height, resize_type) 

Выполните пропорциональное изменение размера изображения, сохраняя его соотношение сторон
при корректировке размеров. Используйте этот метод для динамического масштабирования изображений
в вашем приложении, обеспечивая согласованное визуальное представление целостности содержимого
.
Пропорциональное изменение размера будет масштабировать каждый кадр согласно соотношению newWidth/width и newHeight/height.

Parameters:

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

Method: resize_width_proportionally(new_width)

 resize_width_proportionally(new_width) 

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

Parameters:

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

Method: resize_width_proportionally(new_width, resize_type)

 resize_width_proportionally(new_width, resize_type) 

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

Parameters:

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

Method: resize_width_proportionally(new_width, settings)

 resize_width_proportionally(new_width, settings) 

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

Parameters:

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

Method: resize_width_proportionally_settings(new_width, settings)

 resize_width_proportionally_settings(new_width, settings) 

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

Parameters:

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

Method: rotate(angle)

 rotate(angle) 

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

Parameters:

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

Method: rotate(angle, resize_proportionally, background_color)

 rotate(angle, resize_proportionally, background_color) 

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

Parameters:

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

Method: rotate_flip(rotate_flip_type)

 rotate_flip(rotate_flip_type) 

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

Parameters:

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

See also:

Example # 1: This example loads a TIFF image, rotates it by 90 degrees clockwise and optio…

Method: rotate_flip_all(rotate_flip)

 rotate_flip_all(rotate_flip) 

Выполняет вращение и отражение всех.

Parameters:

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

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:

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

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

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


from os.path import join
import aspose.pycore as aspycore
from aspose.imaging import Image, RotateFlipType
from aspose.imaging.fileformats.tiff import TiffImage
from aspose.imaging.imageoptions import PngOptions

dir_: str = "c:\\temp"
rotate_flip_types = [RotateFlipType.ROTATE_90_FLIP_NONE, RotateFlipType.ROTATE_90_FLIP_X, RotateFlipType.ROTATE_90_FLIP_XY, RotateFlipType.ROTATE_90_FLIP_Y]
for rotate_flip_type in rotate_flip_types:
	# Повернуть, отразить и сохранить в выходной файл.
	with aspycore.as_of(Image.load(join(dir_, "sample.tif")), TiffImage) as image:
		image.rotate_flip(rotate_flip_type)
		image.save(join(dir_, "sample." + rotate_flip_type + ".png"), PngOptions())

The following example loads a TIFF image and prints information about raw data format and alpha channel.


import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.tiff import TiffImage
from os.path import join as path_join


dir_ = "c:\\temp"
file_name = path_join(dir_, "sample.tif")
with Image.load(file_name) as image:
	tiff_image = aspycore.as_of(image, TiffImage)
	# Если у активного кадра TIFF есть альфа‑канал, то считается, что всё изображение TIFF имеет альфа‑канал.
	print("ImageFile={0}, FileFormat={1}, HasAlpha={2}".format(file_name, tiff_image.raw_data_format, tiff_image.has_alpha))
	i = 1
	for frame in tiff_image.frames:
		print("Frame={0}, FileFormat={1}, HasAlpha={2}".format(i, frame.raw_data_format, frame.has_alpha))
		i += 1

# Вывод может выглядеть так:
# ImageFile=c:\temp\sample.tif, FileFormat=RgbIndexed1Bpp, использованные каналы: 1, HasAlpha=False
# Frame=1, FileFormat=RgbIndexed1Bpp, использованные каналы: 1, HasAlpha=False
# Frame=2, FileFormat=RgbIndexed1Bpp, использованные каналы: 1, HasAlpha=False

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

import aspose.pycore as aspycore
from aspose.imaging import Image, Rectangle
from aspose.imaging.imageoptions import PngOptions
from aspose.imaging.fileformats.tiff import TiffImage
from os.path import join

dir_: str = "c:\\temp"
with Image.load(join(dir_, "sample.tif")) as image:
	tiff_image = aspycore.as_of(image, TiffImage)
	# Обрезать изображение. Область обрезки — прямоугольная центральная часть изображения.
	area = Rectangle(tiff_image.width // 4, tiff_image.height // 4, tiff_image.width // 2,
					 tiff_image.height // 2)
	tiff_image.crop(area)
	# Сохранить обрезанное изображение в PNG.
	tiff_image.save(join(dir_, "sample.Crop.png"), PngOptions())

The following example crops a TIFF image. The cropping area is specified via Left, Top, Right, Bottom margins.

from os.path import join
import aspose.pycore as aspycore
from aspose.imaging import Image       
from aspose.imaging.fileformats.tiff import TiffImage
from aspose.imaging.imageoptions import PngOptions

dir_: str = r"c:\temp"
with Image.load(join(dir_, "sample.tif")) as image:
	tiff_image = aspycore.as_of(image, TiffImage)
	# Обрезать снова. Установить отступ в размере 10 % от размера изображения.
	horizontal_margin: int = tiff_image.width // 10
	vertical_margin: int = tiff_image.height // 10
	tiff_image.crop(horizontal_margin, horizontal_margin, vertical_margin, vertical_margin)
	# Сохранить обрезанное изображение в PNG.
	tiff_image.save(join(dir_, "sample.Crop.png"), PngOptions())

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


import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.tiff import TiffImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_ = "c:\\temp"
with Image.load(join(dir_, "sample.tif")) as image:
	tiff_image = aspycore.as_of(image, TiffImage)
	# Бинаризовать изображение с пороговым значением 127.
	# Если соответствующее серое значение пикселя больше 127, ему будет присвоено значение 255, иначе 0.
	tiff_image.binarize_fixed(127)
	tiff_image.save(join(dir_, "sample.BinarizeFixed.png"), PngOptions())

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

from os.path import join
import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.tiff import TiffImage
from aspose.imaging.imageoptions import PngOptions

dir_: str = "c:\\temp"
with Image.load(join(dir_, "sample.tif")) as image:
	tiff_image = aspycore.as_of(image, TiffImage)
	# Бинаризовать изображение с разницей яркости 5. Яркость — это разница между пикселем и средним значением окна 10 × 10 пикселей, центрированного вокруг этого пикселя.
	tiff_image.binarize_bradley(5, 10)
	tiff_image.save(join(dir_, "sample.BinarizeBradley5_10x10.png"), PngOptions())

The following example performs gamma-correction of a TIFF image.

import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.tiff import TiffImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_: str = "c:\\temp"
with Image.load(join(dir_, "sample.tif")) as image:
	tiff_image = aspycore.as_of(image, TiffImage)
	# Установить коэффициент гаммы для красного, зелёного и синего каналов.
	tiff_image.adjust_gamma(2.5)
	tiff_image.save(join(dir_, "sample.AdjustGamma.png"), PngOptions())

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


import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.tiff import TiffImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_ = "c:\\temp"
with Image.load(join(dir_, "sample.tif")) as image:
	tiff_image = aspycore.as_of(image, TiffImage)
	# Установить отдельные коэффициенты гаммы для красного, зелёного и синего каналов.
	tiff_image.adjust_gamma(1.5, 2.5, 3.5)
	tiff_image.save(join(dir_, "sample.AdjustGamma.png"), PngOptions())

The following example performs brightness correction of a TIFF image.


import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.tiff import TiffImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_ = "c:\\temp"
with Image.load(join(dir_, "sample.tif")) as image:
	tiff_image = aspycore.as_of(image, TiffImage)
	# Установить значение яркости. Допустимые значения яркости находятся в диапазоне [-255, 255].
	tiff_image.adjust_brightness(50)
	tiff_image.save(join(dir_, "sample.AdjustBrightness.png"), PngOptions())

The following example performs contrast correction of a TIFF image.


import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.tiff import TiffImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_ = "c:\\temp"
with Image.load(join(dir_, "sample.tif")) as image:
	tiff_image = aspycore.as_of(image, TiffImage)
	# Установить значение контрастности. Допустимые значения контрастности находятся в диапазоне [-100f, 100f].
	tiff_image.adjust_contrast(50.0)
	tiff_image.save(join(dir_, "sample.AdjustContrast.png"), PngOptions())

Create Graphics Path from Path Resources in TIFF image.


import aspose.pycore as aspycore
from aspose.imaging import Image, Graphics, Color, Pen
from aspose.imaging.fileformats.tiff import TiffImage
from aspose.imaging.fileformats.tiff.pathresources import PathResourceConverter

with aspycore.as_of(Image.load("Bottle.tif"), TiffImage) as image:
	# Создайте GraphicsPath, используя PathResources из TIFF‑изображения
	active_frame = image.active_frame
	graphics_path = PathResourceConverter.to_graphics_path(active_frame.path_resource, active_frame.size)
	graphics = Graphics(image)
	# Нарисовать красную линию и сохранить изображение
	graphics.draw_path(Pen(Color.red, 10), graphics_path)
	image.save("BottleWithRedBorder.tif")