Classe WebPImage

Summary: Manipulate WebP raster images with our API, using its modern features for both
lossless and lossy compression, ensuring optimal image quality with reduced file sizes.
Seamlessly handle extended file formats, animations, and alpha channels, while easily
updating dimensions, resizing proportionally, cropping, rotating, applying filters,
adjusting image parameters, and converting to other image formats for versatile
web image optimization.

Module: aspose.imaging.fileformats.webp

Full Name: aspose.imaging.fileformats.webp.WebPImage

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

Constructors

Name	Descrizione
WebPImage(path)	Instanzia una nuova istanza della classe WebPImage, inizializzata da una fonte file fornita. Utilizza questo costruttore per creare senza soluzione di continuità oggetti immagine WebP direttamente dai file, semplificando il processo di caricamento e manipolazione dei dati immagine WebP nella tua applicazione.
WebPImage(path, load_options)	Crea una nuova istanza della classe WebPImage utilizzando un file e opzioni di caricamento specificate, facilitando una gestione flessibile dei dati immagine WebP. Utilizza questo costruttore per inizializzare senza soluzione di continuità oggetti immagine WebP dai file mentre personalizzi i parametri di caricamento secondo i requisiti della tua applicazione.
WebPImage(raster_image)	Instanzia una nuova istanza della classe WebPImage inizializzata da un oggetto rasterImage fornito. Questo costruttore consente una conversione senza soluzione di continuità delle immagini raster al formato WebP, permettendo una gestione efficiente e la manipolazione dei dati immagine nella tua applicazione.
WebPImage(raster_image, load_options)	Crea una nuova istanza della classe WebPImage utilizzando un oggetto rasterImage e opzioni di caricamento specificate, consentendo una gestione flessibile dei dati immagine. Utilizza questo costruttore per inizializzare senza soluzione di continuità oggetti immagine WebP da immagini raster mentre personalizzi i parametri di caricamento secondo i requisiti della tua applicazione.
WebPImage(stream)	Istanziare una nuova istanza della classe WebPImage , inizializzata da una sorgente stream fornita. Utilizzare questo costruttore per creare senza problemi oggetti immagine WebP direttamente da stream, consentendo una gestione efficiente e la manipolazione dei dati immagine WebP all’interno della tua applicazione.
WebPImage(stream, load_options)	Creare una nuova istanza della classe WebPImage da uno stream, incorporando le opzioni di caricamento specificate e le impostazioni di gestione della memoria. Questo costruttore offre flessibilità nel caricare immagini WebP da stream gestendo efficientemente le risorse di memoria, garantendo prestazioni ottimali e utilizzo delle risorse all’interno della tua applicazione.
WebPImage(width, height, options)	Istanziare una nuova istanza della classe WebPImage con un’immagine vuota di larghezza e altezza specificate. Questo costruttore consente la creazione di immagini WebP vuote, fornendo una base per la successiva manipolazione dell’immagine e la generazione di contenuti all’interno della tua applicazione.
WebPImage(width, height, options, load_options)	Creare una nuova istanza della classe WebPImage con un’immagine vuota e le opzioni di caricamento specificate. Questo costruttore permette l’inizializzazione di immagini WebP con parametri di caricamento personalizzabili, offrendo flessibilità nella creazione e manipolazione dell’immagine all’interno della tua applicazione.

Properties

