System.Drawing.Imaging Spazio dei nomi

Fornisce funzionalità avanzate di creazione dell'immagine GDI+ . La funzionalità grafica di base viene fornita dallo spazio dei System.Drawing nomi .

Classi

Nome Descrizione
BitmapData

Specifica gli attributi di un'immagine bitmap. La BitmapData classe viene utilizzata dai LockBits metodi e UnlockBits(BitmapData) della Bitmap classe . Non ereditabile.

ColorMap

Definisce una mappa per la conversione dei colori. Diversi metodi della classe regolano i ImageAttributes colori delle immagini usando una tabella di mapping dei colori, ovvero una matrice di ColorMap strutture. Non ereditabile.

ColorMatrix

Definisce una matrice 5 x 5 che contiene le coordinate per lo spazio RGBAW. Diversi metodi della classe regolano i ImageAttributes colori delle immagini usando una matrice di colori. La classe non può essere ereditata.

ColorPalette

Definisce una matrice di colori che costituiscono una tavolozza dei colori. I colori sono colori ARGB a 32 bit. Non ereditabile.

Encoder

Un Encoder oggetto incapsula un identificatore univoco globale (GUID) che identifica la categoria di un parametro del codificatore di immagini.

EncoderParameter

Usato per passare un valore, o una matrice di valori, a un codificatore di immagini.

EncoderParameters

Incapsula una matrice di EncoderParameter oggetti.

FrameDimension

Fornisce proprietà che ottengono le dimensioni del frame di un'immagine. Non ereditabile.

ImageAttributes

Contiene informazioni sulla modalità di modifica dei colori bitmap e metafile durante il rendering.

ImageCodecInfo

La ImageCodecInfo classe fornisce i metodi e i membri di archiviazione necessari per recuperare tutte le informazioni pertinenti sui codificatori e decodificatori di immagini installati (denominati codec). Non ereditabile.

ImageFormat

Specifica il formato di file dell'immagine. Non ereditabile.

Metafile

Definisce un metafile grafico. Un metafile contiene record che descrivono una sequenza di operazioni grafiche che possono essere registrate (costruite) e riprodotte (visualizzate). Questa classe non è ereditabile.

MetafileHeader

Contiene gli attributi di un oggetto associato Metafile. Non ereditabile.

MetaHeader

Contiene informazioni su un metafile wmf (Windows-Format).

PropertyItem

Incapsula una proprietà di metadati da includere in un file di immagine. Non ereditabile.

WmfPlaceableFileHeader

Definisce un metafile posizionabile. Non ereditabile.

Enumerazioni

Nome Descrizione
ColorAdjustType

Specifica gli oggetti GDI+ che utilizzano informazioni sulla regolazione del colore.

ColorChannelFlag

Specifica i singoli canali nello spazio dei colori CMYK (ciano, magenta, giallo, nero). Questa enumerazione viene utilizzata dai metodi SetOutputChannel.

ColorMapType

Specifica i tipi di mappe a colori.

ColorMatrixFlag

Specifica i tipi di immagini e colori che saranno interessati dalle impostazioni di regolazione del colore e della scala di grigi di un ImageAttributes.

ColorMode

Specifica due modalità per i valori dei componenti colore.

EmfPlusRecordType

Specifica i metodi disponibili per l'uso con un metafile per leggere e scrivere comandi grafici.

EmfType

Specifica la natura dei record inseriti in un file EMF (Enhanced Metafile). Questa enumerazione viene usata da diversi costruttori nella classe Metafile.

EncoderParameterValueType

Specifica il tipo di dati del EncoderParameter utilizzato con il metodo Save o SaveAdd di un'immagine.

EncoderValue

Consente di specificare il valore del parametro passato a un codificatore di immagini JPEG o TIFF quando si usano i metodi Save(String, ImageCodecInfo, EncoderParameters) o SaveAdd(EncoderParameters).

ImageCodecFlags

Fornisce gli attributi di un codificatore/decodificatore di immagini (codec).

ImageFlags

