Класс TgaImage

Summary: Manipulate TGA raster image files with our API, tailored for the TARGA
(Truevision Advanced Raster Adapter) format, enabling seamless loading and
customization. Easily update public properties such as author, timestamp,
image ID, and software version, while using various bits per pixel settings,
alpha channel and color transparency. Additionally, you can export TGA images
to other popular raster formats, ensuring compatibility for your projects.

Module: aspose.imaging.fileformats.tga

Full Name: aspose.imaging.fileformats.tga.TgaImage

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

Constructors

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

Properties

NameTypeAccessDescription
author_commentsstringr/wПолучает или задает комментарии, предоставленные автором изображения. Эти комментарии
часто содержат ценную информацию, такую как описания, аннотации или
дополнительный контекст об изображении. Получая доступ к свойству Author Comments
или изменяя его, разработчики могут улучшить метаданные, связанные с изображением, предоставляя
пользователям ценные сведения и контекст относительно его содержания или создания.
Это ASCII‑поле, состоящее из 324 байт, организованных в четыре строки
по 80 символов, каждая из которых завершается нулевым терминатором.
author_namestringr/wПолучает или задает имя автора, связанное с изображением. Это свойство
позволяет разработчикам получать доступ к метаданным имени автора или изменять их, предоставляя
ценную информацию о создателе изображения. Используя свойство Author Name
, пользователи могут легко определить лицо, ответственное за создание или
вклад в изображение, улучшая общие метаданные и предоставляя ценный
контекст для зрителей.
Это поле состоит из 40 ASCII‑символов для имени. Если поле используется,
оно должно содержать имя человека, создавшего изображение (автор).
auto_adjust_paletteboolr/wПолучает или задает значение, указывающее, следует ли автоматически корректировать палитру.
background_colorColorr/wПолучает или задает цвет фона изображения. Это свойство позволяет
указать цвет, используемый для фона изображения, обеспечивая согласованность и
улучшая визуальное представление. Оно особенно полезно в сценариях, когда
изображение отображается на фоне другого цвета или при рендеринге
изображения на другом холсте.
bits_per_pixelintrПолучите значение бит на пиксель, предоставляющее важную информацию о
глубине цвета изображения. Это свойство служит ключевым показателем для понимания
уровня детализации и насыщенности цветов в изображении, помогая разработчикам
оптимизировать алгоритмы обработки и распределение ресурсов для эффективного
манипулирования и рендеринга изображений.
boundsRectanglerПолучает границы объекта.
buffer_size_hintintr/wПолучает или задает подсказку о размере буфера, определяющую максимальный допустимый размер для всех внутренних буферов.
bytes_per_pixelintrПолучите значение байт на пиксель, которое обозначает объём памяти, занимаемый
каждым пикселем изображения. Это свойство служит важным показателем для управления
памятью и оптимизации, помогая разработчикам эффективно распределять ресурсы
и обрабатывать данные изображения.
containerImagerПолучает контейнер Image.
data_stream_containerStreamContainerrПолучает поток данных объекта.
date_time_stampSystem.Nullable`1[[System.DateTime]]r/wПолучает или задает метку даты/времени.
Это поле определяет значение даты и времени, когда изображение было сохранено.
Хотя операционные системы обычно ставят временные и датированные метки на файлы, эта возможность
предоставлена, потому что ОС может изменить метку даты и времени при копировании файла.
Используя эту область, вы получаете гарантированный неизменный регион для записи даты и времени.
disposedboolrПолучает значение, указывающее, удалён ли этот экземпляр.
exif_dataExifDatar/wПолучает или задаёт экземпляр Exif.
file_formatFileFormatrПолучите важную информацию о формате файла изображения, представленного этим
экземпляром TgaImage. Понимание формата файла необходимо для
проверки совместимости и обеспечения беспрепятственной интеграции в программных системах,
позволяя эффективно обрабатывать и манипулировать изображениями.
gamma_value_denominatorintrПолучает знаменатель значения гаммы, являющийся важным фактором при
определении цветового представления в изображениях. Для изображений без коррекции гаммы это значение должно быть 1.0, обеспечивая точную цветовую визуализацию.
Понимание и использование этого параметра является фундаментом для поддержания цветовой
достоверности и достижения точной визуализации изображения.
gamma_value_numeratorintrПолучает числитель значения гаммы, который необходим для точного цветового
представления в изображениях. В изображениях без коррекции гаммы это значение должно быть
1.0. Понимание и использование этого значения критически важно для поддержания цветовой
достоверности и обеспечения точного рендеринга изображения.
has_alphaboolrПолучите логическое значение, указывающее, содержит ли TgaImage альфа‑канал, позволяющий реализовать эффекты прозрачности. Это свойство предоставляет важную
информацию для обработки композиции и рендеринга изображений, помогая разработчикам
внедрять разнообразные визуальные эффекты и операции композитинга.
has_background_colorboolr/wПолучает или задает значение, указывающее, содержит ли изображение фоновый
цвет. Это свойство полезно для определения, включает ли изображение отдельный фоновый цвет, отличающийся от переднего плана. Оно позволяет
настраивать обработку или рендеринг изображения в зависимости от наличия или отсутствия
фонового цвета.
has_color_mapboolrПолучите информацию о том, содержит ли данный экземпляр TgaImage цветовую карту.
Понимание наличия цветовой карты критически важно для точной интерпретации
и манипуляции цветовыми данными изображения.
has_transparent_colorboolr/wПолучает или задает логическое значение, указывающее, содержит ли изображение
прозрачный цвет. Это свойство необходимо для определения, поддерживает ли изображение
прозрачность, помогая вам реализовать соответствующую обработку операций, связанных с прозрачностью, таких как наложение, композитинг или маскирование.
heightintrПолучите высоту изображения, инкапсулированного в этом экземпляре TgaImage
. Это свойство предоставляет разработчикам критически важную информацию о
вертикальных размерах изображения, обеспечивая бесшовную интеграцию и манипуляцию
изображениями в их программных решениях.
horizontal_resolutionfloatr/wПолучает или задает горизонтальное разрешение в пикселях на дюйм для этого RasterImage.
image_idstringr/wПолучает или задает уникальный идентификатор, связанный с изображением. Этот ID служит
точкой отсчёта для идентификации и различения изображения от других в рамках
системы или приложения. Устанавливая или получая Image ID, вы можете эффективно управлять и
отслеживать изображения, облегчая организованное управление и извлечение изображений
процессов.

Это необязательное поле содержит идентифицирующую информацию об изображении. Максимальная длина
этого поля — 255 байт.
image_opacityfloatrПолучает непрозрачность этого изображения.
interrupt_monitorInterruptMonitorr/wПолучает или задает монитор прерываний.
is_cachedboolrПолучает значение, указывающее, кэшируются ли данные изображения в данный момент.
is_gray_scaleboolrПолучите логическое значение, указывающее, представляет ли TgaImage изображение в градациях серого. Это свойство имеет решающее значение для различения цветных и
изображений в градациях серого, помогая разработчикам применять соответствующие методы обработки и
рендеринга в зависимости от цветовых характеристик изображения.
is_raw_data_availableboolrПолучает значение, указывающее, поддерживается ли загрузка необработанных данных.
job_name_or_idstringr/wПолучает или задает название задания или его ID, связанные с изображением. Это свойство
позволяет вам получать или изменять метаданные, относящиеся к конкретному заданию или проекту,
связанному с изображением. Используя свойство Job Name/ID, пользователи могут легко
определить проект или задачу, к которым относится изображение, облегчая
организацию и управление ресурсами изображений в рамках более крупных рабочих процессов или проектов.
job_timeSystem.Nullable`1[[System.TimeSpan]]r/wПолучает или задает метку времени, указывающую время задания, связанное с изображением.
Это свойство позволяет разработчикам получать или изменять метаданные времени, относящиеся к
конкретному заданию или проекту, связанному с изображением.
metadataImageMetadatarПолучает метаданные изображения.
paletteIColorPaletter/wПолучает или задает цветовую палитру. Цветовая палитра не используется, когда пиксели представлены напрямую.
pixel_aspect_ratio_denominatorintrПолучает знаменатель отношения сторон пикселя (Pixel Aspect Ratio), критически важный фактор при
определении визуального вида пикселей в изображении. Это значение необходимо
для сохранения точного представления пикселей и соотношений сторон во всех различных
операциях рендеринга и обработки изображений, обеспечивая высококачественный визуальный результат.
pixel_aspect_ratio_numeratorintrПолучает числитель отношения сторон пикселя (Pixel Aspect Ratio), который влияет на
визуальный вид пикселей в изображении. Понимание и управление этим
значением необходимо для достижения точного представления пикселей и соотношений сторон
при рендеринге и обработке изображений.
premultiply_componentsboolr/wПолучает или задает значение, указывающее, должны ли компоненты изображения быть предварительно умножены.
raw_custom_color_converterIColorConverterr/wПолучает или задает пользовательский конвертер цветов
raw_data_formatPixelDataFormatrПолучает формат необработанных данных.
raw_data_settingsRawDataSettingsrПолучает текущие настройки необработанных данных. Обратите внимание, что при использовании этих настроек данные загружаются без конвертации.
raw_fallback_indexintr/wПолучает или задает резервный индекс, используемый, когда индекс палитры выходит за пределы.
raw_indexed_color_converterIIndexedColorConverterr/wПолучает или задает индексированный конвертер цветов
raw_line_sizeintrПолучает размер необработанной строки в байтах.
sizeSizerПолучает размер объекта.
software_idstringr/wУправляет идентификацией программного обеспечения (ID), связанной с изображением, позволяя использовать
до 40 символов ASCII. Это свойство служит средством уникальной идентификации
программного обеспечения, использованного при создании или обработке изображения, предоставляя ценную
метаинформацию для организационных и информационных целей.
software_versionstringr/wПолучает или задает версию программного обеспечения, связанную с изображением. Приемлемая
длина строки версии обычно составляет от 3 до 4 символов. Это свойство
полезно для отслеживания программного обеспечения, использованного при создании или обработке изображения, и может
предоставить ценный контекст для обработки изображений и проверки совместимости.
software_version_letterSystem.Charr/wПолучает или задает буквенную часть версии программного обеспечения, связанной с
изображением. Это свойство представляет дополнительную деталь в строке версии программного обеспечения
и может быть полезным для более точного различения версий.
software_version_numberintr/wПолучает или задает числовую часть версии программного обеспечения, связанной с
изображением. Это свойство представляет числовую часть строки версии программного обеспечения
и предоставляет важную информацию о версии программного обеспечения, использованного для
создания или изменения изображения.
transparent_colorColorr/wПолучает или задает ключевой цвет, связанный с изображением. Это свойство позволяет
вам получать или изменять цвет, назначенный в качестве ключевого цвета для конкретных задач
обработки изображений или эффектов. Использование свойства Key Color позволяет пользователям
применять операции, основанные на цвете, такие как хромакей или замена цвета, расширяя
возможности манипуляции изображениями и творческие возможности.

