Classe TgaImage

Summary: Manipulate TGA raster image files with our API, tailored for the TARGA
(Truevision Advanced Raster Adapter) format, enabling seamless loading and
customization. Easily update public properties such as author, timestamp,
image ID, and software version, while using various bits per pixel settings,
alpha channel and color transparency. Additionally, you can export TGA images
to other popular raster formats, ensuring compatibility for your projects.

Module: aspose.imaging.fileformats.tga

Full Name: aspose.imaging.fileformats.tga.TgaImage

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

Constructors

NameDescrizione
TgaImage(path)Inizializza un nuovo oggetto TgaImage utilizzando il percorso file fornito per
caricare il contenuto dell’immagine. Questo costruttore inizializza in modo efficiente l’istanza dell’immagine
consentendo un accesso senza interruzioni ai file immagine TGA, semplificando l’integrazione
nel flusso di lavoro della tua applicazione.
TgaImage(raster_image)Crea una nuova istanza della classe TgaImage fornendo un raster
oggetto immagine. Questo costruttore facilita l’integrazione diretta delle immagini raster esistenti
nel formato immagine TGA, ottimizzando il processo di conversione per
una compatibilità migliorata all’interno dei tuoi sistemi software.
TgaImage(stream)Inizializza una nuova istanza della classe TgaImage utilizzando uno stream per
caricare l’immagine. Questo costruttore consente un’integrazione senza interruzioni dei dati immagine
provenienti da stream, facilitando una gestione efficiente e l’elaborazione delle immagini TGA all’interno
delle tue applicazioni software.

Properties

