Класс CdrImage
Summary: The API for CorelDRAW CDR vector image format support is an essential toolkit
for developers working with vector graphics. This API enables the
seamless processing of CDR files, allowing for the storage and
manipulation of diverse elements such as text, lines, shapes, images,
colors, and effects. With its comprehensive capabilities, developers can
efficiently work with vector representations of image contents, ensuring
precision and flexibility in creating and editing CorelDRAW vector
graphics programmatically.
Module: aspose.imaging.fileformats.cdr
Full Name: aspose.imaging.fileformats.cdr.CdrImage
Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, IObjectWithSizeF, IMultipageImage, ICdrImage, VectorMultipageImage
Constructors
| Name | Description |
|---|---|
| CdrImage(stream, load_options) | Начните работать с классом CdrImage без усилий, инициализируя новый экземпляр с параметрами stream и loadOptions. Идеально подходит для разработчиков, ищущих удобный способ загрузки CDR‑изображений из различных источников данных с возможностью настройки процесса загрузки по мере необходимости. |
Properties
| Name | Type | Access | Description |
|---|---|---|---|
| auto_adjust_palette | bool | r/w | Получает или задает значение, указывающее, следует ли автоматически корректировать палитру. |
| background_color | Color | r/w | Получает или задает значение цвета фона. |
| bits_per_pixel | int | r | Получите глубину цвета изображения без усилий с помощью этого удобного свойства. Идеально подходит для разработчиков, желающих определить уровень детализации или глубину цвета в своих изображениях, обеспечивая точную обработку и манипуляцию. |
| bounds | Rectangle | r | Получает границы объекта. |
| buffer_size_hint | int | r/w | Получает или задает подсказку о размере буфера, определяющую максимальный допустимый размер для всех внутренних буферов. |
| cdr_document | CdrDocument | r | Без усилий получайте или обновляйте документ CDR с помощью этого интуитивного свойства. Идеально подходит для разработчиков, желающих получить доступ к документу CDR или изменить его, обеспечивая гибкость и эффективность в их приложениях. |
| container | Image | r | Получает контейнер Image. |
| data_stream_container | StreamContainer | r | Получает поток данных объекта. |
| default_page | Image | r | Легко получайте страницу по умолчанию изображения с помощью этого удобного свойства. Идеально для разработчиков, которым нужен быстрый доступ к основной странице их изображения, обеспечивая эффективную навигацию и управление. |
| disposed | bool | r | Получает значение, указывающее, удалён ли этот экземпляр. |
| exif_data | ExifData | r/w | Получает или задаёт экземпляр Exif. |
| file_format | FileFormat | r | Без усилий получайте формат файла изображения с помощью этого интуитивного свойства. Идеально подходит для разработчиков, желающих динамически определить формат своих изображений, обеспечивая совместимость и точную обработку в их приложениях. |
| has_background_color | bool | r/w | Получает или задает значение, указывающее, имеет ли изображение фоновый цвет. |
| height | int | r | Получает высоту изображения. |
| height_f | float | r | Получает высоту объекта в дюймах. |
| interrupt_monitor | InterruptMonitor | r/w | Получает или задает монитор прерываний. |
| is_cached | bool | r | Без усилий определяйте, кэшированы ли данные объекта в данный момент, устраняя необходимость чтения данных. Идеально подходит для разработчиков, стремящихся оптимизировать производительность, эффективно используя кэшированные данные, обеспечивая более быстрый доступ к информации об объекте. |
| metadata | ImageMetadata | r | Получает метаданные изображения. |
| page_count | int | r | Без усилий получайте или обновляйте общее количество страниц изображения с помощью этого интуитивного свойства. Идеально подходит для разработчиков, желающих управлять многостраничными изображениями динамически, обеспечивая эффективную навигацию и манипуляцию содержимым изображения. |
| pages | Image[] | r | Бесшовно получайте страницы изображения с помощью этого интуитивного свойства. Идеально подходит для разработчиков, желающих получить доступ и манипулировать отдельными страницами в многостраничных изображениях, обеспечивая эффективную навигацию и обработку. |
| palette | IColorPalette | r/w | Получает или задает цветовую палитру. Цветовая палитра не используется, когда пиксели представлены напрямую. |
| size | Size | r | Получает размер объекта. |
| size_f | SizeF | r | Получает размер объекта в дюймах. |
| use_palette | bool | r | Получает значение, указывающее, используется ли палитра изображения. |
| width | int | r | Получает ширину изображения. |
| width_f | float | r | Получает ширину объекта в дюймах. |
| xmp_data | XmpPacketWrapper | r/w | Получает или задает данные Xmp. |
Methods
| Name | Description |
|---|---|
| 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_files(files) | Создает многостраничное изображение, содержащее указанные файлы в виде страниц с отложенной загрузкой. |
| create_from_files(files, throw_exception_on_load_error) | Создает многостраничное изображение, содержащее указанные файлы в виде страниц с отложенной загрузкой. |
| create_from_images(images) | Создаёт новое изображение, используя указанные изображения в качестве страниц |
| create_from_images(images, dispose_images) | Создает новое изображение из указанных изображений в виде страниц. |
| crop(left_shift, right_shift, top_shift, bottom_shift) | Обрезать изображение со смещениями. |
| crop(rectangle) | Обрезает указанный прямоугольник. |
| get_default_options(args) | Получает параметры изображения по умолчанию. |
| get_embedded_images() | Получает встроенные изображения. |
| 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_original_options() | Получает параметры на основе настроек оригинального файла. Это может быть полезно для сохранения глубины цвета и других параметров оригинального изображения без изменений. Например, если мы загружаем черно‑белое PNG‑изображение с 1 битом на пиксель и затем сохраняем его с помощью DataStreamSupporter.save(file_path) метода, будет получено PNG‑изображение с 8‑битами на пиксель. Чтобы избежать этого и сохранить PNG‑изображение с 1‑битом на пиксель, используйте этот метод для получения соответствующих параметров сохранения и передайте их в метод Image.save(file_path, options) в качестве второго параметра. |
| get_proportional_height(width, height, new_width) | Получает пропорциональную высоту. |
| get_proportional_width(width, height, new_height) | Получает пропорциональную ширину. |
| get_serialized_stream(image_options, clipping_rectangle, page_number) | Преобразует в aps. |
| load(file_path) | Загружает новое изображение из указанного пути к файлу или URL. Если filePath — путь к файлу, метод просто открывает файл. Если filePath — URL, метод загружает файл, сохраняет его как временный и открывает. |
| load(file_path, load_options) | Загружает новое изображение из указанного пути к файлу или URL. Если filePath — путь к файлу, метод просто открывает файл. Если filePath — URL, метод загружает файл, сохраняет его как временный и открывает. |
| load(stream) | Загружает новое изображение из указанного потока. |
| load(stream, load_options) | Загружает новое изображение из указанного потока. |
| load_stream(stream) | Загружает новое изображение из указанного потока. |
| load_stream_with_options(stream, load_options) | Загружает новое изображение из указанного потока. |
| load_with_options(file_path, load_options) | Загружает новое изображение из указанного пути к файлу или URL. Если filePath — путь к файлу, метод просто открывает файл. Если filePath — URL, метод загружает файл, сохраняет его как временный и открывает. |
| remove_background() | Удаляет фон. |
| remove_background(settings) | Удаляет фон. |
| remove_metadata() | Удаляет метаданные. |
| 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_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_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_palette(palette, update_colors) | Настройте цветовую палитру изображения с помощью этого интуитивного метода. Идеально подходит для разработчиков, желающих динамически применять определённые цветовые схемы или корректировки, обеспечивая точный контроль над визуальным отображением их изображений. |
| try_set_metadata(metadata) | Пытается установить экземпляр metadata, если этот экземпляр Image поддерживает и реализует экземпляр IImageMetadataFormat. |
Constructor: CdrImage(stream, load_options)
CdrImage(stream, load_options)
Начните работать с классом CdrImage без усилий,
инициализируя новый экземпляр с параметрами stream и loadOptions.
Идеально подходит для разработчиков, ищущих удобный способ загрузки CDR‑изображений из
различных источников данных с возможностью настройки процесса загрузки по мере необходимости.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| поток | _io.BufferedRandom | Поток. |
| load_options | LoadOptions | Опции загрузки. |
Property: pages
Бесшовно получайте страницы изображения с помощью этого интуитивного свойства.
Идеально подходит для разработчиков, желающих получить доступ и манипулировать отдельными страницами в
многостраничных изображениях, обеспечивая эффективную навигацию и обработку.
See also:
Example # 1: The following example shows how to cache all pages of a CDR image.
Example # 2: The following example shows how to export a single page of CDR document to PDF.
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_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_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: 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: get_default_options(args)
get_default_options(args)
Получает параметры изображения по умолчанию.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| args | System.Object | Аргументы. |
Returns
| Тип | Описание |
|---|---|
| ImageOptionsBase | Параметры изображения по умолчанию. |
Method: get_embedded_images()
get_embedded_images()
Получает встроенные изображения.
Returns
| Тип | Описание |
|---|---|
| EmbeddedImage[] | Массив изображений |
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_original_options()
get_original_options()
Получает параметры на основе настроек оригинального файла.
Это может быть полезно для сохранения глубины цвета и других параметров оригинального изображения без изменений.
Например, если мы загружаем черно‑белое PNG‑изображение с 1 битом на пиксель и затем сохраняем его с помощью
DataStreamSupporter.save(file_path) метода, будет получено PNG‑изображение с 8‑битами на пиксель.
Чтобы избежать этого и сохранить PNG‑изображение с 1‑битом на пиксель, используйте этот метод для получения соответствующих параметров сохранения и передайте их
в метод Image.save(file_path, options) в качестве второго параметра.
Returns
| Тип | Описание |
|---|---|
| ImageOptionsBase | Параметры, основанные на настройках исходного файла. |
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: 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_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: remove_background(settings)
remove_background(settings)
Удаляет фон.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| settings | RemoveBackgroundSettings | Настройки. |
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_flip(rotate_flip_type)
rotate_flip(rotate_flip_type)
Вращает, отражает или вращает и отражает изображение.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| rotate_flip_type | RotateFlipType | Тип поворота и отражения. |
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 | The stream to save data to. |
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_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_palette(palette, update_colors)
set_palette(palette, update_colors)
Настройте цветовую палитру изображения с помощью этого интуитивного метода. Идеально подходит для
разработчиков, желающих динамически применять определённые цветовые схемы или корректировки,
обеспечивая точный контроль над визуальным отображением их изображений.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| palette | IColorPalette | Палитра для установки. |
| update_colors | bool | если установить значение Обратите внимание, что неизменённые индексы могут привести к сбою загрузки изображения, если для некоторых индексов нет соответствующих записей в палитре. |
Method: try_set_metadata(metadata)
try_set_metadata(metadata)
Пытается установить экземпляр metadata, если этот экземпляр Image поддерживает и реализует экземпляр IImageMetadataFormat.
Parameters:
| Параметр | Тип | Описание |
|---|---|---|
| metadata | IImageMetadataFormat | Метаданные. |
Returns
| Тип | Описание |
|---|---|
| bool | Истина, если metadata не равно null и экземпляр IMetadataContainer поддерживает и/или реализует экземпляр IImageMetadataFormat; в противном случае — ложь. |
Examples
The following example shows how to cache all pages of a CDR image.
import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.cdr import CdrImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join
dir_ = "c:\\temp"
# Загрузите изображение из файла CDR.
with aspycore.as_of(Image.load(join(dir_, "sample.cdr")), CdrImage) as image:
# Этот вызов кэширует только страницу по умолчанию.
image.cache_data()
# Кэшируйте все страницы, чтобы не происходила дополнительная загрузка данных из базового потока данных.
for page in image.pages:
page.cache_data()
The following example shows how to export a single page of CDR document to PDF.
import aspose.pycore as aspycore
from aspose.imaging import Image, TextRenderingHint, SmoothingMode
from aspose.imaging.fileformats.cdr import CdrImage, CdrImagePage
from aspose.imaging.imageoptions import PdfOptions, CdrRasterizationOptions
from os.path import join as path_combine
page_number: int = 0 # the page index for export
dir_ = "c:\\aspose.imaging\\issues\\net\\3635\\testdata\\3570"
input_cdr_file_name: str = path_combine(dir_, "tiger.cdr")
output_pdf_file_name: str = path_combine(dir_, "tiger.cdr.page" + page_number + ".pdf")
with aspycore.as_of(Image.load(input_cdr_file_name), CdrImage) as image:
image_page = aspycore.as_of(image.pages[page_number], CdrImagePage)
pdf_options = PdfOptions()
obj_init = CdrRasterizationOptions()
obj_init.text_rendering_hint = TextRenderingHint.SINGLE_BIT_PER_PIXEL
obj_init.smoothing_mode = SmoothingMode.NONE
obj_init.page_width = image_page.width
obj_init.page_height = image_page.height
pdf_options.vector_rasterization_options = obj_init
image_page.save(output_pdf_file_name, pdf_options)