System.Drawing.Imaging Espace de noms

Fournit des fonctionnalités d’imagerie GDI+ avancées. Des fonctionnalités graphiques de base sont fournies par l'espace de noms System.Drawing.

Classes

BitmapData

Spécifie les attributs d'une bitmap. La classe BitmapData est utilisée par les méthodes LockBits et UnlockBits(BitmapData) de la classe Bitmap. Héritage impossible.

CachedBitmap

Représente une copie dépendante de l’appareil d’un Bitmap correspondant aux paramètres d’appareil actuels (d’affichage) d’un objet spécifié Graphics . Évite l’étape de reformatage lors du rendu, ce qui peut améliorer considérablement les performances.

ColorMap

Définit une table pour la conversion des couleurs. Plusieurs méthodes de la classe ImageAttributes permettent d'ajuster les couleurs d'une image à l'aide d'une table de remappage des couleurs, qui est un tableau de structures ColorMap. Héritage impossible.

ColorMatrix

Définit une matrice 5 x 5 qui contient les coordonnées de l'espace RGBAW. Plusieurs méthodes de la classe ImageAttributes permettent d'affiner les couleurs d'une image à l'aide d'une matrice de couleurs. Cette classe ne peut pas être héritée.

ColorPalette

Définit un tableau de couleurs qui composent une palette de couleurs. Les couleurs sont des couleurs ARVB 32 bits. Héritage impossible.

Encoder

Un objet Encoder encapsule un GUID (Identificateur Global Unique) qui identifie la catégorie d'un paramètre d'encodeur d'image.

EncoderParameter

Utilisé pour passer une valeur ou un tableau de valeurs à un encodeur d'image.

EncoderParameters

Encapsule un tableau d'objets EncoderParameter.

FrameDimension

Fournit des propriétés qui obtiennent les dimensions de frame d'une image. Héritage impossible.

ImageAttributes

Contient des informations sur la manière dont les couleurs de bitmap et de métafichier sont manipulées pendant le rendu.

ImageCodecInfo

La classe ImageCodecInfo fournit les méthodes et les membres de stockage nécessaires pour récupérer toutes les informations appropriées concernant les encodeurs et décodeurs d'images (appelés codecs) installés. Héritage impossible.

ImageFormat

Spécifie le format de fichier de l'image. Héritage impossible.

Metafile

Définit un métafichier graphique. Un métafichier contient des enregistrements qui décrivent une séquence d'opérations de graphiques qui peuvent être enregistrées (construites) et lues (affichées). Cette classe n'est pas héritable.

MetafileHeader

Contient les attributs d'un Metafile associé. Héritage impossible.

MetaHeader

Contient des informations sur un métafichier (WMF) au format Windows.

PropertyItem

Encapsule une propriété de métadonnées à inclure dans un fichier image. Héritage impossible.

WmfPlaceableFileHeader

Définit un métafichier qui peut être placé. Héritage impossible.

Énumérations

ColorAdjustType

Spécifie quels objets GDI+ utilisent des informations de réglage des couleurs.

ColorChannelFlag

Spécifie des canaux individuels dans l'espace de couleurs CMJN (cyan, magenta, jaune, noir). Cette énumération est utilisée par les méthodes SetOutputChannel.

ColorMapType

Spécifie les types de table des couleurs.

ColorMatrixFlag

Spécifie les types d'images et de couleurs qui seront affectés par les paramètres de réglage des couleurs et des nuances de gris d'un ImageAttributes.

ColorMode

Spécifie deux modes pour des valeurs de composant de couleur.

DitherType

Fournit des fonctionnalités d’imagerie GDI+ avancées. Des fonctionnalités graphiques de base sont fournies par l'espace de noms System.Drawing.

EmfPlusRecordType

Spécifie les méthodes qui peuvent être utilisées avec un métafichier pour lire et écrire des commandes graphiques.

EmfType

Spécifie la nature des enregistrements qui sont placés dans un fichier EMF (métafichier amélioré). Cette énumération est utilisée par plusieurs constructeurs dans la classe Metafile.

EncoderParameterValueType

Spécifie le type de données du EncoderParameter utilisé avec la méthode Save ou SaveAdd d’une image.

EncoderValue

Utilisé pour spécifier la valeur du paramètre passé à un encodeur d'image JPEG ou TIFF lors de l'utilisation des méthodes Save(String, ImageCodecInfo, EncoderParameters) ou SaveAdd(EncoderParameters).

