C# Bitmap Library to Replace System.Drawing.Common in .NET

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronDrawing est gratuit, open-source et prend en charge la plupart des formats de bibliothèque de dessin .NET

IronDrawing est une bibliothèque open-source initialement développée par Iron Software qui aide les ingénieurs logiciels C# à remplacer System.Drawing.Common dans les projets .NET sur les plateformes Windows, macOS et Linux.

Développer des bibliothèques de classes et des packages NuGet for .NET 5, 6, 7 et 8 prenant en charge les graphiques, les images et les polices devrait être facile.

IronDrawing sert de pont transparent entre toutes les nouvelles normes graphiques .NET 5, 6, 7 et 8 proposées à mesure qu'elles évoluent ; vous n'avez donc besoin de développer que pour celle que vous préférez .

IronDrawing est gratuit, open-source et prend en charge la plupart des formats de bibliothèque de dessin .NET

Contexte

Microsoft .NET est un framework logiciel multiplateforme et hautement compatible, utilisé par des millions de développeurs de logiciels à travers le monde. Microsoft a annoncé un changement majeur selon lequel System.Drawing.Common ne sera pris en charge que sur les plateformes Windows.

Cela pose problème aux développeurs de bibliothèques .NET qui maintiennent des bibliothèques multiplateformes utilisant System.Drawing.Common car l'action recommandée par Microsoft vous oblige à reconstruire votre bibliothèque pour prendre en charge les utilisateurs non-Windows. Les bénévoles et les universitaires devront reconstruire chaque package NuGet et chaque bibliothèque de classes pour utiliser chacune des nouvelles bibliothèques graphiques suggérées au fur et à mesure de leur apparition, ce qui engendrera une dette technique qui ralentira l'adoption du .NET moderne.

Finalement, lorsque nous utilisons .NET, nous utilisons NuGet.

Les développeurs de packages NuGet nous rendent tous service en faisant progresser .NET et le code pré-packagé qui nous prendrait des milliers d'heures à écrire nous-mêmes chaque jour.

Cette modification majeure ralentira le développement de NuGet et pourrait entraîner l'abandon ou l'obsolescence de bibliothèques de code dont dépendent les développeurs .NET. Nous devons agir maintenant !

Notre solution

Un format graphique intermédiaire qui assure la conversion entre toutes les anciennes et les nouvelles bibliothèques graphiques.

En tant que développeur de bibliothèque de classes, vos entrées et sorties publiques Bitmap, Color, Rectangle, Font et Size ne peuvent être que d'un seul type prenant en charge toutes les nouvelles normes. En interne, vous pouvez continuer à faire ce que vous voulez.

IronDrawing est rétrocompatible avec .NET Framework 4.62 et prend en charge toutes les versions de .NET (y compris .NET 8).

Le développement et la publication d'IronDrawing résolvent ce problème en fournissant une solution open-source au manque de format uniforme pour des classes importantes telles que Bitmap, Color, Rectangle, Font et Size. IronSoftware.Drawing convertira de manière transparente entre les implémentations de ces types dans System.Drawing, Microsoft.Maui, SkiaSharp et SixLabors pour vous. Cela vous permet, en tant que développeur, de ne pas avoir à remplacer toutes les instances de ces classes dans votre bibliothèque.

Par exemple , si vous utilisez System.Drawing.Bitmap, vous pouvez utiliser la classe AnyBitmap d'IronDrawing qui a des conversions implicites vers n'importe lequel de ces types : System.Drawing.Bitmap, System.Drawing.Image, SkiaSharp.SKBitmap, SkiaSharp.SKImage, SixLabors.ImageSharp, Microsoft.Maui.Graphics.Platform.PlatformImage.

Pourquoi faisons-nous cela gratuitement ?

Nous avons développé IronDrawing parce que chez Iron Software, nous sommes des développeurs .NET seniors de longue date qui nous soucions de l'évolution de .NET et souhaitons sa croissance et son succès. Nous sommes ravis de constater la croissance et l'évolution de .NET, comme en témoigne .NET 7. Nous utilisons NuGet quotidiennement, et je suis sûr que vous aussi. Nous soutenons et espérons encourager une transition facile vers l'avenir et loin de System.Drawing.

Nous souhaitons simplifier le développement de toutes les bibliothèques de classes .NET et de NuGet, afin que l'écosystème NuGet continue de prospérer et que tous les développeurs .NET en bénéficient.

