Classe GifImage

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

Module: aspose.imaging.fileformats.gif

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

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

Constructors

Name	Descrizione
GifImage(first_frame)	Creare immagini GIF diventa senza sforzo con il GifImage costruttore. Con il solo parametro firstFrame, si entra in un mondo di comunicazione visiva dinamica .
GifImage(first_frame, global_palette)	Avvia un nuovo oggetto GifImage con i parametri specificati per il primo fotogramma e la tavolozza globale. Inizia a gestire le immagini GIF rapidamente, garantendo una rappresentazione accurata con impostazioni personalizzabili per risultati ottimali.
GifImage(first_frame, global_palette, is_palette_sorted, palette_color_resolution, palette_background_color_index, aspect_ratio, has_trailer)	Inizia senza sforzo con il costruttore GifImage. Con questo metodo semplice, puoi immergerti nella creazione di GIF animate con facilità. Basta fornire i firstFrame, globalPalette, paletteColorResolution, aspectRatio e altri parametri, e sarai pronto a dare vita alle tue immagini.

Properties

Name	Type	Access	Descrizione
active_frame	GifFrameBlock	r/w	Gestisci e manipola i fotogrammi con questa proprietà, consentendo una navigazione fluida e la modifica del fotogramma attivo all’interno dell’immagine GIF.
auto_adjust_palette	bool	r/w	Ottiene o imposta un valore che indica se la palette viene regolata automaticamente.
background_color	Color	r/w	Gestisci il colore di sfondo dell’immagine GIF con questa proprietà. Puoi impostare o recuperare il colore di sfondo per garantire coerenza e migliorare l’appeal visivo.
background_color_index	System.Byte	r/w	Controlla l’indice del colore di sfondo dell’immagine GIF usando questa proprietà. Imposta o recupera l’indice per mantenere la coerenza o ottenere gli effetti visivi desiderati.
bits_per_pixel	int	r	Ottiene il conteggio dei bit per pixel dell’immagine.
blocks	IGifBlock[]	r	Ottieni accesso ai blocchi GIF senza problemi con questa proprietà, facilitando il facile recupero e la manipolazione delle strutture dati sottostanti dell’immagine.
bounds	Rectangle	r	Ottiene i limiti dell’oggetto.
buffer_size_hint	int	r/w	Ottiene o imposta il suggerimento della dimensione del buffer, che è definito come dimensione massima consentita per tutti i buffer interni.
container	Image	r	Ottiene il contenitore Image.
data_stream_container	StreamContainer	r	Ottiene lo stream di dati dell’oggetto.
eliminato	bool	r	Ottiene un valore che indica se questa istanza è stata eliminata.
exif_data	ExifData	r/w	Ottiene o imposta l’istanza Exif.
file_format	FileFormat	r	Recupera il formato del file senza sforzo con questa proprietà. È la tua fonte di riferimento per identificare il formato dei tuoi file. Integrata perfettamente nel tuo flusso di lavoro, fornisce informazioni vitali senza alcun problema.
has_alpha	bool	r	Ottiene un valore che indica se questa istanza ha alfa.
has_background_color	bool	r/w	Questa proprietà determina se l’immagine GIF contiene un colore di sfondo. Se vero, indica che l’immagine include un colore di sfondo.
has_trailer	bool	r/w	Gestisci la presenza di un trailer nei tuoi file GIF con questa proprietà. Che tu debba verificare se un trailer esiste o impostarne la presenza, questa proprietà semplifica il processo. Mantieni i tuoi file GIF strutturati e conformi con questa funzione intuitiva.
has_transparent_color	bool	r/w	Determina se il fotogramma attivo dell’immagine GIF include un colore trasparente. Questa proprietà offre un modo conveniente per verificare la trasparenza all’interno dell’immagine.
height	int	r	Ottiene l’altezza dell’immagine.
horizontal_resolution	float	r/w	Ottiene o imposta la risoluzione orizzontale, in pixel per pollice, di questo RasterImage.
image_opacity	float	r	Recupera l’opacità del fotogramma attivo all’interno dell’immagine, offrendo una visione del suo livello di trasparenza. Questa proprietà è particolarmente utile per comprendere il grado di trasparenza o opacità del fotogramma attivo nell’immagine.
interrupt_monitor	InterruptMonitor	r/w	Ottiene o imposta il monitor di interruzione.
is_cached	bool	r	Ottiene un valore che indica se i dati dell’immagine sono attualmente memorizzati nella cache.
is_interlaced	bool	r	Determina se l’immagine è interlacciata, influenzando la sua visualizzazione durante il caricamento. Questa proprietà offre informazioni sul comportamento di rendering dell’immagine, essenziale per ottimizzare le strategie di caricamento e migliorare l’esperienza di visualizzazione complessiva.
is_palette_sorted	bool	r/w	Controlla l’ordinamento della palette nelle tue immagini GIF usando questa proprietà. Che tu debba verificare se la palette è ordinata o impostare il comportamento di ordinamento, questa proprietà fornisce un modo semplice per gestire l’organizzazione della palette nei tuoi file GIF.
is_raw_data_available	bool	r	Ottiene un valore che indica se il caricamento dei dati grezzi è supportato.
loops_count	int	r/w	Recupera il conteggio dei loop senza sforzo con questa proprietà. Se la tua immagine GIF include informazioni sul loop, questa proprietà ti offre un accesso rapido al conteggio dei loop, consentendoti di gestire senza problemi il comportamento di looping nei tuoi file GIF.
metadata	ImageMetadata	r	Ottiene o imposta i dati XMP dal fotogramma.
page_count	int	r	Recupera il numero totale di pagine contenute nell’immagine con questa proprietà semplice. Ideale per valutare rapidamente l’estensione del contenuto dell’immagine.
pages	Image[]	r	Ottieni l’accesso alle pagine all’interno dell’immagine tramite questa proprietà comoda, consentendo una navigazione fluida e la manipolazione delle singole pagine secondo necessità.
palette	IColorPalette	r/w	Ottiene o imposta la tavolozza dei colori. La tavolozza dei colori non viene utilizzata quando i pixel sono rappresentati direttamente.
palette_color_resolution_bits	System.Byte	r/w	Gestisci la risoluzione dei colori della palette delle tue immagini GIF con questa proprietà. Regola il numero di bit utilizzati per rappresentare i colori nella palette, fornendo un controllo preciso sulla profondità di colore e sulla qualità dell’immagine.
pixel_aspect_ratio	System.Byte	r/w	Gestisci il rapporto d’aspetto dei pixel dell’immagine GIF con questa proprietà. Imposta o recupera il rapporto d’aspetto per garantire un rendering accurato e mantenere la fedeltà visiva.
premultiply_components	bool	r/w	Ottiene o imposta un valore che indica se i componenti dell’immagine devono essere premoltiplicati.
raw_custom_color_converter	IColorConverter	r/w	Ottiene o imposta il convertitore di colore personalizzato
raw_data_format	PixelDataFormat	r	Ottiene il formato dei dati grezzi.
raw_data_settings	RawDataSettings	r	Ottiene le impostazioni attuali dei dati grezzi. Nota che quando si usano queste impostazioni i dati vengono caricati senza conversione.
raw_fallback_index	int	r/w	Ottiene o imposta l’indice di fallback da usare quando l’indice della tavolozza è fuori dai limiti
raw_indexed_color_converter	IIndexedColorConverter	r/w	Ottiene o imposta il convertitore di colore indicizzato
raw_line_size	int	r	Ottiene la dimensione della riga grezza in byte.
size	Size	r	Ottiene la dimensione dell’oggetto.
transparent_color	Color	r/w	Recupera il colore trasparente del fotogramma attivo nell’immagine GIF. Questa proprietà ti consente di accedere al colore specifico designato come trasparente all’interno del fotogramma attualmente attivo.
update_xmp_data	bool	r/w	Ottiene o imposta un valore che indica se aggiornare i metadati XMP.
use_palette	bool	r	Ottiene un valore che indica se la tavolozza dell’immagine è utilizzata.
use_raw_data	bool	r/w	Ottiene o imposta un valore che indica se utilizzare il caricamento dei dati grezzi quando è disponibile.
vertical_resolution	float	r/w	Ottiene o imposta la risoluzione verticale, in pixel per pollice, di questo RasterImage.
width	int	r	Ottiene la larghezza dell’immagine.
xmp_data	XmpPacketWrapper	r/w	Ottiene o imposta i dati Xmp.

