Clase GifImage

Summary: The API for Graphical Interchange Format (GIF) image file provides
developers with versatile tools for processing compressed raster images and
animated GIFs. Offering features like XMP metadata handling, color palette
settings, background and transparent color control, opacity settings, resize,
crop, filter application, gamma corrections, contrast adjustment, grayscale
transformation, and conversion to other formats. This API empowers seamless
manipulation and enhancement of GIF images for a wide range of applications.

Module: aspose.imaging.fileformats.gif

Full Name: aspose.imaging.fileformats.gif.GifImage

Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, IRasterImageArgb32PixelLoader, IRasterImageRawDataLoader, IMultipageImage, IMultipageImageExt, RasterCachedMultipageImage

Constructors

Name	Descripción
GifImage(first_frame)	Crear imágenes GIF se vuelve sencillo con el GifImage constructor. Con solo el parámetro firstFrame, se adentra en un mundo de comunicación visual dinámica .
GifImage(first_frame, global_palette)	Inicia un nuevo objeto GifImage con los parámetros especificados para el first frame y la paleta global. Comienza a gestionar imágenes GIF rápidamente, asegurando una representación precisa con configuraciones personalizables para obtener resultados óptimos.
GifImage(first_frame, global_palette, is_palette_sorted, palette_color_resolution, palette_background_color_index, aspect_ratio, has_trailer)	Comienza sin esfuerzo con el constructor GifImage. Con este método simple, puedes sumergirte en la creación de GIFs animados con facilidad. Simplemente proporciona el firstFrame, globalPalette, paletteColorResolution, aspectRatio y otros parámetros, y estarás listo para dar vida a tus visuales.

Properties

