Класс GifImage

Summary: The API for Graphical Interchange Format (GIF) image file provides
developers with versatile tools for processing compressed raster images and
animated GIFs. Offering features like XMP metadata handling, color palette
settings, background and transparent color control, opacity settings, resize,
crop, filter application, gamma corrections, contrast adjustment, grayscale
transformation, and conversion to other formats. This API empowers seamless
manipulation and enhancement of GIF images for a wide range of applications.

Module: aspose.imaging.fileformats.gif

Full Name: aspose.imaging.fileformats.gif.GifImage

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

Constructors

Name	Description
GifImage(first_frame)	Создание GIF‑изображений становится простым с помощью конструктора GifImage конструктора. С лишь параметром firstFrame вы погружаетесь в мир динамичной визуальной коммуникации.
GifImage(first_frame, global_palette)	Инициализируйте новый объект GifImage с указанными параметрами для первого кадра и глобальной палитры. Начните быстро управлять GIF‑изображениями, обеспечивая точное представление с настраиваемыми параметрами для оптимальных результатов.
GifImage(first_frame, global_palette, is_palette_sorted, palette_color_resolution, palette_background_color_index, aspect_ratio, has_trailer)	Начните без усилий с конструктором GifImage. С помощью этого простого метода вы можете легко приступить к созданию анимированных GIF‑файлов. Просто укажите firstFrame, globalPalette, paletteColorResolution, aspectRatio и другие параметры, и вы будете готовы оживить свои визуальные материалы.

Properties

Name	Type	Access	Description
active_frame	GifFrameBlock	r/w	Управляйте и изменяйте кадры с помощью этого свойства, обеспечивая плавную навигацию и модификацию активного кадра в GIF‑изображении.
auto_adjust_palette	bool	r/w	Получает или задает значение, указывающее, следует ли автоматически корректировать палитру.
background_color	Color	r/w	Управляйте цветом фона GIF‑изображения с помощью этого свойства. Вы можете установить или получить цвет фона, чтобы обеспечить согласованность и улучшить визуальную привлекательность.
background_color_index	System.Byte	r/w	Контролируйте индекс цвета фона GIF‑изображения с помощью этого свойства. Установите или получите индекс, чтобы поддерживать согласованность или достичь желаемых визуальных эффектов.
bits_per_pixel	int	r	Получает количество бит на пиксель изображения.
blocks	IGifBlock[]	r	Получайте беспрепятственный доступ к GIF‑блокам с помощью этого свойства, облегчая простое извлечение и изменение базовых структур данных изображения.
bounds	Rectangle	r	Получает границы объекта.
buffer_size_hint	int	r/w	Получает или задает подсказку о размере буфера, определяющую максимальный допустимый размер для всех внутренних буферов.
container	Image	r	Получает контейнер Image.
data_stream_container	StreamContainer	r	Получает поток данных объекта.
disposed	bool	r	Получает значение, указывающее, удалён ли этот экземпляр.
exif_data	ExifData	r/w	Получает или задаёт экземпляр Exif.
file_format	FileFormat	r	Получайте формат файла без усилий с помощью этого свойства. Это ваш основной источник для определения формата ваших файлов. Бесшовно интегрированный в ваш рабочий процесс, он предоставляет важную информацию без каких‑либо затруднений.
has_alpha	bool	r	Получает значение, указывающее, имеет ли этот экземпляр альфа-канал.
has_background_color	bool	r/w	Это свойство определяет, содержит ли GIF‑изображение цвет фона. Если true, это указывает, что изображение включает цвет фона.
has_trailer	bool	r/w	Управляйте наличием трейлера в ваших GIF‑файлах с помощью этого свойства. Независимо от того, нужно ли вам проверить наличие трейлера или установить его присутствие, это свойство упрощает процесс. Держите ваши GIF‑файлы структурированными и соответствующими требованиям с этой интуитивной функцией.
has_transparent_color	bool	r/w	Определите, включает ли активный кадр GIF‑изображения прозрачный цвет. Это свойство предоставляет удобный способ проверить наличие прозрачности в изображении.
height	int	r	Получает высоту изображения.
horizontal_resolution	float	r/w	Получает или задает горизонтальное разрешение в пикселях на дюйм для этого RasterImage.
image_opacity	float	r	Получите непрозрачность активного кадра в изображении, получая представление о уровне его прозрачности. Это свойство особенно полезно для понимания степени прозрачности или непрозрачности активного кадра в изображении.
interrupt_monitor	InterruptMonitor	r/w	Получает или задает монитор прерываний.
is_cached	bool	r	Получает значение, указывающее, кэшируются ли данные изображения в данный момент.
is_interlaced	bool	r	Определяет, является ли изображение чересстрочным, влияя на его отображение во время загрузки. Это свойство предоставляет информацию о поведении рендеринга изображения, что необходимо для оптимизации стратегий загрузки и улучшения общего качества просмотра.
is_palette_sorted	bool	r/w	Управляйте сортировкой палитры в ваших GIF‑изображениях с помощью этого свойства. Независимо от того, нужно ли вам проверить, отсортирована ли палитра, или задать поведение сортировки, это свойство предоставляет простой способ управлять организацией палитры в ваших GIF‑файлах.
is_raw_data_available	bool	r	Получает значение, указывающее, поддерживается ли загрузка необработанных данных.
loops_count	int	r/w	Получите количество повторов без усилий с помощью этого свойства. Если ваше GIF‑изображение содержит информацию о повторениях, это свойство предоставляет быстрый доступ к количеству повторов, позволяя беспрепятственно управлять поведением циклов в ваших GIF‑файлах.
metadata	ImageMetadata	r	Получает или задает XMP‑данные из кадра.
page_count	int	r	Получите общее количество страниц, содержащихся в изображении, с помощью этого простого свойства. Идеально подходит для быстрого оценки объёма содержимого изображения.
pages	Image[]	r	Получите доступ к страницам изображения через это удобное свойство, позволяющее бесшовно перемещаться и манипулировать отдельными страницами по мере необходимости.
palette	IColorPalette	r/w	Получает или задает цветовую палитру. Цветовая палитра не используется, когда пиксели представлены напрямую.
palette_color_resolution_bits	System.Byte	r/w	Управляйте разрешением цветов палитры ваших GIF‑изображений с помощью этого свойства. Регулируйте количество бит, используемых для представления цветов в палитре, обеспечивая точный контроль над глубиной цвета и качеством изображения.
pixel_aspect_ratio	System.Byte	r/w	Управляйте соотношением сторон пикселя GIF‑изображения с помощью этого свойства. Устанавливайте или получайте соотношение сторон, чтобы обеспечить точный рендеринг и сохранить визуальную достоверность.
premultiply_components	bool	r/w	Получает или задает значение, указывающее, должны ли компоненты изображения быть предварительно умножены.
raw_custom_color_converter	IColorConverter	r/w	Получает или задает пользовательский конвертер цветов
raw_data_format	PixelDataFormat	r	Получает формат необработанных данных.
raw_data_settings	RawDataSettings	r	Получает текущие настройки необработанных данных. Обратите внимание, что при использовании этих настроек данные загружаются без конвертации.
raw_fallback_index	int	r/w	Получает или задает резервный индекс, используемый, когда индекс палитры выходит за пределы.
raw_indexed_color_converter	IIndexedColorConverter	r/w	Получает или задает индексированный конвертер цветов
raw_line_size	int	r	Получает размер необработанной строки в байтах.
size	Size	r	Получает размер объекта.
transparent_color	Color	r/w	Получите прозрачный цвет активного кадра в GIF‑изображении. Это свойство позволяет вам получить доступ к конкретному цвету, назначенному как прозрачный в текущем активном кадре.
update_xmp_data	bool	r/w	Получает или задает значение, указывающее, следует ли обновлять метаданные XMP.
use_palette	bool	r	Получает значение, указывающее, используется ли палитра изображения.
use_raw_data	bool	r/w	Получает или задает значение, указывающее, следует ли использовать загрузку необработанных данных, когда такая загрузка доступна.
vertical_resolution	float	r/w	Получает или задает вертикальное разрешение в пикселях на дюйм для этого RasterImage.
width	int	r	Получает ширину изображения.
xmp_data	XmpPacketWrapper	r/w	Получает или задает данные Xmp.