NameTypeAccessDescrizione
author_commentsstringr/wRecupera o imposta i commenti forniti dall’autore dell’immagine. Questi commenti
contengono spesso informazioni preziose, come descrizioni, annotazioni o
contesto aggiuntivo sull’immagine. Accedendo o modificando la proprietà Author Comments
gli sviluppatori possono migliorare i metadati associati all’immagine, fornendo
agli utenti approfondimenti e contesto utili riguardo al suo contenuto o alla sua creazione.
Questo è un campo ASCII di 324 byte organizzato in quattro righe
di 80 caratteri, ciascuna seguita da un terminatore nullo.
author_namestringr/wRecupera o imposta il nome dell’autore associato all’immagine. Questa proprietà
consente agli sviluppatori di accedere o modificare i metadati del nome dell’autore, fornendo
informazioni preziose sul creatore dell’immagine. Utilizzando la proprietà Author Name
gli utenti possono identificare facilmente la persona responsabile della creazione o
del contributo all’immagine, migliorando i metadati complessivi e fornendo
contesto prezioso per gli spettatori.
Questo campo è composto da un totale di 40 caratteri ASCII per il nome. Se il campo è utilizzato,
deve contenere il nome della persona che ha creato l’immagine (autore).
auto_adjust_paletteboolr/wOttiene o imposta un valore che indica se la palette viene regolata automaticamente.
background_colorColorr/wRecupera o imposta il colore di sfondo dell’immagine. Questa proprietà consente
di specificare il colore da utilizzare per lo sfondo dell’immagine, garantendo coerenza e
migliorando la presentazione visiva. È particolarmente utile in scenari in cui
l’immagine viene visualizzata su uno sfondo di colore diverso o durante il rendering
dell’immagine su un’altra tela.
bits_per_pixelintrRecupera il valore dei bit per pixel, fornendo informazioni essenziali sulla
profondità di colore dell’immagine. Questa proprietà funge da metrica cruciale per comprendere
il livello di dettaglio e la ricchezza di colore presenti nell’immagine, aiutando gli sviluppatori a
ottimizzare gli algoritmi di elaborazione e l’allocazione delle risorse per una manipolazione
e rendering efficienti 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.
bytes_per_pixelintrOttiene il valore dei byte per pixel, che indica la quantità di memoria occupata da
ogni pixel nell’immagine. Questa proprietà è una metrica cruciale per la gestione
e l’ottimizzazione della memoria, aiutando gli sviluppatori a allocare risorse
in modo efficiente e a elaborare i dati dell’immagine.
containerImagerOttiene il contenitore Image.
data_stream_containerStreamContainerrOttiene lo stream di dati dell’oggetto.
date_time_stampSystem.Nullable`1[[System.DateTime]]r/wRecupera o imposta il timestamp data/ora.
Questo campo definisce il valore per la data e l’ora in cui l’immagine è stata salvata.
Anche se i sistemi operativi tipicamente aggiungono data e ora ai file, questa funzionalità è
fornita perché il sistema operativo può modificare il timestamp data e ora se il file è
copiato. Utilizzando quest’area, si garantisce una regione non modificata per la registrazione della data e dell’ora.
eliminatoboolrOttiene un valore che indica se questa istanza è stata eliminata.
exif_dataExifDatar/wOttiene o imposta l’istanza Exif.
file_formatFileFormatrOttieni informazioni cruciali sul formato file dell’immagine rappresentata da questa
istanza di TgaImage. Comprendere il formato file è essenziale per
verifiche di compatibilità e per garantire un’integrazione senza interruzioni nei sistemi software,
consentendo una gestione efficiente e la manipolazione delle immagini.
gamma_value_denominatorintrRecupera la parte denominatore del valore gamma, un fattore fondamentale nella
determinazione della rappresentazione dei colori nelle immagini. Per le immagini prive di correzione gamma, questo valore dovrebbe essere 1.0, garantendo una resa accurata dei colori.
Apprezzare e sfruttare questo parametro è fondamentale per mantenere la fedeltà del colore e ottenere una visualizzazione precisa dell’immagine.
gamma_value_numeratorintrRecupera la parte numeratore del valore gamma, essenziale per una rappresentazione accurata dei colori nelle immagini. Nelle immagini senza correzione gamma, questo valore dovrebbe essere 1.0. Comprendere e utilizzare questo valore è cruciale per mantenere la fedeltà del colore e garantire un rendering accurato dell’immagine.
has_alphaboolrRecupera un valore booleano che indica se il TgaImage include un
canale alfa, facilitando gli effetti di trasparenza. Questa proprietà fornisce informazioni essenziali
per la gestione della composizione e del rendering dell’immagine, assistendo gli sviluppatori nella
implementazione di diversi effetti visivi e operazioni di compositing.
has_background_colorboolr/wRecupera o imposta un valore che indica se l’immagine contiene un colore di sfondo. Questa proprietà è utile per determinare se l’immagine include un
colore di sfondo distinto dal contenuto in primo piano. Consente
di personalizzare l’elaborazione o il rendering dell’immagine in base alla presenza o assenza di
un colore di sfondo.
has_color_mapboolrRecupera se questa istanza di TgaImage contiene una mappa dei colori.
Comprendere la presenza di una mappa dei colori è cruciale per un’interpretazione accurata
e la manipolazione dei dati di colore dell’immagine.
has_transparent_colorboolr/wRecupera o imposta un valore booleano che indica se l’immagine contiene un
colore trasparente. Questa proprietà è essenziale per identificare se l’immagine
supporta la trasparenza, aiutandoti a implementare una gestione appropriata delle
operazioni legate alla trasparenza, come blending, compositing o masking.
heightintrOttieni l’altezza dell’immagine incapsulata da questa TgaImage
istanza. Questa proprietà fornisce agli sviluppatori dettagli critici riguardo le
dimensioni verticali dell’immagine, consentendo un’integrazione e manipolazione senza soluzione di continuità delle
immagini all’interno delle loro soluzioni software.
horizontal_resolutionfloatr/wOttiene o imposta la risoluzione orizzontale, in pixel per pollice, di questo RasterImage.
image_idstringr/wOttiene o imposta l’identificatore univoco associato all’immagine. Questo ID funge da
punto di riferimento per identificare e distinguere l’immagine dalle altre all’interno di un
sistema o applicazione. Impostando o recuperando l’Image ID, è possibile gestire e
tracciare le immagini in modo efficace, facilitando processi di gestione e recupero delle immagini organizzate.

Questo campo opzionale contiene informazioni identificative sull’immagine. La lunghezza massima
per questo campo è di 255 byte.
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_gray_scaleboolrOttieni un valore booleano che indica se il TgaImage rappresenta un’immagine in scala di grigi. Questa proprietà è cruciale per distinguere tra immagini a colori e
immagini in scala di grigi, aiutando gli sviluppatori ad applicare tecniche di elaborazione e
rendering appropriate basate sulle caratteristiche cromatiche dell’immagine.
is_raw_data_availableboolrOttiene un valore che indica se il caricamento dei dati grezzi è supportato.
job_name_or_idstringr/wRecupera o imposta il nome o l’ID del lavoro associato all’immagine. Questa proprietà
consente di accedere o modificare i metadati relativi al lavoro o progetto specifico
associato all’immagine. Utilizzando la proprietà Job Name/ID, gli utenti possono facilmente
identificare il progetto o compito a cui l’immagine si riferisce, facilitando
l’organizzazione e la gestione delle risorse immagine all’interno di flussi di lavoro o progetti più ampi.
job_timeSystem.Nullable`1[[System.TimeSpan]]r/wRecupera o imposta il timestamp che indica il tempo del lavoro associato all’immagine.
Questa proprietà consente agli sviluppatori di accedere o modificare i metadati temporali relativi al
lavoro o progetto specifico associato all’immagine.
metadataImageMetadatarOttiene i metadati dell’immagine.
paletteIColorPaletter/wOttiene o imposta la tavolozza dei colori. La tavolozza dei colori non viene utilizzata quando i pixel sono rappresentati direttamente.
pixel_aspect_ratio_denominatorintrRecupera la parte denominatore del Pixel Aspect Ratio, un fattore cruciale nella
determinazione dell’aspetto visivo dei pixel all’interno dell’immagine. Questo valore è essenziale
per preservare una rappresentazione accurata dei pixel e i rapporti di aspetto in varie
operazioni di rendering e elaborazione delle immagini, garantendo un output visivo di alta qualità.
pixel_aspect_ratio_numeratorintrRecupera la componente numeratore del Pixel Aspect Ratio, che influenza l’aspetto visivo dei pixel all’interno dell’immagine. Comprendere e manipolare questo
valore è essenziale per ottenere una rappresentazione accurata dei pixel e i rapporti di aspetto
nel rendering e nell’elaborazione delle immagini.
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.
software_idstringr/wGestisce l’identificazione del software (ID) associata all’immagine, consentendo fino a 40 caratteri ASCII. Questa proprietà serve come mezzo per identificare in modo univoco il software utilizzato nella creazione o elaborazione dell’immagine, fornendo metadati preziosi per scopi organizzativi e informativi.
software_versionstringr/wRecupera o imposta la versione del software associata all’immagine. La lunghezza accettata per la stringa di versione è tipicamente di 3-4 caratteri. Questa proprietà è
utile per tracciare il software utilizzato per creare o manipolare l’immagine e può
fornire un contesto prezioso per l’elaborazione delle immagini e i controlli di compatibilità.
software_version_letterSystem.Charr/wRecupera o imposta la componente lettera della versione del software associata all’immagine. Questa proprietà rappresenta un dettaglio aggiuntivo nella stringa della versione del software
e può essere utile per una differenziazione più fine delle versioni.
software_version_numberintr/wRecupera o imposta la componente numerica della versione del software associata all’immagine. Questa proprietà rappresenta la parte numerica della stringa della versione del software
fornendo informazioni importanti sulla versione del software utilizzato per
creare o modificare l’immagine.
transparent_colorColorr/wRecupera o imposta il colore chiave associato all’immagine. Questa proprietà consente
di accedere o modificare il colore designato come colore chiave per specifici compiti o effetti di elaborazione dell’immagine. Utilizzare la proprietà Key Color permette agli utenti di
applicare operazioni basate sul colore come chroma keying o sostituzione del colore, migliorando
le capacità di manipolazione dell’immagine e le possibilità creative.