Name	Type	Access	Descrizione
auto_adjust_palette	bool	r/w	Ottiene o imposta un valore che indica se la palette viene regolata automaticamente.
background_color	Color	r/w	Ottiene o imposta un valore per il colore di sfondo.
bits_per_pixel	int	r	Ottiene il conteggio dei bit per pixel 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	Accedere al valore del formato file associato all’immagine, fornendo informazioni sul formato in cui l’immagine è memorizzata. Utilizzare questa proprietà per determinare il formato file dell’immagine, facilitando controlli di compatibilità e l’elaborazione specifica del formato all’interno della tua applicazione.
has_alpha	bool	r	Ottenere se l’immagine contiene un canale alfa, indicando la presenza di informazioni di trasparenza. Utilizzare questa proprietà per determinare se l’immagine include trasparenza, consentendo una gestione e un’elaborazione appropriate delle operazioni legate all’alfa all’interno della tua applicazione.
has_background_color	bool	r/w	Ottiene o imposta un valore che indica se l’immagine ha un colore di sfondo.
has_transparent_color	bool	r/w	Ottiene un valore che indica se l’immagine ha un colore trasparente.
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	Ottiene l’opacità di questa 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_raw_data_available	bool	r	Ottiene un valore che indica se il caricamento dei dati grezzi è supportato.
metadata	ImageMetadata	r	Ottiene o imposta i dati XMP dal fotogramma.
options	WebPOptions	r	Ottenere o modificare le opzioni associate alla proprietà specificata, consentendo una personalizzazione fine del comportamento e delle impostazioni. Utilizzare questa proprietà per accedere e manipolare senza problemi i parametri configurabili, facilitando un controllo versatile e l’ottimizzazione all’interno della funzionalità della tua applicazione.
page_count	int	r	Ottenere il conteggio totale delle pagine del documento specificato, facilitando una navigazione efficiente e la gestione di contenuti multi-pagina. Incorporare questa funzionalità per migliorare l’esperienza dell’utente, consentendo un accesso fluido a strutture documentali complete.
pages	Image[]	r	Accedere ai blocchi WebP all’interno dell’immagine, consentendo un esame dettagliato o la manipolazione della struttura a blocchi sottostante. Utilizzare questa proprietà per analizzare o modificare blocchi individuali nei dati immagine WebP, facilitando tecniche avanzate di elaborazione delle immagini nella tua applicazione.
palette	IColorPalette	r/w	Ottiene o imposta la tavolozza dei colori. La tavolozza dei colori non viene utilizzata quando i pixel sono rappresentati direttamente.
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	Ottiene il colore trasparente dell’immagine.
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)	Incorporare un nuovo blocco WebP nell’immagine, arricchendone il contenuto e facilitando una manipolazione avanzata dell’immagine. Integrare questo metodo per migliorare dinamicamente la struttura e la complessità dei dati immagine WebP nella tua applicazione, consentendo un controllo preciso e l’ottimizzazione del rendering dell’immagine.
add_page(page)	Aggiungere una nuova pagina all’immagine, ampliandone il contenuto e accogliendo elementi visivi aggiuntivi. Integrare questo metodo per facilitare la gestione dinamica delle pagine nella tua applicazione, consentendo la creazione fluida e l’ampliamento di documenti o immagini multi-pagina.
adjust_brightness(brightness)	Implementare la regolazione della luminosità per l’immagine, consentendo la modifica dei livelli di luminanza complessiva. Incorporare questo metodo nel flusso di lavoro di elaborazione delle immagini per migliorare la visibilità e la qualità visiva delle immagini nella tua applicazione.
adjust_contrast(contrast)	Migliorare il contrasto dell’Image, amplificando le differenze tra le aree chiare e scure. Integrare questo metodo nel flusso di lavoro di elaborazione delle immagini per migliorare la chiarezza visiva e la qualità complessiva dell’immagine nella tua applicazione.
adjust_gamma(gamma)	Applicare la correzione gamma all’immagine, regolando le intensità dei pixel per ottenere la luminosità e il bilanciamento colore desiderati. Incorporare questo metodo nel flusso di lavoro di elaborazione delle immagini per migliorare la qualità visiva e aumentare l’accuratezza delle successive analisi o visualizzazioni nella tua applicazione.
adjust_gamma(gamma_red, gamma_green, gamma_blue)	Eseguire la correzione gamma sull’immagine utilizzando coefficienti individuali per i canali rosso, verde e blu, consentendo regolazioni precise del bilanciamento colore e del contrasto. Integrare questo metodo nella pipeline di elaborazione delle immagini per ottenere un controllo preciso sulla resa dei colori e migliorare la fedeltà visiva nella tua applicazione.
analyze_percentage_digital_signature(password)	Calcola la percentuale di somiglianza tra i dati estratti e la password originale.
auto_brightness_contrast()	Esegue la normalizzazione automatica adattiva di luminosità e contrasto per l’intera immagine.
auto_rotate()	Ruota automaticamente l’immagine in base ai dati di orientamento estratti dai metadati Exif . Questo metodo garantisce che le immagini vengano visualizzate nella corretta orientazione, migliorando l’esperienza dell’utente ed eliminando la necessità di regolazioni manuali. Analizzando le informazioni Exif, l’immagine viene ruotata di conseguenza, fornendo un’esperienza di visualizzazione fluida su diverse piattaforme e dispositivi. Questo processo di rotazione automatizzata semplifica la gestione delle immagini e migliora l’usabilità complessiva, soprattutto quando si lavora con grandi lotti di immagini con orientamenti variabili.
binarize_bradley(brightness_difference)	Binarizzazione di un’immagine usando l’algoritmo di sogliatura adattiva di Bradley con la sogliatura dell’immagine integrale
binarize_bradley(brightness_difference, window_size)	Applicare la binarizzazione all’immagine usando l’algoritmo di sogliatura adattiva di Bradley con sogliatura basata su immagine integrale. Questo metodo calcola dinamicamente soglie locali basate sul vicinato dell’immagine, migliorando l’adattabilità a condizioni di illuminazione variabili e garantendo una segmentazione robusta per le successive attività di elaborazione nella tua applicazione.
binarize_fixed(threshold)	Eseguire la binarizzazione sull’immagine usando un valore di soglia predefinito, convertendola in un’immagine binaria dove i pixel sono classificati come primo piano o sfondo in base alla loro intensità rispetto alla soglia. Integrare questo metodo nel flusso di lavoro di elaborazione delle immagini per facilitare la segmentazione e l’estrazione di caratteristiche, migliorando l’accuratezza e l’efficienza delle successive analisi nella tua applicazione.
binarize_otsu()	Eseguire la binarizzazione sull’immagine usando il metodo di sogliatura di Otsu, determinando automaticamente il valore di soglia ottimale basato sull’istogramma dell’immagine. Integrare questo metodo nel flusso di lavoro di elaborazione delle immagini per ottenere una segmentazione efficace e l’estrazione di caratteristiche, migliorando l’accuratezza e l’affidabilità delle attività di analisi delle immagini nella tua applicazione.
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 WebP esistenti dall’immagine, facilitando una base pulita per modifiche o aggiunte successive. Utilizzare questo metodo per resettare efficacemente la struttura a blocchi nei dati immagine WebP, garantendo una gestione ottimale e l’organizzazione del contenuto dell’immagine nella tua applicazione.
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_file_with_options(path, load_options)	Inizializza una nuova istanza della classe WebPImage da file.
create_from_files(files)	Crea l’immagine multipagina contenente i file specificati come pagine a caricamento differito.
create_from_files(files, throw_exception_on_load_error)	Crea l’immagine multipagina contenente i file specificati come pagine a caricamento differito.
create_from_image(raster_image)	Inizializza una nuova istanza della classe WebPImage da rasterImage.
create_from_image_with_options(raster_image, load_options)	Inizializza una nuova istanza della classe WebPImage da rasterImage.
create_from_images(images)	Crea una nuova immagine utilizzando le immagini specificate come pagine
create_from_images(images, dispose_images)	Crea una nuova immagine dalle immagini specificate come pagine.
create_from_stream(stream)	Inizializza una nuova istanza della classe WebPImage da stream.
create_from_stream_with_options(stream, load_options)	Inizializza una nuova istanza della classe WebPImage da stream.
crop(left_shift, right_shift, top_shift, bottom_shift)	Ritagliare l’immagine applicando spostamenti sinistro, destro, superiore e inferiore, selezionando efficacemente una regione di interesse all’interno dell’immagine. Utilizzare questo metodo per estrarre dinamicamente le parti desiderate dell’immagine regolando la sua composizione e il fuoco secondo i requisiti della tua applicazione.
crop(rectangle)	Ritagliare l’immagine usando una regione rettangolare specificata, rimuovendo le parti indesiderate mantenendo il contenuto desiderato. Integrare questo metodo nel flusso di lavoro di elaborazione delle immagini per estrarre con precisione e focalizzarsi su aree specifiche di interesse all’interno dell’immagine, migliorando chiarezza e composizione per varie applicazioni.
dither(dithering_method, bits_count)	Esegue il dithering sull’immagine corrente.
dither(dithering_method, bits_count, custom_palette)	Esegui il dithering sull’immagine corrente per ridurre le bande di colore e migliorare la qualità visiva . Integra questo metodo nel tuo flusso di lavoro di elaborazione delle immagini per ottenere transizioni più fluide tra i colori e migliorare l’aspetto complessivo dell’ immagine all’interno della tua applicazione.
embed_digital_signature(password)	Incorpora la firma digitale basata sulla password fornita in ogni pagina dell’immagine.
filter(rectangle, options)	Filtra il contenuto all’interno del rettangolo specificato, applicando un filtro di elaborazione delle immagini designato per migliorare o modificare la regione selezionata. Integra questo metodo nel tuo flusso di lavoro di manipolazione delle immagini per ottenere miglioramenti mirati o trasformazioni all’interno della tua applicazione.
get_argb_32_pixel(x, y)	Ottiene un pixel ARGB a 32 bit dell’immagine.
get_default_argb_32_pixels(rectangle)	Ottiene l’array predefinito di pixel ARGB a 32 bit.
get_default_options(args)	Ottiene le opzioni predefinite.
get_default_pixels(rectangle, partial_pixel_loader)	Ottiene l’array predefinito di pixel usando il caricatore di pixel parziale.
get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings)	Ottiene l’array predefinito di dati grezzi usando il caricatore di pixel parziale.
get_default_raw_data(rectangle, raw_data_settings)	Ottiene l’array predefinito di dati grezzi.
get_file_format(file_path)	Ottiene il formato del file.
get_file_format(stream)	Ottiene il formato del file.
get_file_format_of_stream(stream)	Ottiene il formato del file.
get_fitting_rectangle(rectangle, pixels, width, height)	Ottiene il rettangolo che si adatta all’immagine corrente.
get_fitting_rectangle(rectangle, width, height)	Ottiene il rettangolo che si adatta all’immagine corrente.
get_modify_date(use_default)	Ottiene la data e l’ora dell’ultima modifica dell’immagine di risorsa.
get_original_options()	Ottiene le opzioni basate sulle impostazioni originali del file. Questo può essere utile per mantenere inalterata la profondità di bit e altri parametri dell’immagine originale. Ad esempio, se carichiamo un’immagine PNG in bianco e nero a 1 bit per pixel e poi la salviamo usando il metodo DataStreamSupporter.save(file_path), verrà generata un’immagine PNG di output a 8 bit per pixel. Per evitarlo e salvare l’immagine PNG a 1 bit per pixel, utilizza questo metodo per ottenere le opzioni di salvataggio corrispondenti e passale al metodo Image.save(file_path, options) come secondo parametro.
get_pixel(x, y)	Ottiene un pixel dell’immagine.
get_proportional_height(width, height, new_width)	Ottiene un’altezza proporzionale.
get_proportional_width(width, height, new_height)	Ottiene una larghezza proporzionale.
get_serialized_stream(image_options, clipping_rectangle, page_number)	Converte in aps.
get_skew_angle()	Ottiene l’angolo di inclinazione. Questo metodo è applicabile ai documenti di testo scansionati, per determinare l’angolo di inclinazione durante la scansione.
grayscale()	Converti l’immagine nella sua rappresentazione in scala di grigi, trasformandola in un’immagine a canale singolo dove ogni pixel rappresenta l’intensità o la luminanza. Integra questo metodo nella tua pipeline di elaborazione delle immagini per semplificare l’analisi e migliorare la compatibilità con algoritmi basati sulla scala di grigi, facilitando varie attività di visione artificiale e analisi delle immagini nella tua applicazione.
insert_block(index, block)	Inserisci un nuovo blocco WebP all’indice specificato all’interno dell’immagine, consentendo un controllo preciso sulla sequenza dei blocchi. Integra questo metodo per incorporare senza soluzione di continuità blocchi WebP aggiuntivi nella struttura dei dati dell’immagine, facilitando l’elaborazione avanzata delle immagini e l’ottimizzazione nella tua applicazione.
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 i dati dallo stream.
load_argb_32_pixels(rectangle)	Carica pixel ARGB a 32 bit.
load_argb_64_pixels(rectangle)	Carica pixel ARGB a 64 bit.
load_cmyk_32_pixels(rectangle)	Carica pixel in formato CMYK.
load_cmyk_pixels(rectangle)	Carica pixel in formato CMYK. Questo metodo è deprecato. Si prega di utilizzare il metodo più efficace RasterImage.load_cmyk_32_pixels(rectangle).
load_partial_argb_32_pixels(rectangle, partial_pixel_loader)	Carica parzialmente pixel ARGB a 32 bit (per blocchi).
load_partial_argb_64_pixels(rectangle, partial_pixel_loader)	Carica parzialmente pixel ARGB a 64 bit per pacchetti.
load_partial_pixels(desired_rectangle, pixel_loader)	Carica pixel parzialmente per pacchetti.
load_pixels(rectangle)	Carica pixel.
load_raw_data(rectangle, dest_image_bounds, raw_data_settings, raw_data_loader)	Carica dati grezzi.
load_raw_data(rectangle, raw_data_settings, raw_data_loader)	Carica dati grezzi.
load_stream(stream)	Carica una nuova immagine dallo stream specificato.
load_stream_with_options(stream, load_options)	Carica una nuova immagine dallo stream specificato.
load_with_options(file_path, load_options)	Carica una nuova immagine dal percorso file o URL specificato. Se filePath è un percorso file, il metodo apre semplicemente il file. Se filePath è un URL, il metodo scarica il file, lo memorizza temporaneamente e lo apre.
normalize_angle()	Normalizza l’angolo. Questo metodo è applicabile ai documenti di testo scansionati per eliminare la scansione inclinata. Questo metodo utilizza i metodi RasterImage.get_skew_angle() e RasterImage.rotate(angle).
normalize_angle(resize_proportionally, background_color)	Normalizza l’angolo. Questo metodo è applicabile ai documenti di testo scansionati per eliminare la scansione inclinata. Questo metodo utilizza i metodi RasterImage.get_skew_angle() e RasterCachedMultipageImage.rotate(angle, resize_proportionally, background_color).
normalize_histogram()	Normalizza l’istogramma dell’immagine — regola i valori dei pixel per utilizzare l’intera gamma disponibile.
read_argb_32_scan_line(scan_line_index)	Legge l’intera linea di scansione tramite l’indice di linea di scansione specificato.
read_scan_line(scan_line_index)	Legge l’intera linea di scansione tramite l’indice di linea di scansione specificato.
remove_block(block)	Rimuovi il blocco WebP specificato dall’immagine, facilitando una gestione efficiente della struttura dei dati dell’immagine. Utilizza questo metodo per semplificare i flussi di lavoro di elaborazione delle immagini eliminando blocchi o componenti non necessari nella tua applicazione.
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 l’immagine, regolando le sue dimensioni mantenendo il rapporto d’aspetto. Integra questo metodo nel tuo flusso di lavoro di elaborazione delle immagini per scalare dinamicamente le immagini in modo da soddisfare vari requisiti di visualizzazione o archiviazione nella tua applicazione.
resize(new_width, new_height, settings)	Ridimensiona l’immagine secondo le impostazioni specificate, consentendo un controllo preciso su dimensioni, rapporto d’aspetto e comportamento di scaling. Integra questo metodo nel tuo flusso di lavoro di elaborazione delle immagini per ottenere operazioni di ridimensionamento personalizzate, adattate ai requisiti specifici della tua applicazione.
resize_by_settings(new_width, new_height, settings)	Ridimensiona l’immagine.
resize_by_type(new_width, new_height, resize_type)	Ridimensiona l’immagine.
resize_height_proportionally(new_height)	Ridimensiona l’altezza proporzionalmente. Viene utilizzato il valore predefinito ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.
resize_height_proportionally(new_height, resize_type)	Regola l’altezza dell’immagine proporzionalmente, mantenendo il suo rapporto d’aspetto per un ridimensionamento coerente. Integra questo metodo nel tuo flusso di lavoro di elaborazione delle immagini per ridimensionare dinamicamente le immagini con proporzioni uniformi, garantendo una visualizzazione o archiviazione ottimale nella tua applicazione.
resize_height_proportionally(new_height, settings)	Ridimensiona l’altezza proporzionalmente.
resize_height_proportionally_settings(new_height, settings)	Ridimensiona l’altezza proporzionalmente.
resize_width_proportionally(new_width)	Ridimensiona la larghezza proporzionalmente. Viene utilizzato il valore predefinito ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.
resize_width_proportionally(new_width, resize_type)	Regola proporzionalmente la larghezza dell’immagine mantenendo il suo rapporto d’aspetto. Integra questo metodo nel tuo flusso di lavoro di elaborazione delle immagini per ridimensionare dinamicamente le immagini con proporzioni coerenti, garantendo una visualizzazione o archiviazione ottimale nella tua applicazione.
resize_width_proportionally(new_width, settings)	Ridimensiona la larghezza proporzionalmente.
resize_width_proportionally_settings(new_width, settings)	Ridimensiona la larghezza proporzionalmente.
rotate(angle)	Ruota l’immagine attorno al centro.
rotate(angle, resize_proportionally, background_color)	Ruota l’immagine attorno al suo centro di un angolo specificato, ridimensionandola proporzionalmente e applicando i parametri di colore di sfondo specificati. Integra questo metodo nel tuo flusso di lavoro di elaborazione delle immagini per ottenere trasformazioni precise con colori di sfondo personalizzabili, garantendo una presentazione visiva ottimale nella tua applicazione.
rotate_flip(rotate_flip_type)	Applica rotazione, capovolgimento o entrambe le operazioni esclusivamente al fotogramma attivo all’interno dell’immagine. Integra questo metodo nel tuo flusso di lavoro di elaborazione delle immagini per ottenere una manipolazione precisa dei singoli fotogrammi, migliorando la flessibilità e il controllo sulle trasformazioni dei fotogrammi nella tua applicazione.
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.
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_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: WebPImage(path)

 WebPImage(path)

