Класс DjvuImage

Summary: DjVu document class supports graphics file format and facilitates seamless
management of scanned documents and books, integrating text, drawings, images,
and photos into a single format. Supporting multi-page operations, you can
efficiently access unique document identifiers, count pages, set active pages,
and retrieve specific document pages. With features for resizing, rotating,
dithering, cropping, grayscale transformation, gamma corrections, adjustments,
and filters application, this class empowers precise manipulation and enhancement
of DjVu images to meet diverse application needs with ease and precision.

Module: aspose.imaging.fileformats.djvu

Full Name: aspose.imaging.fileformats.djvu.DjvuImage

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

Constructors

NameDescription
DjvuImage(stream)Начните работу с изображениями DjVu, создав новый экземпляр
DjvuImage класса, используя параметр Stream. Идеально подходит для
разработчиков, желающих бесшовно интегрировать обработку изображений DjVu в
свои проекты.
DjvuImage(stream, load_options)Начните работу с изображениями DjVu без проблем с помощью этого конструктора, который
инициализирует новый экземпляр класса DjvuImage с использованием параметров Stream и
LoadOptions. Идеально подходит для разработчиков, желающих точный контроль над
параметрами загрузки изображений DjVu при сохранении простоты и эффективности.

Properties

NameTypeAccessDescription
active_pageDjvuPager/wПеремещайтесь по вашему документу DjVu, получая доступ или задавая текущую активную
страницу с помощью этого свойства. Бесшовно переключайтесь между страницами, чтобы сосредоточиться на конкретном
содержании и улучшить опыт просмотра документа.
auto_adjust_paletteboolr/wПолучает или задает значение, указывающее, следует ли автоматически корректировать палитру.
background_colorColorr/wПолучает или задает значение цвета фона.
bits_per_pixelintrПолучает количество бит на пиксель изображения.
boundsRectanglerПолучает границы объекта.
buffer_size_hintintr/wПолучает или задает подсказку о размере буфера, определяющую максимальный допустимый размер для всех внутренних буферов.
containerImagerПолучает контейнер Image.
data_stream_containerStreamContainerrПолучает поток данных объекта.
disposedboolrПолучает значение, указывающее, удалён ли этот экземпляр.
djvu_pagesDjvuPage[]rБыстро получайте все страницы, содержащиеся в вашем документе DjVu, используя это
свойство. Упростите процесс обработки документов, легко получая доступ и
управляя отдельными страницами в файлах DjVu. Повышайте эффективность и
оптимизируйте задачи с помощью удобного получения страниц.
exif_dataExifDatar/wПолучает или задаёт экземпляр Exif.
file_formatFileFormatrПолучите информацию о формате файла, связанного с вашим изображением DjVu. Быстро
определите формат вашего файла для бесшовной интеграции в ваш рабочий процесс.
first_pageDjvuPagerПолучите доступ к первой странице вашего документа DjVu с помощью этого свойства. Быстро получайте
начальную страницу, чтобы эффективно начать просмотр или обработку документа.
has_alphaboolrБыстро определите, содержит ли ваш файл изображения DjVu альфа-канал.
Упростите рабочий процесс, проверяя наличие информации о прозрачности
в ваших изображениях.
has_background_colorboolr/wПолучает или задает значение, указывающее, имеет ли изображение фоновый цвет.
has_transparent_colorboolr/wПолучает значение, указывающее, имеет ли изображение прозрачный цвет.
heightintrПолучает высоту изображения.
horizontal_resolutionfloatr/wПолучает или задает горизонтальное разрешение в пикселях на дюйм для этого RasterImage.
идентификаторintrПолучает уникальный идентификатор документа
image_opacityfloatrПолучает непрозрачность этого изображения.
interrupt_monitorInterruptMonitorr/wПолучает или задает монитор прерываний.
is_cachedboolrПолучает значение, указывающее, кэшируются ли данные изображения в данный момент.
is_raw_data_availableboolrПолучает значение, указывающее, поддерживается ли загрузка необработанных данных.
last_pageDjvuPagerПолучите последнюю страницу вашего документа DjVu с помощью этого свойства. Быстро получайте
конечную страницу для просмотра или обработки без труда.
metadataImageMetadatarПолучает или задает XMP‑данные из кадра.
next_pageDjvuPagerПеремещайтесь по вашему документу DjVu, получая доступ к следующей странице с помощью этого
удобного свойства. Быстро продвигайтесь вперёд при просмотре или
обработке документа.
page_countintrПолучите общее количество страниц в вашей коллекции изображений DjVu с помощью этого свойства.
Идеально для быстрой оценки объёма вашего документа или книги в формате DjVu.
Повышайте эффективность рабочего процесса с точной информацией о количестве страниц.
pagesImage[]rПолучайте доступ к отдельным страницам вашей коллекции изображений DjVu с помощью этого свойства.
Упростите навигацию и манипуляцию вашим документом или книгой в формате DjVu,
получая каждую страницу напрямую. Повышайте эффективность рабочего процесса с лёгким
получением страниц.
paletteIColorPaletter/wПолучает или задает цветовую палитру. Цветовая палитра не используется, когда пиксели представлены напрямую.
premultiply_componentsboolr/wПолучает или задает значение, указывающее, должны ли компоненты изображения быть предварительно умножены.
previous_pageDjvuPagerБыстро перемещайтесь назад в задачах просмотра или обработки вашего документа DjVu,
получая доступ к предыдущей странице с помощью этого удобного свойства. Эффективно навигируйте
по документу без усилий.
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Получает или задает вертикальное разрешение в пикселях на дюйм для этого RasterImage.
widthintrПолучает ширину изображения.
xmp_dataXmpPacketWrapperr/wПолучает или задает данные Xmp.

