Classe 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

NameDescrizione
DicomImage(dicom_options, width, height)Inizializza una nuova istanza della classe DicomImage senza sforzo con questo
costruttore, utilizzando i parametri dicomOptions. Perfetto per gli sviluppatori che desiderano
immergersi rapidamente ed efficientemente negli oggetti DicomImage nei loro progetti.
DicomImage(stream)Crea una nuova istanza della classe DicomImage utilizzando un parametro stream
in questo costruttore. Perfetto per gli sviluppatori che cercano un modo semplificato per inizializzare
gli oggetti DicomImage da flussi di dati esistenti nei loro progetti.
DicomImage(stream, load_options)Inizia una nuova istanza della classe DicomImage in modo fluido impiegando un parametro stream e
i parametri loadOptions in questo costruttore. Ideale per gli sviluppatori desiderosi di iniziare
a lavorare con gli oggetti DicomImage rapidamente ed efficacemente nei loro progetti.

Properties

NameTypeAccessDescrizione
active_pageDicomPager/wGestisci la pagina attiva dell’immagine con questa proprietà intuitiva. Ideale per gli sviluppatori
che desiderano passare dinamicamente tra le pagine di immagini multi-pagina, garantendo una navigazione
e un’elaborazione efficienti.
active_page_indexintrRecupera l’indice della pagina attiva senza sforzo con questa proprietà intuitiva.
Ideale per gli sviluppatori che cercano un accesso rapido all’indice della pagina corrente in immagini multi-pagina,
garantendo una navigazione e un’elaborazione efficienti.
auto_adjust_paletteboolr/wOttiene o imposta un valore che indica se la palette viene regolata automaticamente.
background_colorColorr/wOttiene o imposta un valore per il colore di sfondo.
bits_per_pixelintrOttiene il conteggio dei bit per pixel dell’immagine.
boundsRectanglerOttiene i limiti dell’oggetto.
buffer_size_hintintr/wOttiene o imposta il suggerimento della dimensione del buffer, che è definito come dimensione massima consentita per tutti i buffer interni.
containerImagerOttiene il contenitore Image.
data_stream_containerStreamContainerrOttiene lo stream di dati dell’oggetto.
dicom_pagesDicomPage[]rAccedi alle pagine dell’immagine con questa proprietà intuitiva. Ideale per gli sviluppatori
che desiderano interagire con le singole pagine all’interno dell’immagine, garantendo una navigazione e una manipolazione fluide.
eliminatoboolrOttiene un valore che indica se questa istanza è stata eliminata.
exif_dataExifDatar/wOttiene o imposta l’istanza Exif.
file_formatFileFormatrRecupera il valore del formato file senza sforzo con questa proprietà intuitiva. Ideale per gli sviluppatori
che cercano un accesso rapido al formato del file immagine, garantendo una gestione e un’elaborazione efficienti in base al tipo di file.
file_infoDicomImageInforRecupera facilmente informazioni preziose dall’intestazione del file DICOM con questa
proprietà intuitiva. Ideale per gli sviluppatori che cercano un accesso rapido ai dettagli essenziali
contenuti nel file DICOM, garantendo un’estrazione e un’analisi dei dati efficienti.
has_alphaboolrRecupera se l’immagine ha un canale alfa senza sforzo con questa proprietà intuitiva.
Ideale per gli sviluppatori che desiderano determinare se l’immagine contiene informazioni sulla trasparenza,
garantendo una gestione precisa dei dati del canale alfa nelle attività di elaborazione delle immagini.
has_background_colorboolr/wOttiene o imposta un valore che indica se l’immagine ha un colore di sfondo.
has_transparent_colorboolr/wOttiene un valore che indica se l’immagine ha un colore trasparente.
heightintrOttiene l’altezza dell’immagine.
horizontal_resolutionfloatr/wOttiene o imposta la risoluzione orizzontale, in pixel per pollice, di questo RasterImage.
image_opacityfloatrOttiene l’opacità di questa immagine.
interrupt_monitorInterruptMonitorr/wOttiene o imposta il monitor di interruzione.
is_cachedboolrOttiene un valore che indica se i dati dell’immagine sono attualmente memorizzati nella cache.
is_raw_data_availableboolrOttiene un valore che indica se il caricamento dei dati grezzi è supportato.
metadataImageMetadatarOttiene o imposta i dati XMP dal fotogramma.
page_countintrRecupera il conteggio totale delle pagine dell’immagine con questa proprietà intuitiva. Ideale per gli sviluppatori
che cercano un accesso rapido al numero di pagine all’interno di un’immagine, garantendo
una navigazione e una gestione efficienti.
pagesImage[]rAccedi alle pagine dell’immagine con questa proprietà intuitiva. Ideale per gli sviluppatori
che desiderano interagire con le singole pagine all’interno dell’immagine, garantendo una navigazione fluida
e una manipolazione.
paletteIColorPaletter/wOttiene o imposta la tavolozza dei colori. La tavolozza dei colori non viene utilizzata quando i pixel sono rappresentati direttamente.
premultiply_componentsboolr/wOttiene o imposta un valore che indica se i componenti dell’immagine devono essere premoltiplicati.
raw_custom_color_converterIColorConverterr/wOttiene o imposta il convertitore di colore personalizzato
raw_data_formatPixelDataFormatrOttiene il formato dei dati grezzi.
raw_data_settingsRawDataSettingsrOttiene le impostazioni attuali dei dati grezzi. Nota che quando si usano queste impostazioni i dati vengono caricati senza conversione.
raw_fallback_indexintr/wOttiene o imposta l’indice di fallback da usare quando l’indice della tavolozza è fuori dai limiti
raw_indexed_color_converterIIndexedColorConverterr/wOttiene o imposta il convertitore di colore indicizzato
raw_line_sizeintrOttiene la dimensione della riga grezza in byte.
sizeSizerOttiene la dimensione dell’oggetto.
transparent_colorColorr/wOttiene il colore trasparente dell’immagine.
update_xmp_databoolr/wOttiene o imposta un valore che indica se aggiornare i metadati XMP.
use_paletteboolrOttiene un valore che indica se la tavolozza dell’immagine è utilizzata.
use_raw_databoolr/wOttiene o imposta un valore che indica se utilizzare il caricamento dei dati grezzi quando è disponibile.
vertical_resolutionfloatr/wOttiene o imposta la risoluzione verticale, in pixel per pollice, di questo RasterImage.
widthintrOttiene la larghezza dell’immagine.
xmp_dataXmpPacketWrapperr/wOttiene o imposta i dati Xmp.

Methods

NameDescrizione
add_page()Aggiungi una nuova pagina alla fine dell’elenco di pagine dell’immagine con questo metodo semplice.
Ideale per gli sviluppatori che desiderano espandere dinamicamente le immagini multi-pagina, garantendo un’integrazione fluida
e l’organizzazione del contenuto dell’immagine.
add_page(page)Espandi la tua collezione di immagini aggiungendo una nuova pagina con questo metodo intuitivo.
Ideale per gli sviluppatori che desiderano aggiungere dinamicamente pagine a immagini multi-pagina,
garantendo un’espansione fluida e l’organizzazione del contenuto dell’immagine.
adjust_brightness(brightness)Migliora la luminanza dell’immagine regolando la luminosità, un
metodo parametrizzato che consente agli sviluppatori di regolare finemente la luminosità delle immagini.
Questa funzione intuitiva permette agli sviluppatori di manipolare senza sforzo la
luminosità dell’immagine, offrendo flessibilità e controllo sull’estetica visiva.
adjust_contrast(contrast)Migliora il contrasto di Image con questo metodo intuitivo,
che regola la differenza tra le aree chiare e scure. Migliora la chiarezza visiva e
la definizione senza sforzo, fornendo agli sviluppatori un controllo intuitivo su
il contrasto dell’immagine per una resa ottimale.
adjust_gamma(gamma)Migliora la qualità dell’immagine e regola con la correzione gamma, una tecnica potente
per affinare l’aspetto visivo. Ideale per gli sviluppatori che desiderano ottimizzare la presentazione dell’immagine,
regolare il bilanciamento dei colori e garantire una resa coerente su diversi
dispositivi e ambienti.
adjust_gamma(gamma_red, gamma_green, gamma_blue)Ottieni regolazioni di colore precise applicando la correzione gamma in modo indipendente
ai componenti rosso, verde e blu di un’immagine. Questo metodo garantisce un bilanciamento dei colori accurato
e un output visivo ottimale, soddisfacendo gli sviluppatori che cercano un controllo granulare
sulla resa dell’immagine e sulla precisione dei colori.
analyze_percentage_digital_signature(password)Calcola la percentuale di somiglianza tra i dati estratti e la password originale.
auto_brightness_contrast()Esegue la normalizzazione automatica adattiva di luminosità e contrasto per l’intera immagine.
auto_rotate()Ruota automaticamente l’immagine in base ai dati di orientamento estratti dai metadati Exif
. Questo metodo garantisce che le immagini vengano visualizzate nella corretta orientazione,
migliorando l’esperienza dell’utente ed eliminando la necessità di regolazioni manuali. Analizzando le informazioni Exif, l’immagine viene ruotata di conseguenza, fornendo un’esperienza di visualizzazione fluida
su diverse piattaforme e dispositivi. Questo processo di rotazione automatizzata
semplifica la gestione delle immagini e migliora l’usabilità complessiva, soprattutto quando
si lavora con grandi lotti di immagini con orientamenti variabili.
binarize_bradley(brightness_difference)Binarizzazione di un’immagine usando l’algoritmo di sogliatura adattiva di Bradley con la sogliatura dell’immagine integrale
binarize_bradley(brightness_difference, window_size)Binarizza le immagini con l’algoritmo di sogliatura adattiva di Bradley, sfruttando la sogliatura dell’immagine integrale per prestazioni migliorate. Ideale per gli sviluppatori che desiderano
segmentare automaticamente le immagini in base alle variazioni locali di luminosità, garantendo
un rilevamento e un’estrazione accurati degli oggetti in condizioni di illuminazione variabili.
binarize_fixed(threshold)Converti facilmente l’immagine in un formato binario usando una soglia predefinita
con questo metodo semplice. Ideale per gli sviluppatori che desiderano semplificare le attività di elaborazione delle immagini segmentando l’immagine in componenti di primo piano e sfondo
in base ai livelli di intensità specificati.
binarize_otsu()Applica la sogliatura Otsu per binarizzare l’immagine, determinando automaticamente il valore di soglia ottimale
basato sull’istogramma dell’immagine. Perfetto per gli sviluppatori che cercano
un metodo affidabile per segmentare le immagini in regioni di primo piano e sfondo con
un intervento manuale minimo.
blend(origin, overlay, overlay_alpha)Unisce questa istanza di immagine con l’immagine overlay.
blend(origin, overlay, overlay_area, overlay_alpha)Unisce questa istanza di immagine con l’immagine overlay.
cache_data()Questo metodo memorizza i dati in cache in modo efficiente, ottimizzando le prestazioni e garantendo un accesso rapido
quando necessario. Ideale per gli sviluppatori che desiderano migliorare la velocità e l’efficienza delle loro
applicazioni gestendo in modo intelligente le risorse dei dati.
can_load(file_path)Determina se l’immagine può essere caricata dal percorso file specificato.
can_load(file_path, load_options)Determina se l’immagine può essere caricata dal percorso file specificato e, opzionalmente, utilizzando le opzioni di apertura specificate.
can_load(stream)Determina se l’immagine può essere caricata dallo stream specificato.
can_load(stream, load_options)Determina se l’immagine può essere caricata dallo stream specificato e, opzionalmente, utilizzando le loadOptions specificate.
can_load_stream(stream)Determina se l’immagine può essere caricata dallo stream specificato.
can_load_stream_with_options(stream, load_options)Determina se l’immagine può essere caricata dallo stream specificato e, opzionalmente, utilizzando le loadOptions specificate.
can_load_with_options(file_path, load_options)Determina se l’immagine può essere caricata dal percorso file specificato e, opzionalmente, utilizzando le opzioni di apertura specificate.
can_save(options)Determina se l’immagine può essere salvata nel formato file specificato rappresentato dalle opzioni di salvataggio fornite.
create(files)Crea l’immagine multipagina contenente i file specificati.
create(files, throw_exception_on_load_error)Crea l’immagine multipagina contenente i file specificati.
create(image_options, width, height)Crea una nuova immagine utilizzando le opzioni di creazione specificate.
create(image_options, width, height, pixels)Crea un’istanza di RasterImage dall’array di pixel fornito.

