Classe SvgImage

Summary: Manipulate Scalar Vector Graphics (SVG) image files with our API, utilizing
the power of XML-based text format for seamless customization and scalability.
Easily load SVG images, rasterize vector elements, and convert to other formats,
while controlling compression levels to optimize file size and quality for your projects.

Module: aspose.imaging.fileformats.svg

Full Name: aspose.imaging.fileformats.svg.SvgImage

Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, IObjectWithSizeF, VectorImage

Constructors

Name	Descrizione
SvgImage(path)	Instanzia un nuovo oggetto della classe SvgImage, utilizzando il percorso specificato per individuare e caricare l’immagine. Questo costruttore facilita la creazione di istanze di immagini SVG da file esterni, consentendo un’integrazione fluida nei sistemi software e nei flussi di lavoro.
SvgImage(stream)	Crea una nuova istanza della classe SvgImage, caricando l’immagine dal flusso fornito. Questo costruttore consente il caricamento diretto di immagini SVG da stream, migliorando flessibilità ed efficienza nella gestione delle risorse immagine all’interno delle applicazioni software.
SvgImage(svg_options, width, height)	Crea una nuova istanza della classe SvgImage con le opzioni SVG specificate, larghezza e altezza dell’immagine. Questo costruttore consente agli sviluppatori di inizializzare immagini SVG con opzioni e dimensioni personalizzate, offrendo flessibilità nella gestione del contenuto e del layout SVG.
SvgImage(width, height)	Instanzia un nuovo oggetto SvgImage con la larghezza e altezza specificate. Questo costruttore permette agli sviluppatori di creare immagini SVG con dimensioni predefinite facilitando un controllo preciso sulla dimensione dell’immagine durante l’inizializzazione.

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	Restituisce il conteggio dei bit per pixel dell’immagine. È importante notare che questo parametro non è applicabile alle immagini vettoriali, poiché non sono misurate in pixel. Questa proprietà fornisce informazioni cruciali sulla profondità di colore dell’immagine, aiutando nelle attività di elaborazione e manipolazione.
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	Restituisce il formato file dell’immagine, fornendo metadati essenziali per l’elaborazione e i controlli di compatibilità. Questa proprietà è fondamentale per determinare le strategie di decodifica e codifica appropriate per gestire i dati dell’immagine in modo efficace su diversi sistemi e applicazioni.
has_background_color	bool	r/w	Ottiene o imposta un valore che indica se l’immagine ha un colore di sfondo.
height	int	r	Ottiene l’altezza dell’immagine.
height_f	float	r	Ottiene l’altezza dell’oggetto, in pollici.
interrupt_monitor	InterruptMonitor	r/w	Ottiene o imposta il monitor di interruzione.
is_cached	bool	r	Restituisce un valore booleano che indica se i dati dell’oggetto sono attualmente memorizzati nella cache, eliminando la necessità di ulteriori operazioni di lettura dei dati. Questa proprietà fornisce una visione dello stato attuale della cache, ottimizzando il recupero dei dati e i flussi di lavoro di elaborazione per prestazioni ed efficienza migliorate.
metadata	ImageMetadata	r	Ottiene i metadati dell’immagine.
palette	IColorPalette	r/w	Ottiene o imposta la tavolozza dei colori. La tavolozza dei colori non viene utilizzata quando i pixel sono rappresentati direttamente.
size	Size	r	Ottiene la dimensione dell’oggetto.
size_f	SizeF	r	Ottiene le dimensioni dell’oggetto, in pollici.
use_palette	bool	r	Ottiene un valore che indica se la tavolozza dell’immagine è utilizzata.
width	int	r	Ottiene la larghezza dell’immagine.
width_f	float	r	Ottiene la larghezza dell’oggetto, in pollici.
xmp_data	XmpPacketWrapper	r/w	Ottiene o imposta i dati Xmp.

Methods

