Clase OtgImage

Summary: Process OpenDocument Template (OTG) drawing image files with our API, leveraging
the OpenDocument XML format with Graphics Content for seamless manipulation.
Easily parse documents, customize background colors, and adjust page dimensions,
ensuring optimal control and flexibility for your OTG vector graphics projects.

Module: aspose.imaging.fileformats.opendocument

Full Name: aspose.imaging.fileformats.opendocument.OtgImage

Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, IObjectWithSizeF, IMultipageImage, OdImage

Constructors

Name	Descripción
OtgImage(stream_container)	Cree un nuevo objeto de la clase OtgImage proporcionando un flujo contenedor. Este constructor permite a los desarrolladores crear imágenes OTG directamente desde contenedores de flujo, simplificando el proceso de trabajo con datos de imágenes OTG.
OtgImage(stream_container, load_options)	Inicialice un nuevo objeto de la clase OtgImage proporcionando un contenedor de flujo y opciones de carga. Este constructor permite a los desarrolladores cargar eficientemente imágenes OTG desde flujos mientras especifican configuraciones de carga personalizadas.

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	Obtiene el recuento de bits por píxel de la imagen. Esta propiedad brinda información sobre el nivel de detalle y la profundidad de color representada en la imagen, ayudando en diversas tareas de procesamiento de imágenes y optimizaciones.
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.
container	Image	r	Obtiene el contenedor Image.
data_stream_container	StreamContainer	r	Obtiene el flujo de datos del objeto.
default_page	Image	r	Obtiene la página predeterminada asociada a la imagen, proporcionando acceso esencial a la página principal dentro de la colección de imágenes. Esta propiedad simplifica la navegación y manipulación de datos de la imagen, mejorando la eficiencia de los flujos de trabajo de desarrollo de software.
disposed	bool	r	Obtiene un valor que indica si esta instancia está disposed.
exif_data	ExifData	r/w	Obtiene o establece la instancia Exif.
file_format	FileFormat	r	Esta propiedad brinda acceso al formato de archivo OTG, ofreciendo información crucial sobre el tipo de datos encapsulados dentro del archivo de imagen. Sirve como un punto de referencia fundamental para los desarrolladores de software, permitiéndoles manejar eficazmente archivos OTG dentro de sus aplicaciones. Al utilizar esta propiedad, puede determinar el formato específico del archivo de imagen, facilitando una integración fluida y la manipulación de archivos OTG en sus sistemas de software.
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 del objeto.
height_f	float	r	Obtiene la altura del objeto, en pulgadas.
interrupt_monitor	InterruptMonitor	r/w	Obtiene o establece el monitor de interrupciones.
is_cached	bool	r	Obtiene un valor booleano que indica si los datos del objeto están actualmente en caché, eliminando así la necesidad de leer los datos. Esta propiedad actúa como un indicador de optimización, mejorando el rendimiento al minimizar operaciones redundantes de acceso a datos.
metadata	OdMetadata	r	Obtiene los metadatos específicos de los archivos OpenDocument. Esta propiedad permite el acceso a información esencial incrustada en los archivos OD, facilitando diversas operaciones como la extracción, modificación o análisis de los metadatos.
page_count	int	r	Obtiene el recuento total de páginas dentro de la imagen. Esta propiedad es esencial para aplicaciones que gestionan imágenes multipágina, permitiéndoles determinar con precisión el número de páginas disponibles para procesamiento o visualización.
pages	Image[]	r	Obtiene la colección de páginas asociadas a la imagen, permitiendo a los desarrolladores de software acceder y manipular cada página individual de manera eficiente. Esta propiedad facilita una iteración fluida a través de las páginas para diversas operaciones, mejorando la funcionalidad y versatilidad de las aplicaciones de procesamiento de imágenes.
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.
records	OdObject[]	r	Obtiene los registros OpenDocument almacenados dentro de la imagen. Esta propiedad otorga acceso a elementos de datos estructurados específicos incrustados en los archivos OpenDocument, facilitando la recuperación o manipulación de información relevante para un procesamiento o análisis posterior.
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 del objeto.
width_f	float	r	Obtiene el ancho del objeto, en pulgadas.
xmp_data	XmpPacketWrapper	r/w	Obtiene o establece los datos Xmp.

Methods

Name	Descripción
cache_data()	Almacena en caché los datos y garantiza que no se cargará información adicional desde el subyacente DataStreamSupporter.data_stream_container.
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)	Establece la paleta de la imagen.
try_set_metadata(metadata)	Intenta establecer una instancia de metadata, si esta instancia de Image admite e implementa la instancia IImageMetadataFormat.

Constructor: OtgImage(stream_container)

 OtgImage(stream_container) 

Cree un nuevo objeto de la clase OtgImage proporcionando un flujo
contenedor. Este constructor permite a los desarrolladores crear imágenes OTG directamente desde
contenedores de flujo, simplificando el proceso de trabajo con datos de imágenes OTG.

Parameters:

Parámetro	Tipo	Descripción
stream_container	StreamContainer	El contenedor del flujo.

Constructor: OtgImage(stream_container, load_options)

 OtgImage(stream_container, load_options) 

Inicialice un nuevo objeto de la clase OtgImage proporcionando un contenedor de flujo
y opciones de carga. Este constructor permite a los desarrolladores cargar eficientemente imágenes OTG
desde flujos mientras especifican configuraciones de carga personalizadas.

Parameters:

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

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) 

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.
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) 

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.
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) 

Establece la paleta de la imagen.

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 correspondientes en la paleta.

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 code snippet demonstrates how to convert an OTG image to PDF and other image formats.

from aspose.pycore import cast
from aspose.imaging import Image, SizeF
from aspose.imaging.imageoptions import PngOptions, PdfOptions, OtgRasterizationOptions

dir_: str = "c:\\3567\\"
input_file_path: str = dir_ + "VariousObjectsMultiPage.otg"
options = [PngOptions(), PdfOptions()]
for save_options in options:
	extension: str = ".png" if aspycore.is_assignable(save_options, PngOptions) else ".pdf"
	with Image.load(input_file_path) as image:
		otg_rasterization_options = OtgRasterizationOptions()
		otg_rasterization_options.page_size = cast(SizeF, image.size)
		save_options.vector_rasterization_options = otg_rasterization_options
		image.save(input_file_path + extension, save_options)