Methods

Name	Description
add_block(block)	Добавление нового GIF‑блока позволяет включить дополнительные данные в изображение. Этот метод позволяет вам добавлять пользовательские блоки в GIF‑изображение, которые могут содержать различные типы информации.
add_page(page)	Бесшовно интегрируйте новую страницу в существующее изображение, улучшая его содержимое и расширяя его охват. Этот метод дополняет коллекции изображений дополнительным контентом, способствуя креативности и гибкости в управлении и композиции изображений.
adjust_brightness(brightness)	Регулирует яркость изображения в соответствии с указанным параметром brightness. Этот метод изменяет яркость всего изображения равномерно, усиливая или уменьшая общую светимость для достижения желаемого эффекта.
adjust_contrast(contrast)	Регулирует контраст изображения, усиливая или уменьшая разницу в яркости между пикселями. Этот метод изменяет общий тональный диапазон изображения, делая тёмные области темнее, а светлые — светлее, чтобы улучшить визуальную чёткость и детали.
adjust_gamma(gamma)	Повышайте качество изображения, применяя гамма‑коррекцию. Этот метод регулирует гамму цвета изображения для достижения оптимальной визуальной чёткости. Он изменяет значение гаммы каждого пикселя, что приводит к улучшенной цветопередаче и общему виду изображения.
adjust_gamma(gamma_red, gamma_green, gamma_blue)	Гамма‑коррекция изображения применяет нелинейную настройку значений пикселей, усиливая или уменьшая яркость в зависимости от указанных коэффициентов для красного, зелёного и синего каналов. Этот метод помогает точно настроить цветовой баланс и светимость изображения, улучшая его общий внешний вид и визуальное качество.
analyze_percentage_digital_signature(password)	Вычисляет процентное сходство между извлечёнными данными и оригинальным паролем.
auto_brightness_contrast()	Выполняет автоматическую адаптивную нормализацию яркости и контраста для всего изображения.
auto_rotate()	Автоматически вращает изображение на основе данных ориентации, извлечённых из Exif метаданных. Этот метод гарантирует, что изображения отображаются в правильной ориентации, улучшая пользовательский опыт и устраняя необходимость ручных корректировок. Путём анализа информации Exif изображение вращается соответствующим образом, обеспечивая бесшовный просмотр на разных платформах и устройствах. Этот автоматизированный процесс вращения упрощает работу с изображениями и повышает общую удобность, особенно при работе с большими партиями изображений с различными ориентациями.
binarize_bradley(brightness_difference)	Бинаризация изображения с использованием адаптивного порогового алгоритма Брэдли с интегральным порогом изображения — это метод преобразования градаций серого в бинарное изображение. Этот алгоритм вычисляет локальный порог для каждого пикселя на основе средней интенсивности окружающих пикселей в заданном окне. Путём адаптивной настройки порога в зависимости от локальной интенсивности пикселей, метод Брэдли эффективно справляется с вариациями освещения и контраста по всему изображению.
binarize_bradley(brightness_difference, window_size)	Бинаризация изображения с использованием адаптивного порогового алгоритма Брэдли, основанного на интегральном порогировании изображения
binarize_fixed(threshold)	Бинаризация изображения с предустановленным порогом преобразует изображение в градациях серого или цветное изображение в бинарное, где каждый пиксель классифицируется как чёрный или белый в зависимости от того, превышает ли его значение интенсивности заданный порог.
binarize_otsu()	Бинаризация изображения с порогом Оцу — это метод, используемый для автоматического определения оптимального порогового значения при преобразовании градаций серого в бинарное изображение. Алгоритм пороговой обработки Оцу вычисляет порог, который минимизирует внутриклассовую дисперсию интенсивностей пикселей в двух полученных классах (фон и объект). Эта техника особенно полезна, когда оптимальное пороговое значение неизвестно и должно определяться адаптивно на основе гистограммы изображения.
blend(origin, overlay, overlay_alpha)	Смешивает этот экземпляр изображения с изображением overlay.
blend(origin, overlay, overlay_area, overlay_alpha)	Смешивает этот экземпляр изображения с изображением overlay.
cache_data()	Кеширует данные приватно.
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)	Определяет, можно ли сохранить изображение в указанный формат файла, представленный переданными параметрами сохранения.
clear_blocks()	Очистка всех GIF‑блоков удаляет любые существующие данные, хранящиеся в изображении. Эта операция эффективно сбрасывает изображение в пустое состояние, удаляя любые ранее добавленные блоки. Используйте этот метод, когда необходимо начать с чистого листа для создания или изменения GIF‑изображения.
create(files)	Создаёт многостраничное изображение, содержащее указанные файлы.
create(files, throw_exception_on_load_error)	Создаёт многостраничное изображение, содержащее указанные файлы.
create(image_options, width, height)	Создаёт новое изображение с использованием указанных параметров создания.
create(image_options, width, height, pixels)	Создаёт экземпляр RasterImage из предоставленного массива пикселей. Проверяет, что указанные ширина и высота соответствуют размерам пиксельных данных. Этот метод может использоваться только в лицензированном режиме библиотеки.
create(images)	Создаёт новое изображение, используя указанные изображения в качестве страниц
create(images, dispose_images)	Создает новое изображение из указанных изображений в виде страниц.
create(multipage_create_options)	Создает указанные параметры создания многостраничного изображения.
create_from_files(files)	Создает многостраничное изображение, содержащее указанные файлы в виде страниц с отложенной загрузкой.
create_from_files(files, throw_exception_on_load_error)	Создает многостраничное изображение, содержащее указанные файлы в виде страниц с отложенной загрузкой.
create_from_images(images)	Создаёт новое изображение, используя указанные изображения в качестве страниц
create_from_images(images, dispose_images)	Создает новое изображение из указанных изображений в виде страниц.
crop(left_shift, right_shift, top_shift, bottom_shift)	Обрезать изображение со смещениями.
crop(rectangle)	Обрежьте изображение, используя заданную прямоугольную область. Эта операция удаляет внешнюю часть изображения, оставляя только выбранный регион, определённый прямоугольником.
dither(dithering_method, bits_count)	Выполняет дизеринг текущего изображения.
dither(dithering_method, bits_count, custom_palette)	Примените дизеринг к текущему изображению. Этот процесс повышает качество изображения, уменьшая цветовые полосы и улучшая переходы цветов, что приводит к более плавному внешнему виду.
embed_digital_signature(password)	Вставьте цифровую подпись, основанную на предоставленном пароле, в каждую страницу изображения.
filter(rectangle, options)	Примените конкретный фильтр к указанной области изображения, улучшая его визуальное качество или изменяя внешний вид по желанию. Этот метод избирательно обрабатывает пиксели внутри заданного прямоугольника, позволяя выполнять целевые корректировки при сохранении целостности окружающих данных изображения.
get_argb_32_pixel(x, y)	Получает 32-битный ARGB‑пиксель изображения.
get_default_argb_32_pixels(rectangle)	Получает массив пикселей по умолчанию в формате 32‑бит ARGB.
get_default_options(args)	Получает параметры по умолчанию.
get_default_pixels(rectangle, partial_pixel_loader)	Получает массив пикселей по умолчанию с использованием частичного загрузчика пикселей.
get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings)	Получает массив необработанных данных по умолчанию с использованием частичного загрузчика пикселей.
get_default_raw_data(rectangle, raw_data_settings)	Получает массив необработанных данных по умолчанию.
get_file_format(file_path)	Получает формат файла.
get_file_format(stream)	Получает формат файла.
get_file_format_of_stream(stream)	Получает формат файла.
get_fitting_rectangle(rectangle, pixels, width, height)	Получает прямоугольник, соответствующий текущему изображению.
get_fitting_rectangle(rectangle, width, height)	Получает прямоугольник, соответствующий текущему изображению.
get_modify_date(use_default)	Получает дату и время последнего изменения ресурса изображения.
get_original_options()	Получите параметры, основанные на настройках оригинального файла, что важно для поддержания точности и согласованности при обработке и манипуляции изображениями. Этот метод обеспечивает бесшовную интеграцию параметров, специфичных для файла, в последующие операции, гарантируя точное воспроизведение и соблюдение присущих изображению характеристик. Это может быть полезно для сохранения глубины цвета и других параметров оригинального изображения без изменений. Например, если мы загружаем черно-белое PNG‑изображение с 1 битом на пиксель и затем сохраняем его с помощью DataStreamSupporter.save(file_path) метода, будет получено PNG‑изображение с 8‑битами на пиксель. Чтобы избежать этого и сохранить PNG‑изображение с 1‑битом на пиксель, используйте этот метод для получения соответствующих параметров сохранения и передайте их в метод Image.save(file_path, options) в качестве второго параметра.
get_pixel(x, y)	Получает пиксель изображения.
get_proportional_height(width, height, new_width)	Получает пропорциональную высоту.
get_proportional_width(width, height, new_height)	Получает пропорциональную ширину.
get_serialized_stream(image_options, clipping_rectangle, page_number)	Преобразует в aps.
get_skew_angle()	Получает угол наклона. Этот метод применим к отсканированным текстовым документам для определения угла наклона при сканировании.
grayscale()	Преобразование изображения в его градационную (оттенки серого) форму переводит цветное изображение в черно‑серую версию, удаляя цветовую информацию при сохранении яркости. Этот процесс упрощает изображение до оттенков серого, делая его подходящим для различных применений, таких как печать, обработка документов и анализ в градациях серого.
insert_block(index, block)	Вставка нового блока GIF позволяет добавить пользовательские данные в определённую позицию внутри изображения. Этот метод дает возможность разместить пользовательские блоки в нужном месте GIF‑изображения, обеспечивая гибкость в организации и структуре данных изображения.
is_digital_signed(password, percentage_threshold)	Выполняет быструю проверку, чтобы определить, подписано ли изображение цифровой подписью, используя предоставленный пароль и пороговое значение.
load(file_path)	Загружает новое изображение из указанного пути к файлу или URL. Если filePath — путь к файлу, метод просто открывает файл. Если filePath — URL, метод загружает файл, сохраняет его как временный и открывает.
load(file_path, load_options)	Загружает новое изображение из указанного пути к файлу или URL. Если filePath — путь к файлу, метод просто открывает файл. Если filePath — URL, метод загружает файл, сохраняет его как временный и открывает.
load(stream)	Загружает новое изображение из указанного потока.
load(stream, load_options)	Загружает новое изображение из указанного потока.
load_argb_32_pixels(rectangle)	Загружает 32‑битные ARGB‑пиксели.
load_argb_64_pixels(rectangle)	Загружает 64‑битные ARGB‑пиксели.
load_cmyk_32_pixels(rectangle)	Загружает пиксели в формате CMYK.
load_cmyk_pixels(rectangle)	Загружает пиксели в формате CMYK. Этот метод устарел. Пожалуйста, используйте более эффективный метод RasterImage.load_cmyk_32_pixels(rectangle).
load_partial_argb_32_pixels(rectangle, partial_pixel_loader)	Частично загружает 32‑битные ARGB‑пиксели (по блокам).
load_partial_argb_64_pixels(rectangle, partial_pixel_loader)	Частично загружает 64‑битные ARGB‑пиксели пакетами.
load_partial_pixels(desired_rectangle, pixel_loader)	Частично загружает пиксели пакетами.
load_pixels(rectangle)	Загружает пиксели.
load_raw_data(rectangle, dest_image_bounds, raw_data_settings, raw_data_loader)	Загружает необработанные данные.
load_raw_data(rectangle, raw_data_settings, raw_data_loader)	Загружает необработанные данные.
load_stream(stream)	Загружает новое изображение из указанного потока.
load_stream_with_options(stream, load_options)	Загружает новое изображение из указанного потока.
load_with_options(file_path, load_options)	Загружает новое изображение из указанного пути к файлу или URL. Если filePath — путь к файлу, метод просто открывает файл. Если filePath — URL, метод загружает файл, сохраняет его как временный и открывает.
normalize_angle()	Нормализует угол. Этот метод применим к отсканированным текстовым документам для устранения наклона сканирования. Метод использует функции RasterImage.get_skew_angle() и RasterImage.rotate(angle).
normalize_angle(resize_proportionally, background_color)	Нормализует угол. Этот метод применим к отсканированным текстовым документам для устранения наклона сканирования. Метод использует функции RasterImage.get_skew_angle() и RasterCachedMultipageImage.rotate(angle, resize_proportionally, background_color).
normalize_histogram()	Нормализует гистограмму изображения — корректирует значения пикселей, чтобы использовать весь доступный диапазон.
order_blocks()	Упорядочивание блоков GIF в соответствии со спецификацией GIF обеспечивает правильную структуру GIF и соответствие стандарту. Этот процесс включает размещение блоков в корректной последовательности, определённой спецификацией. Кроме того, он может включать удаление некоторых экземпляров GifGraphicsControlBlock , которые не необходимы для окончательной структуры. Соблюдая спецификацию GIF, полученное изображение будет правильно построено и совместимо с приложениями для просмотра GIF.
read_argb_32_scan_line(scan_line_index)	Считывает всю строку сканирования по указанному индексу строки сканирования.
read_scan_line(scan_line_index)	Считывает всю строку сканирования по указанному индексу строки сканирования.
remove_block(block)	Удаление блока GIF удаляет определённые данные из изображения, предоставляя возможность очистить или изменить структуру изображения. Этот метод позволяет удалить нежелательные или лишние блоки, оптимизируя GIF‑изображение для эффективного хранения. Используйте эту функциональность для устранения устаревшей информации из изображения, сохраняя его целостность и качество.
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)	Изменяет размер этого экземпляра Image.
resize(new_width, new_height, settings)	Изменяет размер этого экземпляра Image.
resize_by_settings(new_width, new_height, settings)	Изменяет размер изображения.
resize_by_type(new_width, new_height, resize_type)	Изменяет размер изображения.
resize_full_frame(new_width, new_height, resize_type)	Изменение размера изображения с учётом всех кадров каждой страницы в GIF, тем самым предотвращая появление потенциальных артефактов. Этот метод необходим для поддержания целостности и качества изображения, особенно при работе с анимированными GIF или последовательностями кадров.
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_frame_time(time)	Настраивает длительность каждого кадра в миллисекундах, обеспечивая согласованное время воспроизведения по всей последовательности изображений. Этот метод единообразно задаёт время отображения для каждого кадра, позволяя точно контролировать скорость анимации. Изменение этого значения сбросит задержку для всех кадров.
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: GifImage(first_frame)

 GifImage(first_frame)

