Clase CmxImage

Summary: The API for Corel Metafile Exchange (CMX) vector image format with metadata
descriptions support is a comprehensive solution for developers working
with CMX files. This API allows for the seamless loading of CMX images,
extracting metadata such as bits per pixel, object dimensions, and more.
With additional functionalities like resizing, rotating, setting
palettes, and converting to other formats, this API empowers developers
to efficiently manipulate and customize CMX vector images to meet their
specific application requirements.

Module: aspose.imaging.fileformats.cmx

Full Name: aspose.imaging.fileformats.cmx.CmxImage

Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, IObjectWithSizeF, IMultipageImage, ICmxImage, VectorMultipageImage

Constructors

Name	Descripción
CmxImage(stream_container, load_options)	Comience a trabajar con la clase CmxImage de forma fluida inicializando una nueva instancia con los parámetros streamContainer y loadOptions. Ideal para desarrolladores que buscan una manera conveniente de cargar imágenes CMX desde diversas fuentes de datos mientras personalizan el proceso de carga según sea necesario.

Properties

Name	Type	Access	Descripción
auto_adjust_palette	bool	r/w	Obtiene o establece un valor que indica si se ajusta automáticamente la paleta.
background_color	Color	r/w	Obtiene o establece un valor para el color de fondo.
bits_per_pixel	int	r	Recupere la profundidad de bits de la imagen sin esfuerzo con esta propiedad fácil de usar. Ideal para desarrolladores que buscan determinar el nivel de detalle o la profundidad de color presente en sus imágenes, garantizando un procesamiento y manipulación precisos.
bounds	Rectangle	r	Obtiene los límites del objeto.
buffer_size_hint	int	r/w	Obtiene o establece la sugerencia de tamaño del búfer, que se define como el tamaño máximo permitido para todos los búferes internos.
cmx_page	CmxPage	r	Recupere sin esfuerzo la página CMX de la imagen con esta propiedad intuitiva. Ideal para desarrolladores que buscan acceso rápido a páginas individuales dentro de imágenes CMX, asegurando una navegación y gestión eficientes.
container	Image	r	Obtiene el contenedor Image.
data_stream_container	StreamContainer	r	Obtiene el flujo de datos del objeto.
default_page	Image	r	Recupere sin esfuerzo la página predeterminada de la imagen con esta propiedad intuitiva. Ideal para desarrolladores que buscan acceso rápido a la página principal de su imagen, asegurando una navegación y gestión eficientes.
disposed	bool	r	Obtiene un valor que indica si esta instancia está disposed.
document	CmxDocument	r	Recupere el documento CMX sin esfuerzo con esta propiedad intuitiva. Ideal para desarrolladores que buscan acceder o modificar imágenes CMX, garantizando flexibilidad y eficiencia en sus aplicaciones.
exif_data	ExifData	r/w	Obtiene o establece la instancia Exif.
file_format	FileFormat	r	Recupere el formato de archivo de la imagen sin esfuerzo con esta propiedad fácil de usar. Ideal para desarrolladores que buscan determinar el formato de sus imágenes de forma dinámica, garantizando compatibilidad y un procesamiento preciso en sus aplicaciones.
has_background_color	bool	r/w	Obtiene o establece un valor que indica si la imagen tiene color de fondo.
height	int	r	Obtiene la altura de la imagen.
height_f	float	r	Obtenga sin esfuerzo la altura del objeto, medida en pulgadas, con esta propiedad fácil de usar. Ideal para desarrolladores que buscan información dimensional precisa para un diseño y presentación efectivos en sus aplicaciones.
interrupt_monitor	InterruptMonitor	r/w	Obtiene o establece el monitor de interrupciones.
is_cached	bool	r	Determine si los datos del objeto están actualmente en caché, eliminando la necesidad de leer los datos. Ideal para desarrolladores que buscan optimizar el rendimiento mediante el uso eficiente de datos en caché, garantizando un acceso más rápido a la información del objeto.
metadata	ImageMetadata	r	Obtiene los metadatos de la imagen.
page_count	int	r	Recupere el recuento total de páginas de la imagen con esta propiedad intuitiva. Ideal para desarrolladores que buscan gestionar imágenes multipágina de forma dinámica, asegurando una navegación y manipulación eficientes del contenido de la imagen.
pages	Image[]	r	Recupere las páginas de la imagen sin problemas con esta propiedad intuitiva. Ideal para desarrolladores que buscan acceder y manipular páginas individuales dentro de imágenes multipágina, asegurando una navegación y procesamiento eficientes.
palette	IColorPalette	r/w	Obtiene o establece la paleta de colores. La paleta de colores no se usa cuando los píxeles se representan directamente.
size	Size	r	Obtiene el tamaño del objeto.
size_f	SizeF	r	Obtiene el tamaño del objeto, en pulgadas.
use_palette	bool	r	Obtiene un valor que indica si se usa la paleta de la imagen.
width	int	r	Obtiene el ancho de la imagen.
width_f	float	r	Recupere el ancho del objeto en pulgadas con esta propiedad intuitiva. Ideal para desarrolladores que buscan mediciones precisas de objetos en sus aplicaciones, garantizando un diseño y presentación exactos.
xmp_data	XmpPacketWrapper	r/w	Obtiene o establece los datos Xmp.

