Clase Image

Summary: The image is the base class for all type of images.

Module: aspose.imaging

Full Name: aspose.imaging.Image

Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, DataStreamSupporter

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.
bounds	Rectangle	r	Obtiene los límites de la imagen.
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 los datos Exif.
file_format	FileFormat	r	Obtiene un valor del formato de archivo
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.
interrupt_monitor	InterruptMonitor	r/w	Obtiene o establece el monitor de interrupciones.
is_cached	bool	r	Obtiene un valor que indica si los datos del objeto están en caché actualmente y no se requiere lectura de datos.
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 de la imagen.
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.
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 realizará una carga adicional de datos desde el DataStreamSupporter.data_stream_container subyacente.
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 predeterminadas.
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_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 del objeto en el flujo especificado.
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 el tipo IImageMetadataFormat.

Property: use_palette

Obtiene un valor que indica si se usa la paleta de la imagen.

See also:

Example # 1: Determine if the palette is used by the 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.

See also:

Example # 1: This example determines whether image can be loaded from a file.

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.

See also:

Example # 1: This example determines whether image can be loaded from a file stream.

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.

See also:

Example # 1: This example shows how to determine whether image can be saved to the specifi…

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.

See also:

Example # 1: This example creates a new Image file at some disk location as specified by S…

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

Parameters:

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

Returns

Tipo	Descripción
ImageOptionsBase	Opciones predeterminadas

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.

See also:

Example # 1: This example shows how to determine the image format without loading the enti…

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.

See also:

Example # 1: This example shows how to determine the image format without loading the enti…

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.

See also:

Example # 1: This example demonstrates the loading of an existing Image file into an insta…

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.

See also:

Example # 1: This example demonstrates the use of a file stream objects to load an existin…

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

See also:

Example # 1: The following example shows how to resize a metafile (WMF and EMF).

Example # 2: The following example shows how to resize SVG image and save it to PNG.

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.

See also:

Example # 1: Resize image using specific Resize Type.

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.

See also:

Example # 1: This example loads an image and resizes it using various resizing settings.

Example # 2: Resize image using specific Resize Type.

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.

See also:

Example # 1: This example loads an image and resizes it proportionally using various resiz…

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.

See also:

Example # 1: This example loads an image and resizes it proportionally using various resiz…

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.

See also:

Example # 1: This example demonstrates the use of Rotate operation on an image. Example lo…

Example # 2: This example loads an image, rotates it by 90 degrees clockwise and optionall…

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.

See also:

Example # 1: This example shows the simple steps to save an Image. To demonstrate this ope…

Example # 2: The following example loads a BMP image from a file, then saves the image to …

Example # 3: The following example shows how to save an entire BMP image or part of it to …

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.

See also:

Example # 1: The following example loads a BMP image from a file, then saves a rectangular…

Example # 2: The following example shows how to save an entire BMP image or part of it to …

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

See also:

Example # 1: This example shows the process of saving an Image to MemoryStream. To demonst…

Example # 2: The following example loads an image from a file, then saves the image to a P…

Example # 3: The following example shows how to save an entire BMP image or part of it to …

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.

See also:

Example # 1: The following example loads an image from a file, then saves a rectangular pa…

Example # 2: The following example shows how to save an entire BMP image or part of it to …

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 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 el tipo IImageMetadataFormat.

Parameters:

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

Returns

Tipo	Descripción
bool	True, si la instancia de Image admite e implementa el tipo IImageMetadataFormat; de lo contrario, false.

Examples

This example demonstrates the loading of an existing Image file into an instance of aspose.imaging.Image using file path specified

from aspose.imaging import Image
# Crea una instancia de Image e inicialízala con un archivo de imagen existente en la ubicación del disco.
with Image.load(r"C:\temp\sample.bmp") as image:
	# realiza algún procesamiento de imagen
	pass

This example creates a new Image file at some disk location as specified by Source property of the BmpOptions instance. Several properties for BmpOptions instance are set before creating the actual image. Especially the Source property, that refers to the actual disk location in this case.

from aspose.imaging import Image
from aspose.imaging.imageoptions import BmpOptions
from aspose.imaging.sources import FileCreateSource