Создание GIF‑изображений становится простым с помощью конструктора GifImage
конструктора. С лишь параметром firstFrame вы погружаетесь в мир динамичной
визуальной коммуникации.

Parameters:

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

See also:

Example # 1: This example shows how to create a GIF image and save it to a file.

Example # 2: The following example shows how to compose an animated GIF image from individ…

Constructor: GifImage(first_frame, global_palette)

 GifImage(first_frame, global_palette)

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

Parameters:

Параметр	Тип	Описание
first_frame	GifFrameBlock	Первый кадр, с которым инициализируется GIF‑изображение.
global_palette	IColorPalette	Глобальная палитра, которую следует использовать. Обратите внимание, что если оба firstFrame и globalPalette равны null, будет использована палитра по умолчанию.

See also:

Example # 1: This example shows how to create a GIF image with a custom palette and save i…

Constructor: GifImage(first_frame, global_palette, is_palette_sorted, palette_color_resolution, palette_background_color_index, aspect_ratio, has_trailer)

 GifImage(first_frame, global_palette, is_palette_sorted, palette_color_resolution, palette_background_color_index, aspect_ratio, has_trailer)

Начните без усилий с конструктором GifImage. С помощью этого
простого метода вы можете легко приступить к созданию анимированных GIF‑файлов. Просто укажите
firstFrame, globalPalette, paletteColorResolution, aspectRatio и другие
параметры, и вы будете готовы оживить свои визуальные материалы.