Methods

Name	Descripción
cache_data()	Almacene en caché los datos para evitar cargas adicionales desde la fuente subyacente DataStreamSupporter.data_stream_container con este método conveniente. Ideal para desarrolladores que buscan optimizar el rendimiento mediante la precarga de datos, garantizando un acceso más rápido y una operación más fluida en sus aplicaciones.
can_load(file_path)	Determina si la imagen puede cargarse desde la ruta de archivo especificada.
can_load(file_path, load_options)	Determina si la imagen puede cargarse desde la ruta de archivo especificada y, opcionalmente, usando las opciones de apertura especificadas.
can_load(stream)	Determina si la imagen puede cargarse desde el flujo especificado.
can_load(stream, load_options)	Determina si la imagen puede cargarse desde el flujo especificado y, opcionalmente, usando los loadOptions especificados.
can_load_stream(stream)	Determina si la imagen puede cargarse desde el flujo especificado.
can_load_stream_with_options(stream, load_options)	Determina si la imagen puede cargarse desde el flujo especificado y, opcionalmente, usando los loadOptions especificados.
can_load_with_options(file_path, load_options)	Determina si la imagen puede cargarse desde la ruta de archivo especificada y, opcionalmente, usando las opciones de apertura especificadas.
can_save(options)	Determina si la imagen puede guardarse en el formato de archivo especificado representado por las opciones de guardado proporcionadas.
create(files)	Crea la imagen multipágina que contiene los archivos especificados.
create(files, throw_exception_on_load_error)	Crea la imagen multipágina que contiene los archivos especificados.
create(image_options, width, height)	Crea una nueva imagen usando las opciones de creación especificadas.
create(image_options, width, height, pixels)	Crea una instancia de RasterImage a partir del arreglo de píxeles proporcionado. Valida que el ancho y alto especificados coincidan con las dimensiones de los datos de píxeles. Este método solo puede usarse cuando la biblioteca está en modo Licenciado.
create(images)	Crea una nueva imagen usando las imágenes especificadas como páginas
create(images, dispose_images)	Crea una nueva imagen con las imágenes especificadas como páginas.
create(multipage_create_options)	Crea las opciones de creación multipágina especificadas.
create_from_files(files)	Crea la imagen multipágina que contiene los archivos especificados como páginas de carga diferida.
create_from_files(files, throw_exception_on_load_error)	Crea la imagen multipágina que contiene los archivos especificados como páginas de carga diferida.
create_from_images(images)	Crea una nueva imagen usando las imágenes especificadas como páginas
create_from_images(images, dispose_images)	Crea una nueva imagen con las imágenes especificadas como páginas.
crop(left_shift, right_shift, top_shift, bottom_shift)	Recortar la imagen con desplazamientos.
crop(rectangle)	Recorta el rectángulo especificado.
get_default_options(args)	Obtiene las opciones de imagen predeterminadas.
get_embedded_images()	Obtiene las imágenes incrustadas.
get_file_format(file_path)	Obtiene el formato de archivo.
get_file_format(stream)	Obtiene el formato de archivo.
get_file_format_of_stream(stream)	Obtiene el formato de archivo.
get_fitting_rectangle(rectangle, pixels, width, height)	Obtiene el rectángulo que se ajusta a la imagen actual.
get_fitting_rectangle(rectangle, width, height)	Obtiene el rectángulo que se ajusta a la imagen actual.
get_original_options()	Obtiene las opciones basadas en la configuración original del archivo. Esto puede ser útil para mantener la profundidad de bits y otros parámetros de la imagen original sin cambios. Por ejemplo, si cargamos una imagen PNG en blanco y negro con 1 bit por píxel y luego la guardamos usando el método DataStreamSupporter.save(file_path), se producirá una imagen PNG de salida con 8 bits por píxel. Para evitarlo y guardar la imagen PNG con 1 bit por píxel, use este método para obtener las opciones de guardado correspondientes y páselas al método Image.save(file_path, options) como segundo parámetro.
get_proportional_height(width, height, new_width)	Obtiene una altura proporcional.
get_proportional_width(width, height, new_height)	Obtiene un ancho proporcional.
get_serialized_stream(image_options, clipping_rectangle, page_number)	Convierte a aps.
load(file_path)	Carga una nueva imagen desde la ruta de archivo o URL especificada. Si filePath es una ruta de archivo, el método simplemente abre el archivo. Si filePath es una URL, el método descarga el archivo, lo almacena como uno temporal y lo abre.
load(file_path, load_options)	Carga una nueva imagen desde la ruta de archivo o URL especificada. Si filePath es una ruta de archivo, el método simplemente abre el archivo. Si filePath es una URL, el método descarga el archivo, lo almacena como uno temporal y lo abre.
load(stream)	Carga una nueva imagen desde el flujo especificado.
load(stream, load_options)	Carga una nueva imagen desde el flujo especificado.
load_stream(stream)	Carga una nueva imagen desde el flujo especificado.
load_stream_with_options(stream, load_options)	Carga una nueva imagen desde el flujo especificado.
load_with_options(file_path, load_options)	Carga una nueva imagen desde la ruta de archivo o URL especificada. Si filePath es una ruta de archivo, el método simplemente abre el archivo. Si filePath es una URL, el método descarga el archivo, lo almacena como uno temporal y lo abre.
remove_background()	Elimina el fondo.
remove_background(settings)	Elimina el fondo.
remove_metadata()	Elimina los metadatos.
resize(new_width, new_height)	Redimensiona la imagen. Se utiliza el valor predeterminado ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.
resize(new_width, new_height, resize_type)	Redimensiona la imagen.
resize(new_width, new_height, settings)	Redimensiona la imagen.
resize_by_settings(new_width, new_height, settings)	Redimensiona la imagen.
resize_by_type(new_width, new_height, resize_type)	Redimensiona la imagen.
resize_height_proportionally(new_height)	Redimensiona la altura proporcionalmente. Se utiliza el valor predeterminado ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.
resize_height_proportionally(new_height, resize_type)	Redimensiona la altura proporcionalmente.
resize_height_proportionally(new_height, settings)	Redimensiona la altura proporcionalmente.
resize_height_proportionally_settings(new_height, settings)	Redimensiona la altura proporcionalmente.
resize_width_proportionally(new_width)	Redimensiona el ancho proporcionalmente. Se utiliza el valor predeterminado ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.
resize_width_proportionally(new_width, resize_type)	Redimensiona el ancho proporcionalmente.
resize_width_proportionally(new_width, settings)	Redimensiona el ancho proporcionalmente.
resize_width_proportionally_settings(new_width, settings)	Redimensiona el ancho proporcionalmente.
rotate(angle)	Rotar la imagen alrededor del centro.
rotate_flip(rotate_flip_type)	Rota, voltea o rota y voltea la imagen.
save()	Guarda los datos de la imagen en el flujo subyacente.
save(file_path)	Guarda la imagen en la ubicación de archivo especificada.
save(file_path, options)	Guarda los datos del objeto en la ubicación de archivo especificada en el formato de archivo indicado según las opciones de guardado.
save(file_path, options, bounds_rectangle)	Guarda los datos del objeto en la ubicación de archivo especificada en el formato de archivo indicado según las opciones de guardado.
save(file_path, over_write)	Guarda los datos del objeto en la ubicación de archivo especificada.
save(stream)	Guarda los datos.
save(stream, options_base)	Guarda los datos de la imagen en el flujo especificado en el formato de archivo indicado según las opciones de guardado.
save(stream, options_base, bounds_rectangle)	Guarda los datos de la imagen en el flujo especificado en el formato de archivo indicado según las opciones de guardado.
save_to_stream(stream)	Guarda los datos del objeto en el flujo especificado.
save_to_stream_with_options(stream, options_base)	Guarda los datos de la imagen en el flujo especificado en el formato de archivo indicado según las opciones de guardado.
save_to_stream_with_options_rect(stream, options_base, bounds_rectangle)	Guarda los datos de la imagen en el flujo especificado en el formato de archivo indicado según las opciones de guardado.
save_with_options(file_path, options)	Guarda los datos del objeto en la ubicación de archivo especificada en el formato de archivo indicado según las opciones de guardado.
save_with_options_rect(file_path, options, bounds_rectangle)	Guarda los datos del objeto en la ubicación de archivo especificada en el formato de archivo indicado según las opciones de guardado.
set_palette(palette, update_colors)	Personalice la paleta de colores de la imagen con este método intuitivo. Ideal para desarrolladores que buscan aplicar esquemas de color o ajustes específicos de forma dinámica, garantizando un control preciso sobre la apariencia visual de sus imágenes.
try_set_metadata(metadata)	Intenta establecer una instancia de metadata, si esta instancia de Image admite e implementa la instancia IImageMetadataFormat.

