1. IronDrawing
  2. Comenzar

Biblioteca Bitmap C# para reemplazar System.Drawing.Common en .NET

IronDrawing es gratuito, de código abierto y compatible con la mayoría de los formatos de bibliotecas de dibujo .NET.

IronDrawing es una biblioteca de código abierto desarrollada originalmente por Iron Software que ayuda a los ingenieros de software de C# a sustituir System.Drawing.Common en proyectos .NET en plataformas Windows, macOS y Linux.

Desarrollar bibliotecas de clases y paquetes NuGet para .NET 5, 6, 7 y 8 que admitan gráficos, imágenes y fuentes debería ser fácil.

IronDrawing actúa como un puente sin fisuras entre todos los nuevos estándares gráficos propuestos para .NET 5, 6, 7 y 8 a medida que evolucionan, por lo que sólo tendrá que desarrollar para el que prefiera.

IronDrawing es gratuito, de código abierto y compatible con la mayoría de los formatos de bibliotecas de dibujo .NET.

Pasos técnicos a evitar system.drawing.common no es compatible con esta excepción de plataforma

  1. Implementar System.drawing.common no es posible para .NET6 y .NET 7 & 8 en plataformas Linux y MacOs
  2. Usar System.Drawing.Common en estas plataformas se enfrentará con el mensaje de excepción
  3. Establecer System.Drawing.EnableUnixSupport configuración en tiempo de ejecución a verdadero para .NET6
  4. La compatibilidad con System.Drawing.Common ya no está disponible en .NET 7 y 8
  5. Utilizar una biblioteca de código abierto IronSoftware.Drawing sustituir System.Drawing.Common para .NET7

Contexto

Microsoft .NET es un marco de software multiplataforma y altamente compatible utilizado por millones de desarrolladores de software de todo el mundo. Microsoft ha anunciado un cambio de última hora por el que System.Drawing.Common sólo será compatible con plataformas Windows.

Esto es problemático para los desarrolladores de bibliotecas .NET que mantienen bibliotecas multiplataforma que utilizan System.Drawing.Common porque la directiva de Microsoft acción recomendada le obliga a reconstruir su biblioteca para que sea compatible con usuarios de sistemas operativos distintos de Windows. Se espera que voluntarios y académicos reconstruyan cada paquete NuGet y biblioteca de clases para utilizar cada de las nuevas bibliotecas gráficas sugeridas a medida que vayan surgiendo, lo que provocará una deuda técnica que ralentizará la adopción de .NET moderno.

En última instancia, cuando utilizamos .NET, utilizamos NuGet.

Los desarrolladores de paquetes NuGet nos hacen un favor a todos con el avance de .NET y el código preempaquetado que a nosotros nos llevaría miles de horas escribir cada día.

Este cambio rupturista ralentizará el desarrollo de NuGet y podría dar lugar a bibliotecas de código abandonadas u obsoletas de las que dependen los desarrolladores .NET. Tenemos que actuar ya!

Nuestra solución

Un intermediario de formatos gráficos que convierte entre todas las bibliotecas gráficas antiguas y nuevas.

Como desarrollador de bibliotecas de clases, sus entradas y salidas públicas Bitmap, Color, Rectangle, Font y Size sólo pueden ser de un tipo compatible con todos los nuevos estándares. Internamente, puedes seguir haciendo lo que quieras.

IronDrawing es compatible con .NET Framework 4.62 y con todas las versiones de .NET.(incluido .NET 8).

El desarrollo y lanzamiento de IronDrawing resuelve este problema proporcionando una solución de código abierto a la falta de un formato uniforme para clases importantes como Bitmap, Color, Rectangle, Font y Size. IronSoftware.Drawingconvertirá sin problemas entre las implementaciones de este tipo enSystem.Drawing,Microsoft.Maui,SkiaSharp, ySixLabors` para usted. Esto le permite a usted, el desarrollador, no tener que reemplazar todas las instancias de estas clases dentro de su biblioteca.

Para ejemploSi estás usando System.Drawing.Bitmap, puedes usar la clase AnyBitmap de IronDrawing que tiene conversiones implícitas a cualquiera de estos tipos: System.Drawing.Bitmap,System.Drawing.Image,SkiaSharp.SKBitmap,SkiaSharp.SKImage,SixLabors.ImageSharp,Microsoft.Maui.Graphics.Platform.PlatformImage`.