Parameters:

Параметр	Тип	Описание
first_frame	GifFrameBlock	Первый кадр, с которым инициализируется GIF‑изображение.
global_palette	IColorPalette	Глобальная палитра, которую следует использовать. Обратите внимание, что если оба firstFrame и globalPalette равны null, будет использована палитра по умолчанию.
is_palette_sorted	bool	если установить в true, палитра будет отсортирована. Обратите внимание, что параметр используется, когда globalPalette не равен null.
palette_color_resolution	System.Byte	Разрешение цвета палитры. Обратите внимание, что параметр используется, когда globalPalette не равен null.
palette_background_color_index	System.Byte	Индекс фонового цвета палитры.
aspect_ratio	System.Byte	Соотношение сторон.
has_trailer	bool	если установить в true, у GIF‑изображения будет трейлер, иначе в конце потока трейлер не будет записан.

Property: active_frame

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

See also:

Example # 1: The following example shows how to remove all blocks from a GIF image.

Method: add_block(block)

 add_block(block)

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

Parameters:

Параметр	Тип	Описание
block	IGifBlock	Блок GIF для добавления.

See also:

Example # 1: The following example shows how to compose an animated GIF image from individ…

Method: add_page(page)

 add_page(page)

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

Parameters:

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

See also:

Example # 1: Create multipage GIF image using single page raster images.