Name	Type	Access	Descripción
active_frame	GifFrameBlock	r/w	Gestiona y manipula fotogramas con esta propiedad, permitiendo una navegación fluida y la modificación del fotograma activo dentro de la imagen GIF.
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	Gestiona el color de fondo de la imagen GIF con esta propiedad. Puedes establecer o recuperar el color de fondo para garantizar consistencia y mejorar el atractivo visual.
background_color_index	System.Byte	r/w	Controla el índice del color de fondo de la imagen GIF usando esta propiedad. Establece o recupera el índice para mantener la consistencia o lograr los efectos visuales deseados.
bits_per_pixel	int	r	Obtiene el recuento de bits por píxel de la imagen.
blocks	IGifBlock[]	r	Obtén acceso a los bloques GIF sin problemas con esta propiedad, facilitando la fácil recuperación y manipulación de las estructuras de datos subyacentes de la imagen.
bounds	Rectangle	r	Obtiene los límites del objeto.
buffer_size_hint	int	r/w	Obtiene o establece la sugerencia de tamaño del búfer, que se define como el tamaño máximo permitido para todos los búferes internos.
container	Image	r	Obtiene el contenedor Image.
data_stream_container	StreamContainer	r	Obtiene el flujo de datos del objeto.
disposed	bool	r	Obtiene un valor que indica si esta instancia está disposed.
exif_data	ExifData	r/w	Obtiene o establece la instancia Exif.
file_format	FileFormat	r	Recupera el formato de archivo sin esfuerzo con esta propiedad. Es tu fuente principal para identificar el formato de tus archivos. Integrada sin problemas en tu flujo de trabajo, proporciona información vital sin complicaciones.
has_alpha	bool	r	Obtiene un valor que indica si esta instancia tiene alfa.
has_background_color	bool	r/w	Esta propiedad determina si la imagen GIF contiene un color de fondo. Si es true, indica que la imagen incluye un color de fondo.
has_trailer	bool	r/w	Gestiona la presencia de un trailer en tus archivos GIF con esta propiedad. Ya sea que necesites comprobar si existe un trailer o establecer su presencia, esta propiedad simplifica el proceso. Mantén tus archivos GIF estructurados y conformes con esta característica intuitiva.
has_transparent_color	bool	r/w	Determina si el fotograma activo de la imagen GIF incluye un color transparente. Esta propiedad ofrece una forma conveniente de verificar la transparencia dentro de la imagen.
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	Recupera la opacidad del fotograma activo dentro de la imagen, ofreciendo una visión del nivel de transparencia. Esta propiedad es particularmente útil para comprender el grado de transparencia u opacidad del fotograma activo en la imagen.
interrupt_monitor	InterruptMonitor	r/w	Obtiene o establece el monitor de interrupciones.
is_cached	bool	r	Obtiene un valor que indica si los datos de la imagen están almacenados en caché actualmente.
is_interlaced	bool	r	Determina si la imagen está entrelazada, lo que afecta su visualización durante la carga. Esta propiedad ofrece información sobre el comportamiento de renderizado de la imagen, esencial para optimizar las estrategias de carga y mejorar la experiencia de visualización en general.
is_palette_sorted	bool	r/w	Controla la ordenación de la paleta en tus imágenes GIF usando esta propiedad. Ya sea que necesites comprobar si la paleta está ordenada o establecer el comportamiento de ordenación, esta propiedad ofrece una forma sencilla de gestionar la organización de la paleta en tus archivos GIF.
is_raw_data_available	bool	r	Obtiene un valor que indica si se admite la carga de datos sin procesar.
loops_count	int	r/w	Obtén el recuento de bucles sin esfuerzo con esta propiedad. Si tu imagen GIF incluye información de bucle, esta propiedad te brinda acceso rápido al recuento de bucles, lo que te permite gestionar de forma fluida el comportamiento de repetición en tus archivos GIF.
metadata	ImageMetadata	r	Obtiene o establece los datos XMP del fotograma.
page_count	int	r	Obtén el número total de páginas contenidas en la imagen con esta propiedad sencilla. Ideal para evaluar rápidamente la extensión del contenido de la imagen.
pages	Image[]	r	Obtén acceso a las páginas dentro de la imagen mediante esta práctica propiedad, que permite una navegación fluida y la manipulación de páginas individuales según sea necesario.
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.
palette_color_resolution_bits	System.Byte	r/w	Gestiona la resolución de color de la paleta de tus imágenes GIF con esta propiedad. Ajusta el número de bits utilizados para representar los colores en la paleta, proporcionando un control preciso sobre la profundidad de color y la calidad de la imagen.
pixel_aspect_ratio	System.Byte	r/w	Gestiona la relación de aspecto de los píxeles de la imagen GIF con esta propiedad. Establece o recupera la relación de aspecto para garantizar una renderización precisa y mantener la fidelidad visual.
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 del objeto.
transparent_color	Color	r/w	Obtén el color transparente del fotograma activo en la imagen GIF. Esta propiedad te permite acceder al color específico que ha sido designado como transparente dentro del fotograma actualmente activo.
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
add_block(block)	Agregar un nuevo bloque GIF te permite incluir datos adicionales dentro de la imagen. Este método te permite añadir bloques personalizados a la imagen GIF, los cuales pueden contener varios tipos de información.
add_page(page)	Incorpora una nueva página de forma fluida en la imagen existente, mejorando su contenido y ampliando su alcance. Este método aumenta las colecciones de imágenes con contenido adicional, fomentando la creatividad y la flexibilidad en la gestión y composición de imágenes.
adjust_brightness(brightness)	Ajusta el brillo de la imagen según el parámetro especificado brightness. Este método modifica el brillo de toda la imagen de manera uniforme, aumentando o reduciendo la luminancia general para lograr el efecto deseado.
adjust_contrast(contrast)	Ajusta el contraste de la imagen, aumentando o reduciendo la diferencia de brillo entre píxeles. Este método modifica el rango tonal general de la imagen, haciendo que las áreas más oscuras sean más oscuras y las áreas más claras más brillantes para mejorar la claridad visual y el detalle.
adjust_gamma(gamma)	Mejora la calidad de la imagen aplicando corrección gamma. Este método ajusta la gamma de color de la imagen para lograr una claridad visual óptima. Modifica el valor gamma de cada píxel, resultando en una mejor reproducción del color y una apariencia general de la imagen mejorada.
adjust_gamma(gamma_red, gamma_green, gamma_blue)	La corrección gamma de una imagen aplica un ajuste no lineal a los valores de los píxeles, aumentando o reduciendo el brillo según los coeficientes especificados para los canales rojo, verde y azul. Este método ayuda a afinar el equilibrio de color y la luminancia de la imagen, mejorando su apariencia general y calidad visual.
analyze_percentage_digital_signature(password)	Calcula el porcentaje de similitud entre los datos extraídos y la contraseña original.
auto_brightness_contrast()	Realiza una 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)	La binarización de una imagen usando el algoritmo de umbral adaptativo de Bradley con umbralado de imagen integral es un método para convertir una imagen en escala de grises en una imagen binaria. Este algoritmo calcula un umbral local para cada píxel basado en la intensidad promedio de los píxeles circundantes dentro de una ventana especificada. Al ajustar adaptativamente el umbral según las intensidades locales de los píxeles, el método de Bradley es eficaz para manejar variaciones de iluminación y contraste en toda la imagen.
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)	La binarización de una imagen con un umbral predefinido convierte una imagen en escala de grises o a color en una imagen binaria, donde cada píxel se clasifica como negro o blanco según si su valor de intensidad supera un umbral especificado.
binarize_otsu()	La binarización de una imagen con umbralizado de Otsu es un método utilizado para determinar automáticamente el valor de umbral óptimo para convertir una imagen en escala de grises en una imagen binaria. El algoritmo de umbralizado de Otsu calcula el umbral que minimiza la varianza intra-clase de las intensidades de los píxeles en las dos clases resultantes (primer plano y fondo). Esta técnica es particularmente útil cuando el valor de umbral óptimo es desconocido y necesita determinarse de forma adaptativa basada en el histograma de la imagen.
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()	Cachea los datos de forma privada.
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.
clear_blocks()	Eliminar todos los bloques GIF elimina cualquier dato existente almacenado dentro de la imagen. Esta operación restablece efectivamente la imagen a un estado vacío, eliminando cualquier bloque añadido previamente. Usa este método cuando necesites comenzar de nuevo con una pizarra limpia para crear o modificar una imagen GIF.
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 la imagen usando un área rectangular especificada. Esta operación elimina la parte externa de la imagen, dejando solo la región seleccionada definida por el rectángulo.
dither(dithering_method, bits_count)	Aplica dithering a la imagen actual.
dither(dithering_method, bits_count, custom_palette)	Aplicar dithering a la imagen actual. Este proceso mejora la calidad de la imagen al reducir el banding de color y mejorar las transiciones de color, resultando en una apariencia más suave .
embed_digital_signature(password)	Incrusta una firma digital basada en la contraseña proporcionada en cada página de la imagen.
filter(rectangle, options)	Aplicar un filtro específico al área designada de la imagen, mejorando su calidad visual o alterando su apariencia según se desee. Este método procesa selectivamente los píxeles dentro del rectángulo definido, permitiendo realizar ajustes dirigidos mientras se preserva la integridad de los datos de la imagen circundante.
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()	Recuperar las opciones basadas en la configuración original del archivo, cruciales para mantener la fidelidad y consistencia en el procesamiento y manipulación de imágenes. Este método permite una integración fluida de parámetros específicos del archivo en operaciones posteriores, asegurando una representación precisa y el cumplimiento de las características inherentes de la imagen. Esto puede ser útil para mantener sin cambios la profundidad de bits y otros parámetros de la imagen original. Por ejemplo, si cargamos una imagen PNG en blanco y negro con 1 bit por píxel y luego la guardamos usando el DataStreamSupporter.save(file_path) método, 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 Image.save(file_path, options) método 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()	La transformación de una imagen a su representación en escala de grises convierte la imagen a color en una versión en escala de grises al eliminar la información de color mientras se preserva la luminancia. Este proceso simplifica la imagen a tonos de gris, haciéndola adecuada para diversas aplicaciones como impresión, procesamiento de documentos y análisis en escala de grises.
insert_block(index, block)	Insertar un nuevo bloque GIF le permite agregar datos personalizados en una posición específica dentro de la imagen. Este método le permite colocar bloques personalizados en la ubicación deseada en la imagen GIF, proporcionando flexibilidad en la organización y estructuración de los datos de la imagen.
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 parcialmente píxeles ARGB de 32 bits (por bloques).
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 distorsión del escaneo. Este método utiliza los métodos RasterImage.get_skew_angle() y RasterCachedMultipageImage.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.
order_blocks()	Ordenar los bloques GIF de acuerdo con la especificación GIF garantiza una disposición adecuada del GIF y el cumplimiento del estándar. Este proceso implica organizar los bloques en la secuencia correcta según lo definido por la especificación. Además, puede implicar la eliminación de ciertas instancias de GifGraphicsControlBlock que no son necesarias para la disposición final. Al adherirse a la especificación GIF, la imagen resultante estará estructurada correctamente y será compatible con las aplicaciones de visualización de GIF.
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_block(block)	Eliminar un bloque GIF elimina datos específicos de la imagen, ofreciendo la capacidad de limpiar o modificar la estructura de la imagen. Este método le permite eliminar bloques no deseados o innecesarios, optimizando la imagen GIF para un almacenamiento eficiente. Use esta funcionalidad para eliminar información obsoleta de la imagen mientras se preserva su integridad y calidad.
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 con un nuevo color y preserva el valor alfa original para mantener bordes suaves. Nota: si lo usa en imágenes sin transparencia, todos los colores se reemplazarán por uno solo.
replace_non_transparent_colors(new_color_argb)	Reemplaza todos los colores no transparentes con un nuevo color y preserva el valor alfa original para mantener bordes suaves. Nota: si lo usa en imágenes sin transparencia, todos los colores se reemplazarán 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 esta instancia de Image.
resize(new_width, new_height, settings)	Redimensiona esta instancia de Image.
resize_by_settings(new_width, new_height, settings)	Redimensiona la imagen.
resize_by_type(new_width, new_height, resize_type)	Redimensiona la imagen.
resize_full_frame(new_width, new_height, resize_type)	Redimensionar la imagen teniendo en cuenta todos los fotogramas de cada página en un GIF, evitando así la aparición de artefactos potenciales. Este método es esencial para mantener la integridad y calidad de la imagen, especialmente al trabajar con GIFs animados o secuencias de fotogramas.
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 el ancho proporcionalmente.
resize_height_proportionally(new_height, settings)	Redimensiona la altura proporcionalmente.
resize_height_proportionally_settings(new_height, settings)	Redimensiona la altura proporcionalmente.
resize_proportional(new_width, new_height, resize_type)	El redimensionado proporcional mantiene la relación de aspecto de la imagen mientras ajusta su tamaño, asegurando que la imagen no aparezca estirada o distorsionada. Este método redimensiona la imagen proporcionalmente, escalando tanto el ancho como la altura por el mismo factor. El redimensionado proporcional ajustará cada fotograma según la proporción de newWidth/width y newHeight/height.
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)	Este método rota la imagen alrededor de su punto central. Al especificar el ángulo de rotación puedes girar la imagen en sentido horario o antihorario para lograr la orientación deseada. Esta rotación ayuda a ajustar la presentación o alineación de la imagen sin distorsionar su contenido.
rotate_flip(rotate_flip_type)	Realizar rotación, volteo o ambos en el fotograma activo exclusivamente. Esta operación aplica transformaciones únicamente al fotograma actualmente activo de la imagen, preservando la integridad de los demás fotogramas en la secuencia.
rotate_flip_all(rotate_flip)	Rota el volteo completo.
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 internos principales.
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_frame_time(time)	Ajusta la duración de cada fotograma en milisegundos, asegurando una sincronización constante a lo largo de la secuencia de imágenes. Este método establece uniformemente el tiempo de visualización para cada fotograma, permitiendo un control preciso de la velocidad de animación. Cambiar este valor restablecerá el retraso para todos los fotogramas.
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 la instancia 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.