Convalida che la larghezza e l’altezza specificate corrispondano alle dimensioni dei dati pixel.
Questo metodo può essere usato solo quando la libreria è in modalità Licensed.
create(images)Crea una nuova immagine utilizzando le immagini specificate come pagine
create(images, dispose_images)Crea una nuova immagine dalle immagini specificate come pagine.
create(multipage_create_options)Crea le opzioni di creazione multipagina specificate.
create_from_files(files)Crea l’immagine multipagina contenente i file specificati come pagine a caricamento differito.
create_from_files(files, throw_exception_on_load_error)Crea l’immagine multipagina contenente i file specificati come pagine a caricamento differito.
create_from_images(images)Crea una nuova immagine utilizzando le immagini specificate come pagine
create_from_images(images, dispose_images)Crea una nuova immagine dalle immagini specificate come pagine.
crop(left_shift, right_shift, top_shift, bottom_shift)Regola l’area di ritaglio dell’immagine applicando spostamenti con questo metodo versatile.
Perfetto per gli sviluppatori che necessitano di un controllo preciso sul processo di ritaglio, garantendo
che i dettagli importanti vengano conservati eliminando gli elementi superflui.
crop(rectangle)Ritaglia l’immagine per rimuovere le aree indesiderate e concentrarti sul contenuto essenziale con questo
metodo semplice. Ideale per gli sviluppatori che desiderano personalizzare la composizione visiva delle
immagini, assicurando che trasmettano il messaggio desiderato in modo efficace.
dither(dithering_method, bits_count)Esegue il dithering sull’immagine corrente.
dither(dithering_method, bits_count, custom_palette)Migliora l’immagine corrente applicando effetti di dithering con questo metodo diretto
. Perfetto per gli sviluppatori che vogliono aggiungere texture e profondità alle immagini,
migliorandone la qualità visiva e l’appeal complessivo.
embed_digital_signature(password)Incorpora la firma digitale basata sulla password fornita in ogni pagina dell’immagine.
filter(rectangle, options)Migliora senza sforzo aree specifiche della tua immagine applicando filtri a rettangoli designati
. Questo metodo offre agli sviluppatori un controllo preciso sulla
manipolazione dell’immagine, consentendo regolazioni mirate per ottenere gli effetti
visivi desiderati con facilità.
get_argb_32_pixel(x, y)Ottiene un pixel ARGB a 32 bit dell’immagine.
get_default_argb_32_pixels(rectangle)Ottiene l’array predefinito di pixel ARGB a 32 bit.
get_default_options(args)Ottiene le opzioni predefinite.
get_default_pixels(rectangle, partial_pixel_loader)Ottiene l’array predefinito di pixel usando il caricatore di pixel parziale.
get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings)Ottiene l’array predefinito di dati grezzi usando il caricatore di pixel parziale.
get_default_raw_data(rectangle, raw_data_settings)Ottiene l’array predefinito di dati grezzi.
get_file_format(file_path)Ottiene il formato del file.
get_file_format(stream)Ottiene il formato del file.
get_file_format_of_stream(stream)Ottiene il formato del file.
get_fitting_rectangle(rectangle, pixels, width, height)Ottiene il rettangolo che si adatta all’immagine corrente.
get_fitting_rectangle(rectangle, width, height)Ottiene il rettangolo che si adatta all’immagine corrente.
get_modify_date(use_default)Ottiene la data e l’ora dell’ultima modifica dell’immagine di risorsa.
get_original_options()Ottiene le opzioni basate sulle impostazioni originali del file.
Questo può essere utile per mantenere inalterata la profondità di bit e altri parametri dell’immagine originale.
Ad esempio, se carichiamo un’immagine PNG in bianco e nero a 1 bit per pixel e poi la salviamo usando il
metodo DataStreamSupporter.save(file_path), verrà generata un’immagine PNG di output a 8 bit per pixel.
Per evitarlo e salvare l’immagine PNG a 1 bit per pixel, utilizza questo metodo per ottenere le opzioni di salvataggio corrispondenti e passale
al metodo Image.save(file_path, options) come secondo parametro.
get_pixel(x, y)Ottiene un pixel dell’immagine.
get_proportional_height(width, height, new_width)Ottiene un’altezza proporzionale.
get_proportional_width(width, height, new_height)Ottiene una larghezza proporzionale.
get_serialized_stream(image_options, clipping_rectangle, page_number)Converte in aps.
get_skew_angle()Ottiene l’angolo di inclinazione.
Questo metodo è applicabile ai documenti di testo scansionati, per determinare l’angolo di inclinazione durante la scansione.
grayscale()Trasforma facilmente le immagini nella loro rappresentazione in scala di grigi, semplificando l’analisi visiva
e le attività di elaborazione. Perfetto per gli sviluppatori che desiderano migliorare la chiarezza delle immagini,
ridurre la complessità e facilitare algoritmi efficienti basati sulla scala di grigi
per diverse applicazioni.
insert_page(page_index)Inserisci una nuova pagina nell’elenco delle pagine dell’immagine a un indice specificato con questo metodo intuitivo
. Ideale per gli sviluppatori che cercano un controllo preciso sulla disposizione delle pagine in
immagini multi-pagina, garantendo un’organizzazione fluida e la personalizzazione del contenuto dell’immagine.
is_digital_signed(password, percentage_threshold)Esegue un rapido controllo per determinare se l’immagine è firmata digitalmente, utilizzando la password e la soglia fornite.
load(file_path)Carica una nuova immagine dal percorso file o URL specificato.
Se filePath è un percorso file, il metodo apre semplicemente il file.
Se filePath è un URL, il metodo scarica il file, lo memorizza temporaneamente e lo apre.
load(file_path, load_options)Carica una nuova immagine dal percorso file o URL specificato.
Se filePath è un percorso file, il metodo apre semplicemente il file.
Se filePath è un URL, il metodo scarica il file, lo memorizza temporaneamente e lo apre.
load(stream)Carica una nuova immagine dallo stream specificato.
load(stream, load_options)Carica una nuova immagine dallo stream specificato.
load_argb_32_pixels(rectangle)Carica pixel ARGB a 32 bit.
load_argb_64_pixels(rectangle)Carica pixel ARGB a 64 bit.
load_cmyk_32_pixels(rectangle)Carica pixel in formato CMYK.
load_cmyk_pixels(rectangle)Carica pixel in formato CMYK.
Questo metodo è deprecato. Si prega di utilizzare il metodo più efficace RasterImage.load_cmyk_32_pixels(rectangle).
load_partial_argb_32_pixels(rectangle, partial_pixel_loader)Carica parzialmente pixel ARGB a 32 bit (per blocchi).
load_partial_argb_64_pixels(rectangle, partial_pixel_loader)Carica parzialmente pixel ARGB a 64 bit per pacchetti.
load_partial_pixels(desired_rectangle, pixel_loader)Carica pixel parzialmente per pacchetti.
load_pixels(rectangle)Carica pixel.
load_raw_data(rectangle, dest_image_bounds, raw_data_settings, raw_data_loader)Carica dati grezzi.
load_raw_data(rectangle, raw_data_settings, raw_data_loader)Carica dati grezzi.
load_stream(stream)Carica una nuova immagine dallo stream specificato.
load_stream_with_options(stream, load_options)Carica una nuova immagine dallo stream specificato.
load_with_options(file_path, load_options)Carica una nuova immagine dal percorso file o URL specificato.
Se filePath è un percorso file, il metodo apre semplicemente il file.
Se filePath è un URL, il metodo scarica il file, lo memorizza temporaneamente e lo apre.
normalize_angle()Normalizza l’angolo.
Questo metodo è applicabile ai documenti di testo scansionati per eliminare la scansione inclinata.
Questo metodo utilizza i metodi RasterImage.get_skew_angle() e RasterImage.rotate(angle).
normalize_angle(resize_proportionally, background_color)Normalizza l’angolo.
Questo metodo è applicabile ai documenti di testo scansionati per eliminare la scansione inclinata.
Questo metodo utilizza i metodi RasterImage.get_skew_angle() e RasterCachedMultipageImage.rotate(angle, resize_proportionally, background_color).
normalize_histogram()Normalizza l’istogramma dell’immagine — regola i valori dei pixel per utilizzare l’intera gamma disponibile.
read_argb_32_scan_line(scan_line_index)Legge l’intera linea di scansione tramite l’indice di linea di scansione specificato.
read_scan_line(scan_line_index)Legge l’intera linea di scansione tramite l’indice di linea di scansione specificato.
remove_metadata()Rimuove i metadati di questa istanza immagine impostando il valore di IHasXmpData.xmp_data a None.
remove_page(page_index)Elimina la pagina all’indice specificato dall’elenco delle pagine con questo metodo comodo.
Ideale per gli sviluppatori che cercano un controllo preciso sulla gestione delle immagini multi-pagina,
garantendo un’organizzazione fluida e la personalizzazione del contenuto dell’immagine.
replace_argb(old_color_argb, old_color_diff, new_color_argb)Sostituisce un colore con un altro con differenza consentita e preserva il valore alfa originale per mantenere bordi lisci.
replace_color(old_color, old_color_diff, new_color)Sostituisce un colore con un altro con differenza consentita e preserva il valore alfa originale per mantenere bordi lisci.
replace_color(old_color_argb, old_color_diff, new_color_argb)Sostituisce un colore con un altro con differenza consentita e preserva il valore alfa originale per mantenere bordi lisci.
replace_non_transparent_colors(new_color)Sostituisce tutti i colori non trasparenti con un nuovo colore e preserva il valore alfa originale per mantenere bordi lisci.
Nota: se lo utilizzi su immagini senza trasparenza, tutti i colori saranno sostituiti con un unico colore.
replace_non_transparent_colors(new_color_argb)Sostituisce tutti i colori non trasparenti con un nuovo colore e preserva il valore alfa originale per mantenere bordi lisci.
Nota: se lo utilizzi su immagini senza trasparenza, tutti i colori saranno sostituiti con un unico colore.
resize(new_width, new_height)Ridimensiona l’immagine. Viene utilizzato il valore predefinito ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.
resize(new_width, new_height, resize_type)Ridimensiona l’immagine mantenendo il suo rapporto d’aspetto con questo metodo comodo. Ideale
per gli sviluppatori che desiderano regolare le dimensioni dell’immagine proporzionalmente, garantendo
coerenza e preservando le proporzioni del contenuto originale.
Il ridimensionamento proporzionale ridimensionerà ogni fotogramma secondo il rapporto newWidth/width e newHeight/height.
resize(new_width, new_height, settings)Regola le dimensioni della tua immagine con questo semplice metodo di ridimensionamento. Che tu debba
ridurre o ingrandire la tua immagine, questa funzione garantisce che le tue esigenze di ridimensionamento siano soddisfatte
in modo efficiente e preciso, rendendola perfetta per gli sviluppatori che cercano regolazioni rapide e facili
delle dimensioni dell’immagine.
resize_by_settings(new_width, new_height, settings)Ridimensiona l’immagine.
resize_by_type(new_width, new_height, resize_type)Ridimensiona l’immagine.
resize_height_proportionally(new_height)Ridimensiona l’altezza proporzionalmente. Viene utilizzato il valore predefinito ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.
resize_height_proportionally(new_height, resize_type)Regola l’altezza dell’immagine mantenendo il suo rapporto d’aspetto con questo
metodo intuitivo. Perfetto per gli sviluppatori che desiderano ridimensionare dinamicamente le immagini
preservandone le proporzioni, garantendo una visualizzazione ottimale e usabilità
nelle loro applicazioni.
resize_height_proportionally(new_height, settings)Ridimensiona l’altezza proporzionalmente.
resize_height_proportionally_settings(new_height, settings)Ridimensiona l’altezza proporzionalmente.
resize_proportional(new_width, new_height, resize_type)Ridimensiona l’immagine mantenendo il suo rapporto d’aspetto con questo metodo comodo. Ideale
per gli sviluppatori che desiderano regolare le dimensioni dell’immagine proporzionalmente, garantendo
coerenza e preservando le proporzioni del contenuto originale.
Il ridimensionamento proporzionale ridimensionerà ogni fotogramma secondo il rapporto newWidth/width e newHeight/height.
resize_width_proportionally(new_width)Ridimensiona la larghezza proporzionalmente. Viene utilizzato il valore predefinito ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.
resize_width_proportionally(new_width, resize_type)Regola la larghezza dell’immagine mantenendo il suo rapporto d’aspetto con questo pratico
metodo. Ideale per gli sviluppatori che desiderano ridimensionare le immagini proporzionalmente, garantendo
risultati coerenti e visivamente gradevoli su diversi ambienti di visualizzazione.
resize_width_proportionally(new_width, settings)Ridimensiona la larghezza proporzionalmente.
resize_width_proportionally_settings(new_width, settings)Ridimensiona la larghezza proporzionalmente.
rotate(angle)Ruota l’immagine attorno al centro.
rotate(angle, resize_proportionally, background_color)Ruota l’immagine attorno al suo centro con questo metodo pratico. Ideale per gli sviluppatori
che desiderano regolare l’orientamento dell’immagine dinamicamente, garantendo una presentazione ottimale e
allineamento all’interno delle loro applicazioni.
rotate_flip(rotate_flip_type)Manipola facilmente il fotogramma attivo ruotando, capovolgendo o eseguendo entrambe le azioni
simultaneamente con questo metodo semplice. Ideale per gli sviluppatori che devono
regolare dinamicamente l’orientamento di fotogrammi specifici all’interno delle loro sequenze di immagini,
garantendo una presentazione e un allineamento ottimali.
rotate_flip_all(rotate_flip)Ruota il flip completo.
save()Salva i dati dell’immagine nello stream sottostante.
save(file_path)Salva l’immagine nella posizione file specificata.
save(file_path, options)Conserva i dati dell’oggetto salvandoli nel file designato (indice + nome file)
nella posizione indicata insieme al formato file e alle opzioni specificate. Ideale per gli sviluppatori che desiderano
archiviare in modo sicuro i dati in vari formati mantenendo flessibilità e controllo sui
parametri di salvataggio.
save(file_path, options, bounds_rectangle)Salva i dati dell’oggetto nella posizione file specificata nel formato file indicato secondo le opzioni di salvataggio.
save(file_path, over_write)Salva i dati dell’oggetto nella posizione file specificata.
save(stream)Salva i dati.
save(stream, options_base)Salva i dati dell’immagine nello stream specificato nel formato file indicato secondo le opzioni di salvataggio.
save(stream, options_base, bounds_rectangle)Salva facilmente i dati della tua immagine in uno stream specificato nel formato file desiderato
utilizzando questo metodo pratico. Che tu stia lavorando con JPEG, PNG o un altro formato,
questa funzione garantisce che i dati dell’immagine vengano salvati in modo efficiente e preciso,
rendendola ideale per gli sviluppatori che desiderano semplificare i loro processi di salvataggio dei file.
save_all(file_path, options)Conserva i dati dell’oggetto salvandoli nel file designato (indice + nome file)
nella posizione indicata insieme al formato file e alle opzioni specificate. Ideale per gli sviluppatori che desiderano
archiviare in modo sicuro i dati in vari formati mantenendo flessibilità e controllo sui
parametri di salvataggio.
save_argb_32_pixels(rectangle, pixels)Salva i pixel ARGB a 32 bit.
save_cmyk_32_pixels(rectangle, pixels)Salva i pixel.
save_cmyk_pixels(rectangle, pixels)Salva i pixel.
Questo metodo è deprecato. Si prega di utilizzare in modo più efficace il metodo RasterImage.save_cmyk_32_pixels(rectangle, pixels).
save_pixels(rectangle, pixels)Salva i pixel (metodo specifico del formato).
save_raw_data(data, data_offset, rectangle, raw_data_settings)Salva i dati grezzi.
save_to_stream(stream)Salva i dati dell’oggetto nello stream specificato.
save_to_stream_with_options(stream, options_base)Salva i dati dell’immagine nello stream specificato nel formato file indicato secondo le opzioni di salvataggio.
save_to_stream_with_options_rect(stream, options_base, bounds_rectangle)Salva i dati dell’immagine nello stream specificato nel formato file indicato secondo le opzioni di salvataggio.
save_with_options(file_path, options)Salva i dati dell’oggetto nella posizione file specificata nel formato file indicato secondo le opzioni di salvataggio.
save_with_options_rect(file_path, options, bounds_rectangle)Salva i dati dell’oggetto nella posizione file specificata nel formato file indicato secondo le opzioni di salvataggio.
set_argb_32_pixel(x, y, argb_32_color)Imposta un pixel immagine a 32 bit ARGB per la posizione specificata.
set_palette(palette, update_colors)Imposta la tavolozza dell’immagine.
set_pixel(x, y, color)Imposta un pixel dell’immagine per la posizione specificata.
set_resolution(dpi_x, dpi_y)Regola la risoluzione di questo RasterImage con precisione utilizzando questo
metodo semplice. Ideale per gli sviluppatori che desiderano personalizzare la risoluzione dell’immagine per
requisiti specifici, garantendo una qualità di visualizzazione ottimale e una gestione della dimensione del file.
try_set_metadata(metadata)Cerca di impostare un’istanza metadata, se questa istanza di Image supporta e implementa l’istanza IImageMetadataFormat.
write_argb_32_scan_line(scan_line_index, argb_32_pixels)Scrive l’intera riga di scansione all’indice di riga di scansione specificato.
write_scan_line(scan_line_index, pixels)Scrive l’intera riga di scansione all’indice di riga di scansione specificato.