Il Key Color può essere considerato come il ‘colore di sfondo’ o ‘colore trasparente’.
Questo è il colore dell’area ‘non immagine’ dello schermo, e lo stesso colore a cui lo
schermo verrebbe cancellato se cancellato nell’applicazione.
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.
widthintrRecupera la larghezza dell’immagine rappresentata da questa TgaImage
istanza. Questa proprietà fornisce agli sviluppatori informazioni essenziali sulle
dimensioni dell’immagine, facilitando varie operazioni di manipolazione e elaborazione delle immagini
all’interno delle loro applicazioni software.
x_originintr/wOttiene o imposta la coordinata orizzontale assoluta per l’angolo inferiore sinistro dell’immagine
così come è posizionata su un dispositivo di visualizzazione con origine nell’angolo inferiore sinistro dello
schermo (ad es., la serie TARGA).
xmp_dataXmpPacketWrapperr/wOttiene o imposta i dati Xmp.
y_originintr/wOttiene o imposta la coordinata verticale assoluta per l’angolo inferiore sinistro dell’immagine
così come è posizionata su un dispositivo di visualizzazione con origine nell’angolo inferiore sinistro dello
schermo (ad es., la serie TARGA).

Methods

NameDescrizione
adjust_brightness(brightness)Regola la luminosità dell’immagine.
adjust_contrast(contrast)Contrasto dell’immagine
adjust_gamma(gamma)Correzione gamma di un’immagine.
adjust_gamma(gamma_red, gamma_green, gamma_blue)Correzione gamma di un’immagine.
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)Binarizzazione di un’immagine usando l’algoritmo di sogliatura adattiva di Bradley con la sogliatura dell’immagine integrale
binarize_fixed(threshold)Binarizzazione di un’immagine con soglia predefinita
binarize_otsu()Binarizzazione di un’immagine con soglia Otsu
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()Memorizza nella cache i dati e garantisce che non vengano caricati ulteriori dati dal DataStreamSupporter.data_stream_container sottostante.
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.
clone()Produce un duplicato dell’istanza corrente, generando un nuovo oggetto che clona
tutti gli attributi e le proprietà dell’originale. Questo metodo facilita la
creazione di copie identiche, garantendo l’integrità dei dati e preservando lo stato dell’
istanza corrente senza influire sull’oggetto originale.
clone(tga_image)Replica le proprietà di un altro oggetto TgaImage, creando una
nuova istanza con attributi identici. Questa operazione garantisce la preservazione
dell’integrità dei dati e facilita la duplicazione delle proprietà dell’immagine senza
modificare l’oggetto di origine.
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_image(raster_image)Inizializza una nuova istanza della classe TgaImage.
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.
create_from_stream(stream)Inizializza una nuova istanza della classe TgaImage.
crop(left_shift, right_shift, top_shift, bottom_shift)Ritaglia l’immagine specificando gli spostamenti per i bordi sinistro, destro, superiore e inferiore
. Questo metodo consente di tagliare l’immagine spostando i suoi bordi
indipendentemente lungo gli assi orizzontale e verticale. Regolando questi spostamenti,
è possibile controllare con precisione quali parti dell’immagine conservare,
ritagliandola efficacemente alle dimensioni desiderate.
crop(rectangle)Ritaglia l’immagine a una regione specificata. Questo metodo consente di definire un
area rettangolare all’interno dell’immagine da conservare, scartando il resto. Questa operazione
è utile per focalizzarsi su contenuti specifici dell’immagine o rimuovere parti indesiderate.
dither(dithering_method, bits_count)Esegue il dithering sull’immagine corrente.
dither(dithering_method, bits_count, custom_palette)Esegue il dithering sull’immagine corrente.
embed_digital_signature(password)Incorpora una firma digitale basata sulla password fornita nell’immagine usando la steganografia.
filter(rectangle, options)Filtra il rettangolo specificato.
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()Trasformazione di un’immagine nella sua rappresentazione in scala di grigi
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 RasterImage.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.
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)Regola le dimensioni dell’immagine utilizzando un tipo di ridimensionamento specificato, che determina come
viene eseguita l’operazione di ridimensionamento. Questo metodo offre flessibilità nel ridimensionare
le immagini secondo diversi algoritmi o tecniche. Scegliendo il
tipo di ridimensionamento appropriato, è possibile ottenere il bilanciamento desiderato tra la qualità dell’immagine
e l’efficienza computazionale in base a requisiti o preferenze specifici.
resize(new_width, new_height, settings)Ridimensiona l’immagine applicando impostazioni specifiche per mantenere le dimensioni desiderate
e il rapporto d’aspetto. Personalizzando le impostazioni dell’immagine, è possibile ridimensionare efficacemente
l’immagine garantendo al contempo una qualità visiva ottimale e la compatibilità con
diversi dispositivi di visualizzazione o applicazioni.
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)Ridimensiona l’altezza proporzionalmente.
resize_height_proportionally(new_height, settings)Ridimensiona l’altezza proporzionalmente.
resize_height_proportionally_settings(new_height, settings)Ridimensiona l’altezza proporzionalmente.
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)Ridimensiona la larghezza proporzionalmente.
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 di un angolo specificato mantenendo la proporzionalità del ridimensionamento
e preservando il colore di sfondo. Questo metodo consente una manipolazione precisa dell’immagine, assicurando che la rotazione mantenga l’equilibrio visivo
e la coerenza con il colore di sfondo specificato. È ideale per attività in cui
è necessaria una rotazione accurata attorno al centro, come la correzione dell’orientamento
o regolazioni artistiche.
rotate_flip(rotate_flip_type)Il metodo "RotateFlip" consente operazioni di rotazione e capovolgimento sull’immagine. Offre una funzionalità versatile per manipolare l’orientamento dell’immagine, permettendo agli utenti
di eseguire rotazioni e capovolgimenti secondo le loro esigenze, facilitando
attività di elaborazione delle immagini efficienti all’interno delle applicazioni software.
save()Salva i dati dell’immagine nello stream sottostante.
save(file_path)Salva l’immagine nella posizione file specificata.
save(file_path, options)Salva i dati dell’oggetto nella posizione file specificata nel formato file indicato secondo le opzioni 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)I dati di salvataggio.
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 i dati dell’immagine nello stream specificato nel formato file indicato secondo le opzioni 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)Imposta la risoluzione per questo RasterImage.
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: TgaImage(path)

 TgaImage(path) 