Instanzia una nuova istanza della classe WebPImage, inizializzata
da una fonte file fornita. Utilizza questo costruttore per creare senza soluzione di continuità oggetti immagine WebP
direttamente dai file, semplificando il processo di caricamento e
manipolazione dei dati immagine WebP nella tua applicazione.

Parameters:

Parametro	Tipo	Descrizione
percorso	string	Il percorso al file immagine WebP

See also:

Example # 1: This example shows how to load a WebP image from a file and save it to PNG.

Constructor: WebPImage(path, load_options)

 WebPImage(path, load_options)

Crea una nuova istanza della classe WebPImage utilizzando un file e
opzioni di caricamento specificate, facilitando una gestione flessibile dei dati immagine WebP. Utilizza
questo costruttore per inizializzare senza soluzione di continuità oggetti immagine WebP dai file mentre
personalizzi i parametri di caricamento secondo i requisiti della tua applicazione.

Parameters:

Parametro	Tipo	Descrizione
percorso	string	Il percorso al file immagine WebP
load_options	LoadOptions	Le opzioni di caricamento.

Constructor: WebPImage(raster_image)

 WebPImage(raster_image)

Instanzia una nuova istanza della classe WebPImage inizializzata
da un oggetto rasterImage fornito. Questo costruttore consente una conversione senza soluzione di continuità
delle immagini raster al formato WebP, permettendo una gestione efficiente e
la manipolazione dei dati immagine nella tua applicazione.

