在伺服器上渲染 Adobe Illustrator (AI) 藝術作品比看起來更困難，且 Type 1 基於函數的陰影 是讓許多渲染器卡住的特性之一。如果您的工作流程需要從 AI 檔案產生縮圖、網頁預覽或列印樣張，您必須正確繪製該陰影，而不是被平面填色取代。Aspose.PSD for .NET 讓您只需幾行 C# 程式碼且無需安裝 Adobe Illustrator，即可將包含 Type 1 陰影的 AI 檔案轉換為 PNG。本教學將帶您完成 SDK 的安裝、載入 AI 檔案、設定 PngOptions、匯出多頁文件，以及在生產環境中處理錯誤。

為什麼將 AI Type 1 陰影轉換為 PNG

現代 AI 檔案將其藝術作品存儲在 PDF 相容的結構中，PDF 定義了多種漸層類型以實現平滑的顏色過渡。類型 2（軸向）和類型 3（徑向）漸層描述線性和圓形漸層。類型 1 漸層是基於函數的：每個點的顏色是根據其 x 和 y 坐標的數學函數計算的。這使其非常靈活，但也意味著渲染器必須在整個著色區域內評估該函數。

當渲染器未實作基於函式的陰影時，陰影區域通常會被跳過或以單一顏色繪製，導致匯出的影像不再符合原始設計。Aspose.PSD for .NET 在渲染過程中會在內部評估 Type 1 陰影，因此您儲存的 PNG 能忠實呈現設計稿的藝術作品。

有了此功能，.NET 開發人員可以：

  • 為數位資產管理 (DAM) 系統產生精確的縮圖和預覽。
  • 在無法顯示 AI 檔案的網站和應用程式上發布 Illustrator 藝術作品的 PNG 版本。
  • 建立在 Windows、Linux 或容器中執行的自動化伺服器端批次轉換管線。

使用 Aspose.PSD 轉換 AI Type 1 陰影

Aspose.PSD for .NET 是一個 C# 函式庫，用於建立、編輯和轉換 Photoshop (PSD、PSB) 檔案，以及載入和匯出 Adobe Illustrator (AI) 檔案。它可在沒有 Adobe Photoshop 或 Illustrator 的情況下運行，並以 NuGet 套件形式發佈。

本教程中使用的類別有：

  • Image (namespace Aspose.PSD): 載入任何受支援檔案的入口點，透過 Image.Load。
  • AiImage (namespace Aspose.PSD.FileFormats.Ai): 代表已載入的 Illustrator 文件，並公開如 PageCount 與 ActivePageIndex 等成員。
  • PngOptions (namespace Aspose.PSD.ImageOptions): 控制 PNG 匯出設定，例如 ColorType 與 CompressionLevel。
  • PngColorType (namespace Aspose.PSD.FileFormats.Png): 選擇 PNG 像素格式。

安裝

從套件管理員主控台安裝套件：

Install-Package Aspose.PSD

或者使用 .NET CLI：

dotnet add package Aspose.PSD

您可以在 Aspose.PSD for .NET 產品頁面、開發者文件 和 API 參考 中了解更多。

1. 設定您的 .NET 專案

建立一個控制台應用程式來承載轉換程式碼。以下範例使用頂層語句和 C# 9 模式匹配，因此目標為 .NET 6 或更高版本。

  1. 從命令列或 Visual Studio 建立新專案：
dotnet new console -n AiShadingConversion
cd AiShadingConversion
  1. 使用上面顯示的其中一個安裝指令，新增 Aspose.PSD for .NET 套件。
  2. 開啟 Program.cs，並在檔案頂部加入所需的 using 指令：
using System;
using System.IO;
using Aspose.PSD;
using Aspose.PSD.CoreExceptions;
using Aspose.PSD.FileFormats.Ai;
using Aspose.PSD.FileFormats.Png;
using Aspose.PSD.ImageOptions;

Aspose.PSD 提供 Image 類別，Aspose.PSD.FileFormats.Ai 包含 AiImage。PngOptions 位於 Aspose.PSD.ImageOptions，而 Aspose.PSD.FileFormats.Png 提供 PngColorType 列舉。Aspose.PSD.CoreExceptions 包含 ImageLoadException，您將用於錯誤處理。

2. 載入包含 Type 1 陰影的 AI 檔案

Image.Load 會自動偵測檔案格式。當來源是 Illustrator 文件時，返回的物件是 AiImage。使用模式匹配檢查類型比直接轉型更安全，因為直接轉型如果有人傳入 PSD 或其他支援的格式，會拋出 InvalidCastException。