Constructor: GifImage(first_frame)

 GifImage(first_frame) 

Crear imágenes GIF se vuelve sencillo con el GifImage
constructor. Con solo el parámetro firstFrame, se adentra en un mundo de comunicación visual dinámica
.

Parameters:

Parámetro	Tipo	Descripción
first_frame	GifFrameBlock	El primer fotograma con el que inicializar la imagen GIF.

See also:

Example # 1: This example shows how to create a GIF image and save it to a file.

Example # 2: The following example shows how to compose an animated GIF image from individ…

Constructor: GifImage(first_frame, global_palette)

 GifImage(first_frame, global_palette) 

Inicia un nuevo objeto GifImage con los parámetros especificados para el
first frame y la paleta global. Comienza a gestionar imágenes GIF rápidamente, asegurando
una representación precisa con configuraciones personalizables para obtener resultados óptimos.

Parameters:

Parámetro	Tipo	Descripción
first_frame	GifFrameBlock	El primer fotograma con el que inicializar la imagen GIF.
global_palette	IColorPalette	La paleta global a usar. Nota: si tanto firstFrame como globalPalette son nulos, se utilizará la paleta global predeterminada.

See also:

Example # 1: This example shows how to create a GIF image with a custom palette and save i…

Constructor: GifImage(first_frame, global_palette, is_palette_sorted, palette_color_resolution, palette_background_color_index, aspect_ratio, has_trailer)

 GifImage(first_frame, global_palette, is_palette_sorted, palette_color_resolution, palette_background_color_index, aspect_ratio, has_trailer) 

