System.Drawing.Imaging Espacio de nombres
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona la funcionalidad avanzada de imágenes de GDI+. Las funciones básicas de gráficos las proporciona el espacio de nombres System.Drawing.
Clases
BitmapData |
Especifica los atributos de una imagen de mapa de bits. La clase BitmapData la utilizan los métodos LockBits y UnlockBits(BitmapData) de la clase Bitmap. No puede heredarse. |
CachedBitmap |
Representa una copia dependiente del dispositivo de una configuración actual (display) de un Bitmap objeto especificado Graphics . Evita el paso de reformateo al representar, lo que puede mejorar significativamente el rendimiento. |
ColorMap |
Define un mapa de conversión de colores. Algunos de los métodos de la clase ImageAttributes ajustan los colores de la imagen mediante una tabla de reasignación de colores, consistente en una matriz de estructuras ColorMap. No puede heredarse. |
ColorMatrix |
Define una matriz de 5 x 5 que contiene las coordenadas del espacio RGBAW. Algunos de los métodos de la clase ImageAttributes ajustan los colores de la imagen mediante una matriz de colores. Esta clase no puede heredarse. |
ColorPalette |
Define una matriz de colores que constituyen una paleta de colores. Los colores son ARGB de 32 bits. No puede heredarse. |
Encoder |
Un objeto Encoder encapsula un identificador único global (GUID) que identifica la categoría de un parámetro de codificador de imagen. |
EncoderParameter |
Se utiliza para pasar un valor o una matriz de valores a un codificador de imágenes. |
EncoderParameters |
Encapsula una matriz de objetos EncoderParameter. |
FrameDimension |
Proporciona propiedades para obtener las dimensiones del marco de una imagen. No puede heredarse. |
ImageAttributes |
Contiene información acerca de la manipulación de los colores de los mapas de bits y de los metarchivos durante la representación. |
ImageCodecInfo |
La clase ImageCodecInfo proporciona los miembros y métodos de almacenamiento necesarios para recuperar toda la información relevante acerca de los codificadores y descodificadores (códecs) de imágenes instalados. No puede heredarse. |
ImageFormat |
Especifica el formato de archivo de la imagen. No puede heredarse. |
Metafile |
Define un metarchivo gráfico. Un metarchivo contiene registros que describen una secuencia de gráficos que pueden grabarse (construirse) y reproducirse (mostrarse). Esta clase no se hereda. |
MetafileHeader |
Contiene los atributos de un Metafile asociado. No puede heredarse. |
MetaHeader |
Contiene información acerca de un metarchivo Windows (WMF). |
PropertyItem |
Encapsula una propiedad de metadatos que debe incluirse en un archivo de imagen. No puede heredarse. |
WmfPlaceableFileHeader |
Define un metarchivo ubicable. No puede heredarse. |
Enumeraciones
ColorAdjustType |
Especifica qué objetos de GDI+ utilizan información de ajuste del color. |
ColorChannelFlag |
Especifica los canales individuales en el espacio de colores CMYK (aguamarina, fucsia, amarillo, negro). Los métodos SetOutputChannel utilizan esta enumeración. |
ColorMapType |
Especifica los tipos de asignaciones de colores. |
ColorMatrixFlag |
Especifica el tipo de imágenes y colores a los que afectarán los ajustes de color y escala de grises de ImageAttributes. |
ColorMode |
Especifica dos modos para los valores de los componentes de color. |
DitherType |
Proporciona la funcionalidad avanzada de imágenes de GDI+. Las funciones básicas de gráficos las proporciona el espacio de nombres System.Drawing. |
EmfPlusRecordType |
Especifica los métodos disponibles para leer y escribir comandos gráficos, para utilizarlos con metarchivos. |
EmfType |
Especifica la naturaleza de los registros situados en un archivo de tipo Metarchivo mejorado (EMF). Varios de los constructores de la clase Metafile utilizan esta enumeración. |
EncoderParameterValueType |
Especifica el tipo de datos del elemento EncoderParameter utilizado con el método Save o SaveAdd de una imagen. |
EncoderValue |
Se usa para especificar el valor de parámetro que se pasa a un codificador de imágenes JPEG o TIFF cuando se usan los métodos Save(String, ImageCodecInfo, EncoderParameters) o SaveAdd(EncoderParameters). |
ImageCodecFlags |
Proporciona atributos de un codificador/descodificador (códec) de una imagen. |
ImageFlags |
Especifica los atributos de los datos de píxeles contenidos en un objeto Image. La propiedad Flags devuelve un miembro de esta enumeración. |
ImageLockMode |
Especifica los marcadores que se pasan al parámetro marcadores del método LockBits. El método LockBits bloquea una parte de una imagen para poder leer o escribir los datos de píxeles. |
MetafileFrameUnit |
Especifica la unidad de medida del rectángulo utilizado para indicar el tamaño y posición de un metarchivo. Se especifica durante la creación del objeto Metafile. |
MetafileType |
Especifica los tipos de metarchivos. La propiedad Type devuelve un miembro de esta enumeración. |
PaletteFlags |
Especifica el tipo de datos de color en la paleta del sistema. Pueden ser datos de color alfa, datos de escala de grises o datos de semitonos. |
PaletteType |
Proporciona la funcionalidad avanzada de imágenes de GDI+. Las funciones básicas de gráficos las proporciona el espacio de nombres System.Drawing. |
PixelFormat |
Especifica el formato de los datos de color de cada uno de los píxeles de la imagen. |
Delegados
PlayRecordCallback |
Este delegado no se utiliza. Para obtener un ejemplo de enumeración de los registros de un metarchivo, vea EnumerateMetafile(Metafile, Point, Graphics+EnumerateMetafileProc). |
Comentarios
Precaución
El System.Drawing
espacio de nombres tiene algunas limitaciones para determinados sistemas operativos y tipos de aplicación.
En Windows,
System.Drawing
depende de la biblioteca nativa de GDI+, que se envía como parte del sistema operativo. Algunas SKU de Windows, como Windows Server Core o Windows Nano, no incluyen esta biblioteca nativa como parte del sistema operativo. Si usa este espacio de nombres y la biblioteca no se puede cargar, se producirán excepciones en tiempo de ejecución.Algunos tipos del
System.Drawing
espacio de nombres se basan en GDI+, que no se admite en los servicios de Windows y ASP.NET Core y ASP.NET aplicaciones. Estos tipos están en el paquete NuGet System.Drawing.Common e incluyen System.Drawing.Bitmap y System.Drawing.Font. Sin embargo, los tipos primitivos del espacio de nombres, como System.Drawing.Color, System.Drawing.Size, System.Drawing.Pointy System.Drawing.Rectangle, se pueden usar en cualquier aplicación.En .NET 5 y versiones anteriores, el paquete NuGet System.Drawing.Common funciona en Windows, Linux y macOS. Sin embargo, hay algunas diferencias de plataforma. En Linux y macOS, la biblioteca libgdiplus implementa la funcionalidad de GDI+. Esta biblioteca no está instalada de forma predeterminada en la mayoría de las distribuciones de Linux y no admite toda la funcionalidad de GDI+ en Windows y macOS. También hay plataformas en las que libgdiplus no está disponible en absoluto. Para usar tipos del paquete System.Drawing.Common en Linux y macOS, debe instalar libgdiplus por separado. Para obtener más información, consulte Instalación de .NET en Linux o Instalación de .NET en macOS.
En .NET 6 y versiones posteriores, el paquete NuGet System.Drawing.Common solo se admite en sistemas operativos Windows. Para obtener más información, vea System.Drawing.Common solo compatible con Windows.
Si no puedes usar System.Drawing
con la aplicación, las alternativas recomendadas incluyen ImageSharp, SkiaSharp, Windows Imaging Components y Microsoft.Maui.Graphics.
La Metafile clase proporciona métodos para grabar y guardar metarchivos. La Encoder clase permite a los usuarios ampliar GDI+ para admitir cualquier formato de imagen. La PropertyItem clase proporciona métodos para almacenar y recuperar metadatos en archivos de imagen.
Precaución
Las clases dentro del System.Drawing.Imaging espacio de nombres no se admiten para su uso en un servicio de Windows o ASP.NET. Intentar usar estas clases desde uno de estos tipos de aplicación puede producir problemas inesperados, como reducir el rendimiento del servicio y las excepciones en tiempo de ejecución.