Method: adjust_brightness(brightness)

 adjust_brightness(brightness)

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

Parameters:

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

See also:

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

Method: adjust_contrast(contrast)

 adjust_contrast(contrast)

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

Parameters:

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

See also:

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

Method: adjust_gamma(gamma)

 adjust_gamma(gamma)

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

Parameters:

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

See also:

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

Method: adjust_gamma(gamma_red, gamma_green, gamma_blue)

 adjust_gamma(gamma_red, gamma_green, gamma_blue)

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

Parameters:

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

See also:

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

Method: analyze_percentage_digital_signature(password)

 analyze_percentage_digital_signature(password)

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

Parameters:

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

Returns

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

Method: binarize_bradley(brightness_difference)

 binarize_bradley(brightness_difference)

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

Parameters:

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

Method: binarize_bradley(brightness_difference, window_size)

 binarize_bradley(brightness_difference, window_size)

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

Parameters:

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

Method: binarize_fixed(threshold)

 binarize_fixed(threshold)

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

Parameters:

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

See also:

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

Method: blend(origin, overlay, overlay_alpha)

 blend(origin, overlay, overlay_alpha)

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

Parameters:

Параметр	Тип	Описание
origin	Point	Источник наложения фонового изображения.
overlay	RasterImage	Изображение наложения.
overlay_alpha	System.Byte	Прозрачность наложения.

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

 blend(origin, overlay, overlay_area, overlay_alpha)

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

Parameters:

Параметр	Тип	Описание
origin	Point	Источник наложения фонового изображения.
overlay	RasterImage	Изображение наложения.
overlay_area	Rectangle	Область наложения.
overlay_alpha	System.Byte	Прозрачность наложения.

Method: can_load(file_path) [static]

 can_load(file_path)

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

Parameters:

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

Returns

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

Method: can_load(file_path, load_options) [static]

 can_load(file_path, load_options)

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

Parameters:

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

Returns

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

Method: can_load(stream) [static]

 can_load(stream)

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

Parameters:

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

Returns

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

Method: can_load(stream, load_options) [static]

 can_load(stream, load_options)

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

Parameters:

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

Returns

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

Method: can_load_stream(stream) [static]

 can_load_stream(stream)

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

Parameters:

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

Returns

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

Method: can_load_stream_with_options(stream, load_options) [static]

 can_load_stream_with_options(stream, load_options)

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

Parameters:

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

Returns

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

Method: can_load_with_options(file_path, load_options) [static]

 can_load_with_options(file_path, load_options)

Parameters:

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

Returns

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

Method: can_save(options)

 can_save(options)

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

Parameters:

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

Returns

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

Method: create(files) [static]

 create(files)

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

Parameters:

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

Returns

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

Method: create(files, throw_exception_on_load_error) [static]

 create(files, throw_exception_on_load_error)

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

Parameters:

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

Returns

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

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

 create(image_options, width, height)

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

Parameters:

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

Returns

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

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

 create(image_options, width, height, pixels)

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

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

Parameters:

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

Returns

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

Method: create(images) [static]

 create(images)

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

Parameters:

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

Returns

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

Method: create(images, dispose_images) [static]

 create(images, dispose_images)

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

Parameters:

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

Returns

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

Method: create(multipage_create_options) [static]

 create(multipage_create_options)

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

Parameters:

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

Returns

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

Method: create_from_files(files) [static]

 create_from_files(files)

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

Parameters:

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

Returns

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

Method: create_from_files(files, throw_exception_on_load_error) [static]

 create_from_files(files, throw_exception_on_load_error)

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

Parameters:

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

Returns

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

Method: create_from_images(images) [static]

 create_from_images(images)

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

Parameters:

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

Returns

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

Method: create_from_images(images, dispose_images) [static]

 create_from_images(images, dispose_images)

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

Parameters:

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

Returns

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

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

 crop(left_shift, right_shift, top_shift, bottom_shift)

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

Parameters:

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

Method: crop(rectangle)

 crop(rectangle)

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

Parameters:

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

See also:

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

Method: dither(dithering_method, bits_count)

 dither(dithering_method, bits_count)

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

Parameters:

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

Method: dither(dithering_method, bits_count, custom_palette)

 dither(dithering_method, bits_count, custom_palette)

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

Parameters:

Параметр	Тип	Описание
dithering_method	DitheringMethod	Метод дизеринга.
bits_count	int	Окончательное количество бит для дизеринга.
custom_palette	IColorPalette	Пользовательская палитра для дизеринга.

Method: embed_digital_signature(password)

 embed_digital_signature(password)

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

Parameters:

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

Method: filter(rectangle, options)

 filter(rectangle, options)

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

Parameters:

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

Method: get_argb_32_pixel(x, y)

 get_argb_32_pixel(x, y)

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

Parameters:

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

Returns

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

Method: get_default_argb_32_pixels(rectangle)

 get_default_argb_32_pixels(rectangle)

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

Parameters:

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

Returns

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

Method: get_default_options(args)

 get_default_options(args)

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

Parameters:

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

Returns

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

Method: get_default_pixels(rectangle, partial_pixel_loader)

 get_default_pixels(rectangle, partial_pixel_loader)

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

Parameters:

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

Method: get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings)

 get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings)

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

Parameters:

Параметр	Тип	Описание
rectangle	Rectangle	Прямоугольник, для которого получаются пиксели.
partial_raw_data_loader	IPartialRawDataLoader	Частичный загрузчик необработанных данных.
raw_data_settings	RawDataSettings	Настройки необработанных данных.