Methods

NameDescription
adjust_brightness(brightness)Отрегулируйте яркость изображения, используя указанный параметр,
обеспечивая контроль над уровнями светимости для оптимальной визуальной чёткости. Этот метод усиливает
или уменьшает общую яркость изображения, позволяя выполнять точные настройки для
достижения желаемых световых эффектов. Модулируя яркость, пользователи могут оптимизировать видимость изображения
и улучшить воспроизведение деталей для лучшего восприятия.
adjust_contrast(contrast)Улучшите контраст Image для повышения визуальной чёткости и
выделения деталей с помощью этого метода, который регулирует разницу в яркости между
светлыми и тёмными областями. Точно настраивая уровни контраста, пользователи могут получить более яркие и
выразительные изображения, повышая общее качество изображения и максимизируя видимость деталей.
Эта настройка помогает раскрыть тонкие нюансы цвета и текстуры, в результате получаются
более динамичные и визуально привлекательные изображения.
adjust_gamma(gamma)Гамма‑коррекция, специально для красного, зелёного и синего каналов, включает регулировку
яркости каждого цветового компонента отдельно. Применяя разные коэффициенты гаммы к каналам RGB, вы можете точно настроить общую яркость и контраст
изображения. Эта техника обеспечивает точное воспроизведение цветов и улучшает
визуальное качество изображения на разных дисплейных устройствах.
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)Бинаризация с использованием адаптивного порогового алгоритма Брэдли с интегральным изображением
пороговая обработка — это метод, который вычисляет локальный порог для каждого пикселя на основе
локального соседства. Он адаптируется к вариациям освещённости по всему изображению, делая его
подходящим для изображений с неравномерным освещением. Вычисляя порог с помощью
интегральных изображений, он эффективно обрабатывает большие области, что делает его применимым к
реальному времени. Эта техника обычно используется в обработке документов, OCR
(оптическое распознавание символов), и задачах сегментации изображений, где точная
бинаризация необходима для последующего анализа.
binarize_fixed(threshold)Бинаризация с предопределённым порогом упрощает сложные изображения до бинарных
представлений, где пиксели классифицируются как чёрные или белые в зависимости от их
интенсивности по сравнению с заданным пороговым значением. Эта техника обычно используется в
обработке изображений для повышения чёткости, упрощения анализа и подготовки изображений к дальнейшим
этапам обработки, таким как оптическое распознавание символов (OCR). Применяя фиксированный
порог, вы можете быстро преобразовать градации серого в бинарную форму, делая их
легче интерпретировать и извлекать значимую информацию.
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)Создает новое изображение из указанных изображений в виде страниц.
crop(left_shift, right_shift, top_shift, bottom_shift)Обрезка со сдвигами позволяет точно регулировать положение и размеры
обрезаемой области внутри изображения. Эта функция незаменима для уточнения композиций,
выравнивания элементов и акцентирования точек фокуса в ваших визуалах. Внедряя сдвиги
в процесс обрезки, вы можете достичь пиксельной точности и тонко настроить
кадрирование ваших изображений с лёгкостью.
crop(rectangle)“Crop” обрезает ваше изображение, чтобы сосредоточиться на конкретных деталях или удалить нежелательные элементы,
улучшая его композицию и визуальное воздействие. Независимо от того, корректируете ли вы фотографии для социальных
сетей, создаёте баннеры для сайта или разрабатываете печатные материалы, этот инструмент поможет вам
уточнить изображения с точностью и ясностью.
dither(dithering_method, bits_count)Выполняет дизеринг текущего изображения.
dither(dithering_method, bits_count, custom_palette)Функция “Dither” применяет эффект дизеринга к вашему изображению, улучшая его визуальное
качество за счёт снижения полосатости и улучшения переходов цветов. Независимо от того, работаете ли вы
над цифровым искусством, фотографией или проектами графического дизайна, эта функция придаёт
профессиональный штрих вашим изображениям, делая их более гладкими и изысканными.
embed_digital_signature(password)Вставьте цифровую подпись, основанную на предоставленном пароле, в каждую страницу изображения.
filter(rectangle, options)Применяйте фильтры к указанной прямоугольной области изображения, чтобы улучшить или изменить её
внешний вид. Нацеливая конкретные регионы, этот метод позволяет выполнять точные настройки,
такие как размытие, повышение резкости или применение художественных эффектов, для достижения желаемых визуальных
результатов. Точная настройка фильтров на выбранных областях даёт пользователям возможность кастомизировать эстетику изображения,
улучшать чёткость и создавать художественные эффекты, соответствующие их предпочтениям.
get_argb_32_pixel(x, y)Получает 32-битный ARGB‑пиксель изображения.
get_default_argb_32_pixels(rectangle)Получает массив пикселей по умолчанию в формате 32‑бит ARGB.
get_default_options(args)Получает параметры по умолчанию.
get_default_pixels(rectangle, partial_pixel_loader)Получает массив пикселей по умолчанию с использованием частичного загрузчика пикселей.
get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings)Получает массив необработанных данных по умолчанию с использованием частичного загрузчика пикселей.
get_default_raw_data(rectangle, raw_data_settings)Получает массив необработанных данных по умолчанию.
get_file_format(file_path)Получает формат файла.
get_file_format(stream)Получает формат файла.
get_file_format_of_stream(stream)Получает формат файла.
get_fitting_rectangle(rectangle, pixels, width, height)Получает прямоугольник, соответствующий текущему изображению.
get_fitting_rectangle(rectangle, width, height)Получает прямоугольник, соответствующий текущему изображению.
get_modify_date(use_default)Получает дату и время последнего изменения ресурса изображения.
get_original_options()Получает параметры на основе настроек оригинального файла.
Это может быть полезно для сохранения глубины цвета и других параметров оригинального изображения без изменений.
Например, если мы загружаем черно‑белое PNG‑изображение с 1 битом на пиксель и затем сохраняем его с помощью
DataStreamSupporter.save(file_path) метода, будет получено PNG‑изображение с 8‑битами на пиксель.
Чтобы избежать этого и сохранить PNG‑изображение с 1‑битом на пиксель, используйте этот метод для получения соответствующих параметров сохранения и передайте их
в метод Image.save(file_path, options) в качестве второго параметра.
get_pixel(x, y)Получает пиксель изображения.
get_proportional_height(width, height, new_width)Получает пропорциональную высоту.
get_proportional_width(width, height, new_height)Получает пропорциональную ширину.
get_serialized_stream(image_options, clipping_rectangle, page_number)Преобразует в aps.
get_skew_angle()Получает угол наклона.
Этот метод применим к отсканированным текстовым документам для определения угла наклона при сканировании.
grayscale()Преобразование в градации серого переводит изображение в чёрно‑белое представление, где
интенсивность каждого пикселя задаётся единственным значением от чёрного до белого.
Этот процесс удаляет цветовую информацию, в результате чего получается монохромное изображение. Градации серого
часто используются в приложениях, где цвет не нужен или предпочтительна простота,
например при сканировании документов, печати и некоторых типах анализа изображений.
is_digital_signed(password, percentage_threshold)Выполняет быструю проверку, чтобы определить, подписано ли изображение цифровой подписью, используя предоставленный пароль и пороговое значение.
load(file_path)Загружает новое изображение из указанного пути к файлу или URL.
Если filePath — путь к файлу, метод просто открывает файл.
Если filePath — URL, метод загружает файл, сохраняет его как временный и открывает.
load(file_path, load_options)Загружает новое изображение из указанного пути к файлу или URL.
Если filePath — путь к файлу, метод просто открывает файл.
Если filePath — URL, метод загружает файл, сохраняет его как временный и открывает.
load(stream)Загрузите ваш DjVu‑документ с помощью этого метода. Упростите процесс, быстро
получая доступ и импортируя DjVu‑файлы в ваше приложение.
load(stream, load_options)Импортируйте ваш DjVu‑документ, используя этот метод с параметрами stream и loadOptions.
Упростите процесс, быстро получая доступ и импортируя DjVu‑файлы
в ваше приложение, предоставляя гибкость и возможности настройки для удовлетворения
ваших потребностей.
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_document(stream)Загрузите ваш DjVu‑документ с помощью этого метода. Упростите процесс, быстро
получая доступ и импортируя DjVu‑файлы в ваше приложение.
load_document(stream, load_options)Импортируйте ваш DjVu‑документ, используя этот метод с параметрами stream и loadOptions.
Упростите процесс, быстро получая доступ и импортируя DjVu‑файлы
в ваше приложение, предоставляя гибкость и возможности настройки для удовлетворения
ваших потребностей.
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() и RasterCachedMultipageImage.rotate(angle, resize_proportionally, background_color).
normalize_histogram()Нормализует гистограмму изображения — корректирует значения пикселей, чтобы использовать весь доступный диапазон.
read_argb_32_scan_line(scan_line_index)Считывает всю строку сканирования по указанному индексу строки сканирования.
read_scan_line(scan_line_index)Считывает всю строку сканирования по указанному индексу строки сканирования.
remove_metadata()Удаляет метаданные этого экземпляра изображения, устанавливая значение IHasXmpData.xmp_data в None.
replace_argb(old_color_argb, old_color_diff, new_color_argb)Заменяет один цвет другим с допустимой разницей и сохраняет исходное альфа‑значение для сохранения плавных краёв.
replace_color(old_color, old_color_diff, new_color)Заменяет один цвет другим с допустимой разницей и сохраняет исходное альфа‑значение для сохранения плавных краёв.
replace_color(old_color_argb, old_color_diff, new_color_argb)Заменяет один цвет другим с допустимой разницей и сохраняет исходное альфа‑значение для сохранения плавных краёв.
replace_non_transparent_colors(new_color)Заменяет все непрозрачные цвета новым цветом и сохраняет исходное альфа‑значение для сохранения плавных краёв.
Примечание: если использовать его для изображений без прозрачности, все цвета будут заменены одним.
replace_non_transparent_colors(new_color_argb)Заменяет все непрозрачные цвета новым цветом и сохраняет исходное альфа‑значение для сохранения плавных краёв.
Примечание: если использовать его для изображений без прозрачности, все цвета будут заменены одним.
resize(new_width, new_height)Изменяет размер изображения. По умолчанию используется ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.
resize(new_width, new_height, resize_type)Измените размер изображения с помощью метода Resize, предоставляющего простой и эффективный способ
регулировать размеры ваших изображений в соответствии с вашими требованиями. Эта
универсальная функция позволяет легко масштабировать изображения до нужного размера,
повышая их удобство использования на различных платформах и в приложениях.
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)Метод ResizeHeightProportionally позволяет регулировать высоту вашего
изображения, сохраняя его соотношение сторон. Это гарантирует, что изображение сохраняет
пропорции, предотвращая искажения и сохраняя визуальную целостность.
Независимо от того, оптимизируете ли вы изображения для веб‑страниц, мобильных приложений или печатных материалов, этот
метод обеспечивает наилучший вид ваших изображений на разных платформах и устройствах.
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)Метод ResizeWidthProportionally предлагает удобное решение для регулирования
ширины вашего изображения, сохраняя его соотношение сторон. Пропорционально изменяя
ширину, вы можете обеспечить визуальную привлекательность и
согласованность изображений на разных устройствах и размерах экранов, повышая их универсальность
и удобство использования в различных контекстах.
resize_width_proportionally(new_width, settings)Пропорционально изменяет ширину.
resize_width_proportionally_settings(new_width, settings)Пропорционально изменяет ширину.
rotate(angle)Повернуть изображение вокруг центра.
rotate(angle, resize_proportionally, background_color)Поверните изображение вокруг его центра с помощью метода Rotate класса
RasterCachedMultipageImage. Эта удобная функция позволяет легко
регулировать ориентацию изображений, сохраняя их центральное положение,
расширяя возможности манипуляции изображениями.
rotate_flip(rotate_flip_type)Метод RotateFlip предоставляет разнообразные варианты манипуляций с изображением, позволяя
вращать, отражать или выполнять обе операции над активным кадром независимо.
Независимо от того, редактируете ли вы фотографии, создаёте графику или улучшаете цифровое искусство, этот
метод обеспечивает точный контроль над ориентацией и композицией ваших изображений,
гарантируя соответствие вашей творческой задумке с лёгкостью и эффективностью.
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: DjvuImage(stream)

 DjvuImage(stream) 

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