Constructor: CmxImage(stream_container, load_options)

 CmxImage(stream_container, load_options)

Comience a trabajar con la clase CmxImage de forma fluida inicializando
una nueva instancia con los parámetros streamContainer y loadOptions. Ideal para desarrolladores
que buscan una manera conveniente de cargar imágenes CMX desde diversas fuentes de datos mientras
personalizan el proceso de carga según sea necesario.

Parameters:

Parámetro	Tipo	Descripción
stream_container	StreamContainer	El contenedor del flujo.
load_options	LoadOptions	Las opciones de carga.

Property: pages

Recupere las páginas de la imagen sin problemas con esta propiedad intuitiva.
Ideal para desarrolladores que buscan acceder y manipular páginas individuales
dentro de imágenes multipágina, asegurando una navegación y procesamiento eficientes.

See also:

Example # 1: The following example shows how to cache all pages of a CMX image.

Method: can_load(file_path) [static]

 can_load(file_path)

Determina si la imagen puede cargarse desde la ruta de archivo especificada.

Parameters:

Parámetro	Tipo	Descripción
file_path	string	La ruta del archivo.

Returns

Tipo	Descripción
bool	true si la imagen puede cargarse desde el archivo especificado; de lo contrario, false.

Method: can_load(file_path, load_options) [static]

 can_load(file_path, load_options)