#Crea una instancia de `BmpOptions` y establece sus diversas propiedades
with BmpOptions() as bmp_options:
	bmp_options.bits_per_pixel = 24

	#Crea una instancia de `FileCreateSource` y asígnala como `source` para la instancia de `BmpOptions`
	#El segundo parámetro `Boolean` determina si el archivo a crear es_temporal o no
	bmp_options.source = FileCreateSource(r"C:\temp\output.bmp", False)

	#Crea una instancia de Image e inicialízala con una instancia de BmpOptions llamando al método Create
	with Image.create(bmp_options, 500, 500) as image:
		#realiza algún procesamiento de imagen
		# guarda todos los cambios
		image.save()

This example demonstrates the use of a file stream objects to load an existing Image file

from aspose.imaging import Image

# Crea una instancia de FileStream
with open(r"C:\temp\sample.bmp", "rb"):
	#Crea una instancia de la clase Image y carga un archivo existente a través del objeto FileStream llamando al método Load
	with Image.load(stream) as image:
		#realiza algún procesamiento de imágenes.
		pass

This example demonstrates the use of Rotate operation on an image. Example loads an existing image file from some disk location and performs the Rotate operation on the image according to the value of enumeration aspose.imaging.RotateFlipType

from aspose.imaging import Image, RotateFlipType
#Crea una instancia de la clase image y inicialízala con un archivo de imagen existente mediante la ruta del archivo
with Image.load(r"C:\temp\sample.bmp") as image:
	# rota la imagen 180 grados alrededor del eje X
	image.rotate_flip(RotateFlipType.ROTATE_180_FLIP_X)
	# guarde todos los cambios.
	image.save()

This example shows the simple steps to save an Image. To demonstrate this operation, we load an existing file from some disk location, performs rotate operation on the image and save the image in PSD format using file path

from aspose.imaging import Image, RotateFlipType
from aspose.imaging.imageoptions import PsdOptions
from os.path import join as path_join

directory = "c:\\temp"

#Crea una instancia de la clase image y inicialízala con un archivo existente mediante la ruta del archivo
with Image.load(path_join(directory, "sample.bmp")) as image:
	#Rota la imagen 180 grados alrededor del eje X
	image.rotate_flip(RotateFlipType.ROTATE_180_FLIP_X)
	#Guarda la Image como PSD en la ruta del archivo con la configuración predeterminada de PsdOptions
	image.save(path_join(directory, "output.psd"), PsdOptions())

This example shows the process of saving an Image to MemoryStream. To demonstrate this operation, example loads an existing file from some disk location, performs rotate operation on the image and save the image in PSD format

from aspose.imaging import Image, RotateFlipType
from aspose.imaging.imageoptions import PsdOptions
from aspose.imaging.extensions import StreamExtensions as stream_ext

#Crea una instancia de MemoryStream
with stream_ext.create_memory_stream() as stream:
	#Crea una instancia de la clase image y inicialízala con un archivo existente mediante la ruta del archivo
	with Image.load(r"C:\temp\sample.bmp") as image:
		#Rota la imagen 180 grados alrededor del eje X
		image.rotate_flip(RotateFlipType.ROTATE_180_FLIP_X)
		#Guarda la Image como PSD en MemoryStream con la configuración predeterminada de PsdOptions
		image.save(stream, PsdOptions())

This example determines whether image can be loaded from a file.

from aspose.imaging import Image

# Usa una ruta absoluta al archivo
can_load: bool = Image.can_load(r"c:\temp\sample.gif")

This example determines whether image can be loaded from a file stream.

from aspose.imaging import Image
from aspose.imaging.extensions import StreamExtensions as strm_ext
import os.path import join

directory = r"c:\temp"

canLoad = False

# Usa un flujo de archivo
with open(join(directory, "sample.bmp"), "rb"):
	canLoad = Image.can_load(stream)

print(f"Can load the file: {canLoad}")

# Los siguientes datos no son una secuencia de imagen válida, por lo que CanLoad devuelve false.
imageData = [0, 0, 0, 0, 0, 0, 0, 0]
with strm_ext.create_memory_stream_from_bytes(imageData) as stream:
	canLoad = Image.can_load(stream)

print(f"Can load the byte buffer: {canLoad}")

This example shows how to determine the image format without loading the entire image from a file.

