Classe Image

Summary: The image is the base class for all type of images.

Module: aspose.imaging

Full Name: aspose.imaging.Image

Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, DataStreamSupporter

Properties

NameTypeAccessDescrizione
auto_adjust_paletteboolr/wOttiene o imposta un valore che indica se la palette viene regolata automaticamente.
background_colorColorr/wOttiene o imposta un valore per il colore di sfondo.
bits_per_pixelintrOttiene il conteggio dei bit per pixel dell’immagine.
boundsRectanglerOttiene i limiti dell’immagine.
buffer_size_hintintr/wOttiene o imposta il suggerimento della dimensione del buffer, che è definito come dimensione massima consentita per tutti i buffer interni.
containerImagerOttiene il contenitore Image.
data_stream_containerStreamContainerrOttiene lo stream di dati dell’oggetto.
eliminatoboolrOttiene un valore che indica se questa istanza è stata eliminata.
exif_dataExifDatar/wOttiene o imposta i dati Exif.
file_formatFileFormatrOttiene un valore del formato file
has_background_colorboolr/wOttiene o imposta un valore che indica se l’immagine ha un colore di sfondo.
heightintrOttiene l’altezza dell’immagine.
interrupt_monitorInterruptMonitorr/wOttiene o imposta il monitor di interruzione.
is_cachedboolrRestituisce un valore che indica se i dati dell’oggetto sono attualmente nella cache e non è necessario leggere i dati.
metadataImageMetadatarOttiene i metadati dell’immagine.
paletteIColorPaletter/wOttiene o imposta la tavolozza dei colori. La tavolozza dei colori non viene utilizzata quando i pixel sono rappresentati direttamente.
sizeSizerOttiene le dimensioni dell’immagine.
use_paletteboolrOttiene un valore che indica se la tavolozza dell’immagine è utilizzata.
widthintrOttiene la larghezza dell’immagine.
xmp_dataXmpPacketWrapperr/wOttiene o imposta i dati Xmp.

Methods

NameDescrizione
cache_data()Memorizza nella cache i dati e garantisce che non vengano caricati ulteriori dati dal DataStreamSupporter.data_stream_container sottostante.
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 predefinite.
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_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 dell’oggetto nello stream specificato.
save(stream, options_base)Salva i dati dell’immagine nello stream specificato nel formato file indicato secondo le opzioni di salvataggio.
save(stream, options_base, bounds_rectangle)Salva i dati dell’immagine nello stream specificato nel formato file indicato secondo le opzioni di salvataggio.
save_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)Prova a impostare un’istanza metadata, se questa istanza di Image supporta e implementa il tipo IImageMetadataFormat.

Property: use_palette

Ottiene un valore che indica se la tavolozza dell’immagine è utilizzata.

See also:

Example # 1: Determine if the palette is used by the image.

Method: can_load(file_path) [static]

 can_load(file_path) 

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

Parameters:

ParametroTipoDescrizione
file_pathstringIl percorso del file.

Returns

TipoDescrizione
booltrue se l’immagine può essere caricata dal file specificato; altrimenti, false.

See also:

Example # 1: This example determines whether image can be loaded from a file.

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:

ParametroTipoDescrizione
file_pathstringIl percorso del file.
load_optionsLoadOptionsLe opzioni di caricamento.

Returns

TipoDescrizione
booltrue 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:

ParametroTipoDescrizione
stream_io.BufferedRandomIl flusso da cui caricare.

Returns

TipoDescrizione
booltrue se l’immagine può essere caricata dal flusso specificato; altrimenti, false.

See also:

Example # 1: This example determines whether image can be loaded from a file stream.

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:

ParametroTipoDescrizione
stream_io.BufferedRandomIl flusso da cui caricare.
load_optionsLoadOptionsLe opzioni di caricamento.

Returns

TipoDescrizione
booltrue 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:

ParametroTipoDescrizione
stream_io.BufferedRandomIl flusso da cui caricare.

Returns

TipoDescrizione
booltrue 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:

ParametroTipoDescrizione
stream_io.BufferedRandomIl flusso da cui caricare.
load_optionsLoadOptionsLe opzioni di caricamento.

Returns

TipoDescrizione
booltrue 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:

ParametroTipoDescrizione
file_pathstringIl percorso del file.
load_optionsLoadOptionsLe opzioni di caricamento.

Returns

TipoDescrizione
booltrue 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:

ParametroTipoDescrizione
optionsImageOptionsBaseLe opzioni di salvataggio da utilizzare.

Returns

TipoDescrizione
booltrue se l’immagine può essere salvata nel formato di file specificato rappresentato dalle opzioni di salvataggio fornite; altrimenti, false.

See also:

Example # 1: This example shows how to determine whether image can be saved to the specifi…

Method: create(files) [static]

 create(files) 

Crea l’immagine multipagina contenente i file specificati.