Inizializza un nuovo oggetto TgaImage utilizzando il percorso file fornito per
caricare il contenuto dell’immagine. Questo costruttore inizializza in modo efficiente l’istanza dell’immagine
consentendo un accesso senza interruzioni ai file immagine TGA, semplificando l’integrazione
nel flusso di lavoro della tua applicazione.

Parameters:

ParametroTipoDescrizione
percorsostringIl percorso per caricare un’immagine.

Constructor: TgaImage(raster_image)

 TgaImage(raster_image) 

Crea una nuova istanza della classe TgaImage fornendo un raster
oggetto immagine. Questo costruttore facilita l’integrazione diretta delle immagini raster esistenti
nel formato immagine TGA, ottimizzando il processo di conversione per
una compatibilità migliorata all’interno dei tuoi sistemi software.

Parameters:

ParametroTipoDescrizione
raster_imageRasterImageL’immagine raster.

See also:

Example # 1: Loading of the PNG image, conversion of it to the TgaImage and saving as a TG…

Constructor: TgaImage(stream)

 TgaImage(stream) 

Inizializza una nuova istanza della classe TgaImage utilizzando uno stream per
caricare l’immagine. Questo costruttore consente un’integrazione senza interruzioni dei dati immagine
provenienti da stream, facilitando una gestione efficiente e l’elaborazione delle immagini TGA all’interno
delle tue applicazioni software.

