Clase DicomImage

Summary: This Class implements Digital Imaging and Communications in Medicine
(DICOM) raster image format support and offers a comprehensive solution for
processing DICOM images with precision and flexibility. You can seamlessly
manipulate image pages, including operations to get, add, or remove pages, and
control the default and active pages. With capabilities to work with alpha channels,
embed XMP metadata, resize, rotate, crop, binarize, adjust, apply filters,
and convert to other raster formats. This API empowers developers to handle
DICOM images effectively while meeting diverse application requirements in
medical imaging contexts.

Module: aspose.imaging.fileformats.dicom

Full Name: aspose.imaging.fileformats.dicom.DicomImage

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

Constructors

NameDescripción
DicomImage(dicom_options, width, height)Inicializa una nueva instancia de la clase DicomImage sin esfuerzo con este
constructor, utilizando los parámetros dicomOptions. Perfecto para los desarrolladores que buscan
sumergirse en los objetos DicomImage de forma rápida y eficiente en sus proyectos.
DicomImage(stream)Crea una nueva instancia de la clase DicomImage utilizando un parámetro de flujo
en este constructor. Perfecto para los desarrolladores que buscan una forma simplificada de inicializar
los objetos DicomImage a partir de flujos de datos existentes en sus proyectos.
DicomImage(stream, load_options)Inicia una nueva instancia de la clase DicomImage de manera fluida empleando un flujo y
parámetros loadOptions en este constructor. Ideal para los desarrolladores deseosos de comenzar
a trabajar con los objetos DicomImage de forma rápida y eficaz en sus proyectos.

Properties

NameTypeAccessDescripción
active_pageDicomPager/wGestiona la página activa de la imagen con esta propiedad intuitiva. Ideal para los desarrolladores
que buscan cambiar dinámicamente entre páginas dentro de imágenes multipágina, garantizando una navegación y procesamiento eficientes.
active_page_indexintrRecupera el índice de la página activa sin esfuerzo con esta propiedad intuitiva.
Ideal para los desarrolladores que buscan acceso rápido al índice de la página actual dentro de imágenes multipágina,
garantizando una navegación y procesamiento eficientes.
auto_adjust_paletteboolr/wObtiene o establece un valor que indica si se ajusta automáticamente la paleta.
background_colorColorr/wObtiene o establece un valor para el color de fondo.
bits_per_pixelintrObtiene el recuento de bits por píxel de la imagen.
boundsRectanglerObtiene los límites del objeto.
buffer_size_hintintr/wObtiene 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.
containerImagerObtiene el contenedor Image.
data_stream_containerStreamContainerrObtiene el flujo de datos del objeto.
dicom_pagesDicomPage[]rAcceda a las páginas de la imagen con esta propiedad intuitiva. Ideal para desarrolladores
que buscan interactuar con páginas individuales dentro de la imagen, garantizando una navegación
y manipulación sin problemas.
disposedboolrObtiene un valor que indica si esta instancia está disposed.
exif_dataExifDatar/wObtiene o establece la instancia Exif.
file_formatFileFormatrRecupere el valor del formato de archivo sin esfuerzo con esta propiedad intuitiva. Ideal para
desarrolladores que buscan acceso rápido al formato del archivo de imagen, garantizando un manejo
y procesamiento eficientes según el tipo de archivo.
file_infoDicomImageInforRecupere información valiosa del encabezado del archivo DICOM sin esfuerzo con esta
propiedad intuitiva. Ideal para desarrolladores que buscan acceso rápido a los detalles esenciales
encapsulados en el archivo DICOM, garantizando una extracción y análisis de datos eficientes.
has_alphaboolrRecupere si la imagen tiene un canal alfa sin esfuerzo con esta propiedad intuitiva
. Ideal para desarrolladores que buscan determinar si la imagen contiene información de transparencia
, garantizando un manejo preciso de los datos del canal alfa en tareas de procesamiento de imágenes.
has_background_colorboolr/wObtiene o establece un valor que indica si la imagen tiene color de fondo.
has_transparent_colorboolr/wObtiene un valor que indica si la imagen tiene un color transparente.
heightintrObtiene la altura de la imagen.
horizontal_resolutionfloatr/wObtiene o establece la resolución horizontal, en píxeles por pulgada, de este RasterImage.
image_opacityfloatrObtiene la opacidad de esta imagen.
interrupt_monitorInterruptMonitorr/wObtiene o establece el monitor de interrupciones.
is_cachedboolrObtiene un valor que indica si los datos de la imagen están almacenados en caché actualmente.
is_raw_data_availableboolrObtiene un valor que indica si se admite la carga de datos sin procesar.
metadataImageMetadatarObtiene o establece los datos XMP del fotograma.
page_countintrRecupere el recuento total de páginas de la imagen con esta propiedad intuitiva. Ideal para
desarrolladores que buscan acceso rápido al número de páginas dentro de una imagen, garantizando una navegación
y gestión eficientes.
pagesImage[]rAcceda a las páginas de la imagen con esta propiedad intuitiva. Ideal para desarrolladores
que buscan interactuar con páginas individuales dentro de la imagen, garantizando una navegación
y manipulación sin problemas.
paletteIColorPaletter/wObtiene o establece la paleta de colores. La paleta de colores no se usa cuando los píxeles se representan directamente.
premultiply_componentsboolr/wObtiene o establece un valor que indica si los componentes de la imagen deben ser premultiplicados.
raw_custom_color_converterIColorConverterr/wObtiene o establece el convertidor de color personalizado
raw_data_formatPixelDataFormatrObtiene el formato de datos sin procesar.
raw_data_settingsRawDataSettingsrObtiene la configuración actual de datos sin procesar. Nota: al usar esta configuración, los datos se cargan sin conversión.
raw_fallback_indexintr/wObtiene o establece el índice de reserva a usar cuando el índice de la paleta está fuera de los límites
raw_indexed_color_converterIIndexedColorConverterr/wObtiene o establece el convertidor de color indexado
raw_line_sizeintrObtiene el tamaño de línea sin procesar en bytes.
sizeSizerObtiene el tamaño del objeto.
transparent_colorColorr/wObtiene el color transparente de la imagen.
update_xmp_databoolr/wObtiene o establece un valor que indica si se debe actualizar los metadatos XMP.
use_paletteboolrObtiene un valor que indica si se usa la paleta de la imagen.
use_raw_databoolr/wObtiene 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_resolutionfloatr/wObtiene o establece la resolución vertical, en píxeles por pulgada, de este RasterImage.
widthintrObtiene el ancho de la imagen.
xmp_dataXmpPacketWrapperr/wObtiene o establece los datos Xmp.

Methods