Name	Descrizione
cache_data()	Memorizza i dati nella cache e garantisce che non avvenga ulteriori caricamenti di dati dal sottostante DataStreamSupporter.data_stream_container. Questa ottimizzazione migliora le prestazioni eliminando operazioni ridondanti di recupero dei dati , particolarmente vantaggiosa in scenari che richiedono accessi frequenti ai dati dell’immagine.
can_load(file_path)	Determina se l’immagine può essere caricata dal percorso file specificato.
can_load(file_path, load_options)	Determina se l’immagine può essere caricata dal percorso file specificato e, opzionalmente, utilizzando le opzioni di apertura specificate.
can_load(stream)	Determina se l’immagine può essere caricata dallo stream specificato.
can_load(stream, load_options)	Determina se l’immagine può essere caricata dallo stream specificato e, opzionalmente, utilizzando le loadOptions specificate.
can_load_stream(stream)	Determina se l’immagine può essere caricata dallo stream specificato.
can_load_stream_with_options(stream, load_options)	Determina se l’immagine può essere caricata dallo stream specificato e, opzionalmente, utilizzando le loadOptions specificate.
can_load_with_options(file_path, load_options)	Determina se l’immagine può essere caricata dal percorso file specificato e, opzionalmente, utilizzando le opzioni di apertura specificate.
can_save(options)	Determina se l’immagine può essere salvata nel formato file specificato rappresentato dalle opzioni di salvataggio fornite.
create(files)	Crea l’immagine multipagina contenente i file specificati.
create(files, throw_exception_on_load_error)	Crea l’immagine multipagina contenente i file specificati.
create(image_options, width, height)	Crea una nuova immagine utilizzando le opzioni di creazione specificate.
create(image_options, width, height, pixels)	Crea un’istanza di RasterImage dall’array di pixel fornito. Convalida che la larghezza e l’altezza specificate corrispondano alle dimensioni dei dati pixel. Questo metodo può essere usato solo quando la libreria è in modalità Licensed.
create(images)	Crea una nuova immagine utilizzando le immagini specificate come pagine
create(images, dispose_images)	Crea una nuova immagine dalle immagini specificate come pagine.
create(multipage_create_options)	Crea le opzioni di creazione multipagina specificate.
create_from_files(files)	Crea l’immagine multipagina contenente i file specificati come pagine a caricamento differito.
create_from_files(files, throw_exception_on_load_error)	Crea l’immagine multipagina contenente i file specificati come pagine a caricamento differito.
create_from_images(images)	Crea una nuova immagine utilizzando le immagini specificate come pagine
create_from_images(images, dispose_images)	Crea una nuova immagine dalle immagini specificate come pagine.
create_from_stream(stream)	Inizializza una nuova istanza della classe SvgImage.
crop(left_shift, right_shift, top_shift, bottom_shift)	Ritaglia l’immagine con spostamenti.
crop(rectangle)	Ritaglia il rettangolo specificato.
get_default_options(args)	Ottiene le opzioni immagine predefinite.
get_embedded_images()	Ottiene le immagini incorporate.
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_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_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.
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 la sezione SVG.
load(stream, load_options)	Carica una nuova immagine dallo stream specificato.
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.
remove_background()	Rimuove lo sfondo.
remove_background(settings)	Rimuove lo sfondo.
remove_metadata()	Rimuove i metadati.
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 per adattarla alle dimensioni specificate mantenendo il suo rapporto d’aspetto rapporto. Questo metodo offre un modo conveniente per regolare le dimensioni dell’immagine senza distorcere le proporzioni, garantendo una visualizzazione o archiviazione secondo le dimensioni desiderate.
resize(new_width, new_height, settings)	Ridimensiona l’immagine con opzioni estese.
resize_by_settings(new_width, new_height, settings)	Ridimensiona l’immagine.
resize_by_type(new_width, new_height, resize_type)	Ridimensiona l’immagine.
resize_height_proportionally(new_height)	Ridimensiona l’altezza proporzionalmente. Viene utilizzato il valore predefinito ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.
resize_height_proportionally(new_height, resize_type)	Ridimensiona l’altezza proporzionalmente.
resize_height_proportionally(new_height, settings)	Ridimensiona l’altezza proporzionalmente.
resize_height_proportionally_settings(new_height, settings)	Ridimensiona l’altezza proporzionalmente.
resize_width_proportionally(new_width)	Ridimensiona la larghezza proporzionalmente. Viene utilizzato il valore predefinito ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.
resize_width_proportionally(new_width, resize_type)	Ridimensiona la larghezza proporzionalmente.
resize_width_proportionally(new_width, settings)	Ridimensiona la larghezza proporzionalmente.
resize_width_proportionally_settings(new_width, settings)	Ridimensiona la larghezza proporzionalmente.
rotate(angle)	Ruota l’immagine attorno al centro.
rotate_flip(rotate_flip_type)	Ruota, capovolge o ruota e capovolge l’immagine.
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_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_palette(palette, update_colors)	Applica una tavolozza specificata all’immagine, consentendo la personalizzazione del colore schemi per scopi estetici o funzionali. Questo metodo offre flessibilità nella gestione delle tavolozze di colore per soddisfare varie esigenze di progettazione o applicazione.
try_set_metadata(metadata)	Cerca di impostare un’istanza metadata, se questa istanza di Image supporta e implementa l’istanza IImageMetadataFormat.

