Classe WmfImage

Summary: Manipulate Microsoft Windows Metafile (WMF) images with our API, seamlessly
handling both vector and bitmap data stored within variable-length records.
Resize, rotate, and flip images with ease while setting custom image palettes.
Convert WMF files to compressed WMZ formats or save them in raster image formats
for versatile usage across platforms and applications.

Module: aspose.imaging.fileformats.wmf

Full Name: aspose.imaging.fileformats.wmf.WmfImage

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

Constructors

Name	Descrizione
WmfImage()	Crea una nuova istanza della classe WmfImage, inizializzandola per ulteriori manipolazioni e l’elaborazione dei dati immagine Windows Metafile (WMF). Questo costruttore fornisce un oggetto di base per lavorare con le immagini WMF, consentendo un’integrazione fluida delle capacità di gestione delle immagini WMF nella funzionalità della tua applicazione.
WmfImage(width, height)	Istanzia una nuova istanza della classe WmfImage con parametri di larghezza e altezza personalizzabili, facilitando la creazione di immagini WMF vuote su misura per dimensioni specifiche. Utilizza questo costruttore per generare dinamicamente immagini WMF con dimensioni precise, consentendo una creazione e manipolazione flessibile delle immagini 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	Recupera il conteggio dei bit per pixel dell’immagine, indicando il livello di profondità o granularità del colore Utilizza questa proprietà per determinare la rappresentazione e la precisione del colore dell’immagine, facilitando i controlli di compatibilità e l’elaborazione correlata al colore all’interno della tua applicazione.
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.
frame_bounds	Rectangle	r	Accedi ai limiti del fotogramma, indicando la sua posizione e le sue dimensioni all’interno dell’ immagine. Utilizza questa proprietà per recuperare informazioni dettagliate sulla posizione spaziale del fotogramma, consentendo una manipolazione e un rendering precisi 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.
height	int	r	Ottiene l’altezza dell’oggetto.
height_f	float	r	Accedi all’altezza dell’immagine, rappresentante il numero di pixel lungo il suo asse verticale Utilizza questa proprietà per determinare le dimensioni spaziali e il rapporto d’aspetto dell’immagine, consentendo regolazioni accurate del layout e del rendering all’interno della tua applicazione.
pollice	int	r/w	Accedi o modifica la proprietà inch, che rappresenta un’unità di misura tipicamente utilizzata per specificare le dimensioni fisiche in contesti di stampa o visualizzazione. Utilizza questa proprietà per impostare o recuperare i valori in pollici associati all’immagine, facilitando una rappresentazione accurata delle dimensioni fisiche all’interno della tua applicazione.
interrupt_monitor	InterruptMonitor	r/w	Ottiene o imposta il monitor di interruzione.
is_cached	bool	r	Recupera un valore booleano che indica se i dati dell’oggetto sono attualmente nella cache, eliminando la necessità di operazioni aggiuntive di lettura dei dati. Utilizza questa proprietà per ottimizzare le prestazioni determinando se i dati dell’oggetto sono prontamente disponibili senza la necessità di costosi processi di recupero dati all’interno della tua applicazione.
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.
records	MetaObjectList	r/w	Ottiene o imposta i record.
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’oggetto.
width_f	float	r	Accedi alla larghezza dell’immagine, indicando il numero di pixel lungo il suo asse orizzontale Utilizza questa proprietà per determinare le dimensioni spaziali e il rapporto d’aspetto dell’immagine, consentendo regolazioni precise del layout e del rendering all’interno della tua applicazione.
xmp_data	XmpPacketWrapper	r/w	Ottiene o imposta i dati Xmp.

Methods

