System.Drawing.Imaging Espacio de nombres

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.

Consulte también