Method: get_default_raw_data(rectangle, raw_data_settings)

 get_default_raw_data(rectangle, raw_data_settings)

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

Parameters:

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

Returns

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

Method: get_file_format(file_path) [static]

 get_file_format(file_path)

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

Parameters:

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

Returns

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

Method: get_file_format(stream) [static]

 get_file_format(stream)

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

Parameters:

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

Returns

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

Method: get_file_format_of_stream(stream) [static]

 get_file_format_of_stream(stream)

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

Parameters:

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

Returns

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

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

 get_fitting_rectangle(rectangle, pixels, width, height)

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

Parameters:

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

Returns

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

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

 get_fitting_rectangle(rectangle, width, height)

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

Parameters:

Параметр	Тип	Описание
rectangle	Rectangle	Прямоугольник, для которого определяется подходящий прямоугольник.
width	int	Ширина объекта.
height	int	Высота объекта.

Returns

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

Method: get_modify_date(use_default)

 get_modify_date(use_default)

Получает дату и время последнего изменения ресурса изображения.

Parameters:

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

Returns

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

Method: get_original_options()

 get_original_options()

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

Returns

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

Method: get_pixel(x, y)

 get_pixel(x, y)

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

Parameters:

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

Returns

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

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

 get_proportional_height(width, height, new_width)

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

Parameters:

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

Returns

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

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

 get_proportional_width(width, height, new_height)

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

Parameters:

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

Returns

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

Method: get_serialized_stream(image_options, clipping_rectangle, page_number)

 get_serialized_stream(image_options, clipping_rectangle, page_number)

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

Parameters:

Параметр	Тип	Описание
image_options	ImageOptionsBase	Параметры изображения.
clipping_rectangle	Rectangle	Прямоугольник обрезки.
page_number	int[]	Номер страницы.

Returns

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

Method: get_skew_angle()

 get_skew_angle()

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

Returns

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

Method: insert_block(index, block)

 insert_block(index, block)

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

Parameters:

Параметр	Тип	Описание
index	int	Элемент с нулевой индексацией, в котором будет вставлен блок.
block	IGifBlock	Блок GIF для добавления.

Method: is_digital_signed(password, percentage_threshold)

 is_digital_signed(password, percentage_threshold)

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

Parameters:

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

Returns

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

Method: load(file_path) [static]

 load(file_path)

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

Parameters:

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

Returns

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

Method: load(file_path, load_options) [static]

 load(file_path, load_options)

Parameters:

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

Returns

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

Method: load(stream) [static]

 load(stream)

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

Parameters:

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

Returns

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

Method: load(stream, load_options) [static]

 load(stream, load_options)

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

Parameters:

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

Returns

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

Method: load_argb_32_pixels(rectangle)

 load_argb_32_pixels(rectangle)

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

Parameters:

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

Returns

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

Method: load_argb_64_pixels(rectangle)

 load_argb_64_pixels(rectangle)

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

Parameters:

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

Returns

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

Method: load_cmyk_32_pixels(rectangle)

 load_cmyk_32_pixels(rectangle)

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

Parameters:

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

Returns

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

Method: load_cmyk_pixels(rectangle)

 load_cmyk_pixels(rectangle)

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

Parameters:

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

Returns

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

Method: load_partial_argb_32_pixels(rectangle, partial_pixel_loader)

 load_partial_argb_32_pixels(rectangle, partial_pixel_loader)

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

Parameters:

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

Method: load_partial_argb_64_pixels(rectangle, partial_pixel_loader)

 load_partial_argb_64_pixels(rectangle, partial_pixel_loader)

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

Parameters:

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

Method: load_partial_pixels(desired_rectangle, pixel_loader)

 load_partial_pixels(desired_rectangle, pixel_loader)

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

Parameters:

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

Method: load_pixels(rectangle)

 load_pixels(rectangle)

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

Parameters:

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

Returns

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

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

 load_raw_data(rectangle, dest_image_bounds, raw_data_settings, raw_data_loader)

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

Parameters:

Параметр	Тип	Описание
rectangle	Rectangle	Прямоугольник, из которого загружать необработанные данные.
dest_image_bounds	Rectangle	Границы целевого изображения.
raw_data_settings	RawDataSettings	Настройки необработанных данных, используемые для загруженных данных. Обратите внимание, что если данные не в указанном формате, будет выполнено их преобразование.
raw_data_loader	IPartialRawDataLoader	Загрузчик необработанных данных.

Method: load_raw_data(rectangle, raw_data_settings, raw_data_loader)

 load_raw_data(rectangle, raw_data_settings, raw_data_loader)

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

Parameters:

Параметр	Тип	Описание
rectangle	Rectangle	Прямоугольник, из которого загружать необработанные данные.
raw_data_settings	RawDataSettings	Настройки необработанных данных, используемые для загруженных данных. Обратите внимание, что если данные не в указанном формате, будет выполнено их преобразование.
raw_data_loader	IPartialRawDataLoader	Загрузчик необработанных данных.

Method: load_stream(stream) [static]

 load_stream(stream)

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

Parameters:

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

Returns

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

Method: load_stream_with_options(stream, load_options) [static]

 load_stream_with_options(stream, load_options)

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

Parameters:

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

Returns

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

Method: load_with_options(file_path, load_options) [static]

 load_with_options(file_path, load_options)

Parameters:

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

Returns

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

Method: normalize_angle(resize_proportionally, background_color)

 normalize_angle(resize_proportionally, background_color)

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

Parameters:

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

Method: read_argb_32_scan_line(scan_line_index)

 read_argb_32_scan_line(scan_line_index)

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

Parameters:

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

Returns

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

Method: read_scan_line(scan_line_index)

 read_scan_line(scan_line_index)

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

Parameters:

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

Returns

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

Method: remove_block(block)

 remove_block(block)

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

Parameters:

Параметр	Тип	Описание
block	IGifBlock	Блок для удаления.

Method: replace_argb(old_color_argb, old_color_diff, new_color_argb)

 replace_argb(old_color_argb, old_color_diff, new_color_argb)

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

Parameters:

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

Method: replace_color(old_color, old_color_diff, new_color)

 replace_color(old_color, old_color_diff, new_color)

Parameters:

Параметр	Тип	Описание
old_color	Color
old_color_diff	System.Byte	Допустимая разница в старом цвете, позволяющая расширить заменённый тон цвета.
new_color	Color

Method: replace_color(old_color_argb, old_color_diff, new_color_argb)

 replace_color(old_color_argb, old_color_diff, new_color_argb)

Parameters:

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

Method: replace_non_transparent_colors(new_color)

 replace_non_transparent_colors(new_color)

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

Parameters:

Параметр	Тип	Описание
new_color	Color

Method: replace_non_transparent_colors(new_color_argb)

 replace_non_transparent_colors(new_color_argb)

Parameters:

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

Method: resize(new_width, new_height)

 resize(new_width, new_height)

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

Parameters:

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

Method: resize(new_width, new_height, resize_type)

 resize(new_width, new_height, resize_type)

Изменяет размер этого экземпляра Image.

Parameters:

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

Method: resize(new_width, new_height, settings)

 resize(new_width, new_height, settings)

Изменяет размер этого экземпляра Image.

Parameters:

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

Method: resize_by_settings(new_width, new_height, settings)

 resize_by_settings(new_width, new_height, settings)

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

Parameters:

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

Method: resize_by_type(new_width, new_height, resize_type)

 resize_by_type(new_width, new_height, resize_type)

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

Parameters:

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

Method: resize_full_frame(new_width, new_height, resize_type)

 resize_full_frame(new_width, new_height, resize_type)

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

Parameters:

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

Method: resize_height_proportionally(new_height)

 resize_height_proportionally(new_height)

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

Parameters:

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

Method: resize_height_proportionally(new_height, resize_type)

 resize_height_proportionally(new_height, resize_type)

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

Parameters:

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

Method: resize_height_proportionally(new_height, settings)

 resize_height_proportionally(new_height, settings)

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

Parameters:

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

Method: resize_height_proportionally_settings(new_height, settings)

 resize_height_proportionally_settings(new_height, settings)

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

Parameters:

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

Method: resize_proportional(new_width, new_height, resize_type)

 resize_proportional(new_width, new_height, resize_type)

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

Parameters:

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

Method: resize_width_proportionally(new_width)

 resize_width_proportionally(new_width)

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

Parameters:

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

Method: resize_width_proportionally(new_width, resize_type)

 resize_width_proportionally(new_width, resize_type)

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

Parameters:

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

Method: resize_width_proportionally(new_width, settings)

 resize_width_proportionally(new_width, settings)

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

Parameters:

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

Method: resize_width_proportionally_settings(new_width, settings)

 resize_width_proportionally_settings(new_width, settings)

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

Parameters:

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

Method: rotate(angle)

 rotate(angle)

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

Parameters:

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

Method: rotate(angle, resize_proportionally, background_color)

 rotate(angle, resize_proportionally, background_color)

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

Parameters:

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

Method: rotate_flip(rotate_flip_type)

 rotate_flip(rotate_flip_type)

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

Parameters:

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

See also:

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

Method: rotate_flip_all(rotate_flip)

 rotate_flip_all(rotate_flip)

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

Parameters:

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

Method: save(file_path)

 save(file_path)

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

Parameters:

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

Method: save(file_path, options)

 save(file_path, options)

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

Parameters:

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

Method: save(file_path, options, bounds_rectangle)

 save(file_path, options, bounds_rectangle)

Parameters:

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

Method: save(file_path, over_write)

 save(file_path, over_write)

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

Parameters:

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

Method: save(stream)

 save(stream)

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

Parameters:

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

Method: save(stream, options_base)

 save(stream, options_base)

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

Parameters:

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

Method: save(stream, options_base, bounds_rectangle)

 save(stream, options_base, bounds_rectangle)

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

Parameters:

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

Method: save_argb_32_pixels(rectangle, pixels)

 save_argb_32_pixels(rectangle, pixels)

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

Parameters:

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

Method: save_cmyk_32_pixels(rectangle, pixels)

 save_cmyk_32_pixels(rectangle, pixels)

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

Parameters:

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

Method: save_cmyk_pixels(rectangle, pixels)

 save_cmyk_pixels(rectangle, pixels)

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

Parameters:

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

Method: save_pixels(rectangle, pixels)

 save_pixels(rectangle, pixels)

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

Parameters:

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

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

 save_raw_data(data, data_offset, rectangle, raw_data_settings)

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

Parameters:

Параметр	Тип	Описание
данные	System.Byte	The raw data.
data_offset	int	The starting raw data offset.
rectangle	Rectangle	The raw data rectangle.
raw_data_settings	RawDataSettings	Настройки необработанных данных, в которых находятся данные.

Method: save_to_stream(stream)

 save_to_stream(stream)

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

Parameters:

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

Method: save_to_stream_with_options(stream, options_base)

 save_to_stream_with_options(stream, options_base)

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

Parameters:

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

Method: save_to_stream_with_options_rect(stream, options_base, bounds_rectangle)

 save_to_stream_with_options_rect(stream, options_base, bounds_rectangle)

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

Parameters:

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

Method: save_with_options(file_path, options)

 save_with_options(file_path, options)

Parameters:

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

Method: save_with_options_rect(file_path, options, bounds_rectangle)

 save_with_options_rect(file_path, options, bounds_rectangle)

Parameters:

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

Method: set_argb_32_pixel(x, y, argb_32_color)

 set_argb_32_pixel(x, y, argb_32_color)

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

Parameters:

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

Method: set_frame_time(time)

 set_frame_time(time)

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

Parameters:

Параметр	Тип	Описание
время	int	Время длительности кадра в миллисекундах.

Method: set_palette(palette, update_colors)

 set_palette(palette, update_colors)

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

Parameters:

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

Method: set_pixel(x, y, color)

 set_pixel(x, y, color)

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

Parameters:

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

Method: set_resolution(dpi_x, dpi_y)

 set_resolution(dpi_x, dpi_y)

Устанавливает разрешение для этого RasterImage.

Parameters:

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

Method: try_set_metadata(metadata)

 try_set_metadata(metadata)

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

Parameters:

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

Returns

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

Method: write_argb_32_scan_line(scan_line_index, argb_32_pixels)

 write_argb_32_scan_line(scan_line_index, argb_32_pixels)

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

Parameters:

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

