2024-02-11碼農

點亮.NET的文字雲藝術之光——Sdcb.WordCloud 2.0

作為一名.NET開發者，你是否渴望擁有一個強大且易用的庫，用以在你的應用程式中創造美輪美奐的文字雲？我在經過一輪農歷新年前的碼力全開後，非常自豪地向大家宣布，我的個人計畫—Sdcb.WordCloud 2.0，現已推出！相比於上一個版本（1.2），這個全新的版本在效能上更進一步，利用指標操作等技術進行了深度最佳化，大幅提升了文字雲生成的速度。且支持跨平台、生成多種格式輸出。現在，我們賦予文字以自由，讓它們在虛擬的空間中起舞。

版本 2.0 的全新提升

跨平台相容性 ：在不同作業系統上工作，無需依賴於 System . Drawing 。

多種輸出格式 ：支持生成圖片、SVG或JSON數據的文字雲。

靈活配置 ：透過各種選項自訂您的文字雲，包括文本方向、字型和遮罩。

開源：在MIT授權下自由提供，歡迎貢獻和修改。

在Sdcb.WordCloud 2.0中，我註重效能的同時，也保持了對創造力的尊重。利用.NET的強大功能，特別是指標操作的精細最佳化，這個版本的文字雲生成不僅更加迅速，更在視覺效果上帶來了更為豐富的展現。以下是基於Sdcb.WordCloud 2.0，你可以輕松實作的一些很酷的功能。

不同文本方向的文字雲

要實作不同方向排列的文字雲，你可以透過調整 TextOrientation 選項來輕松實作。以下展示了如何用一段簡潔的程式碼建立五種文本方向的文字雲：

TextOrientations[] orientations =
[
TextOrientations.PreferHorizontal,// 預設
TextOrientations.PreferVertical,
TextOrientations.HorizontalOnly,
TextOrientations.VerticalOnly,
TextOrientations.Random,
];
foreach(var o in orientations)
{
WordCloud wc =WordCloud.Create(newWordCloudOptions(600,600,MakeDemoScore())
{
TextOrientation= o,
});
byte[] pngBytes = wc.ToSKBitmap().Encode(SKEncodedImageFormat.Png,100).AsSpan().ToArray();
File.WriteAllBytes($"{o}.png", pngBytes);
}

這樣你就能得到下面這些充滿藝術感的文字雲，每一張都展示了文字的不同排列方向。

文字雲轉換為JSON，並進行反轉操作

使用Sdcb.WordCloud，可以很靈活地操作文字雲的數據，甚至可以將其轉換為JSON格式，方便儲存和交換：

WordCloud wc =WordCloud.Create(newWordCloudOptions(900,900,MakeDemoScore())
{
FontManager=newFontManager([SKTypeface.FromFamilyName("Times New Roman")]),
Mask=MaskOptions.CreateWithForegroundColor(SKBitmap.Decode(newHttpClient().GetByteArrayAsync("https://io.starworks.cc:88/cv-public/2024/alice_mask.png").GetAwaiter().GetResult()),SKColors.White)
});
string json = wc.ToJson();
Console.WriteLine(json);
// 可以從JSON再轉換回來
WordCloud wc2 =WordCloud.FromJson(json);
File.WriteAllText($"reconstructed.svg", wc2.ToSvg());

透過這種方式，你可以靈活地將文字雲存為JSON，並在需要的時候重建它。

套用遮罩的文字雲

想要讓文字雲填充特定形狀？使用遮罩，你可以輕易做到：

WordCloud wc =WordCloud.Create(newWordCloudOptions(900,900,MakeDemoScore())
{
FontManager=newFontManager([SKTypeface.FromFamilyName("Times New Roman")]),
Mask=MaskOptions.CreateWithForegroundColor(SKBitmap.Decode(newHttpClient().GetByteArrayAsync("https://io.starworks.cc:88/cv-public/2024/alice_mask.png").GetAwaiter().GetResult()),SKColors.White)
});
byte[] pngBytes = wc.ToSKBitmap().Encode(SKEncodedImageFormat.Png,100).AsSpan().ToArray();
File.WriteAllBytes($"mask.png", pngBytes);

這樣，單詞將被巧妙地分布在指定的形狀中，就像這個範例中的Alice蒙面形象。

使用特定字型的文字雲

透過指定字型，你可以制作出符合品牌形象或主題風格的文字雲：

WordCloud wc =WordCloud.Create(newWordCloudOptions(600,600,MakeDemoScore())
{
FontManager=newFontManager([SKTypeface.FromFamilyName("Consolas")])
});
byte[] pngBytes = wc.ToSKBitmap().Encode(SKEncodedImageFormat.Png,100).AsSpan().ToArray();
File.WriteAllBytes($"specified-font.png", pngBytes);