Methods

Name	Descrizione
add_block(block)	Aggiungere un nuovo blocco GIF ti consente di includere dati aggiuntivi all’interno dell’immagine. Questo metodo ti permette di aggiungere blocchi personalizzati all’immagine GIF, che possono contenere vari tipi di informazioni.
add_page(page)	Incorpora una nuova pagina senza soluzione di continuità nell’immagine esistente, migliorandone il contenuto ed espandendone la portata. Questo metodo arricchisce le collezioni di immagini con contenuti aggiuntivi, favorendo creatività e flessibilità nella gestione e composizione delle immagini.
adjust_brightness(brightness)	Regola la luminosità dell’immagine in base al parametro specificato brightness. Questo metodo modifica la luminosità dell’intera immagine in modo uniforme, aumentando o riducendo la luminanza complessiva per ottenere l’effetto desiderato.
adjust_contrast(contrast)	Regola il contrasto dell’immagine, aumentando o riducendo la differenza di luminosità tra i pixel. Questo metodo modifica l’intervallo tonale complessivo dell’immagine, rendendo le aree più scure più scure e le aree più luminose più luminose per migliorare la chiarezza visiva e i dettagli.
adjust_gamma(gamma)	Migliora la qualità dell’immagine applicando la correzione gamma. Questo metodo regola la gamma di colore dell’immagine per ottenere una chiarezza visiva ottimale. Modifica il valore gamma di ogni pixel, risultando in una resa cromatica migliorata e un aspetto complessivo dell’immagine più gradevole.
adjust_gamma(gamma_red, gamma_green, gamma_blue)	La correzione gamma di un’immagine applica una regolazione non lineare ai valori dei pixel, aumentando o riducendo la luminosità in base ai coefficienti specificati per i canali rosso, verde e blu. Questo metodo aiuta a perfezionare il bilanciamento del colore e la luminanza dell’immagine, migliorandone l’aspetto complessivo e la qualità visiva.
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)	La binarizzazione di un’immagine usando l’algoritmo di sogliatura adattiva di Bradley con sogliatura dell’immagine integrale è un metodo per convertire un’immagine in scala di grigi in una immagine binaria. Questo algoritmo calcola una soglia locale per ogni pixel basandosi sull’intensità media dei pixel circostanti all’interno di una finestra specificata. Regolando in modo adattivo la soglia in base alle intensità locali dei pixel, il metodo di Bradley è efficace nella gestione delle variazioni di illuminazione e contrasto nell’immagine.
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)	La binarizzazione di un’immagine con una soglia predefinita converte un’immagine in scala di grigi o a colori in un’immagine binaria, dove ogni pixel è classificato come nero o bianco in base al fatto che il suo valore di intensità superi una soglia specificata.
binarize_otsu()	La binarizzazione di un’immagine con sogliatura Otsu è un metodo utilizzato per determinare automaticamente il valore di soglia ottimale per convertire un’immagine in scala di grigi in una immagine binaria. L’algoritmo di sogliatura Otsu calcola la soglia che minimizza la varianza intra-classe delle intensità dei pixel nelle due classi risultanti (sfondo e primo piano). Questa tecnica è particolarmente utile quando il valore di soglia ottimale è sconosciuto e deve essere determinato in modo adattivo basandosi sull’istogramma dell’immagine.
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 in modo privato.
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.
clear_blocks()	Cancellare tutti i blocchi GIF rimuove tutti i dati esistenti memorizzati nell’immagine. Questa operazione ripristina efficacemente l’immagine a uno stato vuoto, rimuovendo eventuali blocchi precedentemente aggiunti. Usa questo metodo quando devi ricominciare da zero con una base pulita per creare o modificare un’immagine GIF.
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)	Ritaglia l’immagine con spostamenti.
crop(rectangle)	Ritaglia l’immagine usando un’area rettangolare specificata. Questa operazione rimuove la parte esterna dell’immagine, lasciando solo la regione selezionata definita dal rettangolo.
dither(dithering_method, bits_count)	Esegue il dithering sull’immagine corrente.
dither(dithering_method, bits_count, custom_palette)	Applica la dithering all’immagine corrente. Questo processo migliora la qualità dell’immagine riducendo la banding dei colori e migliorando le transizioni di colore, risultando in un aspetto più fluido.
embed_digital_signature(password)	Incorpora la firma digitale basata sulla password fornita in ogni pagina dell’immagine.
filter(rectangle, options)	Applica un filtro specifico all’area designata dell’immagine, migliorando la sua qualità visiva o alterando il suo aspetto secondo le necessità. Questo metodo elabora selettivamente i pixel all’interno del rettangolo definito, consentendo di effettuare regolazioni mirate preservando l’integrità dei dati dell’immagine circostante.
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()	Recupera le opzioni basate sulle impostazioni originali del file, fondamentali per mantenere fedeltà e coerenza nell’elaborazione e manipolazione delle immagini. Questo metodo consente un’integrazione fluida dei parametri specifici del file nelle operazioni successive, garantendo una resa accurata e il rispetto delle caratteristiche intrinseche dell’immagine. 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 con 1 bit per pixel e poi la salviamo usando il DataStreamSupporter.save(file_path) metodo, verrà prodotta un’immagine PNG di output con 8 bit per pixel. Per evitarlo e salvare l’immagine PNG con 1 bit per pixel, utilizza questo metodo per ottenere le opzioni di salvataggio corrispondenti e passale al Image.save(file_path, options) metodo 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()	La trasformazione di un’immagine nella sua rappresentazione in scala di grigi converte l’immagine a colori in una versione in scala di grigi rimuovendo le informazioni di colore mantenendo la luminanza. Questo processo semplifica l’immagine in tonalità di grigio, rendendola adatta a varie applicazioni come la stampa, l’elaborazione di documenti e l’analisi in scala di grigi.
insert_block(index, block)	L’inserimento di un nuovo blocco GIF consente di aggiungere dati personalizzati in una posizione specifica all’interno dell’immagine. Questo metodo permette di posizionare blocchi personalizzati nella posizione desiderata nell’immagine GIF, offrendo flessibilità nell’organizzazione e nella strutturazione dei dati 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.
order_blocks()	L’ordinamento dei blocchi GIF secondo la specifica GIF garantisce una corretta disposizione GIF e la conformità allo standard. Questo processo prevede l’organizzazione dei blocchi nella sequenza corretta come definita dalla specifica. Inoltre, può includere la rimozione di alcune istanze di GifGraphicsControlBlock non necessarie per la disposizione finale. Attenendosi alla specifica GIF, l’immagine risultante sarà strutturata correttamente e compatibile con le applicazioni di visualizzazione GIF.
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_block(block)	La rimozione di un blocco GIF elimina dati specifici dall’immagine, offrendo la possibilità di pulire o modificare la struttura dell’immagine. Questo metodo consente di rimuovere blocchi indesiderati o non necessari, ottimizzando l’immagine GIF per una memorizzazione efficiente. Usa questa funzionalità per eliminare informazioni obsolete dall’immagine preservandone l’integrità e la qualità.
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)	Ridimensiona questa istanza di Image.
resize(new_width, new_height, settings)	Ridimensiona questa istanza di Image.
resize_by_settings(new_width, new_height, settings)	Ridimensiona l’immagine.
resize_by_type(new_width, new_height, resize_type)	Ridimensiona l’immagine.
resize_full_frame(new_width, new_height, resize_type)	Il ridimensionamento dell’immagine tenendo conto di tutti i fotogrammi per ogni pagina in un GIF, prevenendo così la comparsa di potenziali artefatti. Questo metodo è essenziale per mantenere l’integrità e la qualità dell’immagine, specialmente quando si lavora con GIF animate o sequenze di fotogrammi.
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 la larghezza proporzionalmente.
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)	Il ridimensionamento proporzionale mantiene il rapporto d’aspetto dell’immagine mentre ne regola la dimensione, garantendo che l’immagine non appaia stirata o distorta. Questo metodo ridimensiona l’immagine proporzionalmente, scalando sia la larghezza che l’altezza con lo stesso fattore. Il ridimensionamento proporzionale ridimensionerà ogni fotogramma secondo il rapporto di newWidth/larghezza e newHeight/altezza.
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)	Questo metodo ruota l’immagine attorno al suo punto centrale. Specificando l’angolo di rotazione è possibile ruotare l’immagine in senso orario o antiorario per ottenere l’orientamento desiderato. Questa rotazione aiuta a regolare la presentazione o l’allineamento dell’immagine senza distorcerne il contenuto.
rotate_flip(rotate_flip_type)	Esegue rotazione, capovolgimento o entrambi esclusivamente sul fotogramma attivo. Questa operazione applica trasformazioni solo al fotogramma attualmente attivo dell’immagine, preservando l’integrità degli altri fotogrammi nella sequenza.
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)	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)	Salva i dati dell’oggetto nello stream specificato.
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 interni principali.
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_frame_time(time)	Regola la durata di ogni fotogramma in millisecondi, garantendo una temporizzazione coerente lungo la sequenza di immagini. Questo metodo imposta uniformemente il tempo di visualizzazione per ogni fotogramma, consentendo un controllo preciso sulla velocità di animazione. Modificando questo valore verrà reimpostato il ritardo per tutti i fotogrammi.
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: GifImage(first_frame)

 GifImage(first_frame) 