Ключевой цвет можно рассматривать как ‘цвет фона’ или ‘прозрачный цвет’.
Это цвет области экрана, не содержащей изображение, и тот же цвет, которым
экран будет очищен, если его стереть в приложении.
update_xmp_databoolr/wПолучает или задает значение, указывающее, следует ли обновлять метаданные XMP.
use_paletteboolrПолучает значение, указывающее, используется ли палитра изображения.
use_raw_databoolr/wПолучает или задает значение, указывающее, следует ли использовать загрузку необработанных данных, когда такая загрузка доступна.
vertical_resolutionfloatr/wПолучает или задает вертикальное разрешение в пикселях на дюйм для этого RasterImage.
widthintrПолучите ширину изображения, представленного этим экземпляром TgaImage
. Это свойство предоставляет разработчикам важную информацию о
размерах изображения, облегчая различные задачи манипуляции и обработки изображений
в их программных приложениях.
x_originintr/wПолучает или задает абсолютную горизонтальную координату нижнего левого угла изображения
как оно размещено на дисплейном устройстве с началом координат в нижнем левом углу
экрана (например, серия TARGA).
xmp_dataXmpPacketWrapperr/wПолучает или задает данные Xmp.
y_originintr/wПолучает или задает абсолютную вертикальную координату нижнего левого угла изображения
как оно размещено на дисплейном устройстве с началом координат в нижнем левом углу
экрана (например, серия TARGA).

