Clase RasterImage

Summary: Represents a raster image supporting raster graphics operations.

Module: aspose.imaging

Full Name: aspose.imaging.RasterImage

Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, IRasterImageArgb32PixelLoader, IRasterImageRawDataLoader, Image

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_alpha	bool	r	Obtiene un valor que indica si esta instancia tiene alfa.
has_background_color	bool	r/w	Obtiene o establece un valor que indica si la imagen tiene color de fondo.
has_transparent_color	bool	r/w	Obtiene o establece un valor que indica si esta instancia de RasterImage tiene un color transparente.
height	int	r	Obtiene la altura de la imagen.
horizontal_resolution	float	r/w	Obtiene o establece la resolución horizontal, en píxeles por pulgada, de este RasterImage.
image_opacity	float	r	Obtiene la opacidad de esta 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.
is_raw_data_available	bool	r	Obtiene un valor que indica si la carga de datos sin procesar está disponible.
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.
premultiply_components	bool	r/w	Obtiene o establece un valor que indica si los componentes de la imagen deben ser premultiplicados.
raw_custom_color_converter	IColorConverter	r/w	Obtiene o establece el convertidor de color personalizado
raw_data_format	PixelDataFormat	r	Obtiene el formato de datos sin procesar.
raw_data_settings	RawDataSettings	r	Obtiene la configuración actual de datos sin procesar. Nota: al usar esta configuración, los datos se cargan sin conversión.
raw_fallback_index	int	r/w	Obtiene o establece el índice de reserva a usar cuando el índice de la paleta está fuera de los límites
raw_indexed_color_converter	IIndexedColorConverter	r/w	Obtiene o establece el convertidor de color indexado
raw_line_size	int	r	Obtiene el tamaño de línea sin procesar en bytes.
size	Size	r	Obtiene el tamaño de la imagen.
transparent_color	Color	r/w	Obtiene el color transparente de la imagen.
update_xmp_data	bool	r/w	Obtiene o establece un valor que indica si se debe actualizar los metadatos XMP.
use_palette	bool	r	Obtiene un valor que indica si se usa la paleta de la imagen.
use_raw_data	bool	r/w	Obtiene o establece un valor que indica si se debe usar la carga de datos sin procesar cuando la carga de datos sin procesar está disponible.
vertical_resolution	float	r/w	Obtiene o establece la resolución vertical, en píxeles por pulgada, de este RasterImage.
width	int	r	Obtiene el ancho de la imagen.
xmp_data	XmpPacketWrapper	r/w	Obtiene o establece los datos Xmp.

Methods

Name	Descripción
adjust_brightness(brightness)	Ajuste de brillo para la imagen.
adjust_contrast(contrast)	Contraste de imagen
adjust_gamma(gamma)	Corrección gamma de una imagen.
adjust_gamma(gamma_red, gamma_green, gamma_blue)	Corrección gamma de una imagen.
analyze_percentage_digital_signature(password)	Calcula el porcentaje de similitud entre los datos extraídos y la contraseña original.
auto_brightness_contrast()	Normalización automática adaptativa de brillo y contraste para toda la imagen.
auto_rotate()	Rota automáticamente la imagen basándose en los datos de orientación extraídos de los metadatos Exif . Este método garantiza que las imágenes se muestren en la orientación correcta, mejorando la experiencia del usuario y eliminando la necesidad de ajustes manuales. Al analizar la información Exif, la imagen se rota en consecuencia, proporcionando una experiencia de visualización fluida en diferentes plataformas y dispositivos. Este proceso de rotación automatizado simplifica la gestión de imágenes y mejora la usabilidad general, especialmente al trabajar con grandes lotes de imágenes con orientaciones variables.
binarize_bradley(brightness_difference)	Binarización de una imagen usando el algoritmo de umbral adaptativo de Bradley mediante el umbralado de imagen integral
binarize_bradley(brightness_difference, window_size)	Binarización de una imagen usando el algoritmo de umbral adaptativo de Bradley mediante el umbralado de imagen integral
binarize_fixed(threshold)	Binarización de una imagen con umbral predefinido
binarize_otsu()	Binarización de una imagen con umbral de Otsu
blend(origin, overlay, overlay_alpha)	Mezcla esta instancia de imagen con la imagen overlay.
blend(origin, overlay, overlay_area, overlay_alpha)	Mezcla esta instancia de imagen con la imagen overlay.
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.
dither(dithering_method, bits_count)	Aplica dithering a la imagen actual.
dither(dithering_method, bits_count, custom_palette)	Aplica dithering a la imagen actual.
embed_digital_signature(password)	Incrustar una firma digital basada en la contraseña proporcionada en la imagen usando esteganografía.
filter(rectangle, options)	Filtra el rectángulo especificado.
get_argb_32_pixel(x, y)	Obtiene un píxel ARGB de 32 bits de la imagen.
get_default_argb_32_pixels(rectangle)	Obtiene la matriz predeterminada de píxeles ARGB de 32 bits.
get_default_options(args)	Obtiene las opciones predeterminadas.
get_default_pixels(rectangle, partial_pixel_loader)	Obtiene la matriz predeterminada de píxeles usando el cargador parcial de píxeles.
get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings)	Obtiene la matriz de datos sin procesar predeterminada usando el cargador parcial de píxeles.
get_default_raw_data(rectangle, raw_data_settings)	Obtiene la matriz de datos sin procesar predeterminada.
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_modify_date(use_default)	Obtiene la fecha y hora en que la imagen del recurso fue modificada por última vez.
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_pixel(x, y)	Obtiene un píxel de la imagen.
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.
get_skew_angle()	Obtiene el ángulo de sesgo. Este método es aplicable a documentos de texto escaneados, para determinar el ángulo de sesgo al escanear.
grayscale()	Transformación de una imagen a su representación en escala de grises
is_digital_signed(password, percentage_threshold)	Realiza una verificación rápida para determinar si la imagen está firmada digitalmente, usando la contraseña proporcionada y el umbral.
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_argb_32_pixels(rectangle)	Carga píxeles ARGB de 32 bits.
load_argb_64_pixels(rectangle)	Carga píxeles ARGB de 64 bits.
load_cmyk_32_pixels(rectangle)	Carga píxeles en formato CMYK.
load_cmyk_pixels(rectangle)	Carga píxeles en formato CMYK. Este método está obsoleto. Por favor, use de manera más eficaz el método RasterImage.load_cmyk_32_pixels(rectangle).
load_partial_argb_32_pixels(rectangle, partial_pixel_loader)	Carga píxeles ARGB de 32 bits parcialmente por paquetes.
load_partial_argb_64_pixels(rectangle, partial_pixel_loader)	Carga parcialmente píxeles ARGB de 64 bits por paquetes.
load_partial_pixels(desired_rectangle, pixel_loader)	Carga píxeles parcialmente por paquetes.
load_pixels(rectangle)	Carga píxeles.
load_raw_data(rectangle, dest_image_bounds, raw_data_settings, raw_data_loader)	Carga datos sin procesar.
load_raw_data(rectangle, raw_data_settings, raw_data_loader)	Carga datos sin procesar.
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.
normalize_angle()	Normaliza el ángulo. Este método es aplicable a documentos de texto escaneados para eliminar la distorsión del escaneo. Este método utiliza los métodos RasterImage.get_skew_angle() y RasterImage.rotate(angle).
normalize_angle(resize_proportionally, background_color)	Normaliza el ángulo. Este método es aplicable a documentos de texto escaneados para eliminar la inclinación del escaneo. Este método usa los métodos RasterImage.get_skew_angle() y RasterImage.rotate(angle, resize_proportionally, background_color).
normalize_histogram()	Normaliza el histograma de la imagen — ajusta los valores de píxeles para usar todo el rango disponible.
read_argb_32_scan_line(scan_line_index)	Lee toda la línea de escaneo según el índice de línea de escaneo especificado.
read_scan_line(scan_line_index)	Lee toda la línea de escaneo según el índice de línea de escaneo especificado.
remove_metadata()	Elimina los metadatos de esta instancia de imagen estableciendo el valor de IHasXmpData.xmp_data a None.
replace_argb(old_color_argb, old_color_diff, new_color_argb)	Reemplaza un color por otro con diferencia permitida y preserva el valor alfa original para mantener bordes suaves.
replace_color(old_color, old_color_diff, new_color)	Reemplaza un color por otro con diferencia permitida y preserva el valor alfa original para mantener bordes suaves.
replace_color(old_color_argb, old_color_diff, new_color_argb)	Reemplaza un color por otro con diferencia permitida y preserva el valor alfa original para mantener bordes suaves.
replace_non_transparent_colors(new_color)	Reemplaza todos los colores no transparentes por un nuevo color y conserva el valor alfa original para mantener bordes suaves. Nota: si lo usas en imágenes sin transparencia, todos los colores serán reemplazados por uno solo.
replace_non_transparent_colors(new_color_argb)	Reemplaza todos los colores no transparentes por un nuevo color y conserva el valor alfa original para mantener bordes suaves. Nota: si lo usas en imágenes sin transparencia, todos los colores serán reemplazados por uno solo.
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 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(angle, resize_proportionally, background_color)	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_argb_32_pixels(rectangle, pixels)	Guarda los píxeles ARGB de 32 bits.
save_cmyk_32_pixels(rectangle, pixels)	Guarda los píxeles.
save_cmyk_pixels(rectangle, pixels)	Guarda los píxeles. Este método está obsoleto. Por favor, utiliza de forma más eficaz el método RasterImage.save_cmyk_32_pixels(rectangle, pixels).
save_pixels(rectangle, pixels)	Guarda los píxeles.
save_raw_data(data, data_offset, rectangle, raw_data_settings)	Guarda los datos sin procesar.
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_argb_32_pixel(x, y, argb_32_color)	Establece un píxel ARGB de 32 bits de la imagen para la posición especificada.
set_palette(palette, update_colors)	Establece la paleta de la imagen.
set_pixel(x, y, color)	Establece un píxel de la imagen para la posición especificada.
set_resolution(dpi_x, dpi_y)	Establece la resolución para este RasterImage.
try_set_metadata(metadata)	Intenta establecer una instancia de metadata, si esta instancia de Image admite e implementa el tipo IImageMetadataFormat.
write_argb_32_scan_line(scan_line_index, argb_32_pixels)	Escribe toda la línea de escaneo en el índice de línea de escaneo especificado.
write_scan_line(scan_line_index, pixels)	Escribe toda la línea de escaneo en el índice de línea de escaneo especificado.