NameDescripción
add_page()Agrega una nueva página al final de la lista de páginas de la imagen con este método sencillo.
Ideal para desarrolladores que buscan expandir dinámicamente imágenes multipágina, garantizando una integración fluida
y la organización del contenido de la imagen.
add_page(page)Amplía tu colección de imágenes añadiendo una nueva página con este método intuitivo.
Ideal para desarrolladores que buscan agregar dinámicamente páginas a imágenes multipágina,
garantizando una expansión fluida y la organización del contenido de la imagen.
adjust_brightness(brightness)Mejora la luminancia de la imagen con el ajuste del brillo, un
método parametrizado que permite a los desarrolladores afinar la luminosidad de las imágenes.
Esta función fácil de usar permite a los desarrolladores manipular sin problemas el
brillo de la imagen, ofreciendo flexibilidad y control sobre la estética visual.
adjust_contrast(contrast)Mejora el contraste de Image con este método fácil de usar,
que ajusta la disparidad entre áreas claras y oscuras. Mejora la claridad visual y
la definición sin esfuerzo, proporcionando a los desarrolladores un control intuitivo sobre
el contraste de la imagen para una renderización óptima.
adjust_gamma(gamma)Mejora la calidad de la imagen y ajústala con corrección gamma, una técnica poderosa
para afinar la apariencia visual. Perfecta para desarrolladores que buscan optimizar la presentación de la imagen,
ajustar el balance de color y garantizar una renderización consistente en diferentes
dispositivos y entornos.
adjust_gamma(gamma_red, gamma_green, gamma_blue)Logra ajustes de color precisos aplicando corrección gamma de forma independiente
a los componentes rojo, verde y azul de una imagen. Este método garantiza un balance de color preciso
y una salida visual óptima, atendiendo a desarrolladores que buscan un control granular
sobre la renderización de la imagen y la exactitud del color.
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)Binaria imágenes con el algoritmo de umbral adaptativo de Bradley, aprovechando el umbralado de imagen integral para mejorar el rendimiento. Ideal para desarrolladores que desean
segmentar automáticamente imágenes basándose en variaciones locales de brillo, garantizando
una detección y extracción precisas de objetos en condiciones de iluminación variables.
binarize_fixed(threshold)Convierte fácilmente la imagen a un formato binario usando un umbral predefinido
con este método sencillo. Ideal para desarrolladores que buscan simplificar tareas de procesamiento de imágenes segmentando la imagen en componentes de primer plano y fondo
basándose en niveles de intensidad especificados.
binarize_otsu()Aplica el umbralado de Otsu para binarizar la imagen, determinando automáticamente el valor de umbral óptimo basado en el histograma de la imagen. Perfecto para desarrolladores que buscan
un método fiable para segmentar imágenes en regiones de primer plano y fondo con
mínima intervención manual.
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()Este método almacena datos en caché de manera eficiente, optimizando el rendimiento y garantizando un acceso rápido
cuando sea necesario. Ideal para desarrolladores que buscan mejorar la velocidad y eficiencia de sus
aplicaciones gestionando inteligentemente los recursos de datos.
can_load(file_path)Determina si la imagen puede cargarse desde la ruta de archivo especificada.
can_load(file_path, load_options)Determina si la imagen puede cargarse desde la ruta de archivo especificada y, opcionalmente, usando las opciones de apertura especificadas.
can_load(stream)Determina si la imagen puede cargarse desde el flujo especificado.
can_load(stream, load_options)Determina si la imagen puede cargarse desde el flujo especificado y, opcionalmente, usando los loadOptions especificados.
can_load_stream(stream)Determina si la imagen puede cargarse desde el flujo especificado.
can_load_stream_with_options(stream, load_options)Determina si la imagen puede cargarse desde el flujo especificado y, opcionalmente, usando los loadOptions especificados.
can_load_with_options(file_path, load_options)Determina si la imagen puede cargarse desde la ruta de archivo especificada y, opcionalmente, usando las opciones de apertura especificadas.
can_save(options)Determina si la imagen puede guardarse en el formato de archivo especificado representado por las opciones de guardado proporcionadas.
create(files)Crea la imagen multipágina que contiene los archivos especificados.
create(files, throw_exception_on_load_error)Crea la imagen multipágina que contiene los archivos especificados.
create(image_options, width, height)Crea una nueva imagen usando las opciones de creación especificadas.
create(image_options, width, height, pixels)Crea una instancia de RasterImage a partir del arreglo de píxeles proporcionado.