Methods

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

Проверяет, что указанные ширина и высота соответствуют размерам пиксельных данных.
Этот метод может использоваться только в лицензированном режиме библиотеки.
create(images)Создаёт новое изображение, используя указанные изображения в качестве страниц
create(images, dispose_images)Создает новое изображение из указанных изображений в виде страниц.
create(multipage_create_options)Создает указанные параметры создания многостраничного изображения.
create_from_files(files)Создает многостраничное изображение, содержащее указанные файлы в виде страниц с отложенной загрузкой.
create_from_files(files, throw_exception_on_load_error)Создает многостраничное изображение, содержащее указанные файлы в виде страниц с отложенной загрузкой.
create_from_image(raster_image)Инициализирует новый экземпляр класса TgaImage.
create_from_images(images)Создаёт новое изображение, используя указанные изображения в качестве страниц
create_from_images(images, dispose_images)Создает новое изображение из указанных изображений в виде страниц.
create_from_stream(stream)Инициализирует новый экземпляр класса TgaImage.
crop(left_shift, right_shift, top_shift, bottom_shift)Обрезайте изображение, указывая сдвиги для левой, правой, верхней и нижней
границ. Этот метод позволяет обрезать изображение, перемещая его границы
независимо по горизонтальной и вертикальной осям. Регулируя эти сдвиги,
вы можете точно контролировать, какие части изображения сохранять, эффективно
обрезая его до требуемых размеров.
crop(rectangle)Обрезайте изображение до указанного региона. Этот метод позволяет определить
прямоугольную область внутри изображения, которую следует сохранить, отбрасывая остальное. Эта операция
полезна для фокусировки на конкретном содержимом изображения или удаления нежелательных
частей.
dither(dithering_method, bits_count)Выполняет дизеринг текущего изображения.
dither(dithering_method, bits_count, custom_palette)Выполняет дизеринг текущего изображения.
embed_digital_signature(password)Встроить цифровую подпись, основанную на предоставленном пароле, в изображение с помощью стеганографии.
filter(rectangle, options)Фильтрует указанный прямоугольник.
get_argb_32_pixel(x, y)Получает 32-битный ARGB‑пиксель изображения.
get_default_argb_32_pixels(rectangle)Получает массив пикселей по умолчанию в формате 32‑бит ARGB.
get_default_options(args)Получает параметры по умолчанию.
get_default_pixels(rectangle, partial_pixel_loader)Получает массив пикселей по умолчанию с использованием частичного загрузчика пикселей.
get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings)Получает массив необработанных данных по умолчанию с использованием частичного загрузчика пикселей.
get_default_raw_data(rectangle, raw_data_settings)Получает массив необработанных данных по умолчанию.
get_file_format(file_path)Получает формат файла.
get_file_format(stream)Получает формат файла.
get_file_format_of_stream(stream)Получает формат файла.
get_fitting_rectangle(rectangle, pixels, width, height)Получает прямоугольник, соответствующий текущему изображению.
get_fitting_rectangle(rectangle, width, height)Получает прямоугольник, соответствующий текущему изображению.
get_modify_date(use_default)Получает дату и время последнего изменения ресурса изображения.
get_original_options()Получает параметры на основе настроек оригинального файла.
Это может быть полезно для сохранения глубины цвета и других параметров оригинального изображения без изменений.
Например, если мы загружаем черно‑белое PNG‑изображение с 1 битом на пиксель и затем сохраняем его с помощью
DataStreamSupporter.save(file_path) метода, будет получено PNG‑изображение с 8‑битами на пиксель.
Чтобы избежать этого и сохранить PNG‑изображение с 1‑битом на пиксель, используйте этот метод для получения соответствующих параметров сохранения и передайте их
в метод Image.save(file_path, options) в качестве второго параметра.
get_pixel(x, y)Получает пиксель изображения.
get_proportional_height(width, height, new_width)Получает пропорциональную высоту.
get_proportional_width(width, height, new_height)Получает пропорциональную ширину.
get_serialized_stream(image_options, clipping_rectangle, page_number)Преобразует в aps.
get_skew_angle()Получает угол наклона.
Этот метод применим к отсканированным текстовым документам для определения угла наклона при сканировании.
grayscale()Преобразование изображения в его градации серого
is_digital_signed(password, percentage_threshold)Выполняет быструю проверку, чтобы определить, подписано ли изображение цифровой подписью, используя предоставленный пароль и пороговое значение.
load(file_path)Загружает новое изображение из указанного пути к файлу или URL.
Если filePath — путь к файлу, метод просто открывает файл.
Если filePath — URL, метод загружает файл, сохраняет его как временный и открывает.
load(file_path, load_options)Загружает новое изображение из указанного пути к файлу или URL.
Если filePath — путь к файлу, метод просто открывает файл.
Если filePath — URL, метод загружает файл, сохраняет его как временный и открывает.
load(stream)Загружает новое изображение из указанного потока.
load(stream, load_options)Загружает новое изображение из указанного потока.
load_argb_32_pixels(rectangle)Загружает 32‑битные ARGB‑пиксели.
load_argb_64_pixels(rectangle)Загружает 64‑битные ARGB‑пиксели.
load_cmyk_32_pixels(rectangle)Загружает пиксели в формате CMYK.
load_cmyk_pixels(rectangle)Загружает пиксели в формате CMYK.
Этот метод устарел. Пожалуйста, используйте более эффективный метод RasterImage.load_cmyk_32_pixels(rectangle).
load_partial_argb_32_pixels(rectangle, partial_pixel_loader)Частично загружает 32‑битные ARGB‑пиксели (по блокам).
load_partial_argb_64_pixels(rectangle, partial_pixel_loader)Частично загружает 64‑битные ARGB‑пиксели пакетами.
load_partial_pixels(desired_rectangle, pixel_loader)Частично загружает пиксели пакетами.
load_pixels(rectangle)Загружает пиксели.
load_raw_data(rectangle, dest_image_bounds, raw_data_settings, raw_data_loader)Загружает необработанные данные.
load_raw_data(rectangle, raw_data_settings, raw_data_loader)Загружает необработанные данные.
load_stream(stream)Загружает новое изображение из указанного потока.
load_stream_with_options(stream, load_options)Загружает новое изображение из указанного потока.
load_with_options(file_path, load_options)Загружает новое изображение из указанного пути к файлу или URL.
Если filePath — путь к файлу, метод просто открывает файл.
Если filePath — URL, метод загружает файл, сохраняет его как временный и открывает.
normalize_angle()Нормализует угол.
Этот метод применим к отсканированным текстовым документам для устранения наклона сканирования.
Метод использует функции RasterImage.get_skew_angle() и RasterImage.rotate(angle).
normalize_angle(resize_proportionally, background_color)Нормализует угол.
Этот метод применим к отсканированным текстовым документам, чтобы избавиться от наклона скана.
Этот метод использует методы RasterImage.get_skew_angle() и RasterImage.rotate(angle, resize_proportionally, background_color).
normalize_histogram()Нормализует гистограмму изображения — корректирует значения пикселей, чтобы использовать весь доступный диапазон.
read_argb_32_scan_line(scan_line_index)Считывает всю строку сканирования по указанному индексу строки сканирования.
read_scan_line(scan_line_index)Считывает всю строку сканирования по указанному индексу строки сканирования.
remove_metadata()Удаляет метаданные этого экземпляра изображения, устанавливая значение IHasXmpData.xmp_data в None.
replace_argb(old_color_argb, old_color_diff, new_color_argb)Заменяет один цвет другим с допустимой разницей и сохраняет исходное альфа‑значение для сохранения плавных краёв.
replace_color(old_color, old_color_diff, new_color)Заменяет один цвет другим с допустимой разницей и сохраняет исходное альфа‑значение для сохранения плавных краёв.
replace_color(old_color_argb, old_color_diff, new_color_argb)Заменяет один цвет другим с допустимой разницей и сохраняет исходное альфа‑значение для сохранения плавных краёв.
replace_non_transparent_colors(new_color)Заменяет все непрозрачные цвета новым цветом и сохраняет исходное значение альфа‑канала, чтобы сохранить плавные края.
Примечание: если использовать его на изображениях без прозрачности, все цвета будут заменены одним цветом.
replace_non_transparent_colors(new_color_argb)Заменяет все непрозрачные цвета новым цветом и сохраняет исходное значение альфа‑канала, чтобы сохранить плавные края.
Примечание: если использовать его на изображениях без прозрачности, все цвета будут заменены одним цветом.
resize(new_width, new_height)Изменяет размер изображения. По умолчанию используется ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.
resize(new_width, new_height, resize_type)Регулирует размер изображения, используя указанный тип изменения размера, который определяет, как
выполняется операция масштабирования. Этот метод обеспечивает гибкость при изменении размеров
изображений в соответствии с различными алгоритмами или техниками. Выбирая
подходящий тип изменения размера, вы можете достичь желаемого баланса между качеством изображения
и вычислительной эффективностью в зависимости от конкретных требований или предпочтений.
resize(new_width, new_height, settings)Изменяйте размер изображения, применяя определённые настройки для поддержания желаемых
размеров и соотношения сторон. Настраивая параметры изображения, вы можете эффективно
изменить размер изображения, обеспечивая оптимальное визуальное качество и совместимость с
различными дисплейными устройствами или приложениями.
resize_by_settings(new_width, new_height, settings)Изменяет размер изображения.
resize_by_type(new_width, new_height, resize_type)Изменяет размер изображения.
resize_height_proportionally(new_height)Пропорционально изменяет высоту. По умолчанию используется ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.
resize_height_proportionally(new_height, resize_type)Пропорционально изменяет высоту.
resize_height_proportionally(new_height, settings)Пропорционально изменяет высоту.
resize_height_proportionally_settings(new_height, settings)Пропорционально изменяет высоту.
resize_width_proportionally(new_width)Пропорционально изменяет ширину. По умолчанию используется ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.
resize_width_proportionally(new_width, resize_type)Пропорционально изменяет ширину.
resize_width_proportionally(new_width, settings)Пропорционально изменяет ширину.
resize_width_proportionally_settings(new_width, settings)Пропорционально изменяет ширину.
rotate(angle)Повернуть изображение вокруг центра.
rotate(angle, resize_proportionally, background_color)Поворачивает изображение вокруг его центра на указанный угол, сохраняя пропорциональность изменения размера
и сохраняет цвет фона. Этот метод позволяет точно манипулировать изображением, обеспечивая, что вращение сохраняет визуальный баланс
и согласованность с указанным цветом фона. Он идеален для задач, где требуется точное вращение вокруг центра, например, коррекция ориентации
или художественные корректировки.
rotate_flip(rotate_flip_type)Метод "RotateFlip" позволяет выполнять операции вращения и отражения изображения. Он
предоставляет универсальные возможности для управления ориентацией изображения, позволяя пользователям
выполнять вращения и отражения в соответствии с их требованиями, облегчая
эффективную обработку изображений в программных приложениях.
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: TgaImage(path)

 TgaImage(path) 

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

