在服务器上渲染 Adobe Illustrator (AI) 艺术作品比看起来更困难，且 Type 1 基于函数的着色 是让许多渲染器卡住的特性之一。如果你的流水线需要从 AI 文件生成缩略图、网页预览或打印校样，你需要正确绘制该着色，而不是被平面填充所取代。Aspose.PSD for .NET 让你只需几行 C# 代码且无需安装 Adobe Illustrator，即可将包含 Type 1 着色的 AI 文件转换为 PNG。本教程将带你完成 SDK 的安装、加载 AI 文件、配置 PngOptions、导出多页文档以及在生产环境中处理错误。

为什么将 AI Type 1 Shading 转换为 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 类型 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 阴影是文档内容的一部分，在保存时由渲染器处理。

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 阴影转换为 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 或外部工具。通过逐页导出、安全的类型检查以及明确的错误处理，同一段代码即可从单个预览扩展到高并发、服务器端的批量转换流水线。

FAQs

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. 哪些 .NET 版本受 Aspose.PSD for .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（最大压缩，文件最小）之间的值。压缩在每个级别都是无损的，因此仅影响文件大小和编码时间。

阅读更多