Determina si la imagen puede cargarse desde la ruta de archivo especificada y, opcionalmente, usando las opciones de apertura especificadas.

Parameters:

Parámetro	Tipo	Descripción
file_path	string	La ruta del archivo.
load_options	LoadOptions	Las opciones de carga.

Returns

Tipo	Descripción
bool	true si la imagen puede cargarse desde el archivo especificado; de lo contrario, false.

Method: can_load(stream) [static]

 can_load(stream)

Determina si la imagen puede cargarse desde el flujo especificado.

Parameters:

Parámetro	Tipo	Descripción
flujo	_io.BufferedRandom	El flujo desde el cual cargar.

Returns

Tipo	Descripción
bool	true si la imagen puede cargarse desde el flujo especificado; de lo contrario, false.

Method: can_load(stream, load_options) [static]

 can_load(stream, load_options)

Determina si la imagen puede cargarse desde el flujo especificado y, opcionalmente, usando los loadOptions especificados.

Parameters:

Parámetro	Tipo	Descripción
flujo	_io.BufferedRandom	El flujo desde el cual cargar.
load_options	LoadOptions	Las opciones de carga.

Returns

Tipo	Descripción
bool	true si la imagen puede cargarse desde el flujo especificado; de lo contrario, false.

Method: can_load_stream(stream) [static]

 can_load_stream(stream)

Determina si la imagen puede cargarse desde el flujo especificado.

Parameters:

Parámetro	Tipo	Descripción
flujo	_io.BufferedRandom	El flujo desde el cual cargar.

Returns

Tipo	Descripción
bool	true si la imagen puede cargarse desde el flujo especificado; de lo contrario, false.

Method: can_load_stream_with_options(stream, load_options) [static]

 can_load_stream_with_options(stream, load_options)

Determina si la imagen puede cargarse desde el flujo especificado y, opcionalmente, usando los loadOptions especificados.

Parameters:

Parámetro	Tipo	Descripción
flujo	_io.BufferedRandom	El flujo desde el cual cargar.
load_options	LoadOptions	Las opciones de carga.

Returns

Tipo	Descripción
bool	true si la imagen puede cargarse desde el flujo especificado; de lo contrario, false.

Method: can_load_with_options(file_path, load_options) [static]

 can_load_with_options(file_path, load_options)

Determina si la imagen puede cargarse desde la ruta de archivo especificada y, opcionalmente, usando las opciones de apertura especificadas.

Parameters:

Parámetro	Tipo	Descripción
file_path	string	La ruta del archivo.
load_options	LoadOptions	Las opciones de carga.

Returns

Tipo	Descripción
bool	true si la imagen puede cargarse desde el archivo especificado; de lo contrario, false.

Method: can_save(options)

 can_save(options)

Determina si la imagen puede guardarse en el formato de archivo especificado representado por las opciones de guardado proporcionadas.

Parameters:

Parámetro	Tipo	Descripción
options	ImageOptionsBase	Las opciones de guardado a usar.

Returns

Tipo	Descripción
bool	true si la imagen puede guardarse en el formato de archivo especificado representado por las opciones de guardado proporcionadas; de lo contrario, false.

Method: create(files) [static]

 create(files)

Crea la imagen multipágina que contiene los archivos especificados.

Parameters:

Parámetro	Tipo	Descripción
files	string[]	Los archivos.

Returns

Tipo	Descripción
Image	La imagen multipágina

Method: create(files, throw_exception_on_load_error) [static]

 create(files, throw_exception_on_load_error)

Crea la imagen multipágina que contiene los archivos especificados.

Parameters:

Parámetro	Tipo	Descripción
files	string[]	Los archivos.
throw_exception_on_load_error	bool	si se establece en true [lanzar excepción al error de carga].

Returns

Tipo	Descripción
Image	La imagen multipágina

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

 create(image_options, width, height)

Crea una nueva imagen usando las opciones de creación especificadas.

Parameters:

Parámetro	Tipo	Descripción
image_options	ImageOptionsBase	Las opciones de la imagen.
width	int	El ancho.
height	int	La altura.

Returns

Tipo	Descripción
Image	La imagen recién creada.

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

 create(image_options, width, height, pixels)

Crea una instancia de RasterImage a partir del arreglo de píxeles proporcionado.

Valida que el ancho y alto especificados coincidan con las dimensiones de los datos de píxeles.
Este método solo puede usarse cuando la biblioteca está en modo Licenciado.

Parameters:

Parámetro	Tipo	Descripción
image_options	ImageOptionsBase	Las opciones usadas para crear el RasterImage.
width	int	El ancho del RasterImage.
height	int	La altura del RasterImage.
píxeles	int[]	La matriz de valores de píxeles usada para poblar la imagen.

Returns

Tipo	Descripción
Image	Una RasterImage poblada con los datos de píxeles proporcionados.

Method: create(images) [static]

 create(images)

Crea una nueva imagen usando las imágenes especificadas como páginas

Parameters:

Parámetro	Tipo	Descripción
images	Image[]	Las imágenes.

Returns

Tipo	Descripción
Image	La Imagen como IMultipageImage

Method: create(images, dispose_images) [static]

 create(images, dispose_images)