Parameters:

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

Constructor: TgaImage(raster_image)

 TgaImage(raster_image) 

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

Parameters:

ПараметрТипОписание
raster_imageRasterImageРастровое изображение.

See also:

Example # 1: Loading of the PNG image, conversion of it to the TgaImage and saving as a TG…

Constructor: TgaImage(stream)

 TgaImage(stream) 

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

Parameters:

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

Method: adjust_brightness(brightness)

 adjust_brightness(brightness) 

Регулировка яркости изображения.

Parameters:

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

Method: adjust_contrast(contrast)

 adjust_contrast(contrast) 

Контрастирование изображения

Parameters:

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

Method: adjust_gamma(gamma)

 adjust_gamma(gamma) 

Гамма‑коррекция изображения.

Parameters:

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

Method: adjust_gamma(gamma_red, gamma_green, gamma_blue)

 adjust_gamma(gamma_red, gamma_green, gamma_blue) 

Гамма‑коррекция изображения.

Parameters:

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

Method: analyze_percentage_digital_signature(password)

 analyze_percentage_digital_signature(password) 

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

Parameters:

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

Returns

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

Method: binarize_bradley(brightness_difference)

 binarize_bradley(brightness_difference) 

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

Parameters:

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

Method: binarize_bradley(brightness_difference, window_size)

 binarize_bradley(brightness_difference, window_size) 

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