Parameters:

ParametroTipoDescrizione
stream_io.BufferedRandomIl flusso per caricare un’immagine.

Method: adjust_brightness(brightness)

 adjust_brightness(brightness) 

Regola la luminosità dell’immagine.

Parameters:

ParametroTipoDescrizione
luminositàintValore di luminosità.

Method: adjust_contrast(contrast)

 adjust_contrast(contrast) 

Contrasto dell’immagine

Parameters:

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

Method: adjust_gamma(gamma)

 adjust_gamma(gamma) 

Correzione gamma di un’immagine.

Parameters:

ParametroTipoDescrizione
gammafloatCoefficiente gamma per i canali rosso, verde e blu

Method: adjust_gamma(gamma_red, gamma_green, gamma_blue)

 adjust_gamma(gamma_red, gamma_green, gamma_blue) 

Correzione gamma di un’immagine.

Parameters:

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

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 s x s di pixel centrata su questo pixel.

Method: binarize_bradley(brightness_difference, window_size)

 binarize_bradley(brightness_difference, window_size) 

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 s x s di pixel centrata su questo pixel.
window_sizeintLa dimensione della finestra di pixel s x s centrata attorno a questo pixel

Method: binarize_fixed(threshold)

 binarize_fixed(threshold) 

Binarizzazione di un’immagine con soglia predefinita