Crea una nueva imagen con las imágenes especificadas como páginas.

Parameters:

Parámetro	Tipo	Descripción
images	Image[]	Las imágenes.
dispose_images	bool	si se establece en true [eliminar imágenes].

Returns

Tipo	Descripción
Image	La Imagen como IMultipageImage

Method: create(multipage_create_options) [static]

 create(multipage_create_options)

Crea las opciones de creación multipágina especificadas.

Parameters:

Parámetro	Tipo	Descripción
multipage_create_options	MultipageCreateOptions	Las opciones de creación multipágina.

Returns

Tipo	Descripción
Image	La imagen multipágina

Method: create_from_files(files) [static]

 create_from_files(files)

Crea la imagen multipágina que contiene los archivos especificados como páginas de carga diferida.

Parameters:

Parámetro	Tipo	Descripción
files	string[]	Los archivos.

Returns

Tipo	Descripción
Image	La imagen multipágina

Method: create_from_files(files, throw_exception_on_load_error) [static]

 create_from_files(files, throw_exception_on_load_error)

Crea la imagen multipágina que contiene los archivos especificados como páginas de carga diferida.

Parameters:

Parámetro	Tipo	Descripción
files	string[]	Los archivos.
throw_exception_on_load_error	bool	si se establece en true lanzar excepción al error de carga.

Returns

Tipo	Descripción
Image	La imagen multipágina

Method: create_from_images(images) [static]

 create_from_images(images)

Crea una nueva imagen usando las imágenes especificadas como páginas

Parameters:

Parámetro	Tipo	Descripción
images	Image[]	Las imágenes.

Returns

Tipo	Descripción
Image	La Imagen como IMultipageImage

Method: create_from_images(images, dispose_images) [static]

 create_from_images(images, dispose_images)

Crea una nueva imagen con las imágenes especificadas como páginas.

Parameters:

Parámetro	Tipo	Descripción
images	Image[]	Las imágenes.
dispose_images	bool	si se establece en true [eliminar imágenes].

Returns

Tipo	Descripción
Image	La Imagen como IMultipageImage

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

 crop(left_shift, right_shift, top_shift, bottom_shift)

Recortar la imagen con desplazamientos.

Parameters:

Parámetro	Tipo	Descripción
left_shift	int	El desplazamiento a la izquierda.
right_shift	int	El desplazamiento a la derecha.
top_shift	int	El desplazamiento superior.
bottom_shift	int	El desplazamiento inferior.

Method: crop(rectangle)

 crop(rectangle)

Recorta el rectángulo especificado.

Parameters:

Parámetro	Tipo	Descripción
rectangle	Rectangle	El rectángulo.

Method: get_default_options(args)

 get_default_options(args)

Obtiene las opciones de imagen predeterminadas.

Parameters:

Parámetro	Tipo	Descripción
args	System.Object	Los argumentos.

Returns

Tipo	Descripción
ImageOptionsBase	Las opciones de imagen predeterminadas.

Method: get_embedded_images()

 get_embedded_images()

Obtiene las imágenes incrustadas.

Returns

Tipo	Descripción
EmbeddedImage[]	Matriz de imágenes

Method: get_file_format(file_path) [static]

 get_file_format(file_path)

Obtiene el formato de archivo.

Parameters:

Parámetro	Tipo	Descripción
file_path	string	La ruta del archivo.

Returns

Tipo	Descripción
FileFormat	El formato de archivo determinado.

Method: get_file_format(stream) [static]

 get_file_format(stream)

Obtiene el formato de archivo.

Parameters:

Parámetro	Tipo	Descripción
flujo	_io.BufferedRandom	El flujo.

Returns

Tipo	Descripción
FileFormat	El formato de archivo determinado.

Method: get_file_format_of_stream(stream) [static]

 get_file_format_of_stream(stream)

Obtiene el formato de archivo.

Parameters:

Parámetro	Tipo	Descripción
flujo	_io.BufferedRandom	El flujo.

Returns

Tipo	Descripción
FileFormat	El formato de archivo determinado.

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

 get_fitting_rectangle(rectangle, pixels, width, height)

Obtiene el rectángulo que se ajusta a la imagen actual.

Parameters:

Parámetro	Tipo	Descripción
rectangle	Rectangle	El rectángulo para obtener el rectángulo de ajuste.
píxeles	int[]	Los píxeles ARGB de 32 bits.
width	int	El ancho del objeto.
height	int	La altura del objeto.

Returns

Tipo	Descripción
Rectangle	El rectángulo de ajuste o excepción si no se puede encontrar un rectángulo de ajuste.

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

 get_fitting_rectangle(rectangle, width, height)

Obtiene el rectángulo que se ajusta a la imagen actual.

Parameters:

Parámetro	Tipo	Descripción
rectangle	Rectangle	El rectángulo para obtener el rectángulo de ajuste.
width	int	El ancho del objeto.
height	int	La altura del objeto.

Returns

Tipo	Descripción
Rectangle	El rectángulo de ajuste o excepción si no se puede encontrar un rectángulo de ajuste.

Method: get_original_options()

 get_original_options()