Property: has_alpha

Obtiene un valor que indica si esta instancia tiene alfa.

See also:

Example # 1: The following example loads raster images and prints information about raw da…

Example # 2: The following example shows how to extract information about raw data format …

Property: premultiply_components

Obtiene o establece un valor que indica si los componentes de la imagen deben ser premultiplicados.

See also:

Example # 1: The following example creates a new raster image, saves the specified semi-tr…

Property: raw_data_format

Obtiene el formato de datos sin procesar.

See also:

Example # 1: The following example loads raster images and prints information about raw da…

Method: adjust_brightness(brightness)

 adjust_brightness(brightness) 

Ajuste de brillo para la imagen.

Parameters:

Parámetro	Tipo	Descripción
brillo	int	Valor de brillo.

See also:

Example # 1: The following example performs brightness correction of an image.

Method: adjust_contrast(contrast)

 adjust_contrast(contrast) 

Contraste de imagen

Parameters:

Parámetro	Tipo	Descripción
contraste	float	Valor de contraste (en el rango [-100; 100])

See also:

Example # 1: The following example performs contrast correction of an image.

Method: adjust_gamma(gamma)

 adjust_gamma(gamma) 

Corrección gamma de una imagen.

Parameters:

Parámetro	Tipo	Descripción
gamma	float	Coeficiente gamma para los canales rojo, verde y azul

See also:

Example # 1: The following example performs gamma-correction of an image.

Method: adjust_gamma(gamma_red, gamma_green, gamma_blue)

 adjust_gamma(gamma_red, gamma_green, gamma_blue) 

Corrección gamma de una imagen.

Parameters:

Parámetro	Tipo	Descripción
gamma_red	float	Coeficiente gamma para el canal rojo
gamma_green	float	Coeficiente gamma para el canal verde
gamma_blue	float	Gamma para el coeficiente del canal azul

See also:

Example # 1: The following example performs gamma-correction of an image applying differen…

Method: analyze_percentage_digital_signature(password)

 analyze_percentage_digital_signature(password) 

Calcula el porcentaje de similitud entre los datos extraídos y la contraseña original.

Parameters:

Parámetro	Tipo	Descripción
password	string	La contraseña utilizada para extraer los datos incrustados.

Returns

Tipo	Descripción
int	El valor de porcentaje de similitud.

See also:

Example # 1: The example illustrates how to determine the probability (from 0% to 100%) th…

Method: binarize_bradley(brightness_difference)

 binarize_bradley(brightness_difference) 

Binarización de una imagen usando el algoritmo de umbral adaptativo de Bradley mediante el umbralado de imagen integral

Parameters:

Parámetro	Tipo	Descripción
brightness_difference	float	La diferencia de brillo entre el píxel y el promedio de una ventana de s x s píxeles centrada en este píxel.

Method: binarize_bradley(brightness_difference, window_size)

 binarize_bradley(brightness_difference, window_size) 

Binarización de una imagen usando el algoritmo de umbral adaptativo de Bradley mediante el umbralado de imagen integral

Parameters:

Parámetro	Tipo	Descripción
brightness_difference	float	La diferencia de brillo entre el píxel y el promedio de una ventana de s x s píxeles centrada en este píxel.
window_size	int	El tamaño de la ventana de píxeles de s x s centrada alrededor de este píxel

See also:

Example # 1: The following example binarizes a raster image with Bradley’s adaptive thresh…

Method: binarize_fixed(threshold)

 binarize_fixed(threshold) 

Binarización de una imagen con umbral predefinido

Parameters:

Parámetro	Tipo	Descripción
umbral	System.Byte	Valor de umbral. Si el valor gris correspondiente de un píxel es mayor que el umbral, se le asignará un valor de 255, de lo contrario 0.

See also:

Example # 1: The following example binarizes a raster image with the predefined threshold….

Method: blend(origin, overlay, overlay_alpha)

 blend(origin, overlay, overlay_alpha) 

Mezcla esta instancia de imagen con la imagen overlay.

Parameters:

Parámetro	Tipo	Descripción
origin	Point	El origen de la fusión de la imagen de fondo.
overlay	RasterImage	La imagen superpuesta.
overlay_alpha	System.Byte	El alfa de la superposición.

Method: blend(origin, overlay, overlay_area, overlay_alpha)

 blend(origin, overlay, overlay_area, overlay_alpha) 

Mezcla esta instancia de imagen con la imagen overlay.

Parameters:

Parámetro	Tipo	Descripción
origin	Point	El origen de la fusión de la imagen de fondo.
overlay	RasterImage	La imagen superpuesta.
overlay_area	Rectangle	El área de superposición.
overlay_alpha	System.Byte	El alfa de la superposición.

Method: can_load(file_path) [static]

 can_load(file_path) 

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

Parameters:

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

Returns

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

Method: can_load(file_path, load_options) [static]

 can_load(file_path, load_options) 

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

Parameters:

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

Returns

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

Method: can_load(stream) [static]

 can_load(stream) 

Determina si la imagen puede cargarse desde el flujo especificado.

Parameters:

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

Returns

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