Parameters:

ParametroTipoDescrizione
filestring[]I file.

Returns

TipoDescrizione
ImageL’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:

ParametroTipoDescrizione
filestring[]I file.
throw_exception_on_load_errorboolse impostato su true [throw exception on load error].

Returns

TipoDescrizione
ImageL’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:

ParametroTipoDescrizione
image_optionsImageOptionsBaseLe opzioni dell’immagine.
widthintLa larghezza.
heightintL’altezza.

Returns

TipoDescrizione
ImageL’immagine appena creata.

See also:

Example # 1: This example creates a new Image file at some disk location as specified by S…

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:

ParametroTipoDescrizione
image_optionsImageOptionsBaseLe opzioni utilizzate per creare il RasterImage.
widthintLa larghezza del RasterImage.
heightintL’altezza del RasterImage.
pixelint[]L’array di valori dei pixel usato per popolare l’immagine.

Returns

TipoDescrizione
ImageUna 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:

ParametroTipoDescrizione
imagesImage[]Le immagini.

Returns

TipoDescrizione
ImageL’Image come IMultipageImage

Method: create(images, dispose_images) [static]

 create(images, dispose_images) 

Crea una nuova immagine dalle immagini specificate come pagine.

Parameters:

ParametroTipoDescrizione
imagesImage[]Le immagini.
dispose_imagesboolse impostato su true [dispose images].

Returns

TipoDescrizione
ImageL’Image come IMultipageImage

Method: create(multipage_create_options) [static]

 create(multipage_create_options) 

Crea le opzioni di creazione multipagina specificate.

Parameters:

ParametroTipoDescrizione
multipage_create_optionsMultipageCreateOptionsLe opzioni di creazione multipagina.

Returns

TipoDescrizione
ImageL’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:

ParametroTipoDescrizione
filestring[]I file.

Returns

TipoDescrizione
ImageL’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:

ParametroTipoDescrizione
filestring[]I file.
throw_exception_on_load_errorboolse impostato su true lancia un’eccezione in caso di errore di caricamento.

Returns

TipoDescrizione
ImageL’immagine multipagina

Method: create_from_images(images) [static]

 create_from_images(images) 

Crea una nuova immagine utilizzando le immagini specificate come pagine

Parameters:

ParametroTipoDescrizione
imagesImage[]Le immagini.

Returns

TipoDescrizione
ImageL’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:

ParametroTipoDescrizione
imagesImage[]Le immagini.
dispose_imagesboolse impostato su true [dispose images].

Returns

TipoDescrizione
ImageL’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:

ParametroTipoDescrizione
left_shiftintLo shift a sinistra.
right_shiftintLo shift a destra.
top_shiftintLo shift superiore.
bottom_shiftintLo shift inferiore.

Method: crop(rectangle)

 crop(rectangle) 

Ritaglia il rettangolo specificato.

Parameters:

ParametroTipoDescrizione
rectangleRectangleIl rettangolo.

Method: get_default_options(args)

 get_default_options(args) 

Ottiene le opzioni predefinite.

Parameters:

ParametroTipoDescrizione
argsSystem.ObjectGli argomenti.

Returns

TipoDescrizione
ImageOptionsBaseOpzioni predefinite

Method: get_file_format(file_path) [static]

 get_file_format(file_path) 

Ottiene il formato del file.

Parameters:

ParametroTipoDescrizione
file_pathstringIl percorso del file.

Returns

TipoDescrizione
FileFormatIl formato file determinato.

See also:

Example # 1: This example shows how to determine the image format without loading the enti…

Method: get_file_format(stream) [static]

 get_file_format(stream) 

Ottiene il formato del file.

Parameters:

ParametroTipoDescrizione
stream_io.BufferedRandomLo stream.

Returns

TipoDescrizione
FileFormatIl formato file determinato.

See also:

Example # 1: This example shows how to determine the image format without loading the enti…

Method: get_file_format_of_stream(stream) [static]

 get_file_format_of_stream(stream) 

Ottiene il formato del file.

Parameters:

ParametroTipoDescrizione
stream_io.BufferedRandomLo stream.

Returns

TipoDescrizione
FileFormatIl 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:

ParametroTipoDescrizione
rectangleRectangleIl rettangolo per cui ottenere il rettangolo di adattamento.
pixelint[]I pixel ARGB a 32 bit.
widthintLa larghezza dell’oggetto.
heightintL’altezza dell’oggetto.

Returns

TipoDescrizione
RectangleIl 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:

ParametroTipoDescrizione
rectangleRectangleIl rettangolo per cui ottenere il rettangolo di adattamento.
widthintLa larghezza dell’oggetto.
heightintL’altezza dell’oggetto.

Returns

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

TipoDescrizione
ImageOptionsBaseLe 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:

ParametroTipoDescrizione
widthintLa larghezza.
heightintL’altezza.
new_widthintLa nuova larghezza.

