System.Drawing.Imaging Espacio de nombres

Referencia

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.
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.
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.
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 GDI+ nativa, que se incluye como parte del sistema operativo. Algunas Windows SKU, como Windows Server Core o Windows Nano, no incluyen esta biblioteca nativa como parte del sistema operativo. Si usa este espacio de nombres y no se puede cargar la biblioteca, se producirán excepciones en tiempo de ejecución.
Algunos tipos del espacio de nombres se basan GDI+ , que no se admite en Windows servicios y ASP.NET Core System.Drawing y ASP.NET aplicaciones. Estos tipos se encuentran en el paquete de NuGet System.Drawing.Common e incluyen System.Drawing.Bitmap y System.Drawing.Font . Sin embargo, los tipos primitivos del espacio de nombres, System.Drawing.Color como , , y , se pueden usar en cualquier System.Drawing.Size System.Drawing.Point System.Drawing.Rectangle aplicación.
En .NET 5 y versiones anteriores, el paquete de NuGet System.Drawing.Common funciona en Windows, Linux y macOS. Sin embargo, hay algunas diferencias de plataforma. En Linux y macOS, la GDI+ la biblioteca libgdiplus implementa la funcionalidad de instalación. Esta biblioteca no se instala 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, vea Instalar .NET en Linux o Instalar .NET en macOS.
En .NET 6 y versiones posteriores, el paquete de NuGet System.Drawing.Common solo se admite en Windows sistemas operativos. Para obtener más información, vea System.Drawing.Common only supported on Windows.

Si no puede usar con la aplicación, entre las alternativas recomendadas se incluyen System.Drawing ImageSharp, SkiaSharp, Windows Imaging Componentsy Microsoft.Graphics.

La Metafile clase proporciona métodos para grabar y guardar metarchivos. La Encoder clase permite a los usuarios ampliar GDI+ admitir cualquier formato de imagen. La PropertyItem clase proporciona métodos para almacenar y recuperar metadatos en archivos de imagen.