Comienza sin esfuerzo con el constructor GifImage. Con este
método simple, puedes sumergirte en la creación de GIFs animados con facilidad. Simplemente proporciona el
firstFrame, globalPalette, paletteColorResolution, aspectRatio y otros
parámetros, y estarás listo para dar vida a tus visuales.

Parameters:

Parámetro	Tipo	Descripción
first_frame	GifFrameBlock	El primer fotograma con el que inicializar la imagen GIF.
global_palette	IColorPalette	La paleta global a usar. Nota: si tanto firstFrame como globalPalette son nulos, se utilizará la paleta global predeterminada.
is_palette_sorted	bool	si se establece en true la paleta se ordena. Nota: el parámetro se usa cuando globalPalette no es nulo.
palette_color_resolution	System.Byte	La resolución de color de la paleta. Nota: el parámetro se usa cuando globalPalette no es nulo.
palette_background_color_index	System.Byte	El índice de color de fondo de la paleta.
aspect_ratio	System.Byte	La relación de aspecto.
has_trailer	bool	si se establece en true la imagen GIF tiene trailer; de lo contrario, no se escribe trailer al final del flujo.

Property: active_frame

Gestiona y manipula fotogramas con esta propiedad, permitiendo una navegación fluida y
la modificación del fotograma activo dentro de la imagen GIF.

See also:

Example # 1: The following example shows how to remove all blocks from a GIF image.

Method: add_block(block)

 add_block(block) 

Agregar un nuevo bloque GIF te permite incluir datos adicionales dentro de la imagen.
Este método te permite añadir bloques personalizados a la imagen GIF, los cuales pueden
contener varios tipos de información.