Parameters:

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

Method: binarize_fixed(threshold)

 binarize_fixed(threshold) 

Бинаризация изображения с предопределённым порогом

Parameters:

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

Method: blend(origin, overlay, overlay_alpha)

 blend(origin, overlay, overlay_alpha) 

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

Parameters:

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

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

 blend(origin, overlay, overlay_area, overlay_alpha) 

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

Parameters:

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

Method: can_load(file_path) [static]

 can_load(file_path) 

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

Parameters:

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

Returns

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

Method: can_load(file_path, load_options) [static]

 can_load(file_path, load_options) 

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

Parameters:

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

Returns

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

Method: can_load(stream) [static]

 can_load(stream) 

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

Parameters:

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

Returns

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

Method: can_load(stream, load_options) [static]

 can_load(stream, load_options) 

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

Parameters:

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

Returns

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

Method: can_load_stream(stream) [static]

 can_load_stream(stream) 

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

Parameters:

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

Returns

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

Method: can_load_stream_with_options(stream, load_options) [static]

 can_load_stream_with_options(stream, load_options) 

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

Parameters:

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

Returns

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

Method: can_load_with_options(file_path, load_options) [static]

 can_load_with_options(file_path, load_options) 

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

Parameters:

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

Returns

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

Method: can_save(options)

 can_save(options) 

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