Valida que el ancho y alto especificados coincidan con las dimensiones de los datos de píxeles.
Este método solo puede usarse cuando la biblioteca está en modo Licenciado.
create(images)Crea una nueva imagen usando las imágenes especificadas como páginas
create(images, dispose_images)Crea una nueva imagen con las imágenes especificadas como páginas.
create(multipage_create_options)Crea las opciones de creación multipágina especificadas.
create_from_files(files)Crea la imagen multipágina que contiene los archivos especificados como páginas de carga diferida.
create_from_files(files, throw_exception_on_load_error)Crea la imagen multipágina que contiene los archivos especificados como páginas de carga diferida.
create_from_images(images)Crea una nueva imagen usando las imágenes especificadas como páginas
create_from_images(images, dispose_images)Crea una nueva imagen con las imágenes especificadas como páginas.
crop(left_shift, right_shift, top_shift, bottom_shift)Ajusta el área de recorte de la imagen aplicando desplazamientos con este método versátil.
Perfecto para desarrolladores que necesitan un control preciso sobre el proceso de recorte, asegurando
que se conserven los detalles importantes mientras se eliminan los elementos innecesarios.
crop(rectangle)Recorta la imagen para eliminar áreas no deseadas y centrarte en el contenido esencial con este
método sencillo. Ideal para desarrolladores que buscan personalizar la composición visual de
imágenes, asegurando que transmitan el mensaje deseado de manera eficaz.
dither(dithering_method, bits_count)Aplica dithering a la imagen actual.
dither(dithering_method, bits_count, custom_palette)Mejora la imagen actual aplicando efectos de dithering con este método sencillo
. Perfecto para desarrolladores que desean añadir textura y profundidad a las imágenes,
mejorando su calidad visual y atractivo general.
embed_digital_signature(password)Incrusta una firma digital basada en la contraseña proporcionada en cada página de la imagen.
filter(rectangle, options)Mejora sin esfuerzo áreas específicas de tu imagen aplicando filtros a rectángulos designados
. Este método brinda a los desarrolladores un control preciso sobre
la manipulación de la imagen, permitiendo ajustes dirigidos para lograr los efectos
visuales deseados con facilidad.
get_argb_32_pixel(x, y)Obtiene un píxel ARGB de 32 bits de la imagen.
get_default_argb_32_pixels(rectangle)Obtiene la matriz predeterminada de píxeles ARGB de 32 bits.
get_default_options(args)Obtiene las opciones predeterminadas.
get_default_pixels(rectangle, partial_pixel_loader)Obtiene la matriz predeterminada de píxeles usando el cargador parcial de píxeles.
get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings)Obtiene la matriz de datos sin procesar predeterminada usando el cargador parcial de píxeles.
get_default_raw_data(rectangle, raw_data_settings)Obtiene la matriz de datos sin procesar predeterminada.
get_file_format(file_path)Obtiene el formato de archivo.
get_file_format(stream)Obtiene el formato de archivo.
get_file_format_of_stream(stream)Obtiene el formato de archivo.
get_fitting_rectangle(rectangle, pixels, width, height)Obtiene el rectángulo que se ajusta a la imagen actual.
get_fitting_rectangle(rectangle, width, height)Obtiene el rectángulo que se ajusta a la imagen actual.
get_modify_date(use_default)Obtiene la fecha y hora en que la imagen del recurso fue modificada por última vez.
get_original_options()Obtiene las opciones basadas en la configuración original del archivo.
Esto puede ser útil para mantener la profundidad de bits y otros parámetros de la imagen original sin cambios.
Por ejemplo, si cargamos una imagen PNG en blanco y negro con 1 bit por píxel y luego la guardamos usando el
método DataStreamSupporter.save(file_path), se producirá una imagen PNG de salida con 8 bits por píxel.
Para evitarlo y guardar la imagen PNG con 1 bit por píxel, use este método para obtener las opciones de guardado correspondientes y páselas
al método Image.save(file_path, options) como segundo parámetro.
get_pixel(x, y)Obtiene un píxel de la imagen.
get_proportional_height(width, height, new_width)Obtiene una altura proporcional.
get_proportional_width(width, height, new_height)Obtiene un ancho proporcional.
get_serialized_stream(image_options, clipping_rectangle, page_number)Convierte a aps.
get_skew_angle()Obtiene el ángulo de sesgo.
Este método es aplicable a documentos de texto escaneados, para determinar el ángulo de sesgo al escanear.
grayscale()Transforma fácilmente imágenes a su representación en escala de grises, simplificando el análisis visual
y las tareas de procesamiento. Perfecto para desarrolladores que buscan mejorar la claridad de la imagen,
reducir la complejidad y facilitar algoritmos eficientes basados en escala de grises
para diversas aplicaciones.
insert_page(page_index)Inserta una nueva página en la lista de páginas de la imagen en un índice especificado con este método intuitivo
. Ideal para desarrolladores que buscan un control preciso sobre la disposición de las páginas en
imágenes multipágina, garantizando una organización fluida y la personalización del contenido 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.
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.
remove_page(page_index)Elimina la página en el índice especificado de la lista de páginas con este método conveniente.
Ideal para desarrolladores que buscan un control preciso sobre la gestión de imágenes multipágina,
garantizando una organización fluida y la personalización del contenido de la imagen.
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 la imagen manteniendo su relación de aspecto con este método conveniente. Ideal
para desarrolladores que buscan ajustar las dimensiones de la imagen proporcionalmente, garantizando
consistencia y preservando las proporciones del contenido original.
El redimensionado proporcional redimensionará cada fotograma según la relación de newWidth/width y newHeight/height.
resize(new_width, new_height, settings)Ajusta el tamaño de tu imagen con este sencillo método de redimensionado. Ya sea que necesites
reducir o ampliar tu imagen, esta función garantiza que tus necesidades de redimensionado se cumplan
de manera eficiente y precisa, lo que la hace perfecta para desarrolladores que buscan ajustes rápidos y fáciles
del tamaño de 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)Ajusta la altura de la imagen manteniendo su relación de aspecto con este
método fácil de usar. Perfecto para desarrolladores que buscan redimensionar imágenes dinámicamente
mientras preservan sus proporciones, garantizando una visualización y usabilidad óptimas
en sus aplicaciones.
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)Redimensiona la imagen manteniendo su relación de aspecto con este método conveniente. Ideal
para desarrolladores que buscan ajustar las dimensiones de la imagen proporcionalmente, garantizando
consistencia y preservando las proporciones del contenido original.
El redimensionado proporcional redimensionará cada fotograma según la relació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)Ajusta el ancho de la imagen manteniendo su relación de aspecto con este conveniente
método. Ideal para desarrolladores que buscan redimensionar imágenes proporcionalmente, garantizando
resultados consistentes y visualmente atractivos en diferentes entornos de visualización.
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)Rota la imagen alrededor de su centro con este conveniente método. Ideal para desarrolladores
que buscan ajustar la orientación de la imagen dinámicamente, garantizando una presentación y
alineación óptimas dentro de sus aplicaciones.
rotate_flip(rotate_flip_type)Manipula fácilmente el fotograma activo rotando, volteando o realizando ambas acciones
simultáneamente con este método sencillo. Ideal para desarrolladores que necesitan
ajustar dinámicamente la orientación de fotogramas específicos dentro de sus secuencias de imágenes,
garantizando una presentación y alineación óptimas.
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)Preserva los datos del objeto guardándolos en el archivo designado (índice + nombre de archivo)
ubicación junto con el formato de archivo y opciones especificados. Ideal para desarrolladores que buscan
almacenar datos de forma segura en varios formatos mientras mantienen flexibilidad y control sobre
los parámetros de guardado.
save(file_path, options, bounds_rectangle)Guarda los datos del objeto en la ubicación de archivo especificada en el formato de archivo indicado según las opciones de guardado.
save(file_path, over_write)Guarda los datos del objeto en la ubicación de archivo especificada.
save(stream)Guarda los datos.
save(stream, options_base)Guarda los datos de la imagen en el flujo especificado en el formato de archivo indicado según las opciones de guardado.
save(stream, options_base, bounds_rectangle)Guarda fácilmente los datos de tu imagen en un flujo especificado en el formato de archivo deseado
usando este método conveniente. Ya sea que trabajes con JPEG, PNG u otro formato,
esta función garantiza que los datos de tu imagen se guarden de manera eficiente y precisa,
lo que la hace ideal para desarrolladores que buscan simplificar sus procesos de guardado de archivos.
save_all(file_path, options)Preserva los datos del objeto guardándolos en el archivo designado (índice + nombre de archivo)
ubicación junto con el formato de archivo y opciones especificados. Ideal para desarrolladores que buscan
almacenar datos de forma segura en varios formatos mientras mantienen flexibilidad y control sobre
los parámetros 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)Ajusta la resolución de este RasterImage con precisión usando este
método sencillo. Ideal para desarrolladores que buscan adaptar la resolución de la imagen a
requisitos específicos, garantizando una calidad de visualización óptima y una gestión adecuada del tamaño del archivo.
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: DicomImage(dicom_options, width, height)

 DicomImage(dicom_options, width, height) 

Inicializa una nueva instancia de la clase DicomImage sin esfuerzo con este
constructor, utilizando los parámetros dicomOptions. Perfecto para los desarrolladores que buscan
sumergirse en los objetos DicomImage de forma rápida y eficiente en sus proyectos.

Parameters:

ParámetroTipoDescripción
dicom_optionsDicomOptionsLas opciones DICOM.
widthintEl ancho.
heightintLa altura.

Constructor: DicomImage(stream)

 DicomImage(stream) 

Crea una nueva instancia de la clase DicomImage utilizando un parámetro de flujo
en este constructor. Perfecto para los desarrolladores que buscan una forma simplificada de inicializar
los objetos DicomImage a partir de flujos de datos existentes en sus proyectos.

Parameters:

ParámetroTipoDescripción
flujo_io.BufferedRandomEl flujo.

See also:

Example # 1: This example shows how to load a DICOM image from a file stream.

Constructor: DicomImage(stream, load_options)

 DicomImage(stream, load_options) 

Inicia una nueva instancia de la clase DicomImage de manera fluida empleando un flujo y
parámetros loadOptions en este constructor. Ideal para los desarrolladores deseosos de comenzar
a trabajar con los objetos DicomImage de forma rápida y eficaz en sus proyectos.

Parameters:

ParámetroTipoDescripción
flujo_io.BufferedRandomEl flujo.
load_optionsLoadOptionsLas opciones de carga.

See also:

Example # 1: This example shows how to load a DICOM image from a file stream to stay withi…

Method: add_page()

 add_page() 

Agrega una nueva página al final de la lista de páginas de la imagen con este método sencillo.
Ideal para desarrolladores que buscan expandir dinámicamente imágenes multipágina, garantizando una integración fluida
y la organización del contenido de la imagen.

Returns

TipoDescripción
DicomPageLa recién creada DicomPage.

Method: add_page(page)

 add_page(page) 

Amplía tu colección de imágenes añadiendo una nueva página con este método intuitivo.
Ideal para desarrolladores que buscan agregar dinámicamente páginas a imágenes multipágina,
garantizando una expansión fluida y la organización del contenido de la imagen.

Parameters:

ParámetroTipoDescripción
pageRasterImageLa página a añadir.

Method: adjust_brightness(brightness)

 adjust_brightness(brightness) 

Mejora la luminancia de la imagen con el ajuste del brillo, un
método parametrizado que permite a los desarrolladores afinar la luminosidad de las imágenes.
Esta función fácil de usar permite a los desarrolladores manipular sin problemas el
brillo de la imagen, ofreciendo flexibilidad y control sobre la estética visual.