程式碼的功能：

  • 建立指向來源 AI 檔案的完整路徑。
  • 使用 Image.Load 載入檔案。
  • 確認結果為 AiImage，並列印其尺寸與頁數。
string baseFolder = @"C:\Images";
string sourceFile = Path.Combine(baseFolder, "shadingType1.ai");

using (Image image = Image.Load(sourceFile))
{
    if (image is not AiImage aiImage)
    {
        Console.WriteLine("The source file is not an Adobe Illustrator document.");
        return;
    }

Console.WriteLine($"Loaded AI file: {aiImage.Width} x {aiImage.Height} px, pages: {aiImage.PageCount}");
}

using 區塊會在您完成使用後處置圖像並釋放其資源。無需特定於陰影的設定：Type 1 shading 是文件內容的一部分，並在您儲存時由渲染器處理。

3. 將圖像保存為 PNG

導出為 PNG 只需一次呼叫 Save，該方法接受輸出路徑和 PngOptions 實例。將 ColorType 設為 PngColorType.TruecolorWithAlpha 會寫入 32 位元 RGBA 圖像，從而保留渲染器產生的任何透明度，而 CompressionLevel（0 到 9）則在編碼速度與檔案大小之間取得平衡。

程式碼的功能：

  • 如果輸出資料夾不存在，則建立它。
  • 將 AI 檔案載入為 AiImage。
  • 設定 PngOptions，並將渲染的藝術作品（包括 Type 1 陰影）儲存為 PNG。
string baseFolder = @"C:\Images";
string outputFolder = @"C:\Converted";
string sourceFile = Path.Combine(baseFolder, "shadingType1.ai");
string outputFile = Path.Combine(outputFolder, "shadingType1.png");

Directory.CreateDirectory(outputFolder);

using (var aiImage = (AiImage)Image.Load(sourceFile))
{
    var pngOptions = new PngOptions
    {
        ColorType = PngColorType.TruecolorWithAlpha,
        CompressionLevel = 6 // 0 = store (fastest), 9 = maximum compression
    };

aiImage.Save(outputFile, pngOptions);
    Console.WriteLine($"PNG saved to {outputFile}");
}

在任何圖像檢視器中打開 shadingType1.png，並與原始藝術作品進行比較，以確認陰影區域如預期般呈現。

完整範例：將 AI Type 1 Shading 轉換為 PNG（C#）

以下 Program.cs 將所有內容結合成一個可投入生產的控制台應用程式。它會驗證輸入、匯出多頁 AI 檔案的每一頁，並處理載入錯誤。

using System;
using System.IO;
using Aspose.PSD;
using Aspose.PSD.CoreExceptions;
using Aspose.PSD.FileFormats.Ai;
using Aspose.PSD.FileFormats.Png;
using Aspose.PSD.ImageOptions;

// Optional: apply a license to remove the evaluation watermark.
// var license = new License();
// license.SetLicense("Aspose.PSD.NET.lic");

string sourceFile = @"C:\Images\shadingType1.ai";
string outputFolder = @"C:\Converted";

if (!File.Exists(sourceFile))
{
    Console.WriteLine($"Source file not found: {sourceFile}");
    return;
}

Directory.CreateDirectory(outputFolder);

var pngOptions = new PngOptions
{
    ColorType = PngColorType.TruecolorWithAlpha,
    CompressionLevel = 6
};

try
{
    using (Image image = Image.Load(sourceFile))
    {
        if (image is not AiImage aiImage)
        {
            Console.WriteLine("The source file is not an Adobe Illustrator document.");
            return;
        }

string baseName = Path.GetFileNameWithoutExtension(sourceFile);

// Legacy AI files report PageCount = 0, so treat them as a single page.
        if (aiImage.PageCount <= 1)
        {
            string outputFile = Path.Combine(outputFolder, $"{baseName}.png");
            aiImage.Save(outputFile, pngOptions);
            Console.WriteLine($"Saved {outputFile}");
        }
        else
        {
            for (int i = 0; i < aiImage.PageCount; i++)
            {
                aiImage.ActivePageIndex = i;
                string outputFile = Path.Combine(outputFolder, $"{baseName}_page{i + 1}.png");
                aiImage.Save(outputFile, pngOptions);
                Console.WriteLine($"Saved {outputFile}");
            }
        }
    }
}
catch (ImageLoadException ex)
{
    Console.WriteLine($"Could not load the AI file: {ex.Message}");
}
catch (Exception ex)
{
    Console.WriteLine($"Conversion failed: {ex.Message}");
}

4. 提示、常見陷阱與效能考量

逐頁匯出多頁 AI 檔案