Creare immagini GIF diventa senza sforzo con il GifImage
costruttore. Con il solo parametro firstFrame, si entra in un mondo di comunicazione visiva dinamica
.

Parameters:

Parametro	Tipo	Descrizione
first_frame	GifFrameBlock	Il primo fotogramma con cui inizializzare l’immagine GIF.

See also:

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

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

Constructor: GifImage(first_frame, global_palette)

 GifImage(first_frame, global_palette) 

Avvia un nuovo oggetto GifImage con i parametri specificati per il
primo fotogramma e la tavolozza globale. Inizia a gestire le immagini GIF rapidamente, garantendo
una rappresentazione accurata con impostazioni personalizzabili per risultati ottimali.

Parameters:

Parametro	Tipo	Descrizione
first_frame	GifFrameBlock	Il primo fotogramma con cui inizializzare l’immagine GIF.
global_palette	IColorPalette	La tavolozza globale da utilizzare. Nota: se sia firstFrame sia globalPalette sono null, viene usata la tavolozza globale predefinita.

See also:

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

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

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

Inizia senza sforzo con il costruttore GifImage. Con questo
metodo semplice, puoi immergerti nella creazione di GIF animate con facilità. Basta fornire i
firstFrame, globalPalette, paletteColorResolution, aspectRatio e altri
parametri, e sarai pronto a dare vita alle tue immagini.

Parameters:

Parametro	Tipo	Descrizione
first_frame	GifFrameBlock	Il primo fotogramma con cui inizializzare l’immagine GIF.
global_palette	IColorPalette	La tavolozza globale da utilizzare. Nota: se sia firstFrame sia globalPalette sono null, viene usata la tavolozza globale predefinita.
is_palette_sorted	bool	se impostato a true la tavolozza è ordinata. Nota: il parametro è usato quando globalPalette non è null.
palette_color_resolution	System.Byte	La risoluzione del colore della tavolozza. Nota: il parametro è usato quando globalPalette non è null.
palette_background_color_index	System.Byte	L’indice del colore di sfondo della tavolozza.
aspect_ratio	System.Byte	Il rapporto d’aspetto.
has_trailer	bool	se impostato a true l’immagine GIF ha un trailer altrimenti non viene scritto alcun trailer alla fine del flusso.

Property: active_frame

Gestisci e manipola i fotogrammi con questa proprietà, consentendo una navigazione fluida e
la modifica del fotogramma attivo all’interno dell’immagine GIF.

See also:

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

Method: add_block(block)

 add_block(block) 

Aggiungere un nuovo blocco GIF ti consente di includere dati aggiuntivi all’interno dell’immagine.
Questo metodo ti permette di aggiungere blocchi personalizzati all’immagine GIF, che possono
contenere vari tipi di informazioni.

Parameters:

Parametro	Tipo	Descrizione
block	IGifBlock	Il blocco GIF da aggiungere.

See also:

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

Method: add_page(page)

 add_page(page) 

Incorpora una nuova pagina senza soluzione di continuità nell’immagine esistente, migliorandone il contenuto
ed espandendone la portata. Questo metodo arricchisce le collezioni di immagini con contenuti aggiuntivi,
favorendo creatività e flessibilità nella gestione e composizione delle immagini.

Parameters:

Parametro	Tipo	Descrizione
page	RasterImage	La pagina da aggiungere.

See also:

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

Method: adjust_brightness(brightness)

 adjust_brightness(brightness) 

Regola la luminosità dell’immagine in base al parametro specificato
brightness. Questo metodo modifica la luminosità
dell’intera immagine in modo uniforme, aumentando o riducendo la luminanza complessiva per ottenere
l’effetto desiderato.

Parameters:

Parametro	Tipo	Descrizione
luminosità	int	Valore di luminosità.

See also:

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

Method: adjust_contrast(contrast)

 adjust_contrast(contrast) 

Regola il contrasto dell’immagine, aumentando o riducendo la differenza di
luminosità tra i pixel. Questo metodo modifica l’intervallo tonale complessivo dell’immagine,
rendendo le aree più scure più scure e le aree più luminose più luminose per migliorare la chiarezza visiva
e i dettagli.

Parameters:

Parametro	Tipo	Descrizione
contrasto	float	Valore di contrasto (nell’intervallo [-100; 100])

See also:

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

Method: adjust_gamma(gamma)

 adjust_gamma(gamma) 

Migliora la qualità dell’immagine applicando la correzione gamma. Questo metodo regola la gamma di colore
dell’immagine per ottenere una chiarezza visiva ottimale. Modifica il valore gamma
di ogni pixel, risultando in una resa cromatica migliorata e un aspetto complessivo dell’immagine più gradevole.

Parameters:

Parametro	Tipo	Descrizione
gamma	float	Coefficiente gamma per i canali rosso, verde e blu

See also:

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

Method: adjust_gamma(gamma_red, gamma_green, gamma_blue)

 adjust_gamma(gamma_red, gamma_green, gamma_blue) 

La correzione gamma di un’immagine applica una regolazione non lineare ai valori dei pixel,
aumentando o riducendo la luminosità in base ai coefficienti specificati per i canali rosso,
verde e blu. Questo metodo aiuta a perfezionare il bilanciamento del colore e la
luminanza dell’immagine, migliorandone l’aspetto complessivo e la qualità visiva.