Parameters:

Parametro	Tipo	Descrizione
raster_image	RasterImage	L’immagine raster.

See also:

Example # 1: This example shows how to create a WebP image from another raster image.

Constructor: WebPImage(raster_image, load_options)

 WebPImage(raster_image, load_options)

Crea una nuova istanza della classe WebPImage utilizzando un oggetto rasterImage e
opzioni di caricamento specificate, consentendo una gestione flessibile dei dati immagine. Utilizza
questo costruttore per inizializzare senza soluzione di continuità oggetti immagine WebP da immagini raster mentre
personalizzi i parametri di caricamento secondo i requisiti della tua applicazione.

Parameters:

Parametro	Tipo	Descrizione
raster_image	RasterImage	L’immagine raster.
load_options	LoadOptions	Le opzioni di caricamento.

Constructor: WebPImage(stream)

 WebPImage(stream)

Istanziare una nuova istanza della classe WebPImage , inizializzata
da una sorgente stream fornita. Utilizzare questo costruttore per creare senza problemi oggetti immagine WebP direttamente da stream, consentendo una gestione efficiente e la manipolazione dei dati immagine WebP all’interno della tua applicazione.

Parameters:

Parametro	Tipo	Descrizione
stream	_io.BufferedRandom	Lo stream immagine WebP.