Parameters:

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

See also:

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

Constructor: DjvuImage(stream, load_options)

 DjvuImage(stream, load_options) 

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

Parameters:

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

See also:

Example # 1: This example shows how to load a DJVU image from a file stream to stay within…

Property: pages

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

See also:

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

Method: adjust_brightness(brightness)

 adjust_brightness(brightness) 

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

Parameters:

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

See also:

Example # 1: The following example performs brightness correction of a DJVU 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 DJVU image.

Method: adjust_gamma(gamma)

 adjust_gamma(gamma) 

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

Parameters:

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

See also:

Example # 1: The following example performs gamma-correction of a DJVU 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 DJVU 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) 

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

Parameters:

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

See also:

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

Method: binarize_fixed(threshold)

 binarize_fixed(threshold) 

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

Parameters:

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

See also:

Example # 1: The following example binarizes a DJVU 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: 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) 

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

Parameters:

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

See also:

Example # 1: The following example crops a DJVU 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) 

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

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

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

Parameters:

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

Returns

ТипОписание
ImageЗагруженный djvu документ

Method: load(stream, load_options) [static]

 load(stream, load_options) 

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

Parameters:

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

Returns

ТипОписание
ImageЗагруженный djvu документ

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_document(stream) [static]

 load_document(stream) 

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