Constructor: SvgImage(path)

 SvgImage(path)

Instanzia un nuovo oggetto della classe SvgImage, utilizzando il
percorso specificato per individuare e caricare l’immagine. Questo costruttore facilita la
creazione di istanze di immagini SVG da file esterni, consentendo un’integrazione fluida
nei sistemi software e nei flussi di lavoro.

Parameters:

Parametro	Tipo	Descrizione
percorso	string	Il percorso da cui caricare l’immagine e con cui inizializzare i dati dei pixel e della palette.

Constructor: SvgImage(stream)

 SvgImage(stream)

Crea una nuova istanza della classe SvgImage, caricando l’immagine
dal flusso fornito. Questo costruttore consente il caricamento diretto di immagini SVG
da stream, migliorando flessibilità ed efficienza nella gestione delle risorse immagine
all’interno delle applicazioni software.

Parameters:

Parametro	Tipo	Descrizione
stream	_io.BufferedRandom	Lo stream da cui caricare l’immagine e con cui inizializzare i dati dei pixel e della palette.

See also:

Example # 1: This example shows how to load an SVG image from a file stream and rasterize …

Constructor: SvgImage(svg_options, width, height)

 SvgImage(svg_options, width, height)

Crea una nuova istanza della classe SvgImage con le opzioni SVG
specificate, larghezza e altezza dell’immagine. Questo costruttore consente
agli sviluppatori di inizializzare immagini SVG con opzioni e dimensioni personalizzate,
offrendo flessibilità nella gestione del contenuto e del layout SVG.

Parameters:

Parametro	Tipo	Descrizione
svg_options	SvgOptions	Le opzioni SVG.
width	int	Larghezza immagine.
height	int	Altezza immagine.

Constructor: SvgImage(width, height)

 SvgImage(width, height)

Instanzia un nuovo oggetto SvgImage con la larghezza e
altezza specificate. Questo costruttore permette agli sviluppatori di creare immagini SVG con dimensioni predefinite
facilitando un controllo preciso sulla dimensione dell’immagine durante
l’inizializzazione.

Parameters:

Parametro	Tipo	Descrizione
width	int	La larghezza dell’immagine.
height	int	L’altezza dell’immagine.

Method: can_load(file_path) [static]

 can_load(file_path)

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

Parameters:

Parametro	Tipo	Descrizione
file_path	string	Il percorso del file.

Returns

Tipo	Descrizione
bool	true se l’immagine può essere caricata dal file specificato; altrimenti, false.