Parameters:

ParámetroTipoDescripción
brillointValor de brillo.

See also:

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

Method: adjust_contrast(contrast)

 adjust_contrast(contrast) 

Mejora el contraste de Image con este método fácil de usar,
que ajusta la disparidad entre áreas claras y oscuras. Mejora la claridad visual y
la definición sin esfuerzo, proporcionando a los desarrolladores un control intuitivo sobre
el contraste de la imagen para una renderización óptima.

Parameters:

ParámetroTipoDescripción
contrastefloatValor de contraste (en el rango [-100; 100])

See also:

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

Method: adjust_gamma(gamma)

 adjust_gamma(gamma) 

Mejora la calidad de la imagen y ajústala con corrección gamma, una técnica poderosa
para afinar la apariencia visual. Perfecta para desarrolladores que buscan optimizar la presentación de la imagen,
ajustar el balance de color y garantizar una renderización consistente en diferentes
dispositivos y entornos.

Parameters:

ParámetroTipoDescripción
gammafloatCoeficiente gamma para los canales rojo, verde y azul

See also:

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

Method: adjust_gamma(gamma_red, gamma_green, gamma_blue)

 adjust_gamma(gamma_red, gamma_green, gamma_blue) 

Logra ajustes de color precisos aplicando corrección gamma de forma independiente
a los componentes rojo, verde y azul de una imagen. Este método garantiza un balance de color preciso
y una salida visual óptima, atendiendo a desarrolladores que buscan un control granular
sobre la renderización de la imagen y la exactitud del color.

Parameters:

ParámetroTipoDescripción
gamma_redfloatCoeficiente gamma para el canal rojo
gamma_greenfloatCoeficiente gamma para el canal verde
gamma_bluefloatGamma para el coeficiente del canal azul

See also:

Example # 1: The following example performs gamma-correction of a DICOM image applying dif…

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ámetroTipoDescripción
passwordstringLa contraseña utilizada para extraer los datos incrustados.

Returns

TipoDescripción
intEl 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ámetroTipoDescripción
brightness_differencefloatLa 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.

Method: binarize_bradley(brightness_difference, window_size)

 binarize_bradley(brightness_difference, window_size) 

Binaria imágenes con el algoritmo de umbral adaptativo de Bradley, aprovechando el umbralado de imagen integral para mejorar el rendimiento. Ideal para desarrolladores que desean
segmentar automáticamente imágenes basándose en variaciones locales de brillo, garantizando
una detección y extracción precisas de objetos en condiciones de iluminación variables.

Parameters:

ParámetroTipoDescripción
brightness_differencefloatLa 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_sizeintEl tamaño de la ventana de píxeles de s x s centrada alrededor de este píxel

See also:

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

Method: binarize_fixed(threshold)

 binarize_fixed(threshold) 

Convierte fácilmente la imagen a un formato binario usando un umbral predefinido
con este método sencillo. Ideal para desarrolladores que buscan simplificar tareas de procesamiento de imágenes segmentando la imagen en componentes de primer plano y fondo
basándose en niveles de intensidad especificados.

Parameters:

ParámetroTipoDescripción
umbralSystem.ByteValor de umbral. Si el valor gris correspondiente de un píxel es mayor que el umbral, se asignará un valor de
255, de lo contrario 0.

See also:

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

Method: blend(origin, overlay, overlay_alpha)

 blend(origin, overlay, overlay_alpha) 

Mezcla esta instancia de imagen con la imagen overlay.

Parameters:

ParámetroTipoDescripción
originPointEl origen de la fusión de la imagen de fondo.
overlayRasterImageLa imagen superpuesta.
overlay_alphaSystem.ByteEl 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ámetroTipoDescripción
originPointEl origen de la fusión de la imagen de fondo.
overlayRasterImageLa imagen superpuesta.
overlay_areaRectangleEl área de superposición.
overlay_alphaSystem.ByteEl 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ámetroTipoDescripción
file_pathstringLa ruta del archivo.

Returns

TipoDescripción
booltrue 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ámetroTipoDescripción
file_pathstringLa ruta del archivo.
load_optionsLoadOptionsLas opciones de carga.

Returns

TipoDescripción
booltrue 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ámetroTipoDescripción
flujo_io.BufferedRandomEl flujo desde el cual cargar.

Returns

TipoDescripción
booltrue 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ámetroTipoDescripción
flujo_io.BufferedRandomEl flujo desde el cual cargar.
load_optionsLoadOptionsLas opciones de carga.

Returns

TipoDescripción
booltrue 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ámetroTipoDescripción
flujo_io.BufferedRandomEl flujo desde el cual cargar.

Returns

TipoDescripción
booltrue 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ámetroTipoDescripción
flujo_io.BufferedRandomEl flujo desde el cual cargar.
load_optionsLoadOptionsLas opciones de carga.

Returns

TipoDescripción
booltrue 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ámetroTipoDescripción
file_pathstringLa ruta del archivo.
load_optionsLoadOptionsLas opciones de carga.

Returns

TipoDescripción
booltrue 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ámetroTipoDescripción
optionsImageOptionsBaseLas opciones de guardado a usar.

Returns

TipoDescripción
booltrue 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ámetroTipoDescripción
filesstring[]Los archivos.

Returns

TipoDescripción
ImageLa 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ámetroTipoDescripción
filesstring[]Los archivos.
throw_exception_on_load_errorboolsi se establece en true [lanzar excepción al error de carga].

Returns

TipoDescripción
ImageLa 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ámetroTipoDescripción
image_optionsImageOptionsBaseLas opciones de la imagen.
widthintEl ancho.
heightintLa altura.

Returns

TipoDescripción
ImageLa 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ámetroTipoDescripción
image_optionsImageOptionsBaseLas opciones usadas para crear el RasterImage.
widthintEl ancho del RasterImage.
heightintLa altura del RasterImage.
píxelesint[]La matriz de valores de píxeles usada para poblar la imagen.

Returns

TipoDescripción
ImageUna 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ámetroTipoDescripción
imagesImage[]Las imágenes.

Returns

TipoDescripción
ImageLa 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ámetroTipoDescripción
imagesImage[]Las imágenes.
dispose_imagesboolsi se establece en true [eliminar imágenes].

Returns

TipoDescripción
ImageLa Imagen como IMultipageImage

Method: create(multipage_create_options) [static]

 create(multipage_create_options) 

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

Parameters:

ParámetroTipoDescripción
multipage_create_optionsMultipageCreateOptionsLas opciones de creación multipágina.

Returns

TipoDescripción
ImageLa 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ámetroTipoDescripción
filesstring[]Los archivos.

Returns

TipoDescripción
ImageLa 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ámetroTipoDescripción
filesstring[]Los archivos.
throw_exception_on_load_errorboolsi se establece en true lanzar excepción al error de carga.

Returns

TipoDescripción
ImageLa 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ámetroTipoDescripción
imagesImage[]Las imágenes.

Returns

TipoDescripción
ImageLa 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ámetroTipoDescripción
imagesImage[]Las imágenes.
dispose_imagesboolsi se establece en true [eliminar imágenes].

Returns

TipoDescripción
ImageLa Imagen como IMultipageImage

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

 crop(left_shift, right_shift, top_shift, bottom_shift) 

Ajusta el área de recorte de la imagen aplicando desplazamientos con este método versátil.
Perfecto para desarrolladores que necesitan un control preciso sobre el proceso de recorte, asegurando
que se conserven los detalles importantes mientras se eliminan los elementos innecesarios.