Parameters:

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

Returns

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

Method: clone()

 clone() 

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

Returns

ТипОписание
TgaImageВозвращает новый объект, являющийся копией текущего экземпляра.

Method: clone(tga_image)

 clone(tga_image) 

Копирует свойства другого объекта TgaImage, создавая
новый экземпляр с идентичными атрибутами. Эта операция обеспечивает сохранение
целостности данных и облегчает дублирование свойств изображения без
изменения исходного объекта.

Parameters:

ПараметрТипОписание
tga_imageTgaImageДругие TgaImage

Method: create(files) [static]

 create(files) 

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

Parameters:

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

Returns

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

Method: create(files, throw_exception_on_load_error) [static]

 create(files, throw_exception_on_load_error) 

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

Parameters:

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

Returns

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

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

 create(image_options, width, height) 

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

Parameters:

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

Returns

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

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

 create(image_options, width, height, pixels) 

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

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

Parameters:

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

Returns

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

Method: create(images) [static]

 create(images) 

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

Parameters:

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

Returns

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

Method: create(images, dispose_images) [static]

 create(images, dispose_images) 

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

Parameters:

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

Returns

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

Method: create(multipage_create_options) [static]

 create(multipage_create_options) 

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

Parameters:

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

Returns

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

Method: create_from_files(files) [static]

 create_from_files(files) 

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

Parameters:

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

Returns

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

Method: create_from_files(files, throw_exception_on_load_error) [static]

 create_from_files(files, throw_exception_on_load_error) 

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

Parameters:

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

Returns

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

Method: create_from_image(raster_image) [static]

 create_from_image(raster_image) 

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

Parameters:

ПараметрТипОписание
raster_imageRasterImageРастровое изображение.

Returns

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

Method: create_from_images(images) [static]

 create_from_images(images) 

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

Parameters:

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

Returns

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

Method: create_from_images(images, dispose_images) [static]

 create_from_images(images, dispose_images) 

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

Parameters:

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

Returns

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

Method: create_from_stream(stream) [static]

 create_from_stream(stream) 

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

Parameters:

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

Returns

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

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

 crop(left_shift, right_shift, top_shift, bottom_shift) 

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

Parameters:

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

Method: crop(rectangle)

 crop(rectangle) 

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

Parameters:

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

Method: dither(dithering_method, bits_count)

 dither(dithering_method, bits_count) 

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

Parameters:

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

Method: dither(dithering_method, bits_count, custom_palette)

 dither(dithering_method, bits_count, custom_palette) 

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

Parameters:

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

Method: embed_digital_signature(password)

 embed_digital_signature(password) 

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

Parameters:

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

Method: filter(rectangle, options)

 filter(rectangle, options) 

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

Parameters:

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

Method: get_argb_32_pixel(x, y)

 get_argb_32_pixel(x, y) 

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

Parameters:

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

Returns

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

Method: get_default_argb_32_pixels(rectangle)

 get_default_argb_32_pixels(rectangle) 

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

Parameters:

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

Returns

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

Method: get_default_options(args)

 get_default_options(args) 

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

Parameters:

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

Returns

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

Method: get_default_pixels(rectangle, partial_pixel_loader)

 get_default_pixels(rectangle, partial_pixel_loader) 

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