Parameters:

Parámetro	Tipo	Descripción
block	IGifBlock	El bloque GIF a agregar.

See also:

Example # 1: The following example shows how to compose an animated GIF image from individ…

Method: add_page(page)

 add_page(page) 

Incorpora una nueva página de forma fluida en la imagen existente, mejorando su contenido
y ampliando su alcance. Este método aumenta las colecciones de imágenes con contenido adicional,
fomentando la creatividad y la flexibilidad en la gestión y composición de imágenes.

Parameters:

Parámetro	Tipo	Descripción
page	RasterImage	La página a añadir.

See also:

Example # 1: Create multipage GIF image using single page raster images.

Method: adjust_brightness(brightness)

 adjust_brightness(brightness) 

Ajusta el brillo de la imagen según el parámetro especificado
brightness. Este método modifica el brillo de
toda la imagen de manera uniforme, aumentando o reduciendo la luminancia general para lograr
el efecto deseado.

Parameters:

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

See also:

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

Method: adjust_contrast(contrast)

 adjust_contrast(contrast) 

Ajusta el contraste de la imagen, aumentando o reduciendo la diferencia de
brillo entre píxeles. Este método modifica el rango tonal general de la imagen,
haciendo que las áreas más oscuras sean más oscuras y las áreas más claras más brillantes para mejorar la claridad visual
y el detalle.

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 a GIF image.

Method: adjust_gamma(gamma)

 adjust_gamma(gamma) 

Mejora la calidad de la imagen aplicando corrección gamma. Este método ajusta la gamma de color
de la imagen para lograr una claridad visual óptima. Modifica el valor gamma
de cada píxel, resultando en una mejor reproducción del color y una apariencia general de la imagen mejorada.

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 a GIF image.

Method: adjust_gamma(gamma_red, gamma_green, gamma_blue)

 adjust_gamma(gamma_red, gamma_green, gamma_blue) 

La corrección gamma de una imagen aplica un ajuste no lineal a los valores de los píxeles,
aumentando o reduciendo el brillo según los coeficientes especificados para los canales rojo,
verde y azul. Este método ayuda a afinar el equilibrio de color y la
luminancia de la imagen, mejorando su apariencia general y calidad visual.

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 a GIF image applying diffe…

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.

Method: binarize_bradley(brightness_difference)

 binarize_bradley(brightness_difference) 

La binarización de una imagen usando el algoritmo de umbral adaptativo de Bradley con
umbralado de imagen integral es un método para convertir una imagen en escala de grises en una
imagen binaria. Este algoritmo calcula un umbral local para cada píxel basado en
la intensidad promedio de los píxeles circundantes dentro de una ventana especificada. Al
ajustar adaptativamente el umbral según las intensidades locales de los píxeles, el método de Bradley
es eficaz para manejar variaciones de iluminación y contraste en toda la imagen.

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 píxeles de s x s centrada alrededor de 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

Method: binarize_fixed(threshold)

 binarize_fixed(threshold) 

La binarización de una imagen con un umbral predefinido convierte una imagen en escala de grises o a color
en una imagen binaria, donde cada píxel se clasifica como negro o blanco
según si su valor de intensidad supera un umbral especificado.

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 GIF image with the predefined threshold. Bi…

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.

Method: crop(rectangle)

 crop(rectangle) 

Recorta la imagen usando un área rectangular especificada. Esta operación elimina la parte externa
de la imagen, dejando solo la región seleccionada definida por el rectángulo.

Parameters:

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

See also:

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

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.

Method: dither(dithering_method, bits_count, custom_palette)

 dither(dithering_method, bits_count, custom_palette) 

Aplicar dithering a la imagen actual. Este proceso mejora la calidad de la imagen al
reducir el banding de color y mejorar las transiciones de color, resultando en una apariencia más suave
.

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) 

Incrusta una firma digital basada en la contraseña proporcionada en cada página de la imagen.

Parameters:

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

Method: filter(rectangle, options)

 filter(rectangle, options) 

Aplicar un filtro específico al área designada de la imagen, mejorando su calidad visual
o alterando su apariencia según se desee. Este método procesa selectivamente
los píxeles dentro del rectángulo definido, permitiendo realizar ajustes dirigidos
mientras se preserva la integridad de los datos de la imagen circundante.

Parameters:

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

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.

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

Recuperar las opciones basadas en la configuración original del archivo, cruciales para mantener la fidelidad
y consistencia en el procesamiento y manipulación de imágenes. Este método permite una integración fluida
de parámetros específicos del archivo en operaciones posteriores, asegurando
una representación precisa y el cumplimiento de las características inherentes de la imagen.
Esto puede ser útil para mantener sin cambios la profundidad de bits y otros parámetros de la imagen original.
Por ejemplo, si cargamos una imagen PNG en blanco y negro con 1 bit por píxel y luego la guardamos usando el
DataStreamSupporter.save(file_path) método, 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 Image.save(file_path, options) método 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.

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: insert_block(index, block)

 insert_block(index, block) 