IronSoftware.Drawing Fonctionnalités

  • AnyBitmap : Une classe Bitmap universellement compatible. Conversion implicite entre IronSoftware.Drawing.AnyBitmap et les éléments suivants prise en charge :
    • System.Drawing.Bitmap
    • System.Drawing.Image
    • SkiaSharp.SKBitmap
    • SkiaSharp.SKImage
    • SixLabors.ImageSharp
    • Microsoft.Maui.Graphics.Platform.PlatformImage
  • Couleur : Une classe de couleurs universellement compatible. La conversion implicite entre IronSoftware.Drawing.Color et les éléments suivants est prise en charge :
    • System.Drawing.Color
    • SkiaSharp.SKColor
    • SixLabors.ImageSharp.Color
    • SixLabors.ImageSharp.PixelFormats
  • Rectangle : Une classe Rectangle universellement compatible. La conversion implicite entre IronSoftware.Drawing.Rectangle et les éléments suivants est prise en charge :
    • System.Drawing.Rectangle
    • SkiaSharp.SKRect
    • SkiaSharp.SKRectI
    • SixLabors.ImageSharp.Rectangle
  • Police : Une classe de police universellement compatible. La conversion implicite entre IronSoftware.Drawing.Font et les éléments suivants est prise en charge :
    • System.Drawing.Font
    • SkiaSharp.SKFont
    • SixLabors.Fonts.Font

Compatibilité

IronSoftware.Drawing est compatible avec plusieurs plateformes :

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

Installation

L'installation du package NuGet IronDrawing (IronSoftware.Drawing) est rapide et facile. Veuillez installer le paquet comme ceci :

Install-Package IronSoftware.System.Drawing

Vous pouvez également télécharger directement depuis le site Web officiel de NuGet .

Une fois installé, vous pouvez commencer en ajoutant using IronSoftware.Drawing; en haut de votre code C#.

Exemples de code

Exemple AnyBitmap

:path=/static-assets/drawing/content-code-examples/get-started/anybitmap.cs
using IronSoftware.Drawing;
using System.IO;
using System.Drawing;

// Create a new AnyBitmap object from a file
// Replace "FILE_PATH" with the actual path of the image you want to process
var bitmap = AnyBitmap.FromFile("FILE_PATH");

// Save the AnyBitmap object as a JPEG file
bitmap.SaveAs("result.jpg");

// Export the AnyBitmap as a byte array
// This can be useful if you want to send the image data over a network or save it in a database
var bytes = bitmap.ExportBytes();

// Create a memory stream to export the AnyBitmap as a JPEG stream with 100% quality
using (var resultExport = new MemoryStream())
{
    // This exports the image to the stream with the specified format and quality
    bitmap.ExportStream(resultExport, AnyBitmap.ImageFormat.Jpeg, 100);
    // Be sure to use 'using' or manually close the stream to release resources
}

// Casting between System.Drawing.Bitmap and IronSoftware.Drawing.AnyBitmap
// Load a System.Drawing.Bitmap from the same file
System.Drawing.Bitmap image = new System.Drawing.Bitmap("FILE_PATH");

// This is an implicit conversion from System.Drawing.Bitmap to IronSoftware.Drawing.AnyBitmap
// This step is necessary if you are working with System.Drawing.Bitmap and need to convert to IronSoftware.Drawing.AnyBitmap for processing
IronSoftware.Drawing.AnyBitmap anyBitmap = AnyBitmap.FromBitmap(image);

// Save the resulting AnyBitmap from casting as a PNG file
anyBitmap.SaveAs("result-from-casting.png");
$vbLabelText   $csharpLabel

Exemple de couleur

:path=/static-assets/drawing/content-code-examples/get-started/color.cs
using IronSoftware.Drawing;
using System;

// The IronSoftware.Drawing library provides enhanced color manipulation features.
// This example demonstrates creating color objects and converting between
// System.Drawing.Color and IronSoftware.Drawing.Color.

// Create a new Color object from a hex string.
Color fromHex = Color.FromHex("#191919");

// Create a new Color object from RGB values.
Color fromRgb = Color.FromRgb(255, 255, 0);

// Create a new Color object using an enumeration.
Color fromEnum = Color.Crimson;

// Casting between System.Drawing.Color and IronSoftware.Drawing.Color.
System.Drawing.Color drawingColor = System.Drawing.Color.Red;

// Convert System.Drawing.Color to IronSoftware.Drawing.Color.
IronSoftware.Drawing.Color ironColor = Color.FromSystemColor(drawingColor);