Parameters:

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

Method: get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings)

 get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings) 

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

Parameters:

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

Method: get_default_raw_data(rectangle, raw_data_settings)

 get_default_raw_data(rectangle, raw_data_settings) 

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

Parameters:

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

Returns

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

Method: get_file_format(file_path) [static]

 get_file_format(file_path) 

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

Parameters:

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

Returns

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

Method: get_file_format(stream) [static]

 get_file_format(stream) 

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

Parameters:

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

Returns

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

Method: get_file_format_of_stream(stream) [static]

 get_file_format_of_stream(stream) 

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

Parameters:

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

Returns

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

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

 get_fitting_rectangle(rectangle, pixels, width, height) 

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

Parameters:

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

Returns

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

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

 get_fitting_rectangle(rectangle, width, height) 

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

Parameters:

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

Returns

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

Method: get_modify_date(use_default)

 get_modify_date(use_default) 

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

Parameters:

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

Returns

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

Method: get_original_options()

 get_original_options() 

Получает параметры на основе настроек оригинального файла.
Это может быть полезно для сохранения глубины цвета и других параметров оригинального изображения без изменений.
Например, если мы загружаем черно‑белое 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) 

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

Parameters:

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

Returns

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

Method: load(stream, load_options) [static]

 load(stream, load_options) 

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

Parameters:

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

Returns

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

Method: load_argb_32_pixels(rectangle)

 load_argb_32_pixels(rectangle) 

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

Parameters:

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

Returns

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

Method: load_argb_64_pixels(rectangle)

 load_argb_64_pixels(rectangle) 

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

Parameters:

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

Returns

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

Method: load_cmyk_32_pixels(rectangle)

 load_cmyk_32_pixels(rectangle) 

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

Parameters:

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

Returns

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

Method: load_cmyk_pixels(rectangle)

 load_cmyk_pixels(rectangle) 

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

Parameters:

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

Returns

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

Method: load_partial_argb_32_pixels(rectangle, partial_pixel_loader)

 load_partial_argb_32_pixels(rectangle, partial_pixel_loader) 

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

Parameters:

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

Method: load_partial_argb_64_pixels(rectangle, partial_pixel_loader)

 load_partial_argb_64_pixels(rectangle, partial_pixel_loader) 

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

Parameters:

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

Method: load_partial_pixels(desired_rectangle, pixel_loader)

 load_partial_pixels(desired_rectangle, pixel_loader) 

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

Parameters:

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

Method: load_pixels(rectangle)

 load_pixels(rectangle) 

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

Parameters:

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

Returns

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

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

 load_raw_data(rectangle, dest_image_bounds, raw_data_settings, raw_data_loader) 

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

Parameters:

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

Method: load_raw_data(rectangle, raw_data_settings, raw_data_loader)

 load_raw_data(rectangle, raw_data_settings, raw_data_loader) 

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

Parameters:

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

Method: load_stream(stream) [static]

 load_stream(stream) 

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

Parameters:

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

Returns

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

Method: load_stream_with_options(stream, load_options) [static]

 load_stream_with_options(stream, load_options) 

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

Parameters:

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

Returns

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

Method: load_with_options(file_path, load_options) [static]

 load_with_options(file_path, load_options) 

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

Parameters:

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

Returns

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

Method: normalize_angle(resize_proportionally, background_color)

 normalize_angle(resize_proportionally, background_color) 

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

Parameters:

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

Method: read_argb_32_scan_line(scan_line_index)

 read_argb_32_scan_line(scan_line_index) 

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

Parameters:

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

Returns

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

Method: read_scan_line(scan_line_index)

 read_scan_line(scan_line_index) 

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

Parameters:

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

Returns

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

Method: replace_argb(old_color_argb, old_color_diff, new_color_argb)

 replace_argb(old_color_argb, old_color_diff, new_color_argb) 

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

Parameters:

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

Method: replace_color(old_color, old_color_diff, new_color)

 replace_color(old_color, old_color_diff, new_color) 

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

Parameters:

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

Method: replace_color(old_color_argb, old_color_diff, new_color_argb)

 replace_color(old_color_argb, old_color_diff, new_color_argb) 

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

Parameters:

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

Method: replace_non_transparent_colors(new_color)

 replace_non_transparent_colors(new_color) 

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

Parameters:

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

Method: replace_non_transparent_colors(new_color_argb)

 replace_non_transparent_colors(new_color_argb) 

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

Parameters:

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

Method: resize(new_width, new_height)

 resize(new_width, new_height) 

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

Parameters:

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

Method: resize(new_width, new_height, resize_type)

 resize(new_width, new_height, resize_type) 

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

Parameters:

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

Method: resize(new_width, new_height, settings)

 resize(new_width, new_height, settings) 

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

Parameters:

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

Method: resize_by_settings(new_width, new_height, settings)

 resize_by_settings(new_width, new_height, settings) 

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

Parameters:

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