Obtiene las opciones basadas en la configuración original del archivo.
Esto puede ser útil para mantener la profundidad de bits y otros parámetros de la imagen original sin cambios.
Por ejemplo, si cargamos una imagen PNG en blanco y negro con 1 bit por píxel y luego la guardamos usando el
método DataStreamSupporter.save(file_path), se producirá una imagen PNG de salida con 8 bits por píxel.
Para evitarlo y guardar la imagen PNG con 1 bit por píxel, use este método para obtener las opciones de guardado correspondientes y páselas
al método Image.save(file_path, options) como segundo parámetro.

Returns

Tipo	Descripción
ImageOptionsBase	Las opciones basadas en la configuración original del archivo.

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

 get_proportional_height(width, height, new_width)

Obtiene una altura proporcional.

Parameters:

Parámetro	Tipo	Descripción
width	int	El ancho.
height	int	La altura.
new_width	int	El nuevo ancho.

Returns

Tipo	Descripción
int	La altura proporcional.

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

 get_proportional_width(width, height, new_height)

Obtiene un ancho proporcional.

Parameters:

Parámetro	Tipo	Descripción
width	int	El ancho.
height	int	La altura.
new_height	int	La nueva altura.

Returns

Tipo	Descripción
int	El ancho proporcional.

Method: get_serialized_stream(image_options, clipping_rectangle, page_number)

 get_serialized_stream(image_options, clipping_rectangle, page_number)

Convierte a aps.

Parameters:

Parámetro	Tipo	Descripción
image_options	ImageOptionsBase	Las opciones de la imagen.
clipping_rectangle	Rectangle	El rectángulo de recorte.
page_number	int[]	El número de página.

Returns

Tipo	Descripción
_io.BufferedRandom	El flujo serializado

Method: load(file_path) [static]

 load(file_path)

Carga una nueva imagen desde la ruta de archivo o URL especificada.
Si filePath es una ruta de archivo, el método simplemente abre el archivo.
Si filePath es una URL, el método descarga el archivo, lo almacena como uno temporal y lo abre.

Parameters:

Parámetro	Tipo	Descripción
file_path	string	La ruta del archivo o URL desde la cual cargar la imagen.

Returns

Tipo	Descripción
Image	La imagen cargada.

Method: load(file_path, load_options) [static]

 load(file_path, load_options)

Parameters:

Parámetro	Tipo	Descripción
file_path	string	La ruta del archivo o URL desde la cual cargar la imagen.
load_options	LoadOptions	Las opciones de carga.

Returns

Tipo	Descripción
Image	La imagen cargada.

Method: load(stream) [static]

 load(stream)

Carga una nueva imagen desde el flujo especificado.

Parameters:

Parámetro	Tipo	Descripción
flujo	_io.BufferedRandom	El flujo desde el cual cargar la imagen.

Returns

Tipo	Descripción
Image	La imagen cargada.

Method: load(stream, load_options) [static]

 load(stream, load_options)

Carga una nueva imagen desde el flujo especificado.

Parameters:

Parámetro	Tipo	Descripción
flujo	_io.BufferedRandom	El flujo desde el cual cargar la imagen.
load_options	LoadOptions	Las opciones de carga.

Returns

Tipo	Descripción
Image	La imagen cargada.

Method: load_stream(stream) [static]

 load_stream(stream)

Carga una nueva imagen desde el flujo especificado.

Parameters:

Parámetro	Tipo	Descripción
flujo	_io.BufferedRandom	El flujo desde el cual cargar la imagen.

Returns

Tipo	Descripción
Image	La imagen cargada.

Method: load_stream_with_options(stream, load_options) [static]

 load_stream_with_options(stream, load_options)

Carga una nueva imagen desde el flujo especificado.

Parameters:

Parámetro	Tipo	Descripción
flujo	_io.BufferedRandom	El flujo desde el cual cargar la imagen.
load_options	LoadOptions	Las opciones de carga.

Returns

Tipo	Descripción
Image	La imagen cargada.

Method: load_with_options(file_path, load_options) [static]

 load_with_options(file_path, load_options)

Parameters:

Parámetro	Tipo	Descripción
file_path	string	La ruta del archivo o URL desde la cual cargar la imagen.
load_options	LoadOptions	Las opciones de carga.

Returns

Tipo	Descripción
Image	La imagen cargada.

Method: remove_background(settings)

 remove_background(settings)

Elimina el fondo.

Parameters:

Parámetro	Tipo	Descripción
settings	RemoveBackgroundSettings	La configuración.

Method: resize(new_width, new_height)

 resize(new_width, new_height)

Redimensiona la imagen. Se utiliza el valor predeterminado ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.

Parameters:

Parámetro	Tipo	Descripción
new_width	int	El nuevo ancho.
new_height	int	La nueva altura.

Method: resize(new_width, new_height, resize_type)

 resize(new_width, new_height, resize_type)

Redimensiona la imagen.

Parameters:

Parámetro	Tipo	Descripción
new_width	int	El nuevo ancho.
new_height	int	La nueva altura.
resize_type	ResizeType	El tipo de redimensionamiento.

Method: resize(new_width, new_height, settings)

 resize(new_width, new_height, settings)

Redimensiona la imagen.

Parameters:

Parámetro	Tipo	Descripción
new_width	int	El nuevo ancho.
new_height	int	La nueva altura.
settings	ImageResizeSettings	Los ajustes de redimensionamiento.

Method: resize_by_settings(new_width, new_height, settings)

 resize_by_settings(new_width, new_height, settings)

Redimensiona la imagen.

Parameters:

Parámetro	Tipo	Descripción
new_width	int	El nuevo ancho.
new_height	int	La nueva altura.
settings	ImageResizeSettings	Los ajustes de redimensionamiento.

Method: resize_by_type(new_width, new_height, resize_type)

 resize_by_type(new_width, new_height, resize_type)

Redimensiona la imagen.

Parameters:

Parámetro	Tipo	Descripción
new_width	int	El nuevo ancho.
new_height	int	La nueva altura.
resize_type	ResizeType	El tipo de redimensionamiento.

Method: resize_height_proportionally(new_height)

 resize_height_proportionally(new_height)

Redimensiona la altura proporcionalmente. Se utiliza el valor predeterminado ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.

Parameters:

Parámetro	Tipo	Descripción
new_height	int	La nueva altura.

Method: resize_height_proportionally(new_height, resize_type)

 resize_height_proportionally(new_height, resize_type)

Redimensiona la altura proporcionalmente.

Parameters:

Parámetro	Tipo	Descripción
new_height	int	La nueva altura.
resize_type	ResizeType	Tipo de redimensionamiento.

Method: resize_height_proportionally(new_height, settings)

 resize_height_proportionally(new_height, settings)

Redimensiona la altura proporcionalmente.

Parameters:

Parámetro	Tipo	Descripción
new_height	int	La nueva altura.
settings	ImageResizeSettings	Los ajustes de redimensionamiento de la imagen.

Method: resize_height_proportionally_settings(new_height, settings)

 resize_height_proportionally_settings(new_height, settings)

Redimensiona la altura proporcionalmente.

Parameters:

Parámetro	Tipo	Descripción
new_height	int	La nueva altura.
settings	ImageResizeSettings	Los ajustes de redimensionamiento de la imagen.

Method: resize_width_proportionally(new_width)

 resize_width_proportionally(new_width)

Redimensiona el ancho proporcionalmente. Se utiliza el valor predeterminado ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.

Parameters:

Parámetro	Tipo	Descripción
new_width	int	El nuevo ancho.

Method: resize_width_proportionally(new_width, resize_type)

 resize_width_proportionally(new_width, resize_type)

Redimensiona el ancho proporcionalmente.

Parameters:

Parámetro	Tipo	Descripción
new_width	int	El nuevo ancho.
resize_type	ResizeType	Tipo de redimensionamiento.

Method: resize_width_proportionally(new_width, settings)

 resize_width_proportionally(new_width, settings)

Redimensiona el ancho proporcionalmente.

Parameters:

Parámetro	Tipo	Descripción
new_width	int	El nuevo ancho.
settings	ImageResizeSettings	Los ajustes de redimensionamiento de la imagen.

Method: resize_width_proportionally_settings(new_width, settings)

 resize_width_proportionally_settings(new_width, settings)

Redimensiona el ancho proporcionalmente.

Parameters:

Parámetro	Tipo	Descripción
new_width	int	El nuevo ancho.
settings	ImageResizeSettings	Los ajustes de redimensionamiento de la imagen.

Method: rotate(angle)

 rotate(angle)

Rotar la imagen alrededor del centro.

Parameters:

Parámetro	Tipo	Descripción
angle	float	El ángulo de rotación en grados. Los valores positivos girarán en sentido horario.

Method: rotate_flip(rotate_flip_type)

 rotate_flip(rotate_flip_type)

Rota, voltea o rota y voltea la imagen.

Parameters:

Parámetro	Tipo	Descripción
rotate_flip_type	RotateFlipType	Tipo de rotación y volteo.

Method: save(file_path)

 save(file_path)

Guarda la imagen en la ubicación de archivo especificada.

Parameters:

Parámetro	Tipo	Descripción
file_path	string	La ruta del archivo donde guardar la imagen.

Method: save(file_path, options)

 save(file_path, options)

Guarda los datos del objeto en la ubicación de archivo especificada en el formato de archivo indicado según las opciones de guardado.

Parameters:

Parámetro	Tipo	Descripción
file_path	string	La ruta del archivo.
options	ImageOptionsBase	Las opciones.

Method: save(file_path, options, bounds_rectangle)

 save(file_path, options, bounds_rectangle)

Guarda los datos del objeto en la ubicación de archivo especificada en el formato de archivo indicado según las opciones de guardado.

Parameters:

Parámetro	Tipo	Descripción
file_path	string	La ruta del archivo.
options	ImageOptionsBase	Las opciones.
bounds_rectangle	Rectangle	El rectángulo de límites de la imagen de destino. Establezca el rectángulo vacío para usar los límites de origen.

Method: save(file_path, over_write)

 save(file_path, over_write)

Guarda los datos del objeto en la ubicación de archivo especificada.

Parameters:

Parámetro	Tipo	Descripción
file_path	string	La ruta del archivo donde guardar los datos del objeto.
sobrescribir	bool	si se establece en true sobrescribe el contenido del archivo, de lo contrario se añadirá.