Parameters:

ParámetroTipoDescripción
left_shiftintEl desplazamiento a la izquierda.
right_shiftintEl desplazamiento a la derecha.
top_shiftintEl desplazamiento superior.
bottom_shiftintEl desplazamiento inferior.

See also:

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

Method: crop(rectangle)

 crop(rectangle) 

Recorta la imagen para eliminar áreas no deseadas y centrarte en el contenido esencial con este
método sencillo. Ideal para desarrolladores que buscan personalizar la composición visual de
imágenes, asegurando que transmitan el mensaje deseado de manera eficaz.

Parameters:

ParámetroTipoDescripción
rectangleRectangleEl rectángulo.

See also:

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

Method: dither(dithering_method, bits_count)

 dither(dithering_method, bits_count) 

Aplica dithering a la imagen actual.

Parameters:

ParámetroTipoDescripción
dithering_methodDitheringMethodEl método de tramado.
bits_countintEl recuento final de bits para el tramado.

Method: dither(dithering_method, bits_count, custom_palette)

 dither(dithering_method, bits_count, custom_palette) 

Mejora la imagen actual aplicando efectos de dithering con este método sencillo
. Perfecto para desarrolladores que desean añadir textura y profundidad a las imágenes,
mejorando su calidad visual y atractivo general.

Parameters:

ParámetroTipoDescripción
dithering_methodDitheringMethodEl método de tramado.
bits_countintEl recuento final de bits para el tramado.
custom_paletteIColorPaletteLa 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ámetroTipoDescripción
passwordstringLa contraseña utilizada para generar datos de firma digital.

Method: filter(rectangle, options)

 filter(rectangle, options) 

Mejora sin esfuerzo áreas específicas de tu imagen aplicando filtros a rectángulos designados
. Este método brinda a los desarrolladores un control preciso sobre
la manipulación de la imagen, permitiendo ajustes dirigidos para lograr los efectos
visuales deseados con facilidad.

Parameters:

ParámetroTipoDescripción
rectangleRectangleEl rectángulo.
optionsFilterOptionsBaseLas 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ámetroTipoDescripción
xintLa ubicación x del píxel.
yintLa ubicación y del píxel.

Returns

TipoDescripción
intEl 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ámetroTipoDescripción
rectangleRectangleEl rectángulo del cual obtener píxeles.

Returns

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

Method: get_default_options(args)

 get_default_options(args) 

Obtiene las opciones predeterminadas.

Parameters:

ParámetroTipoDescripción
argsSystem.ObjectLos argumentos.

Returns

TipoDescripción
ImageOptionsBaseOpciones 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ámetroTipoDescripción
rectangleRectangleEl rectángulo del cual obtener píxeles.
partial_pixel_loaderIPartialArgb32PixelLoaderEl 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ámetroTipoDescripción
rectangleRectangleEl rectángulo del cual obtener píxeles.
partial_raw_data_loaderIPartialRawDataLoaderEl cargador parcial de datos sin procesar.
raw_data_settingsRawDataSettingsLa 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ámetroTipoDescripción
rectangleRectangleEl rectángulo del cual obtener datos sin procesar.
raw_data_settingsRawDataSettingsLa configuración de datos sin procesar.

Returns

TipoDescripción
System.ByteLa 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ámetroTipoDescripción
file_pathstringLa ruta del archivo.

Returns

TipoDescripción
FileFormatEl formato de archivo determinado.

Method: get_file_format(stream) [static]

 get_file_format(stream) 

Obtiene el formato de archivo.

Parameters:

ParámetroTipoDescripción
flujo_io.BufferedRandomEl flujo.

Returns

TipoDescripción
FileFormatEl 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ámetroTipoDescripción
flujo_io.BufferedRandomEl flujo.

Returns

TipoDescripción
FileFormatEl 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ámetroTipoDescripción
rectangleRectangleEl rectángulo para obtener el rectángulo de ajuste.
píxelesint[]Los píxeles ARGB de 32 bits.
widthintEl ancho del objeto.
heightintLa altura del objeto.

Returns

TipoDescripción
RectangleEl 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ámetroTipoDescripción
rectangleRectangleEl rectángulo para obtener el rectángulo de ajuste.
widthintEl ancho del objeto.
heightintLa altura del objeto.

Returns

TipoDescripción
RectangleEl 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ámetroTipoDescripción
use_defaultboolsi se establece en true utiliza la información de FileInfo como valor predeterminado.

Returns

TipoDescripción
System.DateTimeLa 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

TipoDescripción
ImageOptionsBaseLas 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ámetroTipoDescripción
xintLa ubicación x del píxel.
yintLa ubicación y del píxel.

Returns

TipoDescripción
ColorEl 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ámetroTipoDescripción
widthintEl ancho.
heightintLa altura.
new_widthintEl nuevo ancho.

Returns

TipoDescripción
intLa altura proporcional.

Method: get_proportional_width(width, height, new_height) [static]

 get_proportional_width(width, height, new_height) 

Obtiene un ancho proporcional.

Parameters:

ParámetroTipoDescripción
widthintEl ancho.
heightintLa altura.
new_heightintLa nueva altura.

Returns

TipoDescripción
intEl 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ámetroTipoDescripción
image_optionsImageOptionsBaseLas opciones de la imagen.
clipping_rectangleRectangleEl rectángulo de recorte.
page_numberint[]El número de página.

Returns

TipoDescripción
_io.BufferedRandomEl 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

TipoDescripción
floatEl ángulo de sesgo, en grados.

Method: insert_page(page_index)

 insert_page(page_index) 

Inserta una nueva página en la lista de páginas de la imagen en un índice especificado con este método intuitivo
. Ideal para desarrolladores que buscan un control preciso sobre la disposición de las páginas en
imágenes multipágina, garantizando una organización fluida y la personalización del contenido de la imagen.

Parameters:

ParámetroTipoDescripción
page_indexintÍndice de la página.

Returns

TipoDescripción
DicomPageLa recién creada DicomPage.

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ámetroTipoDescripción
passwordstringLa contraseña para verificar la firma.
percentage_thresholdintEl umbral (en porcentaje)[0-100] que determina si la imagen se considera firmada.
Si no se especifica, se aplicará un umbral predeterminado (75).

Returns

TipoDescripción
boolVerdadero 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ámetroTipoDescripción
file_pathstringLa ruta del archivo o URL desde la cual cargar la imagen.

Returns

TipoDescripción
ImageLa 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ámetroTipoDescripción
file_pathstringLa ruta del archivo o URL desde la cual cargar la imagen.
load_optionsLoadOptionsLas opciones de carga.

Returns

TipoDescripción
ImageLa imagen cargada.

Method: load(stream) [static]

 load(stream) 

Carga una nueva imagen desde el flujo especificado.

Parameters:

ParámetroTipoDescripción
flujo_io.BufferedRandomEl flujo desde el cual cargar la imagen.

Returns

TipoDescripción
ImageLa imagen cargada.

Method: load(stream, load_options) [static]

 load(stream, load_options) 

Carga una nueva imagen desde el flujo especificado.

Parameters:

ParámetroTipoDescripción
flujo_io.BufferedRandomEl flujo desde el cual cargar la imagen.
load_optionsLoadOptionsLas opciones de carga.

Returns

TipoDescripción
ImageLa imagen cargada.

Method: load_argb_32_pixels(rectangle)

 load_argb_32_pixels(rectangle) 

Carga píxeles ARGB de 32 bits.

Parameters:

ParámetroTipoDescripción
rectangleRectangleEl rectángulo desde el cual cargar los píxeles.

Returns

TipoDescripció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ámetroTipoDescripción
rectangleRectangleEl rectángulo desde el cual cargar los píxeles.

Returns

TipoDescripció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ámetroTipoDescripción
rectangleRectangleEl rectángulo desde el cual cargar los píxeles.

Returns

TipoDescripció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ámetroTipoDescripción
rectangleRectangleEl rectángulo desde el cual cargar los píxeles.

Returns

TipoDescripció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ámetroTipoDescripción
rectangleRectangleEl rectángulo desde el cual cargar los píxeles.
partial_pixel_loaderIPartialArgb32PixelLoaderEl 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ámetroTipoDescripción
rectangleRectangleEl rectángulo deseado.
partial_pixel_loaderIPartialArgb64PixelLoaderEl 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ámetroTipoDescripción
desired_rectangleRectangleEl rectángulo deseado.
pixel_loaderIPartialPixelLoaderEl cargador de píxeles.

Method: load_pixels(rectangle)

 load_pixels(rectangle) 

Carga píxeles.

Parameters:

ParámetroTipoDescripción
rectangleRectangleEl rectángulo desde el cual cargar los píxeles.

Returns

TipoDescripció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ámetroTipoDescripción
rectangleRectangleEl rectángulo desde el cual cargar datos sin procesar.
dest_image_boundsRectangleLos límites de la imagen de destino.
raw_data_settingsRawDataSettingsLa 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_loaderIPartialRawDataLoaderEl 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ámetroTipoDescripción
rectangleRectangleEl rectángulo desde el cual cargar datos sin procesar.
raw_data_settingsRawDataSettingsLa 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_loaderIPartialRawDataLoaderEl cargador de datos sin procesar.

Method: load_stream(stream) [static]

 load_stream(stream) 

Carga una nueva imagen desde el flujo especificado.

Parameters:

ParámetroTipoDescripción
flujo_io.BufferedRandomEl flujo desde el cual cargar la imagen.

Returns

TipoDescripción
ImageLa 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ámetroTipoDescripción
flujo_io.BufferedRandomEl flujo desde el cual cargar la imagen.
load_optionsLoadOptionsLas opciones de carga.

Returns

TipoDescripción
ImageLa 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ámetroTipoDescripción
file_pathstringLa ruta del archivo o URL desde la cual cargar la imagen.
load_optionsLoadOptionsLas opciones de carga.

Returns

TipoDescripción
ImageLa 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ámetroTipoDescripción
resize_proportionallyboolsi 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_colorColorColor 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ámetroTipoDescripción
scan_line_indexintÍndice basado en cero de la línea de escaneo.

Returns

TipoDescripció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ámetroTipoDescripción
scan_line_indexintÍndice basado en cero de la línea de escaneo.

Returns

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

Method: remove_page(page_index)

 remove_page(page_index) 

Elimina la página en el índice especificado de la lista de páginas con este método conveniente.
Ideal para desarrolladores que buscan un control preciso sobre la gestión de imágenes multipágina,
garantizando una organización fluida y la personalización del contenido de la imagen.

Parameters:

ParámetroTipoDescripción
page_indexintÍndice de la página.

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ámetroTipoDescripción
old_color_argbintValor ARGB del color antiguo a reemplazar.
old_color_diffSystem.ByteDiferencia permitida en el color antiguo para poder ampliar el tono del color reemplazado.
new_color_argbintNuevo 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ámetroTipoDescripción
old_colorColor
old_color_diffSystem.ByteDiferencia permitida en el color antiguo para poder ampliar el tono del color reemplazado.
new_colorColor

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ámetroTipoDescripción
old_color_argbintValor ARGB del color antiguo a reemplazar.
old_color_diffSystem.ByteDiferencia permitida en el color antiguo para poder ampliar el tono del color reemplazado.
new_color_argbintNuevo 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ámetroTipoDescripción
new_colorColor

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ámetroTipoDescripción
new_color_argbintNuevo 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ámetroTipoDescripción
new_widthintEl nuevo ancho.
new_heightintLa nueva altura.

Method: resize(new_width, new_height, resize_type)

 resize(new_width, new_height, resize_type) 

Redimensiona la imagen manteniendo su relación de aspecto con este método conveniente. Ideal
para desarrolladores que buscan ajustar las dimensiones de la imagen proporcionalmente, garantizando
consistencia y preservando las proporciones del contenido original.
El redimensionado proporcional redimensionará cada fotograma según la relación de newWidth/width y newHeight/height.

Parameters:

ParámetroTipoDescripción
new_widthintEl nuevo ancho.
new_heightintLa nueva altura.
resize_typeResizeTypeEl tipo de redimensionamiento.

Method: resize(new_width, new_height, settings)

 resize(new_width, new_height, settings) 

Ajusta el tamaño de tu imagen con este sencillo método de redimensionado. Ya sea que necesites
reducir o ampliar tu imagen, esta función garantiza que tus necesidades de redimensionado se cumplan
de manera eficiente y precisa, lo que la hace perfecta para desarrolladores que buscan ajustes rápidos y fáciles
del tamaño de la imagen.

Parameters:

ParámetroTipoDescripción
new_widthintEl nuevo ancho.
new_heightintLa nueva altura.
settingsImageResizeSettingsLos 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ámetroTipoDescripción
new_widthintEl nuevo ancho.
new_heightintLa nueva altura.
settingsImageResizeSettingsLos 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ámetroTipoDescripción
new_widthintEl nuevo ancho.
new_heightintLa nueva altura.
resize_typeResizeTypeEl 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ámetroTipoDescripción
new_heightintLa nueva altura.

Method: resize_height_proportionally(new_height, resize_type)

 resize_height_proportionally(new_height, resize_type) 

Ajusta la altura de la imagen manteniendo su relación de aspecto con este
método fácil de usar. Perfecto para desarrolladores que buscan redimensionar imágenes dinámicamente
mientras preservan sus proporciones, garantizando una visualización y usabilidad óptimas
en sus aplicaciones.

Parameters:

ParámetroTipoDescripción
new_heightintLa nueva altura.
resize_typeResizeTypeTipo de redimensionamiento.

Method: resize_height_proportionally(new_height, settings)

 resize_height_proportionally(new_height, settings) 

Redimensiona la altura proporcionalmente.

Parameters:

ParámetroTipoDescripción
new_heightintLa nueva altura.
settingsImageResizeSettingsLos 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ámetroTipoDescripción
new_heightintLa nueva altura.
settingsImageResizeSettingsLos ajustes de redimensionamiento de la imagen.

Method: resize_proportional(new_width, new_height, resize_type)

 resize_proportional(new_width, new_height, resize_type) 

Redimensiona la imagen manteniendo su relación de aspecto con este método conveniente. Ideal
para desarrolladores que buscan ajustar las dimensiones de la imagen proporcionalmente, garantizando
consistencia y preservando las proporciones del contenido original.
El redimensionado proporcional redimensionará cada fotograma según la relación de newWidth/width y newHeight/height.

Parameters:

ParámetroTipoDescripción
new_widthintEl nuevo ancho.
new_heightintLa nueva altura.
resize_typeResizeTypeEl 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ámetroTipoDescripción
new_widthintEl nuevo ancho.

Method: resize_width_proportionally(new_width, resize_type)

 resize_width_proportionally(new_width, resize_type) 

Ajusta el ancho de la imagen manteniendo su relación de aspecto con este conveniente
método. Ideal para desarrolladores que buscan redimensionar imágenes proporcionalmente, garantizando
resultados consistentes y visualmente atractivos en diferentes entornos de visualización.