Method: resize_by_type(new_width, new_height, resize_type)

 resize_by_type(new_width, new_height, resize_type) 

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

Parameters:

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

Method: resize_height_proportionally(new_height)

 resize_height_proportionally(new_height) 

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

Parameters:

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

Method: resize_height_proportionally(new_height, resize_type)

 resize_height_proportionally(new_height, resize_type) 

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

Parameters:

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

Method: resize_height_proportionally(new_height, settings)

 resize_height_proportionally(new_height, settings) 

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

Parameters:

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

Method: resize_height_proportionally_settings(new_height, settings)

 resize_height_proportionally_settings(new_height, settings) 

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

Parameters:

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

Method: resize_width_proportionally(new_width)

 resize_width_proportionally(new_width) 

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

Parameters:

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

Method: resize_width_proportionally(new_width, resize_type)

 resize_width_proportionally(new_width, resize_type) 

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

Parameters:

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

Method: resize_width_proportionally(new_width, settings)

 resize_width_proportionally(new_width, settings) 

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

Parameters:

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

Method: resize_width_proportionally_settings(new_width, settings)

 resize_width_proportionally_settings(new_width, settings) 

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

Parameters:

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

Method: rotate(angle)

 rotate(angle) 

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

Parameters:

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

Method: rotate(angle, resize_proportionally, background_color)

 rotate(angle, resize_proportionally, background_color) 

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

Parameters:

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

Method: rotate_flip(rotate_flip_type)

 rotate_flip(rotate_flip_type) 

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

Parameters:

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

Method: save(file_path)

 save(file_path) 

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

Parameters:

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

Method: save(file_path, options)

 save(file_path, options) 

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

Parameters:

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

Method: save(file_path, options, bounds_rectangle)

 save(file_path, options, bounds_rectangle) 

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

Parameters:

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

Method: save(file_path, over_write)

 save(file_path, over_write) 

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

Parameters:

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

Method: save(stream)

 save(stream) 

Данные сохранения.

Parameters:

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

Method: save(stream, options_base)

 save(stream, options_base) 

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

Parameters:

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

Method: save(stream, options_base, bounds_rectangle)

 save(stream, options_base, bounds_rectangle) 

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

Parameters:

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

Method: save_argb_32_pixels(rectangle, pixels)

 save_argb_32_pixels(rectangle, pixels) 

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

Parameters:

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

Method: save_cmyk_32_pixels(rectangle, pixels)

 save_cmyk_32_pixels(rectangle, pixels) 

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

Parameters:

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

Method: save_cmyk_pixels(rectangle, pixels)

 save_cmyk_pixels(rectangle, pixels) 

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

Parameters:

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

Method: save_pixels(rectangle, pixels)

 save_pixels(rectangle, pixels) 

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

Parameters:

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

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

 save_raw_data(data, data_offset, rectangle, raw_data_settings) 

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

Parameters:

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

Method: save_to_stream(stream)

 save_to_stream(stream) 

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

Parameters:

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

Method: save_to_stream_with_options(stream, options_base)

 save_to_stream_with_options(stream, options_base) 

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

Parameters:

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

Method: save_to_stream_with_options_rect(stream, options_base, bounds_rectangle)

 save_to_stream_with_options_rect(stream, options_base, bounds_rectangle) 

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

Parameters:

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

Method: save_with_options(file_path, options)

 save_with_options(file_path, options) 

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

Parameters:

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

Method: save_with_options_rect(file_path, options, bounds_rectangle)

 save_with_options_rect(file_path, options, bounds_rectangle) 

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

Parameters:

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

Method: set_argb_32_pixel(x, y, argb_32_color)

 set_argb_32_pixel(x, y, argb_32_color) 

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

Parameters:

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

Method: set_palette(palette, update_colors)

 set_palette(palette, update_colors) 

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

Parameters:

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

Method: set_pixel(x, y, color)

 set_pixel(x, y, color) 

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

Parameters:

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

Method: set_resolution(dpi_x, dpi_y)

 set_resolution(dpi_x, dpi_y) 

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

Parameters:

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

Method: try_set_metadata(metadata)

 try_set_metadata(metadata) 

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

Parameters:

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

Returns

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

Method: write_argb_32_scan_line(scan_line_index, argb_32_pixels)

 write_argb_32_scan_line(scan_line_index, argb_32_pixels) 

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

Parameters:

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

Method: write_scan_line(scan_line_index, pixels)

 write_scan_line(scan_line_index, pixels) 

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

Parameters:

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

Examples

Saving of the JPG image as a TGA image.


from aspose.imaging import Image
from aspose.imaging.imageoptions import TgaOptions

with Image.load("test.jpg") as image:
	image.save("test.tga"", TgaOptions())
	

Loading of the PNG image, conversion of it to the TgaImage and saving as a TGA image.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage
from aspose.imaging.fileformats.tga import TgaImage

with as_of(Image.load("test.png"), RasterImage) as image:
	with TgaImage(image) as tgaImage:
		tgaImage.save("test.tga")