Method: can_load(stream, load_options) [static]

 can_load(stream, load_options) 

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

Parameters:

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

Returns

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

Method: can_load_stream(stream) [static]

 can_load_stream(stream) 

Determina si la imagen puede cargarse desde el flujo especificado.

Parameters:

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

Returns

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

Method: can_load_stream_with_options(stream, load_options) [static]

 can_load_stream_with_options(stream, load_options) 

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

Parameters:

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

Returns

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

Method: can_load_with_options(file_path, load_options) [static]

 can_load_with_options(file_path, load_options) 

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

Parameters:

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

Returns

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

Method: can_save(options)

 can_save(options) 

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

Parameters:

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

Returns

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

Method: create(files) [static]

 create(files) 

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

Parameters:

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

Returns

Tipo	Descripción
Image	La imagen multipágina

Method: create(files, throw_exception_on_load_error) [static]

 create(files, throw_exception_on_load_error) 

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

Parameters:

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

Returns

Tipo	Descripción
Image	La imagen multipágina

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

 create(image_options, width, height) 

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

Parameters:

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

Returns

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

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

 create(image_options, width, height, pixels) 

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

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

Parameters:

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

Returns

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

Method: create(images) [static]

 create(images) 

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

Parameters:

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

Returns

Tipo	Descripción
Image	La Imagen como IMultipageImage

Method: create(images, dispose_images) [static]

 create(images, dispose_images) 

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

Parameters:

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

Returns

Tipo	Descripción
Image	La Imagen como IMultipageImage

Method: create(multipage_create_options) [static]

 create(multipage_create_options) 

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

Parameters:

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

Returns

Tipo	Descripción
Image	La imagen multipágina

Method: create_from_files(files) [static]

 create_from_files(files) 

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

Parameters:

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

Returns

Tipo	Descripción
Image	La imagen multipágina

Method: create_from_files(files, throw_exception_on_load_error) [static]

 create_from_files(files, throw_exception_on_load_error) 

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

Parameters:

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

Returns

Tipo	Descripción
Image	La imagen multipágina

Method: create_from_images(images) [static]

 create_from_images(images) 

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

Parameters:

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

Returns

Tipo	Descripción
Image	La Imagen como IMultipageImage

Method: create_from_images(images, dispose_images) [static]

 create_from_images(images, dispose_images) 

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

Parameters:

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

Returns

Tipo	Descripción
Image	La Imagen como IMultipageImage

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

 crop(left_shift, right_shift, top_shift, bottom_shift) 

Recortar la imagen con desplazamientos.

Parameters:

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

See also:

Example # 1: The following example crops a raster image. The cropping area is specified vi…

Method: crop(rectangle)

 crop(rectangle) 

Recorta el rectángulo especificado.

Parameters:

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

See also:

Example # 1: The following example crops a raster image. The cropping area is be specified…

Method: dither(dithering_method, bits_count)

 dither(dithering_method, bits_count) 

Aplica dithering a la imagen actual.

Parameters:

Parámetro	Tipo	Descripción
dithering_method	DitheringMethod	El método de tramado.
bits_count	int	El recuento final de bits para el tramado.

See also:

Example # 1: The following example loads a raster image and performs threshold and Floyd d…

Method: dither(dithering_method, bits_count, custom_palette)

 dither(dithering_method, bits_count, custom_palette) 

Aplica dithering a la imagen actual.

Parameters:

Parámetro	Tipo	Descripción
dithering_method	DitheringMethod	El método de tramado.
bits_count	int	El recuento final de bits para el tramado.
custom_palette	IColorPalette	La paleta personalizada para el tramado.

Method: embed_digital_signature(password)

 embed_digital_signature(password) 

Incrustar una firma digital basada en la contraseña proporcionada en la imagen usando esteganografía.

Parameters:

Parámetro	Tipo	Descripción
password	string	La contraseña utilizada para generar datos de firma digital.

See also:

Example # 1: The example shows how to embed digital signature based on provided password i…

Method: filter(rectangle, options)

 filter(rectangle, options) 

Filtra el rectángulo especificado.

Parameters:

Parámetro	Tipo	Descripción
rectangle	Rectangle	El rectángulo.
options	FilterOptionsBase	Las opciones.

See also:

Example # 1: The following example applies various types of filters to a raster image.

Method: get_argb_32_pixel(x, y)

 get_argb_32_pixel(x, y) 

Obtiene un píxel ARGB de 32 bits de la imagen.

Parameters:

Parámetro	Tipo	Descripción
x	int	La ubicación x del píxel.
y	int	La ubicación y del píxel.

Returns

Tipo	Descripción
int	El píxel ARGB de 32 bits para la ubicación especificada.

See also:

Example # 1: The following example shows how image caching affects performance. In general…

Example # 2: The following example loads a raster image and obtains the color of an arbitr…

Method: get_default_argb_32_pixels(rectangle)

 get_default_argb_32_pixels(rectangle) 

Obtiene la matriz predeterminada de píxeles ARGB de 32 bits.

Parameters:

Parámetro	Tipo	Descripción
rectangle	Rectangle	El rectángulo del cual obtener píxeles.

Returns

Tipo	Descripción
int[]	La matriz predeterminada de píxeles.

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_default_pixels(rectangle, partial_pixel_loader)

 get_default_pixels(rectangle, partial_pixel_loader) 

Obtiene la matriz predeterminada de píxeles usando el cargador parcial de píxeles.

Parameters:

Parámetro	Tipo	Descripción
rectangle	Rectangle	El rectángulo del cual obtener píxeles.
partial_pixel_loader	IPartialArgb32PixelLoader	El cargador parcial de píxeles.

Method: get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings)

 get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings) 

Obtiene la matriz de datos sin procesar predeterminada usando el cargador parcial de píxeles.

Parameters:

Parámetro	Tipo	Descripción
rectangle	Rectangle	El rectángulo del cual obtener píxeles.
partial_raw_data_loader	IPartialRawDataLoader	El cargador parcial de datos sin procesar.
raw_data_settings	RawDataSettings	La configuración de datos sin procesar.

Method: get_default_raw_data(rectangle, raw_data_settings)

 get_default_raw_data(rectangle, raw_data_settings) 

Obtiene la matriz de datos sin procesar predeterminada.

Parameters:

Parámetro	Tipo	Descripción
rectangle	Rectangle	El rectángulo del cual obtener datos sin procesar.
raw_data_settings	RawDataSettings	La configuración de datos sin procesar.

Returns

Tipo	Descripción
System.Byte	La matriz predeterminada de datos sin procesar.

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_modify_date(use_default)

 get_modify_date(use_default) 

Obtiene la fecha y hora en que la imagen del recurso fue modificada por última vez.

Parameters:

Parámetro	Tipo	Descripción
use_default	bool	si se establece en true utiliza la información de FileInfo como valor predeterminado.

Returns

Tipo	Descripción
System.DateTime	La fecha y hora en que la imagen del recurso fue modificada por última vez.

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_pixel(x, y)

 get_pixel(x, y) 

Obtiene un píxel de la imagen.

Parameters:

Parámetro	Tipo	Descripción
x	int	La ubicación x del píxel.
y	int	La ubicación y del píxel.

Returns

Tipo	Descripción
Color	El color del píxel para la ubicación especificada.

See also:

Example # 1: The following example loads a raster image and obtains the color of an arbitr…

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: get_skew_angle()

 get_skew_angle() 

Obtiene el ángulo de sesgo.
Este método es aplicable a documentos de texto escaneados, para determinar el ángulo de sesgo al escanear.

Returns

Tipo	Descripción
float	El ángulo de sesgo, en grados.

Method: is_digital_signed(password, percentage_threshold)

 is_digital_signed(password, percentage_threshold) 

Realiza una verificación rápida para determinar si la imagen está firmada digitalmente, usando la contraseña proporcionada y el umbral.