Constructor: DicomImage(dicom_options, width, height)

 DicomImage(dicom_options, width, height) 

Inizializza una nuova istanza della classe DicomImage senza sforzo con questo
costruttore, utilizzando i parametri dicomOptions. Perfetto per gli sviluppatori che desiderano
immergersi rapidamente ed efficientemente negli oggetti DicomImage nei loro progetti.

Parameters:

ParametroTipoDescrizione
dicom_optionsDicomOptionsLe opzioni DICOM.
widthintLa larghezza.
heightintL’altezza.

Constructor: DicomImage(stream)

 DicomImage(stream) 

Crea una nuova istanza della classe DicomImage utilizzando un parametro stream
in questo costruttore. Perfetto per gli sviluppatori che cercano un modo semplificato per inizializzare
gli oggetti DicomImage da flussi di dati esistenti nei loro progetti.

Parameters:

ParametroTipoDescrizione
stream_io.BufferedRandomLo stream.

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) 

Inizia una nuova istanza della classe DicomImage in modo fluido impiegando un parametro stream e
i parametri loadOptions in questo costruttore. Ideale per gli sviluppatori desiderosi di iniziare
a lavorare con gli oggetti DicomImage rapidamente ed efficacemente nei loro progetti.

Parameters:

ParametroTipoDescrizione
stream_io.BufferedRandomLo stream.
load_optionsLoadOptionsLe opzioni di caricamento.

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

Aggiungi una nuova pagina alla fine dell’elenco di pagine dell’immagine con questo metodo semplice.
Ideale per gli sviluppatori che desiderano espandere dinamicamente le immagini multi-pagina, garantendo un’integrazione fluida
e l’organizzazione del contenuto dell’immagine.

Returns

TipoDescrizione
DicomPageLa nuova DicomPage creata.

Method: add_page(page)

 add_page(page) 

Espandi la tua collezione di immagini aggiungendo una nuova pagina con questo metodo intuitivo.
Ideale per gli sviluppatori che desiderano aggiungere dinamicamente pagine a immagini multi-pagina,
garantendo un’espansione fluida e l’organizzazione del contenuto dell’immagine.

Parameters:

ParametroTipoDescrizione
pageRasterImageLa pagina da aggiungere.

Method: adjust_brightness(brightness)

 adjust_brightness(brightness) 

Migliora la luminanza dell’immagine regolando la luminosità, un
metodo parametrizzato che consente agli sviluppatori di regolare finemente la luminosità delle immagini.
Questa funzione intuitiva permette agli sviluppatori di manipolare senza sforzo la
luminosità dell’immagine, offrendo flessibilità e controllo sull’estetica visiva.

Parameters:

ParametroTipoDescrizione
luminositàintValore di luminosità.

See also:

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

Method: adjust_contrast(contrast)

 adjust_contrast(contrast) 

