Clase SvgImage

Summary: Manipulate Scalar Vector Graphics (SVG) image files with our API, utilizing
the power of XML-based text format for seamless customization and scalability.
Easily load SVG images, rasterize vector elements, and convert to other formats,
while controlling compression levels to optimize file size and quality for your projects.

Module: aspose.imaging.fileformats.svg

Full Name: aspose.imaging.fileformats.svg.SvgImage

Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, IObjectWithSizeF, VectorImage

Constructors

Name	Descripción
SvgImage(path)	Instancia un nuevo objeto de la clase SvgImage, utilizando la ruta especificada para localizar y cargar la imagen. Este constructor facilita la creación de instancias de imágenes SVG a partir de archivos externos, permitiendo una integración fluida en sistemas y flujos de trabajo de software.
SvgImage(stream)	Crea una nueva instancia de la clase SvgImage, cargando la imagen desde el flujo proporcionado. Este constructor permite la carga directa de imágenes SVG desde flujos, mejorando la flexibilidad y eficiencia en el manejo de recursos de imagen dentro de aplicaciones de software.
SvgImage(svg_options, width, height)	Crea una nueva instancia de la clase SvgImage con opciones SVG especificadas, ancho y altura de la imagen. Este constructor permite a los desarrolladores inicializar imágenes SVG con opciones y dimensiones personalizadas, proporcionando flexibilidad en la gestión del contenido y diseño SVG.
SvgImage(width, height)	Instancia un nuevo objeto SvgImage con el ancho y altura especificados. Este constructor permite a los desarrolladores crear imágenes SVG con dimensiones predefinidas, facilitando un control preciso sobre el tamaño de la imagen durante la inicialización.

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. Es importante notar que este parámetro no se aplica a imágenes vectoriales, ya que no se miden en píxeles. Esta propiedad proporciona información crucial sobre la profundidad de color de la imagen, ayudando en tareas de procesamiento y manipulación.
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.
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	Obtiene el formato de archivo de la imagen, proporcionando metadatos esenciales para el procesamiento y la verificación de compatibilidad. Esta propiedad es fundamental para determinar las estrategias de decodificación y codificación adecuadas para manejar los datos de la imagen de manera eficaz en diferentes sistemas y 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	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 la necesidad de operaciones adicionales de lectura de datos. Esta propiedad brinda información sobre el estado actual de la caché, optimizando la recuperación y los flujos de procesamiento de datos para mejorar el rendimiento y la eficiencia.
metadata	ImageMetadata	r	Obtiene los metadatos de la imagen.
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	Obtiene el ancho del objeto, en pulgadas.
xmp_data	XmpPacketWrapper	r/w	Obtiene o establece los datos Xmp.

Methods

Name	Descripción
cache_data()	Ponga en caché los datos y garantice que no habrá más cargas de datos desde el DataStreamSupporter.data_stream_container subyacente. Esta optimización mejora el rendimiento al eliminar operaciones redundantes de recuperación de datos, especialmente útil en escenarios que requieren acceso frecuente a los datos de la imagen.
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.
create_from_stream(stream)	Inicializa una nueva instancia de la clase SvgImage.
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 la sección SVG.
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 para que se ajuste a las dimensiones especificadas mientras preserva su relación de aspecto ratio. Este método proporciona una forma conveniente de ajustar el tamaño de la imagen sin distorsionar sus proporciones, garantizando una visualización o almacenamiento óptimo según las dimensiones deseadas.
resize(new_width, new_height, settings)	Redimensiona la imagen con opciones extendidas.
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)	Aplica una paleta especificada a la imagen, permitiendo la personalización de esquemas de color para propósitos estéticos o funcionales. Este método brinda flexibilidad en la gestión de paletas de colores para adaptarse a diversos requisitos de diseño o aplicación.
try_set_metadata(metadata)	Intenta establecer una instancia de metadata, si esta instancia de Image admite e implementa la instancia IImageMetadataFormat.

Constructor: SvgImage(path)

 SvgImage(path) 

Instancia un nuevo objeto de la clase SvgImage, utilizando la
ruta especificada para localizar y cargar la imagen. Este constructor facilita la
creación de instancias de imágenes SVG a partir de archivos externos, permitiendo una integración fluida
en sistemas y flujos de trabajo de software.

Parameters:

Parámetro	Tipo	Descripción
ruta	string	La ruta desde la cual cargar la imagen e inicializar los datos de píxeles y paleta.

Constructor: SvgImage(stream)

 SvgImage(stream) 

Crea una nueva instancia de la clase SvgImage, cargando la imagen
desde el flujo proporcionado. Este constructor permite la carga directa de imágenes SVG
desde flujos, mejorando la flexibilidad y eficiencia en el manejo de recursos de imagen
dentro de aplicaciones de software.

Parameters:

Parámetro	Tipo	Descripción
flujo	_io.BufferedRandom	El flujo desde el cual cargar la imagen e inicializar los datos de píxeles y paleta.

See also:

Example # 1: This example shows how to load an SVG image from a file stream and rasterize …