Illustrator 文件可以包含多個頁面（畫板）。AiImage.PageCount 會返回頁面數量，ActivePageIndex 用於選擇 Save 所渲染的頁面。設定索引、保存，然後重複，如完整範例所示。請注意，AiImage.Layers 會返回描述文件結構的 AiLayerSection 物件；它們不是獨立的圖像，因此在需要每個畫板一個 PNG 時，請使用頁面而非圖層。

使用模式匹配而不是盲目轉型

當您能控制輸入時，像 (AiImage)Image.Load(path) 這樣的轉型是可以接受的。在上傳處理程序或批次作業中，建議使用 image is AiImage aiImage，以便在遇到意外格式時能清楚報告，而不是拋出 InvalidCastException。

管理批量轉換中的記憶體

渲染大型或複雜的藝術作品，尤其是使用基於函數的陰影時，會消耗大量 CPU 和記憶體。始終將每個載入的圖像包裹在 using 區塊中，一次處理一個檔案（或以小且受限的平行度處理），並在所有檔案中重複使用單一的 PngOptions 實例。

保留透明度

當 PNG 需要放置在其他內容之上（例如在網頁或設計工具中）時，請使用 PngColorType.TruecolorWithAlpha。如果不需要 alpha 通道，則不含 alpha 的真彩色輸出會產生較小的檔案。

明確處理錯誤

在載入之前檢查輸入檔案是否存在，並捕獲 ImageLoadException（命名空間 Aspose.PSD.CoreExceptions）以處理已損壞或無法解析的檔案。將檔案名稱與例外訊息一起記錄，讓批次中失敗的項目容易重新嘗試。

保持 Aspose.PSD 為最新

AI 渲染隨著每次發行持續穩定提升，包括對陰影、軟遮罩和內嵌圖像的修復。如果檔案的渲染結果與預期不同，請在進一步排除故障之前更新至最新的套件版本。

取得免費授權

如果沒有授權，Aspose.PSD for .NET 會以評估模式運行，並在匯出的圖像上添加水印。請求一個免費臨時授權以測試完整 API 30 天，然後在第一次呼叫 Image.Load 之前套用它。

var license = new License();
license.SetLicense("Aspose.PSD.NET.lic");

免費額外資源

結論

在 C# 中使用 Aspose.PSD for .NET 將帶有 Type 1 基於函數的陰影的 AI 檔案轉換為 PNG 非常簡單。安裝 NuGet 套件，使用 Image.Load 載入檔案，設定 PngOptions，然後呼叫 Save：函式庫在渲染過程中會評估陰影，因此您的 PNG 與原始藝術作品相匹配，無需 Adobe Illustrator 或外部工具。透過逐頁匯出、安全的類型檢查以及明確的錯誤處理，同一段程式碼即可從單一預覽擴展到高容量、伺服器端的轉換管線。

常見問題

1. 我需要許可證才能將 AI Type 1 陰影轉換為 PNG 嗎？ 試用時不需要許可證，但如果沒有許可證，Aspose.PSD 會以評估模式運行，並在輸出中添加水印。您可以申請免費的 30 天臨時許可證，以無限制地進行評估。正式生產環境需要購買許可證。

2. 如何在 C# 中將多頁 AI 檔案轉換為 PNG？ 讀取 AiImage.PageCount 屬性，然後將 ActivePageIndex 設為每個頁面的索引，並使用不同的輸出路徑呼叫 Save。舊版 AI 檔案的 PageCount 會報告為 0，因而將其視為單一頁面。

3. 如果 AI 檔案不包含 Type 1 陰影會發生什麼情況？ 程式碼不會有任何變化。Aspose.PSD 會渲染檔案中包含的所有內容，包括其他漸層類型、路徑和內嵌圖像，並將結果儲存為 PNG。

4. 匯出 AI 為 PNG 時是否會有品質損失？ PNG 是無損格式，因此渲染器產生的像素會在不產生壓縮雜訊的情況下儲存。輸出尺寸遵循已載入的 AiImage 所報告的 Width 和 Height。

5. Aspose.PSD for .NET 支援哪些 .NET 版本？ Aspose.PSD for .NET 同時支援 .NET Framework 與現代 .NET，且自 25.4 版起已提供專門的 .NET 8 與 .NET 9 建置。請檢查 NuGet 上 Aspose.PSD 套件的 Frameworks 分頁，以了解您安裝的版本的確切目標。

6. 我該如何控制 PNG 壓縮等級？ 在呼叫 Save 之前，將 PngOptions.CompressionLevel 設為 0（存儲，最快）到 9（最大壓縮，最小檔案）之間的值。壓縮在每個等級都是無損的，因此僅影響檔案大小和編碼時間。

閱讀更多