Migliora il contrasto di Image con questo metodo intuitivo,
che regola la differenza tra le aree chiare e scure. Migliora la chiarezza visiva e
la definizione senza sforzo, fornendo agli sviluppatori un controllo intuitivo su
il contrasto dell’immagine per una resa ottimale.

Parameters:

ParametroTipoDescrizione
contrastofloatValore di contrasto (nell’intervallo [-100; 100])

See also:

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

Method: adjust_gamma(gamma)

 adjust_gamma(gamma) 

Migliora la qualità dell’immagine e regola con la correzione gamma, una tecnica potente
per affinare l’aspetto visivo. Ideale per gli sviluppatori che desiderano ottimizzare la presentazione dell’immagine,
regolare il bilanciamento dei colori e garantire una resa coerente su diversi
dispositivi e ambienti.

Parameters:

ParametroTipoDescrizione
gammafloatCoefficiente gamma per i canali rosso, verde e blu

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) 

Ottieni regolazioni di colore precise applicando la correzione gamma in modo indipendente
ai componenti rosso, verde e blu di un’immagine. Questo metodo garantisce un bilanciamento dei colori accurato
e un output visivo ottimale, soddisfacendo gli sviluppatori che cercano un controllo granulare
sulla resa dell’immagine e sulla precisione dei colori.

Parameters:

ParametroTipoDescrizione
gamma_redfloatCoefficiente gamma per il canale rosso
gamma_greenfloatCoefficiente gamma per il canale verde
gamma_bluefloatGamma per il coefficiente del canale blu

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) 

Calcola la percentuale di somiglianza tra i dati estratti e la password originale.

Parameters:

ParametroTipoDescrizione
passwordstringLa password utilizzata per estrarre i dati incorporati.

Returns

TipoDescrizione
intIl valore percentuale di similarità.

Method: binarize_bradley(brightness_difference)

 binarize_bradley(brightness_difference) 

Binarizzazione di un’immagine usando l’algoritmo di sogliatura adattiva di Bradley con la sogliatura dell’immagine integrale

Parameters:

ParametroTipoDescrizione
brightness_differencefloatLa differenza di luminosità tra il pixel e la media di una finestra di pixel s x s
centrata attorno a questo pixel.

Method: binarize_bradley(brightness_difference, window_size)

 binarize_bradley(brightness_difference, window_size) 

Binarizza le immagini con l’algoritmo di sogliatura adattiva di Bradley, sfruttando la sogliatura dell’immagine integrale per prestazioni migliorate. Ideale per gli sviluppatori che desiderano
segmentare automaticamente le immagini in base alle variazioni locali di luminosità, garantendo
un rilevamento e un’estrazione accurati degli oggetti in condizioni di illuminazione variabili.

Parameters:

ParametroTipoDescrizione
brightness_differencefloatLa differenza di luminosità tra il pixel e la media di una finestra di pixel s x s
centrata attorno a questo pixel.
window_sizeintLa dimensione della finestra di pixel s x s centrata attorno a questo pixel

See also:

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

Method: binarize_fixed(threshold)

 binarize_fixed(threshold) 

Converti facilmente l’immagine in un formato binario usando una soglia predefinita
con questo metodo semplice. Ideale per gli sviluppatori che desiderano semplificare le attività di elaborazione delle immagini segmentando l’immagine in componenti di primo piano e sfondo
in base ai livelli di intensità specificati.

Parameters:

ParametroTipoDescrizione
sogliaSystem.ByteValore di soglia. Se il valore grigio corrispondente di un pixel è maggiore della soglia, verrà assegnato a esso un valore di
255, altrimenti 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) 

Unisce questa istanza di immagine con l’immagine overlay.

Parameters:

ParametroTipoDescrizione
originPointL’origine della fusione dell’immagine di sfondo.
overlayRasterImageL’immagine di sovrapposizione.
overlay_alphaSystem.ByteL’alpha della sovrapposizione.

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

 blend(origin, overlay, overlay_area, overlay_alpha) 

Unisce questa istanza di immagine con l’immagine overlay.

Parameters:

ParametroTipoDescrizione
originPointL’origine della fusione dell’immagine di sfondo.
overlayRasterImageL’immagine di sovrapposizione.
overlay_areaRectangleL’area di sovrapposizione.
overlay_alphaSystem.ByteL’alpha della sovrapposizione.

Method: can_load(file_path) [static]

 can_load(file_path) 

Determina se l’immagine può essere caricata dal percorso file specificato.

Parameters:

ParametroTipoDescrizione
file_pathstringIl percorso del file.

Returns

TipoDescrizione
booltrue se l’immagine può essere caricata dal file specificato; altrimenti, false.

Method: can_load(file_path, load_options) [static]

 can_load(file_path, load_options) 

Determina se l’immagine può essere caricata dal percorso file specificato e, opzionalmente, utilizzando le opzioni di apertura specificate.

Parameters:

ParametroTipoDescrizione
file_pathstringIl percorso del file.
load_optionsLoadOptionsLe opzioni di caricamento.

Returns

TipoDescrizione
booltrue se l’immagine può essere caricata dal file specificato; altrimenti, false.

Method: can_load(stream) [static]

 can_load(stream) 

Determina se l’immagine può essere caricata dallo stream specificato.

Parameters:

ParametroTipoDescrizione
stream_io.BufferedRandomIl flusso da cui caricare.

Returns

TipoDescrizione
booltrue se l’immagine può essere caricata dal flusso specificato; altrimenti, false.

Method: can_load(stream, load_options) [static]

 can_load(stream, load_options) 

Determina se l’immagine può essere caricata dallo stream specificato e, opzionalmente, utilizzando le loadOptions specificate.

Parameters:

ParametroTipoDescrizione
stream_io.BufferedRandomIl flusso da cui caricare.
load_optionsLoadOptionsLe opzioni di caricamento.

Returns

TipoDescrizione
booltrue se l’immagine può essere caricata dal flusso specificato; altrimenti, false.

Method: can_load_stream(stream) [static]

 can_load_stream(stream) 

Determina se l’immagine può essere caricata dallo stream specificato.

Parameters:

ParametroTipoDescrizione
stream_io.BufferedRandomIl flusso da cui caricare.

Returns

TipoDescrizione
booltrue se l’immagine può essere caricata dal flusso specificato; altrimenti, false.

Method: can_load_stream_with_options(stream, load_options) [static]

 can_load_stream_with_options(stream, load_options) 

Determina se l’immagine può essere caricata dallo stream specificato e, opzionalmente, utilizzando le loadOptions specificate.

Parameters:

ParametroTipoDescrizione
stream_io.BufferedRandomIl flusso da cui caricare.
load_optionsLoadOptionsLe opzioni di caricamento.

Returns

TipoDescrizione
booltrue se l’immagine può essere caricata dal flusso specificato; altrimenti, false.

Method: can_load_with_options(file_path, load_options) [static]

 can_load_with_options(file_path, load_options) 

Determina se l’immagine può essere caricata dal percorso file specificato e, opzionalmente, utilizzando le opzioni di apertura specificate.

Parameters:

ParametroTipoDescrizione
file_pathstringIl percorso del file.
load_optionsLoadOptionsLe opzioni di caricamento.

Returns

TipoDescrizione
booltrue se l’immagine può essere caricata dal file specificato; altrimenti, false.

Method: can_save(options)

 can_save(options) 

Determina se l’immagine può essere salvata nel formato file specificato rappresentato dalle opzioni di salvataggio fornite.

Parameters:

ParametroTipoDescrizione
optionsImageOptionsBaseLe opzioni di salvataggio da utilizzare.

Returns

TipoDescrizione
booltrue se l’immagine può essere salvata nel formato di file specificato rappresentato dalle opzioni di salvataggio fornite; altrimenti, false.

Method: create(files) [static]

 create(files) 

Crea l’immagine multipagina contenente i file specificati.

Parameters:

ParametroTipoDescrizione
filestring[]I file.

Returns

TipoDescrizione
ImageL’immagine multipagina

Method: create(files, throw_exception_on_load_error) [static]

 create(files, throw_exception_on_load_error) 

Crea l’immagine multipagina contenente i file specificati.

Parameters:

ParametroTipoDescrizione
filestring[]I file.
throw_exception_on_load_errorboolse impostato su true [throw exception on load error].

Returns

TipoDescrizione
ImageL’immagine multipagina

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

 create(image_options, width, height) 

Crea una nuova immagine utilizzando le opzioni di creazione specificate.

Parameters:

ParametroTipoDescrizione
image_optionsImageOptionsBaseLe opzioni dell’immagine.
widthintLa larghezza.
heightintL’altezza.

Returns

TipoDescrizione
ImageL’immagine appena creata.

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

 create(image_options, width, height, pixels) 

Crea un’istanza di RasterImage dall’array di pixel fornito.

Convalida che la larghezza e l’altezza specificate corrispondano alle dimensioni dei dati pixel.
Questo metodo può essere usato solo quando la libreria è in modalità Licensed.

Parameters:

ParametroTipoDescrizione
image_optionsImageOptionsBaseLe opzioni utilizzate per creare il RasterImage.
widthintLa larghezza del RasterImage.
heightintL’altezza del RasterImage.
pixelint[]L’array di valori dei pixel usato per popolare l’immagine.

Returns

TipoDescrizione
ImageUna RasterImage popolata con i dati dei pixel forniti.

Method: create(images) [static]

 create(images) 

Crea una nuova immagine utilizzando le immagini specificate come pagine

Parameters:

ParametroTipoDescrizione
imagesImage[]Le immagini.

Returns

TipoDescrizione
ImageL’Image come IMultipageImage

Method: create(images, dispose_images) [static]

 create(images, dispose_images) 

Crea una nuova immagine dalle immagini specificate come pagine.

Parameters:

ParametroTipoDescrizione
imagesImage[]Le immagini.
dispose_imagesboolse impostato su true [dispose images].

Returns

TipoDescrizione
ImageL’Image come IMultipageImage

Method: create(multipage_create_options) [static]

 create(multipage_create_options) 

Crea le opzioni di creazione multipagina specificate.

Parameters:

ParametroTipoDescrizione
multipage_create_optionsMultipageCreateOptionsLe opzioni di creazione multipagina.

Returns

TipoDescrizione
ImageL’immagine multipagina

Method: create_from_files(files) [static]

 create_from_files(files) 

Crea l’immagine multipagina contenente i file specificati come pagine a caricamento differito.

Parameters:

ParametroTipoDescrizione
filestring[]I file.

Returns

TipoDescrizione
ImageL’immagine multipagina

Method: create_from_files(files, throw_exception_on_load_error) [static]

 create_from_files(files, throw_exception_on_load_error) 

Crea l’immagine multipagina contenente i file specificati come pagine a caricamento differito.

Parameters:

ParametroTipoDescrizione
filestring[]I file.
throw_exception_on_load_errorboolse impostato su true lancia un’eccezione in caso di errore di caricamento.

Returns

TipoDescrizione
ImageL’immagine multipagina

Method: create_from_images(images) [static]

 create_from_images(images) 