from aspose.imaging import Image
from os.path import join as path_join

directory = "c:\\temp\\"

# Usa una ruta absoluta al archivo
file_format = Image.get_file_format(path_join(directory, "sample.gif"))
print(f"The file format is {file_format}")

This example shows how to determine the image format without loading the entire image from a file stream.

from aspose.imaging import Image
from aspose.imaging.extensions import StreamExtensions as strm_ex
from os.path import join as path_join

directory = "c:\\temp\\"

# Usa un flujo de archivo
with open(path_join(directory, "sample.bmp"), "rb") as stream:
	file_format = Image.get_file_format(stream)
	print(f"The file format is {file_format}")

# Los siguientes datos no son una secuencia de imagen válida, por lo que get_file_format devuelve FileFormat.UNKNOWN
imageData = bytearray([0, 0, 0, 0, 0, 0, 0, 0])
with strm_ex.create_memory_stream_from_bytes(imageData) as stream:
	file_format = Image.get_file_format(stream)
	print(f"The file format is {file_format}")

This example shows how to determine whether image can be saved to the specified file format represented by the passed save options.

from aspose.imaging import Image
from aspose.imaging.imageoptions import JpegOptions
from os.path import join as path_join

directory = "c:\\temp\\"

with Image.load(path_join(directory, "sample.gif")) as image:
	saveOptions = JpegOptions()
	saveOptions.quality = 50
	# Determina si la image puede guardarse en jpeg
	canSave: bool = image.can_save(saveOptions)
	print(canSave)

This example loads an image and resizes it using various resizing settings.

from aspose.imaging import Image, ImageResizeSettings, ResizeType, ImageFilterType,\
	ColorQuantizationMethod
from os.path import join as path_join

directory = "c:\\temp\\"

resizeSettings = ImageResizeSettings()

# El algoritmo adaptativo basado en función racional ponderada y combinada y en interpolación lanczos3.
resizeSettings.mode = ResizeType.ADAPTIVE_RESAMPLE
# El filtro rectangular pequeño
resizeSettings.filter_type = ImageFilterType.SMALL_RECTANGULAR
# El número de colores en la paleta.
resizeSettings.entries_count = 256
# La cuantización de color no se usa
resizeSettings.color_quantization_method = ColorQuantizationMethod.NONE

# El método euclidiano
resizeSettings.ColorCompareMethod = ColorCompareMethod.Euclidian;