Method: can_load(file_path, load_options) [static]

 can_load(file_path, load_options)

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

Parameters:

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

Returns

Tipo	Descrizione
bool	true se l’immagine può essere caricata dal file specificato; altrimenti, false.

Method: can_load(stream) [static]

 can_load(stream)

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

Parameters:

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

Returns

Tipo	Descrizione
bool	true se l’immagine può essere caricata dal flusso specificato; altrimenti, false.

Method: can_load(stream, load_options) [static]

 can_load(stream, load_options)

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

Parameters:

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

Returns

Tipo	Descrizione
bool	true se l’immagine può essere caricata dal flusso specificato; altrimenti, false.

Method: can_load_stream(stream) [static]

 can_load_stream(stream)

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

Parameters:

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

Returns

Tipo	Descrizione
bool	true se l’immagine può essere caricata dal flusso specificato; altrimenti, false.

Method: can_load_stream_with_options(stream, load_options) [static]

 can_load_stream_with_options(stream, load_options)

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

Parameters:

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

Returns

Tipo	Descrizione
bool	true se l’immagine può essere caricata dal flusso specificato; altrimenti, false.

Method: can_load_with_options(file_path, load_options) [static]

 can_load_with_options(file_path, load_options)

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

Parameters:

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

Returns

Tipo	Descrizione
bool	true se l’immagine può essere caricata dal file specificato; altrimenti, false.

Method: can_save(options)

 can_save(options)

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

Parameters:

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

Returns

Tipo	Descrizione
bool	true se l’immagine può essere salvata nel formato di file specificato rappresentato dalle opzioni di salvataggio fornite; altrimenti, false.

Method: create(files) [static]

 create(files)

Crea l’immagine multipagina contenente i file specificati.

Parameters:

Parametro	Tipo	Descrizione
file	string[]	I file.

Returns

Tipo	Descrizione
Image	L’immagine multipagina

Method: create(files, throw_exception_on_load_error) [static]

 create(files, throw_exception_on_load_error)

Crea l’immagine multipagina contenente i file specificati.

Parameters:

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

Returns

Tipo	Descrizione
Image	L’immagine multipagina

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

 create(image_options, width, height)

Crea una nuova immagine utilizzando le opzioni di creazione specificate.

Parameters:

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

Returns

Tipo	Descrizione
Image	L’immagine appena creata.

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

 create(image_options, width, height, pixels)

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

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

Parameters:

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

Returns

Tipo	Descrizione
Image	Una RasterImage popolata con i dati dei pixel forniti.

Method: create(images) [static]

 create(images)

Crea una nuova immagine utilizzando le immagini specificate come pagine

Parameters:

Parametro	Tipo	Descrizione
images	Image[]	Le immagini.

Returns

Tipo	Descrizione
Image	L’Image come IMultipageImage

Method: create(images, dispose_images) [static]

 create(images, dispose_images)

Crea una nuova immagine dalle immagini specificate come pagine.

Parameters:

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

Returns

Tipo	Descrizione
Image	L’Image come IMultipageImage

Method: create(multipage_create_options) [static]

 create(multipage_create_options)

Crea le opzioni di creazione multipagina specificate.

Parameters:

Parametro	Tipo	Descrizione
multipage_create_options	MultipageCreateOptions	Le opzioni di creazione multipagina.

Returns

Tipo	Descrizione
Image	L’immagine multipagina

Method: create_from_files(files) [static]

 create_from_files(files)

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

Parameters:

Parametro	Tipo	Descrizione
file	string[]	I file.

Returns

Tipo	Descrizione
Image	L’immagine multipagina

Method: create_from_files(files, throw_exception_on_load_error) [static]

 create_from_files(files, throw_exception_on_load_error)

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

Parameters:

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

Returns

Tipo	Descrizione
Image	L’immagine multipagina

Method: create_from_images(images) [static]

 create_from_images(images)

Crea una nuova immagine utilizzando le immagini specificate come pagine