Crea una nuova immagine utilizzando le immagini specificate come pagine

Parameters:

ParametroTipoDescrizione
imagesImage[]Le immagini.

Returns

TipoDescrizione
ImageL’Image come IMultipageImage

Method: create_from_images(images, dispose_images) [static]

 create_from_images(images, dispose_images) 

Crea una nuova immagine dalle immagini specificate come pagine.

Parameters:

ParametroTipoDescrizione
imagesImage[]Le immagini.
dispose_imagesboolse impostato su true [dispose images].

Returns

TipoDescrizione
ImageL’Image come IMultipageImage

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

 crop(left_shift, right_shift, top_shift, bottom_shift) 

Regola l’area di ritaglio dell’immagine applicando spostamenti con questo metodo versatile.
Perfetto per gli sviluppatori che necessitano di un controllo preciso sul processo di ritaglio, garantendo
che i dettagli importanti vengano conservati eliminando gli elementi superflui.

Parameters:

ParametroTipoDescrizione
left_shiftintLo shift a sinistra.
right_shiftintLo shift a destra.
top_shiftintLo shift superiore.
bottom_shiftintLo shift inferiore.

See also:

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

Method: crop(rectangle)

 crop(rectangle) 

Ritaglia l’immagine per rimuovere le aree indesiderate e concentrarti sul contenuto essenziale con questo
metodo semplice. Ideale per gli sviluppatori che desiderano personalizzare la composizione visiva delle
immagini, assicurando che trasmettano il messaggio desiderato in modo efficace.

Parameters:

ParametroTipoDescrizione
rectangleRectangleIl rettangolo.

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) 

Esegue il dithering sull’immagine corrente.

Parameters:

ParametroTipoDescrizione
dithering_methodDitheringMethodIl metodo di dithering.
bits_countintIl conteggio finale dei bit per il dithering.

Method: dither(dithering_method, bits_count, custom_palette)

 dither(dithering_method, bits_count, custom_palette) 

Migliora l’immagine corrente applicando effetti di dithering con questo metodo diretto
. Perfetto per gli sviluppatori che vogliono aggiungere texture e profondità alle immagini,
migliorandone la qualità visiva e l’appeal complessivo.

Parameters:

ParametroTipoDescrizione
dithering_methodDitheringMethodIl metodo di dithering.
bits_countintIl conteggio finale dei bit per il dithering.
custom_paletteIColorPaletteLa palette personalizzata per il dithering.

Method: embed_digital_signature(password)

 embed_digital_signature(password) 

Incorpora la firma digitale basata sulla password fornita in ogni pagina dell’immagine.

Parameters:

ParametroTipoDescrizione
passwordstringLa password usata per generare i dati della firma digitale.

Method: filter(rectangle, options)

 filter(rectangle, options) 

Migliora senza sforzo aree specifiche della tua immagine applicando filtri a rettangoli designati
. Questo metodo offre agli sviluppatori un controllo preciso sulla
manipolazione dell’immagine, consentendo regolazioni mirate per ottenere gli effetti
visivi desiderati con facilità.

Parameters:

ParametroTipoDescrizione
rectangleRectangleIl rettangolo.
optionsFilterOptionsBaseLe opzioni.

Method: get_argb_32_pixel(x, y)

 get_argb_32_pixel(x, y) 

Ottiene un pixel ARGB a 32 bit dell’immagine.

Parameters:

ParametroTipoDescrizione
xintLa posizione x del pixel.
yintLa posizione y del pixel.

Returns

TipoDescrizione
intIl pixel ARGB a 32 bit per la posizione specificata.

Method: get_default_argb_32_pixels(rectangle)

 get_default_argb_32_pixels(rectangle) 

Ottiene l’array predefinito di pixel ARGB a 32 bit.

Parameters:

ParametroTipoDescrizione
rectangleRectangleIl rettangolo per cui ottenere i pixel.

Returns

TipoDescrizione
int[]L’array predefinito di pixel.

Method: get_default_options(args)

 get_default_options(args) 

Ottiene le opzioni predefinite.

Parameters:

ParametroTipoDescrizione
argsSystem.ObjectGli argomenti.

Returns

TipoDescrizione
ImageOptionsBaseOpzioni predefinite

Method: get_default_pixels(rectangle, partial_pixel_loader)

 get_default_pixels(rectangle, partial_pixel_loader) 

Ottiene l’array predefinito di pixel usando il caricatore di pixel parziale.

Parameters:

ParametroTipoDescrizione
rectangleRectangleIl rettangolo per cui ottenere i pixel.
partial_pixel_loaderIPartialArgb32PixelLoaderIl caricatore parziale di pixel.

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) 

Ottiene l’array predefinito di dati grezzi usando il caricatore di pixel parziale.

Parameters:

ParametroTipoDescrizione
rectangleRectangleIl rettangolo per cui ottenere i pixel.
partial_raw_data_loaderIPartialRawDataLoaderIl caricatore parziale di dati grezzi.
raw_data_settingsRawDataSettingsLe impostazioni dei dati grezzi.

Method: get_default_raw_data(rectangle, raw_data_settings)

 get_default_raw_data(rectangle, raw_data_settings) 

Ottiene l’array predefinito di dati grezzi.

Parameters:

ParametroTipoDescrizione
rectangleRectangleIl rettangolo per cui ottenere i dati grezzi.
raw_data_settingsRawDataSettingsLe impostazioni dei dati grezzi.

Returns

TipoDescrizione
System.ByteL’array predefinito di dati grezzi.

Method: get_file_format(file_path) [static]

 get_file_format(file_path) 

Ottiene il formato del file.

Parameters:

ParametroTipoDescrizione
file_pathstringIl percorso del file.

Returns

TipoDescrizione
FileFormatIl formato file determinato.

Method: get_file_format(stream) [static]

 get_file_format(stream) 

Ottiene il formato del file.

Parameters:

ParametroTipoDescrizione
stream_io.BufferedRandomLo stream.

Returns

TipoDescrizione
FileFormatIl formato file determinato.

Method: get_file_format_of_stream(stream) [static]

 get_file_format_of_stream(stream) 

Ottiene il formato del file.

Parameters:

ParametroTipoDescrizione
stream_io.BufferedRandomLo stream.

Returns

TipoDescrizione
FileFormatIl formato file determinato.

Method: get_fitting_rectangle(rectangle, pixels, width, height) [static]

 get_fitting_rectangle(rectangle, pixels, width, height) 

Ottiene il rettangolo che si adatta all’immagine corrente.

Parameters:

ParametroTipoDescrizione
rectangleRectangleIl rettangolo per cui ottenere il rettangolo di adattamento.
pixelint[]I pixel ARGB a 32 bit.
widthintLa larghezza dell’oggetto.
heightintL’altezza dell’oggetto.

Returns

TipoDescrizione
RectangleIl rettangolo di adattamento o un’eccezione se non è possibile trovare un rettangolo di adattamento.

Method: get_fitting_rectangle(rectangle, width, height) [static]

 get_fitting_rectangle(rectangle, width, height) 

Ottiene il rettangolo che si adatta all’immagine corrente.

Parameters:

ParametroTipoDescrizione
rectangleRectangleIl rettangolo per cui ottenere il rettangolo di adattamento.
widthintLa larghezza dell’oggetto.
heightintL’altezza dell’oggetto.

Returns

TipoDescrizione
RectangleIl rettangolo di adattamento o un’eccezione se non è possibile trovare un rettangolo di adattamento.

Method: get_modify_date(use_default)

 get_modify_date(use_default) 

Ottiene la data e l’ora dell’ultima modifica dell’immagine di risorsa.

Parameters:

ParametroTipoDescrizione
use_defaultboolse impostato su true utilizza le informazioni da FileInfo come valore predefinito.

Returns

TipoDescrizione
System.DateTimeLa data e l’ora in cui l’immagine della risorsa è stata modificata l’ultima volta.

Method: get_original_options()

 get_original_options() 

Ottiene le opzioni basate sulle impostazioni originali del file.
Questo può essere utile per mantenere inalterata la profondità di bit e altri parametri dell’immagine originale.
Ad esempio, se carichiamo un’immagine PNG in bianco e nero a 1 bit per pixel e poi la salviamo usando il
metodo DataStreamSupporter.save(file_path), verrà generata un’immagine PNG di output a 8 bit per pixel.
Per evitarlo e salvare l’immagine PNG a 1 bit per pixel, utilizza questo metodo per ottenere le opzioni di salvataggio corrispondenti e passale
al metodo Image.save(file_path, options) come secondo parametro.

Returns

TipoDescrizione
ImageOptionsBaseLe opzioni basate sulle impostazioni del file originale.

Method: get_pixel(x, y)

 get_pixel(x, y) 

Ottiene un pixel dell’immagine.

Parameters:

ParametroTipoDescrizione
xintLa posizione x del pixel.
yintLa posizione y del pixel.

Returns

TipoDescrizione
ColorIl colore del pixel per la posizione specificata.

Method: get_proportional_height(width, height, new_width) [static]

 get_proportional_height(width, height, new_width) 

Ottiene un’altezza proporzionale.

Parameters:

ParametroTipoDescrizione
widthintLa larghezza.
heightintL’altezza.
new_widthintLa nuova larghezza.

Returns

TipoDescrizione
intL’altezza proporzionale.

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

 get_proportional_width(width, height, new_height) 

Ottiene una larghezza proporzionale.

Parameters:

ParametroTipoDescrizione
widthintLa larghezza.
heightintL’altezza.
new_heightintLa nuova altezza.

Returns

TipoDescrizione
intLa larghezza proporzionale.

Method: get_serialized_stream(image_options, clipping_rectangle, page_number)

 get_serialized_stream(image_options, clipping_rectangle, page_number) 

Converte in aps.

Parameters:

ParametroTipoDescrizione
image_optionsImageOptionsBaseLe opzioni dell’immagine.
clipping_rectangleRectangleIl rettangolo di ritaglio.
page_numberint[]Il numero di pagina.

Returns

TipoDescrizione
_io.BufferedRandomIl flusso serializzato

Method: get_skew_angle()

 get_skew_angle() 

Ottiene l’angolo di inclinazione.
Questo metodo è applicabile ai documenti di testo scansionati, per determinare l’angolo di inclinazione durante la scansione.

Returns

TipoDescrizione
floatL’angolo di inclinazione, in gradi.

Method: insert_page(page_index)

 insert_page(page_index) 

Inserisci una nuova pagina nell’elenco delle pagine dell’immagine a un indice specificato con questo metodo intuitivo
. Ideale per gli sviluppatori che cercano un controllo preciso sulla disposizione delle pagine in
immagini multi-pagina, garantendo un’organizzazione fluida e la personalizzazione del contenuto dell’immagine.

Parameters:

ParametroTipoDescrizione
page_indexintIndice della pagina.

Returns

TipoDescrizione
DicomPageLa nuova DicomPage creata.

Method: is_digital_signed(password, percentage_threshold)

 is_digital_signed(password, percentage_threshold) 