Constructor: SvgImage(svg_options, width, height)

 SvgImage(svg_options, width, height) 

Crea una nueva instancia de la clase SvgImage con opciones SVG especificadas, ancho y altura de la imagen. Este constructor permite
a los desarrolladores inicializar imágenes SVG con opciones y dimensiones personalizadas,
proporcionando flexibilidad en la gestión del contenido y diseño SVG.

Parameters:

Parámetro	Tipo	Descripción
svg_options	SvgOptions	Las opciones SVG.
width	int	Ancho de la imagen.
height	int	Altura de la imagen.

Constructor: SvgImage(width, height)

 SvgImage(width, height) 

Instancia un nuevo objeto SvgImage con el ancho y
altura especificados. Este constructor permite a los desarrolladores crear imágenes SVG con dimensiones predefinidas,
facilitando un control preciso sobre el tamaño de la imagen durante
la inicialización.

Parameters:

Parámetro	Tipo	Descripción
width	int	El ancho de la imagen.
height	int	El alto de la imagen.

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: create_from_stream(stream) [static]

 create_from_stream(stream) 

Inicializa una nueva instancia de la clase SvgImage.

Parameters:

Parámetro	Tipo	Descripción
flujo	_io.BufferedRandom	El flujo desde el cual cargar la imagen e inicializar los datos de píxeles y paleta.

Returns

Tipo	Descripción
SvgImage

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 la sección SVG.

Parameters:

Parámetro	Tipo	Descripción
flujo	_io.BufferedRandom

Returns

Tipo	Descripción
Image

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 para que se ajuste a las dimensiones especificadas mientras preserva su relación de aspecto
ratio. Este método proporciona una forma conveniente de ajustar el tamaño de la imagen
sin distorsionar sus proporciones, garantizando una visualización o almacenamiento óptimo
según las dimensiones deseadas.

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 con opciones extendidas.

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) 

Aplica una paleta especificada a la imagen, permitiendo la personalización de esquemas de color
para propósitos estéticos o funcionales. Este método brinda flexibilidad
en la gestión de paletas de colores para adaptarse a diversos requisitos de diseño o aplicación.

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

This example shows how to load an SVG image from a file stream and rasterize it to PNG.

import aspose.pycore as aspycore
from os.path import join
from aspose.imaging.fileformats.svg import SvgImage
from aspose.imaging.imageoptions import PngOptions, SvgRasterizationOptions

dir_: str = "c:\\temp"
# Carga una imagen SVG desde un flujo de archivo.
with open(join(dir_, "test.svg"), "rb") as stream:
	with SvgImage(stream) as svg_image:
		# Para rasterizar SVG necesitamos especificar opciones de rasterización.
		rasterization_options = SvgRasterizationOptions()
		save_options = PngOptions()
		save_options.vector_rasterization_options = rasterization_options
		svg_image.save(join(dir_, "test.output.png"), save_options)

The following example shows how to convert compressed images (.emz,.wmz, *.svgz) to a raster format

from aspose.imaging import Image, Color
from aspose.imaging.imageoptions import PngOptions, VectorRasterizationOptions
from os.path import join
from aspose.pycore import as_of

files = ["example.emz", "example.wmz", "example.svgz"]
base_folder: str = join("D:", "Compressed")
for file in files:
	input_file: str = join(base_folder, file)
	out_file: str = input_file + ".png"
	with Image.load(input_file) as image:
		vector_rasterization_options = aspycore.as_of(image.get_default_options([Color.white, image.width, image.height]), VectorRasterizationOptions)
		obj_init = PngOptions()
		obj_init.vector_rasterization_options = vector_rasterization_options
		image.save(out_file, obj_init)

The following example shows how to convert a svgz images to svg fromat

import aspose.pycore as aspycore
from aspose.imaging import Image, SizeF
from aspose.imaging.imageoptions import SvgRasterizationOptions, SvgOptions
from os.path import join

file: str = "example.svgz"
base_folder: str = join("D:", "Compressed")
input_file: str = join(base_folder, file)
out_file: str = input_file + ".svg"
with Image.load(input_file) as image:
	obj_init = SvgRasterizationOptions()
	obj_init.page_size = aspycore.cast(SizeF, image.size)
	obj_init2 = SvgOptions()
	obj_init2.vector_rasterization_options = obj_init
	image.save(out_file, obj_init2)

The following example shows how to convert a svg images to svgz format

from os.path import join as path_combine
import aspose.pycore as aspycore
from aspose.imaging import Image, SizeF
from aspose.imaging.imageoptions import SvgRasterizationOptions, SvgOptions

file = "juanmontoya_lingerie.svg"
base_folder = path_combine("D:", "Compressed")
input_file = path_combine(base_folder, file)
out_file = input_file + ".svgz"
with Image.load(input_file) as image:
	vector_rasterization_options = SvgRasterizationOptions()
	vector_rasterization_options.page_size = aspycore.cast(SizeF, image.size)
	obj_init2 = SvgOptions()
	obj_init2.vector_rasterization_options = vector_rasterization_options
	obj_init2.compress = True
	image.save(out_file, obj_init2)