Parameters:

Parametro	Tipo	Descrizione
gamma_red	float	Coefficiente gamma per il canale rosso
gamma_green	float	Coefficiente gamma per il canale verde
gamma_blue	float	Gamma per il coefficiente del canale blu

See also:

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

Method: analyze_percentage_digital_signature(password)

 analyze_percentage_digital_signature(password) 

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

Parameters:

Parametro	Tipo	Descrizione
password	string	La password utilizzata per estrarre i dati incorporati.

Returns

Tipo	Descrizione
int	Il valore percentuale di similarità.

Method: binarize_bradley(brightness_difference)

 binarize_bradley(brightness_difference) 

La binarizzazione di un’immagine usando l’algoritmo di sogliatura adattiva di Bradley con
sogliatura dell’immagine integrale è un metodo per convertire un’immagine in scala di grigi in una
immagine binaria. Questo algoritmo calcola una soglia locale per ogni pixel basandosi
sull’intensità media dei pixel circostanti all’interno di una finestra specificata.
Regolando in modo adattivo la soglia in base alle intensità locali dei pixel, il metodo di Bradley
è efficace nella gestione delle variazioni di illuminazione e contrasto nell’immagine.

Parameters:

Parametro	Tipo	Descrizione
brightness_difference	float	La 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:

Parametro	Tipo	Descrizione
brightness_difference	float	La differenza di luminosità tra il pixel e la media di una finestra di pixel s x s centrata attorno a questo pixel.
window_size	int	La dimensione della finestra di pixel s x s centrata attorno a questo pixel

Method: binarize_fixed(threshold)

 binarize_fixed(threshold) 

La binarizzazione di un’immagine con una soglia predefinita converte un’immagine in scala di grigi o a colori
in un’immagine binaria, dove ogni pixel è classificato come nero o bianco
in base al fatto che il suo valore di intensità superi una soglia specificata.

Parameters:

Parametro	Tipo	Descrizione
soglia	System.Byte	Valore di soglia. Se il valore di grigio corrispondente di un pixel è maggiore della soglia, gli verrà assegnato il valore 255, altrimenti 0.

See also:

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

Method: blend(origin, overlay, overlay_alpha)

 blend(origin, overlay, overlay_alpha) 

Unisce questa istanza di immagine con l’immagine overlay.

Parameters:

Parametro	Tipo	Descrizione
origin	Point	L’origine della fusione dell’immagine di sfondo.
overlay	RasterImage	L’immagine di sovrapposizione.
overlay_alpha	System.Byte	L’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:

Parametro	Tipo	Descrizione
origin	Point	L’origine della fusione dell’immagine di sfondo.
overlay	RasterImage	L’immagine di sovrapposizione.
overlay_area	Rectangle	L’area di sovrapposizione.
overlay_alpha	System.Byte	L’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:

Parametro	Tipo	Descrizione
file_path	string	Il percorso del file.

Returns

Tipo	Descrizione
bool	true 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:

Parametro	Tipo	Descrizione
file_path	string	Il percorso del file.
load_options	LoadOptions	Le opzioni di caricamento.

Returns

Tipo	Descrizione
bool	true 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:

Parametro	Tipo	Descrizione
stream	_io.BufferedRandom	Il flusso da cui caricare.

Returns

Tipo	Descrizione
bool	true 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:

Parametro	Tipo	Descrizione
stream	_io.BufferedRandom	Il flusso da cui caricare.
load_options	LoadOptions	Le opzioni di caricamento.

Returns

Tipo	Descrizione
bool	true 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:

Parametro	Tipo	Descrizione
stream	_io.BufferedRandom	Il flusso da cui caricare.

Returns

Tipo	Descrizione
bool	true 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:

Parametro	Tipo	Descrizione
stream	_io.BufferedRandom	Il flusso da cui caricare.
load_options	LoadOptions	Le opzioni di caricamento.

Returns

Tipo	Descrizione
bool	true 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:

Parametro	Tipo	Descrizione
file_path	string	Il percorso del file.
load_options	LoadOptions	Le opzioni di caricamento.

Returns

Tipo	Descrizione
bool	true 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:

Parametro	Tipo	Descrizione
options	ImageOptionsBase	Le opzioni di salvataggio da utilizzare.

Returns

Tipo	Descrizione
bool	true 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:

Parametro	Tipo	Descrizione
file	string[]	I file.

Returns

Tipo	Descrizione
Image	L’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:

Parametro	Tipo	Descrizione
file	string[]	I file.
throw_exception_on_load_error	bool	se impostato su true [throw exception on load error].

Returns

Tipo	Descrizione
Image	L’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:

Parametro	Tipo	Descrizione
image_options	ImageOptionsBase	Le opzioni dell’immagine.
width	int	La larghezza.
height	int	L’altezza.

Returns

Tipo	Descrizione
Image	L’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:

Parametro	Tipo	Descrizione
image_options	ImageOptionsBase	Le opzioni utilizzate per creare il RasterImage.
width	int	La larghezza del RasterImage.
height	int	L’altezza del RasterImage.
pixel	int[]	L’array di valori dei pixel usato per popolare l’immagine.

Returns

Tipo	Descrizione
Image	Una 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:

Parametro	Tipo	Descrizione
images	Image[]	Le immagini.

Returns

Tipo	Descrizione
Image	L’Image come IMultipageImage

Method: create(images, dispose_images) [static]

 create(images, dispose_images) 

Crea una nuova immagine dalle immagini specificate come pagine.

Parameters:

Parametro	Tipo	Descrizione
images	Image[]	Le immagini.
dispose_images	bool	se impostato su true [dispose images].

Returns

Tipo	Descrizione
Image	L’Image come IMultipageImage

Method: create(multipage_create_options) [static]

 create(multipage_create_options) 

Crea le opzioni di creazione multipagina specificate.

Parameters:

Parametro	Tipo	Descrizione
multipage_create_options	MultipageCreateOptions	Le opzioni di creazione multipagina.

Returns

Tipo	Descrizione
Image	L’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:

Parametro	Tipo	Descrizione
file	string[]	I file.

Returns

Tipo	Descrizione
Image	L’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:

Parametro	Tipo	Descrizione
file	string[]	I file.
throw_exception_on_load_error	bool	se impostato su true lancia un’eccezione in caso di errore di caricamento.

Returns

Tipo	Descrizione
Image	L’immagine multipagina

Method: create_from_images(images) [static]

 create_from_images(images) 

Crea una nuova immagine utilizzando le immagini specificate come pagine

Parameters:

Parametro	Tipo	Descrizione
images	Image[]	Le immagini.

Returns

Tipo	Descrizione
Image	L’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:

Parametro	Tipo	Descrizione
images	Image[]	Le immagini.
dispose_images	bool	se impostato su true [dispose images].

Returns

Tipo	Descrizione
Image	L’Image come IMultipageImage

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

 crop(left_shift, right_shift, top_shift, bottom_shift) 

Ritaglia l’immagine con spostamenti.

Parameters:

Parametro	Tipo	Descrizione
left_shift	int	Lo shift a sinistra.
right_shift	int	Lo shift a destra.
top_shift	int	Lo shift superiore.
bottom_shift	int	Lo shift inferiore.

Method: crop(rectangle)

 crop(rectangle) 

Ritaglia l’immagine usando un’area rettangolare specificata. Questa operazione rimuove la parte esterna
dell’immagine, lasciando solo la regione selezionata definita dal rettangolo.

Parameters:

Parametro	Tipo	Descrizione
rectangle	Rectangle	Il rettangolo.

See also:

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

Method: dither(dithering_method, bits_count)

 dither(dithering_method, bits_count) 