Parameters:

Parámetro	Tipo	Descripción
password	string	La contraseña para verificar la firma.
percentage_threshold	int	El umbral (en porcentaje)[0-100] que determina si la imagen se considera firmada. Si no se especifica, se aplicará un umbral predeterminado (75).

Returns

Tipo	Descripción
bool	Verdadero si la imagen está firmada, de lo contrario falso.

See also:

Example # 1: The example shows how to validate that the embedded digital signature matches…

Example # 2: The example demonstrates how to verify that the embedded digital signature ma…

Method: load(file_path) [static]

 load(file_path) 

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

Parameters:

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

Returns

Tipo	Descripción
Image	La imagen cargada.

Method: load(file_path, load_options) [static]

 load(file_path, load_options) 

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

Parameters:

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

Returns

Tipo	Descripción
Image	La imagen cargada.

Method: load(stream) [static]

 load(stream) 

Carga una nueva imagen desde el flujo especificado.

Parameters:

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

Returns

Tipo	Descripción
Image	La imagen cargada.

Method: load(stream, load_options) [static]

 load(stream, load_options) 

Carga una nueva imagen desde el flujo especificado.

Parameters:

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

Returns

Tipo	Descripción
Image	La imagen cargada.

Method: load_argb_32_pixels(rectangle)

 load_argb_32_pixels(rectangle) 

Carga píxeles ARGB de 32 bits.

Parameters:

Parámetro	Tipo	Descripción
rectangle	Rectangle	El rectángulo desde el cual cargar los píxeles.

Returns

Tipo	Descripción
int[]	La matriz de píxeles ARGB de 32 bits cargada.

See also:

Example # 1: The following example shows how to load and process pixels of a raster image….

Method: load_argb_64_pixels(rectangle)

 load_argb_64_pixels(rectangle) 

Carga píxeles ARGB de 64 bits.

Parameters:

Parámetro	Tipo	Descripción
rectangle	Rectangle	El rectángulo desde el cual cargar los píxeles.

Returns

Tipo	Descripción
int[]	La matriz de píxeles ARGB de 64 bits cargada.

See also:

Example # 1: The following example shows how to load and process pixels of a raster image….

Method: load_cmyk_32_pixels(rectangle)

 load_cmyk_32_pixels(rectangle) 

Carga píxeles en formato CMYK.

Parameters:

Parámetro	Tipo	Descripción
rectangle	Rectangle	El rectángulo desde el cual cargar los píxeles.

Returns

Tipo	Descripción
int[]	La matriz de píxeles CMYK cargada presentada como valores enteros de 32 bits.

Method: load_cmyk_pixels(rectangle)

 load_cmyk_pixels(rectangle) 

Carga píxeles en formato CMYK.
Este método está obsoleto. Por favor, use de manera más eficaz el método RasterImage.load_cmyk_32_pixels(rectangle).

Parameters:

Parámetro	Tipo	Descripción
rectangle	Rectangle	El rectángulo desde el cual cargar los píxeles.

Returns

Tipo	Descripción
CmykColor[]	La matriz de píxeles CMYK cargada.

Method: load_partial_argb_32_pixels(rectangle, partial_pixel_loader)

 load_partial_argb_32_pixels(rectangle, partial_pixel_loader) 

Carga píxeles ARGB de 32 bits parcialmente por paquetes.

Parameters:

Parámetro	Tipo	Descripción
rectangle	Rectangle	El rectángulo deseado.
partial_pixel_loader	IPartialArgb32PixelLoader	El cargador de píxeles ARGB de 32 bits.

Method: load_partial_argb_64_pixels(rectangle, partial_pixel_loader)

 load_partial_argb_64_pixels(rectangle, partial_pixel_loader) 

Carga parcialmente píxeles ARGB de 64 bits por paquetes.

Parameters:

Parámetro	Tipo	Descripción
rectangle	Rectangle	El rectángulo deseado.
partial_pixel_loader	IPartialArgb64PixelLoader	El cargador de píxeles ARGB de 64 bits.

Method: load_partial_pixels(desired_rectangle, pixel_loader)

 load_partial_pixels(desired_rectangle, pixel_loader) 

Carga píxeles parcialmente por paquetes.

Parameters:

Parámetro	Tipo	Descripción
desired_rectangle	Rectangle	El rectángulo deseado.
pixel_loader	IPartialPixelLoader	El cargador de píxeles.

Method: load_pixels(rectangle)

 load_pixels(rectangle) 

Carga píxeles.

Parameters:

Parámetro	Tipo	Descripción
rectangle	Rectangle	El rectángulo desde el cual cargar los píxeles.

Returns

Tipo	Descripción
Color[]	La matriz de píxeles cargada.

See also:

Example # 1: This example shows how to load a pixels information in an array of Color, man…

Example # 2: The following example shows how to load and process pixels of a raster image….

Method: load_raw_data(rectangle, dest_image_bounds, raw_data_settings, raw_data_loader)

 load_raw_data(rectangle, dest_image_bounds, raw_data_settings, raw_data_loader) 

Carga datos sin procesar.

Parameters:

Parámetro	Tipo	Descripción
rectangle	Rectangle	El rectángulo desde el cual cargar datos sin procesar.
dest_image_bounds	Rectangle	Los límites de la imagen de destino.
raw_data_settings	RawDataSettings	La configuración de datos sin procesar a usar para los datos cargados. Nota: si los datos no están en el formato especificado, se realizará una conversión de datos.
raw_data_loader	IPartialRawDataLoader	El cargador de datos sin procesar.

Method: load_raw_data(rectangle, raw_data_settings, raw_data_loader)

 load_raw_data(rectangle, raw_data_settings, raw_data_loader) 

Carga datos sin procesar.

Parameters:

Parámetro	Tipo	Descripción
rectangle	Rectangle	El rectángulo desde el cual cargar datos sin procesar.
raw_data_settings	RawDataSettings	La configuración de datos sin procesar a usar para los datos cargados. Nota: si los datos no están en el formato especificado, se realizará una conversión de datos.
raw_data_loader	IPartialRawDataLoader	El cargador de datos sin procesar.

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: normalize_angle(resize_proportionally, background_color)

 normalize_angle(resize_proportionally, background_color) 

Normaliza el ángulo.
Este método es aplicable a documentos de texto escaneados para eliminar la inclinación del escaneo.
Este método usa los métodos RasterImage.get_skew_angle() y RasterImage.rotate(angle, resize_proportionally, background_color).

Parameters:

Parámetro	Tipo	Descripción
resize_proportionally	bool	si se establece a true el tamaño de su imagen se cambiará según las proyecciones del rectángulo rotado (puntos de esquina); en otro caso, se dejan las dimensiones sin cambios y solo se rotan los contenidos internos de la imagen.
background_color	Color	Color del fondo.

See also:

Example # 1: Skew is an artifact that might appear during document scanning process when t…

Method: read_argb_32_scan_line(scan_line_index)

 read_argb_32_scan_line(scan_line_index) 

Lee toda la línea de escaneo según el índice de línea de escaneo especificado.

Parameters:

Parámetro	Tipo	Descripción
scan_line_index	int	Índice basado en cero de la línea de escaneo.

Returns

Tipo	Descripción
int[]	La matriz de valores de color ARGB de 32 bits de la línea de escaneo.

Method: read_scan_line(scan_line_index)

 read_scan_line(scan_line_index) 

Lee toda la línea de escaneo según el índice de línea de escaneo especificado.

Parameters:

Parámetro	Tipo	Descripción
scan_line_index	int	Índice basado en cero de la línea de escaneo.

Returns

Tipo	Descripción
Color[]	La matriz de valores de color de píxeles de la línea de escaneo.

Method: replace_argb(old_color_argb, old_color_diff, new_color_argb)

 replace_argb(old_color_argb, old_color_diff, new_color_argb) 