Esegue un rapido controllo per determinare se l’immagine è firmata digitalmente, utilizzando la password e la soglia fornite.

Parameters:

ParametroTipoDescrizione
passwordstringLa password per verificare la firma.
percentage_thresholdintLa soglia (in percentuale)[0-100] che determina se l’immagine è considerata firmata.
Se non specificata, verrà applicata una soglia predefinita (75).

Returns

TipoDescrizione
boolVero se l’immagine è firmata, altrimenti falso.

Method: load(file_path) [static]

 load(file_path) 

Carica una nuova immagine dal percorso file o URL specificato.
Se filePath è un percorso file, il metodo apre semplicemente il file.
Se filePath è un URL, il metodo scarica il file, lo memorizza temporaneamente e lo apre.

Parameters:

ParametroTipoDescrizione
file_pathstringIl percorso file o l’URL da cui caricare l’immagine.

Returns

TipoDescrizione
ImageL’immagine caricata.

Method: load(file_path, load_options) [static]

 load(file_path, load_options) 

Carica una nuova immagine dal percorso file o URL specificato.
Se filePath è un percorso file, il metodo apre semplicemente il file.
Se filePath è un URL, il metodo scarica il file, lo memorizza temporaneamente e lo apre.

Parameters:

ParametroTipoDescrizione
file_pathstringIl percorso file o l’URL da cui caricare l’immagine.
load_optionsLoadOptionsLe opzioni di caricamento.

Returns

TipoDescrizione
ImageL’immagine caricata.

Method: load(stream) [static]

 load(stream) 

Carica una nuova immagine dallo stream specificato.

Parameters:

ParametroTipoDescrizione
stream_io.BufferedRandomIl flusso da cui caricare l’immagine.

Returns

TipoDescrizione
ImageL’immagine caricata.

Method: load(stream, load_options) [static]

 load(stream, load_options) 

Carica una nuova immagine dallo stream specificato.

Parameters:

ParametroTipoDescrizione
stream_io.BufferedRandomIl flusso da cui caricare l’immagine.
load_optionsLoadOptionsLe opzioni di caricamento.

Returns

TipoDescrizione
ImageL’immagine caricata.

Method: load_argb_32_pixels(rectangle)

 load_argb_32_pixels(rectangle) 

Carica pixel ARGB a 32 bit.

Parameters:

ParametroTipoDescrizione
rectangleRectangleIl rettangolo da cui caricare i pixel.

Returns

TipoDescrizione
int[]L’array di pixel ARGB a 32 bit caricato.

Method: load_argb_64_pixels(rectangle)

 load_argb_64_pixels(rectangle) 

Carica pixel ARGB a 64 bit.

Parameters:

ParametroTipoDescrizione
rectangleRectangleIl rettangolo da cui caricare i pixel.

Returns

TipoDescrizione
int[]L’array di pixel ARGB a 64 bit caricato.

Method: load_cmyk_32_pixels(rectangle)

 load_cmyk_32_pixels(rectangle) 

Carica pixel in formato CMYK.

Parameters:

ParametroTipoDescrizione
rectangleRectangleIl rettangolo da cui caricare i pixel.

Returns

TipoDescrizione
int[]L’array di pixel CMYK caricato presentato come valori interi a 32 bit.

Method: load_cmyk_pixels(rectangle)

 load_cmyk_pixels(rectangle) 

Carica pixel in formato CMYK.
Questo metodo è deprecato. Si prega di utilizzare il metodo più efficace RasterImage.load_cmyk_32_pixels(rectangle).

Parameters:

ParametroTipoDescrizione
rectangleRectangleIl rettangolo da cui caricare i pixel.

Returns

TipoDescrizione
CmykColor[]L’array di pixel CMYK caricato.

Method: load_partial_argb_32_pixels(rectangle, partial_pixel_loader)

 load_partial_argb_32_pixels(rectangle, partial_pixel_loader) 

Carica parzialmente pixel ARGB a 32 bit (per blocchi).

Parameters:

ParametroTipoDescrizione
rectangleRectangleIl rettangolo da cui caricare i pixel.
partial_pixel_loaderIPartialArgb32PixelLoaderIl caricatore parziale di pixel.

Method: load_partial_argb_64_pixels(rectangle, partial_pixel_loader)

 load_partial_argb_64_pixels(rectangle, partial_pixel_loader) 

Carica parzialmente pixel ARGB a 64 bit per pacchetti.

Parameters:

ParametroTipoDescrizione
rectangleRectangleIl rettangolo desiderato.
partial_pixel_loaderIPartialArgb64PixelLoaderIl caricatore di pixel ARGB a 64 bit.

Method: load_partial_pixels(desired_rectangle, pixel_loader)

 load_partial_pixels(desired_rectangle, pixel_loader) 

Carica pixel parzialmente per pacchetti.

Parameters:

ParametroTipoDescrizione
desired_rectangleRectangleIl rettangolo desiderato.
pixel_loaderIPartialPixelLoaderIl caricatore di pixel.

Method: load_pixels(rectangle)

 load_pixels(rectangle) 

Carica pixel.

Parameters:

ParametroTipoDescrizione
rectangleRectangleIl rettangolo da cui caricare i pixel.

Returns

TipoDescrizione
Color[]L’array di pixel caricato.

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) 

Carica dati grezzi.

Parameters:

ParametroTipoDescrizione
rectangleRectangleIl rettangolo da cui caricare i dati grezzi.
dest_image_boundsRectangleI limiti dell’immagine di destinazione.
raw_data_settingsRawDataSettingsLe impostazioni dei dati grezzi da utilizzare per i dati caricati. Nota che se i dati non sono nel formato specificato, verrà eseguita la conversione dei dati.
raw_data_loaderIPartialRawDataLoaderIl caricatore di dati grezzi.

Method: load_raw_data(rectangle, raw_data_settings, raw_data_loader)

 load_raw_data(rectangle, raw_data_settings, raw_data_loader) 

Carica dati grezzi.

Parameters:

ParametroTipoDescrizione
rectangleRectangleIl rettangolo da cui caricare i dati grezzi.
raw_data_settingsRawDataSettingsLe impostazioni dei dati grezzi da utilizzare per i dati caricati. Nota che se i dati non sono nel formato specificato, verrà eseguita la conversione dei dati.
raw_data_loaderIPartialRawDataLoaderIl caricatore di dati grezzi.

Method: load_stream(stream) [static]

 load_stream(stream) 

Carica una nuova immagine dallo stream specificato.

Parameters:

ParametroTipoDescrizione
stream_io.BufferedRandomIl flusso da cui caricare l’immagine.

Returns

TipoDescrizione
ImageL’immagine caricata.

Method: load_stream_with_options(stream, load_options) [static]

 load_stream_with_options(stream, load_options) 

Carica una nuova immagine dallo stream specificato.

Parameters:

ParametroTipoDescrizione
stream_io.BufferedRandomIl flusso da cui caricare l’immagine.
load_optionsLoadOptionsLe opzioni di caricamento.

Returns

TipoDescrizione
ImageL’immagine caricata.

Method: load_with_options(file_path, load_options) [static]

 load_with_options(file_path, load_options) 

Carica una nuova immagine dal percorso file o URL specificato.
Se filePath è un percorso file, il metodo apre semplicemente il file.
Se filePath è un URL, il metodo scarica il file, lo memorizza temporaneamente e lo apre.

Parameters:

ParametroTipoDescrizione
file_pathstringIl percorso file o l’URL da cui caricare l’immagine.
load_optionsLoadOptionsLe opzioni di caricamento.

Returns

TipoDescrizione
ImageL’immagine caricata.

Method: normalize_angle(resize_proportionally, background_color)

 normalize_angle(resize_proportionally, background_color) 

Normalizza l’angolo.
Questo metodo è applicabile ai documenti di testo scansionati per eliminare la scansione inclinata.
Questo metodo utilizza i metodi RasterImage.get_skew_angle() e RasterCachedMultipageImage.rotate(angle, resize_proportionally, background_color).

Parameters:

ParametroTipoDescrizione
resize_proportionallyboolse impostato su true la dimensione dell’immagine verrà modificata in base alle proiezioni del rettangolo ruotato (punti d’angolo); altrimenti le dimensioni rimarranno inalterate e solo il contenuto interno dell’immagine verrà ruotato.
background_colorColorColore dello sfondo.

Method: read_argb_32_scan_line(scan_line_index)

 read_argb_32_scan_line(scan_line_index) 

Legge l’intera linea di scansione tramite l’indice di linea di scansione specificato.

Parameters:

ParametroTipoDescrizione
scan_line_indexintIndice basato su zero della riga di scansione.

Returns

TipoDescrizione
int[]L’array dei valori di colore ARGB a 32 bit della riga di scansione.

Method: read_scan_line(scan_line_index)

 read_scan_line(scan_line_index) 

Legge l’intera linea di scansione tramite l’indice di linea di scansione specificato.

Parameters:

ParametroTipoDescrizione
scan_line_indexintIndice basato su zero della riga di scansione.

Returns

TipoDescrizione
Color[]L’array dei valori di colore dei pixel della riga di scansione.

Method: remove_page(page_index)

 remove_page(page_index) 

Elimina la pagina all’indice specificato dall’elenco delle pagine con questo metodo comodo.
Ideale per gli sviluppatori che cercano un controllo preciso sulla gestione delle immagini multi-pagina,
garantendo un’organizzazione fluida e la personalizzazione del contenuto dell’immagine.

Parameters:

ParametroTipoDescrizione
page_indexintIndice della pagina.

Method: replace_argb(old_color_argb, old_color_diff, new_color_argb)

 replace_argb(old_color_argb, old_color_diff, new_color_argb) 

Sostituisce un colore con un altro con differenza consentita e preserva il valore alfa originale per mantenere bordi lisci.

Parameters:

ParametroTipoDescrizione
old_color_argbintValore ARGB del colore vecchio da sostituire.
old_color_diffSystem.ByteDifferenza consentita nel colore vecchio per poter ampliare la tonalità del colore sostituito.
new_color_argbintNuovo valore ARGB del colore per sostituire il colore vecchio.

Method: replace_color(old_color, old_color_diff, new_color)

 replace_color(old_color, old_color_diff, new_color) 

Sostituisce un colore con un altro con differenza consentita e preserva il valore alfa originale per mantenere bordi lisci.

Parameters:

ParametroTipoDescrizione
old_colorColor
old_color_diffSystem.ByteDifferenza consentita nel colore vecchio per poter ampliare la tonalità del colore sostituito.
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) 

Sostituisce un colore con un altro con differenza consentita e preserva il valore alfa originale per mantenere bordi lisci.

Parameters:

ParametroTipoDescrizione
old_color_argbintValore ARGB del colore vecchio da sostituire.
old_color_diffSystem.ByteDifferenza consentita nel colore vecchio per poter ampliare la tonalità del colore sostituito.
new_color_argbintNuovo valore ARGB del colore per sostituire il colore vecchio.