Name	Descrizione
add_record(record)	Incorpora l’oggetto record specificato nell’immagine, arricchendo il suo contenuto con dati o metadati aggiuntivi. Utilizza questo metodo per integrare senza soluzione di continuità gli oggetti record nell’immagine, facilitando l’archiviazione e l’organizzazione completa dei dati all’interno della tua applicazione.
cache_data()	Cache i dati in modo efficiente, eliminando la necessità di caricamenti aggiuntivi dal sottostante DataStreamSupporter.data_stream_container. Utilizza questo metodo per ottimizzare le prestazioni e ridurre al minimo l’uso delle risorse nella tua applicazione memorizzando e accedendo alla cache locale dei dati.
can_load(file_path)	Determina se l’immagine può essere caricata dal percorso file specificato.
can_load(file_path, load_options)	Determina se l’immagine può essere caricata dal percorso file specificato e, opzionalmente, utilizzando le opzioni di apertura specificate.
can_load(stream)	Determina se l’immagine può essere caricata dallo stream specificato.
can_load(stream, load_options)	Determina se l’immagine può essere caricata dallo stream specificato e, opzionalmente, utilizzando le loadOptions specificate.
can_load_stream(stream)	Determina se l’immagine può essere caricata dallo stream specificato.
can_load_stream_with_options(stream, load_options)	Determina se l’immagine può essere caricata dallo stream specificato e, opzionalmente, utilizzando le loadOptions specificate.
can_load_with_options(file_path, load_options)	Determina se l’immagine può essere caricata dal percorso file specificato e, opzionalmente, utilizzando le opzioni di apertura specificate.
can_save(options)	Determina se l’immagine può essere salvata nel formato file specificato rappresentato dalle opzioni di salvataggio fornite.
create(files)	Crea l’immagine multipagina contenente i file specificati.
create(files, throw_exception_on_load_error)	Crea l’immagine multipagina contenente i file specificati.
create(image_options, width, height)	Crea una nuova immagine utilizzando le opzioni di creazione specificate.
create(image_options, width, height, pixels)	Crea un’istanza di RasterImage dall’array di pixel fornito. Convalida che la larghezza e l’altezza specificate corrispondano alle dimensioni dei dati pixel. Questo metodo può essere usato solo quando la libreria è in modalità Licensed.
create(images)	Crea una nuova immagine utilizzando le immagini specificate come pagine
create(images, dispose_images)	Crea una nuova immagine dalle immagini specificate come pagine.
create(multipage_create_options)	Crea le opzioni di creazione multipagina specificate.
create_from_files(files)	Crea l’immagine multipagina contenente i file specificati come pagine a caricamento differito.
create_from_files(files, throw_exception_on_load_error)	Crea l’immagine multipagina contenente i file specificati come pagine a caricamento differito.
create_from_images(images)	Crea una nuova immagine utilizzando le immagini specificate come pagine
create_from_images(images, dispose_images)	Crea una nuova immagine dalle immagini specificate come pagine.
crop(left_shift, right_shift, top_shift, bottom_shift)	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_missed_fonts()	Restituisce l’elenco dei caratteri utilizzati all’interno del metafile ma non trovati.
get_original_options()	Ottiene le opzioni dell’immagine originale.
get_post_script()	Accedi ai dati PostScript associati all’immagine, fornendo informazioni dettagliate sulla sua struttura o contenuto. Utilizza questo metodo per recuperare i dati PostScript per ulteriori analisi o elaborazioni all’interno della tua applicazione, abilitando funzionalità avanzate relative al rendering o alla manipolazione di PostScript.
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_used_fonts()	Recupera l’elenco dei caratteri utilizzati all’interno del metafile, fornendo una panoramica delle risorse di carattere utilizzate nell’immagine. Utilizza questo metodo per analizzare l’uso dei caratteri e garantire la disponibilità dei caratteri per il rendering o ulteriori elaborazioni all’interno della tua applicazione.
load(file_path)	Carica una nuova immagine dal percorso file o URL specificato. Se filePath è un percorso file, il metodo apre semplicemente il file. Se filePath è un URL, il metodo scarica il file, lo memorizza temporaneamente e lo apre.
load(file_path, load_options)	Carica una nuova immagine dal percorso file o URL specificato. Se filePath è un percorso file, il metodo apre semplicemente il file. Se filePath è un URL, il metodo scarica il file, lo memorizza temporaneamente e lo apre.
load(stream)	Carica una nuova immagine dallo stream specificato.
load(stream, load_options)	Carica una nuova immagine dallo stream specificato.
load_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 la larghezza nuova specificata.
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_canvas(new_rectangle)	Ridimensiona la tela dell’immagine, regolando le sue dimensioni mantenendo il contenuto dell’immagine intatto. Utilizza questo metodo per modificare le dimensioni della tela senza alterare il contenuto, facilitando le regolazioni del layout e le modifiche di composizione all’interno della tua applicazione.
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 nello stream specificato.
save(stream, options_base)	Salva i dati dell’immagine nello stream specificato nel formato file indicato secondo le opzioni di salvataggio.
save(stream, options_base, bounds_rectangle)	Salva i dati dell’immagine nello stream specificato nel formato file indicato secondo le opzioni di salvataggio.
save_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 della rappresentazione dei colori Utilizza questo metodo per migliorare il rendering visivo e ottenere effetti di colore specifici all’interno della tua applicazione.
try_set_metadata(metadata)	Cerca di impostare un’istanza metadata, se questa istanza di Image supporta e implementa l’istanza IImageMetadataFormat.

Constructor: WmfImage()

 WmfImage()

Crea una nuova istanza della classe WmfImage, inizializzandola per
ulteriori manipolazioni e l’elaborazione dei dati immagine Windows Metafile (WMF). Questo
costruttore fornisce un oggetto di base per lavorare con le immagini WMF, consentendo
un’integrazione fluida delle capacità di gestione delle immagini WMF nella funzionalità della tua applicazione.

Constructor: WmfImage(width, height)

 WmfImage(width, height)