Returns

TipoDescrizione
intL’altezza proporzionale.

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

 get_proportional_width(width, height, new_height) 

Ottiene una larghezza proporzionale.

Parameters:

ParametroTipoDescrizione
widthintLa larghezza.
heightintL’altezza.
new_heightintLa nuova altezza.

Returns

TipoDescrizione
intLa 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:

ParametroTipoDescrizione
image_optionsImageOptionsBaseLe opzioni dell’immagine.
clipping_rectangleRectangleIl rettangolo di ritaglio.
page_numberint[]Il numero di pagina.

Returns

TipoDescrizione
_io.BufferedRandomIl 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:

ParametroTipoDescrizione
file_pathstringIl percorso file o l’URL da cui caricare l’immagine.

Returns

TipoDescrizione
ImageL’immagine caricata.

See also:

Example # 1: This example demonstrates the loading of an existing Image file into an insta…

Method: load(file_path, load_options) [static]

 load(file_path, load_options) 

Carica una nuova immagine dal percorso file o URL specificato.
Se filePath è un percorso file, il metodo apre semplicemente il file.
Se filePath è un URL, il metodo scarica il file, lo memorizza temporaneamente e lo apre.

Parameters:

ParametroTipoDescrizione
file_pathstringIl percorso file o l’URL da cui caricare l’immagine.
load_optionsLoadOptionsLe opzioni di caricamento.

Returns

TipoDescrizione
ImageL’immagine caricata.

Method: load(stream) [static]

 load(stream) 

Carica una nuova immagine dallo stream specificato.

Parameters:

ParametroTipoDescrizione
stream_io.BufferedRandomIl flusso da cui caricare l’immagine.

Returns

TipoDescrizione
ImageL’immagine caricata.

See also:

Example # 1: This example demonstrates the use of a file stream objects to load an existin…

Method: load(stream, load_options) [static]

 load(stream, load_options) 

Carica una nuova immagine dallo stream specificato.

Parameters:

ParametroTipoDescrizione
stream_io.BufferedRandomIl flusso da cui caricare l’immagine.
load_optionsLoadOptionsLe opzioni di caricamento.

Returns

TipoDescrizione
ImageL’immagine caricata.

Method: load_stream(stream) [static]

 load_stream(stream) 

Carica una nuova immagine dallo stream specificato.

Parameters:

ParametroTipoDescrizione
stream_io.BufferedRandomIl flusso da cui caricare l’immagine.

Returns

TipoDescrizione
ImageL’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:

ParametroTipoDescrizione
stream_io.BufferedRandomIl flusso da cui caricare l’immagine.
load_optionsLoadOptionsLe opzioni di caricamento.

Returns

TipoDescrizione
ImageL’immagine caricata.

Method: load_with_options(file_path, load_options) [static]

 load_with_options(file_path, load_options) 

Carica una nuova immagine dal percorso file o URL specificato.
Se filePath è un percorso file, il metodo apre semplicemente il file.
Se filePath è un URL, il metodo scarica il file, lo memorizza temporaneamente e lo apre.

Parameters:

ParametroTipoDescrizione
file_pathstringIl percorso file o l’URL da cui caricare l’immagine.
load_optionsLoadOptionsLe opzioni di caricamento.

Returns

TipoDescrizione
ImageL’immagine caricata.

Method: resize(new_width, new_height)

 resize(new_width, new_height) 

Ridimensiona l’immagine. Viene utilizzato il valore predefinito ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.

Parameters:

ParametroTipoDescrizione
new_widthintLa nuova larghezza.
new_heightintLa nuova altezza.

See also:

Example # 1: The following example shows how to resize a metafile (WMF and EMF).

Example # 2: The following example shows how to resize SVG image and save it to PNG.

Method: resize(new_width, new_height, resize_type)

 resize(new_width, new_height, resize_type) 

Ridimensiona l’immagine.

Parameters:

ParametroTipoDescrizione
new_widthintLa nuova larghezza.
new_heightintLa nuova altezza.
resize_typeResizeTypeIl tipo di ridimensionamento.

See also:

Example # 1: Resize image using specific Resize Type.

Method: resize(new_width, new_height, settings)

 resize(new_width, new_height, settings) 

Ridimensiona l’immagine.

Parameters:

ParametroTipoDescrizione
new_widthintLa nuova larghezza.
new_heightintLa nuova altezza.
settingsImageResizeSettingsLe impostazioni di ridimensionamento.

See also:

Example # 1: This example loads an image and resizes it using various resizing settings.

Example # 2: Resize image using specific Resize Type.

Method: resize_by_settings(new_width, new_height, settings)

 resize_by_settings(new_width, new_height, settings) 

Ridimensiona l’immagine.

Parameters:

ParametroTipoDescrizione
new_widthintLa nuova larghezza.
new_heightintLa nuova altezza.
settingsImageResizeSettingsLe 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:

