Classe CdrImage
Summary: The API for CorelDRAW CDR vector image format support is an essential toolkit
for developers working with vector graphics. This API enables the
seamless processing of CDR files, allowing for the storage and
manipulation of diverse elements such as text, lines, shapes, images,
colors, and effects. With its comprehensive capabilities, developers can
efficiently work with vector representations of image contents, ensuring
precision and flexibility in creating and editing CorelDRAW vector
graphics programmatically.
Module: aspose.imaging.fileformats.cdr
Full Name: aspose.imaging.fileformats.cdr.CdrImage
Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, IObjectWithSizeF, IMultipageImage, ICdrImage, VectorMultipageImage
Constructors
| Name | Descrizione |
|---|---|
| CdrImage(stream, load_options) | Inizia a lavorare con la classe CdrImage senza sforzo inizializzando una nuova istanza con un flusso e i parametri loadOptions. Ideale per gli sviluppatori che cercano un modo conveniente per caricare immagini CDR da varie fonti di dati personalizzando il processo di caricamento secondo le necessità. |
Properties
| Name | Type | Access | Descrizione |
|---|---|---|---|
| auto_adjust_palette | bool | r/w | Ottiene o imposta un valore che indica se la palette viene regolata automaticamente. |
| background_color | Color | r/w | Ottiene o imposta un valore per il colore di sfondo. |
| bits_per_pixel | int | r | Recupera la profondità di bit dell’immagine senza sforzo con questa proprietà intuitiva. Ideale per gli sviluppatori che desiderano determinare il livello di dettaglio o la profondità di colore presente nelle loro immagini, garantendo una elaborazione e manipolazione accurate. |
| bounds | Rectangle | r | Ottiene i limiti dell’oggetto. |
| buffer_size_hint | int | r/w | Ottiene o imposta il suggerimento della dimensione del buffer, che è definito come dimensione massima consentita per tutti i buffer interni. |
| cdr_document | CdrDocument | r | Recupera o aggiorna il documento CDR senza sforzo usando questa proprietà intuitiva. Ideale per gli sviluppatori che desiderano accedere o modificare il documento CDR, garantendo flessibilità ed efficienza nelle loro applicazioni. |
| container | Image | r | Ottiene il contenitore Image. |
| data_stream_container | StreamContainer | r | Ottiene lo stream di dati dell’oggetto. |
| default_page | Image | r | Recupera la pagina predefinita dell’immagine con facilità usando questa proprietà intuitiva. Perfetto per gli sviluppatori che cercano un accesso rapido alla pagina principale della loro immagine, garantendo una navigazione e gestione efficienti. |
| eliminato | bool | r | Ottiene un valore che indica se questa istanza è stata eliminata. |
| exif_data | ExifData | r/w | Ottiene o imposta l’istanza Exif. |
| file_format | FileFormat | r | Recupera il formato file dell’immagine senza sforzo con questa proprietà intuitiva. Ideale per gli sviluppatori che desiderano determinare dinamicamente il formato delle loro immagini, garantendo compatibilità e una elaborazione accurata nelle loro applicazioni. |
| has_background_color | bool | r/w | Ottiene o imposta un valore che indica se l’immagine ha un colore di sfondo. |
| height | int | r | Ottiene l’altezza dell’immagine. |
| height_f | float | r | Ottiene l’altezza dell’oggetto, in pollici. |
| interrupt_monitor | InterruptMonitor | r/w | Ottiene o imposta il monitor di interruzione. |
| is_cached | bool | r | Determina senza sforzo se i dati dell’oggetto sono attualmente nella cache, eliminando la necessità di leggere i dati. Ideale per gli sviluppatori che cercano di ottimizzare le prestazioni sfruttando i dati nella cache in modo efficiente, garantendo un accesso più rapido alle informazioni dell’oggetto. |
| metadata | ImageMetadata | r | Ottiene i metadati dell’immagine. |
| page_count | int | r | Recupera o aggiorna senza sforzo il conteggio totale delle pagine dell’immagine con questa proprietà intuitiva. Ideale per gli sviluppatori che desiderano gestire immagini multi-pagina in modo dinamico, garantendo una navigazione e manipolazione efficienti del contenuto dell’immagine. |
| pages | Image[] | r | Recupera le pagine dell’immagine senza soluzione di continuità con questa proprietà intuitiva. Ideale per gli sviluppatori che desiderano accedere e manipolare pagine individuali all’interno di immagini multi-pagina, garantendo una navigazione e un’elaborazione efficienti. |
| palette | IColorPalette | r/w | Ottiene o imposta la tavolozza dei colori. La tavolozza dei colori non viene utilizzata quando i pixel sono rappresentati direttamente. |
| size | Size | r | Ottiene la dimensione dell’oggetto. |
| size_f | SizeF | r | Ottiene le dimensioni dell’oggetto, in pollici. |
| use_palette | bool | r | Ottiene un valore che indica se la tavolozza dell’immagine è utilizzata. |
| width | int | r | Ottiene la larghezza dell’immagine. |
| width_f | float | r | Ottiene la larghezza dell’oggetto, in pollici. |
| xmp_data | XmpPacketWrapper | r/w | Ottiene o imposta i dati Xmp. |
Methods
| Name | Descrizione |
|---|---|
| cache_data() | Metti nella cache i dati senza sforzo per evitare ulteriori caricamenti dalla sorgente sottostante con questo metodo intuitivo. Ideale per gli sviluppatori che cercano di ottimizzare le prestazioni precaricando i dati, garantendo un accesso più rapido e un funzionamento più fluido nelle loro applicazioni. DataStreamSupporter.data_stream_container. |
| can_load(file_path) | Determina se l’immagine può essere caricata dal percorso file specificato. |
| can_load(file_path, load_options) | Determina se l’immagine può essere caricata dal percorso file specificato e, opzionalmente, utilizzando le opzioni di apertura specificate. |
| can_load(stream) | Determina se l’immagine può essere caricata dallo stream specificato. |
| can_load(stream, load_options) | Determina se l’immagine può essere caricata dallo stream specificato e, opzionalmente, utilizzando le loadOptions specificate. |
| can_load_stream(stream) | Determina se l’immagine può essere caricata dallo stream specificato. |
| can_load_stream_with_options(stream, load_options) | Determina se l’immagine può essere caricata dallo stream specificato e, opzionalmente, utilizzando le loadOptions specificate. |
| can_load_with_options(file_path, load_options) | Determina se l’immagine può essere caricata dal percorso file specificato e, opzionalmente, utilizzando le opzioni di apertura specificate. |
| can_save(options) | Determina se l’immagine può essere salvata nel formato file specificato rappresentato dalle opzioni di salvataggio fornite. |
| create(files) | Crea l’immagine multipagina contenente i file specificati. |
| create(files, throw_exception_on_load_error) | Crea l’immagine multipagina contenente i file specificati. |
| create(image_options, width, height) | Crea una nuova immagine utilizzando le opzioni di creazione specificate. |
| create(image_options, width, height, pixels) | Crea un’istanza di RasterImage dall’array di pixel fornito. Convalida che la larghezza e l’altezza specificate corrispondano alle dimensioni dei dati pixel. Questo metodo può essere usato solo quando la libreria è in modalità Licensed. |
| create(images) | Crea una nuova immagine utilizzando le immagini specificate come pagine |
| create(images, dispose_images) | Crea una nuova immagine dalle immagini specificate come pagine. |
| create(multipage_create_options) | Crea le opzioni di creazione multipagina specificate. |
| create_from_files(files) | Crea l’immagine multipagina contenente i file specificati come pagine a caricamento differito. |
| create_from_files(files, throw_exception_on_load_error) | Crea l’immagine multipagina contenente i file specificati come pagine a caricamento differito. |
| create_from_images(images) | Crea una nuova immagine utilizzando le immagini specificate come pagine |
| create_from_images(images, dispose_images) | Crea una nuova immagine dalle immagini specificate come pagine. |
| crop(left_shift, right_shift, top_shift, bottom_shift) | Ritaglia l’immagine con spostamenti. |
| crop(rectangle) | Ritaglia il rettangolo specificato. |
| get_default_options(args) | Ottiene le opzioni immagine predefinite. |
| get_embedded_images() | Ottiene le immagini incorporate. |
| get_file_format(file_path) | Ottiene il formato del file. |
| get_file_format(stream) | Ottiene il formato del file. |
| get_file_format_of_stream(stream) | Ottiene il formato del file. |
| get_fitting_rectangle(rectangle, pixels, width, height) | Ottiene il rettangolo che si adatta all’immagine corrente. |
| get_fitting_rectangle(rectangle, width, height) | Ottiene il rettangolo che si adatta all’immagine corrente. |
| get_original_options() | Ottiene le opzioni basate sulle impostazioni originali del file. Questo può essere utile per mantenere inalterata la profondità di bit e altri parametri dell’immagine originale. Ad esempio, se carichiamo un’immagine PNG in bianco e nero a 1 bit per pixel e poi la salviamo usando il metodo DataStreamSupporter.save(file_path), verrà generata un’immagine PNG di output a 8 bit per pixel. Per evitarlo e salvare l’immagine PNG a 1 bit per pixel, utilizza questo metodo per ottenere le opzioni di salvataggio corrispondenti e passale al metodo Image.save(file_path, options) come secondo parametro. |
| get_proportional_height(width, height, new_width) | Ottiene un’altezza proporzionale. |
| get_proportional_width(width, height, new_height) | Ottiene una larghezza proporzionale. |
| get_serialized_stream(image_options, clipping_rectangle, page_number) | Converte in aps. |
| load(file_path) | Carica una nuova immagine dal percorso file o URL specificato. Se filePath è un percorso file, il metodo apre semplicemente il file. Se filePath è un URL, il metodo scarica il file, lo memorizza temporaneamente e lo apre. |
| load(file_path, load_options) | Carica una nuova immagine dal percorso file o URL specificato. Se filePath è un percorso file, il metodo apre semplicemente il file. Se filePath è un URL, il metodo scarica il file, lo memorizza temporaneamente e lo apre. |
| load(stream) | Carica una nuova immagine dallo stream specificato. |
| load(stream, load_options) | Carica una nuova immagine dallo stream specificato. |
| load_stream(stream) | Carica una nuova immagine dallo stream specificato. |
| load_stream_with_options(stream, load_options) | Carica una nuova immagine dallo stream specificato. |
| load_with_options(file_path, load_options) | Carica una nuova immagine dal percorso file o URL specificato. Se filePath è un percorso file, il metodo apre semplicemente il file. Se filePath è un URL, il metodo scarica il file, lo memorizza temporaneamente e lo apre. |
| remove_background() | Rimuove lo sfondo. |
| remove_background(settings) | Rimuove lo sfondo. |
| remove_metadata() | Rimuove i metadati. |
| resize(new_width, new_height) | Ridimensiona l’immagine. Viene utilizzato il valore predefinito ResizeType.NEAREST_NEIGHBOUR_RESAMPLE. |
| resize(new_width, new_height, resize_type) | Ridimensiona l’immagine. |
| resize(new_width, new_height, settings) | Ridimensiona l’immagine. |
| resize_by_settings(new_width, new_height, settings) | Ridimensiona l’immagine. |
| resize_by_type(new_width, new_height, resize_type) | Ridimensiona l’immagine. |
| resize_height_proportionally(new_height) | Ridimensiona l’altezza proporzionalmente. Viene utilizzato il valore predefinito ResizeType.NEAREST_NEIGHBOUR_RESAMPLE. |
| resize_height_proportionally(new_height, resize_type) | Ridimensiona l’altezza proporzionalmente. |
| resize_height_proportionally(new_height, settings) | Ridimensiona l’altezza proporzionalmente. |
| resize_height_proportionally_settings(new_height, settings) | Ridimensiona l’altezza proporzionalmente. |
| resize_width_proportionally(new_width) | Ridimensiona la larghezza proporzionalmente. Viene utilizzato il valore predefinito ResizeType.NEAREST_NEIGHBOUR_RESAMPLE. |
| resize_width_proportionally(new_width, resize_type) | Ridimensiona la larghezza proporzionalmente. |
| resize_width_proportionally(new_width, settings) | Ridimensiona la larghezza proporzionalmente. |
| resize_width_proportionally_settings(new_width, settings) | Ridimensiona la larghezza proporzionalmente. |
| rotate(angle) | Ruota l’immagine attorno al centro. |
| rotate_flip(rotate_flip_type) | Ruota, capovolge o ruota e capovolge l’immagine. |
| save() | Salva i dati dell’immagine nello stream sottostante. |
| save(file_path) | Salva l’immagine nella posizione file specificata. |
| save(file_path, options) | Salva i dati dell’oggetto nella posizione file specificata nel formato file indicato secondo le opzioni di salvataggio. |
| save(file_path, options, bounds_rectangle) | Salva i dati dell’oggetto nella posizione file specificata nel formato file indicato secondo le opzioni di salvataggio. |
| save(file_path, over_write) | Salva i dati dell’oggetto nella posizione file specificata. |
| save(stream) | Salva i dati. |
| save(stream, options_base) | Salva i dati dell’immagine nello stream specificato nel formato file indicato secondo le opzioni di salvataggio. |
| save(stream, options_base, bounds_rectangle) | Salva i dati dell’immagine nello stream specificato nel formato file indicato secondo le opzioni di salvataggio. |
| save_to_stream(stream) | Salva i dati dell’oggetto nello stream specificato. |
| save_to_stream_with_options(stream, options_base) | Salva i dati dell’immagine nello stream specificato nel formato file indicato secondo le opzioni di salvataggio. |
| save_to_stream_with_options_rect(stream, options_base, bounds_rectangle) | Salva i dati dell’immagine nello stream specificato nel formato file indicato secondo le opzioni di salvataggio. |
| save_with_options(file_path, options) | Salva i dati dell’oggetto nella posizione file specificata nel formato file indicato secondo le opzioni di salvataggio. |
| save_with_options_rect(file_path, options, bounds_rectangle) | Salva i dati dell’oggetto nella posizione file specificata nel formato file indicato secondo le opzioni di salvataggio. |
| set_palette(palette, update_colors) | Personalizza la tavolozza dei colori dell’immagine con questo metodo intuitivo. Ideale per gli sviluppatori che desiderano applicare schemi di colore o regolazioni specifiche in modo dinamico, garantendo un controllo preciso sull’aspetto visivo delle loro immagini. |
| try_set_metadata(metadata) | Cerca di impostare un’istanza metadata, se questa istanza di Image supporta e implementa l’istanza IImageMetadataFormat. |
Constructor: CdrImage(stream, load_options)
CdrImage(stream, load_options)
Inizia a lavorare con la classe CdrImage senza sforzo
inizializzando una nuova istanza con un flusso e i parametri loadOptions.
Ideale per gli sviluppatori che cercano un modo conveniente per caricare immagini CDR da
varie fonti di dati personalizzando il processo di caricamento secondo le necessità.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| stream | _io.BufferedRandom | Lo stream. |
| load_options | LoadOptions | Le opzioni di caricamento. |
Property: pages
Recupera le pagine dell’immagine senza soluzione di continuità con questa proprietà intuitiva.
Ideale per gli sviluppatori che desiderano accedere e manipolare pagine individuali all’interno di
immagini multi-pagina, garantendo una navigazione e un’elaborazione efficienti.
See also:
Example # 1: The following example shows how to cache all pages of a CDR image.
Example # 2: The following example shows how to export a single page of CDR document to PDF.
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 |
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 |
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 |
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. |
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 immagine predefinite.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| args | System.Object | Gli argomenti. |
Returns
| Tipo | Descrizione |
|---|---|
| ImageOptionsBase | Le opzioni immagine predefinite. |
Method: get_embedded_images()
get_embedded_images()
Ottiene le immagini incorporate.
Returns
| Tipo | Descrizione |
|---|---|
| EmbeddedImage[] | Array di immagini |
Method: get_file_format(file_path) [static]
get_file_format(file_path)
Ottiene il formato del file.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| file_path | string | Il percorso del file. |
Returns
| Tipo | Descrizione |
|---|---|
| FileFormat | Il formato file determinato. |
Method: get_file_format(stream) [static]
get_file_format(stream)
Ottiene il formato del file.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| stream | _io.BufferedRandom | Lo stream. |
Returns
| Tipo | Descrizione |
|---|---|
| FileFormat | Il formato file determinato. |
Method: get_file_format_of_stream(stream) [static]
get_file_format_of_stream(stream)
Ottiene il formato del file.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| stream | _io.BufferedRandom | Lo stream. |
Returns
| Tipo | Descrizione |
|---|---|
| FileFormat | Il formato file determinato. |
Method: get_fitting_rectangle(rectangle, pixels, width, height) [static]
get_fitting_rectangle(rectangle, pixels, width, height)
Ottiene il rettangolo che si adatta all’immagine corrente.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| rectangle | Rectangle | Il rettangolo per cui ottenere il rettangolo di adattamento. |
| pixel | int[] | I pixel ARGB a 32 bit. |
| width | int | La larghezza dell’oggetto. |
| height | int | L’altezza dell’oggetto. |
Returns
| Tipo | Descrizione |
|---|---|
| Rectangle | Il rettangolo di adattamento o un’eccezione se non è possibile trovare un rettangolo di adattamento. |
Method: get_fitting_rectangle(rectangle, width, height) [static]
get_fitting_rectangle(rectangle, width, height)
Ottiene il rettangolo che si adatta all’immagine corrente.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| rectangle | Rectangle | Il rettangolo per cui ottenere il rettangolo di adattamento. |
| width | int | La larghezza dell’oggetto. |
| height | int | L’altezza dell’oggetto. |
Returns
| Tipo | Descrizione |
|---|---|
| Rectangle | Il rettangolo di adattamento o un’eccezione se non è possibile trovare un rettangolo di adattamento. |
Method: get_original_options()
get_original_options()
Ottiene le opzioni basate sulle impostazioni originali del file.
Questo può essere utile per mantenere inalterata la profondità di bit e altri parametri dell’immagine originale.
Ad esempio, se carichiamo un’immagine PNG in bianco e nero a 1 bit per pixel e poi la salviamo usando il
metodo DataStreamSupporter.save(file_path), verrà generata un’immagine PNG di output a 8 bit per pixel.
Per evitarlo e salvare l’immagine PNG a 1 bit per pixel, utilizza questo metodo per ottenere le opzioni di salvataggio corrispondenti e passale
al metodo Image.save(file_path, options) come secondo parametro.
Returns
| Tipo | Descrizione |
|---|---|
| ImageOptionsBase | Le opzioni basate sulle impostazioni del file originale. |
Method: get_proportional_height(width, height, new_width) [static]
get_proportional_height(width, height, new_width)
Ottiene un’altezza proporzionale.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| width | int | La larghezza. |
| height | int | L’altezza. |
| new_width | int | La nuova larghezza. |
Returns
| Tipo | Descrizione |
|---|---|
| int | L’altezza proporzionale. |
Method: get_proportional_width(width, height, new_height) [static]
get_proportional_width(width, height, new_height)
Ottiene una larghezza proporzionale.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| width | int | La larghezza. |
| height | int | L’altezza. |
| new_height | int | La nuova altezza. |
Returns
| Tipo | Descrizione |
|---|---|
| int | La larghezza proporzionale. |
Method: get_serialized_stream(image_options, clipping_rectangle, page_number)
get_serialized_stream(image_options, clipping_rectangle, page_number)
Converte in aps.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| image_options | ImageOptionsBase | Le opzioni dell’immagine. |
| clipping_rectangle | Rectangle | Il rettangolo di ritaglio. |
| page_number | int[] | Il numero di pagina. |
Returns
| Tipo | Descrizione |
|---|---|
| _io.BufferedRandom | Il flusso serializzato |
Method: load(file_path) [static]
load(file_path)
Carica una nuova immagine dal percorso file o URL specificato.
Se filePath è un percorso file, il metodo apre semplicemente il file.
Se filePath è un URL, il metodo scarica il file, lo memorizza temporaneamente e lo apre.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| file_path | string | Il percorso file o l’URL da cui caricare l’immagine. |
Returns
| Tipo | Descrizione |
|---|---|
| Image | L’immagine caricata. |
Method: load(file_path, load_options) [static]
load(file_path, load_options)
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. |
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: remove_background(settings)
remove_background(settings)
Rimuove lo sfondo.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| settings | RemoveBackgroundSettings | Le impostazioni. |
Method: resize(new_width, new_height)
resize(new_width, new_height)
Ridimensiona l’immagine. Viene utilizzato il valore predefinito ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| new_width | int | La nuova larghezza. |
| new_height | int | La nuova altezza. |
Method: resize(new_width, new_height, resize_type)
resize(new_width, new_height, resize_type)
Ridimensiona l’immagine.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| new_width | int | La nuova larghezza. |
| new_height | int | La nuova altezza. |
| resize_type | ResizeType | Il tipo di ridimensionamento. |
Method: resize(new_width, new_height, settings)
resize(new_width, new_height, settings)
Ridimensiona l’immagine.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| new_width | int | La nuova larghezza. |
| new_height | int | La nuova altezza. |
| settings | ImageResizeSettings | Le impostazioni di ridimensionamento. |
Method: resize_by_settings(new_width, new_height, settings)
resize_by_settings(new_width, new_height, settings)
Ridimensiona l’immagine.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| new_width | int | La nuova larghezza. |
| new_height | int | La nuova altezza. |
| settings | ImageResizeSettings | Le impostazioni di ridimensionamento. |
Method: resize_by_type(new_width, new_height, resize_type)
resize_by_type(new_width, new_height, resize_type)
Ridimensiona l’immagine.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| new_width | int | La nuova larghezza. |
| new_height | int | La nuova altezza. |
| resize_type | ResizeType | Il tipo di ridimensionamento. |
Method: resize_height_proportionally(new_height)
resize_height_proportionally(new_height)
Ridimensiona l’altezza proporzionalmente. Viene utilizzato il valore predefinito ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| new_height | int | La nuova altezza. |
Method: resize_height_proportionally(new_height, resize_type)
resize_height_proportionally(new_height, resize_type)
Ridimensiona l’altezza proporzionalmente.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| new_height | int | La nuova altezza. |
| resize_type | ResizeType | Tipo di ridimensionamento. |
Method: resize_height_proportionally(new_height, settings)
resize_height_proportionally(new_height, settings)
Ridimensiona l’altezza proporzionalmente.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| new_height | int | La nuova altezza. |
| settings | ImageResizeSettings | Le impostazioni di ridimensionamento dell’immagine. |
Method: resize_height_proportionally_settings(new_height, settings)
resize_height_proportionally_settings(new_height, settings)
Ridimensiona l’altezza proporzionalmente.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| new_height | int | La nuova altezza. |
| settings | ImageResizeSettings | Le impostazioni di ridimensionamento dell’immagine. |
Method: resize_width_proportionally(new_width)
resize_width_proportionally(new_width)
Ridimensiona la larghezza proporzionalmente. Viene utilizzato il valore predefinito ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| new_width | int | La nuova larghezza. |
Method: resize_width_proportionally(new_width, resize_type)
resize_width_proportionally(new_width, resize_type)
Ridimensiona la larghezza proporzionalmente.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| new_width | int | La nuova larghezza. |
| resize_type | ResizeType | Tipo di ridimensionamento. |
Method: resize_width_proportionally(new_width, settings)
resize_width_proportionally(new_width, settings)
Ridimensiona la larghezza proporzionalmente.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| new_width | int | La nuova larghezza. |
| settings | ImageResizeSettings | Le impostazioni di ridimensionamento dell’immagine. |
Method: resize_width_proportionally_settings(new_width, settings)
resize_width_proportionally_settings(new_width, settings)
Ridimensiona la larghezza proporzionalmente.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| new_width | int | La nuova larghezza. |
| settings | ImageResizeSettings | Le impostazioni di ridimensionamento dell’immagine. |
Method: rotate(angle)
rotate(angle)
Ruota l’immagine attorno al centro.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| angle | float | L’angolo di rotazione in gradi. I valori positivi ruoteranno in senso orario. |
Method: rotate_flip(rotate_flip_type)
rotate_flip(rotate_flip_type)
Ruota, capovolge o ruota e capovolge l’immagine.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| rotate_flip_type | RotateFlipType | Tipo di rotazione e capovolgimento. |
Method: save(file_path)
save(file_path)
Salva l’immagine nella posizione file specificata.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| file_path | string | Il percorso file in cui salvare l’immagine. |
Method: save(file_path, options)
save(file_path, options)
Salva i dati dell’oggetto nella posizione file specificata nel formato file indicato secondo le opzioni di salvataggio.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| file_path | string | Il percorso del file. |
| options | ImageOptionsBase | Le opzioni. |
Method: save(file_path, options, bounds_rectangle)
save(file_path, options, bounds_rectangle)
Salva i dati dell’oggetto nella posizione file specificata nel formato file indicato secondo le opzioni di salvataggio.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| file_path | string | Il percorso del file. |
| options | ImageOptionsBase | Le opzioni. |
| bounds_rectangle | Rectangle | Il rettangolo dei limiti dell’immagine di destinazione. Imposta il rettangolo vuoto per utilizzare i limiti della sorgente. |
Method: save(file_path, over_write)
save(file_path, over_write)
Salva i dati dell’oggetto nella posizione file specificata.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| file_path | string | Il percorso file in cui salvare i dati dell’oggetto. |
| over_write | bool | se impostato su |
Method: save(stream)
save(stream)
Salva i dati.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| stream | _io.BufferedRandom | Il flusso in cui salvare i dati. |
Method: save(stream, options_base)
save(stream, options_base)
Salva i dati dell’immagine nello stream specificato nel formato file indicato secondo le opzioni di salvataggio.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| stream | _io.BufferedRandom | Il flusso in cui salvare i dati dell’immagine. |
| options_base | ImageOptionsBase | Le opzioni di salvataggio. |
Method: save(stream, options_base, bounds_rectangle)
save(stream, options_base, bounds_rectangle)
Salva i dati dell’immagine nello stream specificato nel formato file indicato secondo le opzioni di salvataggio.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| stream | _io.BufferedRandom | Il flusso in cui salvare i dati dell’immagine. |
| options_base | ImageOptionsBase | Le opzioni di salvataggio. |
| bounds_rectangle | Rectangle | Il rettangolo dei limiti dell’immagine di destinazione. Imposta il rettangolo vuoto per utilizzare i limiti della sorgente. |
Method: save_to_stream(stream)
save_to_stream(stream)
Salva i dati dell’oggetto nello stream specificato.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| stream | _io.BufferedRandom | Il flusso in cui salvare i dati dell’oggetto. |
Method: save_to_stream_with_options(stream, options_base)
save_to_stream_with_options(stream, options_base)
Salva i dati dell’immagine nello stream specificato nel formato file indicato secondo le opzioni di salvataggio.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| stream | _io.BufferedRandom | Il flusso in cui salvare i dati dell’immagine. |
| options_base | ImageOptionsBase | Le opzioni di salvataggio. |
Method: save_to_stream_with_options_rect(stream, options_base, bounds_rectangle)
save_to_stream_with_options_rect(stream, options_base, bounds_rectangle)
Salva i dati dell’immagine nello stream specificato nel formato file indicato secondo le opzioni di salvataggio.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| stream | _io.BufferedRandom | Il flusso in cui salvare i dati dell’immagine. |
| options_base | ImageOptionsBase | Le opzioni di salvataggio. |
| bounds_rectangle | Rectangle | Il rettangolo dei limiti dell’immagine di destinazione. Imposta il rettangolo vuoto per utilizzare i limiti della sorgente. |
Method: save_with_options(file_path, options)
save_with_options(file_path, options)
Salva i dati dell’oggetto nella posizione file specificata nel formato file indicato secondo le opzioni di salvataggio.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| file_path | string | Il percorso del file. |
| options | ImageOptionsBase | Le opzioni. |
Method: save_with_options_rect(file_path, options, bounds_rectangle)
save_with_options_rect(file_path, options, bounds_rectangle)
Salva i dati dell’oggetto nella posizione file specificata nel formato file indicato secondo le opzioni di salvataggio.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| file_path | string | Il percorso del file. |
| options | ImageOptionsBase | Le opzioni. |
| bounds_rectangle | Rectangle | Il rettangolo dei limiti dell’immagine di destinazione. Imposta il rettangolo vuoto per utilizzare i limiti della sorgente. |
Method: set_palette(palette, update_colors)
set_palette(palette, update_colors)
Personalizza la tavolozza dei colori dell’immagine con questo metodo intuitivo. Ideale per
gli sviluppatori che desiderano applicare schemi di colore o regolazioni specifiche in modo dinamico,
garantendo un controllo preciso sull’aspetto visivo delle loro immagini.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| palette | IColorPalette | La tavolozza da impostare. |
| update_colors | bool | se impostato su voci corrispondenti nella tavolozza. |
Method: try_set_metadata(metadata)
try_set_metadata(metadata)
Cerca di impostare un’istanza metadata, se questa istanza di Image supporta e implementa l’istanza IImageMetadataFormat.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| metadata | IImageMetadataFormat | I metadati. |
Returns
| Tipo | Descrizione |
|---|---|
| bool | True se metadata non è null e l’istanza di IMetadataContainer supporta e/o implementa l’istanza di IImageMetadataFormat; altrimenti, false. |
Examples
The following example shows how to cache all pages of a CDR image.
import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.cdr import CdrImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join
dir_ = "c:\\temp"
# Carica un'immagine da un file CDR.
with aspycore.as_of(Image.load(join(dir_, "sample.cdr")), CdrImage) as image:
# Questa chiamata memorizza nella cache solo la pagina predefinita.
image.cache_data()
# Memorizza nella cache tutte le pagine in modo che non vengano effettuati ulteriori caricamenti di dati dal flusso di dati sottostante.
for page in image.pages:
page.cache_data()
The following example shows how to export a single page of CDR document to PDF.
import aspose.pycore as aspycore
from aspose.imaging import Image, TextRenderingHint, SmoothingMode
from aspose.imaging.fileformats.cdr import CdrImage, CdrImagePage
from aspose.imaging.imageoptions import PdfOptions, CdrRasterizationOptions
from os.path import join as path_combine
page_number: int = 0 # the page index for export
dir_ = "c:\\aspose.imaging\\issues\\net\\3635\\testdata\\3570"
input_cdr_file_name: str = path_combine(dir_, "tiger.cdr")
output_pdf_file_name: str = path_combine(dir_, "tiger.cdr.page" + page_number + ".pdf")
with aspycore.as_of(Image.load(input_cdr_file_name), CdrImage) as image:
image_page = aspycore.as_of(image.pages[page_number], CdrImagePage)
pdf_options = PdfOptions()
obj_init = CdrRasterizationOptions()
obj_init.text_rendering_hint = TextRenderingHint.SINGLE_BIT_PER_PIXEL
obj_init.smoothing_mode = SmoothingMode.NONE
obj_init.page_width = image_page.width
obj_init.page_height = image_page.height
pdf_options.vector_rasterization_options = obj_init
image_page.save(output_pdf_file_name, pdf_options)