Istanzia una nuova istanza della classe WmfImage con parametri di larghezza e altezza personalizzabili, facilitando la creazione di immagini WMF vuote
su misura per dimensioni specifiche. Utilizza questo costruttore per generare dinamicamente
immagini WMF con dimensioni precise, consentendo una creazione e manipolazione flessibile delle immagini all’interno della tua applicazione.

Parameters:

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

Method: add_record(record)

 add_record(record)

Incorpora l’oggetto record specificato nell’immagine, arricchendo il suo contenuto con
dati o metadati aggiuntivi. Utilizza questo metodo per integrare senza soluzione di continuità gli oggetti record nell’immagine, facilitando l’archiviazione e l’organizzazione completa dei dati all’interno della tua applicazione.

Parameters:

Parametro	Tipo	Descrizione
record	WmfObject	Il record.

Returns

Tipo	Descrizione
int	Numero di record.

Method: can_load(file_path) [static]

 can_load(file_path)

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

Parameters:

Parametro	Tipo	Descrizione
file_path	string	Il percorso del file.

Returns

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

Method: can_load(file_path, load_options) [static]

 can_load(file_path, load_options)

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

Parameters:

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

Returns

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

Method: can_load(stream) [static]

 can_load(stream)

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

Parameters:

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

Returns

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

Method: can_load(stream, load_options) [static]

 can_load(stream, load_options)

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

Parameters:

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

Returns

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

Method: can_load_stream(stream) [static]

 can_load_stream(stream)

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

Parameters:

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

Returns

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

Method: can_load_stream_with_options(stream, load_options) [static]

 can_load_stream_with_options(stream, load_options)

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

Parameters:

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

Returns

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

Method: can_load_with_options(file_path, load_options) [static]

 can_load_with_options(file_path, load_options)

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

Parameters:

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

Returns

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

Method: can_save(options)

 can_save(options)

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

Parameters:

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

Returns

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

Method: create(files) [static]

 create(files)

Crea l’immagine multipagina contenente i file specificati.

Parameters:

Parametro	Tipo	Descrizione
file	string[]	I file.

Returns

Tipo	Descrizione
Image	L’immagine multipagina

Method: create(files, throw_exception_on_load_error) [static]

 create(files, throw_exception_on_load_error)

Crea l’immagine multipagina contenente i file specificati.

Parameters:

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

Returns

Tipo	Descrizione
Image	L’immagine multipagina

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

 create(image_options, width, height)

Crea una nuova immagine utilizzando le opzioni di creazione specificate.

Parameters:

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

Returns

Tipo	Descrizione
Image	L’immagine appena creata.

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

 create(image_options, width, height, pixels)

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

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

Parameters:

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

Returns

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

Method: create(images) [static]

 create(images)

Crea una nuova immagine utilizzando le immagini specificate come pagine

Parameters:

Parametro	Tipo	Descrizione
images	Image[]	Le immagini.

Returns

Tipo	Descrizione
Image	L’Image come IMultipageImage

Method: create(images, dispose_images) [static]

 create(images, dispose_images)

Crea una nuova immagine dalle immagini specificate come pagine.

Parameters:

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

Returns

Tipo	Descrizione
Image	L’Image come IMultipageImage

Method: create(multipage_create_options) [static]

 create(multipage_create_options)

Crea le opzioni di creazione multipagina specificate.

Parameters:

Parametro	Tipo	Descrizione
multipage_create_options	MultipageCreateOptions	Le opzioni di creazione multipagina.

Returns

Tipo	Descrizione
Image	L’immagine multipagina

Method: create_from_files(files) [static]

 create_from_files(files)

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

Parameters:

Parametro	Tipo	Descrizione
file	string[]	I file.

Returns

Tipo	Descrizione
Image	L’immagine multipagina

Method: create_from_files(files, throw_exception_on_load_error) [static]

 create_from_files(files, throw_exception_on_load_error)

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

Parameters:

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

Returns

Tipo	Descrizione
Image	L’immagine multipagina

Method: create_from_images(images) [static]

 create_from_images(images)

Crea una nuova immagine utilizzando le immagini specificate come pagine

Parameters:

Parametro	Tipo	Descrizione
images	Image[]	Le immagini.

Returns

Tipo	Descrizione
Image	L’Image come IMultipageImage

Method: create_from_images(images, dispose_images) [static]

 create_from_images(images, dispose_images)

Crea una nuova immagine dalle immagini specificate come pagine.

Parameters:

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

Returns

Tipo	Descrizione
Image	L’Image come IMultipageImage

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

 crop(left_shift, right_shift, top_shift, bottom_shift)

Ritaglia l’immagine con spostamenti.

Parameters:

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

Method: crop(rectangle)

 crop(rectangle)

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

 get_missed_fonts()