See also:

Example # 1: This example shows how to load a WebP image from a file stream and save it to…

Constructor: WebPImage(stream, load_options)

 WebPImage(stream, load_options)

Creare una nuova istanza della classe WebPImage da uno stream,
incorporando le opzioni di caricamento specificate e le impostazioni di gestione della memoria. Questo costruttore offre flessibilità nel caricare immagini WebP da stream gestendo efficientemente le risorse di memoria, garantendo prestazioni ottimali e utilizzo delle risorse all’interno della tua applicazione.

Parameters:

Parametro	Tipo	Descrizione
stream	_io.BufferedRandom	Lo stream immagine WebP.
load_options	LoadOptions	Le opzioni di caricamento.

Constructor: WebPImage(width, height, options)

 WebPImage(width, height, options)

Istanziare una nuova istanza della classe WebPImage con un’immagine vuota di larghezza e altezza specificate. Questo costruttore consente la creazione di immagini WebP vuote, fornendo una base per la successiva manipolazione dell’immagine e la generazione di contenuti all’interno della tua applicazione.

Parameters:

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

See also:

Example # 1: This example shows how to create a WebP image with the specified options from…

Constructor: WebPImage(width, height, options, load_options)

 WebPImage(width, height, options, load_options)

Creare una nuova istanza della classe WebPImage con un’immagine vuota e le opzioni di caricamento specificate. Questo costruttore permette l’inizializzazione di immagini WebP con parametri di caricamento personalizzabili, offrendo flessibilità nella creazione e manipolazione dell’immagine all’interno della tua applicazione.