Method: replace_non_transparent_colors(new_color)

 replace_non_transparent_colors(new_color) 

Sostituisce tutti i colori non trasparenti con un nuovo colore e preserva il valore alfa originale per mantenere bordi lisci.
Nota: se lo utilizzi su immagini senza trasparenza, tutti i colori saranno sostituiti con un unico colore.

Parameters:

ParametroTipoDescrizione
new_colorColor

Method: replace_non_transparent_colors(new_color_argb)

 replace_non_transparent_colors(new_color_argb) 

Sostituisce tutti i colori non trasparenti con un nuovo colore e preserva il valore alfa originale per mantenere bordi lisci.
Nota: se lo utilizzi su immagini senza trasparenza, tutti i colori saranno sostituiti con un unico colore.

Parameters:

ParametroTipoDescrizione
new_color_argbintNuovo valore ARGB del colore per sostituire i colori non trasparenti.

Method: resize(new_width, new_height)

 resize(new_width, new_height) 

Ridimensiona l’immagine. Viene utilizzato il valore predefinito ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.

Parameters:

ParametroTipoDescrizione
new_widthintLa nuova larghezza.
new_heightintLa nuova altezza.

Method: resize(new_width, new_height, resize_type)

 resize(new_width, new_height, resize_type) 

Ridimensiona l’immagine mantenendo il suo rapporto d’aspetto con questo metodo comodo. Ideale
per gli sviluppatori che desiderano regolare le dimensioni dell’immagine proporzionalmente, garantendo
coerenza e preservando le proporzioni del contenuto originale.
Il ridimensionamento proporzionale ridimensionerà ogni fotogramma secondo il rapporto newWidth/width e newHeight/height.

Parameters:

ParametroTipoDescrizione
new_widthintLa nuova larghezza.
new_heightintLa nuova altezza.
resize_typeResizeTypeIl tipo di ridimensionamento.

Method: resize(new_width, new_height, settings)

 resize(new_width, new_height, settings) 

Regola le dimensioni della tua immagine con questo semplice metodo di ridimensionamento. Che tu debba
ridurre o ingrandire la tua immagine, questa funzione garantisce che le tue esigenze di ridimensionamento siano soddisfatte
in modo efficiente e preciso, rendendola perfetta per gli sviluppatori che cercano regolazioni rapide e facili
delle dimensioni dell’immagine.

Parameters:

ParametroTipoDescrizione
new_widthintLa nuova larghezza.
new_heightintLa nuova altezza.
settingsImageResizeSettingsLe impostazioni di ridimensionamento.

Method: resize_by_settings(new_width, new_height, settings)

 resize_by_settings(new_width, new_height, settings) 

Ridimensiona l’immagine.

Parameters:

ParametroTipoDescrizione
new_widthintLa nuova larghezza.
new_heightintLa nuova altezza.
settingsImageResizeSettingsLe impostazioni di ridimensionamento.

Method: resize_by_type(new_width, new_height, resize_type)

 resize_by_type(new_width, new_height, resize_type) 

Ridimensiona l’immagine.

Parameters:

ParametroTipoDescrizione
new_widthintLa nuova larghezza.
new_heightintLa nuova altezza.
resize_typeResizeTypeIl tipo di ridimensionamento.

Method: resize_height_proportionally(new_height)

 resize_height_proportionally(new_height) 

Ridimensiona l’altezza proporzionalmente. Viene utilizzato il valore predefinito ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.

Parameters:

ParametroTipoDescrizione
new_heightintLa nuova altezza.

Method: resize_height_proportionally(new_height, resize_type)

 resize_height_proportionally(new_height, resize_type) 

Regola l’altezza dell’immagine mantenendo il suo rapporto d’aspetto con questo
metodo intuitivo. Perfetto per gli sviluppatori che desiderano ridimensionare dinamicamente le immagini
preservandone le proporzioni, garantendo una visualizzazione ottimale e usabilità
nelle loro applicazioni.

Parameters:

ParametroTipoDescrizione
new_heightintLa nuova altezza.
resize_typeResizeTypeTipo di ridimensionamento.

Method: resize_height_proportionally(new_height, settings)

 resize_height_proportionally(new_height, settings) 

Ridimensiona l’altezza proporzionalmente.

Parameters:

ParametroTipoDescrizione
new_heightintLa nuova altezza.
settingsImageResizeSettingsLe impostazioni di ridimensionamento dell’immagine.

Method: resize_height_proportionally_settings(new_height, settings)

 resize_height_proportionally_settings(new_height, settings) 

Ridimensiona l’altezza proporzionalmente.

Parameters:

ParametroTipoDescrizione
new_heightintLa nuova altezza.
settingsImageResizeSettingsLe impostazioni di ridimensionamento dell’immagine.

Method: resize_proportional(new_width, new_height, resize_type)

 resize_proportional(new_width, new_height, resize_type) 

Ridimensiona l’immagine mantenendo il suo rapporto d’aspetto con questo metodo comodo. Ideale
per gli sviluppatori che desiderano regolare le dimensioni dell’immagine proporzionalmente, garantendo
coerenza e preservando le proporzioni del contenuto originale.
Il ridimensionamento proporzionale ridimensionerà ogni fotogramma secondo il rapporto newWidth/width e newHeight/height.

Parameters:

ParametroTipoDescrizione
new_widthintLa nuova larghezza.
new_heightintLa nuova altezza.
resize_typeResizeTypeIl tipo di ridimensionamento.

Method: resize_width_proportionally(new_width)

 resize_width_proportionally(new_width) 

Ridimensiona la larghezza proporzionalmente. Viene utilizzato il valore predefinito ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.

Parameters:

ParametroTipoDescrizione
new_widthintLa nuova larghezza.

Method: resize_width_proportionally(new_width, resize_type)

 resize_width_proportionally(new_width, resize_type) 

Regola la larghezza dell’immagine mantenendo il suo rapporto d’aspetto con questo pratico
metodo. Ideale per gli sviluppatori che desiderano ridimensionare le immagini proporzionalmente, garantendo
risultati coerenti e visivamente gradevoli su diversi ambienti di visualizzazione.

Parameters:

ParametroTipoDescrizione
new_widthintLa nuova larghezza.
resize_typeResizeTypeTipo di ridimensionamento.

Method: resize_width_proportionally(new_width, settings)

 resize_width_proportionally(new_width, settings) 

Ridimensiona la larghezza proporzionalmente.

Parameters:

ParametroTipoDescrizione
new_widthintLa nuova larghezza.
settingsImageResizeSettingsLe impostazioni di ridimensionamento dell’immagine.

Method: resize_width_proportionally_settings(new_width, settings)

 resize_width_proportionally_settings(new_width, settings) 

Ridimensiona la larghezza proporzionalmente.

Parameters:

ParametroTipoDescrizione
new_widthintLa nuova larghezza.
settingsImageResizeSettingsLe impostazioni di ridimensionamento dell’immagine.

Method: rotate(angle)

 rotate(angle) 

Ruota l’immagine attorno al centro.

Parameters:

ParametroTipoDescrizione
anglefloatL’angolo di rotazione in gradi. I valori positivi ruoteranno in senso orario.

Method: rotate(angle, resize_proportionally, background_color)

 rotate(angle, resize_proportionally, background_color) 

Ruota l’immagine attorno al suo centro con questo metodo pratico. Ideale per gli sviluppatori
che desiderano regolare l’orientamento dell’immagine dinamicamente, garantendo una presentazione ottimale e
allineamento all’interno delle loro applicazioni.

Parameters:

ParametroTipoDescrizione
anglefloatL’angolo di rotazione in gradi. I valori positivi ruoteranno in senso orario.
resize_proportionallyboolse impostato su true la dimensione dell’immagine verrà modificata
in base alle proiezioni del rettangolo ruotato (punti d’angolo) in altri
casi, lasciando le dimensioni inalterate e solo
i contenuti dell’immagine internal verranno ruotati.
background_colorColorColore dello sfondo.

Method: rotate_flip(rotate_flip_type)

 rotate_flip(rotate_flip_type) 

Manipola facilmente il fotogramma attivo ruotando, capovolgendo o eseguendo entrambe le azioni
simultaneamente con questo metodo semplice. Ideale per gli sviluppatori che devono
regolare dinamicamente l’orientamento di fotogrammi specifici all’interno delle loro sequenze di immagini,
garantendo una presentazione e un allineamento ottimali.

Parameters:

ParametroTipoDescrizione
rotate_flip_typeRotateFlipTypeIl tipo di rotazione e capovolgimento.

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) 

Ruota il flip completo.

Parameters:

ParametroTipoDescrizione
rotate_flipRotateFlipTypeLa rotazione e capovolgimento.

Method: save(file_path)

 save(file_path) 

Salva l’immagine nella posizione file specificata.

Parameters:

ParametroTipoDescrizione
file_pathstringIl percorso file in cui salvare l’immagine.

Method: save(file_path, options)

 save(file_path, options) 

Conserva i dati dell’oggetto salvandoli nel file designato (indice + nome file)
nella posizione indicata insieme al formato file e alle opzioni specificate. Ideale per gli sviluppatori che desiderano
archiviare in modo sicuro i dati in vari formati mantenendo flessibilità e controllo sui
parametri di salvataggio.

Parameters:

ParametroTipoDescrizione
file_pathstringIl percorso del file.
optionsImageOptionsBaseLe opzioni.

Method: save(file_path, options, bounds_rectangle)

 save(file_path, options, bounds_rectangle) 

Salva i dati dell’oggetto nella posizione file specificata nel formato file indicato secondo le opzioni di salvataggio.

Parameters:

ParametroTipoDescrizione
file_pathstringIl percorso del file.
optionsImageOptionsBaseLe opzioni.
bounds_rectangleRectangleIl rettangolo dei limiti dell’immagine di destinazione. Imposta il rettangolo vuoto per utilizzare i limiti della sorgente.

Method: save(file_path, over_write)

 save(file_path, over_write) 

Salva i dati dell’oggetto nella posizione file specificata.

Parameters:

ParametroTipoDescrizione
file_pathstringIl percorso file in cui salvare i dati dell’oggetto.
over_writeboolse impostato su true sovrascrive il contenuto del file, altrimenti verrà effettuata un’aggiunta.

Method: save(stream)

 save(stream) 

Salva i dati.

Parameters:

ParametroTipoDescrizione
stream_io.BufferedRandomIl flusso in cui salvare i dati.

Method: save(stream, options_base)

 save(stream, options_base) 

Salva i dati dell’immagine nello stream specificato nel formato file indicato secondo le opzioni di salvataggio.

Parameters:

ParametroTipoDescrizione
stream_io.BufferedRandomIl flusso in cui salvare i dati dell’immagine.
options_baseImageOptionsBaseLe opzioni di salvataggio.

Method: save(stream, options_base, bounds_rectangle)

 save(stream, options_base, bounds_rectangle) 

