Classe EpsImage
Summary: The API for Encapsulated PostScript (EPS) image file format support offers
robust capabilities for manipulating compositions comprising text, graphics,
and images. With features such as bitmap preview image handling, orientation
flipping, bounding box retrieval for illustration bounds, resizing, rotating
images, and adding preview images, this API ensures seamless processing
and integration of EPS files into various applications with precision and
versatility.
Module: aspose.imaging.fileformats.eps
Full Name: aspose.imaging.fileformats.eps.EpsImage
Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, IObjectWithSizeF, VectorImage
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 | Accedi facilmente alla profondità di bit precisa dell’immagine con questa proprietà. Recupera il conteggio dei bit per pixel, fornendo informazioni cruciali sulla profondità di colore dell’immagine e contribuendo a ottimizzare le attività di elaborazione. Ideale per applicazioni che richiedono un controllo dettagliato sulla manipolazione e l’analisi delle immagini. |
| bounding_box | RectangleF | r | Accedendo al riquadro di delimitazione originale in punti indipendenti dal dispositivo, questa proprietà fornisce informazioni geometriche cruciali sulle dimensioni del EpsImage. Recuperando questi dati, gli utenti possono valutare con precisione le dimensioni e il rapporto d’aspetto dell’immagine facilitando layout e posizionamento precisi in varie applicazioni. |
| bounding_box_px | Rectangle | r | Questa proprietà restituisce il riquadro di delimitazione originale dell’EpsImage istanza in pixel, fornendo dati geometrici essenziali per un rendering e una manipolazione accurati. Con queste informazioni, gli utenti possono garantire un posizionamento e una dimensione precisi /// delle immagini EPS nei loro progetti, migliorando la presentazione visiva complessiva e la qualità. |
| bounds | Rectangle | r | Ottiene i limiti dell’oggetto. |
| buffer_size_hint | int | r/w | Ottiene o imposta il suggerimento della dimensione del buffer, che è definito come dimensione massima consentita per tutti i buffer interni. |
| container | Image | r | Ottiene il contenitore Image. |
| creation_date | System.DateTime | r | Recuperando la data di creazione dai commenti delle EPS Document Structuring Conventions (DSC) questa proprietà fornisce metadati essenziali che indicano l’origine del file EPS . Accedendo a queste informazioni, gli utenti ottengono approfondimenti sull’origine e la cronologia del file, migliorando la gestione e l’organizzazione dei file. |
| creator | string | r | Questa proprietà offre l’accesso alle informazioni sul creatore provenienti dai commenti delle EPS Document Structuring Conventions (DSC) trovati all’interno del file EPS. Comprendere i dettagli del creatore fornisce indicazioni sul software o sullo strumento utilizzato per generare il file EPS, facilitando la valutazione della compatibilità su varie piattaforme e applicazioni. |
| 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. |
| eps_type | EpsType | r | Accedi e interpreta il valore del sottotipo della tua immagine EPS, semplificando il tuo flusso di lavoro e migliorando la compatibilità su tutte le piattaforme. Ideale per ottimizzare il recupero del sottotipo EPS nei tuoi progetti con precisione ed efficienza. |
| exif_data | ExifData | r/w | Ottiene o imposta l’istanza Exif. |
| file_format | FileFormat | r | Accedi al formato file della tua immagine con questa proprietà. Recupera le informazioni essenziali sul formato del file immagine, facilitando la compatibilità e l’elaborazione efficiente. Ideale per identificare il formato dei tuoi file immagine per un’integrazione fluida nei tuoi progetti. |
| has_background_color | bool | r/w | Ottiene o imposta un valore che indica se l’immagine ha un colore di sfondo. |
| has_raster_preview | bool | r | Scopri la presenza di un’anteprima raster senza sforzo con questa proprietà. Accedi al valore booleano che indica se l’istanza EpsImage include un anteprima raster, potenziando le tue attività di elaborazione delle immagini con chiarezza ed efficienza. Ideale per semplificare le decisioni di flusso di lavoro basate sulla presenza o assenza di anteprime raster nelle immagini EPS. |
| height | int | r | Ottiene l’altezza dell’immagine. |
| height_f | float | r | Accedi all’altezza dell’immagine usando questa proprietà. Ottieni l’altezza dell’immagine con facilità, consentendo regolazioni di layout fluide, calcoli del rapporto d’aspetto e rendering preciso su diverse risoluzioni dello schermo e ambienti di visualizzazione. |
| interrupt_monitor | InterruptMonitor | r/w | Ottiene o imposta il monitor di interruzione. |
| is_cached | bool | r | Questa proprietà fornisce un modo comodo per verificare se i dati dell’oggetto sono attualmente memorizzati nella cache, eliminando la necessità di letture aggiuntive. Offre un metodo rapido ed efficiente per determinare se le informazioni richieste sono prontamente disponibili, ottimizzando le prestazioni e riducendo il consumo di risorse in operazioni ad alta intensità di 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. |
| post_script_version | string | r | Questa proprietà recupera la versione PostScript associata all’ istanza EpsImage. Fornisce informazioni sulla specifica versione del linguaggio PostScript utilizzata nel file EPS, aiutando nella valutazione della compatibilità e facilitando l’integrazione fluida con ambienti compatibili con PostScript. |
| preview_image_count | int | r | Accedi al numero di anteprime disponibili con facilità. Questa proprietà ti consente di recuperare senza sforzo il conteggio delle anteprime associate al tuo file, permettendo una gestione efficiente e una navigazione delle anteprime delle immagini. Ideale per ottimizzare il tuo flusso di lavoro e organizzare efficacemente le risorse immagine. |
| preview_images | Image[] | r | Recupera le anteprime associate al tuo file. Questa proprietà fornisce un accesso fluido alla collezione di anteprime, consentendoti di navigare e gestirle in modo efficiente secondo le necessità. Ideale per visualizzare rapidamente e selezionare l’immagine giusta per il tuo progetto. |
| size | Size | r | Ottiene la dimensione dell’oggetto. |
| size_f | SizeF | r | Ottiene le dimensioni dell’oggetto, in pollici. |
| titolo | string | r | Questa proprietà recupera il titolo estratto dai commenti delle EPS Document Structuring Conventions (DSC) incorporati nel file EPS. Fornisce metadati preziosi sul contenuto del file EPS, aiutando nell’organizzazione dei documenti e nell’identificazione all’interno di applicazioni software compatibili. |
| 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 | Recupera la larghezza dell’immagine con questa pratica proprietà. Ottieni la larghezza dell’immagine senza sforzo, facilitando calcoli di layout precisi, operazioni di ridimensionamento e compiti relativi alle dimensioni nella tua applicazione. Ideale per garantire un rendering accurato e una visualizzazione delle immagini su varie piattaforme e dispositivi. |
| xmp_data | XmpPacketWrapper | r/w | Ottiene o imposta i dati Xmp. |
Methods
| Name | Descrizione |
|---|---|
| cache_data() | Questo metodo non fa nulla poiché l’attuale implementazione della classe EpsImage non prevede la memorizzazione nella cache dei dati. Sebbene non esegua alcuna azione, comprendere questo comportamento è fondamentale per gli sviluppatori che lavorano con immagini EPS, garantendo una gestione efficiente delle risorse e prestazioni ottimali nelle loro applicazioni. |
| 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_preview_image(format) | Recupera l’anteprima esistente nel format specificato o restituisce None se non ne viene trovata alcuna. Questo metodo offre flessibilità nell’ accesso alle anteprime adattate a formati specifici, ottimizzando la compatibilità e la gestione delle risorse nelle applicazioni. |
| get_preview_images() | Accede alle anteprime collegate all’istanza EpsImage, consentendo un recupero fluido per l’ispezione o l’utilizzo nelle applicazioni. Questo metodo fornisce un accesso comodo alle anteprime, migliorando l’interazione dell’utente con i dati dell’immagine. |
| 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 la larghezza nuova specificata. |
| resize(new_width, new_height, settings) | Ridimensiona l’immagine con opzioni estese. |
| resize_by_settings(new_width, new_height, settings) | Ridimensiona l’immagine. |
| resize_by_type(new_width, new_height, resize_type) | Ridimensiona l’immagine. |
| resize_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 le palette di immagine per ottenere schemi di colore unici e migliorare l’appeal visivo. Adatta i colori per effetti specifici e ottimizza la qualità dell’immagine su diverse piattaforme e dispositivi con facilità. |
| try_set_metadata(metadata) | Cerca di impostare un’istanza metadata, se questa istanza di Image supporta e implementa l’istanza IImageMetadataFormat. |
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_preview_image(format)
get_preview_image(format)
Recupera l’anteprima esistente nel format specificato o
restituisce None se non ne viene trovata alcuna. Questo metodo offre flessibilità nell’
accesso alle anteprime adattate a formati specifici, ottimizzando la compatibilità e la
gestione delle risorse nelle applicazioni.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| format | EpsPreviewFormat | Il formato dell’anteprima EPS. |
Returns
| Tipo | Descrizione |
|---|---|
| Image | L’anteprima esistente o None. |
Method: get_preview_images()
get_preview_images()
Accede alle anteprime collegate all’istanza EpsImage, consentendo
un recupero fluido per l’ispezione o l’utilizzo nelle applicazioni. Questo metodo
fornisce un accesso comodo alle anteprime, migliorando l’interazione dell’utente con i
dati dell’immagine.
Returns
| Tipo | Descrizione |
|---|---|
| System.Collections.Generic.IEnumerable`1[[Aspose.Imaging.Image]] | Le anteprime. |
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 la larghezza nuova specificata.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| new_width | int | La nuova larghezza. |
| new_height | int | La nuova altezza. |
| resize_type | ResizeType | Tipo di ridimensionamento. |
See also:
Example # 1: Resize EPS image and export it to PNG format.
Method: resize(new_width, new_height, settings)
resize(new_width, new_height, settings)
Ridimensiona l’immagine con opzioni estese.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| new_width | int | La nuova larghezza. |
| new_height | int | La nuova altezza. |
| settings | ImageResizeSettings | Le impostazioni di ridimensionamento. |
See also:
Example # 1: Resize EPS image using advanced settings.
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 le palette di immagine per ottenere schemi di colore unici e migliorare l’appeal visivo.
Adatta i colori per effetti specifici e ottimizza la qualità dell’immagine su diverse
piattaforme e dispositivi con facilità.
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)
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
Convert EPS image to PNG using PostScript rendering.
import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.eps import EpsImage, EpsPreviewFormat
from aspose.imaging.imageoptions import PngOptions
with aspycore.as_of(Image.load("Sample.eps"), EpsImage) as image:
obj_init = EpsRasterizationOptions()
obj_init.page_width = 500
obj_init.page_height = 500
obj_init.preview_to_export = EpsPreviewFormat.POST_SCRIPT_RENDERING
options = PngOptions()
obj_init2.vector_rasterization_options = obj_init
# Renderizza l'immagine raster utilizzando il PostScript
image.save("Sample.png", options)
Convert EPS image to PDF using PostScript rendering.
from aspose.imaging import Image, PdfComplianceVersion
from aspose.imaging.imageoptions import PdfOptions
from aspose.imaging.fileformats.pdf import PdfCoreOptions
with Image.load("Sample.eps") as image:
options = PdfOptions()
options.pdf_core_options = PdfCoreOptions()
options.pdf_core_options.pdf_compliance = PdfComplianceVersion.PDF_A1B # Set required PDF compliance
image.save("Sample.pdf", options)
Resize EPS image and export it to PNG format.
from aspose.imaging import Image, ResizeType
from aspose.imaging.imageoptions import PngOptions
# Carica immagine EPS
with Image.load("AstrixObelix.eps") as image:
# Ridimensiona l'immagine usando il metodo di interpolazione cubica Mitchell
image.resize(400, 400, ResizeType.MITCHELL)
# Esporta l'immagine in formato PNG
image.save("ExportResult.png", PngOptions())
Resize EPS image using advanced settings.
import aspose.pycore as aspycore
from aspose.imaging import Image, ImageResizeSettings, ResizeType, ImageFilterType, ColorCompareMethod, ColorQuantizationMethod
from aspose.imaging.imageoptions import PngOptions
#Carica immagine EPS
with Image.load("AstrixObelix.eps") as image:
# Ridimensiona l'immagine usando impostazioni avanzate di ridimensionamento
obj_init = ImageResizeSettings()
obj_init.mode = ResizeType.LANCZOS_RESAMPLE
obj_init.filter_type = ImageFilterType.SMALL_RECTANGULAR
obj_init.color_compare_method = ColorCompareMethod.EUCLIDIAN
obj_init.color_quantization_method = ColorQuantizationMethod.POPULARITY
image.resize(400, 400, obj_init)
# Esporta l'immagine in formato PNG
image.save("ExportResult.png", PngOptions())