Parameters:

ParametroTipoDescrizione
sogliaSystem.ByteValore di soglia. Se il valore di grigio corrispondente di un pixel è maggiore della soglia, gli verrà assegnato il valore 255, altrimenti 0.

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

 clone() 

Produce un duplicato dell’istanza corrente, generando un nuovo oggetto che clona
tutti gli attributi e le proprietà dell’originale. Questo metodo facilita la
creazione di copie identiche, garantendo l’integrità dei dati e preservando lo stato dell’
istanza corrente senza influire sull’oggetto originale.

Returns

TipoDescrizione
TgaImageRestituisce un nuovo oggetto che è una copia dell’istanza corrente.

Method: clone(tga_image)

 clone(tga_image) 

Replica le proprietà di un altro oggetto TgaImage, creando una
nuova istanza con attributi identici. Questa operazione garantisce la preservazione
dell’integrità dei dati e facilita la duplicazione delle proprietà dell’immagine senza
modificare l’oggetto di origine.

Parameters:

ParametroTipoDescrizione
tga_imageTgaImageAltri TgaImage

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_image(raster_image) [static]

 create_from_image(raster_image) 

Inizializza una nuova istanza della classe TgaImage.

Parameters:

ParametroTipoDescrizione
raster_imageRasterImageL’immagine raster.

Returns

TipoDescrizione
TgaImage

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: create_from_stream(stream) [static]

 create_from_stream(stream) 

Inizializza una nuova istanza della classe TgaImage.

Parameters:

ParametroTipoDescrizione
stream_io.BufferedRandomIl flusso per caricare un’immagine.

Returns

TipoDescrizione
TgaImage

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

 crop(left_shift, right_shift, top_shift, bottom_shift) 

Ritaglia l’immagine specificando gli spostamenti per i bordi sinistro, destro, superiore e inferiore
. Questo metodo consente di tagliare l’immagine spostando i suoi bordi
indipendentemente lungo gli assi orizzontale e verticale. Regolando questi spostamenti,
è possibile controllare con precisione quali parti dell’immagine conservare,
ritagliandola efficacemente alle dimensioni desiderate.