Restituisce l’elenco dei caratteri utilizzati all’interno del metafile ma non trovati.

Returns

Tipo	Descrizione
string[]	L’elenco dei caratteri

Method: get_original_options()

 get_original_options()

Ottiene le opzioni dell’immagine originale.

Returns

Tipo	Descrizione
ImageOptionsBase	Le opzioni dell’immagine originale.

Method: get_post_script()

 get_post_script()

Accedi ai dati PostScript associati all’immagine, fornendo informazioni dettagliate
sulla sua struttura o contenuto. Utilizza questo metodo per recuperare
i dati PostScript per ulteriori analisi o elaborazioni all’interno della tua applicazione,
abilitando funzionalità avanzate relative al rendering o alla manipolazione di PostScript.

Returns

Tipo	Descrizione
string	Il post script

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

 get_used_fonts()

Recupera l’elenco dei caratteri utilizzati all’interno del metafile, fornendo una panoramica delle
risorse di carattere utilizzate nell’immagine. Utilizza questo metodo per analizzare l’uso dei caratteri
e garantire la disponibilità dei caratteri per il rendering o ulteriori elaborazioni all’interno della tua applicazione.

Returns

Tipo	Descrizione
string[]	L’elenco dei caratteri

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 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 la larghezza nuova specificata.

Parameters:

Parametro	Tipo	Descrizione
new_width	int	La nuova larghezza.
new_height	int	La nuova altezza.
resize_type	ResizeType	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_canvas(new_rectangle)

 resize_canvas(new_rectangle)

Ridimensiona la tela dell’immagine, regolando le sue dimensioni mantenendo il contenuto dell’immagine
intatto. Utilizza questo metodo per modificare le dimensioni della tela senza alterare il
contenuto, facilitando le regolazioni del layout e le modifiche di composizione all’interno della tua
applicazione.

Parameters:

Parametro	Tipo	Descrizione
new_rectangle	Rectangle	Il nuovo rettangolo.

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 nello stream specificato.

Parameters:

Parametro	Tipo	Descrizione
stream	_io.BufferedRandom	Lo stream.

Method: save(stream, options_base)

 save(stream, options_base)

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

Parameters:

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 della rappresentazione dei colori
Utilizza questo metodo per migliorare il rendering visivo e ottenere
effetti di colore specifici all’interno della tua 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 durante il 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 a WMF image from a file and convert it to SVG using WmfRasterizationOptions.


from aspose.pycore import as_of, cast
from aspose.imaging import Image, Color, SizeF
from aspose.imaging.fileformats.wmf import WmfImage, WmfRenderMode
from aspose.imaging.imageoptions import SvgOptions, WmfRasterizationOptions

# Utilizzare Aspose.Imaging.Image.Load è un modo unificato per caricare tutti i tipi di immagini, incluso WMF.
with as_of(Image.load("test.wmf") as image:
	saveOptions = SvgOptions()
	# Il testo verrà convertito in forme.
	saveOptions.text_as_shapes = True
	rasterizationOptions = WmfRasterizationOptions()
	# Il colore di sfondo della superficie di disegno.
	rasterizationOptions.background_color = Color.white_smoke
	# La dimensione della pagina.
	rasterizationOptions.page_size = cast(SizeF, wmfImage.size)
	# Se esiste un emf incorporato, renderizzare emf; altrimenti renderizzare wmf.
	rasterizationOptions.render_mode = WmfRenderMode.AUTO
	saveOptions.vector_rasterization_options = rasterizationOptions
	wmfImage.save("test.output.svg", saveOptions)

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 wmz images to wmf fromat

import aspose.pycore as aspycore
from aspose.imaging import Image, SizeF
from aspose.imaging.imageoptions import WmfRasterizationOptions, WmfOptions
from os.path import join

file: str = "example.wmz"
base_folder: str = join("D:", "Compressed")
input_file: str = join(base_folder, file)
out_file: str = input_file + ".wmf"
with Image.load(input_file) as image:
	obj_init = WmfRasterizationOptions()
	obj_init.page_size = aspycore.cast(SizeF, image.size)
	obj_init2 = WmfOptions()
	obj_init2.vector_rasterization_options = obj_init
	image.save(out_file, obj_init2)

The following example shows how to convert a wmf images to wmz 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 WmfRasterizationOptions, WmfOptions

file = "castle.wmf"
base_folder = path_combine("D:", "Compressed")
input_file = path_combine(base_folder, file)
out_file = input_file + ".wmz"
with Image.load(input_file) as image:
	vector_rasterization_options = WmfRasterizationOptions()
	vector_rasterization_options.page_size = aspycore.cast(SizeF, image.size)
	obj_init2 = WmfOptions()
	obj_init2.vector_rasterization_options = vector_rasterization_options
	obj_init2.compress = True
	image.save(out_file, obj_init2)

Enumerazione WmfRenderMode