Specifica gli attributi dei dati pixel contenuti in un oggetto Image. La proprietà Flags restituisce un membro di questa enumerazione.

ImageLockMode

Specifica i flag passati al parametro flags del metodo LockBits. Il metodo LockBits blocca una parte di un'immagine in modo da poter leggere o scrivere i dati pixel.

MetafileFrameUnit

Specifica l'unità di misura per il rettangolo utilizzato per ridimensionare e posizionare un metafile. Viene specificato durante la creazione dell'oggetto Metafile.

MetafileType

Specifica i tipi di metafile. La proprietà Type restituisce un membro di questa enumerazione.

PaletteFlags

Specifica il tipo di dati di colore nella tavolozza di sistema. I dati possono essere dati a colori con dati alfa, in scala di grigi o a metàtone.

PixelFormat

Specifica il formato dei dati di colore per ogni pixel nell'immagine.

Delegati

Nome Descrizione
PlayRecordCallback

Questo delegato non viene usato. Per un esempio di enumerazione dei record di un metafile, vedere EnumerateMetafile(Metafile, Point, Graphics+EnumerateMetafileProc).

Commenti

Caution

Lo System.Drawing spazio dei nomi presenta alcune limitazioni per determinati sistemi operativi e tipi di applicazione.

  • In Windows, System.Drawing dipende dalla libreria nativa GDI+ fornita come parte del sistema operativo. Alcuni SKU Windows, ad esempio Windows Server Core o Windows Nano, non includono questa libreria nativa come parte del sistema operativo. Se si usa questo spazio dei nomi e non è possibile caricare la libreria, le eccezioni verranno generate in fase di esecuzione.

  • Alcuni tipi nello spazio dei nomi System.Drawing si basano su GDI+, che non è supportato nei servizi Windows e nelle app ASP.NET Core e ASP.NET. Questi tipi si trovano nel pacchetto NuGet System.Drawing.Common e includono System.Drawing.Bitmap e System.Drawing.Font. Tuttavia, i tipi primitivi nello spazio dei nomi, ad esempio System.Drawing.Color, System.Drawing.SizeSystem.Drawing.Point, e System.Drawing.Rectangle, possono essere usati in qualsiasi applicazione.

  • In .NET 5 e versioni precedenti, il pacchetto NuGet System.Drawing.Common funziona in Windows, Linux e macOS. Esistono tuttavia alcune differenze di piattaforma. In Linux e macOS, la funzionalità GDI+ viene implementata dalla libreria libgdiplus ). Questa libreria non è installata per impostazione predefinita nella maggior parte delle distribuzioni Linux e non supporta tutte le funzionalità di GDI+ in Windows e macOS. Ci sono anche piattaforme in cui libgdiplus non è affatto disponibile. Per usare i tipi del pacchetto System.Drawing.Common in Linux e macOS, è necessario installare libgdiplus separatamente. Per altre informazioni, vedere Installare .NET in Linux o Installare .NET in macOS.

  • In .NET 6 e versioni successive, il pacchetto NuGet System.Drawing.Common è supportato solo nei sistemi operativi Windows. Per altre informazioni, vedere System.Drawing.Common supportato solo in Windows.

Se non è possibile usare System.Drawing con l'applicazione, Le alternative consigliate includono ImageSharp, SkiaSharp, Windows Imaging Components e Microsoft. Maui.Graphics.

La Metafile classe fornisce metodi per la registrazione e il salvataggio di metafile. La Encoder classe consente agli utenti di estendere GDI+ per supportare qualsiasi formato di immagine. La PropertyItem classe fornisce metodi per l'archiviazione e il recupero di metadati nei file di immagine.

Caution

Le classi all'interno dello spazio dei nomi System.Drawing.Imaging non sono supportate per l'uso all'interno di un servizio Windows o ASP.NET. Il tentativo di usare queste classi all'interno di uno di questi tipi di applicazione può generare problemi imprevisti, ad esempio le prestazioni del servizio ridotte e le eccezioni in fase di esecuzione.

Vedi anche