Parameters:

Parametro	Tipo	Descrizione
images	Image[]	Le immagini.

Returns

Tipo	Descrizione
Image	L’Image come IMultipageImage

Method: create_from_images(images, dispose_images) [static]

 create_from_images(images, dispose_images)

Crea una nuova immagine dalle immagini specificate come pagine.

Parameters:

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

Returns

Tipo	Descrizione
Image	L’Image come IMultipageImage

Method: create_from_stream(stream) [static]

 create_from_stream(stream)

Inizializza una nuova istanza della classe SvgImage.

Parameters:

Parametro	Tipo	Descrizione
stream	_io.BufferedRandom	Lo stream da cui caricare l’immagine e con cui inizializzare i dati dei pixel e della palette.

Returns

Tipo	Descrizione
SvgImage

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

 crop(left_shift, right_shift, top_shift, bottom_shift)

Ritaglia l’immagine con spostamenti.

Parameters:

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

Method: crop(rectangle)

 crop(rectangle)

Ritaglia il rettangolo specificato.

Parameters:

Parametro	Tipo	Descrizione
rectangle	Rectangle	Il rettangolo.

Method: get_default_options(args)

 get_default_options(args)

Ottiene le opzioni immagine predefinite.

Parameters:

Parametro	Tipo	Descrizione
args	System.Object	Gli argomenti.

Returns

Tipo	Descrizione
ImageOptionsBase	Le opzioni immagine predefinite.

Method: get_embedded_images()

 get_embedded_images()

Ottiene le immagini incorporate.

Returns

Tipo	Descrizione
EmbeddedImage[]	Array di immagini

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_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_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: 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 la sezione SVG.

Parameters:

Parametro	Tipo	Descrizione
stream	_io.BufferedRandom

Returns

Tipo	Descrizione
Image

Method: load(stream, load_options) [static]

 load(stream, load_options)

Carica una nuova immagine dallo stream specificato.

Parameters:

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

Returns

Tipo	Descrizione
Image	L’immagine caricata.

Method: load_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: remove_background(settings)

 remove_background(settings)

Rimuove lo sfondo.

Parameters:

Parametro	Tipo	Descrizione
settings	RemoveBackgroundSettings	Le impostazioni.

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 per adattarla alle dimensioni specificate mantenendo il suo rapporto d’aspetto
rapporto. Questo metodo offre un modo conveniente per regolare le dimensioni dell’immagine
senza distorcere le proporzioni, garantendo una visualizzazione o archiviazione
secondo le dimensioni desiderate.

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 con opzioni estese.

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)

Ridimensiona l’altezza proporzionalmente.

Parameters:

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

Method: resize_height_proportionally(new_height, settings)

 resize_height_proportionally(new_height, settings)

Ridimensiona l’altezza proporzionalmente.

Parameters:

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

Method: resize_height_proportionally_settings(new_height, settings)

 resize_height_proportionally_settings(new_height, settings)

Ridimensiona l’altezza proporzionalmente.

Parameters:

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

Method: resize_width_proportionally(new_width)

 resize_width_proportionally(new_width)

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

Parameters:

Parametro	Tipo	Descrizione
new_width	int	La nuova larghezza.

Method: resize_width_proportionally(new_width, resize_type)

 resize_width_proportionally(new_width, resize_type)

Ridimensiona la larghezza proporzionalmente.

Parameters:

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

Method: resize_width_proportionally(new_width, settings)

 resize_width_proportionally(new_width, settings)

Ridimensiona la larghezza proporzionalmente.

Parameters:

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

Method: resize_width_proportionally_settings(new_width, settings)

 resize_width_proportionally_settings(new_width, settings)

Ridimensiona la larghezza proporzionalmente.

Parameters:

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

Method: rotate(angle)

 rotate(angle)

Ruota l’immagine attorno al centro.

Parameters:

Parametro	Tipo	Descrizione
angle	float	L’angolo di rotazione in gradi. I valori positivi ruoteranno in senso orario.

Method: rotate_flip(rotate_flip_type)

 rotate_flip(rotate_flip_type)

Ruota, capovolge o ruota e capovolge l’immagine.

Parameters:

Parametro	Tipo	Descrizione
rotate_flip_type	RotateFlipType	Tipo di 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	Il flusso in cui salvare i dati.

Method: save(stream, options_base)

 save(stream, options_base)

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

Parameters:

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_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_palette(palette, update_colors)

 set_palette(palette, update_colors)

Applica una tavolozza specificata all’immagine, consentendo la personalizzazione del colore
schemi per scopi estetici o funzionali. Questo metodo offre flessibilità
nella gestione delle tavolozze di colore per soddisfare varie esigenze di progettazione o applicazione.

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: 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.

Examples

This example shows how to load an SVG image from a file stream and rasterize it to PNG.

import aspose.pycore as aspycore
from os.path import join
from aspose.imaging.fileformats.svg import SvgImage
from aspose.imaging.imageoptions import PngOptions, SvgRasterizationOptions

dir_: str = "c:\\temp"
# Carica un'immagine SVG da un flusso di file.
with open(join(dir_, "test.svg"), "rb") as stream:
	with SvgImage(stream) as svg_image:
		# Per rasterizzare SVG è necessario specificare le opzioni di rasterizzazione.
		rasterization_options = SvgRasterizationOptions()
		save_options = PngOptions()
		save_options.vector_rasterization_options = rasterization_options
		svg_image.save(join(dir_, "test.output.png"), save_options)

The following example shows how to convert compressed images (.emz,.wmz, *.svgz) to a raster format

from aspose.imaging import Image, Color
from aspose.imaging.imageoptions import PngOptions, VectorRasterizationOptions
from os.path import join
from aspose.pycore import as_of

files = ["example.emz", "example.wmz", "example.svgz"]
base_folder: str = join("D:", "Compressed")
for file in files:
	input_file: str = join(base_folder, file)
	out_file: str = input_file + ".png"
	with Image.load(input_file) as image:
		vector_rasterization_options = aspycore.as_of(image.get_default_options([Color.white, image.width, image.height]), VectorRasterizationOptions)
		obj_init = PngOptions()
		obj_init.vector_rasterization_options = vector_rasterization_options
		image.save(out_file, obj_init)

The following example shows how to convert a svgz images to svg fromat

import aspose.pycore as aspycore
from aspose.imaging import Image, SizeF
from aspose.imaging.imageoptions import SvgRasterizationOptions, SvgOptions
from os.path import join

file: str = "example.svgz"
base_folder: str = join("D:", "Compressed")
input_file: str = join(base_folder, file)
out_file: str = input_file + ".svg"
with Image.load(input_file) as image:
	obj_init = SvgRasterizationOptions()
	obj_init.page_size = aspycore.cast(SizeF, image.size)
	obj_init2 = SvgOptions()
	obj_init2.vector_rasterization_options = obj_init
	image.save(out_file, obj_init2)

The following example shows how to convert a svg images to svgz format


from os.path import join as path_combine
import aspose.pycore as aspycore
from aspose.imaging import Image, SizeF
from aspose.imaging.imageoptions import SvgRasterizationOptions, SvgOptions

file = "juanmontoya_lingerie.svg"
base_folder = path_combine("D:", "Compressed")
input_file = path_combine(base_folder, file)
out_file = input_file + ".svgz"
with Image.load(input_file) as image:
	vector_rasterization_options = SvgRasterizationOptions()
	vector_rasterization_options.page_size = aspycore.cast(SizeF, image.size)
	obj_init2 = SvgOptions()
	obj_init2.vector_rasterization_options = vector_rasterization_options
	obj_init2.compress = True
	image.save(out_file, obj_init2)

Classe ISvgResourceKeeperCallback Classe SvgResourceKeeperCallback