System.Drawing.Imaging Spazio dei nomi
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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.Drawingdipende 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.Drawingsi 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.