Insertar un nuevo bloque GIF le permite agregar datos personalizados en una posición específica
dentro de la imagen. Este método le permite colocar bloques personalizados en la ubicación deseada
en la imagen GIF, proporcionando flexibilidad en la organización y estructuración de los
datos de la imagen.

Parameters:

Parámetro	Tipo	Descripción
index	int	El elemento basado en cero, en el cual se insertará el bloque.
block	IGifBlock	El bloque GIF a agregar.

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.

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.

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.

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 parcialmente píxeles ARGB de 32 bits (por bloques).

Parameters:

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

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.

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 distorsión del escaneo.
Este método utiliza los métodos RasterImage.get_skew_angle() y RasterCachedMultipageImage.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.

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: remove_block(block)

 remove_block(block) 

Eliminar un bloque GIF elimina datos específicos de la imagen, ofreciendo la capacidad de
limpiar o modificar la estructura de la imagen. Este método le permite eliminar bloques no deseados
o innecesarios, optimizando la imagen GIF para un almacenamiento eficiente. Use esta
funcionalidad para eliminar información obsoleta de la imagen mientras se preserva
su integridad y calidad.

Parameters:

Parámetro	Tipo	Descripción
block	IGifBlock	El bloque a eliminar.

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
old_color_diff	System.Byte	Diferencia permitida en el color antiguo para poder ampliar el tono del color reemplazado.
new_color	Color

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 con un nuevo color y preserva el valor alfa original para mantener bordes suaves.
Nota: si lo usa en imágenes sin transparencia, todos los colores se reemplazarán por uno solo.

Parameters:

Parámetro	Tipo	Descripción
new_color	Color

Method: replace_non_transparent_colors(new_color_argb)

 replace_non_transparent_colors(new_color_argb) 

Reemplaza todos los colores no transparentes con un nuevo color y preserva el valor alfa original para mantener bordes suaves.
Nota: si lo usa en imágenes sin transparencia, todos los colores se reemplazarán 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 esta instancia de Image.

Parameters:

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

Method: resize(new_width, new_height, settings)

 resize(new_width, new_height, settings) 

Redimensiona esta instancia de Image.

Parameters:

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

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_full_frame(new_width, new_height, resize_type)

 resize_full_frame(new_width, new_height, resize_type) 

Redimensionar la imagen teniendo en cuenta todos los fotogramas de cada página en un
GIF, evitando así la aparición de artefactos potenciales. Este método es esencial
para mantener la integridad y calidad de la imagen, especialmente al trabajar con
GIFs animados o secuencias de fotogramas.

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 el ancho 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_proportional(new_width, new_height, resize_type)

 resize_proportional(new_width, new_height, resize_type) 

El redimensionado proporcional mantiene la relación de aspecto de la imagen mientras ajusta su
tamaño, asegurando que la imagen no aparezca estirada o distorsionada. Este método
redimensiona la imagen proporcionalmente, escalando tanto el ancho como la altura por el mismo factor.
El redimensionado proporcional ajustará cada fotograma según la proporción de newWidth/width y newHeight/height.

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

Este método rota la imagen alrededor de su punto central. Al especificar el ángulo de rotación
puedes girar la imagen en sentido horario o antihorario para lograr la
orientación deseada. Esta rotación ayuda a ajustar la presentación o
alineación de la imagen sin distorsionar su contenido.

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 en true el tamaño de su imagen cambiará según las proyecciones del rectángulo rotado (puntos de esquina) en otro caso, lo que deja las dimensiones sin cambios y solo internal el contenido de la imagen se rota.
background_color	Color	Color del fondo.

Method: rotate_flip(rotate_flip_type)

 rotate_flip(rotate_flip_type) 

Realizar rotación, volteo o ambos en el fotograma activo exclusivamente. Esta operación
aplica transformaciones únicamente al fotograma actualmente activo de la imagen,
preservando la integridad de los demás fotogramas en la secuencia.

Parameters:

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

See also:

Example # 1: This example loads a GIF image, rotates it by 90 degrees clockwise and option…

Method: rotate_flip_all(rotate_flip)

 rotate_flip_all(rotate_flip) 

Rota el volteo completo.

Parameters:

Parámetro	Tipo	Descripción
rotate_flip	RotateFlipType	El volteo de rotación.

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.

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.

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

Parameters:

Parámetro	Tipo	Descripción
rectangle	Rectangle	El rectángulo.
pixels	Color[]	Los píxeles.

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.

Method: set_frame_time(time)

 set_frame_time(time) 

