Image

Image class

L’immagine è la classe base per tutti i tipi di immagini.

public abstract class Image : DataStreamSupporter, IObjectWithBounds

Proprietà

Nome	Descrizione
AutoAdjustPalette { get; set; }	Ottiene o imposta un valore che indica se regolare automaticamente la tavolozza.
virtual BackgroundColor { get; set; }	Ottiene o imposta un valore per il colore di sfondo.
abstract BitsPerPixel { get; }	Ottiene il numero di bit dell’immagine per pixel.
Bounds { get; }	Ottiene i limiti dell’immagine.
BufferSizeHint { get; set; }	Ottiene o imposta l’hint per la dimensione del buffer che è la dimensione massima consentita per tutti i buffer interni.
Container { get; }	Ottiene ilImage contenitore.
DataStreamContainer { get; }	Ottiene il flusso di dati dell’oggetto.
Disposed { get; }	Ottiene un valore che indica se questa istanza è stata eliminata.
virtual FileFormat { get; }	Ottiene un valore di formato file
virtual HasBackgroundColor { get; set; }	Ottiene o imposta un valore che indica se l’immagine ha il colore di sfondo.
abstract Height { get; }	Ottiene l’altezza dell’immagine.
InterruptMonitor { get; set; }	Ottiene o imposta il monitor di interruzione.
abstract IsCached { get; }	Ottiene un valore che indica se i dati dell’oggetto sono attualmente memorizzati nella cache e non è richiesta la lettura dei dati.
Palette { get; set; }	Ottiene o imposta la tavolozza dei colori. La tavolozza dei colori non viene utilizzata quando i pixel sono rappresentati direttamente.
Size { get; }	Ottiene la dimensione dell’immagine.
virtual UsePalette { get; }	Ottiene un valore che indica se viene utilizzata la tavolozza dell’immagine.
abstract Width { get; }	Ottiene la larghezza dell’immagine.

Metodi

Nome	Descrizione
static Create(Image[])	Crea una nuova immagine utilizzando le immagini specificate come pagine
static Create(Image[], bool)	Crea una nuova immagine le immagini specificate come pagine.
static Create(ImageOptionsBase, int, int)	Crea una nuova immagine utilizzando le opzioni di creazione specificate.
static Load(Stream)	Carica una nuova immagine dal flusso specificato.
static Load(string)	Carica una nuova immagine dal file specificato.
static Load(Stream, LoadOptions)	Carica una nuova immagine dal flusso specificato.
static Load(string, LoadOptions)	Carica una nuova immagine dal file specificato.
abstract CacheData()	Memorizza i dati nella cache e garantisce che nessun ulteriore caricamento dei dati venga eseguito dal sottostanteDataStreamContainer .
CanSave(ImageOptionsBase)	Determina se l’immagine può essere salvata nel formato file specificato rappresentato dalle opzioni di salvataggio passate.
Dispose()	Elimina l’istanza corrente.
virtual GetDefaultOptions(object[])	Ottiene le opzioni predefinite.
virtual GetOriginalOptions()	Ottiene le opzioni in base alle impostazioni del file originale. Questo può essere utile per mantenere invariati la profondità di bit e altri parametri dell’immagine originale. Ad esempio, se carichiamo un’immagine PNG in bianco e nero con 1 bit per pixel e quindi salvalo usando il Save metodo, verrà prodotta l’immagine PNG di output con 8 bit per pixel. Per evitarlo e salvare l’immagine PNG con 1 bit per pixel, utilizzare questo metodo per ottenere le opzioni di salvataggio corrispondenti e passarle alSave metodo come secondo parametro.
Resize(int, int)	Ridimensiona l’immagine. Il predefinitoNearestNeighbourResample viene utilizzato.
abstract Resize(int, int, ImageResizeSettings)	Ridimensiona l’immagine.
abstract Resize(int, int, ResizeType)	Ridimensiona l’immagine.
ResizeHeightProportionally(int)	Ridimensiona proporzionalmente l’altezza. Il predefinitoNearestNeighbourResample viene utilizzato.
virtual ResizeHeightProportionally(int, ImageResizeSettings)	Ridimensiona proporzionalmente l’altezza.
virtual ResizeHeightProportionally(int, ResizeType)	Ridimensiona proporzionalmente l’altezza.
ResizeWidthProportionally(int)	Ridimensiona proporzionalmente la larghezza. Il predefinitoNearestNeighbourResample viene utilizzato.
virtual ResizeWidthProportionally(int, ImageResizeSettings)	Ridimensiona proporzionalmente la larghezza.
virtual ResizeWidthProportionally(int, ResizeType)	Ridimensiona proporzionalmente la larghezza.
abstract RotateFlip(RotateFlipType)	Ruota, capovolge o ruota e capovolge l’immagine.
Save()	Salva i dati dell’immagine nel flusso sottostante.
Save(Stream)	Salva i dati dell’oggetto nel flusso specificato.
override Save(string)	Salva l’immagine nella posizione del file specificata.
Save(Stream, ImageOptionsBase)	Salva i dati dell’immagine nel flusso specificato nel formato file specificato in base alle opzioni di salvataggio.
virtual Save(string, bool)	Salva i dati dell’oggetto nella posizione del file specificata.
virtual Save(string, ImageOptionsBase)	Salva i dati dell’oggetto nel percorso file specificato nel formato file specificato in base alle opzioni di salvataggio.
virtual Save(Stream, ImageOptionsBase, Rectangle)	Salva i dati dell’immagine nel flusso specificato nel formato file specificato in base alle opzioni di salvataggio.
virtual Save(string, ImageOptionsBase, Rectangle)	Salva i dati dell’oggetto nel percorso file specificato nel formato file specificato in base alle opzioni di salvataggio.
abstract SetPalette(IColorPalette, bool)	Imposta la tavolozza dell’immagine.
static CanLoad(Stream)	Determina se l’immagine può essere caricata dal flusso specificato.
static CanLoad(string)	Determina se l’immagine può essere caricata dal percorso file specificato.
static CanLoad(Stream, LoadOptions)	Determina se l’immagine può essere caricata dal flusso specificato e, facoltativamente, utilizzando quello specificatoloadOptions .
static CanLoad(string, LoadOptions)	Determina se l’immagine può essere caricata dal percorso file specificato e, facoltativamente, utilizzando le opzioni di apertura specificate.
static GetFileFormat(Stream)	Ottiene il formato del file.
static GetFileFormat(string)	Ottiene il formato del file.
static GetFittingRectangle(Rectangle, int, int)	Ottiene il rettangolo che si adatta all’immagine corrente.
static GetFittingRectangle(Rectangle, int[], int, int)	Ottiene il rettangolo che si adatta all’immagine corrente.
static GetProportionalHeight(int, int, int)	Ottiene un’altezza proporzionale.
static GetProportionalWidth(int, int, int)	Ottiene una larghezza proporzionale.

