OtgImage Classe

Summary: Process OpenDocument Template (OTG) drawing image files with our API, leveraging
the OpenDocument XML format with Graphics Content for seamless manipulation.
Easily parse documents, customize background colors, and adjust page dimensions,
ensuring optimal control and flexibility for your OTG vector graphics projects.

Module: aspose.imaging.fileformats.opendocument

Full Name: aspose.imaging.fileformats.opendocument.OtgImage

Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, IObjectWithSizeF, IMultipageImage, OdImage

Constructors

Name	Descrizione
OtgImage(stream_container)	Crea un nuovo oggetto della classe OtgImage fornendo un contenitore di stream . Questo costruttore consente agli sviluppatori di creare immagini OTG direttamente da contenitori di stream, semplificando il processo di lavoro con i dati delle immagini OTG.
OtgImage(stream_container, load_options)	Inizializza un nuovo oggetto OtgImage fornendo un contenitore di stream e opzioni di caricamento. Questo costruttore consente agli sviluppatori di caricare efficientemente immagini OTG da stream specificando configurazioni di caricamento personalizzate.

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 numero di bit per pixel dell’immagine. Questa proprietà fornisce informazioni sul livello di dettaglio e sulla profondità di colore rappresentata nell’immagine, aiutando in varie operazioni di elaborazione e ottimizzazione delle immagini.
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.
default_page	Image	r	Recupera la pagina predefinita associata all’immagine, fornendo accesso essenziale alla pagina principale all’interno della raccolta di immagini. Questa proprietà semplifica la navigazione e la manipolazione dei dati dell’immagine, migliorando l’efficienza dei flussi di lavoro di sviluppo software.
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	Questa proprietà fornisce l’accesso al formato file OTG, offrendo informazioni cruciali sul tipo di dati contenuti nel file immagine. Funziona come punto di riferimento fondamentale per gli sviluppatori software, consentendo loro di gestire efficacemente i file OTG nelle proprie applicazioni. Utilizzando questa proprietà, è possibile determinare il formato specifico del file immagine, facilitando un’integrazione fluida e la manipolazione dei file OTG nei loro sistemi software.
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	Ottiene l’altezza dell’oggetto, in pollici.
interrupt_monitor	InterruptMonitor	r/w	Ottiene o imposta il monitor di interruzione.
is_cached	bool	r	Ottiene un valore booleano che indica se i dati dell’oggetto sono attualmente memorizzati nella cache, eliminando così la necessità di leggere i dati. Questa proprietà funge da indicatore di ottimizzazione, migliorando le prestazioni riducendo le operazioni di accesso ridondante ai dati.
metadata	OdMetadata	r	Recupera i metadati specifici dei file OpenDocument. Questa proprietà consente l’accesso a informazioni essenziali incorporate nei file OD, facilitando varie operazioni come l’estrazione, la modifica o l’analisi dei metadati.
page_count	int	r	Recupera il conteggio totale delle pagine nell’immagine. Questa proprietà è essenziale per le applicazioni che gestiscono immagini multipagina, consentendo loro di determinare con precisione il numero di pagine disponibili per l’elaborazione o la visualizzazione.
pages	Image[]	r	Recupera la collezione di pagine associate all’immagine, consentendo agli sviluppatori software di accedere e manipolare ogni singola pagina in modo efficiente. Questa proprietà facilita l’iterazione fluida attraverso le pagine per varie operazioni, migliorando la funzionalità e la versatilità delle applicazioni di elaborazione delle immagini.
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	OdObject[]	r	Recupera i record OpenDocument memorizzati nell’immagine. Questa proprietà concede l’accesso a specifici elementi di dati strutturati incorporati nei file OpenDocument, facilitando il recupero o la manipolazione delle informazioni pertinenti per ulteriori elaborazioni o analisi.
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	Ottiene la larghezza dell’oggetto, in pollici.
xmp_data	XmpPacketWrapper	r/w	Ottiene o imposta i dati Xmp.

Methods

Name	Descrizione
cache_data()	Memorizza nella cache i dati e garantisce che non venga effettuato alcun caricamento aggiuntivo dei dati dal sottostante DataStreamSupporter.data_stream_container.
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_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 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 l’immagine.
resize(new_width, new_height, settings)	Ridimensiona l’immagine.
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)	Imposta la tavolozza dell’immagine.
try_set_metadata(metadata)	Cerca di impostare un’istanza metadata, se questa istanza di Image supporta e implementa l’istanza IImageMetadataFormat.

Constructor: OtgImage(stream_container)

 OtgImage(stream_container)

Crea un nuovo oggetto della classe OtgImage fornendo un contenitore di stream
. Questo costruttore consente agli sviluppatori di creare immagini OTG direttamente da
contenitori di stream, semplificando il processo di lavoro con i dati delle immagini OTG.

Parameters:

Parametro	Tipo	Descrizione
stream_container	StreamContainer	Il contenitore dello stream.

Constructor: OtgImage(stream_container, load_options)

 OtgImage(stream_container, load_options)

Inizializza un nuovo oggetto OtgImage fornendo un contenitore di stream
e opzioni di caricamento. Questo costruttore consente agli sviluppatori di caricare efficientemente immagini OTG
da stream specificando configurazioni di caricamento personalizzate.

Parameters:

Parametro	Tipo	Descrizione
stream_container	StreamContainer	Lo stream.
load_options	LoadOptions	Le opzioni di caricamento.

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_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 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 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(new_width, new_height, settings)

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

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

The following code snippet demonstrates how to convert an OTG image to PDF and other image formats.


from aspose.pycore import cast
from aspose.imaging import Image, SizeF
from aspose.imaging.imageoptions import PngOptions, PdfOptions, OtgRasterizationOptions

dir_: str = "c:\\3567\\"
input_file_path: str = dir_ + "VariousObjectsMultiPage.otg"
options = [PngOptions(), PdfOptions()]
for save_options in options:
	extension: str = ".png" if aspycore.is_assignable(save_options, PngOptions) else ".pdf"
	with Image.load(input_file_path) as image:
		otg_rasterization_options = OtgRasterizationOptions()
		otg_rasterization_options.page_size = cast(SizeF, image.size)
		save_options.vector_rasterization_options = otg_rasterization_options
		image.save(input_file_path + extension, save_options)

Classe OdgImage