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
| Name | Type | Access | Descrizione |
|---|---|---|---|
| auto_adjust_palette | bool | r/w | Ottiene o imposta un valore che indica se la palette viene regolata automaticamente. |
| background_color | Color | r/w | Ottiene o imposta un valore per il colore di sfondo. |
| bits_per_pixel | int | r | Ottiene il conteggio dei bit per pixel dell’immagine. |
| bounds | Rectangle | r | Ottiene i limiti dell’immagine. |
| buffer_size_hint | int | r/w | Ottiene o imposta il suggerimento della dimensione del buffer, che è definito come dimensione massima consentita per tutti i buffer interni. |
| container | Image | r | Ottiene il contenitore Image. |
| data_stream_container | StreamContainer | r | Ottiene lo stream di dati dell’oggetto. |
| eliminato | bool | r | Ottiene un valore che indica se questa istanza è stata eliminata. |
| exif_data | ExifData | r/w | Ottiene o imposta i dati Exif. |
| file_format | FileFormat | r | Ottiene un valore del formato file |
| has_background_color | bool | r/w | Ottiene o imposta un valore che indica se l’immagine ha un colore di sfondo. |
| height | int | r | Ottiene l’altezza dell’immagine. |
| interrupt_monitor | InterruptMonitor | r/w | Ottiene o imposta il monitor di interruzione. |
| is_cached | bool | r | Restituisce un valore che indica se i dati dell’oggetto sono attualmente nella cache e non è necessario leggere i dati. |
| metadata | ImageMetadata | r | Ottiene i metadati dell’immagine. |
| palette | IColorPalette | r/w | Ottiene o imposta la tavolozza dei colori. La tavolozza dei colori non viene utilizzata quando i pixel sono rappresentati direttamente. |
| size | Size | r | Ottiene le dimensioni dell’immagine. |
| use_palette | bool | r | Ottiene un valore che indica se la tavolozza dell’immagine è utilizzata. |
| width | int | r | Ottiene la larghezza dell’immagine. |
| 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 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:
| Parametro | Tipo | Descrizione |
|---|---|---|
| file_path | string | Il percorso del file. |
Returns
| Tipo | Descrizione |
|---|---|
| bool |
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:
| Parametro | Tipo | Descrizione |
|---|---|---|
| file_path | string | Il percorso del file. |
| load_options | LoadOptions | Le opzioni di caricamento. |
Returns
| Tipo | Descrizione |
|---|---|
| bool |
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 |
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:
| Parametro | Tipo | Descrizione |
|---|---|---|
| stream | _io.BufferedRandom | Il flusso da cui caricare. |
| load_options | LoadOptions | Le opzioni di caricamento. |
Returns
| Tipo | Descrizione |
|---|---|
| bool |
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 |
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 |
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 |
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 |
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:
| 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 |
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. |
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:
| 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 |
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 |
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 |
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 predefinite.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| args | System.Object | Gli argomenti. |
Returns
| Tipo | Descrizione |
|---|---|
| ImageOptionsBase | Opzioni predefinite |
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. |
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:
| Parametro | Tipo | Descrizione |
|---|---|---|
| stream | _io.BufferedRandom | Lo stream. |
Returns
| Tipo | Descrizione |
|---|---|
| FileFormat | Il 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:
| 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. |
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:
| 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. |
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:
| 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)
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. |
| load_options | LoadOptions | Le opzioni di caricamento. |
Returns
| Tipo | Descrizione |
|---|---|
| Image | L’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:
| Parametro | Tipo | Descrizione |
|---|---|---|
| new_width | int | La nuova larghezza. |
| new_height | int | La 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:
| Parametro | Tipo | Descrizione |
|---|---|---|
| new_width | int | La nuova larghezza. |
| new_height | int | La nuova altezza. |
| resize_type | ResizeType | Il 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:
| Parametro | Tipo | Descrizione |
|---|---|---|
| new_width | int | La nuova larghezza. |
| new_height | int | La nuova altezza. |
| settings | ImageResizeSettings | Le 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:
| 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. |
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:
| 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. |
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:
| 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. |
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:
| 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. |
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:
| 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. |
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:
| Parametro | Tipo | Descrizione |
|---|---|---|
| file_path | string | Il percorso file in cui salvare i dati dell’oggetto. |
| over_write | bool | se impostato su |
Method: save(stream)
save(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(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. |
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:
| 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. |
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:
| 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 |
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:
| Parametro | Tipo | Descrizione |
|---|---|---|
| metadata | IImageMetadataFormat | I metadati. |
Returns
| Tipo | Descrizione |
|---|---|
| bool | True, 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")