System.Drawing.Imaging Namespace
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Bietet erweiterte GDI+-Imageerstellungsfunktionen. Grundlegende Grafikfunktionen werden vom System.Drawing Namespace bereitgestellt.
Klassen
| Name | Beschreibung |
|---|---|
| BitmapData |
Gibt die Attribute eines Bitmapbilds an. Die BitmapData Klasse wird von den LockBits Klassen und UnlockBits(BitmapData) Methoden Bitmap verwendet. Nicht vererbbar. |
| ColorMap |
Definiert eine Karte zum Konvertieren von Farben. Verschiedene Methoden der ImageAttributes Klasse passen Bildfarben mithilfe einer Farbzuordnungstabelle an, bei der es sich um ein Array von ColorMap Strukturen handelt. Nicht vererbbar. |
| ColorMatrix |
Definiert eine 5 x 5-Matrix, die die Koordinaten für den RGBAW-Raum enthält. Verschiedene Methoden der ImageAttributes Klasse passen Bildfarben mithilfe einer Farbmatrix an. Diese Klasse kann nicht vererbt werden. |
| ColorPalette |
Definiert ein Array von Farben, aus denen eine Farbpalette besteht. Die Farben sind 32-Bit-ARGB-Farben. Nicht vererbbar. |
| Encoder |
Ein Encoder Objekt kapselt einen global eindeutigen Bezeichner (GUID), der die Kategorie eines Bildgeberparameters identifiziert. |
| EncoderParameter |
Wird verwendet, um einen Wert oder ein Array von Werten an einen Bildgeber zu übergeben. |
| EncoderParameters |
Kapselt ein Array von EncoderParameter Objekten. |
| FrameDimension |
Stellt Eigenschaften bereit, die die Frameabmessungen eines Bilds abrufen. Nicht vererbbar. |
| ImageAttributes |
Enthält Informationen dazu, wie Bitmap- und Metadateifarben während des Renderings bearbeitet werden. |
| ImageCodecInfo |
Die ImageCodecInfo Klasse stellt die erforderlichen Speichermber und Methoden bereit, um alle relevanten Informationen zu den installierten Image-Encodern und Decodern (als Codecs bezeichnet) abzurufen. Nicht vererbbar. |
| ImageFormat |
Gibt das Dateiformat des Bilds an. Nicht vererbbar. |
| Metafile |
Definiert eine Grafikmetadatei. Eine Metadatei enthält Datensätze, die eine Abfolge von Grafikvorgängen beschreiben, die aufgezeichnet (konstruiert) und wiedergegeben werden können (angezeigt). Diese Klasse ist nicht vererbbar. |
| MetafileHeader |
Enthält Attribute einer zugeordneten Metafile. Nicht vererbbar. |
| MetaHeader |
Enthält Informationen zu einer WMF-Metadatei (Windows-Format). |
| PropertyItem |
Kapselt eine Metadateneigenschaft, die in eine Bilddatei eingeschlossen werden soll. Nicht vererbbar. |
| WmfPlaceableFileHeader |
Definiert eine platzierbare Metadatei. Nicht vererbbar. |
Enumerationen
| Name | Beschreibung |
|---|---|
| ColorAdjustType |
Gibt an, welche GDI+-Objekte Farbanpassungsinformationen verwenden. |
| ColorChannelFlag |
Gibt einzelne Kanäle im CMYK -Farbraum (Cyan, Magenta, Gelb, Schwarz) an. Diese Aufzählung wird von den SetOutputChannel Methoden verwendet. |
| ColorMapType |
Gibt die Arten von Farbzuordnungen an. |
| ColorMatrixFlag |
Gibt die Arten von Bildern und Farben an, die von den Einstellungen für die Farb- und Graustufenanpassung eines ImageAttributesbeeinflusst werden. |
| ColorMode |
Gibt zwei Modi für Farbkomponentenwerte an. |
| EmfPlusRecordType |
Gibt die methoden an, die für die Verwendung mit einer Metadatei zum Lesen und Schreiben von Grafikbefehlen verfügbar sind. |
| EmfType |
Gibt die Art der Datensätze an, die in einer EMF-Datei (Enhanced Metafile) abgelegt werden. Diese Aufzählung wird von mehreren Konstruktoren in der Metafile-Klasse verwendet. |
| EncoderParameterValueType |
Gibt den Datentyp der EncoderParameter an, die mit der Save- oder SaveAdd Methode eines Bilds verwendet wird. |
| EncoderValue |
Wird verwendet, um den Parameterwert anzugeben, der bei Verwendung der methoden Save(String, ImageCodecInfo, EncoderParameters) oder SaveAdd(EncoderParameters) an einen JPEG- oder TIFF-Bildgeber übergeben wird. |
| ImageCodecFlags |
Stellt Attribute eines Bild-Encoders/Decoders (Codec) bereit. |
| ImageFlags |
Gibt die Attribute der Pixeldaten an, die in einem Image -Objekt enthalten sind. Die Flags-Eigenschaft gibt ein Element dieser Enumeration zurück. |
| ImageLockMode |
Gibt Flags an, die an den Flags-Parameter der LockBits -Methode übergeben werden. Die LockBits-Methode sperrt einen Teil eines Bilds, sodass Sie die Pixeldaten lesen oder schreiben können. |
| MetafileFrameUnit |
Gibt die Maßeinheit für das Rechteck an, das zum Vergrößern und Positionieren einer Metadatei verwendet wird. Dies wird während der Erstellung des Metafile-Objekts angegeben. |
| MetafileType |
Gibt Typen von Metadateien an. Die Type-Eigenschaft gibt ein Element dieser Enumeration zurück. |
| PaletteFlags |
Gibt den Typ der Farbdaten in der Systempalette an. Die Daten können Farbdaten mit Nur-Alpha-, Graustufen- oder Halbtondaten sein. |
| PixelFormat |
Gibt das Format der Farbdaten für jedes Pixel im Bild an. |
Delegaten
| Name | Beschreibung |
|---|---|
| PlayRecordCallback |
Dieser Delegat wird nicht verwendet. Ein Beispiel zum Aufzählen der Datensätze einer Metadatei finden Sie unter EnumerateMetafile(Metafile, Point, Graphics+EnumerateMetafileProc). |
Hinweise
Vorsicht
Der System.Drawing Namespace hat einige Einschränkungen für bestimmte Betriebssysteme und Anwendungstypen.
Bei Windows hängt
System.Drawingvon der nativen GDI+-Bibliothek ab, die als Teil des Betriebssystems ausgeliefert wird. Einige Windows SKUs, z. B. Windows Server Core oder Windows Nano, enthalten diese native Bibliothek nicht als Teil des Betriebssystems. Wenn Sie diesen Namespace verwenden und die Bibliothek nicht geladen werden kann, werden Ausnahmen zur Laufzeit ausgelöst.Einige Typen im
System.Drawing-Namespace basieren auf GDI+, die in Windows Diensten und ASP.NET Core und ASP.NET Apps nicht unterstützt wird. Diese Typen sind im Paket "System.Drawing.Common NuGet" enthalten und enthalten und enthalten System.Drawing.Bitmap .System.Drawing.Font Grundtypen im Namespace, z System.Drawing.Color. B. , System.Drawing.Size, System.Drawing.Pointund System.Drawing.Rectangle, können jedoch in jeder beliebigen Anwendung verwendet werden.In .NET 5 und früheren Versionen funktioniert das System.Drawing.Common NuGet-Paket unter Windows, Linux und macOS. Es gibt jedoch einige Plattformunterschiede. Unter Linux und macOS wird die GDI+-Funktionalität von der libgdiplus) -Bibliothek implementiert. Diese Bibliothek ist in den meisten Linux-Distributionen nicht standardmäßig installiert und unterstützt nicht alle Funktionen von GDI+ auf Windows und macOS. Es gibt auch Plattformen, auf denen libgdiplus überhaupt nicht verfügbar ist. Um Typen aus dem System.Drawing.Common-Paket unter Linux und macOS zu verwenden, müssen Sie libgdiplus separat installieren. Weitere Informationen finden Sie unter Install .NET unter Linux oder Install .NET unter macOS.
In .NET 6 und höheren Versionen wird das System.Drawing.Common NuGet-Paket nur unter Windows Betriebssystemen unterstützt. Weitere Informationen finden Sie unter System.Drawing.Common wird nur unter Windows unterstützt.
Wenn Sie System.Drawing nicht mit Ihrer Anwendung verwenden können, Empfohlene Alternativen sind ImageSharp, SkiaSharp, Windows Imaging Components und Microsoft. Maui.Graphics.
Die Metafile Klasse stellt Methoden zum Aufzeichnen und Speichern von Metadateien bereit. Mit der Encoder Klasse können Benutzer GDI+ erweitern, um ein beliebiges Bildformat zu unterstützen. Die PropertyItem Klasse stellt Methoden zum Speichern und Abrufen von Metadaten in Bilddateien bereit.
Vorsicht
Klassen innerhalb des namespaces System.Drawing.Imaging werden für die Verwendung innerhalb eines Windows- oder ASP.NET-Diensts nicht unterstützt. Wenn Sie versuchen, diese Klassen aus einem dieser Anwendungstypen zu verwenden, können unerwartete Probleme auftreten, z. B. verringerte Dienstleistung und Laufzeit-Ausnahmen.