Reemplaza un color por otro con diferencia permitida y preserva el valor alfa original para mantener bordes suaves.

Parameters:

Parámetro	Tipo	Descripción
old_color_argb	int	Valor ARGB del color antiguo a reemplazar.
old_color_diff	System.Byte	Diferencia permitida en el color antiguo para poder ampliar el tono del color reemplazado.
new_color_argb	int	Nuevo valor ARGB de color para reemplazar el color antiguo.

Method: replace_color(old_color, old_color_diff, new_color)

 replace_color(old_color, old_color_diff, new_color) 

Reemplaza un color por otro con diferencia permitida y preserva el valor alfa original para mantener bordes suaves.

Parameters:

Parámetro	Tipo	Descripción
old_color	Color	Color antiguo a ser reemplazado.
old_color_diff	System.Byte	Diferencia permitida en el color antiguo para poder ampliar el tono del color reemplazado.
new_color	Color	Nuevo color con el que reemplazar el color antiguo.

Method: replace_color(old_color_argb, old_color_diff, new_color_argb)

 replace_color(old_color_argb, old_color_diff, new_color_argb) 

Reemplaza un color por otro con diferencia permitida y preserva el valor alfa original para mantener bordes suaves.

Parameters:

Parámetro	Tipo	Descripción
old_color_argb	int	Valor ARGB del color antiguo a reemplazar.
old_color_diff	System.Byte	Diferencia permitida en el color antiguo para poder ampliar el tono del color reemplazado.
new_color_argb	int	Nuevo valor ARGB de color para reemplazar el color antiguo.

Method: replace_non_transparent_colors(new_color)

 replace_non_transparent_colors(new_color) 

Reemplaza todos los colores no transparentes por un nuevo color y conserva el valor alfa original para mantener bordes suaves.
Nota: si lo usas en imágenes sin transparencia, todos los colores serán reemplazados por uno solo.

Parameters:

Parámetro	Tipo	Descripción
new_color	Color	Nuevo color con el que reemplazar los colores no transparentes.

Method: replace_non_transparent_colors(new_color_argb)

 replace_non_transparent_colors(new_color_argb) 

Reemplaza todos los colores no transparentes por un nuevo color y conserva el valor alfa original para mantener bordes suaves.
Nota: si lo usas en imágenes sin transparencia, todos los colores serán reemplazados por uno solo.

Parameters:

Parámetro	Tipo	Descripción
new_color_argb	int	Nuevo valor ARGB de color para reemplazar colores no transparentes.

Method: resize(new_width, new_height)

 resize(new_width, new_height) 

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

Parameters:

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

Method: resize(new_width, new_height, resize_type)

 resize(new_width, new_height, resize_type) 

Redimensiona la imagen.

Parameters:

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

See also:

Example # 1: This example loads a raster image and resizes it using various resizing methods.

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.

See also:

Example # 1: This example loads a raster image and resizes it using various resizing setti…

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(angle, resize_proportionally, background_color)

 rotate(angle, resize_proportionally, background_color) 

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.
resize_proportionally	bool	si se establece a true el tamaño de su imagen se cambiará según las proyecciones del rectángulo rotado (puntos de esquina); en otro caso, se dejan las dimensiones sin cambios y solo se rotan los contenidos internos de la imagen.
background_color	Color	Color del fondo.

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

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_argb_32_pixels(rectangle, pixels)

 save_argb_32_pixels(rectangle, pixels) 

Guarda los píxeles ARGB de 32 bits.

Parameters:

Parámetro	Tipo	Descripción
rectangle	Rectangle	El rectángulo donde guardar los píxeles.
píxeles	int[]	La matriz de píxeles ARGB de 32 bits.

See also:

Example # 1: The following example fills the central area of a raster image with black pix…

Method: save_cmyk_32_pixels(rectangle, pixels)

 save_cmyk_32_pixels(rectangle, pixels) 

Guarda los píxeles.

Parameters:

Parámetro	Tipo	Descripción
rectangle	Rectangle	El rectángulo donde guardar los píxeles.
píxeles	int[]	Los píxeles CMYK presentados como valores enteros de 32 bits.

See also:

Example # 1: The following example fills the central area of a raster image with black pix…

Method: save_cmyk_pixels(rectangle, pixels)

 save_cmyk_pixels(rectangle, pixels) 

Guarda los píxeles.
Este método está obsoleto. Por favor, utiliza de forma más eficaz el método RasterImage.save_cmyk_32_pixels(rectangle, pixels).

Parameters:

Parámetro	Tipo	Descripción
rectangle	Rectangle	El rectángulo donde guardar los píxeles.
pixels	CmykColor[]	La matriz de píxeles CMYK.

Method: save_pixels(rectangle, pixels)

 save_pixels(rectangle, pixels) 

Guarda los píxeles.

Parameters:

Parámetro	Tipo	Descripción
rectangle	Rectangle	El rectángulo donde guardar los píxeles.
pixels	Color[]	La matriz de píxeles.

See also:

Example # 1: This example shows how to load a pixels information in an array of Color, man…

Example # 2: The following example fills the central area of a raster image with black pix…

Method: save_raw_data(data, data_offset, rectangle, raw_data_settings)

 save_raw_data(data, data_offset, rectangle, raw_data_settings) 

Guarda los datos sin procesar.

Parameters:

Parámetro	Tipo	Descripción
datos	System.Byte	Los datos sin procesar.
data_offset	int	El desplazamiento inicial de los datos sin procesar.
rectangle	Rectangle	El rectángulo de datos sin procesar.
raw_data_settings	RawDataSettings	La configuración de datos sin procesar en la que se encuentran los datos.

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_argb_32_pixel(x, y, argb_32_color)

 set_argb_32_pixel(x, y, argb_32_color) 

Establece un píxel ARGB de 32 bits de la imagen para la posición especificada.

Parameters:

Parámetro	Tipo	Descripción
x	int	La ubicación x del píxel.
y	int	La ubicación y del píxel.
argb_32_color	int	El píxel ARGB de 32 bits para la posición especificada.

See also:

Example # 1: The following example loads a raster image, and sets the color of an arbitrar…

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: set_pixel(x, y, color)

 set_pixel(x, y, color) 

Establece un píxel de la imagen para la posición especificada.

Parameters:

Parámetro	Tipo	Descripción
x	int	La ubicación x del píxel.
y	int	La ubicación y del píxel.
color	Color	El color del píxel para la posición especificada.

See also:

Example # 1: The following example loads a raster image, and sets the color of an arbitrar…

Method: set_resolution(dpi_x, dpi_y)

 set_resolution(dpi_x, dpi_y) 

Establece la resolución para este RasterImage.

Parameters:

Parámetro	Tipo	Descripción
dpi_x	float	La resolución horizontal, en puntos por pulgada, del RasterImage.
dpi_y	float	La resolución vertical, en puntos por pulgada, del RasterImage.

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.

Method: write_argb_32_scan_line(scan_line_index, argb_32_pixels)

 write_argb_32_scan_line(scan_line_index, argb_32_pixels) 

Escribe toda la línea de escaneo en el índice de línea de escaneo especificado.

Parameters:

Parámetro	Tipo	Descripción
scan_line_index	int	Índice basado en cero de la línea de escaneo.
argb_32_pixels	int[]	La matriz de colores ARGB de 32 bits para escribir.

Method: write_scan_line(scan_line_index, pixels)

 write_scan_line(scan_line_index, pixels) 

Escribe toda la línea de escaneo en el índice de línea de escaneo especificado.

Parameters:

Parámetro	Tipo	Descripción
scan_line_index	int	Índice basado en cero de la línea de escaneo.
pixels	Color[]	La matriz de colores de píxeles para escribir.

Examples