Method: write_scan_line(scan_line_index, pixels)

 write_scan_line(scan_line_index, pixels)

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

Parameters:

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

Examples

This example shows how to create a GIF image and save it to a file.

from aspose.imaging.fileformats.gif.blocks import GifFrameBlock
from aspose.imaging.fileformats.gif import GifImage 
from aspose.imaging.brushes import SolidBrush
from aspose.imaging import Graphics, Color


# Создать блок кадра GIF размером 100×100 пикселей.
with GifFrameBlock(100, 100) as firstBlock:
	# Заполнить весь блок красным цветом.
	gr = Graphics(firstBlock)
	brush = SolidBrush(Color.red)
	gr.fill_rectangle(brush, firstBlock.bounds)

	with GifImage(firstBlock) as gifImage:
		gifImage.save("output.gif")

This example shows how to create a GIF image with a custom palette and save it to a file.

from aspose.imaging.fileformats.gif.blocks import GifFrameBlock
from aspose.imaging.fileformats.gif import GifImage 
from aspose.imaging.brushes import SolidBrush
from aspose.imaging import Graphics, Color, ColorPaletteHelper


# Создать блок кадра GIF размером 100×100 пикселей.
with GifFrameBlock(100, 100) as firstBlock:
	# Заполнить весь блок красным цветом.
	gr = Graphics(firstBlock)
	brush = SolidBrush(Color.red)
	gr.fill_rectangle(brush, firstBlock.bounds)

	# Использовать 4-битную палитру для уменьшения размера изображения. Качество может ухудшиться.
	palette = ColorPaletteHelper.create_4_bit()

	with GifImage(firstBlock, palette) as gifImage:
		gifImage.save("output.gif")

The following example shows how to compose an animated GIF image from individual GIF blocks.

from aspose.imaging.fileformats.gif.blocks import GifFrameBlock
from aspose.imaging.fileformats.gif import GifImage 
from aspose.imaging.brushes import SolidBrush
from aspose.imaging import Graphics, Color

# Создать GIF‑изображение 100 × 100 px.
# Первый блок по умолчанию полностью чёрный.
with GifFrameBlock(100, 100) as firstBlock:
	with GifImage(firstBlock) as gifImage:
		# Первый круг красный
		brush1 = SolidBrush(Color.red)

		# Второй круг чёрный
		brush2 = SolidBrush(Color.black)

		# Постепенно увеличивать угол красной дуги.
		for angle in range(10, 361, 10):
			block = GifFrameBlock(100, 100)
			gr = Graphics(block)
			gr.fill_pie(brush1, block.bounds, 0, angle)
			gifImage.add_block(block)
		
		# Постепенно увеличивать угол чёрной дуги и стирать красную дугу.
		for angle in range(10, 361, 10):
			block = GifFrameBlock(100, 100)
			gr = Graphics(block)
			gr.fill_pie(brush2, block.bounds, 0, angle)
			gr.fill_pie(brush1, block.bounds, angle, 360 - angle)
			gifImage.add_block(block)

		gifImage.save("animated_radar.gif")

The following example shows how to remove all blocks from a GIF image.

from aspose.imaging.fileformats.gif.blocks import GifFrameBlock
from aspose.imaging.fileformats.gif import GifImage 

# Создать GIF‑изображение 100 × 100 px.
# Первый блок по умолчанию полностью чёрный.
with GifFrameBlock(100, 100) as firstBlock:
	with GifImage(firstBlock) as gifImage:
		if gifImage.active_frame is not None:
			print(f"Active frame size: {gifImage.active_frame.size}")
		else:
			print("Active frame is not set")

		print("Clear all the blocks")
		gifImage.clear_blocks()

		if gifImage.active_frame is not None:
			print(f"Active frame size: {gifImage.active_frame.size}")
		else:
			print("Active frame is not set")

# Вывод выглядит так:
# Размер активного кадра: { Width = 100, Height = 100}
# Очистить все блоки
# Активный кадр не установлен

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

The following example crops a GIF 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.gif import GifImage
from os.path import join

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

The following example binarizes a GIF 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.gif import GifImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

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

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

import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.gif import GifImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

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

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


import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.gif import GifImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

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

The following example performs brightness correction of a GIF image.


import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.gif import GifImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

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

The following example performs contrast correction of a GIF image.



import aspose.pycore as aspycore

from aspose.imaging import Image

from aspose.imaging.fileformats.gif import GifImage

from aspose.imaging.imageoptions import PngOptions

from os.path import join



dir_ = "c:\\temp"

with Image.load(join(dir_, "sample.gif")) as image:

	gif_image = aspycore.as_of(image, GifImage)

	# Установить значение контрастности. Допустимые значения контрастности находятся в диапазоне [-100f, 100f].

	gif_image.adjust_contrast(50.0)

	gif_image.save(join(dir_, "sample.AdjustContrast.png"), PngOptions())



# ExEnd

Create multipage GIF image using single page raster images.

from aspose.imaging import Image, RasterImage
from aspose.pycore import as_of
from os import listdir
from os.path import isfile, join

def load_frames(directory):
	for f in listdir(directory):
		full_path = join(directory, f)
		if isfile(full_path):
			yield as_of(Image.load(file_path), RasterImage)


# Загрузить кадры
frames = list(load_frames("Animation frames"))
# Создать GIF‑изображение, используя первый кадр
with GifImage(GifFrameBlock(frames[0])) as image:
	# Добавить кадры в GIF‑изображение с помощью метода AddPage
	for index in range(1, len(frames)):
		image.add_page(frames[index])

	# Сохранить GIF‑изображение
	image.save("Multipage.gif")
	
for it in frames:
	with it as _:
		# освободить изображения
		pass

Export of part of animation from GIF image based on time interval.

from aspose.imaging import Image
from aspose.imaging.imageoptions import GifOptions, MultiPageOptions, MultiPageMode, TimeInterval

with Image.load("Animation.gif") as image:
	obj_init = MultiPageOptions()
	obj_init.mode = MultiPageMode.TIME_INTERVAL
	obj_init.time_interval = TimeInterval(0, 400)
	options = GifOptions()
	options.full_frame = True
	options.multi_page_options = obj_init
	image.save("PartOfAnimation.gif", options)

GifBlocksRegistry Класс Класс IGifBlock