Parameters:

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

Returns

ТипОписание
DjvuImageЗагруженный djvu документ

Method: load_document(stream, load_options) [static]

 load_document(stream, load_options) 

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

Parameters:

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

Returns

ТипОписание
DjvuImageЗагруженный djvu документ

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() и RasterCachedMultipageImage.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) 

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

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) 

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

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) 

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

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) 

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

Parameters:

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

Method: rotate_flip(rotate_flip_type)

 rotate_flip(rotate_flip_type) 

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

Parameters:

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

See also:

Example # 1: This example loads a DJVU 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.BufferedRandomThe stream to save data to.

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

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

from os.path import join
from aspose.imaging.fileformats.djvu import DjvuImage
from aspose.imaging.imageoptions import PngOptions       

dir_: str = "c:\\temp"
# Загрузите DJVU‑изображение из файлового потока.
with open(join(dir_, "sample.djvu"), "rb") as stream:
	with DjvuImage(stream) as djvu_image:
		# Сохранить каждую страницу как отдельное PNG‑изображение.
		for djvu_page in djvu_image.pages:
			# Сгенерировать имя файла на основе номера страницы.
			file_name: str = "sample.{0}.png".format(djvu_page.page_number)
			djvu_page.save(join(dir_, file_name), PngOptions())