This example shows how to load a pixels information in an array of Color, manipulates the array and set it back to the image. To perform these operations, this example creates a new Image file (in GIF format) using MemoryStream object.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage, Color
from aspose.imaging.externsions import StreamExtensions as strm_ext
from aspose.imaging.imageoptions import GifOptions
from aspose.imaging.sources import StreamSource

# Crea una instancia de MemoryStream
with strm_ext.create_memory_stream() as stream:
	#Crea una instancia de GifOptions y establece sus diversas propiedades, incluida la propiedad Source
	with GifOptions() as gifOptions:
		gifOptions.source = StreamSource(stream)

		# Cree una instancia de Image
		with as_of(Image.create(gifOptions, 500, 500), RasterImage) as image:
			# Obtén los píxeles de la imagen especificando el área como límite de la imagen
			pixels = image.load_pixels(image.bounds)

			yellow_color = Color.yellow
			blue_color = Color.blue
			#Recorre la matriz y establece el color del píxel indexado alternativo
			for index in range(pixel.length):
				if index % 2 == 0:
					#Establece el color del píxel indexado a amarillo
					pixels[index] = yellow_color
				else:
					#Establece el color del píxel indexado a azul
					pixels[index] = blue_color

			#Aplica los cambios de píxeles a la imagen
			image.save_pixels(image.bounds, pixels)

			# guarde todos los cambios.
			image.save()

	# Escribe MemoryStream en un archivo
	stream.seek(0)
	with open(r"C:\temp\output.gif", "wb") as fileStream:
		fileStream.write(stream.read())
}

The following example shows how image caching affects performance. In general case, reading cached data is performed faster than reading non-cached data.

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

directory = r"c:\temp"

# Carga una imagen desde un archivo PNG.
with Image.load(path_join(directory, "sample.png")) as image:
	# Cachea todos los datos de píxeles para que no se realice una carga adicional de datos desde el flujo de datos subyacente
	image.cache_daata()

	start_time = timedelta()

	# Leer todos los píxeles es bastante rápido.
	rasterImage = as_of(image, RasterImage)
	for y in range(image.height):
		for x in range(image.width):
			color = rasterImage.get_argb_32_pixel(x, y)
			
	end_time = timedelta()
	time = (end_time.microseconds - start_time.microseconds) / 1000000
	print(f"Reading all cached pixels took {time} ms.")


# Cargar una imagen desde un archivo PNG
with Image.load(path_join(directory, "sample.png")) as image:
	start_time = timedelta()

	# Leer todos los píxeles no es tan rápido como cuando se almacena en caché
	rasterImage = as_of(image, RasterImage)
	for y in range(image.height):
		for x in range(image.width):
			color = rasterImage.get_argb_32_pixel(x, y)

	end_time = timedelta()
	time = (end_time.microseconds - start_time.microseconds) / 1000000
	print(f"Reading all pixels without preliminary caching took {time} ms.")

# La salida puede verse así:
# Leer todos los píxeles en caché tomó 1500 ms.
# Leer todos los píxeles sin caché preliminar tomó 150000 ms.

The following example creates a new raster image, saves the specified semi-transparent pixels, then loads those pixels and gets final colors in the premultiplied form.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage, Color
from aspose.imaging.imageoptions import PngOptions
from aspose.imaging.sources import StreamSource
from aspose.imaging.fileformats.png import PngColorType

image_width = 3
image_height = 2

colors = [
	Color.from_argb(127, 255, 0, 0),
	Color.from_argb(127, 0, 255, 0),
	Color.from_argb(127, 0, 0, 255),
	Color.from_argb(127, 255, 255, 0),
	Color.from_argb(127, 255, 0, 255),
	Color.from_argb(127, 0, 255, 255)
]

create_options = PngOptions()
create_options.source = StreamSource()
create_options.color_type = PngColorType.TRUECOLOR_WITH_ALPHA

with Image.create(create_options, image_width, image_height) as image:
	raster_image = as_of(image, RasterImage)

	# Guardar píxeles para toda la imagen.
	raster_image.save_pixels(raster_image.bounds, colors)

	# Los píxeles se almacenan en la imagen original en forma no premultiplicada.
	# Es necesario especificar la opción correspondiente explícitamente para obtener componentes de color premultiplicados.
	# Los componentes de color premultiplicados se calculan mediante las fórmulas:
	# red = original_red * alpha / 255;
	# green = original_green * alpha / 255;
	# blue = original_blue * alpha / 255;
	raster_image.premultiply_components = True
	premultiplied_colors = raster_image.load_pixels(raster_image.bounds)
	for i in range(len(colors)):
		print(f"Original color: {colors[i]}")
		print(f"Premultiplied color: {premultiplied_colors[i]}")

The following example loads raster images and prints information about raw data format and alpha channel.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage

# Los archivos de imagen a cargar.
fileNames = (r"c:\temp\sample.bmp", r"c:\temp\alpha.png")

for fileName in fileNames:
	with Image.load(fileName) as image:
		raster_image = as_of(image, RasterImage)
		print(f"ImageFile={fileName}, FileFormat={raster_image.raw_data_format}, HasAlpha={raster_image.has_alpha}")

# La salida puede verse así:
# ImageFile=c:\temp\sample.bmp, FileFormat=Rgb24Bpp, canales usados: 8,8,8, HasAlpha=False
# ImageFile=c:\temp\alpha.png, FileFormat=RGBA32Bpp, canales usados: 8,8,8,8, HasAlpha=True

The following example loads a raster image and performs threshold and Floyd dithering using different palette depth.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage, DitheringMethod
from os.path import join as join_path

directory = r"c:\temp"

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# Realizar tramado por umbral usando una paleta de colores de 4 bits que contiene 16 colores.
	# Cuantos más bits se especifiquen, mayor será la calidad y el mayor tamaño de la imagen de salida.
	# Tenga en cuenta que solo se admiten paletas de 1 bit, 4 bits y 8 bits en este momento.
	rasterImage.dither(DitheringMethod.THRESHOLD_DITHERING, 4)

	rasterImage.save(join_path(directory, "sample.ThresholdDithering4.png"))

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)

	# Realizar tramado Floyd usando una paleta de colores de 1 bit que contiene solo 2 colores: negro y blanco.
	# Cuantos más bits se especifiquen, mayor será la calidad y el mayor tamaño de la imagen de salida.
	# Tenga en cuenta que solo se admiten paletas de 1 bit, 4 bits y 8 bits en este momento.
	rasterImage.dither(DitheringMethod.FLOYD_STEINBERG_DITHERING, 1)
	rasterImage.save(join_path(directory, "sample.FloydSteinbergDithering1.png"))

The following example loads a raster image and obtains the color of an arbitrary pixel represented as a 32-bit integer value.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage

with Image.load("sample.png") as image:
	rasterImage = as_of(image, RasterImage)

	# Obtener una representación entera del color del píxel superior izquierdo de la imagen.
	color = rasterImage.get_argb_32_pixel(0, 0)

	# Para obtener los valores de los componentes de color individuales, desplaza el valor del color un número correspondiente de bits
	alpha = (color >> 24) & 0xff
	red = (color >> 16) & 0xff
	green = (color >> 8) & 0xff
	blue = (color >> 0) & 0xff

	print(f"The color of the pixel(0,0) is A={alpha},R={red},G={green},B={blue}")

The following example loads a raster image and obtains the color of an arbitrary pixel.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage

with Image.load("sample.png") as image:
	rasterImage = as_of(image, RasterImage)
	# Obtener el color del píxel superior izquierdo de la imagen.
	color = rasterImage.get_pixel(0, 0)

	# Obtener los valores de los componentes de color individuales
	alpha = color.a
	red = color.r
	green = color.g
	blue = color.b

	print(f"The color of the pixel(0,0) is A={alpha},R={red},G={green},B={blue}")