Method: save(stream)

 save(stream)

Guarda los datos.

Parameters:

Parámetro	Tipo	Descripción
flujo	_io.BufferedRandom	El flujo donde guardar los datos.

Method: save(stream, options_base)

 save(stream, options_base)

Guarda los datos de la imagen en el flujo especificado en el formato de archivo indicado según las opciones de guardado.

Parameters:

Parámetro	Tipo	Descripción
flujo	_io.BufferedRandom	El flujo donde guardar los datos de la imagen.
options_base	ImageOptionsBase	Las opciones de guardado.

Method: save(stream, options_base, bounds_rectangle)

 save(stream, options_base, bounds_rectangle)

Guarda los datos de la imagen en el flujo especificado en el formato de archivo indicado según las opciones de guardado.

Parameters:

Parámetro	Tipo	Descripción
flujo	_io.BufferedRandom	El flujo donde guardar los datos de la imagen.
options_base	ImageOptionsBase	Las opciones de guardado.
bounds_rectangle	Rectangle	El rectángulo de límites de la imagen de destino. Establezca el rectángulo vacío para usar los límites de origen.

Method: save_to_stream(stream)

 save_to_stream(stream)

Guarda los datos del objeto en el flujo especificado.

Parameters:

Parámetro	Tipo	Descripción
flujo	_io.BufferedRandom	El flujo donde guardar los datos del objeto.

Method: save_to_stream_with_options(stream, options_base)

 save_to_stream_with_options(stream, options_base)

Guarda los datos de la imagen en el flujo especificado en el formato de archivo indicado según las opciones de guardado.

Parameters:

Parámetro	Tipo	Descripción
flujo	_io.BufferedRandom	El flujo donde guardar los datos de la imagen.
options_base	ImageOptionsBase	Las opciones de guardado.

Method: save_to_stream_with_options_rect(stream, options_base, bounds_rectangle)

 save_to_stream_with_options_rect(stream, options_base, bounds_rectangle)

Guarda los datos de la imagen en el flujo especificado en el formato de archivo indicado según las opciones de guardado.

Parameters:

Parámetro	Tipo	Descripción
flujo	_io.BufferedRandom	El flujo donde guardar los datos de la imagen.
options_base	ImageOptionsBase	Las opciones de guardado.
bounds_rectangle	Rectangle	El rectángulo de límites de la imagen de destino. Establezca el rectángulo vacío para usar los límites de origen.

Method: save_with_options(file_path, options)

 save_with_options(file_path, options)

Guarda los datos del objeto en la ubicación de archivo especificada en el formato de archivo indicado según las opciones de guardado.

Parameters:

Parámetro	Tipo	Descripción
file_path	string	La ruta del archivo.
options	ImageOptionsBase	Las opciones.

Method: save_with_options_rect(file_path, options, bounds_rectangle)

 save_with_options_rect(file_path, options, bounds_rectangle)

Guarda los datos del objeto en la ubicación de archivo especificada en el formato de archivo indicado según las opciones de guardado.

Parameters:

Parámetro	Tipo	Descripción
file_path	string	La ruta del archivo.
options	ImageOptionsBase	Las opciones.
bounds_rectangle	Rectangle	El rectángulo de límites de la imagen de destino. Establezca el rectángulo vacío para usar los límites de origen.

Method: set_palette(palette, update_colors)

 set_palette(palette, update_colors)

Personalice la paleta de colores de la imagen con este método intuitivo. Ideal para
desarrolladores que buscan aplicar esquemas de color o ajustes específicos de forma dinámica,
garantizando un control preciso sobre la apariencia visual de sus imágenes.

Parameters:

Parámetro	Tipo	Descripción
palette	IColorPalette	La paleta a establecer.
update_colors	bool	si se establece en true los colores se actualizarán según la nueva paleta; de lo contrario, los índices de color permanecerán sin cambios. Tenga en cuenta que los índices sin cambios pueden provocar un error al cargar la imagen si algunos índices no tienen entradas de paleta correspondientes.

Method: try_set_metadata(metadata)

 try_set_metadata(metadata)

Intenta establecer una instancia de metadata, si esta instancia de Image admite e implementa la instancia IImageMetadataFormat.

Parameters:

Parámetro	Tipo	Descripción
metadata	IImageMetadataFormat	Los metadatos.

Returns

Tipo	Descripción
bool	Verdadero si metadata no es nulo y la instancia de IMetadataContainer admite y/o implementa la instancia de IImageMetadataFormat; de lo contrario, falso.

Examples

The following example shows how to cache all pages of a CMX image.

import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.cmx import CmxImage
from os.path import join

dir_: str = "c:\\temp"
# Cargue una imagen desde un archivo CMX.
with aspycore.as_of(Image.load(join(dir_, "sample.cmx")), CmxImage) as image:
	# Esta llamada almacena en caché solo la página predeterminada.
	image.cache_data()
	# Almacene en caché todas las páginas para que no se realice ninguna carga adicional de datos desde el flujo de datos subyacente.
	for page in image.pages:
		page.cache_data()

Clase CmxImagePage