ImageCodecFlags

Fournit des attributs d'un encodeur/décodeur (codec) d'images.

ImageFlags

Spécifie les attributs des données de pixels contenues dans un objet Image. La propriété Flags retourne un membre de cette énumération.

ImageLockMode

Spécifie des indicateurs qui sont passés au paramètre des indicateurs de la méthode LockBits. La méthode verrouille LockBits une partie d'une image de sorte que vous puissiez lire ou écrire les données en pixels.

MetafileFrameUnit

Spécifie l'unité de mesure pour le rectangle utilisé pour dimensionner et positionner un métafichier. Elle est spécifiée pendant la création de l'objet Metafile.

MetafileType

Spécifie les types de métafichiers. La propriété Type retourne un membre de cette énumération.

PaletteFlags

Spécifie le type de données de couleur dans la palette du système. Les données peuvent être des données de couleur avec données alpha, données de nuances de gris uniquement ou données de demi-teintes.

PaletteType

Fournit des fonctionnalités d’imagerie GDI+ avancées. Des fonctionnalités graphiques de base sont fournies par l'espace de noms System.Drawing.

PixelFormat

Spécifie le format des données de couleur pour chaque pixel de l'image.

Délégués

PlayRecordCallback

Ce délégué n'est pas utilisé. Pour obtenir un exemple d'énumération des enregistrements d'un métafichier, consultez EnumerateMetafile(Metafile, Point, Graphics+EnumerateMetafileProc).

Remarques

Attention

L’espace System.Drawing de noms présente certaines limitations pour certains systèmes d’exploitation et types d’applications.

  • Sur Windows, System.Drawing dépend de la bibliothèque native GDI+, qui est fournie dans le cadre du système d’exploitation. Certaines références SKU Windows, telles que Windows Server Core ou Windows Nano, n’incluent pas cette bibliothèque native dans le cadre du système d’exploitation. Si vous utilisez cet espace de noms et que la bibliothèque ne peut pas être chargée, des exceptions sont levées au moment de l’exécution.

  • Certains types de l’espace System.Drawing de noms s’appuient sur GDI+, qui n’est pas pris en charge dans les services Windows et les applications ASP.NET Core et ASP.NET. Ces types se trouvent dans le package NuGet System.Drawing.Common et incluent System.Drawing.Bitmap et System.Drawing.Font. Toutefois, les types primitifs dans l’espace de noms, tels que System.Drawing.Color, System.Drawing.Size, System.Drawing.Pointet System.Drawing.Rectangle, peuvent être utilisés dans n’importe quelle application.

  • Dans .NET 5 et les versions antérieures, le package NuGet System.Drawing.Common fonctionne sur Windows, Linux et macOS. Toutefois, il existe des différences de plateforme. Sur Linux et macOS, la fonctionnalité GDI+ est implémentée par la bibliothèque libgdiplus ). Cette bibliothèque n’est pas installée par défaut dans la plupart des distributions Linux et ne prend pas en charge toutes les fonctionnalités de GDI+ sur Windows et macOS. Il existe également des plateformes où libgdiplus n’est pas disponible du tout. Pour utiliser des types du package System.Drawing.Common sur Linux et macOS, vous devez installer libgdiplus séparément. Pour plus d’informations, consultez Installer .NET sur Linux ou Installer .NET sur macOS.

  • Dans .NET 6 et versions ultérieures, le package NuGet System.Drawing.Common est uniquement pris en charge sur les systèmes d’exploitation Windows. Pour plus d’informations, consultez System.Drawing.Common uniquement pris en charge sur Windows.

Si vous ne pouvez pas utiliser System.Drawing avec votre application, les alternatives recommandées incluent ImageSharp, SkiaSharp, Windows Imaging Components et Microsoft.Maui.Graphics.

La Metafile classe fournit des méthodes pour enregistrer et enregistrer des métafichiers. La Encoder classe permet aux utilisateurs d’étendre GDI+ pour prendre en charge n’importe quel format d’image. La PropertyItem classe fournit des méthodes pour stocker et récupérer des métadonnées dans des fichiers image.

Attention

Les classes au sein de l’espace System.Drawing.Imaging de noms ne sont pas prises en charge pour une utilisation dans un service Windows ou ASP.NET. La tentative d’utilisation de ces classes à partir de l’un de ces types d’application peut générer des problèmes inattendus, tels que des performances de service réduites et des exceptions au moment de l’exécution.

Voir aussi