¿Por qué lo hacemos gratis?

Hemos desarrollado IronDrawing porque en Iron Software somos desarrolladores senior de .NET a largo plazo que nos preocupamos por la evolución de .NET y queremos que crezca y tenga éxito. Nos encanta ver que .NET crece y evoluciona, como se ha visto con .NET 7. Nosotros usamos NuGet todo el día, y seguro que usted también. Apoyamos y esperamos fomentar una transición fácil hacia el futuro y lejos de System.Drawing.

Queremos que todo el desarrollo de bibliotecas de clases .NET y NuGet sea más fácil, para que el ecosistema NuGet siga prosperando y para que todos los desarrolladores .NET se beneficien.

Características de IronSoftware.Drawing

  • AnyBitmap: Una clase Bitmap universalmente compatible. Casting implícito entre IronSoftware.Drawing.AnyBitmap y los siguientes soportados:

    • System.Drawing.Bitmap
    • System.Drawing.Image
    • SkiaSharp.SKBitmap.
    • SkiaSharp.SKImage
    • SixLabors.ImageSharp
    • Microsoft.Maui.Graphics.Platform.PlatformImage

  • Color: Una clase de Color universalmente compatible. Casting implícito entre IronSoftware.Drawing.Color y los siguientes soportados:

    • System.Drawing.Color
    • SkiaSharp.SKColor
    • SixLabors.ImageSharp.Color
    • SixLabors.ImageSharp.PixelFormats

  • Rectángulo: Una clase Rectangle universalmente compatible. Casting implícito entre IronSoftware.Drawing.Rectangle y los siguientes soportados:

    • System.Drawing.Rectangle
    • SkiaSharp.SKRect
    • SkiaSharp.SKRectI
    • SixLabors.ImageSharp.Rectangle

  • Fuente: Una clase de Fuente universalmente compatible. Casting implícito entre IronSoftware.Drawing.Font y los siguientes soportados:

    • System.Drawing.Font
    • SkiaSharp.SKFont
    • SixLabors.Fonts.Font

Compatibilidad

IronSoftware.Drawing tiene compatibilidad multiplataforma con:

  • .NET 8, .NET 7, .NET 6, .NET 5, .NET Core, .NET Standard y .NET Framework 4.62+.
  • Windows, macOS, Linux, Docker, Azure y AWS

Instalación

Instalación del IronDrawing(IronSoftware.Drawing) El paquete NuGet es rápido y sencillo. Por favor, instale el paquete así:

Install-Package IronSoftware.System.Drawing

También puede descargarse directamente de sitio web oficial de NuGet.

Una vez instalado, puede empezar añadiendo using IronSoftware.Drawing; al principio de su código C#.

Ejemplos de códigos

Ejemplo de AnyBitmap

:path=/static-assets/drawing/content-code-examples/get-started/anybitmap.cs
using IronSoftware.Drawing;
​
// Crear un nuevo objeto AnyBitmap
var bitmap = AnyBitmap.FromFile("FILE_PATH");
bitmap.SaveAs("result.jpg");
​
var bytes = bitmap.ExportBytes();
​
var resultExport = new System.IO.MemoryStream();
bitmap.ExportStream(resultExport, AnyBitmap.ImageFormat.Jpeg, 100);
​
// Casting entre System.Drawing.Bitmap y IronSoftware.Drawing.AnyBitmap
System.Drawing.Bitmap image = new System.Drawing.Bitmap("FILE_PATH");
IronSoftware.Drawing.AnyBitmap anyBitmap = image;
anyBitmap.SaveAs("result-from-casting.png");
Imports IronSoftware.Drawing

' Crear un nuevo objeto AnyBitmap
Private bitmap = AnyBitmap.FromFile("FILE_PATH")
bitmap.SaveAs("result.jpg")

Dim bytes = bitmap.ExportBytes()

Dim resultExport = New System.IO.MemoryStream()
bitmap.ExportStream(resultExport, AnyBitmap.ImageFormat.Jpeg, 100)

' Casting entre System.Drawing.Bitmap y IronSoftware.Drawing.AnyBitmap
Dim image As New System.Drawing.Bitmap("FILE_PATH")
Dim anyBitmap As IronSoftware.Drawing.AnyBitmap = image
anyBitmap.SaveAs("result-from-casting.png")
VB   C#

Ejemplo de color

