在 .NET 中取代 System.Drawing.Common 的 C# 點陣圖程式庫

Curtis Chau
Curtis Chau
已更新: 2026年8月2日

IronDrawing 是免費的開源軟體,並支援大多數 .NET 圖形庫格式

IronDrawing 是由 Iron Software 開發的開源程式庫,協助 C# 軟體工程師在 Windows、macOS 和 Linux 平台上的 .NET 專案中取代 System.Drawing.Common。

為 .NET 5、6、7 和 8 開發支援圖形、圖像和字體的類別庫和 NuGet 套件_應該_很容易。

IronDrawing 充當了所有新提出的 .NET 5、6、7 和 8 圖形標準之間的無縫橋樑,隨著這些標準的演變,您只需針對您喜歡的標準進行開發即可。

IronDrawing 是免費的開源軟體,並支援大多數 .NET 圖形庫格式。

情境

Microsoft .NET 是一個跨平台、高度相容的軟體框架,被全球數百萬軟體開發人員使用。 微軟已宣布一個重大變更,即 System.Drawing.Common 將只支持 Windows 平台。

對於那些維護跨平台程式庫並使用 System.Drawing.Common 的 .NET 程式庫開發者來說,這是一個問題,因為微軟的建議行動要求您重建您的程式庫以支持非 Windows 用戶。 志工和學者需要重新建構每個 NuGet 套件和類別庫,以便使用每個新建議的圖形庫,這將造成技術債務,從而減緩現代 .NET 的普及。

最終,當我們使用 .NET 時,我們會使用 NuGet。

NuGet 套件開發者們正在為我們所有人做一件好事,他們推進了 .NET 的發展,並提供了預先包裝程式碼,這些程式碼如果我們自己編寫,每天都需要花費數千小時。

這項重大變更將減緩 NuGet 的開發速度,並可能導致 .NET 開發人員所依賴的程式碼庫被棄用或過時。 我們必須立即行動!

我們的解決方案

一種用於在所有新舊圖形庫之間進行轉換的中間圖形格式。

作為類別程式庫開發者,您的公共 Bitmap、Color、Rectangle、Font 和 Size 輸入和輸出只能是一種支持所有新標準的類型。 在內部,你可以繼續做你喜歡的事。

IronDrawing 向後相容於 .NET Framework 4.62,支援所有版本的 .NET(包括 .NET 8)。

IronDrawing 的開發和發佈解決了這個問題,提供了一個開源解決方案,以彌補對 Bitmap、Color、Rectangle、Font 和 Size 等重要類別缺乏統一格式的情況。 IronSoftware.Drawing 將為您無縫轉換在 System.Drawing、Microsoft.Maui、SkiaSharp 和 SixLabors 中這些類型的實現。 這樣一來,開發者就不必替換庫中所有此類實例了。

例如,如果 您正在使用 System.Drawing.Bitmap,您可以使用 IronDrawing 的 AnyBitmap 類別,該類別可以隱式轉換為以下任一類型:System.Drawing.Bitmap、System.Drawing.Image、SkiaSharp.SKBitmap、SkiaSharp.SKImage、SixLabors.ImageSharp、Microsoft.Maui.Graphics.Platform.PlatformImage。

我們為什麼要免費做這件事

我們開發 IronDrawing 的原因是,Iron Software 的全體成員都是經驗豐富的 .NET 開發人員,我們關心 .NET 的發展,並希望它能夠成長和成功。 我們很高興看到 .NET 不斷發展壯大,例如 .NET 7。我們每天都在使用 NuGet,我相信你們也是。 我們支持並希望促使從 System.Drawing 向未來的輕鬆過渡。

我們希望所有 .NET 類別程式庫和 NuGet 開發都能變得更輕鬆,從而使 NuGet 生態系統繼續蓬勃發展,並使所有 .NET 開發人員受益。

IronSoftware.Drawing 特點

  • AnyBitmap:一個通用相容的 Bitmap 類別。 在 IronSoftware.Drawing.AnyBitmap 與下列支持之間的隱式轉換:
    • System.Drawing.Bitmap
    • System.Drawing.Image
    • SkiaSharp.SKBitmap
    • SkiaSharp.SKImage
    • SixLabors.ImageSharp
    • Microsoft.Maui.Graphics.Platform.PlatformImage
  • 顏色:一個通用相容的顏色類別。 在 IronSoftware.Drawing.Color 與下列支持之間的隱式轉換:
    • System.Drawing.Color
    • SkiaSharp.SKColor
    • SixLabors.ImageSharp.Color
    • SixLabors.ImageSharp.PixelFormats
  • Rectangle:一個通用相容的矩形類別。 在 IronSoftware.Drawing.Rectangle 與下列支持之間的隱式轉換:
    • System.Drawing.Rectangle
    • SkiaSharp.SKRect
    • SkiaSharp.SKRectI
    • SixLabors.ImageSharp.Rectangle
  • 字型:一個通用相容的字型類別。 在 IronSoftware.Drawing.Font 與下列支持之間的隱式轉換:
    • System.Drawing.Font
    • SkiaSharp.SKFont
    • SixLabors.Fonts.Font

相容性

IronSoftware.Drawing 具有跨平台支持相容性:

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

安裝

安裝 IronDrawing (IronSoftware.Drawing) NuGet 套件既快速又簡單。 請如下安裝軟體包:

PM > Install-Package IronSoftware.System.Drawing

或者,可以直接從官方 NuGet 網站下載。

安裝後,您可以通過在您的 C# 程式碼頂部添加 using IronSoftware.Drawing; 來開始。

程式碼範例

AnyBitmap 範例

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");

顏色範例

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}");

矩形範例

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);

字體範例

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}");
}

可提供的支援

授權

授權資訊可以在此找到:LICENSE.txt

貢獻

如果您想為 IronDrawing 開源專案做出貢獻,請在向GitHub 上的倉庫提交 pull-request 之前閱讀授權。

資訊

有關 Iron Software 的更多資訊,請造訪我們的網站:https://ironsoftware.com/

Iron Software 提供的支援

如需一般支援和技術詢問,請通過電子郵件與我們聯繫:support@ironsoftware.com

Curtis Chau 擁有卡爾頓大學計算機科學學士學位,專注於前端開發,擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面,喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

閱讀更多

準備好開始了嗎?

NuGet 下載次數 21,851,269版本:2026.11剛剛發布