Конвертувати AI Type 1 Shading у PNG у C# .NET

Відображення Adobe Illustrator (AI) графіки на сервері складніше, ніж здається, і Type 1 function-based shading є однією з функцій, які збивають з пантелику багато рендерерів. Якщо ваш конвеєр створює мініатюри, веб‑перегляди або друковані проби з AI‑файлів, вам потрібно, щоб це затінення було намальовано правильно, а не замінено плоским заповненням. Aspose.PSD for .NET дозволяє конвертувати AI‑файли, що містять Type 1 shading, у PNG у C# за допомогою кількох рядків коду і без встановлення Adobe Illustrator. У цьому посібнику ми крок за кроком розглянемо встановлення SDK, завантаження AI‑файлу, налаштування PngOptions, експорт багатосторінкових документів та обробку помилок у продакшн‑середовищі.

Навіщо конвертувати затінення типу AI 1 у PNG

Сучасні AI‑файли зберігають свої зображення у структурі, сумісній з PDF, а PDF визначає кілька типів затінення для плавних переходів кольору. Тип 2 (аксіальний) і Тип 3 (радіальний) затінення описують лінійні та кругові градієнти. Тип 1 затінення базується на функції: колір у кожній точці обчислюється математичною функцією її координат x та y. Це робить його дуже гнучким, але також означає, що рендерер повинен оцінювати функцію по всій затіненій області.

Коли рендерер не реалізує функціональне затінення, затінена область зазвичай пропускається або заповнюється одним кольором, і експортоване зображення більше не відповідає оригінальному дизайну. Aspose.PSD for .NET оцінює Type 1 shading внутрішньо під час рендерингу, тому збережений PNG відображає художню роботу так, як вона була спроектована.

Завдяки цій можливості розробники .NET можуть:

• Створюйте точні мініатюри та попередні перегляди для систем управління цифровими активами (DAM).
• Публікуйте PNG‑версії ілюстрацій Illustrator на веб‑сайтах та в додатках, які не можуть відображати файли AI.
• Створюйте автоматизовані серверні пакетні конвертаційні конвеєри, які працюють у 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

2. Додайте пакет Aspose.PSD for .NET, використовуючи одну з наведених вище команд встановлення.
3. Відкрийте 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, який ви будете використовувати для обробки помилок.

Завантажте файл AI, що містить затінення типу 1

Image.Load автоматично визначає формат файлу. Коли джерелом є документ Illustrator, повернутий об’єкт є AiImage. Перевірка типу за допомогою pattern matching безпечніша, ніж пряме приведення типу, оскільки пряме приведення викликає InvalidCastException, якщо хтось передає PSD або інший підтримуваний формат.

Що робить код:

• Створює повний шлях до вихідного 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 звільняє зображення та його ресурси, щойно ви закінчите роботу з ним. Ніяке спеціальне налаштування для затінення не потрібне: затінення типу 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 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.

Керування пам’яттю під час пакетних перетворень

Відтворення великих або складних зображень, особливо з функціональним затіненням, вимагає значних ресурсів процесора та пам’яті. Завжди обгортайте кожне завантажене зображення у блок using, обробляйте файли по одному (або з невеликим, обмеженим ступенем паралелізму) і повторно використовуйте один екземпляр PngOptions для всіх файлів.

Зберегти прозорість

Використовуйте PngColorType.TruecolorWithAlpha, коли PNG буде розміщений над іншим вмістом, наприклад на веб‑сторінці або в інструменті дизайну. Якщо вам не потрібен альфа‑канал, виведення у форматі truecolor без альфи створює менші файли.

Обробляйте помилки явно

Переконайтеся, що вхідний файл існує перед його завантаженням, і перехоплюйте 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");

Безкоштовні додаткові ресурси

• Документація: https://docs.aspose.com/psd/net/
• API довідник: https://reference.aspose.com/psd/net/
• Безкоштовні веб-додатки: https://products.aspose.app/psd/family

Висновок

Конвертування AI‑файлів з функціональним затіненням Type 1 у PNG у C# є простим за допомогою Aspose.PSD for .NET. Встановіть пакет NuGet, завантажте файл за допомогою Image.Load, налаштуйте PngOptions і викличте Save: бібліотека оцінює затінення під час рендерингу, тому ваш PNG відповідає оригінальному зображенню без Adobe Illustrator або зовнішніх інструментів. Завдяки експортованню посторінково, безпечним перевіркам типів і явній обробці помилок, той самий код масштабується від одного попереднього перегляду до високонавантажених серверних конвеєрів конвертації.

Питання та відповіді

1. Чи потрібна ліцензія для конвертації AI Type 1 shading у PNG?
Ліцензія не потрібна для пробного використання, але без неї Aspose.PSD працює в режимі оцінки, який додає водяний знак до вихідного файлу. Ви можете запросити безкоштовну 30‑денну тимчасову ліцензію для оцінки без обмежень. Для використання у продакшн‑середовищі потрібна придбана ліцензія.

2. Як конвертувати багатосторінковий файл AI у PNG у C#? Прочитайте властивість AiImage.PageCount, потім встановіть ActivePageIndex на індекс кожної сторінки та викличте Save з окремим шляхом виводу. Старі файли AI повідомляють PageCount рівний 0, тому розглядайте їх як односторінкові.

3. Що станеться, якщо файл AI не містить затінення типу 1?
Нічого не змінюється у вашому коді. Aspose.PSD відображає все, що містить файл, включаючи інші типи градієнтів, шляхи та вбудовані зображення, і зберігає результат у PNG.

4. Чи є втрата якості при експорті AI у PNG?
PNG — це формат без втрат, тому пікселі, створені рендерером, зберігаються без артефактів стиснення. Розмір вихідного зображення відповідає Width і Height, повідомленим завантаженим AiImage.

5. Які версії .NET підтримує Aspose.PSD for .NET?
Aspose.PSD for .NET підтримує як .NET Framework, так і сучасний .NET, а спеціальні збірки для .NET 8 і .NET 9 випущені з версії 25.4. Перевірте вкладку Frameworks пакету Aspose.PSD у NuGet, щоб дізнатися точні цілі випуску, який ви встановлюєте.

6. Як я можу керувати рівнем стискання PNG? Встановіть PngOptions.CompressionLevel у значення від 0 (зберігання, найшвидше) до 9 (максимальне стискання, найменший файл) перед викликом Save. Стискання є без втрат на всіх рівнях, тому воно впливає лише на розмір файлу та час кодування.

Читати далі

• Конвертувати AI у PNG, JPG, PSD та PDF файл за допомогою C# .NET
• Змінити AI файл у PNG - AI у PNG онлайн
• Як конвертувати AI файли у SVG за допомогою Python через .NET
• Python через .NET: просте конвертування AI у PDF