Esegue il dithering sull’immagine corrente.

Parameters:

Parametro	Tipo	Descrizione
dithering_method	DitheringMethod	Il metodo di dithering.
bits_count	int	Il conteggio finale dei bit per il dithering.

Method: dither(dithering_method, bits_count, custom_palette)

 dither(dithering_method, bits_count, custom_palette) 

Applica la dithering all’immagine corrente. Questo processo migliora la qualità dell’immagine
riducendo la banding dei colori e migliorando le transizioni di colore, risultando in un aspetto più fluido.

Parameters:

Parametro	Tipo	Descrizione
dithering_method	DitheringMethod	Il metodo di dithering.
bits_count	int	Il conteggio finale dei bit per il dithering.
custom_palette	IColorPalette	La 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:

Parametro	Tipo	Descrizione
password	string	La password usata per generare i dati della firma digitale.

Method: filter(rectangle, options)

 filter(rectangle, options) 

Applica un filtro specifico all’area designata dell’immagine, migliorando la sua qualità visiva
o alterando il suo aspetto secondo le necessità. Questo metodo elabora selettivamente
i pixel all’interno del rettangolo definito, consentendo di effettuare regolazioni mirate
preservando l’integrità dei dati dell’immagine circostante.

Parameters:

Parametro	Tipo	Descrizione
rectangle	Rectangle	Il rettangolo.
options	FilterOptionsBase	Le opzioni.

Method: get_argb_32_pixel(x, y)

 get_argb_32_pixel(x, y) 

Ottiene un pixel ARGB a 32 bit dell’immagine.

Parameters:

Parametro	Tipo	Descrizione
x	int	La posizione x del pixel.
y	int	La posizione y del pixel.

Returns

Tipo	Descrizione
int	Il 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:

Parametro	Tipo	Descrizione
rectangle	Rectangle	Il rettangolo per cui ottenere i pixel.

Returns

Tipo	Descrizione
int[]	L’array predefinito di pixel.

Method: get_default_options(args)

 get_default_options(args) 

Ottiene le opzioni predefinite.

Parameters:

Parametro	Tipo	Descrizione
args	System.Object	Gli argomenti.

Returns

Tipo	Descrizione
ImageOptionsBase	Opzioni 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:

Parametro	Tipo	Descrizione
rectangle	Rectangle	Il rettangolo per cui ottenere i pixel.
partial_pixel_loader	IPartialArgb32PixelLoader	Il 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:

Parametro	Tipo	Descrizione
rectangle	Rectangle	Il rettangolo per cui ottenere i pixel.
partial_raw_data_loader	IPartialRawDataLoader	Il caricatore parziale di dati grezzi.
raw_data_settings	RawDataSettings	Le 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:

Parametro	Tipo	Descrizione
rectangle	Rectangle	Il rettangolo per cui ottenere i dati grezzi.
raw_data_settings	RawDataSettings	Le impostazioni dei dati grezzi.

Returns

Tipo	Descrizione
System.Byte	L’array predefinito di dati grezzi.

Method: get_file_format(file_path) [static]

 get_file_format(file_path) 

Ottiene il formato del file.

Parameters:

Parametro	Tipo	Descrizione
file_path	string	Il percorso del file.

Returns

Tipo	Descrizione
FileFormat	Il formato file determinato.

Method: get_file_format(stream) [static]

 get_file_format(stream) 

Ottiene il formato del file.

Parameters:

Parametro	Tipo	Descrizione
stream	_io.BufferedRandom	Lo stream.

Returns

Tipo	Descrizione
FileFormat	Il formato file determinato.

Method: get_file_format_of_stream(stream) [static]

 get_file_format_of_stream(stream) 

Ottiene il formato del file.

Parameters:

Parametro	Tipo	Descrizione
stream	_io.BufferedRandom	Lo stream.

Returns

Tipo	Descrizione
FileFormat	Il 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:

Parametro	Tipo	Descrizione
rectangle	Rectangle	Il rettangolo per cui ottenere il rettangolo di adattamento.
pixel	int[]	I pixel ARGB a 32 bit.
width	int	La larghezza dell’oggetto.
height	int	L’altezza dell’oggetto.

Returns

Tipo	Descrizione
Rectangle	Il 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:

Parametro	Tipo	Descrizione
rectangle	Rectangle	Il rettangolo per cui ottenere il rettangolo di adattamento.
width	int	La larghezza dell’oggetto.
height	int	L’altezza dell’oggetto.

Returns

Tipo	Descrizione
Rectangle	Il 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:

Parametro	Tipo	Descrizione
use_default	bool	se impostato su true utilizza le informazioni da FileInfo come valore predefinito.

Returns

Tipo	Descrizione
System.DateTime	La data e l’ora in cui l’immagine della risorsa è stata modificata l’ultima volta.

Method: get_original_options()

 get_original_options() 

Recupera le opzioni basate sulle impostazioni originali del file, fondamentali per mantenere fedeltà
e coerenza nell’elaborazione e manipolazione delle immagini. Questo metodo consente un’integrazione fluida
dei parametri specifici del file nelle operazioni successive, garantendo
una resa accurata e il rispetto delle caratteristiche intrinseche dell’immagine.
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 con 1 bit per pixel e poi la salviamo usando il
DataStreamSupporter.save(file_path) metodo, verrà prodotta un’immagine PNG di output con 8 bit per pixel.
Per evitarlo e salvare l’immagine PNG con 1 bit per pixel, utilizza questo metodo per ottenere le opzioni di salvataggio corrispondenti e passale
al Image.save(file_path, options) metodo come secondo parametro.

Returns

Tipo	Descrizione
ImageOptionsBase	Le opzioni basate sulle impostazioni del file originale.

Method: get_pixel(x, y)

 get_pixel(x, y) 

Ottiene un pixel dell’immagine.

Parameters:

Parametro	Tipo	Descrizione
x	int	La posizione x del pixel.
y	int	La posizione y del pixel.

Returns

Tipo	Descrizione
Color	Il 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:

Parametro	Tipo	Descrizione
width	int	La larghezza.
height	int	L’altezza.
new_width	int	La nuova larghezza.

Returns

Tipo	Descrizione
int	L’altezza proporzionale.

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

 get_proportional_width(width, height, new_height) 

Ottiene una larghezza proporzionale.

Parameters:

Parametro	Tipo	Descrizione
width	int	La larghezza.
height	int	L’altezza.
new_height	int	La nuova altezza.

Returns

Tipo	Descrizione
int	La 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:

Parametro	Tipo	Descrizione
image_options	ImageOptionsBase	Le opzioni dell’immagine.
clipping_rectangle	Rectangle	Il rettangolo di ritaglio.
page_number	int[]	Il numero di pagina.

Returns

Tipo	Descrizione
_io.BufferedRandom	Il 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

Tipo	Descrizione
float	L’angolo di inclinazione, in gradi.

Method: insert_block(index, block)

 insert_block(index, block) 

L’inserimento di un nuovo blocco GIF consente di aggiungere dati personalizzati in una posizione specifica
all’interno dell’immagine. Questo metodo permette di posizionare blocchi personalizzati nella posizione desiderata
nell’immagine GIF, offrendo flessibilità nell’organizzazione e nella strutturazione dei
dati dell’immagine.

Parameters:

Parametro	Tipo	Descrizione
index	int	L’elemento a indice zero, al quale il blocco sarà inserito.
block	IGifBlock	Il blocco GIF da aggiungere.

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:

Parametro	Tipo	Descrizione
password	string	La password per verificare la firma.
percentage_threshold	int	La soglia (in percentuale)[0-100] che determina se l’immagine è considerata firmata. Se non specificata, verrà applicata una soglia predefinita (75).

