System.Drawing.Drawing2D 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 funcionalidad avanzada de gráficos vectoriales y bidimensionales.
Clases
AdjustableArrowCap |
Representa un extremo de línea ajustable en forma de flecha. Esta clase no puede heredarse. |
Blend |
Define un modelo de mezcla para un objeto LinearGradientBrush. Esta clase no puede heredarse. |
ColorBlend |
Define matrices de colores y posiciones utilizadas para intercalar mezclas de color en un degradado de color. Esta clase no puede heredarse. |
CustomLineCap |
Encapsula un extremo de línea personalizado definido por el usuario. |
GraphicsContainer |
Representa los datos internos de un contenedor de gráficos. Esta clase se usa al guardar el estado de un objeto Graphics con los métodos BeginContainer() y EndContainer(GraphicsContainer). Esta clase no puede heredarse. |
GraphicsPath |
Representa una serie de líneas y curvas conectadas. Esta clase no puede heredarse. |
GraphicsPathIterator |
Permite recorrer en iteración los subtrazados de un objeto GraphicsPath y comprueba los tipos de las formas incluidas en cada subtrazado. Esta clase no puede heredarse. |
GraphicsState |
Representa el estado de un objeto Graphics. Una llamada al método Save() devuelve este objeto. Esta clase no puede heredarse. |
HatchBrush |
Define un pincel rectangular con un estilo de trama, un color de primer plano y un color de fondo. Esta clase no puede heredarse. |
LinearGradientBrush |
Encapsula un Brush con un degradado lineal. Esta clase no puede heredarse. |
Matrix |
Encapsula una matriz 3 por 3 afín que representa una transformación geométrica. Esta clase no puede heredarse. |
PathData |
Contiene los datos gráficos que forman un objeto GraphicsPath. Esta clase no puede heredarse. |
PathGradientBrush |
Encapsula un objeto Brush que rellena el interior de un objeto GraphicsPath con un degradado. Esta clase no puede heredarse. |
RegionData |
Encapsula los datos que forman un objeto Region. Esta clase no puede heredarse. |
Enumeraciones
CombineMode |
Especifica cómo se pueden combinar regiones de recorte distintas. |
CompositingMode |
Especifica cómo se combinan los colores de origen con los colores del fondo. |
CompositingQuality |
Especifica el nivel de calidad que se va a usar para la composición. |
CoordinateSpace |
Especifica el sistema que se va a usar para evaluar coordenadas. |
DashCap |
Especifica el tipo de forma gráfica que se va a usar en ambos extremos de cada guión de una línea discontinua. |
DashStyle |
Especifica el estilo de las líneas discontinuas dibujadas con un objeto Pen. |
FillMode |
Especifica cómo se rellena el interior de un trazado cerrado. |
FlushIntention |
Especifica si los comandos de la pila de gráficos se terminan (vacían) inmediatamente o se ejecutan lo antes posible. |
HatchStyle |
Especifica los distintos patrones disponibles para los objetos HatchBrush. |
InterpolationMode |
La enumeración InterpolationMode especifica el algoritmo que se utiliza cuando se giran imágenes o se ajusta su tamaño. |
LinearGradientMode |
Especifica la dirección de un degradado lineal. |
LineCap |
Especifica los estilos de extremo de línea disponibles con los que un objeto Pen puede finalizar una línea. |
LineJoin |
Especifica cómo se unen de forma consecutiva segmentos de línea o curva en una figura (subruta) contenida en un objeto GraphicsPath. |
MatrixOrder |
Especifica el orden de las operaciones de transformación de la matriz. |
PathPointType |
Especifica el tipo de punto de un objeto GraphicsPath. |
PenAlignment |
Especifica la alineación de un objeto Pen en relación con la línea teórica de ancho cero. |
PenType |
Especifica el tipo de relleno que usa un objeto Pen para rellenar las líneas. |
PixelOffsetMode |
Especifica cómo se desplazan los píxeles durante la representación. |
QualityMode |
Especifica la calidad general de la representación de objetos GDI+. |
SmoothingMode |
Especifica si se aplica el suavizado de contorno a líneas y curvas y a los bordes de las áreas rellenas. |
WarpMode |
Especifica el tipo de transformación de alabeo que se aplica en el método Warp. |
WrapMode |
Especifica cómo se colocan en mosaico una textura o un degradado cuando son más pequeños que el área que se va a rellenar. |
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 distribuye 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, consulte System.Drawing.Common only supported on Windows(System.Drawing.Common only supported on Windows).
Si no puedes usar System.Drawing
con tu aplicación, las alternativas recomendadas incluyen ImageSharp, SkiaSharp, Windows Imaging Components y Microsoft.Maui.Graphics.
En la tabla siguiente se enumeran algunas de las clases y enumeraciones importantes del System.Drawing.Drawing2D espacio de nombres, agrupadas en categorías.
Categoría de clase | Detalles |
---|---|
- Rutas de acceso de gráficos y gráficos | Las GraphicsState clases y GraphicsContainer notifican información sobre el objeto actual Graphics . GraphicsPath las clases representan una serie de líneas y curvas. Las GraphicsPathIterator clases y PathData proporcionan información detallada sobre el contenido de un GraphicsPath objeto . |
- Matriz y tipos relacionados con la transformación | La Matrix clase representa una matriz para las transformaciones geométricas. La MatrixOrder enumeración especifica el orden de las transformaciones de matriz. |
- Clases brush | Las PathGradientBrush clases y HatchBrush permiten rellenar formas con un patrón de degradado o sombreado, respectivamente. |
- Enumeración relacionada con las líneas | Las LineCap enumeraciones y CustomLineCap permiten especificar estilos de límite para una línea. La enumeración , LineJoin permite especificar cómo se unen dos líneas en una ruta de acceso. La PenAlignment enumeración permite especificar la alineación de la punta de dibujo al dibujar una línea. La PenType enumeración especifica el patrón con el que se debe rellenar una línea. |
- Enumeraciones relacionadas con el relleno de formas y rutas de acceso | La HatchStyle enumeración especifica los estilos de relleno de .HatchBrush La Blend clase especifica un patrón de mezcla para .LinearGradientBrush La FillMode enumeración especifica el estilo de relleno de .GraphicsPath |
Precaución
Las clases del System.Drawing.Drawing2D espacio de nombres no se admiten para su uso en un servicio windows o ASP.NET. El intento de usar estas clases en 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.