The following example loads a raster image, and sets the color of an arbitrary pixel.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage, Color

with Image.load("sample.png") as image:
	rasterImage = as_of(image, RasterImage)
	# Establece el color del píxel superior izquierdo.
	rasterImage.set_argb_32_pixel(0, 0, Color.aqua.to_argb())
	# Otra forma es pasar una instancia de aspose.imaging.Color directamente
	rasterImage.set_pixel(0, 0, Color.aqua)

The following example shows how to load and process pixels of a raster image. The pixels are represented as 32-bit integer values. For example, consider a problem of counting of fully transparent pixels of an image.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage

with Image.load("alpha.png") as image:
	rasterImage = as_of(image, RasterImage)

	# Cargar píxeles para toda la imagen. Cualquier parte rectangular de la imagen puede especificarse como un parámetro del método aspose.imaging.RasterImage.load_argb_32_pixels(rectangle).
	pixels = rasterImage.load_argb_32_pixels(rasterImage.bounds)

	count = 0
	for pixel in pixels:
		alpha = (pixel >> 24) & 0xff
		if alpha == 0:
			count += 1

	print(f"The number of fully transparent pixels is {count}")
	print(f"The total number of pixels is {image.width * image.height}")

The following example shows how to load and process pixels of a raster image. The pixels are represented as 64-bit integer values. For example, consider a problem of counting of fully transparent pixels of an image.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage

with Image.load("16rgba.png") as image:
	rasterImage = as_of(image, RasterImage)
	# Cargar píxeles para toda la imagen. Cualquier parte rectangular de la imagen puede especificarse como un parámetro del método aspose.imaging.RasterImage.load_argb_64_pixels.
	# Tenga en cuenta que la propia imagen debe tener 16 bits por muestra, porque aspose.imaging.RasterImage.load_argb_64_pixels no funciona con 8 bits por muestra.
	# Para trabajar con 8 bits por muestra, por favor use el buen y viejo método aspose.imaging.RasterImage.load_argb_64_pixels.
	pixels = rasterImage.load_argb_64_pixels(rasterImage.bounds)

	count = 0
	for pixel in pixels:
		# Tenga en cuenta que todos los componentes de color, incluido el alfa, se representan con valores de 16 bits, por lo que sus valores permitidos están en el rango [0, 63535].
		alpha = (pixel >> 48) & 0xffff
		if alpha == 0:
			count += 1

	print(f"The number of fully transparent pixels is {count}")
	print(f"The total number of pixels is {image.width * image.height}")

The following example shows how to load and process pixels of a raster image. For example, consider a problem of counting of fully transparent pixels of an image.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage

with Image.load("alpha.png") as image:
	rasterImage = as_of(image, RasterImage)
	# Cargar píxeles para toda la imagen. Cualquier parte rectangular de la imagen puede especificarse como un parámetro del método aspose.imaging.RasterImage.load_pixels.
	pixels = rasterImage.load_pixels(rasterImage.bounds)

	count = 0
	for pixel in pixels:
		if pixel.a == 0:
			count += 1

	print(f"The number of fully transparent pixels is {count}")
	print(f"The total number of pixels is {image.width * image.height}")

The following example fills the central area of a raster image with black pixels using the aspose.imaging.RasterImage.save_argb_32_pixels method.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage, Rectangle, Color
from os.path import join as join_path