Returns

Tipo	Descrizione
bool	Vero 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:

Parametro	Tipo	Descrizione
file_path	string	Il percorso file o l’URL da cui caricare l’immagine.

Returns

Tipo	Descrizione
Image	L’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:

Parametro	Tipo	Descrizione
file_path	string	Il percorso file o l’URL da cui caricare l’immagine.
load_options	LoadOptions	Le opzioni di caricamento.

Returns

Tipo	Descrizione
Image	L’immagine caricata.

Method: load(stream) [static]

 load(stream) 

Carica una nuova immagine dallo stream specificato.

Parameters:

Parametro	Tipo	Descrizione
stream	_io.BufferedRandom	Il flusso da cui caricare l’immagine.

Returns

Tipo	Descrizione
Image	L’immagine caricata.

Method: load(stream, load_options) [static]

 load(stream, load_options) 

Carica una nuova immagine dallo stream specificato.

Parameters:

Parametro	Tipo	Descrizione
stream	_io.BufferedRandom	Il flusso da cui caricare l’immagine.
load_options	LoadOptions	Le opzioni di caricamento.

Returns

Tipo	Descrizione
Image	L’immagine caricata.

Method: load_argb_32_pixels(rectangle)

 load_argb_32_pixels(rectangle) 

Carica pixel ARGB a 32 bit.

Parameters:

Parametro	Tipo	Descrizione
rectangle	Rectangle	Il rettangolo da cui caricare i pixel.

Returns

Tipo	Descrizione
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:

Parametro	Tipo	Descrizione
rectangle	Rectangle	Il rettangolo da cui caricare i pixel.

Returns

Tipo	Descrizione
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:

Parametro	Tipo	Descrizione
rectangle	Rectangle	Il rettangolo da cui caricare i pixel.

Returns

Tipo	Descrizione
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:

Parametro	Tipo	Descrizione
rectangle	Rectangle	Il rettangolo da cui caricare i pixel.

Returns

Tipo	Descrizione
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:

Parametro	Tipo	Descrizione
rectangle	Rectangle	Il rettangolo da cui caricare i pixel.
partial_pixel_loader	IPartialArgb32PixelLoader	Il 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:

Parametro	Tipo	Descrizione
rectangle	Rectangle	Il rettangolo desiderato.
partial_pixel_loader	IPartialArgb64PixelLoader	Il 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:

Parametro	Tipo	Descrizione
desired_rectangle	Rectangle	Il rettangolo desiderato.
pixel_loader	IPartialPixelLoader	Il caricatore di pixel.

Method: load_pixels(rectangle)

 load_pixels(rectangle) 

Carica pixel.

Parameters:

Parametro	Tipo	Descrizione
rectangle	Rectangle	Il rettangolo da cui caricare i pixel.

Returns

Tipo	Descrizione
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:

Parametro	Tipo	Descrizione
rectangle	Rectangle	Il rettangolo da cui caricare i dati grezzi.
dest_image_bounds	Rectangle	I limiti dell’immagine di destinazione.
raw_data_settings	RawDataSettings	Le 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_loader	IPartialRawDataLoader	Il 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:

Parametro	Tipo	Descrizione
rectangle	Rectangle	Il rettangolo da cui caricare i dati grezzi.
raw_data_settings	RawDataSettings	Le 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_loader	IPartialRawDataLoader	Il caricatore di dati grezzi.

Method: load_stream(stream) [static]

 load_stream(stream) 

Carica una nuova immagine dallo stream specificato.

Parameters:

Parametro	Tipo	Descrizione
stream	_io.BufferedRandom	Il flusso da cui caricare l’immagine.

Returns

Tipo	Descrizione
Image	L’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:

Parametro	Tipo	Descrizione
stream	_io.BufferedRandom	Il flusso da cui caricare l’immagine.
load_options	LoadOptions	Le opzioni di caricamento.

Returns

Tipo	Descrizione
Image	L’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:

Parametro	Tipo	Descrizione
file_path	string	Il percorso file o l’URL da cui caricare l’immagine.
load_options	LoadOptions	Le opzioni di caricamento.

Returns

Tipo	Descrizione
Image	L’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:

Parametro	Tipo	Descrizione
resize_proportionally	bool	se 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_color	Color	Colore 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:

Parametro	Tipo	Descrizione
scan_line_index	int	Indice basato su zero della riga di scansione.

Returns

Tipo	Descrizione
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:

Parametro	Tipo	Descrizione
scan_line_index	int	Indice basato su zero della riga di scansione.

Returns

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

Method: remove_block(block)

 remove_block(block) 

La rimozione di un blocco GIF elimina dati specifici dall’immagine, offrendo la possibilità di
pulire o modificare la struttura dell’immagine. Questo metodo consente di rimuovere blocchi indesiderati
o non necessari, ottimizzando l’immagine GIF per una memorizzazione efficiente. Usa questa
funzionalità per eliminare informazioni obsolete dall’immagine preservandone
l’integrità e la qualità.

Parameters:

Parametro	Tipo	Descrizione
block	IGifBlock	Il blocco da rimuovere.

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:

Parametro	Tipo	Descrizione
old_color_argb	int	Valore ARGB del colore vecchio da sostituire.
old_color_diff	System.Byte	Differenza consentita nel colore vecchio per poter ampliare la tonalità del colore sostituito.
new_color_argb	int	Nuovo 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:

Parametro	Tipo	Descrizione
old_color	Color
old_color_diff	System.Byte	Differenza consentita nel colore vecchio per poter ampliare la tonalità del colore sostituito.
new_color	Color

Method: replace_color(old_color_argb, old_color_diff, new_color_argb)

 replace_color(old_color_argb, old_color_diff, new_color_argb) 

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

Parameters:

Parametro	Tipo	Descrizione
old_color_argb	int	Valore ARGB del colore vecchio da sostituire.
old_color_diff	System.Byte	Differenza consentita nel colore vecchio per poter ampliare la tonalità del colore sostituito.
new_color_argb	int	Nuovo 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:

Parametro	Tipo	Descrizione
new_color	Color

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:

Parametro	Tipo	Descrizione
new_color_argb	int	Nuovo 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:

Parametro	Tipo	Descrizione
new_width	int	La nuova larghezza.
new_height	int	La nuova altezza.

Method: resize(new_width, new_height, resize_type)

 resize(new_width, new_height, resize_type) 

Ridimensiona questa istanza di Image.

Parameters:

Parametro	Tipo	Descrizione
new_width	int	La nuova larghezza.
new_height	int	La nuova altezza.
resize_type	ResizeType	Il tipo di ridimensionamento.

Method: resize(new_width, new_height, settings)

 resize(new_width, new_height, settings) 

Ridimensiona questa istanza di Image.

Parameters:

Parametro	Tipo	Descrizione
new_width	int	La nuova larghezza.
new_height	int	La nuova altezza.
settings	ImageResizeSettings	Le impostazioni.

Method: resize_by_settings(new_width, new_height, settings)

 resize_by_settings(new_width, new_height, settings) 

Ridimensiona l’immagine.

Parameters:

Parametro	Tipo	Descrizione
new_width	int	La nuova larghezza.
new_height	int	La nuova altezza.
settings	ImageResizeSettings	Le 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:

Parametro	Tipo	Descrizione
new_width	int	La nuova larghezza.
new_height	int	La nuova altezza.
resize_type	ResizeType	Il tipo di ridimensionamento.

Method: resize_full_frame(new_width, new_height, resize_type)

 resize_full_frame(new_width, new_height, resize_type) 