Parameters:

ParámetroTipoDescripción
new_widthintEl nuevo ancho.
resize_typeResizeTypeTipo de redimensionamiento.

Method: resize_width_proportionally(new_width, settings)

 resize_width_proportionally(new_width, settings) 

Redimensiona el ancho proporcionalmente.

Parameters:

ParámetroTipoDescripción
new_widthintEl nuevo ancho.
settingsImageResizeSettingsLos 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ámetroTipoDescripción
new_widthintEl nuevo ancho.
settingsImageResizeSettingsLos ajustes de redimensionamiento de la imagen.

Method: rotate(angle)

 rotate(angle) 

Rotar la imagen alrededor del centro.

Parameters:

ParámetroTipoDescripción
anglefloatEl á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) 

Rota la imagen alrededor de su centro con este conveniente método. Ideal para desarrolladores
que buscan ajustar la orientación de la imagen dinámicamente, garantizando una presentación y
alineación óptimas dentro de sus aplicaciones.

Parameters:

ParámetroTipoDescripción
anglefloatEl ángulo de rotación en grados. Los valores positivos girarán en sentido horario.
resize_proportionallyboolsi 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_colorColorColor del fondo.

Method: rotate_flip(rotate_flip_type)

 rotate_flip(rotate_flip_type) 

Manipula fácilmente el fotograma activo rotando, volteando o realizando ambas acciones
simultáneamente con este método sencillo. Ideal para desarrolladores que necesitan
ajustar dinámicamente la orientación de fotogramas específicos dentro de sus secuencias de imágenes,
garantizando una presentación y alineación óptimas.

Parameters:

ParámetroTipoDescripción
rotate_flip_typeRotateFlipTypeEl tipo de volteo de rotación.

See also:

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

Method: rotate_flip_all(rotate_flip)

 rotate_flip_all(rotate_flip) 

Rota el volteo completo.

Parameters:

ParámetroTipoDescripción
rotate_flipRotateFlipTypeEl volteo de rotación.

Method: save(file_path)

 save(file_path) 

Guarda la imagen en la ubicación de archivo especificada.

Parameters:

ParámetroTipoDescripción
file_pathstringLa ruta del archivo donde guardar la imagen.

Method: save(file_path, options)

 save(file_path, options) 

Preserva los datos del objeto guardándolos en el archivo designado (índice + nombre de archivo)
ubicación junto con el formato de archivo y opciones especificados. Ideal para desarrolladores que buscan
almacenar datos de forma segura en varios formatos mientras mantienen flexibilidad y control sobre
los parámetros de guardado.

Parameters:

ParámetroTipoDescripción
file_pathstringLa ruta del archivo.
optionsImageOptionsBaseLas 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ámetroTipoDescripción
file_pathstringLa ruta del archivo.
optionsImageOptionsBaseLas opciones.
bounds_rectangleRectangleEl 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ámetroTipoDescripción
file_pathstringLa ruta del archivo donde guardar los datos del objeto.
sobrescribirboolsi se establece en true sobrescribe el contenido del archivo, de lo contrario se añadirá.

Method: save(stream)

 save(stream) 

Guarda los datos.

Parameters:

ParámetroTipoDescripción
flujo_io.BufferedRandomEl flujo donde guardar los datos.

Method: save(stream, options_base)

 save(stream, options_base) 

Guarda los datos de la imagen en el flujo especificado en el formato de archivo indicado según las opciones de guardado.

Parameters:

ParámetroTipoDescripción
flujo_io.BufferedRandomEl flujo donde guardar los datos de la imagen.
options_baseImageOptionsBaseLas opciones de guardado.

Method: save(stream, options_base, bounds_rectangle)

 save(stream, options_base, bounds_rectangle) 

Guarda fácilmente los datos de tu imagen en un flujo especificado en el formato de archivo deseado
usando este método conveniente. Ya sea que trabajes con JPEG, PNG u otro formato,
esta función garantiza que los datos de tu imagen se guarden de manera eficiente y precisa,
lo que la hace ideal para desarrolladores que buscan simplificar sus procesos de guardado de archivos.

Parameters:

ParámetroTipoDescripción
flujo_io.BufferedRandomEl flujo donde guardar los datos de la imagen.
options_baseImageOptionsBaseLas opciones de guardado.
bounds_rectangleRectangleEl rectángulo de límites de la imagen de destino. Establezca el rectángulo vacío para usar los límites de origen.

See also:

Example # 1: The following example loads a DICOM image from a file, then saves the image t…

Method: save_all(file_path, options)

 save_all(file_path, options) 

Preserva los datos del objeto guardándolos en el archivo designado (índice + nombre de archivo)
ubicación junto con el formato de archivo y opciones especificados. Ideal para desarrolladores que buscan
almacenar datos de forma segura en varios formatos mientras mantienen flexibilidad y control sobre
los parámetros de guardado.

Parameters:

ParámetroTipoDescripción
file_pathstringLa ruta del archivo.
optionsImageOptionsBaseLas opciones.

Method: save_argb_32_pixels(rectangle, pixels)

 save_argb_32_pixels(rectangle, pixels) 

Guarda los píxeles ARGB de 32 bits.

Parameters:

ParámetroTipoDescripción
rectangleRectangleEl rectángulo donde guardar los píxeles.
píxelesint[]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ámetroTipoDescripción
rectangleRectangleEl rectángulo donde guardar los píxeles.
píxelesint[]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ámetroTipoDescripción
rectangleRectangleEl rectángulo donde guardar los píxeles.
pixelsCmykColor[]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ámetroTipoDescripción
rectangleRectangleEl rectángulo donde guardar los píxeles.
pixelsColor[]La matriz de 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ámetroTipoDescripción
datosSystem.ByteLos datos sin procesar.
data_offsetintEl desplazamiento inicial de los datos sin procesar.
rectangleRectangleEl rectángulo de datos sin procesar.
raw_data_settingsRawDataSettingsLa 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ámetroTipoDescripción
flujo_io.BufferedRandomEl 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ámetroTipoDescripción
flujo_io.BufferedRandomEl flujo donde guardar los datos de la imagen.
options_baseImageOptionsBaseLas 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ámetroTipoDescripción
flujo_io.BufferedRandomEl flujo donde guardar los datos de la imagen.
options_baseImageOptionsBaseLas opciones de guardado.
bounds_rectangleRectangleEl 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ámetroTipoDescripción
file_pathstringLa ruta del archivo.
optionsImageOptionsBaseLas 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ámetroTipoDescripción
file_pathstringLa ruta del archivo.
optionsImageOptionsBaseLas opciones.
bounds_rectangleRectangleEl 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ámetroTipoDescripción
xintLa ubicación x del píxel.
yintLa ubicación y del píxel.
argb_32_colorintEl 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ámetroTipoDescripción
paletteIColorPaletteLa paleta a establecer.
update_colorsboolsi 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ámetroTipoDescripción
xintLa ubicación x del píxel.
yintLa ubicación y del píxel.
colorColorEl color del píxel para la posición especificada.

Method: set_resolution(dpi_x, dpi_y)

 set_resolution(dpi_x, dpi_y) 

Ajusta la resolución de este RasterImage con precisión usando este
método sencillo. Ideal para desarrolladores que buscan adaptar la resolución de la imagen a
requisitos específicos, garantizando una calidad de visualización óptima y una gestión adecuada del tamaño del archivo.

Parameters:

ParámetroTipoDescripción
dpi_xfloatLa resolución horizontal, en puntos por pulgada, del RasterImage.
dpi_yfloatLa 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ámetroTipoDescripción
metadataIImageMetadataFormatLos metadatos.