Ajusta la duración de cada fotograma en milisegundos, asegurando una sincronización constante
a lo largo de la secuencia de imágenes. Este método establece uniformemente el tiempo de visualización para
cada fotograma, permitiendo un control preciso de la velocidad de animación.
Cambiar este valor restablecerá el retraso para todos los fotogramas.

Parameters:

Parámetro	Tipo	Descripción
tiempo	int	El tiempo de duración del fotograma en milisegundos.

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.

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 la instancia IImageMetadataFormat.

Parameters:

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

Returns

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

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 create a GIF image and save it to a file.

from aspose.imaging.fileformats.gif.blocks import GifFrameBlock
from aspose.imaging.fileformats.gif import GifImage 
from aspose.imaging.brushes import SolidBrush
from aspose.imaging import Graphics, Color


# Crear un bloque de fotograma GIF de 100x100 px.
with GifFrameBlock(100, 100) as firstBlock:
	# Rellenar todo el bloque de rojo.
	gr = Graphics(firstBlock)
	brush = SolidBrush(Color.red)
	gr.fill_rectangle(brush, firstBlock.bounds)

	with GifImage(firstBlock) as gifImage:
		gifImage.save("output.gif")

This example shows how to create a GIF image with a custom palette and save it to a file.

from aspose.imaging.fileformats.gif.blocks import GifFrameBlock
from aspose.imaging.fileformats.gif import GifImage 
from aspose.imaging.brushes import SolidBrush
from aspose.imaging import Graphics, Color, ColorPaletteHelper


# Crear un bloque de fotograma GIF de 100x100 px.
with GifFrameBlock(100, 100) as firstBlock:
	# Rellenar todo el bloque de rojo.
	gr = Graphics(firstBlock)
	brush = SolidBrush(Color.red)
	gr.fill_rectangle(brush, firstBlock.bounds)

	# Usar paleta de 4 bits para reducir el tamaño de la imagen. La calidad puede empeorar.
	palette = ColorPaletteHelper.create_4_bit()

	with GifImage(firstBlock, palette) as gifImage:
		gifImage.save("output.gif")

The following example shows how to compose an animated GIF image from individual GIF blocks.

from aspose.imaging.fileformats.gif.blocks import GifFrameBlock
from aspose.imaging.fileformats.gif import GifImage 
from aspose.imaging.brushes import SolidBrush
from aspose.imaging import Graphics, Color

# Cree una imagen GIF de 100 x 100 px.
# El primer bloque es completamente negro por defecto.
with GifFrameBlock(100, 100) as firstBlock:
	with GifImage(firstBlock) as gifImage:
		# El primer círculo es rojo
		brush1 = SolidBrush(Color.red)

		# El segundo círculo es negro
		brush2 = SolidBrush(Color.black)

		# Aumente gradualmente el ángulo de la forma de arco rojo.
		for angle in range(10, 361, 10):
			block = GifFrameBlock(100, 100)
			gr = Graphics(block)
			gr.fill_pie(brush1, block.bounds, 0, angle)
			gifImage.add_block(block)
		
		# Aumente gradualmente el ángulo del arco negro y elimine el arco rojo.
		for angle in range(10, 361, 10):
			block = GifFrameBlock(100, 100)
			gr = Graphics(block)
			gr.fill_pie(brush2, block.bounds, 0, angle)
			gr.fill_pie(brush1, block.bounds, angle, 360 - angle)
			gifImage.add_block(block)

		gifImage.save("animated_radar.gif")

The following example shows how to remove all blocks from a GIF image.

from aspose.imaging.fileformats.gif.blocks import GifFrameBlock
from aspose.imaging.fileformats.gif import GifImage 

# Cree una imagen GIF de 100 x 100 px.
# El primer bloque es completamente negro por defecto.
with GifFrameBlock(100, 100) as firstBlock:
	with GifImage(firstBlock) as gifImage:
		if gifImage.active_frame is not None:
			print(f"Active frame size: {gifImage.active_frame.size}")
		else:
			print("Active frame is not set")

		print("Clear all the blocks")
		gifImage.clear_blocks()

		if gifImage.active_frame is not None:
			print(f"Active frame size: {gifImage.active_frame.size}")
		else:
			print("Active frame is not set")

# La salida se ve así:
# Tamaño del fotograma activo: { Width = 100, Height = 100}
# Borrar todos los bloques
# El fotograma activo no está configurado

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

from os.path import join
import aspose.pycore as aspycore
from aspose.imaging import Image, RotateFlipType
from aspose.imaging.fileformats.gif import GifImage
from aspose.imaging.imageoptions import PngOptions