directory = r"c:\temp"

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# El cuadrado negro
	pixel_count = ((rasterImage.width // 2) * (rasterImage.height // 2))
	black_color = Color.black.to_argb()
	pixels = [black_color] * pixel_count

	# Dibujar el cuadrado negro en el centro de la imagen.
	area = Rectangle(rasterImage.width // 4, rasterImage.height // 4, rasterImage.width // 2, rasterImage.height // 2)
	rasterImage.save_argb_32_pixels(area, pixels)

	rasterImage.save(join_path(directory, "sample.SaveArgb32Pixels.png"))

The following example fills the central area of a raster image with black pixels using the aspose.imaging.RasterImage.save_pixels method.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage, Rectangle, Color
from os.path import join as join_path

directory = r"c:\temp"

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# El cuadrado negro
	pixel_count = ((rasterImage.width // 2) * (rasterImage.height // 2))
	black_color = Color.black
	pixels = [black_color] * pixel_count

	# Dibujar el cuadrado negro en el centro de la imagen.
	area = Rectangle(rasterImage.width // 4, rasterImage.height // 4, rasterImage.width // 2, rasterImage.height // 2)
	rasterImage.save_pixels(area, pixels)

	rasterImage.save(join_path(directory, "sample.SavePixels.png"))

The following example fills the central area of a raster image with black pixels using the aspose.imaging.RasterImage.save_cmyk_32_pixels method.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage, Rectangle, Color, CmykColorHelper
from os.path import join as join_path

directory = r"c:\temp"

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# Obtener una representación entera del negro en el espacio de color CMYK.
	blackCmyk = CmykColorHelper.to_cmyk(Color.black)
	# El cuadrado negro.
	pixel_count = (rasterImage.width // 2) * (rasterImage.height // 2)
	pixels = [blackCmyk] * pixel_count
	# Dibujar el cuadrado negro en el centro de la imagen.
	area = Rectangle(rasterImage.width // 4, rasterImage.height // 4, rasterImage.width // 2, rasterImage.height // 2)
	rasterImage.save_cmyk_32_pixels(area, pixels)

	rasterImage.save(join_path(directory, "sample.SaveCmyk32Pixels.png"))

The following example crops a raster image. The cropping area is be specified via aspose.imaging.Rectangle.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage, Rectangle
from os.path import join as join_path

directory = r"c:\temp"

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# Recortar la imagen. El área de recorte es la zona rectangular central de la imagen.
	area = Rectangle(rasterImage.width // 4, rasterImage.height // 4, rasterImage.width // 2, rasterImage.height // 2)
	rasterImage.crop(area)
	# Guardar la imagen recortada en PNG
	rasterImage.save(join_path(directory, "sample.Crop.png"))

The following example crops a raster image. The cropping area is specified via Left, Top, Right, Bottom margins.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage, Rectangle, Color
from os.path import join as join_path

directory = r"c:\temp"

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# Recortar de nuevo. Establecer un margen del 10 % del tamaño de la imagen.
	horizontalMargin = rasterImage.width // 10
	verticalMargin = rasterImage.height // 10
	rasterImage.crop(horizontalMargin, horizontalMargin, verticalMargin, verticalMargin)
	# Guardar la imagen recortada en PNG.
	rasterImage.save(join_path(directory, "sample.Crop.png"))

The following example binarizes a raster image with the predefined threshold. Binarized images contain only 2 colors - black and white.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage
from os.path import join as join_path

directory = r"c:\temp"

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# Binarizar la imagen con un valor de umbral de 127.
	# Si el valor gris correspondiente de un píxel es mayor que 127, se le asignará un valor de 255, 0 en caso contrario.
	rasterImage.binarize_fixed(127)
	rasterImage.save(join_path(directory, "sample.BinarizeFixed.png"))

The following example binarizes a raster image with Bradley’s adaptive thresholding algorithm with the specified window size. Binarized images contain only 2 colors - black and white.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage
from os.path import join as join_path

directory = r"c:\temp"

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# Binarizar la imagen con una diferencia de brillo de 5. El brillo es una diferencia entre un píxel y el promedio de una ventana de 10 × 10 píxeles centrada en ese píxel.
	rasterImage.binarize_bradley(5, 10)
	rasterImage.save(join_path(directory, "sample.BinarizeBradley5_10x10.png"))

The following example performs gamma-correction of an image.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage
from os.path import join as join_path

directory = r"c:\temp"

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# Establecer el coeficiente gamma para los canales rojo, verde y azul.
	rasterImage.adjust_gamma(2.5f)
	rasterImage.save(join_path(directory, "sample.AdjustGamma.png"))

The following example performs gamma-correction of an image applying different coefficients for color components.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage
from os.path import join as join_path

directory = r"c:\temp"

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# Establecer el coeficiente gamma para los canales rojo, verde y azul.
	rasterImage.adjust_gamma(1.5f, 2.5f, 3.5f)
	rasterImage.save(join_path(directory, "sample.AdjustGamma.png"))

The following example performs brightness correction of an image.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage
from os.path import join as join_path

directory = r"c:\temp"

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# Establecer el valor de brillo. Los valores aceptados de brillo están en el rango [-255, 255].
	rasterImage.adjust_brightness(50)
	rasterImage.save(join_path(directory, "sample.AdjustBrightness.png"))

The following example performs contrast correction of an image.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage
from os.path import join as join_path

directory = r"c:\temp"

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# Establecer el valor de contraste. Los valores aceptados de contraste están en el rango [-100f, 100f].
	rasterImage.adjust_contrast(50)
	rasterImage.save(join_path(directory, "sample.AdjustContrast.png"))

The following example applies various types of filters to a raster image.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage
from aspose.imaging.imagefilters.filteroptions import *
from os.path import join as join_path

directory = r"c:\temp"

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# Aplicar un filtro mediano con un tamaño de rectángulo de 5 a toda la imagen.
	rasterImage.filter(rasterImage.bounds, MedianFilterOptions(5))
	rasterImage.save(join_path(directory, "sample.MedianFilter.png"))

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# Aplicar un filtro de suavizado bilateral con un tamaño de kernel de 5 a toda la imagen.
	rasterImage.filter(rasterImage.bounds, BilateralSmoothingFilterOptions(5))
	rasterImage.save(join_path(directory, "sample.BilateralSmoothingFilter.png"))

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# Aplicar un filtro de desenfoque gaussiano con un radio de 5 y un valor sigma de 4.0 a toda la imagen.
	rasterImage.filter(rasterImage.bounds, GaussianBlurFilterOptions(5, 4.0))
	rasterImage.save(join_path(directory, "sample.GaussianBlurFilter.png"))

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# Aplicar un filtro Gauss-Wiener con un radio de 5 y un valor de suavizado de 4.0 a toda la imagen.
	rasterImage.filter(rasterImage.bounds, GaussWienerFilterOptions(5, 4.0))
	rasterImage.save(join_path(directory, "sample.GaussWienerFilter.png"))

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# Aplicar un filtro wiener de movimiento con una longitud de 5, un valor de suavizado de 4.0 y un ángulo de 90.0 grados a toda la imagen.
	rasterImage.filter(rasterImage.bounds, MotionWienerFilterOptions(10, 1.0, 90.0))
	rasterImage.save(join_path(directory, "sample.MotionWienerFilter.png"))
}

with Image.load(join_path(directory, "sample.png")) as image:
	rasterImage = as_of(image, RasterImage)
	# Aplicar un filtro de nitidez con un tamaño de kernel de 5 y un valor sigma de 4.0 a toda la imagen.
	rasterImage.filter(rasterImage.bounds, SharpenFilterOptions(5, 4.0))
	rasterImage.save(join_path(directory, "sample.SharpenFilter.png"))

This example loads a raster image and resizes it using various resizing methods.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage, ResizeType
from os.path import join as join_path

directory = r"c:\temp"

with Image.load(join_path(directory, "sample.gif")) as image:
	rasterImage = as_of(image, RasterImage)
	# Escala 2 veces usando remuestreo del vecino más cercano.
	rasterImage.resize(image.width * 2, image.height * 2, ResizeType.NEAREST_NEIGHBOUR_RESAMPLE)
	image.save(join_path(directory, "upsample.nearestneighbour.gif"))

with Image.load(join_path(directory, "sample.gif")) as image:
	rasterImage = as_of(image, RasterImage)
	# Reduce 2 veces usando remuestreo del vecino más cercano.
	rasterImage.resize(image.width // 2, image.height // 2, ResizeType.NEAREST_NEIGHBOUR_RESAMPLE);
	image.Save(dir + "downsample.nearestneighbour.gif");

with Image.load(join_path(directory, "sample.gif")) as image:
	rasterImage = as_of(image, RasterImage)
	# Escala 2 veces usando remuestreo bilineal.
	rasterImage.resize(image.width * 2, image.height * 2, ResizeType.BILINEAR_RESAMPLE)
	image.save(join_path(directory, "upsample.bilinear.gif"))

with Image.load(join_path(directory, "sample.gif")) as image:
	rasterImage = as_of(image, RasterImage)
	# Reduce 2 veces usando remuestreo bilineal.
	rasterImage.resize(image.width // 2, image.height // 2, ResizeType.BILINEAR_RESAMPLE)
	image.Save(dir + "downsample.bilinear.gif");

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

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage, ImageResizeSettings, ResizeType,\
	ImageFilterType, ColorQuantizationMethod, ColorCompareMethod
from os.path import join as join_path

directory = r"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.color_compare_method = ColorCompareMethod.EUCLIDIAN

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

The following example shows how to extract information about raw data format and alpha channel from a BMP image.

from aspose.imaging.fileformats.bmp import BmpImage

# Crear una imagen BMP de 32 bpp de 100 x 100 px.
with BmpImage(100, 100, 32, None) as bmp_image:
	print("FileFormat={0}, RawDataFormat={1}, HasAlpha={2}".format(bmp_image.file_format.name, bmp_image.raw_data_format, bmp_image.has_alpha))


# Crear una imagen BMP de 24 bpp de 100 x 100 px.
with BmpImage(100, 100, 24, None) as bmp_image:
	print("FileFormat={0}, RawDataFormat={1}, HasAlpha={2}".format(bmp_image.file_format.name, bmp_image.raw_data_format, bmp_image.has_alpha))

# Generalmente, BMP no soporta canal alfa, por lo que la salida se verá así:
# FileFormat = BMP, RawDataFormat = Rgb32Bpp, used channels: 8,8,8,8, HasAlpha = False
# FileFormat = BMP, RawDataFormat = Rgb24Bpp, used channels: 8,8,8, HasAlpha = False

Skew is an artifact that might appear during document scanning process when the text/images of the document get rotated at a slight angle. It can have various causes but the most common is that the paper get misplaced during a scan. Therefore, deskew is the process of detecting and fixing this issue on scanned files(i.e. bitmap) so deskewed documents will have the text/images correctly and horizontally adjusted.

from aspose.imaging import Image, RasterImage, Color
from aspose.pycore import as_of

dir_: str = "c:\\3567\\"
input_file_path: str = dir_ + "skewed.png"
output_file_path: str = dir_ + "skewed.out.png"
# Elimine la exploración sesgada con los parámetros predeterminados
with as_of(Image.load(input_file_path), RasterImage) as image:
	# Desinclinar
	image.normalize_angle(False, Color.light_gray)
	image.save(output_file_path)

The example shows how to validate that the embedded digital signature matches the provided password.

from aspose.imaging import Image

with Image.load(output_path) as image:
	is_signed = image.is_digital_signed(password, -1)

The example shows how to embed digital signature based on provided password into image pixel data.

from aspose.imaging import Image

image_file_path = "ball.png"
password = "veryStr0ngPassword"
with Image.load(image_file_path) as image:
	image.embed_digital_signature(password)
	image.save(output_path)

The example demonstrates how to verify that the embedded digital signature matches the provided password against the specified probability threshold.

from aspose.imaging import Image
  
threshold = 100
with Image.load(output_path) as image:
	is_signed = image.is_digital_signed(password, threshold)

The example illustrates how to determine the probability (from 0% to 100%) that an image contains a digital signature created with the specified password.

from aspose.imaging import Image

with Image.load(output_path) as image:
	signed_percentage = image.analyze_percentage_digital_signature(password)