Esempi

Determina se la tavolozza viene utilizzata dall’immagine.

[C#]

using (var image = Image.Load(folder + "Sample.bmp"))
{
    if (image.UsePalette)
    {
        Console.WriteLine("The palette is used by the image");
    }
}

Ridimensiona l’immagine utilizzando un tipo di ridimensionamento specifico.

[C#]

using (var image = Image.Load("Photo.jpg"))
{
    image.Resize(640, 480, ResizeType.CatmullRom);
    image.Save("ResizedPhoto.jpg");

    image.Resize(1024, 768, ResizeType.CubicConvolution);
    image.Save("ResizedPhoto2.jpg");

    var resizeSettings = new ImageResizeSettings
    {
        Mode = ResizeType.CubicBSpline,
        FilterType = ImageFilterType.SmallRectangular
    };

    image.Resize(800, 800, resizeSettings);
    image.Save("ResizedPhoto3.jpg");
}

Questo esempio crea un nuovo file immagine in una posizione del disco come specificato dalla proprietà Source dell’istanza BmpOptions. Diverse proprietà per l’istanza BmpOptions vengono impostate prima di creare l’immagine effettiva. Soprattutto la proprietà Source, che in questo caso si riferisce alla posizione effettiva del disco.

[C#]

//Crea un'istanza di BmpOptions e imposta le sue varie proprietà
Aspose.Imaging.ImageOptions.BmpOptions bmpOptions = new Aspose.Imaging.ImageOptions.BmpOptions();
bmpOptions.BitsPerPixel = 24;

//Crea un'istanza di FileCreateSource e assegnala come origine per l'istanza di BmpOptions
//Il secondo parametro booleano determina se il file da creare è Temporale o meno
bmpOptions.Source = new Aspose.Imaging.Sources.FileCreateSource(@"C:\temp\output.bmp", false);

//Crea un'istanza di Image e inizializzala con un'istanza di BmpOptions chiamando il metodo Create
using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Create(bmpOptions, 500, 500))
{
    //eseguo un po' di elaborazione delle immagini

    // salva tutte le modifiche
    image.Save();
}

Guarda anche

• class DataStreamSupporter
• interface IObjectWithBounds
• spazio dei nomi Aspose.Imaging
• assemblea Aspose.Imaging