dir_: str = "c:\\temp"
rotate_flip_types = [RotateFlipType.ROTATE_90_FLIP_NONE, RotateFlipType.ROTATE_90_FLIP_X, RotateFlipType.ROTATE_90_FLIP_XY, RotateFlipType.ROTATE_90_FLIP_Y]
for rotate_flip_type in rotate_flip_types:
	# Rotar, voltear y guardar en el archivo de salida.
	with aspycore.as_of(Image.load(join(dir_, "sample.gif")), GifImage) as image:
		image.rotate_flip(rotate_flip_type)
		image.save(join(dir_, "sample." + rotate_flip_type + ".png"), PngOptions())

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

import aspose.pycore as aspycore
from aspose.imaging import Image, Rectangle
from aspose.imaging.imageoptions import PngOptions
from aspose.imaging.fileformats.gif import GifImage
from os.path import join

dir_: str = "c:\\temp"
with Image.load(join(dir_, "sample.gif")) as image:
	gif_image = aspycore.as_of(image, GifImage)
	# Recortar la imagen. El área de recorte es la zona rectangular central de la imagen.
	area = Rectangle(gif_image.width // 4, gif_image.height // 4, gif_image.width // 2,
					 gif_image.height // 2)
	gif_image.crop(area)
	# Guardar la imagen recortada en PNG
	gif_image.save(join(dir_, "sample.Crop.png"), PngOptions())

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

import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.gif import GifImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_: str = "c:\\temp"
with Image.load(join(dir_, "sample.gif")) as image:
	djvu_image = aspycore.as_of(image, GifImage)
	# 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.
	djvu_image.binarize_fixed(127)
	djvu_image.save(join(dir_, "sample.BinarizeFixed.png"), PngOptions())

The following example performs gamma-correction of a GIF image.

import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.gif import GifImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_: str = "c:\\temp\\"
with Image.load(join(dir_, "sample.gif")) as image:
	gif_image = aspycore.as_of(image, GifImage)
	# Establecer el coeficiente gamma para los canales rojo, verde y azul.
	gif_image.adjust_gamma(2.5)
	gif_image.save(join(dir_, "sample.AdjustGamma.png"), PngOptions())

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

import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.gif import GifImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_ = "c:\\temp"
with Image.load(join(dir_, "sample.gif")) as image:
	gif_image = aspycore.as_of(image, GifImage)
	# Establecer coeficientes gamma individuales para los canales rojo, verde y azul.
	gif_image.adjust_gamma(1.5, 2.5, 3.5)
	gif_image.save(join(dir_, "sample.AdjustGamma.png"), PngOptions())

The following example performs brightness correction of a GIF image.

import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.gif import GifImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_ = "c:\\temp"
with Image.load(join(dir_, "sample.gif")) as image:
	gif_image = aspycore.as_of(image, GifImage)
	# Establecer el valor de brillo. Los valores aceptados de brillo están en el rango [-255, 255].
	gif_image.adjust_brightness(50)
	gif_image.save(join(dir_, "sample.AdjustBrightness.png"), PngOptions())

The following example performs contrast correction of a GIF image.

import aspose.pycore as aspycore

from aspose.imaging import Image

from aspose.imaging.fileformats.gif import GifImage

from aspose.imaging.imageoptions import PngOptions

from os.path import join



dir_ = "c:\\temp"

with Image.load(join(dir_, "sample.gif")) as image:

	gif_image = aspycore.as_of(image, GifImage)

	# Establecer el valor de contraste. Los valores aceptados de contraste están en el rango [-100f, 100f].

	gif_image.adjust_contrast(50.0)

	gif_image.save(join(dir_, "sample.AdjustContrast.png"), PngOptions())



# ExEnd

Create multipage GIF image using single page raster images.

from aspose.imaging import Image, RasterImage
from aspose.pycore import as_of
from os import listdir
from os.path import isfile, join

def load_frames(directory):
	for f in listdir(directory):
		full_path = join(directory, f)
		if isfile(full_path):
			yield as_of(Image.load(file_path), RasterImage)


# Cargar fotogramas
frames = list(load_frames("Animation frames"))
# Crear imagen GIF usando el primer fotograma
with GifImage(GifFrameBlock(frames[0])) as image:
	# Agregar fotogramas a la imagen GIF usando el método AddPage
	for index in range(1, len(frames)):
		image.add_page(frames[index])

	# Guardar imagen GIF
	image.save("Multipage.gif")
	
for it in frames:
	with it as _:
		# Desechar las imágenes
		pass

Export of part of animation from GIF image based on time interval.

from aspose.imaging import Image
from aspose.imaging.imageoptions import GifOptions, MultiPageOptions, MultiPageMode, TimeInterval

with Image.load("Animation.gif") as image:
	obj_init = MultiPageOptions()
	obj_init.mode = MultiPageMode.TIME_INTERVAL
	obj_init.time_interval = TimeInterval(0, 400)
	options = GifOptions()
	options.full_frame = True
	options.multi_page_options = obj_init
	image.save("PartOfAnimation.gif", options)