ParametroTipoDescrizione
new_widthintLa nuova larghezza.
new_heightintLa nuova altezza.
resize_typeResizeTypeIl 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:

ParametroTipoDescrizione
new_heightintLa nuova altezza.

Method: resize_height_proportionally(new_height, resize_type)

 resize_height_proportionally(new_height, resize_type) 

Ridimensiona l’altezza proporzionalmente.

Parameters:

ParametroTipoDescrizione
new_heightintLa nuova altezza.
resize_typeResizeTypeTipo di ridimensionamento.

See also:

Example # 1: This example loads an image and resizes it proportionally using various resiz…

Method: resize_height_proportionally(new_height, settings)

 resize_height_proportionally(new_height, settings) 

Ridimensiona l’altezza proporzionalmente.

Parameters:

ParametroTipoDescrizione
new_heightintLa nuova altezza.
settingsImageResizeSettingsLe 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:

ParametroTipoDescrizione
new_heightintLa nuova altezza.
settingsImageResizeSettingsLe 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:

ParametroTipoDescrizione
new_widthintLa nuova larghezza.

Method: resize_width_proportionally(new_width, resize_type)

 resize_width_proportionally(new_width, resize_type) 

Ridimensiona la larghezza proporzionalmente.

Parameters:

ParametroTipoDescrizione
new_widthintLa nuova larghezza.
resize_typeResizeTypeTipo di ridimensionamento.

See also:

Example # 1: This example loads an image and resizes it proportionally using various resiz…

Method: resize_width_proportionally(new_width, settings)

 resize_width_proportionally(new_width, settings) 

Ridimensiona la larghezza proporzionalmente.

Parameters:

ParametroTipoDescrizione
new_widthintLa nuova larghezza.
settingsImageResizeSettingsLe 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:

ParametroTipoDescrizione
new_widthintLa nuova larghezza.
settingsImageResizeSettingsLe impostazioni di ridimensionamento dell’immagine.

Method: rotate(angle)

 rotate(angle) 

Ruota l’immagine attorno al centro.

Parameters:

ParametroTipoDescrizione
anglefloatL’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:

ParametroTipoDescrizione
rotate_flip_typeRotateFlipTypeTipo di rotazione e capovolgimento.

See also:

Example # 1: This example demonstrates the use of Rotate operation on an image. Example lo…

Example # 2: This example loads an image, rotates it by 90 degrees clockwise and optionall…

Method: save(file_path)

 save(file_path) 

Salva l’immagine nella posizione file specificata.

Parameters:

ParametroTipoDescrizione
file_pathstringIl 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:

ParametroTipoDescrizione
file_pathstringIl percorso del file.
optionsImageOptionsBaseLe opzioni.

See also:

Example # 1: This example shows the simple steps to save an Image. To demonstrate this ope…

Example # 2: The following example loads a BMP image from a file, then saves the image to …

Example # 3: The following example shows how to save an entire BMP image or part of it to …

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:

ParametroTipoDescrizione
file_pathstringIl percorso del file.
optionsImageOptionsBaseLe opzioni.
bounds_rectangleRectangleIl rettangolo dei limiti dell’immagine di destinazione. Imposta il rettangolo vuoto per utilizzare i limiti della sorgente.

See also:

Example # 1: The following example loads a BMP image from a file, then saves a rectangular…

Example # 2: The following example shows how to save an entire BMP image or part of it to …

Method: save(file_path, over_write)

 save(file_path, over_write) 

Salva i dati dell’oggetto nella posizione file specificata.

Parameters:

ParametroTipoDescrizione
file_pathstringIl percorso file in cui salvare i dati dell’oggetto.
over_writeboolse impostato su true sovrascrive il contenuto del file, altrimenti verrà effettuata un’aggiunta.

Method: save(stream)

 save(stream) 

Salva i dati dell’oggetto nello stream specificato.

Parameters:

ParametroTipoDescrizione
stream_io.BufferedRandomIl flusso in cui salvare i dati dell’oggetto.

Method: save(stream, options_base)

 save(stream, options_base) 

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

Parameters:

ParametroTipoDescrizione
stream_io.BufferedRandomIl flusso in cui salvare i dati dell’immagine.
options_baseImageOptionsBaseLe opzioni di salvataggio.

See also:

Example # 1: This example shows the process of saving an Image to MemoryStream. To demonst…

Example # 2: The following example loads an image from a file, then saves the image to a P…

Example # 3: The following example shows how to save an entire BMP image or part of it to …

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:

ParametroTipoDescrizione
stream_io.BufferedRandomIl flusso in cui salvare i dati dell’immagine.
options_baseImageOptionsBaseLe opzioni di salvataggio.
bounds_rectangleRectangleIl rettangolo dei limiti dell’immagine di destinazione. Imposta il rettangolo vuoto per utilizzare i limiti della sorgente.

