Класс BmpImage
Summary: You can effortlessly handle Bitmap (BMP) and Device Independent Bitmap
(DIB) files, facilitating efficient manipulation and processing of raster
images. Performing various operations on images, this API streamlines the
workflow, offering developers a reliable toolkit for working with BMP and
DIB formats in their software applications.
Module: aspose.imaging.fileformats.bmp
Full Name: aspose.imaging.fileformats.bmp.BmpImage
Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, IRasterImageArgb32PixelLoader, IRasterImageRawDataLoader, RasterCachedImage
Constructors
| Name | Description |
|---|---|
| BmpImage(path) | Начните использовать класс BmpImage без усилий с этим конструктором, который инициализирует новый экземпляр. Идеально подходит для разработчиков, желающих быстро и эффективно работать с объектами BmpImage. |
| BmpImage(path, bits_per_pixel, compression, horizontal_resolution, vertical_resolution) | Без усилий создайте новый экземпляр класса BmpImage с помощью этого конструктора, используя указанные параметры, такие как путь, bitsPerPixel и сжатие. Идеально подходит для разработчиков, желающих быстро и эффективно инициализировать объекты BmpImage с точным контролем над характеристиками изображения. |
| BmpImage(raster_image) | Без усилий создайте новый экземпляр класса BmpImage путем инициализации его объектом RasterImage. Идеально подходит для разработчиков, желающих бесшовно преобразовать существующие растровые изображения в формат BmpImage, обеспечивая совместимость и простоту интеграции в их проекты. |
| BmpImage(raster_image, bits_per_pixel, compression, horizontal_resolution, vertical_resolution) | Начните работать с классом BmpImage без проблем, создавая новый экземпляр с использованием rasterImage и указанных параметров, таких как bitsPerPixel и сжатие. Идеально подходит для разработчиков, ищущих простой способ работы с объектами BmpImage, обеспечивая гибкость и эффективность в их проектах. |
| BmpImage(stream) | Начните использовать класс BmpImage без усилий, инициализируя новый экземпляр с помощью этого конструктора, используя поток в качестве входных данных. Идеально подходит для разработчиков, ищущих удобный способ работы с объектами BmpImage из различных источников данных, обеспечивая гибкость и простоту интеграции. |
| BmpImage(stream, bits_per_pixel, compression, horizontal_resolution, vertical_resolution) | Начните работать с классом BmpImage без проблем, создавая новый экземпляр с использованием потока и указанных параметров, таких как bitsPerPixel и сжатие. Идеально подходит для разработчиков, ищущих простой способ работы с объектами BmpImage, обеспечивая гибкость и эффективность в их проектах. |
| BmpImage(width, height) | Начните использовать класс BmpImage без усилий, создавая новый экземпляр с указанными параметрами ширины и высоты. Идеально подходит для разработчиков, ищущих удобный способ создания объектов BmpImage с пользовательскими размерами, обеспечивая гибкость и простоту интеграции в их проекты. |
| BmpImage(width, height, bits_per_pixel, palette) | Начните использовать класс BmpImage без проблем, инициализируя новый экземпляр с параметрами, такими как ширина, высота, глубина цвета и палитра. Идеально подходит для разработчиков, ищущих простой способ создания объектов BmpImage с пользовательскими размерами и цветовыми конфигурациями, обеспечивая гибкость и эффективность в их проектах. |
| BmpImage(width, height, bits_per_pixel, palette, compression, horizontal_resolution, vertical_resolution) | Без усилий создайте новый экземпляр класса BmpImage с этим конструктором, указывая параметры, такие как ширина, высота, bitsPerPixel и палитра. Идеально подходит для разработчиков, ищущих удобный способ создания объектов BmpImage с пользовательскими размерами и цветовыми конфигурациями, обеспечивая гибкость и простоту интеграции в их проекты. |
Properties
| Name | Type | Access | Description |
|---|---|---|---|
| auto_adjust_palette | bool | r/w | Получает или задает значение, указывающее, следует ли автоматически корректировать палитру. |
| background_color | Color | r/w | Получает или задает значение цвета фона. |
| bitmap_info_header | BitmapInfoHeader | r | Быстро получите основные сведения о вашем битовом изображении с помощью этой простой функции. Идеально подходит для разработчиков, которым необходимо извлечь информацию заголовка их изображений. |
| bits_per_pixel | int | r | Легко получите количество бит на пиксель изображения, используя это свойство. Идеально подходит для разработчиков, ищущих быструю информацию о качестве и глубине изображения. |
| bounds | Rectangle | r | Получает границы объекта. |
| buffer_size_hint | int | r/w | Получает или задает подсказку о размере буфера, определяющую максимальный допустимый размер для всех внутренних буферов. |
| compression | BitmapCompression | r | Получите тип сжатия, используемый для изображения, без усилий с помощью этого свойства. Идеально для разработчиков, которым необходимо быстро получать информацию о сжатии изображения. |
| 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 | Получает или задает значение, указывающее, имеет ли изображение фоновый цвет. |
| has_transparent_color | bool | r/w | Получает или задаёт значение, указывающее, имеет ли этот экземпляр RasterImage прозрачный цвет. |
| height | int | r | Получите высоту изображения без усилий с помощью этого свойства. Идеально для разработчиков которым нужен быстрый доступ к информации о размерах изображения. |
| horizontal_resolution | float | r/w | Это свойство позволяет вам легко получить или установить горизонтальное разрешение, измеряемое в пикселях на дюйм, объекта RasterImage. Идеально для разработчиков, которым нужен точный контроль над разрешением изображения в их приложениях. |
| image_opacity | float | r | Получает непрозрачность этого изображения. |
| interrupt_monitor | InterruptMonitor | r/w | Получает или задает монитор прерываний. |
| is_cached | bool | r | Получает значение, указывающее, кэшируются ли данные изображения в данный момент. |
| is_raw_data_available | bool | r | Получает значение, указывающее, поддерживается ли загрузка необработанных данных. |
| metadata | ImageMetadata | r | Получает метаданные изображения. |
| palette | IColorPalette | r/w | Получает или задает цветовую палитру. Цветовая палитра не используется, когда пиксели представлены напрямую. |
| 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 | Получает прозрачный цвет изображения. |
| 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 |
|---|---|
| adjust_brightness(brightness) | Регулировка яркости изображения. |
| adjust_contrast(contrast) | Контрастирование изображения |
| adjust_gamma(gamma) | Гамма‑коррекция изображения. |
| adjust_gamma(gamma_red, gamma_green, gamma_blue) | Гамма‑коррекция изображения. |
| analyze_percentage_digital_signature(password) | Вычисляет процентное сходство между извлечёнными данными и оригинальным паролем. |
| auto_brightness_contrast() | Выполняет автоматическую адаптивную нормализацию яркости и контраста для всего изображения. |
| auto_rotate() | Автоматически вращает изображение на основе данных ориентации, извлечённых из Exif метаданных. Этот метод гарантирует, что изображения отображаются в правильной ориентации, улучшая пользовательский опыт и устраняя необходимость ручных корректировок. Путём анализа информации Exif изображение вращается соответствующим образом, обеспечивая бесшовный просмотр на разных платформах и устройствах. Этот автоматизированный процесс вращения упрощает работу с изображениями и повышает общую удобность, особенно при работе с большими партиями изображений с различными ориентациями. |
| binarize_bradley(brightness_difference) | Бинаризация изображения с использованием адаптивного порогового алгоритма Брэдли, основанного на интегральном порогировании изображения |
| binarize_bradley(brightness_difference, window_size) | Бинаризация изображения с использованием адаптивного порогового алгоритма Брэдли, основанного на интегральном порогировании изображения |
| binarize_fixed(threshold) | Бинаризация изображения с предопределённым порогом |
| binarize_otsu() | Бинаризация изображения с порогом Оцу |
| blend(origin, overlay, overlay_alpha) | Смешивает этот экземпляр изображения с изображением overlay. |
| blend(origin, overlay, overlay_area, overlay_alpha) | Смешивает этот экземпляр изображения с изображением overlay. |
| cache_data() | Кеширует данные и гарантирует, что из базового DataStreamSupporter.data_stream_container не будет выполнена дополнительная загрузка данных. |
| can_load(file_path) | Определяет, можно ли загрузить изображение из указанного пути к файлу. |
| can_load(file_path, load_options) | Определяет, можно ли загрузить изображение из указанного пути к файлу и, при желании, используя указанные параметры открытия. |
| can_load(stream) | Определяет, можно ли загрузить изображение из указанного потока. |
| can_load(stream, load_options) | Определяет, можно ли загрузить изображение из указанного потока и, при желании, используя указанные loadOptions. |
| can_load_stream(stream) | Определяет, можно ли загрузить изображение из указанного потока. |
| can_load_stream_with_options(stream, load_options) | Определяет, можно ли загрузить изображение из указанного потока и, при желании, используя указанные loadOptions. |
| can_load_with_options(file_path, load_options) | Определяет, можно ли загрузить изображение из указанного пути к файлу и, при желании, используя указанные параметры открытия. |
| can_save(options) | Определяет, можно ли сохранить изображение в указанный формат файла, представленный переданными параметрами сохранения. |
| create(files) | Создаёт многостраничное изображение, содержащее указанные файлы. |
| create(files, throw_exception_on_load_error) | Создаёт многостраничное изображение, содержащее указанные файлы. |
| create(image_options, width, height) | Создаёт новое изображение с использованием указанных параметров создания. |
| create(image_options, width, height, pixels) | Создаёт экземпляр RasterImage из предоставленного массива пикселей. Проверяет, что указанные ширина и высота соответствуют размерам пиксельных данных. Этот метод может использоваться только в лицензированном режиме библиотеки. |
| create(images) | Создаёт новое изображение, используя указанные изображения в качестве страниц |
| create(images, dispose_images) | Создает новое изображение из указанных изображений в виде страниц. |
| create(multipage_create_options) | Создает указанные параметры создания многостраничного изображения. |
| create_from_file_with_params(path, bits_per_pixel, compression, horizontal_resolution, vertical_resolution) | Легко начните использовать класс BmpImage с этим конструктором, упрощая процесс инициализации нового экземпляра. Идеально для разработчиков, ищущих быстрый и эффективный способ включить объекты BmpImage в свои проекты. |
| create_from_files(files) | Создает многостраничное изображение, содержащее указанные файлы в виде страниц с отложенной загрузкой. |
| create_from_files(files, throw_exception_on_load_error) | Создает многостраничное изображение, содержащее указанные файлы в виде страниц с отложенной загрузкой. |
| create_from_image(raster_image) | Инициализирует новый экземпляр класса BmpImage. |
| create_from_image_with_params(raster_image, bits_per_pixel, compression, horizontal_resolution, vertical_resolution) | Инициализирует новый экземпляр класса BmpImage. |
| create_from_images(images) | Создаёт новое изображение, используя указанные изображения в качестве страниц |
| create_from_images(images, dispose_images) | Создает новое изображение из указанных изображений в виде страниц. |
| create_from_stream(stream) | Инициализирует новый экземпляр класса BmpImage. |
| create_from_stream_with_params(stream, bits_per_pixel, compression, horizontal_resolution, vertical_resolution) | Инициализирует новый экземпляр класса BmpImage. |
| 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) | Вращает, отражает или вращает и отражает изображение. |
| 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: BmpImage(path)
BmpImage(path)
Начните использовать класс BmpImage без усилий с этим конструктором, который
инициализирует новый экземпляр. Идеально подходит для разработчиков, желающих быстро и эффективно работать с объектами BmpImage.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| путь | string | Путь, из которого загружается изображение и инициализируются данные пикселей и палитры. |
See also:
Example # 1: The example shows how to load a BmpImage from a file.
Constructor: BmpImage(path, bits_per_pixel, compression, horizontal_resolution, vertical_resolution)
BmpImage(path, bits_per_pixel, compression, horizontal_resolution, vertical_resolution)
Без усилий создайте новый экземпляр класса BmpImage с помощью этого конструктора,
используя указанные параметры, такие как путь, bitsPerPixel и сжатие. Идеально подходит для разработчиков,
желающих быстро и эффективно инициализировать объекты BmpImage с точным контролем
над характеристиками изображения.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| путь | string | Путь, из которого загружается изображение и инициализируются данные пикселей и палитры. |
| bits_per_pixel | int | Биты на пиксель. |
| compression | BitmapCompression | Сжатие для использования. |
| horizontal_resolution | float | Горизонтальное разрешение. Обратите внимание, что из‑за округления полученное разрешение может немного отличаться от переданного. |
| vertical_resolution | float | Вертикальное разрешение. Обратите внимание, что из‑за округления полученное разрешение может немного отличаться от переданного. |
See also:
Example # 1: The example shows how to load a BmpImage from a file with the specified bit d…
Constructor: BmpImage(raster_image)
BmpImage(raster_image)
Без усилий создайте новый экземпляр класса BmpImage
путем инициализации его объектом RasterImage. Идеально подходит для разработчиков, желающих
бесшовно преобразовать существующие растровые изображения в формат BmpImage, обеспечивая
совместимость и простоту интеграции в их проекты.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| raster_image | RasterImage | Изображение, с которым инициализируются данные пикселей и палитры. |
See also:
Example # 1: The example shows how to load a BmpImage from another instance of RasterImage.
Constructor: BmpImage(raster_image, bits_per_pixel, compression, horizontal_resolution, vertical_resolution)
BmpImage(raster_image, bits_per_pixel, compression, horizontal_resolution, vertical_resolution)
Начните работать с классом BmpImage без проблем, создавая новый экземпляр
с использованием rasterImage и указанных параметров, таких как bitsPerPixel и сжатие.
Идеально подходит для разработчиков, ищущих простой способ работы с объектами BmpImage,
обеспечивая гибкость и эффективность в их проектах.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| raster_image | RasterImage | Изображение, с которым инициализируются данные пикселей и палитры. |
| bits_per_pixel | int | Биты на пиксель. |
| compression | BitmapCompression | Сжатие для использования. |
| horizontal_resolution | float | Горизонтальное разрешение. Обратите внимание, что из‑за округления полученное разрешение может немного отличаться от переданного. |
| vertical_resolution | float | Вертикальное разрешение. Обратите внимание, что из‑за округления полученное разрешение может немного отличаться от переданного. |
See also:
Example # 1: The example shows how to load a BmpImage from another instance of RasterImage…
Constructor: BmpImage(stream)
BmpImage(stream)
Начните использовать класс BmpImage без усилий, инициализируя новый экземпляр
с помощью этого конструктора, используя поток в качестве входных данных. Идеально подходит для разработчиков, ищущих
удобный способ работы с объектами BmpImage из различных источников данных,
обеспечивая гибкость и простоту интеграции.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| поток | _io.BufferedRandom | Поток, из которого загружается изображение и инициализируются данные пикселей и палитры. |
See also:
Example # 1: The example shows how to load a BmpImage from a file stream.
Constructor: BmpImage(stream, bits_per_pixel, compression, horizontal_resolution, vertical_resolution)
BmpImage(stream, bits_per_pixel, compression, horizontal_resolution, vertical_resolution)
Начните работать с классом BmpImage без проблем, создавая
новый экземпляр с использованием потока и указанных параметров, таких как bitsPerPixel
и сжатие. Идеально подходит для разработчиков, ищущих простой способ работы с
объектами BmpImage, обеспечивая гибкость и эффективность в их проектах.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| поток | _io.BufferedRandom | Поток, из которого загружается изображение и инициализируются данные пикселей и палитры. |
| bits_per_pixel | int | Биты на пиксель. |
| compression | BitmapCompression | Сжатие для использования. |
| horizontal_resolution | float | Горизонтальное разрешение. Обратите внимание, что из‑за округления полученное разрешение может немного отличаться от переданного. |
| vertical_resolution | float | Вертикальное разрешение. Обратите внимание, что из‑за округления полученное разрешение может немного отличаться от переданного. |
See also:
Example # 1: The example shows how to load a BmpImage from a file stream with the specifie…
Constructor: BmpImage(width, height)
BmpImage(width, height)
Начните использовать класс BmpImage без усилий, создавая новый экземпляр
с указанными параметрами ширины и высоты. Идеально подходит для разработчиков, ищущих
удобный способ создания объектов BmpImage с пользовательскими размерами, обеспечивая
гибкость и простоту интеграции в их проекты.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| width | int | Ширина изображения. |
| height | int | Высота изображения. |
See also:
Example # 1: The following example shows how to set a palette to a BMP image to reduce its…
Example # 2: The example shows how to create a BmpImage of the specified size.
Constructor: BmpImage(width, height, bits_per_pixel, palette)
BmpImage(width, height, bits_per_pixel, palette)
Начните использовать класс BmpImage без проблем, инициализируя новый экземпляр
с параметрами, такими как ширина, высота, глубина цвета и палитра. Идеально подходит для
разработчиков, ищущих простой способ создания объектов BmpImage с
пользовательскими размерами и цветовыми конфигурациями, обеспечивая гибкость и эффективность в их проектах.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| width | int | Ширина изображения. |
| height | int | Высота изображения. |
| bits_per_pixel | int | Биты на пиксель. |
| palette | IColorPalette | Цветовая палитра. |
See also:
Example # 1: The example shows how to create a BmpImage of the specified size with the spe…
Constructor: BmpImage(width, height, bits_per_pixel, palette, compression, horizontal_resolution, vertical_resolution)
BmpImage(width, height, bits_per_pixel, palette, compression, horizontal_resolution, vertical_resolution)
Без усилий создайте новый экземпляр класса BmpImage с этим конструктором,
указывая параметры, такие как ширина, высота, bitsPerPixel и палитра. Идеально подходит для разработчиков,
ищущих удобный способ создания объектов BmpImage с пользовательскими размерами
и цветовыми конфигурациями, обеспечивая гибкость и простоту интеграции в их проекты.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| width | int | Ширина изображения. |
| height | int | Высота изображения. |
| bits_per_pixel | int | Биты на пиксель. |
| palette | IColorPalette | Цветовая палитра. |
| compression | BitmapCompression | Сжатие для использования. |
| horizontal_resolution | float | Горизонтальное разрешение. Обратите внимание, что из‑за округления полученное разрешение может немного отличаться от переданного. |
| vertical_resolution | float | Вертикальное разрешение. Обратите внимание, что из‑за округления полученное разрешение может немного отличаться от переданного. |
See also:
Example # 1: The example shows how to create a BmpImage using various options.
Property: bitmap_info_header
Быстро получите основные сведения о вашем битовом изображении с помощью этой простой функции.
Идеально подходит для разработчиков, которым необходимо извлечь информацию заголовка их изображений.
See also:
Example # 1: The following example gets the information from the BMP header and prints it …
Property: bits_per_pixel
Легко получите количество бит на пиксель изображения, используя это свойство.
Идеально подходит для разработчиков, ищущих быструю информацию о качестве и глубине изображения.
See also:
Example # 1: The following example gets the general information about the image including …
Example # 2: The following example shows how the bitmap compression affects the output ima…
Property: compression
Получите тип сжатия, используемый для изображения, без усилий с помощью этого свойства.
Идеально для разработчиков, которым необходимо быстро получать информацию о сжатии изображения.
See also:
Example # 1: The following example gets the general information about the image including …
Example # 2: The following example shows how the bitmap compression affects the output ima…
Property: file_format
Легко получите значение формата файла с помощью этого удобного свойства.
Идеально для разработчиков, ищущих быстрый доступ к информации о формате файла.
See also:
Example # 1: The following example shows how to extract information about raw data format …
Property: height
Получите высоту изображения без усилий с помощью этого свойства. Идеально для разработчиков
которым нужен быстрый доступ к информации о размерах изображения.
See also:
Example # 1: The following example gets the general information about the image including …
Example # 2: The following example shows how the bitmap compression affects the output ima…
Property: horizontal_resolution
Это свойство позволяет вам легко получить или установить горизонтальное разрешение,
измеряемое в пикселях на дюйм, объекта RasterImage. Идеально для
разработчиков, которым нужен точный контроль над разрешением изображения в их приложениях.
See also:
Example # 1: The following example gets the general information about the image including …
Example # 2: The following example shows how to set horizontal/vertical resolution of a BM…
Property: raw_data_format
Легко получите формат ваших необработанных данных с помощью этой удобной функции.
Идеально для разработчиков, желающих быстро получить важную информацию о формате их данных.
See also:
Example # 1: The following example gets the general information about the image including …
Example # 2: The following example shows how to extract information about raw data format …
Property: raw_line_size
Быстро получите размер каждой необработанной строки в байтах с помощью этого простого свойства.
Идеально для разработчиков, которым необходимо эффективно работать с необработанными данными изображения.
See also:
Example # 1: The following example gets the general information about the image including …
Example # 2: The following example shows how the bitmap compression affects the output ima…
Property: vertical_resolution
Легко получите или задайте вертикальное разрешение, измеряемое в пикселях на дюйм,
этого объекта RasterImage с помощью этого свойства. Идеально для разработчиков, требующих
точный контроль над разрешением изображения в их приложениях.
See also:
Example # 1: The following example gets the general information about the image including …
Example # 2: The following example shows how to set horizontal/vertical resolution of a BM…
Property: width
Получите ширину изображения легко с помощью этого свойства. Идеально для разработчиков
ищущих быструю информацию о размерах изображения.
See also:
Example # 1: The following example gets the general information about the image including …
Example # 2: The following example shows how the bitmap compression affects the output ima…
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_red | float | Коэффициент гаммы для красного канала |
| gamma_green | float | Коэффициент гаммы для зелёного канала |
| gamma_blue | float | Коэффициент гаммы для синего канала |
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. |
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 |
Method: can_load(file_path, load_options) [static]
can_load(file_path, load_options)
Определяет, можно ли загрузить изображение из указанного пути к файлу и, при желании, используя указанные параметры открытия.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| file_path | string | Путь к файлу. |
| load_options | LoadOptions | Опции загрузки. |
Returns
| Тип | Описание |
|---|---|
| bool |
Method: can_load(stream) [static]
can_load(stream)
Определяет, можно ли загрузить изображение из указанного потока.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| поток | _io.BufferedRandom | Поток, из которого загружать. |
Returns
| Тип | Описание |
|---|---|
| bool |
Method: can_load(stream, load_options) [static]
can_load(stream, load_options)
Определяет, можно ли загрузить изображение из указанного потока и, при желании, используя указанные loadOptions.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| поток | _io.BufferedRandom | Поток, из которого загружать. |
| load_options | LoadOptions | Опции загрузки. |
Returns
| Тип | Описание |
|---|---|
| bool |
Method: can_load_stream(stream) [static]
can_load_stream(stream)
Определяет, можно ли загрузить изображение из указанного потока.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| поток | _io.BufferedRandom | Поток, из которого загружать. |
Returns
| Тип | Описание |
|---|---|
| bool |
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 |
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 |
Method: can_save(options)
can_save(options)
Определяет, можно ли сохранить изображение в указанный формат файла, представленный переданными параметрами сохранения.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| options | ImageOptionsBase | Параметры сохранения, которые следует использовать. |
Returns
| Тип | Описание |
|---|---|
| bool |
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 | если установлено |
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 | если установлено |
Returns
| Тип | Описание |
|---|---|
| Image | Изображение как IMultipageImage |
Method: create(multipage_create_options) [static]
create(multipage_create_options)
Создает указанные параметры создания многостраничного изображения.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| multipage_create_options | MultipageCreateOptions | Параметры создания многостраничного изображения. |
Returns
| Тип | Описание |
|---|---|
| Image | Многостраничное изображение |
Method: create_from_file_with_params(path, bits_per_pixel, compression, horizontal_resolution, vertical_resolution) [static]
create_from_file_with_params(path, bits_per_pixel, compression, horizontal_resolution, vertical_resolution)
Легко начните использовать класс BmpImage с этим конструктором, упрощая
процесс инициализации нового экземпляра. Идеально для разработчиков, ищущих
быстрый и эффективный способ включить объекты BmpImage в свои проекты.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| путь | string | Путь, из которого загружается изображение и инициализируются данные пикселей и палитры. |
| bits_per_pixel | int | Биты на пиксель. |
| compression | BitmapCompression | Сжатие для использования. |
| horizontal_resolution | float | Горизонтальное разрешение. Обратите внимание, что из‑за округления полученное разрешение может немного отличаться от переданного. |
| vertical_resolution | float | Вертикальное разрешение. Обратите внимание, что из‑за округления полученное разрешение может немного отличаться от переданного. |
Returns
| Тип | Описание |
|---|---|
| BmpImage |
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 | если установлено |
Returns
| Тип | Описание |
|---|---|
| Image | Многостраничное изображение |
Method: create_from_image(raster_image) [static]
create_from_image(raster_image)
Инициализирует новый экземпляр класса BmpImage.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| raster_image | RasterImage | Изображение, с которым инициализируются данные пикселей и палитры. |
Returns
| Тип | Описание |
|---|---|
| BmpImage |
Method: create_from_image_with_params(raster_image, bits_per_pixel, compression, horizontal_resolution, vertical_resolution) [static]
create_from_image_with_params(raster_image, bits_per_pixel, compression, horizontal_resolution, vertical_resolution)
Инициализирует новый экземпляр класса BmpImage.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| raster_image | RasterImage | Изображение, с которым инициализируются данные пикселей и палитры. |
| bits_per_pixel | int | Биты на пиксель. |
| compression | BitmapCompression | Сжатие для использования. |
| horizontal_resolution | float | Горизонтальное разрешение. Обратите внимание, что из‑за округления полученное разрешение может немного отличаться от переданного. |
| vertical_resolution | float | Вертикальное разрешение. Обратите внимание, что из‑за округления полученное разрешение может немного отличаться от переданного. |
Returns
| Тип | Описание |
|---|---|
| BmpImage |
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 | если установлено |
Returns
| Тип | Описание |
|---|---|
| Image | Изображение как IMultipageImage |
Method: create_from_stream(stream) [static]
create_from_stream(stream)
Инициализирует новый экземпляр класса BmpImage.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| поток | _io.BufferedRandom | Поток, из которого загружается изображение и инициализируются данные пикселей и палитры. |
Returns
| Тип | Описание |
|---|---|
| BmpImage |
Method: create_from_stream_with_params(stream, bits_per_pixel, compression, horizontal_resolution, vertical_resolution) [static]
create_from_stream_with_params(stream, bits_per_pixel, compression, horizontal_resolution, vertical_resolution)
Инициализирует новый экземпляр класса BmpImage.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| поток | _io.BufferedRandom | Поток, из которого загружается изображение и инициализируются данные пикселей и палитры. |
| bits_per_pixel | int | Биты на пиксель. |
| compression | BitmapCompression | Сжатие для использования. |
| horizontal_resolution | float | Горизонтальное разрешение. Обратите внимание, что из‑за округления полученное разрешение может немного отличаться от переданного. |
| vertical_resolution | float | Вертикальное разрешение. Обратите внимание, что из‑за округления полученное разрешение может немного отличаться от переданного. |
Returns
| Тип | Описание |
|---|---|
| BmpImage |
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 | Прямоугольник. |
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 | если установлено в |
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: is_digital_signed(password, percentage_threshold)
is_digital_signed(password, percentage_threshold)
Выполняет быструю проверку, чтобы определить, подписано ли изображение цифровой подписью, используя предоставленный пароль и пороговое значение.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| пароль | string | Пароль для проверки подписи. |
| percentage_threshold | int | Порог (в процентах)[0-100], определяющий, считается ли изображение подписанным. Если не указано, будет применён порог по умолчанию ( |
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)
Загружает новое изображение из указанного пути к файлу или URL.
Если filePath — путь к файлу, метод просто открывает файл.
Если filePath — URL, метод загружает файл, сохраняет его как временный и открывает.
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)
Загружает новое изображение из указанного пути к файлу или URL.
Если filePath — путь к файлу, метод просто открывает файл.
Если filePath — URL, метод загружает файл, сохраняет его как временный и открывает.
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() и RasterImage.rotate(angle, resize_proportionally, background_color).
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| resize_proportionally | bool | если установить значение |
| 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: 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)
Изменяет размер изображения.
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)
Изменяет размер изображения.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| new_width | int | Новая ширина. |
| new_height | int | Новая высота. |
| settings | ImageResizeSettings | The resize settings. |
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_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_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 | если установить значение |
| background_color | Color | Цвет фона. |
Method: rotate_flip(rotate_flip_type)
rotate_flip(rotate_flip_type)
Вращает, отражает или вращает и отражает изображение.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| rotate_flip_type | RotateFlipType | The rotate flip type. |
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 | если установлено |
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 | The rectangle to save pixels to. |
| pixels | Color[] | 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.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_palette(palette, update_colors)
set_palette(palette, update_colors)
Устанавливает палитру изображения.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| palette | IColorPalette | Палитра для установки. |
| update_colors | bool | Если установить значение |
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. |
See also:
Example # 1: The following example gets the general information about the image including …
Example # 2: The following example shows how to set horizontal/vertical resolution of a BM…
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
The following example shows how to create a BMP image of the specified size.
from aspose.imaging import Color
from aspose.imaging.fileformats.bmp import BmpImage
from os.path import join as path_join
directory = "c:\\temp\\"
# Создайте BMP‑изображение размером 100 × 100 px.
with BmpImage(100, 100) as bmpImage:
# Заполните изображение простым линейным градиентом от красного к черному.
width = bmpImage.width
height = bmpImage.height
for y in range(height):
for x in range(width):
hue = (255 * x) // width
bmpImage.set_pixel(x, y, Color.from_argb(255, hue, 0, 0))
with open(path_join(directory, "output.bmp"), "w+b") as stream:
bmpImage.save(stream)
The following example gets the general information about the image including pixel format, image size, resolution, compression etc.
from aspose.pycore import as_of
from aspose.imaging import Image
from aspose.imaging.fileformats.bmp import BmpImage
from os.path import join as path_join
with Image.load(r"c:\temp\sample.bmp") as image:
bmpImage = as_of(image, BmpImage)
print("The pixel format:", bmpImage.raw_data_format)
print("The raw line size in bytes:", bmpImage.raw_line_size)
print("The bitmap compression:", bmpImage.compression)
print("The bitmap width", bmpImage.width)
print("The bitmap height", bmpImage.height)
print("The number of bits per pixel", bmpImage.bits_per_pixel)
hres = bmpImage.horizontal_resolution
vres = bmpImage.vertical_resolution
print("The horizontal resolution, in pixels per inch:", hres)
print("The vertical resolution, in pixels per inch:", vres)
if hres != 96.0 or vres != 96.0:
# Вы можете рассмотреть возможность использования метода SetResolution для обновления обоих значений разрешения одним вызовом.
print("Set resolution values to 96 dpi")
bmpImage.set_resolution(96.0, 96.0)
print("The horizontal resolution, in pixels per inch: {0}", bmpImage.horizontal_resolution);
print("The vertical resolution, in pixels per inch: {0}", bmpImage.vertical_resolution);
#Вывод может выглядеть так:
#Формат пикселя: Rgb24Bpp, используемые каналы: 8,8,8
#Размер необработанной строки в байтах: 1500
#Сжатие битмапа: Rgb
#Ширина битмапа: 500
#Высота битмапа: 375
#Количество бит на пиксель: 24
#Горизонтальное разрешение, в пикселях на дюйм: 0
#Вертикальное разрешение, в пикселях на дюйм: 0
#Установите значения разрешения в 96 dpi
#Горизонтальное разрешение, в пикселях на дюйм: 96.012
#Вертикальное разрешение, в пикселях на дюйм: 96.012
The following example shows how to set a palette to a BMP image to reduce its output size.
from aspose.pycore import as_of
from aspose.imaging import Point, Color, Graphics, ColorPaletteHelper
from aspose.imaging.brushes import LinearGradientBrush
from aspose.imaging.fileformats.bmp import BmpImage
from aspose.imaging.imageoptions import BmpOptions
from os.path import join as path_join
# Создайте BMP‑изображение размером 100 × 100 px.
with BmpImage(100, 100) as bmpImage:
# Линейный градиент от левого верхнего до правого нижнего угла изображения.
brush = LinearGradientBrush(Point(0, 0), Point(bmpImage.width, bmpImage.height),
Color.red,
Color.green)
# Заполните всё изображение кистью линейного градиента.
gr = Graphics(bmpImage)
gr.fill_rectangle(brush, bmpImage.bounds)
# Получите ближайшую 8‑битную цветовую палитру, покрывающую как можно больше пикселей, так чтобы палитризированное изображение
# было почти визуально неотличимо от BMP без палитры
palette = ColorPaletteHelper.get_close_image_palette(bmpImage, 256)
# 8‑битная палитра содержит не более 256 цветов.
saveOptions = BmpOptions()
saveOptions.palette = palette
saveOptions.bits_per_pixel = 8
with stream_ext.create_memory_stream() as stream:
bmpImage.save(stream, saveOptions)
print(f"The size of image with palette is {stream.tell()} bytes.")
stream.seek(0)
bmpImage.save(stream)
print(f"The size of image without palette is {stream.tell()} bytes.")
# Вывод выглядит так:
# Размер изображения с палитрой составляет 11078 байт.
# Размер изображения без палитры составляет 40054 байт.
The example shows how to load a BmpImage from a file.
from aspose.imaging.fileformats.bmp import BmpImage
import os
directory = r"c:\temp"
# Загрузите BMP‑изображение из файла.
# Исходные пиксели будут преобразованы в формат 32‑bpp при необходимости.
with BmpImage(os.path.join(directory, "sample.bmp")) as bmp_image:
# Выполнить обработку изображения.
# Сохраните в другой BMP‑файл.
bmp_image.save(os.path.join(directory, "sample.output.32bpp.bmp"))
The example shows how to load a BmpImage from a file with the specified bit depth and resolution.
from aspose.imaging.fileformats.bmp import BmpImage, BitmapCompression
import os
directory = r"c:\temp"
# Загрузите BMP‑изображение из файла.
# Исходные пиксели будут преобразованы в формат 24‑bpp при необходимости.
# Разрешение будет установлено в 96 dpi.
with BmpImage(os.path.join(directory, "sample.bmp"), 24, BitmapCompression.RGB, 96.0, 96.0) as bmp_image:
# Выполнить обработку изображения.
# Сохраните в другой BMP‑файл.
bmp_image.save(os.path.join(directory, "sample.output.24bpp.96dpi.bmp"))
The example shows how to load a BmpImage from a file stream.
from aspose.imaging.fileformats.bmp import BmpImage
import os
directory = r"c:\temp"
# Загрузите BMP‑изображение из файлового потока.
# Исходные пиксели будут преобразованы в формат 32‑bpp при необходимости.
with open(os.path.join(directory, "sample.bmp"), "rb+") as stream:
with BmpImage(stream) as bmp_image:
# Выполнить обработку изображения.
# Сохраните в другой BMP‑файл.
bmp_image.save(os.path.join(directory, "sample.output.32bpp.bmp"))
The example shows how to load a BmpImage from a file stream with the specified bit depth and resolution.
from aspose.imaging.fileformats.bmp import BmpImage, BitmapCompression
import os
directory = r"c:\temp"
# Загрузите BMP‑изображение из файлового потока.
# Исходные пиксели будут преобразованы в формат 24‑bpp при необходимости.
# Разрешение будет установлено в 96 dpi.
with open(os.path.join(directory, "sample.bmp"), "rb") as stream:
with BmpImage(stream, 24, BitmapCompression.RGB, 96.0, 96.0) as bmp_image:
# Выполнить обработку изображения.
# Сохраните в другой BMP‑файл.
bmp_image.save(os.path.join(directory, "sample.output.24bpp.96dpi.bmp"))
The example shows how to load a BmpImage from another instance of RasterImage.
from aspose.imaging.fileformats.bmp import BmpImage
from aspose.imaging.imageoptions import PngOptions
from aspose.imaging.sources import StreamSource
from aspose.imaging import Image, RasterImage, Graphics, Color
from aspose.imaging.brushes import SolidBrush
import os
import aspose.pycore as aspycore
directory = r"c:\temp"
# Создайте новое PNG‑изображение.
with PngOptions() as create_options:
create_options.source = StreamSource()
with aspycore.as_of(Image.create(create_options, 100, 100), RasterImage) as raster_image:
# Заполните всё изображение PNG красным цветом.
gr = Graphics(raster_image)
brush = SolidBrush(Color.red)
gr.fill_rectangle(brush, raster_image.bounds)
# Создайте BMP‑изображение на основе PNG‑изображения.
# Исходные пиксели будут преобразованы в формат 32‑bpp при необходимости.
with BmpImage(raster_image) as bmp_image:
# Сохраните в BMP‑файл
bmp_image.save(os.path.join(directory, "output.32bpp.bmp"))
The example shows how to load a BmpImage from another instance of RasterImage with the specified bit depth and compression.
from aspose.imaging.fileformats.bmp import BmpImage, BitmapCompression
from aspose.imaging.imageoptions import PngOptions
from aspose.imaging.sources import StreamSource
from aspose.imaging import Image, RasterImage, Graphics, Color
from aspose.imaging.brushes import SolidBrush
import os
import aspose.pycore as aspycore
directory = r"c:\temp"
# Создайте новое PNG‑изображение.
with PngOptions() as create_options:
create_options.source = StreamSource()
with aspycore.as_of(Image.create(create_options, 100, 100), RasterImage) as raster_image:
# Заполните всё изображение PNG красным цветом.
gr = Graphics(raster_image)
brush = SolidBrush(Color.red)
gr.fill_rectangle(brush, raster_image.bounds)
# Создайте BMP‑изображение на основе PNG‑изображения.
# Исходные пиксели будут преобразованы в формат 24‑bpp при необходимости.
# Разрешение будет установлено в 96 dpi.
with BmpImage(raster_image, 24, BitmapCompression.RGB, 96.0, 96.0) as bmp_image:
# Сохраните в BMP‑файл
bmp_image.save(os.path.join(directory, "output.24bpp.96dpi.bmp"))
The example shows how to create a BmpImage of the specified size.
from aspose.imaging.fileformats.bmp import BmpImage
from aspose.imaging import Graphics, Color
from aspose.imaging.brushes import SolidBrush
import os
directory = r"c:\temp"
# Создать BMP‑изображение с глубиной 32 бита на пиксель размером 100 × 100 пикселей.
with BmpImage(100, 100) as bmp_image:
# Заполнить всё изображение красным.
Graphics gr = Graphics(bmp_image)
brush = SolidBrush(Color.red)
gr.fill_rectangle(brush, bmp_image.bounds)
# Сохраните в BMP‑файл
bmp_image.save(os.path.join(directory, "output.bmp"))
The example shows how to create a BmpImage of the specified size with the specified palette.
from aspose.imaging.fileformats.bmp import BmpImage
from aspose.imaging import Graphics, Color, ColorPalette, Rectangle
from aspose.imaging.brushes import SolidBrush
import os
directory = r"c:\temp"
paletterColors = [Color.red, Color.green]
# Создайте монохромную палитру, содержащую только красный и зелёный цвета.
palette = ColorPalette.create_with_colors(paletterColors)
# Создайте монохромное BMP‑изображение 1‑bpp размером 100 × 100 px.
with BmpImage(100, 100, 1, palette) as bmp_image:
gr = Graphics(bmp_image)
# Заполните верхнюю половину изображения красным цветом.
redBrush = SolidBrush(Color.red)
gr.fill_rectangle(redBrush, Rectangle(0, 0, bmp_image.width, bmp_image.height // 2))
# Заполните нижнюю половину изображения зелёным цветом.
greenBrush = SolidBrush(Color.green)
gr.fill_rectangle(greenBrush, Rectangle(0, bmp_image.height // 2, bmp_image.width, bmp_image.height // 2))
# Сохранить в BMP
bmp_image.save(os.path.join(directory, "output.monochrome.bmp"))
The example shows how to create a BmpImage using various options.
from aspose.imaging.fileformats.bmp import BmpImage, BitmapCompression
from aspose.imaging import Graphics, Color, ColorPalette, Rectangle
from aspose.imaging.brushes import SolidBrush
import os
directory = r"c:\temp"
paletterColors = [Color.red, Color.green]
# Создайте монохромную палитру, содержащую только красный и зелёный цвета.
palette = ColorPalette.create_with_colors(paletterColors)
# Создайте монохромное BMP‑изображение 1‑bpp размером 100 × 100 px.
with BmpImage(100, 100, 1, palette, BitmapCompression.RGB, 96.0, 96.0) as bmp_image:
gr = Graphics(bmp_image)
# Заполните верхнюю половину изображения красным цветом.
redBrush = SolidBrush(Color.red)
gr.fill_rectangle(redBrush, Rectangle(0, 0, bmp_image.width, bmp_image.height // 2))
# Заполните нижнюю половину изображения зелёным цветом.
greenBrush = SolidBrush(Color.green)
gr.fill_rectangle(greenBrush, Rectangle(0, bmp_image.height // 2, bmp_image.width, bmp_image.height // 2))
# Сохранить в BMP
bmp_image.save(os.path.join(directory, "output.monochrome.96dpi.bmp"))
The following example shows how to extract information about raw data format and alpha channel from a BMP image.
from aspose.imaging.fileformats.bmp import BmpImage
# Создать BMP‑изображение с глубиной 32 бита на пиксель размером 100 × 100 пикселей.
with BmpImage(100, 100, 32, None) as bmp_image:
print("FileFormat={0}, RawDataFormat={1}, HasAlpha={2}".format(bmp_image.file_format.name, bmp_image.raw_data_format, bmp_image.has_alpha))
# Создать BMP‑изображение с глубиной 24 бита на пиксель размером 100 × 100 пикселей.
with BmpImage(100, 100, 24, None) as bmp_image:
print("FileFormat={0}, RawDataFormat={1}, HasAlpha={2}".format(bmp_image.file_format.name, bmp_image.raw_data_format, bmp_image.has_alpha))
# Как правило, BMP не поддерживает альфа‑канал, поэтому результат будет выглядеть так:
# FileFormat = BMP, RawDataFormat = Rgb32Bpp, использованные каналы: 8,8,8,8, HasAlpha = False
# FileFormat = BMP, RawDataFormat = Rgb24Bpp, использованные каналы: 8,8,8, HasAlpha = False
The following example shows how the bitmap compression affects the output image size.
from aspose.imaging import Color, ColorPalette, Graphics
from aspose.imaging.brushes import SolidBrush
from aspose.imaging.fileformats.bmp import BmpImage, BitmapCompression
from aspose.imaging.extensions import StreamExtensions as strm_ext
compressions = (BitmapCompression.RGB, BitmapCompression.RLE8)
paletterColors = (Color.red, Color.green)
# Создайте монохромную палитру, содержащую только красный и зелёный цвета.
palette = ColorPalette.create_with_colors(paletterColors)
for compression in compressions:
# Создайте BMP‑изображение 8‑bpp размером 100 × 100 px.
with BmpImage(100, 100, 8, palette, compression, 0.0, 0.0) as bmp_image:
gr = Graphics(bmp_image)
# Заполнить всё изображение красным.
red_brush = SolidBrush(Color.red)
gr.fill_rectangle(red_brush, bmp_image.bounds)
# Сохраните изображение в поток памяти, чтобы получить размер выходного изображения.
with strm_ext.create_memory_stream() as stream:
bmp_image.save(stream)
print("---------------------------------------------")
print("The compression =", bmp_image.compression.name)
print("The number of bits per pixel =", bmp_image.bits_per_pixel)
print(f"The image dimensions = {bmp_image.width} x {bmp_image.height}")
print("The raw line size =", bmp_image.raw_line_size)
print("The output size in bytes =", stream.tell())
# Вывод выглядит так:
# ---------------------------------------------
# Сжатие = RGB
# Количество бит на пиксель = 8
# Размеры изображения =100 × 100
# Размер необработанной строки = 100
# Размер вывода в байтах = 1178
# ---------------------------------------------
# Сжатие = RLE8
# Количество бит на пиксель = 8
# Размеры изображения =100 × 100
# Размер необработанной строки = 100
# Размер вывода в байтах = 856
The following example shows how to set horizontal/vertical resolution of a BMP image.
import os
import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.bmp import BmpImage
directory = r"c:\temp"
with Image.load(os.path.join(directory, "sample.bmp")) as image:
bmp_image = aspycore.as_of(image, BmpImage)
# Получить горизонтальное и вертикальное разрешение BmpImage
horizontal_resolution = bmp_image.horizontal_resolution
vertical_resolution = bmp_image.vertical_resolution
print("The horizontal resolution, in pixels per inch:", horizontal_resolution)
print("The vertical resolution, in pixels per inch:", vertical_resolution)
if (horizontal_resolution != 96.0 || vertical_resolution != 96.0)
{
# Используйте метод set_resolution для обновления обоих значений разрешения одним вызовом.
print("Set resolution values to 96 dpi")
bmp_image.set_resolution(96.0, 96.0)
print("The horizontal resolution, in pixels per inch:", bmp_image.horizontal_resolution);
print("The vertical resolution, in pixels per inch:", bmp_image.vertical_resolution);
}
# Вывод может выглядеть так:
# Горизонтальное разрешение, в пикселях на дюйм: 0
# Вертикальное разрешение, в пикселях на дюйм: 0
# Установите значения разрешения в 96 dpi
# Горизонтальное разрешение, в пикселях на дюйм: 96.0
# Вертикальное разрешение, в пикселях на дюйм: 96.0
The following example gets the information from the BMP header and prints it to the console.
import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.bmp import BmpImage
with Image.load(r"c:\temp\sample.bmp") as image:
bmp_image = aspycore.as_of(image, BmpImage)
header = bmp_image.bitmap_info_header
print("The number of palette colors that are required for displaying the bitmap:", header.bitmap_colors_important)
print("The number of palette colors used in the bitmap:", header.bitmap_colors_used)
print("The bitmap compression:", header.bitmap_compression)
print("The bitmap height:", header.bitmap_height)
print("The bitmap width:", header.bitmap_width)
print("The bitmap raw data size in bytes:", header.bitmap_image_size)
print("The number of planes:", header.bitmap_planes)
print("The horizontal resolution of the bitmap, in pixels-per-meter:", header.bitmap_x_pels_per_meter)
print("The vertical resolution of the bitmap, in pixels-per-meter:", header.bitmap_y_pels_per_meter)
print("The number of bits per pixel:", header.bits_per_pixel)
print("The extra bits masks:", header.extra_bit_masks)
print("The header size in bytes:", header.header_size)
#Вывод может выглядеть так:
#Количество цветов палитры, необходимых для отображения битмапа: 0
#Количество цветов палитры, используемых в битмапе: 0
#Сжатие битмапа: 0
#Высота битмапа: 375
#Ширина битмапа: 500
#Размер необработанных данных битмапа в байтах: 562500
#Количество плоскостей: 1
#Горизонтальное разрешение битмапа, в пикселях на метр: 0
#Вертикальное разрешение битмапа, в пикселях на метр: 0
#Количество бит на пиксель: 24
#Дополнительные маски битов:
#Размер заголовка в байтах: 40
Compress BMP image using DXT1 compression algorithm.
#cxFor:aspose.imaging.imageoptions.BmpOptions.compression
from aspose.imaging import Image
from aspose.imaging.imageoptions import BmpOptions
from aspose.imaging.fileformats.bmp import BitmapCompression
with Image.load("Tiger.bmp") as image:
bmp_options = BmpOptions()
bmp_options.compression = BitmapCompression.DXT1
image.save("CompressedTiger.bmp", bmp_options)
Decompress BMP image which was previously compressed using DXT1 compression algorithm.
from aspose.imaging import Image
from aspose.imaging.imageoptions import BmpOptions
with Image.load("CompressedTiger.bmp") as image:
image.save("DecompressedTiger.bmp", BmpOptions())