Parameters:

Parametro	Tipo	Descrizione
width	int	La larghezza dell’immagine
height	int	L’altezza dell’immagine.
options	WebPOptions	Le opzioni.
load_options	LoadOptions	Le opzioni di caricamento.

Property: has_alpha

Ottenere se l’immagine contiene un canale alfa, indicando la presenza di informazioni di trasparenza. Utilizzare questa proprietà per determinare se l’immagine include trasparenza, consentendo una gestione e un’elaborazione appropriate delle operazioni legate all’alfa all’interno della tua applicazione.

See also:

Example # 1: The following example loads a WEBP image and prints information about raw dat…

Method: add_block(block)

 add_block(block)

Incorporare un nuovo blocco WebP nell’immagine, arricchendone il contenuto e
facilitando una manipolazione avanzata dell’immagine. Integrare questo metodo per migliorare dinamicamente la struttura e la complessità dei dati immagine WebP nella tua applicazione, consentendo un controllo preciso e l’ottimizzazione del rendering dell’immagine.

Parameters:

Parametro	Tipo	Descrizione
block	IFrame	Il blocco WebP da aggiungere.

Method: add_page(page)

 add_page(page)

Aggiungere una nuova pagina all’immagine, ampliandone il contenuto e accogliendo elementi visivi aggiuntivi. Integrare questo metodo per facilitare la gestione dinamica delle pagine nella tua applicazione, consentendo la creazione fluida e l’ampliamento di documenti o immagini multi-pagina.

Parameters:

Parametro	Tipo	Descrizione
page	RasterImage	La pagina da aggiungere.

Method: adjust_brightness(brightness)

 adjust_brightness(brightness)

Implementare la regolazione della luminosità per l’immagine, consentendo la
modifica dei livelli di luminanza complessiva. Incorporare questo metodo nel flusso di lavoro di elaborazione delle immagini per migliorare la visibilità e la qualità visiva delle immagini nella tua applicazione.

Parameters:

Parametro	Tipo	Descrizione
luminosità	int	Valore di luminosità.

Method: adjust_contrast(contrast)

 adjust_contrast(contrast)

Migliorare il contrasto dell’Image, amplificando le
differenze tra le aree chiare e scure. Integrare questo metodo nel flusso di lavoro di elaborazione delle immagini per migliorare la chiarezza visiva e la qualità complessiva dell’immagine nella tua applicazione.

Parameters:

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

Method: adjust_gamma(gamma)

 adjust_gamma(gamma)

Applicare la correzione gamma all’immagine, regolando le intensità dei pixel per ottenere
la luminosità e il bilanciamento colore desiderati. Incorporare questo metodo nel flusso di lavoro di elaborazione delle immagini per migliorare la qualità visiva e aumentare l’accuratezza delle successive analisi o visualizzazioni nella tua applicazione.

Parameters:

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

Method: adjust_gamma(gamma_red, gamma_green, gamma_blue)

 adjust_gamma(gamma_red, gamma_green, gamma_blue)

Eseguire la correzione gamma sull’immagine utilizzando coefficienti individuali per i canali rosso,
verde e blu, consentendo regolazioni precise del bilanciamento colore e del contrasto. Integrare questo metodo nella pipeline di elaborazione delle immagini per ottenere un controllo preciso sulla resa dei colori e migliorare la fedeltà visiva nella tua applicazione.

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

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)

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.

Method: binarize_bradley(brightness_difference, window_size)

 binarize_bradley(brightness_difference, window_size)

Applicare la binarizzazione all’immagine usando l’algoritmo di sogliatura adattiva di Bradley
con sogliatura basata su immagine integrale. Questo metodo calcola dinamicamente soglie locali basate sul vicinato dell’immagine, migliorando l’adattabilità a condizioni di illuminazione variabili e garantendo una segmentazione robusta per le successive attività di elaborazione nella tua applicazione.

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)

Eseguire la binarizzazione sull’immagine usando un valore di soglia predefinito, convertendola
in un’immagine binaria dove i pixel sono classificati come primo piano o sfondo in base alla loro intensità rispetto alla soglia. Integrare questo metodo nel flusso di lavoro di elaborazione delle immagini per facilitare la segmentazione e l’estrazione di caratteristiche, migliorando l’accuratezza e l’efficienza delle successive analisi nella tua applicazione.

Parameters:

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

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_file_with_options(path, load_options) [static]

 create_from_file_with_options(path, load_options)

Inizializza una nuova istanza della classe WebPImage da file.

Parameters:

Parametro	Tipo	Descrizione
percorso	string	Il percorso al file immagine WebP
load_options	LoadOptions	Le opzioni di caricamento.