See also:

Example # 1: The following example loads an image from a file, then saves a rectangular pa…

Example # 2: The following example shows how to save an entire BMP image or part of it to …

Method: save_to_stream(stream)

 save_to_stream(stream) 

Salva i dati dell’oggetto nello stream specificato.

Parameters:

ParametroTipoDescrizione
stream_io.BufferedRandomIl 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:

ParametroTipoDescrizione
stream_io.BufferedRandomIl flusso in cui salvare i dati dell’immagine.
options_baseImageOptionsBaseLe 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:

ParametroTipoDescrizione
stream_io.BufferedRandomIl flusso in cui salvare i dati dell’immagine.
options_baseImageOptionsBaseLe opzioni di salvataggio.
bounds_rectangleRectangleIl 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:

ParametroTipoDescrizione
file_pathstringIl percorso del file.
optionsImageOptionsBaseLe 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:

ParametroTipoDescrizione
file_pathstringIl percorso del file.
optionsImageOptionsBaseLe opzioni.
bounds_rectangleRectangleIl 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:

ParametroTipoDescrizione
paletteIColorPaletteLa tavolozza da impostare.
update_colorsboolse 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) 

Prova a impostare un’istanza metadata, se questa istanza di Image supporta e implementa il tipo IImageMetadataFormat.

Parameters:

ParametroTipoDescrizione
metadataIImageMetadataFormatI metadati.

Returns

TipoDescrizione
boolTrue, se l’istanza di Image supporta e implementa il tipo IImageMetadataFormat; altrimenti, false.

Examples

This example demonstrates the loading of an existing Image file into an instance of aspose.imaging.Image using file path specified


from aspose.imaging import Image
# Crea un'istanza di Image e inizializzala con un file immagine esistente dalla posizione su disco
with Image.load(r"C:\temp\sample.bmp") as image:
	# esegui qualche elaborazione dell'immagine
	pass

This example creates a new Image file at some disk location as specified by Source property of the BmpOptions instance. Several properties for BmpOptions instance are set before creating the actual image. Especially the Source property, that refers to the actual disk location in this case.


from aspose.imaging import Image
from aspose.imaging.imageoptions import BmpOptions
from aspose.imaging.sources import FileCreateSource

#Crea un'istanza di `BmpOptions` e imposta le sue varie proprietà
with BmpOptions() as bmp_options:
	bmp_options.bits_per_pixel = 24

	#Crea un'istanza di `FileCreateSource` e assegnala come `source` per l'istanza di `BmpOptions`
	#Il secondo parametro `Boolean` determina se il file da creare è_temporal o meno
	bmp_options.source = FileCreateSource(r"C:\temp\output.bmp", False)

	#Crea un'istanza di Image e inizializzala con l'istanza di BmpOptions chiamando il metodo Create
	with Image.create(bmp_options, 500, 500) as image:
		#esegui qualche elaborazione dell'immagine
		# salva tutte le modifiche
		image.save()

This example demonstrates the use of a file stream objects to load an existing Image file


from aspose.imaging import Image

# Crea un'istanza di FileStream
with open(r"C:\temp\sample.bmp", "rb"):
	#Crea un'istanza della classe Image e carica un file esistente tramite l'oggetto FileStream chiamando il metodo Load
	with Image.load(stream) as image:
		#esegui qualche elaborazione di immagine.
		pass

This example demonstrates the use of Rotate operation on an image. Example loads an existing image file from some disk location and performs the Rotate operation on the image according to the value of enumeration aspose.imaging.RotateFlipType


from aspose.imaging import Image, RotateFlipType
#Crea un'istanza della classe immagine e inizializzala con un file immagine esistente tramite File path
with Image.load(r"C:\temp\sample.bmp") as image:
	# ruota l'immagine di 180 gradi attorno all'asse X
	image.rotate_flip(RotateFlipType.ROTATE_180_FLIP_X)
	# salva tutte le modifiche.
	image.save()

This example shows the simple steps to save an Image. To demonstrate this operation, we load an existing file from some disk location, performs rotate operation on the image and save the image in PSD format using file path


from aspose.imaging import Image, RotateFlipType
from aspose.imaging.imageoptions import PsdOptions
from os.path import join as path_join

directory = "c:\\temp"

#Crea un'istanza della classe immagine e inizializzala con un file esistente tramite File path
with Image.load(path_join(directory, "sample.bmp")) as image:
	#Ruota l'immagine di 180 gradi attorno all'asse X
	image.rotate_flip(RotateFlipType.ROTATE_180_FLIP_X)
	#Salva l'Immagine come PSD su File Path con le impostazioni predefinite di PsdOptions
	image.save(path_join(directory, "output.psd"), PsdOptions())

