Clase PngImage
Summary: Manipulate Portable Network Graphics (PNG) raster images with our versatile API,
featuring support for compression levels and various color depths including
Grayscale, Indexed Color, TrueColor, and alpha channels. Seamlessly process XMP metadata,
enabling comprehensive image metadata management, while easily loading PNG images,
performing diverse manipulations, applying filters, and converting images to other file
formats for optimal versatility and customization.
Module: aspose.imaging.fileformats.png
Full Name: aspose.imaging.fileformats.png.PngImage
Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, IRasterImageArgb32PixelLoader, IRasterImageRawDataLoader, RasterCachedImage
Constructors
| Name | Descripción |
|---|---|
| PngImage(path) | Construye una nueva instancia de la clase PngImage utilizando el parámetro path para especificar la ubicación del archivo de imagen a cargar. Este constructor permite a los desarrolladores crear imágenes PNG de forma cómoda cargándolas desde un archivo, simplificando el proceso de trabajo con imágenes PNG en sus aplicaciones. |
| PngImage(path, color_type) | Inicializa una nueva instancia de la clase PngImage especificando el path al archivo de imagen y el tipo de color. Este constructor permite una creación cómoda de imágenes PNG a partir de archivos con diferentes tipos de color, proporcionando flexibilidad en el manejo de varios formatos de imagen. |
| PngImage(png_options, width, height) | Inicializa una nueva instancia de la clase PngImage incorporando opciones PNG junto con los parámetros de ancho y alto. Este constructor permite a los desarrolladores crear imágenes PNG con configuraciones y dimensiones personalizables, ofreciendo flexibilidad en la generación de imágenes para diversos casos de uso. |
| PngImage(raster_image) | Crea una nueva instancia de la clase PngImage proporcionando una imagen raster como parámetro. Este constructor permite a los desarrolladores inicializar directamente un objeto de imagen PNG usando una imagen raster existente, agilizando el proceso de trabajo con imágenes PNG en sus aplicaciones. |
| PngImage(raster_image, color_type) | Crea una nueva instancia de la clase PngImage especificando una imagen raster y un tipo de color. Este constructor permite a los desarrolladores convertir directamente imágenes raster al formato PNG mientras se especifica el tipo de color deseado, ofreciendo flexibilidad en la representación de colores. |
| PngImage(stream) | Crea una nueva instancia de la clase PngImage inicializándola con un flujo. Este constructor permite a los desarrolladores cargar imágenes PNG directamente desde un flujo, proporcionando flexibilidad en la obtención de imágenes desde diferentes fuentes. |
| PngImage(width, height) | Inicializa un nuevo objeto de la clase PngImage proporcionando los parámetros de ancho y alto. Este constructor simplifica la creación de imágenes PNG al permitir a los desarrolladores especificar las dimensiones directamente, facilitando la gestión eficiente de los datos de imágenes PNG dentro de sus aplicaciones. |
| PngImage(width, height, color_type) | Instancia una nueva instancia de la clase PngImage especificando los parámetros deseados de ancho, alto y tipo de color. Este constructor permite una creación rápida de imágenes PNG con dimensiones y configuraciones de color adaptadas, facilitando una generación de imágenes optimizada para diversas aplicaciones y flujos de trabajo. |
Properties
| Name | Type | Access | Descripción |
|---|---|---|---|
| auto_adjust_palette | bool | r/w | Obtiene o establece un valor que indica si se ajusta automáticamente la paleta. |
| background_color | Color | r/w | Obtiene el color de fondo de la imagen, si se ha especificado uno. Esta propiedad es útil para aplicaciones que necesitan identificar y potencialmente manipular el color de fondo de una imagen. |
| bits_per_pixel | int | r | Recupera el valor de bits por píxel de la imagen. Esta propiedad brinda información crucial sobre la profundidad de color de la imagen, permitiendo a los desarrolladores comprender el nivel de detalle y precisión de color presente en los datos 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 | Obtiene el formato del archivo asociado a la instancia de la imagen. Esta propiedad proporciona información esencial sobre el tipo de archivo, permitiendo un manejo y procesamiento eficientes basados en los requisitos específicos del formato. |
| has_alpha | bool | r | Devuelve un valor booleano que indica si la imagen tiene un canal alfa, lo que determina su transparencia. Esta propiedad es útil para aplicaciones que necesitan manejar la transparencia, permitiendo a los desarrolladores determinar si se requiere procesamiento adicional para gestionar áreas transparentes en la imagen. |
| has_background_color | bool | r/w | Obtiene un valor booleano que indica si la imagen tiene un color de fondo. Esta propiedad es útil para aplicaciones que necesitan determinar si una imagen incluye un color de fondo, lo cual puede ser importante para diversas tareas de procesamiento como composición, renderizado o exportación. |
| has_transparent_color | bool | r/w | Proporciona un valor booleano que indica si la imagen contiene un color transparente . Esta propiedad es crucial para aplicaciones que necesitan manejar la transparencia, permitiendo a los desarrolladores determinar si se requiere procesamiento adicional para gestionar regiones transparentes en la imagen. |
| height | int | r | Obtenga la altura de la imagen. Esta propiedad devuelve la dimensión vertical de la imagen, permitiendo a los desarrolladores determinar su tamaño en píxeles a lo largo del eje vertical. |
| horizontal_resolution | float | r/w | Recupere o modifique la resolución horizontal de la imagen. Esta propiedad representa el número de píxeles por pulgada a lo largo del eje horizontal de la imagen. Ajustar esta resolución puede afectar el tamaño físico de la imagen al imprimirse o mostrarse. |
| image_opacity | float | r | Obtiene la opacidad de esta imagen. |
| interlaced | bool | r | Obtiene un valor booleano que indica si el PngImage está entrelazado, lo que determina si los datos de la imagen se almacenan de forma progresiva para una carga o transmisión más rápida. |
| 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 | Devuelve un valor booleano que indica si la instancia de la imagen está entrelazada. Esta propiedad es crucial para optimizar las estrategias de carga y garantizar un rendimiento eficiente durante el procesamiento o la visualización de imágenes. |
| is_raw_data_available | bool | r | Obtiene un valor que indica si se admite la carga de datos sin procesar. |
| metadata | ImageMetadata | r | Obtiene los metadatos de la imagen. |
| palette | IColorPalette | r/w | Obtiene o establece la paleta de colores. La paleta de colores no se usa cuando los píxeles se representan directamente. |
| premultiply_components | bool | r/w | Obtiene o establece un valor que indica si los componentes de la imagen deben ser premultiplicados. |
| raw_custom_color_converter | IColorConverter | r/w | Obtiene o establece el convertidor de color personalizado |
| raw_data_format | PixelDataFormat | r | Accede al formato de datos sin procesar de la imagen. Esta propiedad brinda información sobre cómo se estructuran internamente los datos de la imagen, lo que puede ser útil para tareas avanzadas de procesamiento de imágenes o conversión de formatos. |
| 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 | Obtiene el color transparente de la imagen, si existe. Esta propiedad es valiosa para aplicaciones que requieren un manejo preciso de áreas transparentes dentro de las imágenes, permitiendo a los desarrolladores acceder y manipular el color transparente específico utilizado. |
| 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 | Proporciona acceso a la resolución vertical de la imagen. Los desarrolladores pueden usar esta propiedad para obtener o modificar la configuración de resolución, que indica el número de píxeles por pulgada (PPI) a lo largo del eje vertical de la imagen. |
| width | int | r | Permite obtener el ancho de la imagen, proporcionando información esencial sobre sus dimensiones. Esta propiedad es frecuentemente utilizada por los desarrolladores para determinar el ancho de la imagen, permitiéndoles realizar diversas operaciones basadas en su tamaño. |
| xmp_data | XmpPacketWrapper | r/w | Obtiene o establece los datos Xmp. |
Methods
| Name | Descripción |
|---|---|
| adjust_brightness(brightness) | Ajuste de brillo para la imagen. |
| adjust_contrast(contrast) | Contraste de imagen |
| adjust_gamma(gamma) | Corrección gamma de una imagen. |
| adjust_gamma(gamma_red, gamma_green, gamma_blue) | Corrección gamma de una imagen. |
| analyze_percentage_digital_signature(password) | Calcula el porcentaje de similitud entre los datos extraídos y la contraseña original. |
| auto_brightness_contrast() | 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) | Binarización de una imagen usando el algoritmo de umbral adaptativo de Bradley mediante el umbralado de imagen integral |
| binarize_bradley(brightness_difference, window_size) | Binarización de una imagen usando el algoritmo de umbral adaptativo de Bradley mediante el umbralado de imagen integral |
| binarize_fixed(threshold) | Binarización de una imagen con umbral predefinido |
| binarize_otsu() | Binarización de una imagen con umbral de Otsu |
| blend(origin, overlay, overlay_alpha) | Mezcla esta instancia de imagen con la imagen overlay. |
| blend(origin, overlay, overlay_area, overlay_alpha) | Mezcla esta instancia de imagen con la imagen overlay. |
| cache_data() | Almacena en caché los datos y garantiza que no se realizará una carga adicional de datos desde el DataStreamSupporter.data_stream_container subyacente. |
| can_load(file_path) | Determina si la imagen puede cargarse desde la ruta de archivo especificada. |
| can_load(file_path, load_options) | Determina si la imagen puede cargarse desde la ruta de archivo especificada y, opcionalmente, usando las opciones de apertura especificadas. |
| can_load(stream) | Determina si la imagen puede cargarse desde el flujo especificado. |
| can_load(stream, load_options) | Determina si la imagen puede cargarse desde el flujo especificado y, opcionalmente, usando los loadOptions especificados. |
| can_load_stream(stream) | Determina si la imagen puede cargarse desde el flujo especificado. |
| can_load_stream_with_options(stream, load_options) | Determina si la imagen puede cargarse desde el flujo especificado y, opcionalmente, usando los loadOptions especificados. |
| can_load_with_options(file_path, load_options) | Determina si la imagen puede cargarse desde la ruta de archivo especificada y, opcionalmente, usando las opciones de apertura especificadas. |
| can_save(options) | Determina si la imagen puede guardarse en el formato de archivo especificado representado por las opciones de guardado proporcionadas. |
| create(files) | Crea la imagen multipágina que contiene los archivos especificados. |
| create(files, throw_exception_on_load_error) | Crea la imagen multipágina que contiene los archivos especificados. |
| create(image_options, width, height) | Crea una nueva imagen usando las opciones de creación especificadas. |
| create(image_options, width, height, pixels) | Crea una instancia de RasterImage a partir del arreglo de píxeles proporcionado. Valida que el ancho y alto especificados coincidan con las dimensiones de los datos de píxeles. Este método solo puede usarse cuando la biblioteca está en modo Licenciado. |
| create(images) | Crea una nueva imagen usando las imágenes especificadas como páginas |
| create(images, dispose_images) | Crea una nueva imagen con las imágenes especificadas como páginas. |
| create(multipage_create_options) | Crea las opciones de creación multipágina especificadas. |
| create_from_file_with_color_type(path, color_type) | Inicializa una nueva instancia de la clase PngImage. |
| 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_image(raster_image) | Inicializa una nueva instancia de la clase PngImage. |
| create_from_image_with_color_type(raster_image, color_type) | Inicializa una nueva instancia de la clase PngImage. |
| create_from_images(images) | Crea una nueva imagen usando las imágenes especificadas como páginas |
| create_from_images(images, dispose_images) | Crea una nueva imagen con las imágenes especificadas como páginas. |
| create_from_stream(stream) | Inicializa una nueva instancia de la clase PngImage. |
| create_with_width_height(width, height) | Inicializa una nueva instancia de la clase PngImage. |
| create_with_width_height_color_type(width, height, color_type) | Inicializa una nueva instancia de la clase PngImage. |
| create_with_width_height_options(png_options, width, height) | Inicializa una nueva instancia de la clase PngImage. |
| crop(left_shift, right_shift, top_shift, bottom_shift) | Recortar la imagen con desplazamientos. |
| crop(rectangle) | Recortando la imagen. |
| dither(dithering_method, bits_count) | Aplica dithering a la imagen actual. |
| dither(dithering_method, bits_count, custom_palette) | Aplica dithering a la imagen actual. |
| embed_digital_signature(password) | Incrustar una firma digital basada en la contraseña proporcionada en la imagen usando esteganografía. |
| filter(rectangle, options) | Filtra el rectángulo especificado. |
| get_argb_32_pixel(x, y) | Obtiene un píxel ARGB de 32 bits de la imagen. |
| get_default_argb_32_pixels(rectangle) | Obtiene la matriz predeterminada de píxeles ARGB de 32 bits. |
| get_default_options(args) | Obtiene las opciones predeterminadas. |
| get_default_pixels(rectangle, partial_pixel_loader) | Obtiene la matriz predeterminada de píxeles usando el cargador parcial de píxeles. |
| get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings) | Obtiene la matriz de datos sin procesar predeterminada usando el cargador parcial de píxeles. |
| get_default_raw_data(rectangle, raw_data_settings) | Obtiene la matriz de datos sin procesar predeterminada. |
| get_file_format(file_path) | Obtiene el formato de archivo. |
| get_file_format(stream) | Obtiene el formato de archivo. |
| get_file_format_of_stream(stream) | Obtiene el formato de archivo. |
| get_fitting_rectangle(rectangle, pixels, width, height) | Obtiene el rectángulo que se ajusta a la imagen actual. |
| get_fitting_rectangle(rectangle, width, height) | Obtiene el rectángulo que se ajusta a la imagen actual. |
| get_modify_date(use_default) | Obtiene la marca de tiempo que indica la modificación más reciente del recurso de la imagen. Este método brinda acceso a metadatos vitales, permitiendo a las aplicaciones determinar cuándo se modificó por última vez la imagen, facilitando el seguimiento de versiones y la gestión de contenido. |
| get_original_options() | Obtiene las opciones basadas en la configuración original del archivo. Esto puede ser útil para mantener la profundidad de bits y otros parámetros de la imagen original sin cambios. Por ejemplo, si cargamos una imagen PNG en blanco y negro con 1 bit por píxel y luego la guardamos usando el método DataStreamSupporter.save(file_path), se producirá una imagen PNG de salida con 8 bits por píxel. Para evitarlo y guardar la imagen PNG con 1 bit por píxel, use este método para obtener las opciones de guardado correspondientes y páselas al método Image.save(file_path, options) como segundo parámetro. |
| get_pixel(x, y) | Obtiene un píxel de la imagen. |
| get_proportional_height(width, height, new_width) | Obtiene una altura proporcional. |
| get_proportional_width(width, height, new_height) | Obtiene un ancho proporcional. |
| get_serialized_stream(image_options, clipping_rectangle, page_number) | Convierte a aps. |
| get_skew_angle() | Obtiene el ángulo de sesgo. Este método es aplicable a documentos de texto escaneados, para determinar el ángulo de sesgo al escanear. |
| grayscale() | Transformación de una imagen a su representación en escala de grises |
| is_digital_signed(password, percentage_threshold) | Realiza una verificación rápida para determinar si la imagen está firmada digitalmente, usando la contraseña proporcionada y el umbral. |
| load(file_path) | Carga una nueva imagen desde la ruta de archivo o URL especificada. Si filePath es una ruta de archivo, el método simplemente abre el archivo. Si filePath es una URL, el método descarga el archivo, lo almacena como uno temporal y lo abre. |
| load(file_path, load_options) | Carga una nueva imagen desde la ruta de archivo o URL especificada. Si filePath es una ruta de archivo, el método simplemente abre el archivo. Si filePath es una URL, el método descarga el archivo, lo almacena como uno temporal y lo abre. |
| load(stream) | Carga una nueva imagen desde el flujo especificado. |
| load(stream, load_options) | Carga una nueva imagen desde el flujo especificado. |
| load_argb_32_pixels(rectangle) | Carga píxeles ARGB de 32 bits. |
| load_argb_64_pixels(rectangle) | Carga píxeles ARGB de 64 bits. |
| load_cmyk_32_pixels(rectangle) | Carga píxeles en formato CMYK. |
| load_cmyk_pixels(rectangle) | Carga píxeles en formato CMYK. Este método está obsoleto. Por favor, use de manera más eficaz el método RasterImage.load_cmyk_32_pixels(rectangle). |
| load_partial_argb_32_pixels(rectangle, partial_pixel_loader) | Carga 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 inclinación del escaneo. Este método usa los métodos RasterImage.get_skew_angle() y RasterImage.rotate(angle, resize_proportionally, background_color). |
| normalize_histogram() | Normaliza el histograma de la imagen — ajusta los valores de píxeles para usar todo el rango disponible. |
| read_argb_32_scan_line(scan_line_index) | Lee toda la línea de escaneo según el índice de línea de escaneo especificado. |
| read_scan_line(scan_line_index) | Lee toda la línea de escaneo según el índice de línea de escaneo especificado. |
| remove_metadata() | Elimina los metadatos de esta instancia de imagen estableciendo el valor de IHasXmpData.xmp_data a None. |
| replace_argb(old_color_argb, old_color_diff, new_color_argb) | Reemplaza un color por otro con diferencia permitida y preserva el valor alfa original para mantener bordes suaves. |
| replace_color(old_color, old_color_diff, new_color) | Reemplaza un color por otro con diferencia permitida y preserva el valor alfa original para mantener bordes suaves. |
| replace_color(old_color_argb, old_color_diff, new_color_argb) | Reemplaza un color por otro con diferencia permitida y preserva el valor alfa original para mantener bordes suaves. |
| replace_non_transparent_colors(new_color) | Reemplaza todos los colores no transparentes por un nuevo color y conserva el valor alfa original para mantener bordes suaves. Nota: si lo usas en imágenes sin transparencia, todos los colores serán reemplazados por uno solo. |
| replace_non_transparent_colors(new_color_argb) | Reemplaza todos los colores no transparentes por un nuevo color y conserva el valor alfa original para mantener bordes suaves. Nota: si lo usas en imágenes sin transparencia, todos los colores serán reemplazados por uno solo. |
| resize(new_width, new_height) | Redimensiona la imagen. Se utiliza el valor predeterminado ResizeType.NEAREST_NEIGHBOUR_RESAMPLE. |
| resize(new_width, new_height, resize_type) | Redimensiona la imagen. |
| resize(new_width, new_height, settings) | Redimensiona la imagen. |
| resize_by_settings(new_width, new_height, settings) | Redimensiona la imagen. |
| resize_by_type(new_width, new_height, resize_type) | Redimensiona la imagen. |
| resize_height_proportionally(new_height) | Redimensiona la altura proporcionalmente. Se utiliza el valor predeterminado ResizeType.NEAREST_NEIGHBOUR_RESAMPLE. |
| resize_height_proportionally(new_height, resize_type) | Redimensiona la altura proporcionalmente. |
| resize_height_proportionally(new_height, settings) | Redimensiona la altura proporcionalmente. |
| resize_height_proportionally_settings(new_height, settings) | Redimensiona la altura proporcionalmente. |
| resize_width_proportionally(new_width) | Redimensiona el ancho proporcionalmente. Se utiliza el valor predeterminado ResizeType.NEAREST_NEIGHBOUR_RESAMPLE. |
| resize_width_proportionally(new_width, resize_type) | Redimensiona el ancho proporcionalmente. |
| resize_width_proportionally(new_width, settings) | Redimensiona el ancho proporcionalmente. |
| resize_width_proportionally_settings(new_width, settings) | Redimensiona el ancho proporcionalmente. |
| rotate(angle) | Rotar la imagen alrededor del centro. |
| rotate(angle, resize_proportionally, background_color) | Rotar la imagen alrededor del centro. |
| rotate_flip(rotate_flip_type) | Rota, voltea o rota y voltea la imagen. |
| save() | Guarda los datos de la imagen en el flujo subyacente. |
| save(file_path) | Guarda la imagen en la ubicación de archivo especificada. |
| save(file_path, options) | Guarda los datos del objeto en la ubicación de archivo especificada en el formato de archivo indicado según las opciones de guardado. |
| save(file_path, options, bounds_rectangle) | Guarda los datos del objeto en la ubicación de archivo especificada en el formato de archivo indicado según las opciones de guardado. |
| save(file_path, over_write) | Guarda los datos del objeto en la ubicación de archivo especificada. |
| save(stream) | Los datos guardados. |
| 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 píxeles (método específico de formato). |
| save_raw_data(data, data_offset, rectangle, raw_data_settings) | Guarda los datos sin procesar. |
| save_to_stream(stream) | Guarda los datos del objeto en el flujo especificado. |
| save_to_stream_with_options(stream, options_base) | Guarda los datos de la imagen en el flujo especificado en el formato de archivo indicado según las opciones de guardado. |
| save_to_stream_with_options_rect(stream, options_base, bounds_rectangle) | Guarda los datos de la imagen en el flujo especificado en el formato de archivo indicado según las opciones de guardado. |
| save_with_options(file_path, options) | Guarda los datos del objeto en la ubicación de archivo especificada en el formato de archivo indicado según las opciones de guardado. |
| save_with_options_rect(file_path, options, bounds_rectangle) | Guarda los datos del objeto en la ubicación de archivo especificada en el formato de archivo indicado según las opciones de guardado. |
| set_argb_32_pixel(x, y, argb_32_color) | Establece un píxel ARGB de 32 bits de la imagen para la posición especificada. |
| set_palette(palette, update_colors) | Establece la paleta de la imagen. |
| set_pixel(x, y, color) | Establece un píxel de la imagen para la posición especificada. |
| set_resolution(dpi_x, dpi_y) | Establece la resolución para este RasterImage. |
| try_set_metadata(metadata) | Intenta establecer una instancia de metadata, si esta instancia de Image admite e implementa 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: PngImage(path)
PngImage(path)
Construye una nueva instancia de la clase PngImage utilizando el parámetro path
para especificar la ubicación del archivo de imagen a cargar. Este constructor
permite a los desarrolladores crear imágenes PNG de forma cómoda cargándolas desde un archivo,
simplificando el proceso de trabajo con imágenes PNG en sus aplicaciones.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| ruta | string | La ruta para cargar una imagen. |
See also:
Example # 1: This example shows how to load a PNG image from a file.
Constructor: PngImage(path, color_type)
PngImage(path, color_type)
Inicializa una nueva instancia de la clase PngImage especificando el
path al archivo de imagen y el tipo de color. Este constructor permite una creación
cómoda de imágenes PNG a partir de archivos con diferentes tipos de color, proporcionando
flexibilidad en el manejo de varios formatos de imagen.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| ruta | string | La ruta para cargar una imagen. |
| color_type | PngColorType | El tipo de color. |
See also:
Example # 1: This example shows how to load a PNG image from a file with the specified col…
Constructor: PngImage(png_options, width, height)
PngImage(png_options, width, height)
Inicializa una nueva instancia de la clase PngImage incorporando
opciones PNG junto con los parámetros de ancho y alto. Este constructor permite
a los desarrolladores crear imágenes PNG con configuraciones y dimensiones personalizables,
ofreciendo flexibilidad en la generación de imágenes para diversos casos de uso.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| png_options | PngOptions | Las opciones de PNG. |
| width | int | El ancho. |
| height | int | La altura. |
Constructor: PngImage(raster_image)
PngImage(raster_image)
Crea una nueva instancia de la clase PngImage proporcionando una imagen raster
como parámetro. Este constructor permite a los desarrolladores inicializar directamente un
objeto de imagen PNG usando una imagen raster existente, agilizando el proceso de
trabajo con imágenes PNG en sus aplicaciones.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| raster_image | RasterImage | La imagen raster. |
See also:
Example # 1: This example shows how to load PNG image from a BMP image.
Constructor: PngImage(raster_image, color_type)
PngImage(raster_image, color_type)
Crea una nueva instancia de la clase PngImage especificando una
imagen raster y un tipo de color. Este constructor permite a los desarrolladores convertir directamente
imágenes raster al formato PNG mientras se especifica el tipo de color deseado,
ofreciendo flexibilidad en la representación de colores.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| raster_image | RasterImage | La imagen raster. |
| color_type | PngColorType | El tipo de color. |
See also:
Example # 1: This example shows how to load PNG image from a BMP image with the specified …
Constructor: PngImage(stream)
PngImage(stream)
Crea una nueva instancia de la clase PngImage inicializándola
con un flujo. Este constructor permite a los desarrolladores cargar imágenes PNG directamente
desde un flujo, proporcionando flexibilidad en la obtención de imágenes desde diferentes fuentes.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| flujo | _io.BufferedRandom | El flujo para cargar una imagen. |
See also:
Example # 1: This example shows how to load a PNG image from a file or a file stream.
Constructor: PngImage(width, height)
PngImage(width, height)
Inicializa un nuevo objeto de la clase PngImage proporcionando los parámetros de
ancho y alto. Este constructor simplifica la creación de imágenes PNG al permitir a los desarrolladores especificar las dimensiones directamente, facilitando
la gestión eficiente de los datos de imágenes PNG dentro de sus aplicaciones.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| width | int | El ancho. |
| height | int | La altura. |
See also:
Example # 1: This example shows how to create a PNG image of the specified size, fill it w…
Constructor: PngImage(width, height, color_type)
PngImage(width, height, color_type)
Instancia una nueva instancia de la clase PngImage especificando
los parámetros deseados de ancho, alto y tipo de color. Este constructor permite
una creación rápida de imágenes PNG con dimensiones y configuraciones de color adaptadas,
facilitando una generación de imágenes optimizada para diversas aplicaciones y flujos de trabajo.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| width | int | El ancho. |
| height | int | La altura. |
| color_type | PngColorType | El tipo de color. |
See also:
Example # 1: This example shows how to create a PNG image of the specified size with the s…
Property: has_alpha
Devuelve un valor booleano que indica si la imagen tiene un canal alfa,
lo que determina su transparencia. Esta propiedad es útil para aplicaciones
que necesitan manejar la transparencia, permitiendo a los desarrolladores determinar si
se requiere procesamiento adicional para gestionar áreas transparentes en la imagen.
See also:
Example # 1: The following example shows how to check if a PNG image supports alpha-channel.
Method: adjust_brightness(brightness)
adjust_brightness(brightness)
Ajuste de brillo para la imagen.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| brillo | int | Valor de brillo. |
Method: adjust_contrast(contrast)
adjust_contrast(contrast)
Contraste de imagen
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| contraste | float | Valor de contraste (en el rango [-100; 100]) |
Method: adjust_gamma(gamma)
adjust_gamma(gamma)
Corrección gamma de una imagen.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| gamma | float | Coeficiente gamma para los canales rojo, verde y azul |
Method: adjust_gamma(gamma_red, gamma_green, gamma_blue)
adjust_gamma(gamma_red, gamma_green, gamma_blue)
Corrección gamma de una imagen.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| gamma_red | float | Coeficiente gamma para el canal rojo |
| gamma_green | float | Coeficiente gamma para el canal verde |
| gamma_blue | float | Gamma para el coeficiente del canal azul |
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)
Binarización de una imagen usando el algoritmo de umbral adaptativo de Bradley mediante el umbralado de imagen integral
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| brightness_difference | float | La diferencia de brillo entre el píxel y el promedio de una ventana de s x s píxeles centrada en este píxel. |
Method: binarize_bradley(brightness_difference, window_size)
binarize_bradley(brightness_difference, window_size)
Binarización de una imagen usando el algoritmo de umbral adaptativo de Bradley mediante el umbralado de imagen integral
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| brightness_difference | float | La diferencia de brillo entre el píxel y el promedio de una ventana de s x s píxeles centrada en este píxel. |
| window_size | int | El tamaño de la ventana de píxeles de s x s centrada alrededor de este píxel |
Method: binarize_fixed(threshold)
binarize_fixed(threshold)
Binarización de una imagen con umbral predefinido
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| umbral | System.Byte | Valor de umbral. Si el valor gris correspondiente de un píxel es mayor que el umbral, se le asignará un valor de 255, de lo contrario 0. |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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_file_with_color_type(path, color_type) [static]
create_from_file_with_color_type(path, color_type)
Inicializa una nueva instancia de la clase PngImage.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| ruta | string | La ruta para cargar una imagen. |
| color_type | PngColorType | El tipo de color. |
Returns
| Tipo | Descripción |
|---|---|
| PngImage |
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 |
Returns
| Tipo | Descripción |
|---|---|
| Image | La imagen multipágina |
Method: create_from_image(raster_image) [static]
create_from_image(raster_image)
Inicializa una nueva instancia de la clase PngImage.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| raster_image | RasterImage | La imagen raster. |
Returns
| Tipo | Descripción |
|---|---|
| PngImage |
Method: create_from_image_with_color_type(raster_image, color_type) [static]
create_from_image_with_color_type(raster_image, color_type)
Inicializa una nueva instancia de la clase PngImage.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| raster_image | RasterImage | La imagen raster. |
| color_type | PngColorType | El tipo de color. |
Returns
| Tipo | Descripción |
|---|---|
| PngImage |
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 |
Returns
| Tipo | Descripción |
|---|---|
| Image | La Imagen como IMultipageImage |
Method: create_from_stream(stream) [static]
create_from_stream(stream)
Inicializa una nueva instancia de la clase PngImage.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| flujo | _io.BufferedRandom | El flujo para cargar una imagen. |
Returns
| Tipo | Descripción |
|---|---|
| PngImage |
Method: create_with_width_height(width, height) [static]
create_with_width_height(width, height)
Inicializa una nueva instancia de la clase PngImage.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| width | int | El ancho. |
| height | int | La altura. |
Returns
| Tipo | Descripción |
|---|---|
| PngImage |
Method: create_with_width_height_color_type(width, height, color_type) [static]
create_with_width_height_color_type(width, height, color_type)
Inicializa una nueva instancia de la clase PngImage.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| width | int | El ancho. |
| height | int | La altura. |
| color_type | PngColorType | El tipo de color. |
Returns
| Tipo | Descripción |
|---|---|
| PngImage |
Method: create_with_width_height_options(png_options, width, height) [static]
create_with_width_height_options(png_options, width, height)
Inicializa una nueva instancia de la clase PngImage.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| png_options | PngOptions | Las opciones de PNG. |
| width | int | El ancho. |
| height | int | La altura. |
Returns
| Tipo | Descripción |
|---|---|
| PngImage |
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)
Recortando la imagen.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| rectangle | Rectangle | El rectángulo. |
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)
Aplica dithering a la imagen actual.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| dithering_method | DitheringMethod | El método de tramado. |
| bits_count | int | El recuento final de bits para el tramado. |
| custom_palette | IColorPalette | La paleta personalizada para el tramado. |
Method: embed_digital_signature(password)
embed_digital_signature(password)
Incrustar una firma digital basada en la contraseña proporcionada en la imagen usando esteganografía.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| password | string | La contraseña utilizada para generar datos de firma digital. |
Method: filter(rectangle, options)
filter(rectangle, options)
Filtra el rectángulo especificado.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| rectangle | Rectangle | El rectángulo. |
| options | FilterOptionsBase | Las opciones. |
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 marca de tiempo que indica la modificación más reciente del recurso
de la imagen. Este método brinda acceso a metadatos vitales, permitiendo a las aplicaciones
determinar cuándo se modificó por última vez la imagen, facilitando el seguimiento de versiones y
la gestión de contenido.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| use_default | bool | si se establece en |
Returns
| Tipo | Descripción |
|---|---|
| System.DateTime | La fecha y hora en que la imagen del recurso fue modificada por última vez. |
Method: get_original_options()
get_original_options()
Obtiene las opciones basadas en la configuración original del archivo.
Esto puede ser útil para mantener la profundidad de bits y otros parámetros de la imagen original sin cambios.
Por ejemplo, si cargamos una imagen PNG en blanco y negro con 1 bit por píxel y luego la guardamos usando el
método DataStreamSupporter.save(file_path), se producirá una imagen PNG de salida con 8 bits por píxel.
Para evitarlo y guardar la imagen PNG con 1 bit por píxel, use este método para obtener las opciones de guardado correspondientes y páselas
al método Image.save(file_path, options) como segundo parámetro.
Returns
| Tipo | Descripción |
|---|---|
| ImageOptionsBase | Las opciones basadas en la configuración original del archivo. |
Method: get_pixel(x, y)
get_pixel(x, y)
Obtiene un píxel de la imagen.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| x | int | La ubicación x del píxel. |
| y | int | La ubicación y del píxel. |
Returns
| Tipo | Descripción |
|---|---|
| Color | El color del píxel para la ubicación especificada. |
Method: get_proportional_height(width, height, new_width) [static]
get_proportional_height(width, height, new_width)
Obtiene una altura proporcional.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| width | int | El ancho. |
| height | int | La altura. |
| new_width | int | El nuevo ancho. |
Returns
| Tipo | Descripción |
|---|---|
| int | La altura proporcional. |
Method: get_proportional_width(width, height, new_height) [static]
get_proportional_width(width, height, new_height)
Obtiene un ancho proporcional.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| width | int | El ancho. |
| height | int | La altura. |
| new_height | int | La nueva altura. |
Returns
| Tipo | Descripción |
|---|---|
| int | El ancho proporcional. |
Method: get_serialized_stream(image_options, clipping_rectangle, page_number)
get_serialized_stream(image_options, clipping_rectangle, page_number)
Convierte a aps.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| image_options | ImageOptionsBase | Las opciones de la imagen. |
| clipping_rectangle | Rectangle | El rectángulo de recorte. |
| page_number | int[] | El número de página. |
Returns
| Tipo | Descripción |
|---|---|
| _io.BufferedRandom | El flujo serializado |
Method: get_skew_angle()
get_skew_angle()
Obtiene el ángulo de sesgo.
Este método es aplicable a documentos de texto escaneados, para determinar el ángulo de sesgo al escanear.
Returns
| Tipo | Descripción |
|---|---|
| float | El ángulo de sesgo, en grados. |
Method: is_digital_signed(password, percentage_threshold)
is_digital_signed(password, percentage_threshold)
Realiza una verificación rápida para determinar si la imagen está firmada digitalmente, usando la contraseña proporcionada y el umbral.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| password | string | La contraseña para verificar la firma. |
| percentage_threshold | int | El umbral (en porcentaje)[0-100] que determina si la imagen se considera firmada. Si no se especifica, se aplicará un umbral predeterminado ( |
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 inclinación del escaneo.
Este método usa los métodos RasterImage.get_skew_angle() y RasterImage.rotate(angle, resize_proportionally, background_color).
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| resize_proportionally | bool | si se establece a |
| 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: replace_argb(old_color_argb, old_color_diff, new_color_argb)
replace_argb(old_color_argb, old_color_diff, new_color_argb)
Reemplaza un color por otro con diferencia permitida y preserva el valor alfa original para mantener bordes suaves.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| old_color_argb | int | Valor ARGB del color antiguo a reemplazar. |
| old_color_diff | System.Byte | Diferencia permitida en el color antiguo para poder ampliar el tono del color reemplazado. |
| new_color_argb | int | Nuevo valor ARGB de color para reemplazar el color antiguo. |
Method: replace_color(old_color, old_color_diff, new_color)
replace_color(old_color, old_color_diff, new_color)
Reemplaza un color por otro con diferencia permitida y preserva el valor alfa original para mantener bordes suaves.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| old_color | Color | Color antiguo a ser reemplazado. |
| old_color_diff | System.Byte | Diferencia permitida en el color antiguo para poder ampliar el tono del color reemplazado. |
| new_color | Color | Nuevo color con el que reemplazar el color antiguo. |
Method: replace_color(old_color_argb, old_color_diff, new_color_argb)
replace_color(old_color_argb, old_color_diff, new_color_argb)
Reemplaza un color por otro con diferencia permitida y preserva el valor alfa original para mantener bordes suaves.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| old_color_argb | int | Valor ARGB del color antiguo a reemplazar. |
| old_color_diff | System.Byte | Diferencia permitida en el color antiguo para poder ampliar el tono del color reemplazado. |
| new_color_argb | int | Nuevo valor ARGB de color para reemplazar el color antiguo. |
Method: replace_non_transparent_colors(new_color)
replace_non_transparent_colors(new_color)
Reemplaza todos los colores no transparentes por un nuevo color y conserva el valor alfa original para mantener bordes suaves.
Nota: si lo usas en imágenes sin transparencia, todos los colores serán reemplazados por uno solo.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| new_color | Color | Nuevo color con el que reemplazar los colores no transparentes. |
Method: replace_non_transparent_colors(new_color_argb)
replace_non_transparent_colors(new_color_argb)
Reemplaza todos los colores no transparentes por un nuevo color y conserva el valor alfa original para mantener bordes suaves.
Nota: si lo usas en imágenes sin transparencia, todos los colores serán reemplazados por uno solo.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| new_color_argb | int | Nuevo valor ARGB de color para reemplazar colores no transparentes. |
Method: resize(new_width, new_height)
resize(new_width, new_height)
Redimensiona la imagen. Se utiliza el valor predeterminado ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| new_width | int | El nuevo ancho. |
| new_height | int | La nueva altura. |
Method: resize(new_width, new_height, resize_type)
resize(new_width, new_height, resize_type)
Redimensiona la imagen.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| new_width | int | El nuevo ancho. |
| new_height | int | La nueva altura. |
| resize_type | ResizeType | El tipo de redimensionamiento. |
Method: resize(new_width, new_height, settings)
resize(new_width, new_height, settings)
Redimensiona la imagen.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| new_width | int | El nuevo ancho. |
| new_height | int | La nueva altura. |
| settings | ImageResizeSettings | Los ajustes de redimensionamiento. |
Method: resize_by_settings(new_width, new_height, settings)
resize_by_settings(new_width, new_height, settings)
Redimensiona la imagen.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| new_width | int | El nuevo ancho. |
| new_height | int | La nueva altura. |
| settings | ImageResizeSettings | Los ajustes de redimensionamiento. |
Method: resize_by_type(new_width, new_height, resize_type)
resize_by_type(new_width, new_height, resize_type)
Redimensiona la imagen.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| new_width | int | El nuevo ancho. |
| new_height | int | La nueva altura. |
| resize_type | ResizeType | El tipo de redimensionamiento. |
Method: resize_height_proportionally(new_height)
resize_height_proportionally(new_height)
Redimensiona la altura proporcionalmente. Se utiliza el valor predeterminado ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| new_height | int | La nueva altura. |
Method: resize_height_proportionally(new_height, resize_type)
resize_height_proportionally(new_height, resize_type)
Redimensiona la altura proporcionalmente.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| new_height | int | La nueva altura. |
| resize_type | ResizeType | Tipo de redimensionamiento. |
Method: resize_height_proportionally(new_height, settings)
resize_height_proportionally(new_height, settings)
Redimensiona la altura proporcionalmente.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| new_height | int | La nueva altura. |
| settings | ImageResizeSettings | Los ajustes de redimensionamiento de la imagen. |
Method: resize_height_proportionally_settings(new_height, settings)
resize_height_proportionally_settings(new_height, settings)
Redimensiona la altura proporcionalmente.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| new_height | int | La nueva altura. |
| settings | ImageResizeSettings | Los ajustes de redimensionamiento de la imagen. |
Method: resize_width_proportionally(new_width)
resize_width_proportionally(new_width)
Redimensiona el ancho proporcionalmente. Se utiliza el valor predeterminado ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| new_width | int | El nuevo ancho. |
Method: resize_width_proportionally(new_width, resize_type)
resize_width_proportionally(new_width, resize_type)
Redimensiona el ancho proporcionalmente.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| new_width | int | El nuevo ancho. |
| resize_type | ResizeType | Tipo de redimensionamiento. |
Method: resize_width_proportionally(new_width, settings)
resize_width_proportionally(new_width, settings)
Redimensiona el ancho proporcionalmente.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| new_width | int | El nuevo ancho. |
| settings | ImageResizeSettings | Los ajustes de redimensionamiento de la imagen. |
Method: resize_width_proportionally_settings(new_width, settings)
resize_width_proportionally_settings(new_width, settings)
Redimensiona el ancho proporcionalmente.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| new_width | int | El nuevo ancho. |
| settings | ImageResizeSettings | Los ajustes de redimensionamiento de la imagen. |
Method: rotate(angle)
rotate(angle)
Rotar la imagen alrededor del centro.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| angle | float | El ángulo de rotación en grados. Los valores positivos girarán en sentido horario. |
Method: rotate(angle, resize_proportionally, background_color)
rotate(angle, resize_proportionally, background_color)
Rotar la imagen alrededor del centro.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| angle | float | El ángulo de rotación en grados. Los valores positivos girarán en sentido horario. |
| resize_proportionally | bool | si se establece a |
| background_color | Color | Color del fondo. |
Method: rotate_flip(rotate_flip_type)
rotate_flip(rotate_flip_type)
Rota, voltea o rota y voltea la imagen.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| rotate_flip_type | RotateFlipType | El tipo de 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 |
Method: save(stream)
save(stream)
Los datos guardados.
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| flujo | _io.BufferedRandom | El flujo. |
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 píxeles (método específico de formato).
Parameters:
| Parámetro | Tipo | Descripción |
|---|---|---|
| rectangle | Rectangle | El rectángulo donde guardar los píxeles. |
| pixels | Color[] | La matriz de píxeles ARGB de 32 bits. |
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_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 |
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 load a PNG image from a file.
from aspose.pycore import as_of
from aspose.imaging import Image
from aspose.imaging.fileformats.png import PngImage
# Cargar una imagen PNG desde un archivo.
with as_of(Image.load("sample.png"), PngImage) as pngImage:
# Transformar la imagen a una representación en escala de grises
pngImage.grayscale()
# Guarde en un archivo.
pngImage.save("sample.grayscale.png")
This example shows how to load a PNG image from a file with the specified color type.
import aspose.pycore as aspycore
from aspose.imaging.fileformats.png import PngImage, PngColorType
from os.path import join
dir_ = "c:\\temp"
# Cargar una imagen PNG desde un archivo.
# Tenga en cuenta que la imagen colorida se convertirá a escala de grises automáticamente.
with PngImage(join(dir_, "sample.png"), PngColorType.GRAYSCALE) as png_image:
# Guarde en un archivo.
png_image.save(join(dir_, "sample.grayscale.png"))
This example shows how to load a PNG image from a file or a file stream.
import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.png import PngImage
from os.path import join
dir_: str = "c:\\temp"
# Cargar una imagen PNG desde un flujo de archivo.
with open(join(dir_, "sample.png"), "rb") as stream:
with PngImage(stream) as png_image:
# Transformar la imagen a una representación en escala de grises
png_image.grayscale()
# Guarde en un archivo.
png_image.save(join(dir_, "sample.grayscale.png"))
This example shows how to load PNG image from a BMP image.
from aspose.imaging.fileformats.bmp import BmpImage
from aspose.imaging.fileformats.png import PngImage
from aspose.imaging import Graphics, Color
from aspose.imaging.brushes import SolidBrush
from os.path import join
dir_: str = "c:\\temp"
# Cargar una imagen PNG TrueColor desde una imagen BMP.
# Primero, cree una imagen BMP temporal que será la base para crear una imagen PNG.
# También puede cargar una imagen BMP desde un archivo o usar una imagen de cualquier otro formato raster.
with BmpImage(100, 100) as bmp_image:
# Rellene toda la imagen BMP de rojo.
gr = Graphics(bmp_image)
brush = SolidBrush(Color.red)
gr.fill_rectangle(brush, bmp_image.bounds)
with PngImage(bmp_image) as png_image:
png_image.save(join(dir_, "output.png"))
This example shows how to load PNG image from a BMP image with the specified color type.
from aspose.imaging import LoadOptions, Graphics, Color
from aspose.imaging.brushes import SolidBrush
from aspose.imaging.imageoptions import PngOptions
from aspose.imaging.fileformats.bmp import BmpImage
from aspose.imaging.fileformats.png import PngImage, PngColorType
from os.path import join as path_join
dir_ = "c:\\temp"
# Cargar una imagen PNG en escala de grises desde una imagen BMP a color.
# Primero, cree una imagen BMP temporal que será la base para crear una imagen PNG.
# También puede cargar una imagen BMP desde un archivo o usar una imagen de cualquier otro formato raster.
with BmpImage(100, 100) as bmp_image:
# Rellene toda la imagen BMP de rojo.
gr = Graphics(bmp_image)
brush = SolidBrush(Color.red)
gr.fill_rectangle(brush, bmp_image.bounds)
# Los colores de los píxeles de la imagen se convertirán a sus equivalentes en escala de grises.
with PngImage(bmp_image, PngColorType.GRAYSCALE) as png_image:
png_image.save(path_join(dir_, "output.grayscale.png"))
This example shows how to create a PNG image of the specified size, fill it with a solid color and save it to a file.
import aspose.pycore as aspycore
from aspose.imaging import Graphics, Color
from aspose.imaging.brushes import SolidBrush
from aspose.imaging.fileformats.png import PngImage
from os.path import join
dir_ = "c:\\temp"
# Cree una imagen PNG de 100x100 px.
with PngImage(100, 100) as png_image:
# Realice algo de procesamiento de imágenes, p. ej., rellene toda la imagen de rojo.
graphics = Graphics(png_image)
brush = SolidBrush(Color.red)
graphics.fill_rectangle(brush, png_image.bounds)
# Guarde en un archivo.
png_image.save(join(dir_, "output.png"))
This example shows how to create a PNG image of the specified size with the specified color type, fill it with a solid color and save it to a file.
from aspose.imaging.fileformats.png import PngImage, PngColorType
from aspose.imaging import Graphics, Color
from aspose.imaging.brushes import SolidBrush
from os.path import join
dir_: str = "c:\\temp"
# Crear una imagen PNG en escala de grises de 100x100 px.
# Todos los colores se convertirán automáticamente al formato de escala de grises.
with PngImage(100, 100, PngColorType.GRAYSCALE) as png_image:
# Realice algo de procesamiento de imágenes, p. ej., rellene toda la imagen de rojo.
graphics = Graphics(png_image)
brush = SolidBrush(Color.red)
graphics.fill_rectangle(brush, png_image.bounds)
# Guarde en un archivo.
png_image.save(join(dir_, "output.grayscale.png"))
The following example shows how to check if a PNG image supports alpha-channel.
from aspose.imaging import Image
from aspose.imaging.imageoptions import PngOptions
from aspose.imaging.fileformats.png import PngColorType, PngImage
# Obtener todos los tipos de color PNG compatibles.
color_types = [it for it in PngColorType]
for color_type in color_types:
create_options = PngOptions()
create_options.color_type = color_type
with Image.create(create_options, 100, 100) as image:
png_image = aspycore.as_of(image, PngImage)
if png_image.has_alpha:
print("A {0} PNG image supports alpha channel".format(create_options.color_type))
else:
print("A {0} PNG image doesn't support alpha channel".format(create_options.color_type))
# La salida se ve así:
# Una imagen PNG en escala de grises no admite canal alfa
# Una imagen PNG Truecolor no admite canal alfa
# Una imagen PNG IndexedColor no admite canal alfa
# Una imagen PNG GrayscaleWithAlpha admite canal alfa
# Una imagen PNG TruecolorWithAlpha admite canal alfa
The example shows how to remove any object from the image using Graphics Path with Content Aware fill algorithm.
from aspose.imaging import Image, Figure, GraphicsPath, RectangleF
from aspose.imaging.shapes import EllipseShape
from aspose.imaging.watermark import WatermarkRemover
from aspose.imaging.watermark.options import ContentAwareFillWatermarkOptions
from aspose.imaging.fileformats.png import PngImage
import aspose.pycore import as_of
image_file_path = "ball.png";
with Image.load(image_file_path) as image:
pngImage = as_of(image, PngImage)
mask = GraphicsPath()
firstFigure = Figure()
firstFigure.add_shape(EllipseShape(RectangleF(350, 170, 570 - 350, 400 - 170)))
mask.add_figure(firstFigure)
options = ContentAwareFillWatermarkOptions(mask)
options.max_painting_attempts = 4
with WatermarkRemover.paint_over(pngImage, options) as result:
result.save(outputPath)
The example shows how to remove any object from the image using Graphics Path with Telea algorithm.
from aspose.imaging import Image, Figure, GraphicsPath, RectangleF
from aspose.imaging.shapes import EllipseShape
from aspose.imaging.watermark import WatermarkRemover
from aspose.imaging.watermark.options import TeleaWatermarkOptions
from aspose.imaging.fileformats.png import PngImage
import aspose.pycore import as_of
image_file_path = "ball.png";
with Image.load(image_file_path) as image:
pngImage = as_of(image, PngImage)
mask = GraphicsPath()
firstFigure = Figure()
firstFigure.add_shape(EllipseShape(RectangleF(350, 170, 570 - 350, 400 - 170)))
mask.add_figure(firstFigure);
options = TeleaWatermarkOptions(mask)
with WatermarkRemover.paint_over(pngImage, options) as result:
result.save(outputPath)