1. IronDrawing
  2. 入门

在.NET中替换 "System.Drawing.Common "的 C# 位图库

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

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 绘图库格式。

避免 system.drawing.common 在此平台上不支持异常的技术步骤

  1. 实施 System.drawing.common 无法在 Linux 和 MacOs 平台上运行 .NET6 和 .NET 7 & 8
  2. 在这些平台上使用 System.Drawing.Common 会出现异常信息
  3. 设置 System.Drawing.EnableUnixSupport 运行时配置为 真 适用于 .NET6
  4. 在 .NET 7 和 8 中不再支持 System.Drawing.Common
  5. 使用开源图书馆 IronSoftware.Drawing 以取代 System.Drawing.Common 适用于 .NET7

上下文

Microsoft .NET 是一个多平台、高兼容性的软件框架，被全球数百万软件开发者使用。 Microsoft 已经宣布一个重大变更，其中System.Drawing.Common只会在Windows平台上得到支持。

这对于维护使用System.Drawing.Common的跨平台库的.NET库开发者来说是有问题的，因为Microsoft的建议采取的行动需要您重新构建库以支持非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`。

为什么我们免费做这个

我们在Iron Software开发了IronDrawing，因为我们是长期的高级.NET开发者，关心.NET的发展，并希望它能够成长并取得成功。 我们很高兴看到 .NET 在不断成长和发展，正如 .NET 7 所展示的。 我们整天都在使用 NuGet，我相信你也是如此。 我们支持并希望促进向未来的过渡，并远离System.Drawing。

我们希望所有的 .NET 类库和 NuGet 开发都能变得更加容易，以便 NuGet 生态系统继续繁荣发展，使所有 .NET 开发者受益。

IronSoftware.Drawing 功能

  • AnyBitmap：一个通用兼容的位图类。 隐式转换支持 IronSoftware.Drawing.AnyBitmap 和以下类型：
    • 系统.绘图.位图
    • 系统.绘图.图像 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 包安装快速且简便。 请按照以下方式安装包：

Install-Package IronSoftware.System.Drawing

或者直接从NuGet 官方网站.

安装后，您可以通过在 C# 代码顶部添加 using IronSoftware.Drawing; 来开始使用。

​

代码示例

AnyBitmap 示例

:path=/static-assets/drawing/content-code-examples/get-started/anybitmap.cs
using IronSoftware.Drawing;
​
// Create a new AnyBitmap object
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 between System.Drawing.Bitmap and 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

' Create a new AnyBitmap object
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 between System.Drawing.Bitmap and 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#

颜色示例

:path=/static-assets/drawing/content-code-examples/get-started/color.cs
using IronSoftware.Drawing;
​
// Create a new Color object
Color fromHex = new Color("#191919");
Color fromRgb = new Color(255, 255, 0);
Color fromEnum = Color.Crimson;
​
// Casting between System.Drawing.Color and IronSoftware.Drawing.Color
System.Drawing.Color drawingColor = System.Drawing.Color.Red;
IronSoftware.Drawing.Color ironColor = drawingColor;
​
ironColor.A;
ironColor.R;
ironColor.G;
ironColor.B;
​
// Luminance is a value from 0 (black) to 100 (white) where 50 is the perceptual "middle grey"
IronDrawingColor.GetLuminance();
Imports IronSoftware.Drawing

' Create a new Color object
Private fromHex As New Color("#191919")
Private fromRgb As New Color(255, 255, 0)
Private fromEnum As Color = Color.Crimson

' Casting between System.Drawing.Color and 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

' Luminance is a value from 0 (black) to 100 (white) where 50 is the perceptual "middle grey"
IronDrawingColor.GetLuminance()
VB   C#

矩形示例

:path=/static-assets/drawing/content-code-examples/get-started/rectangle.cs
using IronSoftware.Drawing;
​
// Create a new Rectangle object
Rectangle Rectangle = new Rectangle(5, 5, 50, 50);
​
// Casting between System.Drawing.Rectangle and 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

' Create a new Rectangle object
Private Rectangle As New Rectangle(5, 5, 50, 50)

' Casting between System.Drawing.Rectangle and 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#

字体示例

:path=/static-assets/drawing/content-code-examples/get-started/font.cs
using IronSoftware.Drawing;
​
// Create a new Font object
Font font = new Font("Times New Roman", FontStyle.Italic | FontStyle.Bold, 30);
​
// Casting between System.Drawing.Font and 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

' Create a new Font object
Private font As New Font("Times New Roman", FontStyle.Italic Or FontStyle.Bold, 30)

' Casting between System.Drawing.Font and 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#

可提供的支持

许可证

许可信息可以在这里找到：LICENSE.txt

贡献

如果您想为IronDrawing开源项目做出贡献，请阅读许可证在向仓库.

信息

有关Iron Software的更多信息，请访问我们的网站：https://ironsoftware.com/

Iron Software的支持

有关一般支持和技术查询，请通过以下电子邮件与我们联系：mailto:support@ironsoftware.com