Returns

Tipo	Descrizione
WebPImage

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

 create_from_image(raster_image)

Inizializza una nuova istanza della classe WebPImage da rasterImage.

Parameters:

Parametro	Tipo	Descrizione
raster_image	RasterImage	L’immagine raster.

Returns

Tipo	Descrizione
WebPImage

Method: create_from_image_with_options(raster_image, load_options) [static]

 create_from_image_with_options(raster_image, load_options)

Inizializza una nuova istanza della classe WebPImage da rasterImage.

Parameters:

Parametro	Tipo	Descrizione
raster_image	RasterImage	L’immagine raster.
load_options	LoadOptions	Le opzioni di caricamento.

Returns

Tipo	Descrizione
WebPImage

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

 create_from_stream(stream)

Inizializza una nuova istanza della classe WebPImage
da stream.

Parameters:

Parametro	Tipo	Descrizione
stream	_io.BufferedRandom	Lo stream immagine WebP.

Returns

Tipo	Descrizione
WebPImage

Method: create_from_stream_with_options(stream, load_options) [static]

 create_from_stream_with_options(stream, load_options)

Inizializza una nuova istanza della classe WebPImage da stream.

Parameters:

Parametro	Tipo	Descrizione
stream	_io.BufferedRandom	Lo stream immagine WebP.
load_options	LoadOptions	Le opzioni di caricamento.

Returns

Tipo	Descrizione
WebPImage

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

 crop(left_shift, right_shift, top_shift, bottom_shift)

Ritagliare l’immagine applicando spostamenti sinistro, destro, superiore e inferiore, selezionando efficacemente
una regione di interesse all’interno dell’immagine. Utilizzare questo metodo per estrarre dinamicamente le parti desiderate dell’immagine regolando la sua composizione e il fuoco secondo i requisiti della tua applicazione.

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)

Ritagliare l’immagine usando una regione rettangolare specificata, rimuovendo le parti indesiderate
mantenendo il contenuto desiderato. Integrare questo metodo nel flusso di lavoro di elaborazione delle immagini per estrarre con precisione e focalizzarsi su aree specifiche di interesse all’interno dell’immagine, migliorando chiarezza e composizione per varie applicazioni.

Parameters:

Parametro	Tipo	Descrizione
rectangle	Rectangle	Il rettangolo.

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)

Esegui il dithering sull’immagine corrente per ridurre le bande di colore e migliorare la qualità visiva
. Integra questo metodo nel tuo flusso di lavoro di elaborazione delle immagini per ottenere
transizioni più fluide tra i colori e migliorare l’aspetto complessivo dell’
immagine all’interno della tua applicazione.

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)

Filtra il contenuto all’interno del rettangolo specificato, applicando un filtro di elaborazione delle immagini
designato per migliorare o modificare la regione selezionata. Integra questo metodo
nel tuo flusso di lavoro di manipolazione delle immagini per ottenere miglioramenti mirati o
trasformazioni all’interno della tua applicazione.

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

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

Returns

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)

Inserisci un nuovo blocco WebP all’indice specificato all’interno dell’immagine, consentendo un controllo preciso
sulla sequenza dei blocchi. Integra questo metodo per incorporare senza soluzione di continuità
blocchi WebP aggiuntivi nella struttura dei dati dell’immagine, facilitando l’elaborazione avanzata delle immagini
e l’ottimizzazione nella tua applicazione.

Parameters:

Parametro	Tipo	Descrizione
index	int	L’elemento indicizzato a zero, al quale il blocco sarà inserito.
block	IFrame	Il blocco WebP 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)

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 i dati dallo stream.

Parameters:

Parametro	Tipo	Descrizione
stream	_io.BufferedRandom	Lo stream immagine WebP.
load_options	LoadOptions	Le opzioni di caricamento

Returns

Tipo	Descrizione
Image

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)

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)

Rimuovi il blocco WebP specificato dall’immagine, facilitando una gestione efficiente
della struttura dei dati dell’immagine. Utilizza questo metodo per semplificare i flussi di lavoro di elaborazione delle immagini
eliminando blocchi o componenti non necessari nella tua applicazione.

Parameters:

Parametro	Tipo	Descrizione
block	IFrame	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)

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 l’immagine, regolando le sue dimensioni mantenendo il rapporto d’aspetto.
Integra questo metodo nel tuo flusso di lavoro di elaborazione delle immagini per scalare dinamicamente
le immagini in modo da soddisfare vari requisiti di visualizzazione o archiviazione nella tua applicazione.

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 l’immagine secondo le impostazioni specificate, consentendo un controllo preciso su
dimensioni, rapporto d’aspetto e comportamento di scaling. Integra questo metodo nel tuo
flusso di lavoro di elaborazione delle immagini per ottenere operazioni di ridimensionamento personalizzate, adattate ai
requisiti specifici della tua applicazione.

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

Regola l’altezza dell’immagine proporzionalmente, mantenendo il suo rapporto d’aspetto
per un ridimensionamento coerente. Integra questo metodo nel tuo flusso di lavoro di elaborazione delle immagini
per ridimensionare dinamicamente le immagini con proporzioni uniformi, garantendo una visualizzazione o
archiviazione ottimale nella tua applicazione.

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