This example shows how to load a DJVU image from a file stream to stay within the specified memory limit.

from aspose.imaging.fileformats.djvu import DjvuImage
from aspose.imaging.imageoptions import PngOptions
from aspose.imaging import LoadOptions
from os.path import join

dir_: str = "c:\\temp"
# Загрузите DJVU‑изображение из файлового потока.
with open(join(dir_, "sample.djvu"), "rb") as stream:
	# Максимальный допустимый размер всех внутренних буферов — 1 МБ.
	load_options = LoadOptions()
	load_options.buffer_size_hint = 1 * 1024 * 1024
	with DjvuImage(stream, load_options) as djvu_image:
		# Сохранить каждую страницу как отдельное PNG‑изображение.
		for djvu_page in djvu_image.pages:
			# Сгенерировать имя файла на основе номера страницы.
			file_name: str = "sample.{0}.png".format(djvu_page.page_number)
			djvu_page.save(join(dir_, file_name), PngOptions())

This example loads a DJVU 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.djvu import DjvuImage
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.djvu")), DjvuImage) as image:
		image.rotate_flip(rotate_flip_type)
		image.save(join(dir_, "sample." + rotate_flip_type + ".png"), PngOptions())

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


from aspose.pycore import as_of
from aspose.imaging import Image, Rectangle
from aspose.imaging.fileformats.djvu import DjvuImage
from aspose.imaging.imageoptions import PngOptions

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

The following example binarizes a DJVU 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.djvu import DjvuImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

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

The following example binarizes a DJVU 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.djvu import DjvuImage
from aspose.imaging.imageoptions import PngOptions

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

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

import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.djvu import DjvuImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

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

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


import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.djvu import DjvuImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

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

The following example performs brightness correction of a DJVU image.


import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.djvu import DjvuImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

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

The following example performs contrast correction of a DJVU image.


import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.djvu import DjvuImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

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