with Image.load(path_join(directory, "sample.gif")) as image:
	# Reduce 2 veces usando remuestreo adaptativo.
	image.resize(image.width // 2, image.height // 2, resizeSettings)
	image.save(path_join(directory, "downsample.adaptive.gif"))

This example loads an image and resizes it proportionally using various resizing methods. Only the width is specified, the height is calculated automatically.

from aspose.imaging import Image, ResizeType
from os.path import join as path_join

directory = "c:\\temp\\"

with Image.load(path_join(directory, "sample.gif")) as image:
	# Escala 2 veces usando remuestreo del vecino más cercano.
	image.resize_width_proportionally(image.width * 2, ResizeType.NEAREST_NEIGHBOUR_RESAMPLE)
	image.save(path_join(directory, "upsample.nearestneighbour.gif"))

with Image.load(path_join(directory, "sample.gif")) as image:
	# Reduce 2 veces usando remuestreo del vecino más cercano.
	image.resize_width_proportionally(image.width // 2, ResizeType.NEAREST_NEIGHBOUR_RESAMPLE)
	image.save(path_join(directory, "downsample.nearestneighbour.gif"))

with Image.load(path_join(directory, "sample.gif")) as image:
	# Escala 2 veces usando remuestreo bilineal.
	image.resize_width_proportionally(image.width * 2, ResizeType.BILINEAR_RESAMPLE)
	image.save(path_join(directory, "upsample.bilinear.gif"))

with Image.load(path_join(directory, "sample.gif")) as image:
	# Reduce 2 veces usando remuestreo bilineal.
	image.resize_width_proportionally(image.width // 2, ResizeType.BILINEAR_RESAMPLE);
	image.save(path_join(directory, "downsample.bilinear.gif"))

This example loads an image and resizes it proportionally using various resizing methods. Only the height is specified, the width is calculated automatically.

from aspose.imaging import Image, ResizeType
from os.path import join as path_join

directory = "c:\\temp\\"

with Image.load(path_join(directory, "sample.gif")) as image:
	# Escala 2 veces usando remuestreo del vecino más cercano.
	image.resize_height_proportionally(image.height * 2, ResizeType.NEAREST_NEIGHBOUR_RESAMPLE)
	image.save(path_join(directory, "upsample.nearestneighbour.gif"))

with Image.load(path_join(directory, "sample.gif")) as image:
	# Reduce 2 veces usando remuestreo del vecino más cercano.
	image.resize_height_proportionally(image.height // 2, ResizeType.NEAREST_NEIGHBOUR_RESAMPLE)
	image.save(path_join(directory, "downsample.nearestneighbour.gif"))

with Image.load(path_join(directory, "sample.gif")) as image:
	# Escala 2 veces usando remuestreo bilineal.
	image.resize_height_proportionally(image.height * 2, ResizeType.BILINEAR_RESAMPLE)
	image.save(path_join(directory, "upsample.bilinear.gif"))

with Image.load(path_join(directory, "sample.gif")) as image:
	# Reduce 2 veces usando remuestreo bilineal.
	image.resize_height_proportionally(image.height // 2, ResizeType.BILINEAR_RESAMPLE)
	image.save(path_join(directory, "downsample.bilinear.gif"))

This example loads an image, rotates it by 90 degrees clockwise and optionally flips the image horizontally and(or) vertically.

from aspose.imaging import Image, RotateFlipType
from os.path import join as path_join

directory = "c:\\temp\\"

rotateFlipTypes = [RotateFlipType.ROTATE_90_FLIP_NONE, RotateFlipType.ROTATE_90_FLIP_X,
				   RotateFlipType.ROTATE_90_FLIP_XY, RotateFlipType.ROTATE_90_FLIP_Y]

for rotateFlipType in rotateFlipTypes:
	# Rotar, voltear y guardar en el archivo de salida.
	with Image.Load(path_join(directory, "sample.bmp")) as image:
		image.rotate_flip(rotateFlipType)
		image.save(path_join(directory, f"sample.{rotateFlipType}.bmp"))

The following example loads a BMP image from a file, then saves the image to a PNG file.

from aspose.imaging import Image
from aspose.imaging.imageoptions import PngOptions
from os.path import join as path_join

directory = r"c:\temp"

with Image.load(path_join(dir, "sample.bmp")) as image:
	# Guarda la imagen completa en un archivo PNG.
	save_options = PngOptions()
	image.save(path_join(dir, "output.png"), save_options)

The following example loads a BMP image from a file, then saves a rectangular part of the image to a PNG file.

from aspose.imaging import Image, Rectangle
from aspose.imaging.imageoptions import PngOptions
from os.path import join as path_join

directory = r"c:\temp"

with Image.load(path_join(dir, "sample.bmp")) as image:
	# Guarda la mitad superior de la imagen en un archivo PNG.
	save_options = PngOptions()
	bounds = Rectangle(0, 0, image.width, image.height // 2)
	image.save(path_join(dir, "output.png"), save_options, bounds)

The following example loads an image from a file, then saves the image to a PNG file stream.

from aspose.imaging import Image, Rectangle
from aspose.imaging.imageoptions import PngOptions
from os.path import join as path_join

directory = r"c:\temp"

with Image.load(path_join(dir, "sample.bmp")) as image:
	save_options = PngOptions()
	with open(path_join(dir, "output.png"), "w+b") as output_stream:
		# Guarda la imagen completa en un flujo de archivo.
		image.save(output_stream, save_options)

The following example loads an image from a file, then saves a rectangular part of the image to a PNG file stream.

from aspose.imaging import Image, Rectangle
from aspose.imaging.imageoptions import PngOptions
from os.path import join as path_join

directory = r"c:\temp"

with Image.load(path_join(dir, "sample.bmp")) as image:
	save_options = PngOptions()
	bounds = Rectangle(0, 0, image.width, image.height // 2)
	with open(path_join(dir, "output.png"), "w+b") as output_stream:
		# Guarda la mitad superior de la imagen en un flujo de archivo.
		image.save(output_stream, save_options, bounds)

The following example shows how to save an entire BMP image or part of it to a file or stream.

from os.path import join as path_join
from aspose.pycore import as_of
from aspose.imaging import Image, ColorPaletteHelper
from aspose.imaging.imageoptions import BmpOptions
from aspose.imaging.extensions import StreamExtensions as strm_ext

directory = "c:\\temp\\"
with Image.load(path_join(directory, "sample.bmp")) as image:
	bmpImage = as_of(image, BmpImage)
		
	# Convierte a una imagen blanco y negro
	bmpImage.binarize_otsu()

	# Guarda en la misma ubicación con las opciones predeterminadas.
	image.save()

	saveOptions = BmpOptions()

	# Una paleta contiene solo dos colores: negro y blanco en este caso.
	saveOptions.palette = ColorPaletteHelper.create_monochrome()

	# Para todas las imágenes monocromáticas (incluyendo las blanco y negro) basta con asignar 1 bit por píxel.
	saveOptions.bits_per_pixel = 1

	# Guarda en otra ubicación con las opciones especificadas.
	image.save(path_join(directory, "sample.bw.palettized.bmp"), saveOptions)

	# Guarda solo la parte central de la imagen.
	bounds = Rectangle(image.width // 4, image.height // 4, image.width // 2, image.height // 2)
	image.save(path_join(directory, "sample.bw.palettized.part.bmp"), saveOptions, bounds)

	# Guarda la imagen completa en un flujo de memoria
	with strm_ext.create_memory_stream() as stream:
		image.save(stream, saveOptions);
		print("The size of the whole image in bytes:", stream.tell())

	# Guarda la parte central de la imagen en un flujo de memoria
	with strm_ext.create_memory_stream() as stream:
		image.save(stream, saveOptions, bounds)
		print("The size of the central part of the image in bytes: ", stream.tell())

#La salida puede verse así:
#El tamaño de la imagen completa en bytes: 24062
#El tamaño de la parte central de la imagen en bytes: 6046

The following example shows how to resize a metafile (WMF and EMF).

import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.emf import MetaImage
from os.path import join

dir_ = "c:\\temp"
file_names = ["image3.emf", "image4.wmf"]
for file_name in file_names:
	input_file_path = join(dir_, file_name)
	output_file_path = join(dir_, "Downscale_" + file_name)
	with aspycore.as_of(Image.load(input_file_path), MetaImage) as image:
		image.resize(image.width // 4, image.height // 4)
		image.save(output_file_path)

The following example shows how to resize SVG image and save it to PNG.

from aspose.imaging import PointF, Image
from aspose.imaging.imageoptions import PngOptions
from os import path

dir_ = "c:\\aspose.imaging\\net\\issues\\3549"
file_names = ["Logotype.svg", "sample_car.svg", "rg1024_green_grapes.svg", "MidMarkerFigure.svg", "embeddedFonts.svg"]
scales = [PointF(0.5, 0.5), PointF(1.0, 1.0), PointF(2.0, 2.0), PointF(3.5, 9.2)]
for input_file in file_names:
	for scale in scales:
		output_file = "{0}_{1}_{2}.png".format(input_file, str(scale.x), str(scale.y))
		with Image.load(path.join(dir_, input_file)) as image:
			image.resize(int(image.width * scale.x), int(image.height * scale.y))
			image.save(path.join(dir_, output_file), PngOptions())

Resize image using specific Resize Type.

from aspose.imaging import Image, ResizeType, ImageResizeSettings, ImageFilterType

with Image.load("Photo.jpg") as image:
	image.resize(640, 480, ResizeType.CATMULL_ROM)
	image.save("ResizedPhoto.jpg")
	image.resize(1024, 768, ResizeType.CUBIC_CONVOLUTION)
	image.save("ResizedPhoto2.jpg")
	resize_settings = ImageResizeSettings()
	resize_settings.mode = ResizeType.CUBIC_BSPLINE
	resize_settings.filter_type = ImageFilterType.SMALL_RECTANGULAR
	image.resize(800, 800, resize_settings)
	image.save("ResizedPhoto3.jpg")

Determine if the palette is used by the image.

from aspose.imaging import Image

with Image.load("Sample.bmp") as image:
	if image.use_palette:
		print("The palette is used by the image")