Il ridimensionamento dell’immagine tenendo conto di tutti i fotogrammi per ogni pagina in un
GIF, prevenendo così la comparsa di potenziali artefatti. Questo metodo è essenziale
per mantenere l’integrità e la qualità dell’immagine, specialmente quando si lavora con
GIF animate o sequenze di fotogrammi.

Parameters:

Parametro	Tipo	Descrizione
new_width	int	La nuova larghezza.
new_height	int	La nuova altezza.
resize_type	ResizeType	Il 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:

Parametro	Tipo	Descrizione
new_height	int	La nuova altezza.

Method: resize_height_proportionally(new_height, resize_type)

 resize_height_proportionally(new_height, resize_type) 

Ridimensiona la larghezza proporzionalmente.

Parameters:

Parametro	Tipo	Descrizione
new_height	int	La nuova altezza.
resize_type	ResizeType	Tipo di ridimensionamento.

Method: resize_height_proportionally(new_height, settings)

 resize_height_proportionally(new_height, settings) 

Ridimensiona l’altezza proporzionalmente.

Parameters:

Parametro	Tipo	Descrizione
new_height	int	La nuova altezza.
settings	ImageResizeSettings	Le 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:

Parametro	Tipo	Descrizione
new_height	int	La nuova altezza.
settings	ImageResizeSettings	Le impostazioni di ridimensionamento dell’immagine.

Method: resize_proportional(new_width, new_height, resize_type)

 resize_proportional(new_width, new_height, resize_type) 

Il ridimensionamento proporzionale mantiene il rapporto d’aspetto dell’immagine mentre ne regola la
dimensione, garantendo che l’immagine non appaia stirata o distorta. Questo metodo
ridimensiona l’immagine proporzionalmente, scalando sia la larghezza che l’altezza con lo stesso fattore.
Il ridimensionamento proporzionale ridimensionerà ogni fotogramma secondo il rapporto di newWidth/larghezza e newHeight/altezza.

Parameters:

Parametro	Tipo	Descrizione
new_width	int	La nuova larghezza.
new_height	int	La nuova altezza.
resize_type	ResizeType	Il 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:

Parametro	Tipo	Descrizione
new_width	int	La nuova larghezza.

Method: resize_width_proportionally(new_width, resize_type)

 resize_width_proportionally(new_width, resize_type) 

Ridimensiona la larghezza proporzionalmente.

Parameters:

Parametro	Tipo	Descrizione
new_width	int	La nuova larghezza.
resize_type	ResizeType	Tipo di ridimensionamento.

Method: resize_width_proportionally(new_width, settings)

 resize_width_proportionally(new_width, settings) 

Ridimensiona la larghezza proporzionalmente.

Parameters:

Parametro	Tipo	Descrizione
new_width	int	La nuova larghezza.
settings	ImageResizeSettings	Le 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:

Parametro	Tipo	Descrizione
new_width	int	La nuova larghezza.
settings	ImageResizeSettings	Le impostazioni di ridimensionamento dell’immagine.

Method: rotate(angle)

 rotate(angle) 

Ruota l’immagine attorno al centro.

Parameters:

Parametro	Tipo	Descrizione
angle	float	L’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) 

Questo metodo ruota l’immagine attorno al suo punto centrale. Specificando l’angolo di rotazione
è possibile ruotare l’immagine in senso orario o antiorario per ottenere l’orientamento desiderato. Questa rotazione aiuta a regolare la presentazione o
l’allineamento dell’immagine senza distorcerne il contenuto.

Parameters:

Parametro	Tipo	Descrizione
angle	float	L’angolo di rotazione in gradi. I valori positivi ruoteranno in senso orario.
resize_proportionally	bool	se 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_color	Color	Colore dello sfondo.

Method: rotate_flip(rotate_flip_type)

 rotate_flip(rotate_flip_type) 

Esegue rotazione, capovolgimento o entrambi esclusivamente sul fotogramma attivo. Questa operazione
applica trasformazioni solo al fotogramma attualmente attivo dell’immagine,
preservando l’integrità degli altri fotogrammi nella sequenza.

Parameters:

Parametro	Tipo	Descrizione
rotate_flip_type	RotateFlipType	Il tipo di rotazione e capovolgimento.

See also:

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

Method: rotate_flip_all(rotate_flip)

 rotate_flip_all(rotate_flip) 

Ruota il flip completo.

Parameters:

Parametro	Tipo	Descrizione
rotate_flip	RotateFlipType	La rotazione e capovolgimento.

Method: save(file_path)

 save(file_path) 

Salva l’immagine nella posizione file specificata.

Parameters:

Parametro	Tipo	Descrizione
file_path	string	Il 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:

Parametro	Tipo	Descrizione
file_path	string	Il percorso del file.
options	ImageOptionsBase	Le 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:

Parametro	Tipo	Descrizione
file_path	string	Il percorso del file.
options	ImageOptionsBase	Le opzioni.
bounds_rectangle	Rectangle	Il 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:

Parametro	Tipo	Descrizione
file_path	string	Il percorso file in cui salvare i dati dell’oggetto.
over_write	bool	se impostato su true sovrascrive il contenuto del file, altrimenti verrà effettuata un’aggiunta.

Method: save(stream)

 save(stream) 

Salva i dati dell’oggetto nello stream specificato.

Parameters:

Parametro	Tipo	Descrizione
stream	_io.BufferedRandom	Il flusso in cui salvare i dati dell’oggetto.

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:

Parametro	Tipo	Descrizione
stream	_io.BufferedRandom	Il flusso in cui salvare i dati dell’immagine.
options_base	ImageOptionsBase	Le 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:

Parametro	Tipo	Descrizione
stream	_io.BufferedRandom	Il flusso in cui salvare i dati dell’immagine.
options_base	ImageOptionsBase	Le opzioni di salvataggio.
bounds_rectangle	Rectangle	Il 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:

Parametro	Tipo	Descrizione
rectangle	Rectangle	Il rettangolo in cui salvare i pixel.
pixel	int[]	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:

Parametro	Tipo	Descrizione
rectangle	Rectangle	Il rettangolo in cui salvare i pixel.
pixel	int[]	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:

Parametro	Tipo	Descrizione
rectangle	Rectangle	Il rettangolo in cui salvare i pixel.
pixels	CmykColor[]	L’array di pixel CMYK.

Method: save_pixels(rectangle, pixels)

 save_pixels(rectangle, pixels) 

Salva i pixel interni principali.

Parameters:

Parametro	Tipo	Descrizione
rectangle	Rectangle	Il rettangolo.
pixels	Color[]	I 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:

Parametro	Tipo	Descrizione
dati	System.Byte	I dati grezzi.
data_offset	int	L’offset iniziale dei dati grezzi.
rectangle	Rectangle	Il rettangolo dei dati grezzi.
raw_data_settings	RawDataSettings	Le 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:

Parametro	Tipo	Descrizione
stream	_io.BufferedRandom	Il 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:

Parametro	Tipo	Descrizione
stream	_io.BufferedRandom	Il flusso in cui salvare i dati dell’immagine.
options_base	ImageOptionsBase	Le 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:

Parametro	Tipo	Descrizione
stream	_io.BufferedRandom	Il flusso in cui salvare i dati dell’immagine.
options_base	ImageOptionsBase	Le opzioni di salvataggio.
bounds_rectangle	Rectangle	Il 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:

Parametro	Tipo	Descrizione
file_path	string	Il percorso del file.
options	ImageOptionsBase	Le 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:

Parametro	Tipo	Descrizione
file_path	string	Il percorso del file.
options	ImageOptionsBase	Le opzioni.
bounds_rectangle	Rectangle	Il 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:

Parametro	Tipo	Descrizione
x	int	La posizione x del pixel.
y	int	La posizione y del pixel.
argb_32_color	int	Il pixel ARGB a 32 bit per la posizione specificata.