This example shows the process of saving an Image to MemoryStream. To demonstrate this operation, example loads an existing file from some disk location, performs rotate operation on the image and save the image in PSD format

from aspose.imaging import Image, RotateFlipType
from aspose.imaging.imageoptions import PsdOptions
from aspose.imaging.extensions import StreamExtensions as stream_ext

#Crea un'istanza di MemoryStream
with stream_ext.create_memory_stream() as stream:
	#Crea un'istanza della classe immagine e inizializzala con un file esistente tramite File path
	with Image.load(r"C:\temp\sample.bmp") as image:
		#Ruota l'immagine di 180 gradi attorno all'asse X
		image.rotate_flip(RotateFlipType.ROTATE_180_FLIP_X)
		#Salva l'Immagine come PSD su MemoryStream con le impostazioni predefinite di PsdOptions
		image.save(stream, PsdOptions())

This example determines whether image can be loaded from a file.


from aspose.imaging import Image

# Usa un percorso assoluto per il file
can_load: bool = Image.can_load(r"c:\temp\sample.gif")

This example determines whether image can be loaded from a file stream.


from aspose.imaging import Image
from aspose.imaging.extensions import StreamExtensions as strm_ext
import os.path import join

directory = r"c:\temp"

canLoad = False

# Usa un flusso di file
with open(join(directory, "sample.bmp"), "rb"):
	canLoad = Image.can_load(stream)

print(f"Can load the file: {canLoad}")

# I dati seguenti non sono un flusso di immagine valido, quindi CanLoad restituisce false.
imageData = [0, 0, 0, 0, 0, 0, 0, 0]
with strm_ext.create_memory_stream_from_bytes(imageData) as stream:
	canLoad = Image.can_load(stream)

print(f"Can load the byte buffer: {canLoad}")

This example shows how to determine the image format without loading the entire image from a file.


from aspose.imaging import Image
from os.path import join as path_join

directory = "c:\\temp\\"

# Usa un percorso assoluto per il file
file_format = Image.get_file_format(path_join(directory, "sample.gif"))
print(f"The file format is {file_format}")

This example shows how to determine the image format without loading the entire image from a file stream.


from aspose.imaging import Image
from aspose.imaging.extensions import StreamExtensions as strm_ex
from os.path import join as path_join

directory = "c:\\temp\\"

# Usa un flusso di file
with open(path_join(directory, "sample.bmp"), "rb") as stream:
	file_format = Image.get_file_format(stream)
	print(f"The file format is {file_format}")

# I dati seguenti non sono un flusso di immagine valido, quindi get_file_format restituisce FileFormat.UNKNOWN
imageData = bytearray([0, 0, 0, 0, 0, 0, 0, 0])
with strm_ex.create_memory_stream_from_bytes(imageData) as stream:
	file_format = Image.get_file_format(stream)
	print(f"The file format is {file_format}")

This example shows how to determine whether image can be saved to the specified file format represented by the passed save options.


from aspose.imaging import Image
from aspose.imaging.imageoptions import JpegOptions
from os.path import join as path_join

directory = "c:\\temp\\"

with Image.load(path_join(directory, "sample.gif")) as image:
	saveOptions = JpegOptions()
	saveOptions.quality = 50
	# Determina se l'immagine può essere salvata in jpeg
	canSave: bool = image.can_save(saveOptions)
	print(canSave)

This example loads an image and resizes it using various resizing settings.

from aspose.imaging import Image, ImageResizeSettings, ResizeType, ImageFilterType,\
	ColorQuantizationMethod
from os.path import join as path_join

directory = "c:\\temp\\"

resizeSettings = ImageResizeSettings()

# L'algoritmo adattivo basato su funzione razionale pesata e mescolata e interpolazione lanczos3.
resizeSettings.mode = ResizeType.ADAPTIVE_RESAMPLE
# Il piccolo filtro rettangolare
resizeSettings.filter_type = ImageFilterType.SMALL_RECTANGULAR
# Il numero di colori nella tavolozza.
resizeSettings.entries_count = 256
# La quantizzazione del colore non è utilizzata
resizeSettings.color_quantization_method = ColorQuantizationMethod.NONE

# Il metodo euclideo
resizeSettings.ColorCompareMethod = ColorCompareMethod.Euclidian;