Parameters:

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

Method: crop(rectangle)

 crop(rectangle) 

Ritaglia l’immagine a una regione specificata. Questo metodo consente di definire un
area rettangolare all’interno dell’immagine da conservare, scartando il resto. Questa operazione
è utile per focalizzarsi su contenuti specifici dell’immagine o rimuovere parti indesiderate.

Parameters:

ParametroTipoDescrizione
rectangleRectangleIl rettangolo.

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) 

Esegue il dithering sull’immagine corrente.

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 una firma digitale basata sulla password fornita nell’immagine usando la steganografia.

Parameters:

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

Method: filter(rectangle, options)

 filter(rectangle, options) 

Filtra il rettangolo specificato.

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: 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 RasterImage.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: 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_colorColorColore vecchio da sostituire.
old_color_diffSystem.ByteDifferenza consentita nel colore vecchio per poter ampliare la tonalità del colore sostituito.
new_colorColorNuovo colore con cui sostituire il colore vecchio.

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_colorColorNuovo colore con cui sostituire i colori non trasparenti.

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) 

Regola le dimensioni dell’immagine utilizzando un tipo di ridimensionamento specificato, che determina come
viene eseguita l’operazione di ridimensionamento. Questo metodo offre flessibilità nel ridimensionare
le immagini secondo diversi algoritmi o tecniche. Scegliendo il
tipo di ridimensionamento appropriato, è possibile ottenere il bilanciamento desiderato tra la qualità dell’immagine
e l’efficienza computazionale in base a requisiti o preferenze specifici.

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) 

Ridimensiona l’immagine applicando impostazioni specifiche per mantenere le dimensioni desiderate
e il rapporto d’aspetto. Personalizzando le impostazioni dell’immagine, è possibile ridimensionare efficacemente
l’immagine garantendo al contempo una qualità visiva ottimale e la compatibilità con
diversi dispositivi di visualizzazione o applicazioni.

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) 

Ridimensiona l’altezza proporzionalmente.

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

Ridimensiona la larghezza proporzionalmente.

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 di un angolo specificato mantenendo la proporzionalità del ridimensionamento
e preservando il colore di sfondo. Questo metodo consente una manipolazione precisa dell’immagine, assicurando che la rotazione mantenga l’equilibrio visivo
e la coerenza con il colore di sfondo specificato. È ideale per attività in cui
è necessaria una rotazione accurata attorno al centro, come la correzione dell’orientamento
o regolazioni artistiche.

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) 

Il metodo "RotateFlip" consente operazioni di rotazione e capovolgimento sull’immagine. Offre una funzionalità versatile per manipolare l’orientamento dell’immagine, permettendo agli utenti
di eseguire rotazioni e capovolgimenti secondo le loro esigenze, facilitando
attività di elaborazione delle immagini efficienti all’interno delle applicazioni software.

Parameters:

ParametroTipoDescrizione
rotate_flip_typeRotateFlipTypeIl tipo di 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) 

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

I dati di salvataggio.

Parameters:

ParametroTipoDescrizione
stream_io.BufferedRandomLo stream.

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 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_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 ARGB a 32 bit.

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) 

Imposta la risoluzione per questo RasterImage.

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

Saving of the JPG image as a TGA image.


from aspose.imaging import Image
from aspose.imaging.imageoptions import TgaOptions

with Image.load("test.jpg") as image:
	image.save("test.tga"", TgaOptions())
	

Loading of the PNG image, conversion of it to the TgaImage and saving as a TGA image.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage
from aspose.imaging.fileformats.tga import TgaImage

with as_of(Image.load("test.png"), RasterImage) as image:
	with TgaImage(image) as tgaImage:
		tgaImage.save("test.tga")