Method: set_frame_time(time)

 set_frame_time(time) 

Regola la durata di ogni fotogramma in millisecondi, garantendo una temporizzazione coerente
lungo la sequenza di immagini. Questo metodo imposta uniformemente il tempo di visualizzazione per
ogni fotogramma, consentendo un controllo preciso sulla velocità di animazione.
Modificando questo valore verrà reimpostato il ritardo per tutti i fotogrammi.

Parameters:

Parametro	Tipo	Descrizione
tempo	int	Il tempo di durata del fotogramma in millisecondi.

Method: set_palette(palette, update_colors)

 set_palette(palette, update_colors) 

Imposta la tavolozza dell’immagine.

Parameters:

Parametro	Tipo	Descrizione
palette	IColorPalette	La tavolozza da impostare.
update_colors	bool	se 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:

Parametro	Tipo	Descrizione
x	int	La posizione x del pixel.
y	int	La posizione y del pixel.
color	Color	Il 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:

Parametro	Tipo	Descrizione
dpi_x	float	La risoluzione orizzontale, in punti per pollice, del RasterImage.
dpi_y	float	La 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:

Parametro	Tipo	Descrizione
metadata	IImageMetadataFormat	I metadati.

Returns

Tipo	Descrizione
bool	True 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:

Parametro	Tipo	Descrizione
scan_line_index	int	Indice basato su zero della riga di scansione.
argb_32_pixels	int[]	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:

Parametro	Tipo	Descrizione
scan_line_index	int	Indice basato su zero della riga di scansione.
pixels	Color[]	L’array di colori dei pixel da scrivere.

Examples

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

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


# Crea un blocco di fotogramma GIF di 100x100 px.
with GifFrameBlock(100, 100) as firstBlock:
	# Riempi l'intero blocco di rosso.
	gr = Graphics(firstBlock)
	brush = SolidBrush(Color.red)
	gr.fill_rectangle(brush, firstBlock.bounds)

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

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

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


# Crea un blocco di fotogramma GIF di 100x100 px.
with GifFrameBlock(100, 100) as firstBlock:
	# Riempi l'intero blocco di rosso.
	gr = Graphics(firstBlock)
	brush = SolidBrush(Color.red)
	gr.fill_rectangle(brush, firstBlock.bounds)

	# Usa una palette a 4 bit per ridurre la dimensione dell'immagine. La qualità può peggiorare.
	palette = ColorPaletteHelper.create_4_bit()

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

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

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

# Crea un'immagine GIF 100 x 100 px.
# Il primo blocco è completamente nero per impostazione predefinita.
with GifFrameBlock(100, 100) as firstBlock:
	with GifImage(firstBlock) as gifImage:
		# Il primo cerchio è rosso
		brush1 = SolidBrush(Color.red)

		# Il secondo cerchio è nero
		brush2 = SolidBrush(Color.black)

		# Aumenta gradualmente l'angolo della forma dell'arco rosso.
		for angle in range(10, 361, 10):
			block = GifFrameBlock(100, 100)
			gr = Graphics(block)
			gr.fill_pie(brush1, block.bounds, 0, angle)
			gifImage.add_block(block)
		
		# Aumenta gradualmente l'angolo dell'arco nero e cancella l'arco rosso.
		for angle in range(10, 361, 10):
			block = GifFrameBlock(100, 100)
			gr = Graphics(block)
			gr.fill_pie(brush2, block.bounds, 0, angle)
			gr.fill_pie(brush1, block.bounds, angle, 360 - angle)
			gifImage.add_block(block)

		gifImage.save("animated_radar.gif")

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

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

# Crea un'immagine GIF 100 x 100 px.
# Il primo blocco è completamente nero per impostazione predefinita.
with GifFrameBlock(100, 100) as firstBlock:
	with GifImage(firstBlock) as gifImage:
		if gifImage.active_frame is not None:
			print(f"Active frame size: {gifImage.active_frame.size}")
		else:
			print("Active frame is not set")

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

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

# L'output appare così:
# Dimensione del fotogramma attivo: { Width = 100, Height = 100}
# Cancella tutti i blocchi
# Il fotogramma attivo non è impostato

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

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

dir_: str = "c:\\temp"
rotate_flip_types = [RotateFlipType.ROTATE_90_FLIP_NONE, RotateFlipType.ROTATE_90_FLIP_X, RotateFlipType.ROTATE_90_FLIP_XY, RotateFlipType.ROTATE_90_FLIP_Y]
for rotate_flip_type in rotate_flip_types:
	# Ruota, capovolgi e salva nel file di output.
	with aspycore.as_of(Image.load(join(dir_, "sample.gif")), GifImage) as image:
		image.rotate_flip(rotate_flip_type)
		image.save(join(dir_, "sample." + rotate_flip_type + ".png"), PngOptions())

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

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

dir_: str = "c:\\temp"
with Image.load(join(dir_, "sample.gif")) as image:
	gif_image = aspycore.as_of(image, GifImage)
	# Ritaglia l'immagine. L'area di ritaglio è l'area rettangolare centrale dell'immagine.
	area = Rectangle(gif_image.width // 4, gif_image.height // 4, gif_image.width // 2,
					 gif_image.height // 2)
	gif_image.crop(area)
	# Salva l'immagine ritagliata in PNG
	gif_image.save(join(dir_, "sample.Crop.png"), PngOptions())

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

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

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

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

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

dir_: str = "c:\\temp\\"
with Image.load(join(dir_, "sample.gif")) as image:
	gif_image = aspycore.as_of(image, GifImage)
	# Imposta il coefficiente gamma per i canali rosso, verde e blu.
	gif_image.adjust_gamma(2.5)
	gif_image.save(join(dir_, "sample.AdjustGamma.png"), PngOptions())

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

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

dir_ = "c:\\temp"
with Image.load(join(dir_, "sample.gif")) as image:
	gif_image = aspycore.as_of(image, GifImage)
	# Imposta i coefficienti gamma individuali per i canali rosso, verde e blu.
	gif_image.adjust_gamma(1.5, 2.5, 3.5)
	gif_image.save(join(dir_, "sample.AdjustGamma.png"), PngOptions())

The following example performs brightness correction of a GIF image.

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

dir_ = "c:\\temp"
with Image.load(join(dir_, "sample.gif")) as image:
	gif_image = aspycore.as_of(image, GifImage)
	# Imposta il valore di luminosità. I valori accettati di luminosità sono nell'intervallo [-255, 255].
	gif_image.adjust_brightness(50)
	gif_image.save(join(dir_, "sample.AdjustBrightness.png"), PngOptions())

The following example performs contrast correction of a GIF image.

import aspose.pycore as aspycore

from aspose.imaging import Image

from aspose.imaging.fileformats.gif import GifImage

from aspose.imaging.imageoptions import PngOptions

from os.path import join



dir_ = "c:\\temp"

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

	gif_image = aspycore.as_of(image, GifImage)

	# Imposta il valore di contrasto. I valori accettati di contrasto sono nell'intervallo [-100f, 100f].

	gif_image.adjust_contrast(50.0)

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



# ExEnd

Create multipage GIF image using single page raster images.

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

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


# Carica i fotogrammi
frames = list(load_frames("Animation frames"))
# Crea immagine GIF usando il primo fotogramma
with GifImage(GifFrameBlock(frames[0])) as image:
	# Aggiungi fotogrammi all'immagine GIF usando il metodo AddPage
	for index in range(1, len(frames)):
		image.add_page(frames[index])

	# Salva immagine GIF
	image.save("Multipage.gif")
	
for it in frames:
	with it as _:
		# elimina le immagini
		pass

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

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

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