with Image.load(path_join(directory, "sample.gif")) as image:
	# Riduci di 2 volte usando il ricampionamento adattivo.
	image.resize(image.width // 2, image.height // 2, resizeSettings)
	image.save(path_join(directory, "downsample.adaptive.gif"))

This example loads an image and resizes it proportionally using various resizing methods. Only the width is specified, the height is calculated automatically.

from aspose.imaging import Image, ResizeType
from os.path import join as path_join

directory = "c:\\temp\\"

with Image.load(path_join(directory, "sample.gif")) as image:
	# Ingrandisci di 2 volte usando il ricampionamento Nearest Neighbour.
	image.resize_width_proportionally(image.width * 2, ResizeType.NEAREST_NEIGHBOUR_RESAMPLE)
	image.save(path_join(directory, "upsample.nearestneighbour.gif"))

with Image.load(path_join(directory, "sample.gif")) as image:
	# Riduci di 2 volte usando il ricampionamento Nearest Neighbour.
	image.resize_width_proportionally(image.width // 2, ResizeType.NEAREST_NEIGHBOUR_RESAMPLE)
	image.save(path_join(directory, "downsample.nearestneighbour.gif"))

with Image.load(path_join(directory, "sample.gif")) as image:
	# Ingrandisci di 2 volte usando il ricampionamento bilineare.
	image.resize_width_proportionally(image.width * 2, ResizeType.BILINEAR_RESAMPLE)
	image.save(path_join(directory, "upsample.bilinear.gif"))

with Image.load(path_join(directory, "sample.gif")) as image:
	# Riduci di 2 volte usando il ricampionamento bilineare.
	image.resize_width_proportionally(image.width // 2, ResizeType.BILINEAR_RESAMPLE);
	image.save(path_join(directory, "downsample.bilinear.gif"))

This example loads an image and resizes it proportionally using various resizing methods. Only the height is specified, the width is calculated automatically.


from aspose.imaging import Image, ResizeType
from os.path import join as path_join

directory = "c:\\temp\\"

with Image.load(path_join(directory, "sample.gif")) as image:
	# Ingrandisci di 2 volte usando il ricampionamento Nearest Neighbour.
	image.resize_height_proportionally(image.height * 2, ResizeType.NEAREST_NEIGHBOUR_RESAMPLE)
	image.save(path_join(directory, "upsample.nearestneighbour.gif"))

with Image.load(path_join(directory, "sample.gif")) as image:
	# Riduci di 2 volte usando il ricampionamento Nearest Neighbour.
	image.resize_height_proportionally(image.height // 2, ResizeType.NEAREST_NEIGHBOUR_RESAMPLE)
	image.save(path_join(directory, "downsample.nearestneighbour.gif"))

with Image.load(path_join(directory, "sample.gif")) as image:
	# Ingrandisci di 2 volte usando il ricampionamento bilineare.
	image.resize_height_proportionally(image.height * 2, ResizeType.BILINEAR_RESAMPLE)
	image.save(path_join(directory, "upsample.bilinear.gif"))

with Image.load(path_join(directory, "sample.gif")) as image:
	# Riduci di 2 volte usando il ricampionamento bilineare.
	image.resize_height_proportionally(image.height // 2, ResizeType.BILINEAR_RESAMPLE)
	image.save(path_join(directory, "downsample.bilinear.gif"))

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


from aspose.imaging import Image, RotateFlipType
from os.path import join as path_join

directory = "c:\\temp\\"

rotateFlipTypes = [RotateFlipType.ROTATE_90_FLIP_NONE, RotateFlipType.ROTATE_90_FLIP_X,
				   RotateFlipType.ROTATE_90_FLIP_XY, RotateFlipType.ROTATE_90_FLIP_Y]

for rotateFlipType in rotateFlipTypes:
	# Ruota, capovolgi e salva nel file di output.
	with Image.Load(path_join(directory, "sample.bmp")) as image:
		image.rotate_flip(rotateFlipType)
		image.save(path_join(directory, f"sample.{rotateFlipType}.bmp"))

The following example loads a BMP image from a file, then saves the image to a PNG file.

from aspose.imaging import Image
from aspose.imaging.imageoptions import PngOptions
from os.path import join as path_join

directory = r"c:\temp"

with Image.load(path_join(dir, "sample.bmp")) as image:
	# Salva l'intera immagine in un file PNG.
	save_options = PngOptions()
	image.save(path_join(dir, "output.png"), save_options)

The following example loads a BMP image from a file, then saves a rectangular part of the image to a PNG file.

from aspose.imaging import Image, Rectangle
from aspose.imaging.imageoptions import PngOptions
from os.path import join as path_join

directory = r"c:\temp"

with Image.load(path_join(dir, "sample.bmp")) as image:
	# Salva la metà superiore dell'immagine in un file PNG.
	save_options = PngOptions()
	bounds = Rectangle(0, 0, image.width, image.height // 2)
	image.save(path_join(dir, "output.png"), save_options, bounds)

The following example loads an image from a file, then saves the image to a PNG file stream.

from aspose.imaging import Image, Rectangle
from aspose.imaging.imageoptions import PngOptions
from os.path import join as path_join

directory = r"c:\temp"

with Image.load(path_join(dir, "sample.bmp")) as image:
	save_options = PngOptions()
	with open(path_join(dir, "output.png"), "w+b") as output_stream:
		# Salva l'intera immagine in un flusso di file.
		image.save(output_stream, save_options)

The following example loads an image from a file, then saves a rectangular part of the image to a PNG file stream.

from aspose.imaging import Image, Rectangle
from aspose.imaging.imageoptions import PngOptions
from os.path import join as path_join

directory = r"c:\temp"

with Image.load(path_join(dir, "sample.bmp")) as image:
	save_options = PngOptions()
	bounds = Rectangle(0, 0, image.width, image.height // 2)
	with open(path_join(dir, "output.png"), "w+b") as output_stream:
		# Salva la metà superiore dell'immagine in un flusso di file.
		image.save(output_stream, save_options, bounds)

The following example shows how to save an entire BMP image or part of it to a file or stream.


from os.path import join as path_join
from aspose.pycore import as_of
from aspose.imaging import Image, ColorPaletteHelper
from aspose.imaging.imageoptions import BmpOptions
from aspose.imaging.extensions import StreamExtensions as strm_ext

directory = "c:\\temp\\"
with Image.load(path_join(directory, "sample.bmp")) as image:
	bmpImage = as_of(image, BmpImage)
		
	# Converti in un'immagine in bianco e nero
	bmpImage.binarize_otsu()

	# Salva nella stessa posizione con le opzioni predefinite.
	image.save()

	saveOptions = BmpOptions()

	# Una palette contiene solo due colori: Nero e Bianco in questo caso.
	saveOptions.palette = ColorPaletteHelper.create_monochrome()

	# Per tutte le immagini monocromatiche (incluse quelle in bianco e nero) è sufficiente allocare 1 bit per pixel.
	saveOptions.bits_per_pixel = 1

	# Salva in un'altra posizione con le opzioni specificate.
	image.save(path_join(directory, "sample.bw.palettized.bmp"), saveOptions)

	# Salva solo la parte centrale dell'immagine.
	bounds = Rectangle(image.width // 4, image.height // 4, image.width // 2, image.height // 2)
	image.save(path_join(directory, "sample.bw.palettized.part.bmp"), saveOptions, bounds)

	# Salva l'intera immagine in un flusso di memoria
	with strm_ext.create_memory_stream() as stream:
		image.save(stream, saveOptions);
		print("The size of the whole image in bytes:", stream.tell())

	# Salva la parte centrale dell'immagine in un flusso di memoria
	with strm_ext.create_memory_stream() as stream:
		image.save(stream, saveOptions, bounds)
		print("The size of the central part of the image in bytes: ", stream.tell())

#L'output potrebbe apparire così:
#La dimensione dell'intera immagine in byte: 24062
#La dimensione della parte centrale dell'immagine in byte: 6046

The following example shows how to resize a metafile (WMF and EMF).


import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.emf import MetaImage
from os.path import join

dir_ = "c:\\temp"
file_names = ["image3.emf", "image4.wmf"]
for file_name in file_names:
	input_file_path = join(dir_, file_name)
	output_file_path = join(dir_, "Downscale_" + file_name)
	with aspycore.as_of(Image.load(input_file_path), MetaImage) as image:
		image.resize(image.width // 4, image.height // 4)
		image.save(output_file_path)

The following example shows how to resize SVG image and save it to PNG.


from aspose.imaging import PointF, Image
from aspose.imaging.imageoptions import PngOptions
from os import path

dir_ = "c:\\aspose.imaging\\net\\issues\\3549"
file_names = ["Logotype.svg", "sample_car.svg", "rg1024_green_grapes.svg", "MidMarkerFigure.svg", "embeddedFonts.svg"]
scales = [PointF(0.5, 0.5), PointF(1.0, 1.0), PointF(2.0, 2.0), PointF(3.5, 9.2)]
for input_file in file_names:
	for scale in scales:
		output_file = "{0}_{1}_{2}.png".format(input_file, str(scale.x), str(scale.y))
		with Image.load(path.join(dir_, input_file)) as image:
			image.resize(int(image.width * scale.x), int(image.height * scale.y))
			image.save(path.join(dir_, output_file), PngOptions())

Resize image using specific Resize Type.

from aspose.imaging import Image, ResizeType, ImageResizeSettings, ImageFilterType

with Image.load("Photo.jpg") as image:
	image.resize(640, 480, ResizeType.CATMULL_ROM)
	image.save("ResizedPhoto.jpg")
	image.resize(1024, 768, ResizeType.CUBIC_CONVOLUTION)
	image.save("ResizedPhoto2.jpg")
	resize_settings = ImageResizeSettings()
	resize_settings.mode = ResizeType.CUBIC_BSPLINE
	resize_settings.filter_type = ImageFilterType.SMALL_RECTANGULAR
	image.resize(800, 800, resize_settings)
	image.save("ResizedPhoto3.jpg")

Determine if the palette is used by the image.


from aspose.imaging import Image

with Image.load("Sample.bmp") as image:
	if image.use_palette:
		print("The palette is used by the image")