:path=/static-assets/drawing/content-code-examples/get-started/color.cs
using IronSoftware.Drawing;
​
// Crear un nuevo objeto Color
Color fromHex = new Color("#191919");
Color fromRgb = new Color(255, 255, 0);
Color fromEnum = Color.Crimson;
​
// Conversión entre System.Drawing.Color y IronSoftware.Drawing.Color
System.Drawing.Color drawingColor = System.Drawing.Color.Red;
IronSoftware.Drawing.Color ironColor = drawingColor;
​
ironColor.A;
ironColor.R;
ironColor.G;
ironColor.B;
​
// La luminancia es un valor de 0 (negro) a 100 (blanco), donde 50 es el "gris medio" perceptual.
IronDrawingColor.GetLuminance();
Imports IronSoftware.Drawing

' Crear un nuevo objeto Color
Private fromHex As New Color("#191919")
Private fromRgb As New Color(255, 255, 0)
Private fromEnum As Color = Color.Crimson

' Conversión entre System.Drawing.Color y IronSoftware.Drawing.Color
Private drawingColor As System.Drawing.Color = System.Drawing.Color.Red
Private ironColor As IronSoftware.Drawing.Color = drawingColor

ironColor.A
ironColor.R
ironColor.G
ironColor.B

' La luminancia es un valor de 0 (negro) a 100 (blanco), donde 50 es el "gris medio" perceptual.
IronDrawingColor.GetLuminance()
VB   C#

Ejemplo de rectángulo

:path=/static-assets/drawing/content-code-examples/get-started/rectangle.cs
using IronSoftware.Drawing;
​
// Crear un nuevo objeto Rectángulo
Rectangle Rectangle = new Rectangle(5, 5, 50, 50);
​
// Conversión entre System.Drawing.Rectangle y IronSoftware.Drawing.Rectangle
System.Drawing.Rectangle rectangle = new System.Drawing.Rectangle(10, 10, 150, 150);
IronSoftware.Drawing.Rectangle ironRectangle = rectangle;
​
ironRectangle.X;
ironRectangle.Y;
ironRectangle.Width;
ironRectangle.Height;
Imports IronSoftware.Drawing

' Crear un nuevo objeto Rectángulo
Private Rectangle As New Rectangle(5, 5, 50, 50)

' Conversión entre System.Drawing.Rectangle y IronSoftware.Drawing.Rectangle
'INSTANT VB NOTE: The field rectangle was renamed since Visual Basic does not allow fields to have the same name as other class members:
Private rectangle_Conflict As New System.Drawing.Rectangle(10, 10, 150, 150)
Private ironRectangle As IronSoftware.Drawing.Rectangle = rectangle_Conflict

ironRectangle.X
ironRectangle.Y
ironRectangle.Width
ironRectangle.Height
VB   C#

Ejemplo de fuente

:path=/static-assets/drawing/content-code-examples/get-started/font.cs
using IronSoftware.Drawing;
​
// Crear un nuevo objeto Fuente
Font font = new Font("Times New Roman", FontStyle.Italic | FontStyle.Bold, 30);
​
// Conversión entre System.Drawing.Font y IronSoftware.Drawing.Font
System.Drawing.Font drawingFont = new System.Drawing.Font("Courier New", 30);
IronSoftware.Drawing.Font ironFont = drawingFont;
​
ironFont.FamilyName;
ironFont.Style;
ironFont.Size;
ironFont.Italic;
ironFont.Bold;
Imports IronSoftware.Drawing

' Crear un nuevo objeto Fuente
Private font As New Font("Times New Roman", FontStyle.Italic Or FontStyle.Bold, 30)

' Conversión entre System.Drawing.Font y IronSoftware.Drawing.Font
Private drawingFont As New System.Drawing.Font("Courier New", 30)
Private ironFont As IronSoftware.Drawing.Font = drawingFont

ironFont.FamilyName
ironFont.Style
ironFont.Size
ironFont.Italic
ironFont.Bold
VB   C#

Asistencia disponible

Licencia

La información sobre licencias puede consultarse aquí:LICENCIA.txt

Contribuir

Si desea contribuir al proyecto de código abierto IronDrawing, lea el documento licencia antes de hacer una petición de pull al en GitHub.

Información

Para más información sobre Iron Software, visite nuestro sitio web: https://ironsoftware.com/

Asistencia de Iron Software

Para asistencia general y consultas técnicas, envíenos un correo electrónico a: mailto:support@ironsoftware.com