Regola proporzionalmente la larghezza dell’immagine mantenendo il suo rapporto d’aspetto.
Integra questo metodo nel tuo flusso di lavoro di elaborazione delle immagini per ridimensionare dinamicamente
le immagini con proporzioni coerenti, garantendo una visualizzazione o archiviazione ottimale nella
tua applicazione.

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)

Ruota l’immagine attorno al suo centro di un angolo specificato, ridimensionandola proporzionalmente
e applicando i parametri di colore di sfondo specificati. Integra questo
metodo nel tuo flusso di lavoro di elaborazione delle immagini per ottenere trasformazioni precise con
colori di sfondo personalizzabili, garantendo una presentazione visiva ottimale nella tua
applicazione.

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)

Applica rotazione, capovolgimento o entrambe le operazioni esclusivamente al fotogramma attivo
all’interno dell’immagine. Integra questo metodo nel tuo flusso di lavoro di elaborazione delle immagini per
ottenere una manipolazione precisa dei singoli fotogrammi, migliorando la flessibilità e il
controllo sulle trasformazioni dei fotogrammi nella tua applicazione.

Parameters:

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

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.

Parameters:

Parametro	Tipo	Descrizione
stream	_io.BufferedRandom	Lo stream in cui salvare i dati dell’immagine.

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_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 load a WebP image from a file and save it to PNG.


import aspose.pycore as aspycore
from aspose.imaging.fileformats.webp import WebPImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_ = "c:\\temp"
# Carica un'immagine WebP da un file.
with WebPImage(join(dir_, "test.webp")) as web_pimage:
	# Salva in PNG
	# Nota che solo il fotogramma attivo verrà salvato in PNG, poiché PNG non è un formato multi-pagina.
	web_pimage.save(join(dir_, "test.output.png"), PngOptions())

This example shows how to load a WebP image from a file stream and save it to PNG.


import aspose.pycore as aspycore
from aspose.imaging.fileformats.webp import WebPImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_: str = "c:\\temp"
# Carica un'immagine WebP da uno stream di file.
with open(join(dir_, "test.webp"), "w+b") as stream:
	with WebPImage(stream) as web_pimage:
		# Salva in PNG
		# Nota che solo il fotogramma attivo verrà salvato in PNG, poiché PNG non è un formato multi-pagina.
		web_pimage.save(join(dir_, "test.output.png"), PngOptions())

This example shows how to create a WebP image from another raster image.

from os.path import join
from aspose.imaging import Graphics, Color
from aspose.imaging.fileformats.png import PngImage
from aspose.imaging.fileformats.webp import WebPImage
from aspose.imaging.brushes import SolidBrush
from aspose.imaging.imageoptions import WebPOptions      

dir_: str = "c:\\temp"
# Carica un'immagine PNG di 100x100 px.
with PngImage(100, 100) as png_image:
	graphics = Graphics(png_image)
	# Riempire l'intera immagine di rosso.
	brush = SolidBrush(Color.red)
	graphics.fill_rectangle(brush, png_image.bounds)
	# Crea un'immagine WebP basata sull'immagine PNG.
	with WebPImage(png_image) as web_pimage:
		# Salva in un file WebP con le opzioni predefinite
		web_pimage.save(join(dir_, "output.webp"), WebPOptions())

This example shows how to create a WebP image with the specified options from scratch.

from aspose.imaging.fileformats.webp import WebPImage
from aspose.imaging import Graphics, Color
from aspose.imaging.brushes import SolidBrush
from aspose.imaging.imageoptions import WebPOptions
from os.path import join


dir_: str = "c:\\temp"
create_options = WebPOptions()
create_options.lossless = True
create_options.quality = 100.0

# Crea un'immagine WebP di 100x100 px.
with WebPImage(100, 100, create_options) as web_pimage:
	graphics = Graphics(web_pimage)
	# Riempire l'intera immagine di rosso.
	brush = SolidBrush(Color.red)
	graphics.fill_rectangle(brush, web_pimage.bounds)
	# Salva in un file WebP
	web_pimage.save(join(dir_, "output.webp"))

The following example loads a WEBP image and prints information about raw data format and alpha channel.


import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.webp import WebPImage, WebPFrameBlock

dir_ = "c:\\temp"
file_name = dir_ + "sample.webp"
with Image.load(file_name) as image:
	webp_image = aspycore.as_of(image, WebPImage)
	# Se il fotogramma TIFF attivo ha canale alfa, allora l'intera immagine TIFF è considerata con canale alfa.
	print(f"ImageFile={file_name}, FileFormat={webp_image.raw_data_format}, HasAlpha={webp_image.has_alpha}")
	i: int = 0
	for frame in webp_image.blocks:
		if aspycore.is_assignable(frame, WebPFrameBlock):
			frame_block = aspycore.as_of(frame, WebPFrameBlock)
			print(f"Frame={i}, FileFormat={frame_block.raw_data_format}, HasAlpha={frame_block.has_alpha}")
			i += 1

# L'output potrebbe apparire così:
# ImageFile=c:\temp\sample.webp, FileFormat=RgbIndexed1Bpp, used channels: 1, HasAlpha=False
# Frame=0, FileFormat=RgbIndexed1Bpp, used channels: 1, HasAlpha=False

Classe WebPFrameBlock