Returns

TipoDescripción
boolVerdadero 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ámetroTipoDescripción
scan_line_indexintÍndice basado en cero de la línea de escaneo.
argb_32_pixelsint[]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ámetroTipoDescripción
scan_line_indexintÍndice basado en cero de la línea de escaneo.
pixelsColor[]La matriz de colores de píxeles para escribir.

Examples

This example shows how to load a DICOM image from a file stream.

from aspose.imaging.fileformats.dicom import DicomImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_: str = "c:\\temp"
# Cargar una imagen DICOM desde un flujo de archivo.
with open(join(dir_, "sample.dicom"), "rb") as stream:
	with DicomImage(stream) as dicom_image:
		# Guardar cada página como una imagen PNG individual.
		for dicom_page in dicom_image.dicom_pages:
			# Generar un nombre de archivo basado en el índice de página.
			file_name = "sample.{0}.png".format(dicom_page.index)
			# Una página DICOM es una imagen raster, por lo que todas las operaciones permitidas con una imagen raster son aplicables a una página DICOM.
			dicom_page.save(join(dir_, file_name), PngOptions())

This example shows how to load a DICOM image from a file stream to stay within the specified memory limit.

from aspose.imaging import LoadOptions, Image
from aspose.imaging.imageoptions import PngOptions
from aspose.imaging.fileformats.dicom import DicomImage
from os.path import join as path_join


dir_: str = "c:\\temp"
# Cargar una imagen DICOM desde un flujo de archivo.
with open(path_join(dir_, "multiframe.dicom"), "rb") as stream:
	# El tamaño máximo permitido para todos los búferes internos es 256 KB.
	load_options = LoadOptions()
	load_options.buffer_size_hint = 256 * 1024
	with DicomImage(stream, load_options) as dicom_image:
		# Guardar cada página como una imagen PNG individual.
		for dicom_page in dicom_image.dicom_pages:
			# Generar un nombre de archivo basado en el índice de página.
			file_name = "multiframe.{0}.png".format(dicom_page.index)
			# Una página DICOM es una imagen raster, por lo que todas las operaciones permitidas con una imagen raster son aplicables a una página DICOM.
			dicom_page.save(path_join(dir_, file_name), PngOptions())

This example loads a DICOM 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.dicom import DicomImage
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.dicom")), DicomImage) as image:
		image.rotate_flip(rotate_flip_type)
		image.save(join(dir_, "sample." + rotate_flip_type + ".png"), PngOptions())

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


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

dir_: str = "c:\\temp"
with aspycore.as_of(Image.load(join(dir_, "sample.dicom")), DicomImage) as image:
	save_options = PngOptions()
	bounds = Rectangle(0, 0, image.width // 2, image.height // 2)
	with open(join(dir_, "output.png"), "wb") as output_stream:
		# Guardar el cuarto superior izquierdo de la imagen en un flujo de archivo.
		image.save(output_stream, save_options, bounds)

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


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


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

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

from os.path import join
import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.dicom import DicomImage
from aspose.imaging.imageoptions import PngOptions

dir_: str = r"c:\temp"
with Image.load(join(dir_, "sample.dicom")) as image:
	dicom_image = aspycore.as_of(image, DicomImage)
	# Recortar de nuevo. Establecer un margen del 10 % del tamaño de la imagen.
	horizontal_margin = dicom_image.width // 10
	vertical_margin = dicom_image.height // 10
	dicom_image.crop(horizontal_margin, horizontal_margin, vertical_margin, vertical_margin)
	# Guardar la imagen recortada en PNG.
	dicom_image.save(join(dir_, "sample.Crop.png"), PngOptions())

The following example binarizes a DICOM 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.imageoptions import PngOptions
from aspose.imaging.fileformats.dicom import DicomImage
from os.path import join

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

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


from os.path import join
import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.dicom import DicomImage
from aspose.imaging.imageoptions import PngOptions

dir_: str = "c:\\temp"
with Image.load(join(dir_, "sample.dicom")) as image:
	dicom_image = aspycore.as_of(image, DicomImage)
	# Binarizar la imagen con una diferencia de brillo de 5. El brillo es una diferencia entre un píxel y el promedio de una ventana de 10 × 10 píxeles centrada en ese píxel.
	dicom_image.binarize_bradley(5, 10)
	dicom_image.save(join(dir_, "sample.BinarizeBradley5_10x10.png"), PngOptions())

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

import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.dicom import DicomImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join


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

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


import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.dicom import DicomImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

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

The following example performs brightness correction of a DICOM image.


import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.dicom import DicomImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

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

The following example performs contrast correction of a DICOM image.


import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.dicom import DicomImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_ = "c:\\temp"
with Image.load(join(dir_, "sample.dicom")) as image:
	dicom_image = aspycore.as_of(image, DicomImage)
	# Establecer el valor de contraste. Los valores aceptados de contraste están en el rango [-100f, 100f].
	dicom_image.adjust_contrast(50.0)
	dicom_image.save(join(dir_, "sample.AdjustContrast.png"), PngOptions())

Use JPEG compression in DICOM image.

import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.imageoptions import JpegOptions, DicomOptions
from aspose.imaging.fileformats.jpeg import JpegCompressionMode, SampleRoundingMode
from aspose.imaging.imageoptions import DicomOptions
from aspose.imaging.fileformats.dicom import Compression, ColorType, CompressionType

with Image.load("original.jpg") as input_image:
	obj_init = JpegOptions()
	obj_init.compression_type = JpegCompressionMode.BASELINE
	obj_init.sample_rounding_mode = SampleRoundingMode.TRUNCATE
	obj_init.quality = 50
	obj_init2 = Compression()
	obj_init2.type = CompressionType.JPEG
	obj_init2.jpeg = obj_init
	options = DicomOptions()
	options.color_type = ColorType.RGB_24_BIT
	options.compression = obj_init2
	input_image.save("original_JPEG.dcm", options)

Use JPEG 2000 compression in DICOM image.

import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.imageoptions import Jpeg2000Options, DicomOptions
from aspose.imaging.fileformats.jpeg2000 import Jpeg2000Codec, Compression, CompressionType, ColorType

with Image.load("original.jpg") as input_image:
	obj_init = Jpeg2000Options()
	obj_init.codec = Jpeg2000Codec.JP2
	obj_init.irreversible = False
	obj_init2 = Compression()
	obj_init2.type_ = CompressionType.JPEG2000
	obj_init2.jpeg2000 = obj_init
	options = DicomOptions()
	options.color_type = ColorType.RGB_24_BIT
	options.compression = obj_init2
	input_image.save("original_JPEG2000.dcm", options)

Use RLE compression in DICOM image.


from aspose.imaging import Image
from aspose.imaging.fileformats.dicom import Compression, CompressionType, ColorType
from aspose.imaging.imageoptions import DicomOptions

with Image.load("original.jpg") as input_image:
	compr = Compression()
	compr.type_ = CompressionType.RLE
	options = DicomOptions()
	options.color_type = ColorType.RGB_24_BIT
	options.compression = compr
	input_image.save("original_RLE.dcm", options)

Change the color type in DICOM compression.


from aspose.imaging import Image
from aspose.imaging.imageoptions import DicomOptions
from aspose.imaging.fileformats.dicom import ColorType

with Image.load("original.jpg") as inputImage:
	options = DicomOptions()
	options.color_type = ColorType.GRAYSCALE_8_BIT
	inputImage.save("original_8Bit.dcm", options)