Salva facilmente i dati della tua immagine in uno stream specificato nel formato file desiderato
utilizzando questo metodo pratico. Che tu stia lavorando con JPEG, PNG o un altro formato,
questa funzione garantisce che i dati dell’immagine vengano salvati in modo efficiente e preciso,
rendendola ideale per gli sviluppatori che desiderano semplificare i loro processi di salvataggio dei file.

Parameters:

ParametroTipoDescrizione
stream_io.BufferedRandomIl flusso in cui salvare i dati dell’immagine.
options_baseImageOptionsBaseLe opzioni di salvataggio.
bounds_rectangleRectangleIl rettangolo dei limiti dell’immagine di destinazione. Imposta il rettangolo vuoto per utilizzare i limiti della sorgente.

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) 

Conserva i dati dell’oggetto salvandoli nel file designato (indice + nome file)
nella posizione indicata insieme al formato file e alle opzioni specificate. Ideale per gli sviluppatori che desiderano
archiviare in modo sicuro i dati in vari formati mantenendo flessibilità e controllo sui
parametri di salvataggio.

Parameters:

ParametroTipoDescrizione
file_pathstringIl percorso del file.
optionsImageOptionsBaseLe opzioni.

Method: save_argb_32_pixels(rectangle, pixels)

 save_argb_32_pixels(rectangle, pixels) 

Salva i pixel ARGB a 32 bit.

Parameters:

ParametroTipoDescrizione
rectangleRectangleIl rettangolo in cui salvare i pixel.
pixelint[]L’array di pixel ARGB a 32 bit.

Method: save_cmyk_32_pixels(rectangle, pixels)

 save_cmyk_32_pixels(rectangle, pixels) 

Salva i pixel.

Parameters:

ParametroTipoDescrizione
rectangleRectangleIl rettangolo in cui salvare i pixel.
pixelint[]I pixel CMYK presentati come valori interi a 32 bit.

Method: save_cmyk_pixels(rectangle, pixels)

 save_cmyk_pixels(rectangle, pixels) 

Salva i pixel.
Questo metodo è deprecato. Si prega di utilizzare in modo più efficace il metodo RasterImage.save_cmyk_32_pixels(rectangle, pixels).

Parameters:

ParametroTipoDescrizione
rectangleRectangleIl rettangolo in cui salvare i pixel.
pixelsCmykColor[]L’array di pixel CMYK.

Method: save_pixels(rectangle, pixels)

 save_pixels(rectangle, pixels) 

Salva i pixel (metodo specifico del formato).

Parameters:

ParametroTipoDescrizione
rectangleRectangleIl rettangolo in cui salvare i pixel.
pixelsColor[]L’array di pixel.

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

 save_raw_data(data, data_offset, rectangle, raw_data_settings) 

Salva i dati grezzi.

Parameters:

ParametroTipoDescrizione
datiSystem.ByteI dati grezzi.
data_offsetintL’offset iniziale dei dati grezzi.
rectangleRectangleIl rettangolo dei dati grezzi.
raw_data_settingsRawDataSettingsLe impostazioni dei dati grezzi in cui si trovano i dati.

Method: save_to_stream(stream)

 save_to_stream(stream) 

Salva i dati dell’oggetto nello stream specificato.

Parameters:

ParametroTipoDescrizione
stream_io.BufferedRandomIl flusso in cui salvare i dati dell’oggetto.

Method: save_to_stream_with_options(stream, options_base)

 save_to_stream_with_options(stream, options_base) 

Salva i dati dell’immagine nello stream specificato nel formato file indicato secondo le opzioni di salvataggio.

Parameters:

ParametroTipoDescrizione
stream_io.BufferedRandomIl flusso in cui salvare i dati dell’immagine.
options_baseImageOptionsBaseLe opzioni di salvataggio.

Method: save_to_stream_with_options_rect(stream, options_base, bounds_rectangle)

 save_to_stream_with_options_rect(stream, options_base, bounds_rectangle) 

Salva i dati dell’immagine nello stream specificato nel formato file indicato secondo le opzioni di salvataggio.

Parameters:

ParametroTipoDescrizione
stream_io.BufferedRandomIl flusso in cui salvare i dati dell’immagine.
options_baseImageOptionsBaseLe opzioni di salvataggio.
bounds_rectangleRectangleIl rettangolo dei limiti dell’immagine di destinazione. Imposta il rettangolo vuoto per utilizzare i limiti della sorgente.

Method: save_with_options(file_path, options)

 save_with_options(file_path, options) 

Salva i dati dell’oggetto nella posizione file specificata nel formato file indicato secondo le opzioni di salvataggio.

Parameters:

ParametroTipoDescrizione
file_pathstringIl percorso del file.
optionsImageOptionsBaseLe opzioni.

Method: save_with_options_rect(file_path, options, bounds_rectangle)

 save_with_options_rect(file_path, options, bounds_rectangle) 

Salva i dati dell’oggetto nella posizione file specificata nel formato file indicato secondo le opzioni di salvataggio.

Parameters:

ParametroTipoDescrizione
file_pathstringIl percorso del file.
optionsImageOptionsBaseLe opzioni.
bounds_rectangleRectangleIl rettangolo dei limiti dell’immagine di destinazione. Imposta il rettangolo vuoto per utilizzare i limiti della sorgente.

Method: set_argb_32_pixel(x, y, argb_32_color)

 set_argb_32_pixel(x, y, argb_32_color) 

Imposta un pixel immagine a 32 bit ARGB per la posizione specificata.

Parameters:

ParametroTipoDescrizione
xintLa posizione x del pixel.
yintLa posizione y del pixel.
argb_32_colorintIl pixel ARGB a 32 bit per la posizione specificata.

Method: set_palette(palette, update_colors)

 set_palette(palette, update_colors) 

Imposta la tavolozza dell’immagine.

Parameters:

ParametroTipoDescrizione
paletteIColorPaletteLa tavolozza da impostare.
update_colorsboolse impostato su true i colori verranno aggiornati secondo la nuova tavolozza; altrimenti gli indici dei colori rimarranno invariati. Nota che gli indici invariati possono causare il crash dell’immagine al caricamento se alcuni indici non hanno voci corrispondenti nella tavolozza.

Method: set_pixel(x, y, color)

 set_pixel(x, y, color) 

Imposta un pixel dell’immagine per la posizione specificata.

Parameters:

ParametroTipoDescrizione
xintLa posizione x del pixel.
yintLa posizione y del pixel.
colorColorIl colore del pixel per la posizione specificata.

Method: set_resolution(dpi_x, dpi_y)

 set_resolution(dpi_x, dpi_y) 

Regola la risoluzione di questo RasterImage con precisione utilizzando questo
metodo semplice. Ideale per gli sviluppatori che desiderano personalizzare la risoluzione dell’immagine per
requisiti specifici, garantendo una qualità di visualizzazione ottimale e una gestione della dimensione del file.

Parameters:

ParametroTipoDescrizione
dpi_xfloatLa risoluzione orizzontale, in punti per pollice, del RasterImage.
dpi_yfloatLa risoluzione verticale, in punti per pollice, del RasterImage.

Method: try_set_metadata(metadata)

 try_set_metadata(metadata) 

Cerca di impostare un’istanza metadata, se questa istanza di Image supporta e implementa l’istanza IImageMetadataFormat.

Parameters:

ParametroTipoDescrizione
metadataIImageMetadataFormatI metadati.

Returns

TipoDescrizione
boolTrue se metadata non è null e l’istanza di IMetadataContainer
supporta e/o implementa l’istanza di IImageMetadataFormat; altrimenti, false.

Method: write_argb_32_scan_line(scan_line_index, argb_32_pixels)

 write_argb_32_scan_line(scan_line_index, argb_32_pixels) 

Scrive l’intera riga di scansione all’indice di riga di scansione specificato.

Parameters:

ParametroTipoDescrizione
scan_line_indexintIndice basato su zero della riga di scansione.
argb_32_pixelsint[]L’array di colori ARGB a 32 bit da scrivere.

Method: write_scan_line(scan_line_index, pixels)

 write_scan_line(scan_line_index, pixels) 

Scrive l’intera riga di scansione all’indice di riga di scansione specificato.

Parameters:

ParametroTipoDescrizione
scan_line_indexintIndice basato su zero della riga di scansione.
pixelsColor[]L’array di colori dei pixel da scrivere.

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"
# Carica un'immagine DICOM da un flusso di file.
with open(join(dir_, "sample.dicom"), "rb") as stream:
	with DicomImage(stream) as dicom_image:
		# Salva ogni pagina come immagine PNG individuale.
		for dicom_page in dicom_image.dicom_pages:
			# Genera un nome file basato sull'indice della pagina.
			file_name = "sample.{0}.png".format(dicom_page.index)
			# Una pagina DICOM è un'immagine raster, quindi tutte le operazioni consentite su un'immagine raster sono applicabili a una pagina 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"
# Carica un'immagine DICOM da un flusso di file.
with open(path_join(dir_, "multiframe.dicom"), "rb") as stream:
	# La dimensione massima consentita per tutti i buffer interni è 256KB.
	load_options = LoadOptions()
	load_options.buffer_size_hint = 256 * 1024
	with DicomImage(stream, load_options) as dicom_image:
		# Salva ogni pagina come immagine PNG individuale.
		for dicom_page in dicom_image.dicom_pages:
			# Genera un nome file basato sull'indice della pagina.
			file_name = "multiframe.{0}.png".format(dicom_page.index)
			# Una pagina DICOM è un'immagine raster, quindi tutte le operazioni consentite su un'immagine raster sono applicabili a una pagina 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:
	# Ruota, capovolgi e salva nel file di output.
	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:
		# Salva il quarto in alto a sinistra dell'immagine in un flusso di file.
		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)
	# Ritaglia l'immagine. L'area di ritaglio è l'area rettangolare centrale dell'immagine.
	area = Rectangle(dicom_image.width // 4, dicom_image.height // 4, dicom_image.width // 2, dicom_image.height // 2)
	dicom_image.crop(area)
	# Salva l'immagine ritagliata in 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)
	# Ritaglia nuovamente. Imposta un margine del 10% della dimensione dell'immagine.
	horizontal_margin = dicom_image.width // 10
	vertical_margin = dicom_image.height // 10
	dicom_image.crop(horizontal_margin, horizontal_margin, vertical_margin, vertical_margin)
	# Salva l'immagine ritagliata in 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)
	# Binarizza l'immagine con un valore di soglia di 127.
	# Se il valore di grigio corrispondente di un pixel è maggiore di 127, verrà assegnato il valore 255, altrimenti 0.
	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)
	# Binarizza l'immagine con una differenza di luminosità di 5. La luminosità è una differenza tra un pixel e la media di una finestra di 10 x 10 pixel centrata su questo pixel.
	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)
	# Imposta il coefficiente gamma per i canali rosso, verde e blu.
	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)
	# Imposta i coefficienti gamma individuali per i canali rosso, verde e blu.
	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)
	# Imposta il valore di luminosità. I valori accettati di luminosità sono nell'intervallo [-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)
	# Imposta il valore di contrasto. I valori accettati di contrasto sono nell'intervallo [-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)