// Access the alpha, red, green, and blue components of the IronSoftware.Drawing.Color.
byte alpha = ironColor.A;
byte red = ironColor.R;
byte green = ironColor.G;
byte blue = ironColor.B;

// Calculate the luminance of the color.
// Luminance is a value from 0 (black) to 100 (white) where 50 is the perceptual "middle grey".
double luminance = ironColor.GetLuminance();

// Log the calculated attributes to the console.
Console.WriteLine($"Color Details - ARGB: ({alpha}, {red}, {green}, {blue}), Luminance: {luminance}");
$vbLabelText   $csharpLabel

Exemple de rectangle

:path=/static-assets/drawing/content-code-examples/get-started/rectangle.cs
using IronSoftware.Drawing;
using System.Drawing;

// Declare an IronSoftware.Drawing.Rectangle object
IronSoftware.Drawing.Rectangle ironRectangle = new IronSoftware.Drawing.Rectangle(5, 5, 50, 50);

// Declare a System.Drawing.Rectangle object
System.Drawing.Rectangle systemRectangle = new System.Drawing.Rectangle(10, 10, 150, 150);

// Implicitly convert System.Drawing.Rectangle to IronSoftware.Drawing.Rectangle
// Note: Uncomment and use appropriate conversion methods if available in the IronSoftware.Drawing library
// ironRectangle = (IronSoftware.Drawing.Rectangle)systemRectangle;

// Output the properties of IronSoftware.Drawing.Rectangle if conversion is successful
// These Console.WriteLine statements assume this code runs in a console environment
Console.WriteLine(ironRectangle.X);
Console.WriteLine(ironRectangle.Y);
Console.WriteLine(ironRectangle.Width);
Console.WriteLine(ironRectangle.Height);
$vbLabelText   $csharpLabel

Exemple de police

:path=/static-assets/drawing/content-code-examples/get-started/font.cs
using System;
using System.Drawing;
using IronSoftware.Drawing;

// Create a new Font object with a specified font family, style, and size
IronSoftware.Drawing.Font font = new IronSoftware.Drawing.Font("Times New Roman", FontStyle.Italic | FontStyle.Bold, 30);

// Create a new instance of System.Drawing.Font
System.Drawing.Font drawingFont = new System.Drawing.Font("Courier New", 30);

try
{
    // Attempt to cast System.Drawing.Font to IronSoftware.Drawing.Font
    // Note: This cast may not be directly possible if the libraries do not support each other;
    // additional conversion logic might be required.
    IronSoftware.Drawing.Font ironFont = new IronSoftware.Drawing.Font(drawingFont.FontFamily.Name, drawingFont.Style, drawingFont.Size);

    // Accessing properties of the IronSoftware.Drawing.Font object
    string familyName = ironFont.FamilyName; // Get the font family name
    FontStyle style = ironFont.Style;       // Get the combined font style (italic, bold, etc.)
    float size = ironFont.Size;             // Get the font size
    bool isItalic = ironFont.Italic;        // Determine if the font style includes Italic
    bool isBold = ironFont.Bold;            // Determine if the font style includes Bold

    // Output the font properties to verify correctness
    Console.WriteLine($"Family: {familyName}, Style: {style}, Size: {size}, Italic: {isItalic}, Bold: {isBold}");
}
catch (InvalidCastException)
{
    Console.WriteLine("The conversion between System.Drawing.Font and IronSoftware.Drawing.Font is not directly supported.");
}
catch (Exception ex)
{
    Console.WriteLine($"An error occurred: {ex.Message}");
}
$vbLabelText   $csharpLabel

Assistance disponible

Licence

Les informations relatives à la licence se trouvent ici : LICENSE.txt

Contribuer

Si vous souhaitez contribuer au projet open-source IronDrawing, veuillez lire la licence avant de soumettre une demande de fusion au dépôt sur GitHub .

Information

Pour plus d'informations sur Iron Software, veuillez consulter notre site web :https://ironsoftware.com/

Assistance d'Iron Software

Pour toute assistance générale et questions techniques, veuillez nous contacter par e-mail à l'adresse suivante :mailto:support@ironsoftware.com

Curtis Chau
Rédacteur technique

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes ...

Lire la suite
Prêt à commencer?
Nuget Téléchargements 15,421,227 | Version : 2025.3 vient de sortir
Still Scrolling Icon

Vous faites encore défiler ?

Vous voulez une preuve rapidement ? PM > Install-Package IronSoftware.System.Drawing
exécuter un échantillon Regardez votre code HTML se transformer en PDF.