Převést AI typ 1 stínování na PNG v C# .NET

Rendering Adobe Illustrator (AI) artwork na serveru je obtížnější, než se zdá, a Type 1 function-based shading je jednou z funkcí, která mnohé renderery zaskočí. Pokud váš pipeline generuje miniatury, webové náhledy nebo tiskové proofy z AI souborů, potřebujete, aby toto stínování bylo vykresleno správně, nikoli nahrazeno plnou výplní. Aspose.PSD for .NET vám umožní převést AI soubory obsahující Type 1 shading do PNG v C# s několika řádky kódu a bez instalace Adobe Illustratoru. Tento tutoriál vás provede instalací SDK, načtením AI souboru, konfigurací PngOptions, exportem vícestránkových dokumentů a zpracováním chyb v produkci.

Proč převést AI Type 1 Shading na PNG

Moderní soubory AI ukládají svou grafiku ve struktuře kompatibilní s PDF a PDF definuje několik typů stínování pro plynulé přechody barev. Typ 2 (axiální) a Typ 3 (radiální) stínování popisují lineární a kruhové gradienty. Typ 1 stínování je založen na funkci: barva v každém bodě je vypočítána matematickou funkcí jejích souřadnic x a y. To je velmi flexibilní, ale také to znamená, že renderér musí vyhodnotit funkci přes celé stínované území.

Když vykreslovací zařízení neimplementuje stínování založené na funkcích, obvykle se stínovaná oblast přeskočí nebo se vykreslí jednou barvou a exportovaný obrázek již neodpovídá původnímu návrhu. Aspose.PSD for .NET vyhodnocuje typ 1 stínování interně během vykreslování, takže PNG, které uložíte, odráží umělecké dílo tak, jak bylo navrženo.

S touto schopností mohou vývojáři .NET:

• Vytvářejte přesné miniatury a náhledy pro systémy správy digitálních aktiv (DAM).
• Publikujte verze Illustratorových ilustrací ve formátu PNG na webových stránkách a v aplikacích, které nemohou zobrazovat soubory AI.
• Vytvářejte automatizované, serverové dávkové konverzní pipeline, které běží na Windows, Linuxu nebo v kontejnerech.

Použití Aspose.PSD pro převod AI typu 1 stínování

Aspose.PSD for .NET je knihovna C# pro vytváření, úpravu a konverzi souborů Photoshop (PSD, PSB) a pro načítání a export souborů Adobe Illustrator (AI). Funguje bez Adobe Photoshopu nebo Illustratoru a je distribuována jako balíček NuGet.

Třídy použité v tomto tutoriálu jsou:

• Image (namespace Aspose.PSD): vstupní bod pro načtení jakéhokoli podporovaného souboru pomocí Image.Load.
• AiImage (namespace Aspose.PSD.FileFormats.Ai): představuje načtený dokument Illustrator a poskytuje členy jako PageCount a ActivePageIndex.
• PngOptions (namespace Aspose.PSD.ImageOptions): řídí nastavení exportu PNG, jako jsou ColorType a CompressionLevel.
• PngColorType (namespace Aspose.PSD.FileFormats.Png): vybírá formát pixelů PNG.

Instalace

Nainstalujte balíček z konzole správce balíčků:

Install-Package Aspose.PSD

Nebo pomocí .NET CLI:

dotnet add package Aspose.PSD

Více se můžete dozvědět na stránce produktu Aspose.PSD for .NET, v dokumentaci pro vývojáře, a v referenční příručce API.

1. Nastavte svůj projekt .NET

Vytvořte konzolovou aplikaci, která bude hostovat kód převodu. Níže uvedené příklady používají top‑level statements a pattern matching v C# 9, takže cílíte na .NET 6 nebo novější.

1. Vytvořte nový projekt z příkazového řádku nebo ve Visual Studio:

dotnet new console -n AiShadingConversion
cd AiShadingConversion

2. Přidejte balíček Aspose.PSD for .NET pomocí jednoho z instalačních příkazů uvedených výše.
3. Otevřete Program.cs a přidejte požadované direktivy using na začátek:

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 poskytuje třídu Image a Aspose.PSD.FileFormats.Ai obsahuje AiImage. PngOptions se nachází v Aspose.PSD.ImageOptions, zatímco Aspose.PSD.FileFormats.Png poskytuje výčet PngColorType. Aspose.PSD.CoreExceptions obsahuje ImageLoadException, který použijete pro zpracování chyb.

2. Načtení souboru AI obsahujícího stínování typu 1

Image.Load detekuje formát souboru automaticky. Když je zdroj dokument Illustratoru, vrácený objekt je AiImage. Kontrola typu pomocí pattern matching je bezpečnější než přímý cast, protože přímý cast vyvolá InvalidCastException, pokud někdo předá PSD nebo jiný podporovaný formát.

Co kód dělá:

• Vytvoří úplnou cestu ke zdrojovému souboru AI.
• Načte soubor pomocí Image.Load.
• Potvrdí, že výsledek je AiImage, a vypíše jeho velikost a počet stránek.

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}");
}

Blok using uvolní obrázek a uvolní jeho prostředky, jakmile s ním skončíte. Není vyžadováno žádné specifické nastavení stínování: Stínování typu 1 je součástí obsahu dokumentu a je zpracováno rendererem při uložení.

3. Uložit obrázek jako PNG

Exportování do PNG vyžaduje jediný volání funkce Save, která přijímá výstupní cestu a instanci PngOptions. Nastavením ColorType na PngColorType.TruecolorWithAlpha se zapíše 32‑bitový RGBA obrázek, takže jakákoli průhlednost vytvořená rendererem je zachována, a CompressionLevel (0 až 9) vyvažuje rychlost kódování a velikost souboru.

Co kód dělá:

• Vytvoří výstupní složku, pokud neexistuje.
• Načte soubor AI jako AiImage.
• Nastaví PngOptions a uloží vykreslené umělecké dílo, včetně stínování Type 1, jako 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}");
}

Otevřete shadingType1.png v libovolném prohlížeči obrázků a porovnejte jej s originálním uměleckým dílem, abyste potvrdili, že stínované oblasti jsou vykresleny podle očekávání.

Kompletní příklad: Převést AI typ 1 stínování na PNG v C#

Následující Program.cs kombinuje vše do jedné připravené produkční konzolové aplikace. Ověřuje vstup, exportuje každou stránku vícestránkového souboru AI a zpracovává chyby načítání.

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. Tipy, běžné úskalí a úvahy o výkonu

Exportovat vícestránkové soubory AI po stránce

Dokumenty Illustratoru mohou obsahovat několik stránek (artboardů). AiImage.PageCount vrací počet stránek a ActivePageIndex vybírá stránku, kterou Save vykreslí. Nastavte index, uložte a opakujte, jak je ukázáno v úplném příkladu. Všimněte si, že AiImage.Layers vrací objekty AiLayerSection, které popisují strukturu dokumentu; nejsou to samostatné obrázky, takže použijte stránky místo vrstev, pokud potřebujete jeden PNG na artboard.

Použijte pattern matching místo slepých přetypování

Přetypování jako (AiImage)Image.Load(path) je v pořádku, pokud máte kontrolu nad vstupem. V obsluze nahrávání nebo v dávkových úlohách upřednostněte image is AiImage aiImage, aby byly neočekávané formáty jasně nahlášeny místo vyhození InvalidCastException.

Spravovat paměť při dávkových konverzích

Renderování velkých nebo složitých obrázků, zejména s funkčně založeným stínováním, je náročné na CPU a paměť. Vždy zabalte každý načtený obrázek do bloku using, zpracovávejte soubory po jednom (nebo s malým, omezeným stupněm paralelismu) a znovu použijte jedinou instanci PngOptions napříč soubory.

Zachovat průhlednost

Použijte PngColorType.TruecolorWithAlpha, když bude PNG umístěn nad jiným obsahem, například na webové stránce nebo v designovém nástroji. Pokud nepotřebujete alfa kanál, výstup ve truecolor bez alfy vytváří menší soubory.

Explicitně zpracovávejte chyby

Zkontrolujte, zda vstupní soubor existuje před jeho načtením, a zachyťte výjimku ImageLoadException (namespace Aspose.PSD.CoreExceptions) pro soubory, které jsou poškozené nebo nelze je parsovat. Zaznamenejte název souboru spolu se zprávou výjimky, aby se selhané položky v dávce snadno opakovaly.

Udržujte Aspose.PSD aktuální

AI rendering se postupně zlepšuje s každým vydáním, včetně oprav stínování, měkkých masek a vložených obrázků. Pokud se soubor vykresluje jinak, než se očekává, aktualizujte na nejnovější verzi balíčku, než budete dále řešit problémy.

Získejte bezplatnou licenci

Bez licence běží Aspose.PSD for .NET v evaluačním režimu a přidává vodoznak k exportovaným obrázkům. Požádejte o bezplatnou dočasnou licenci, abyste mohli 30 dnů testovat plné API, a poté ji použijte před prvním voláním Image.Load:

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

Bezplatné další zdroje

• Dokumentace: https://docs.aspose.com/psd/net/
• Reference API: https://reference.aspose.com/psd/net/
• Bezplatné webové aplikace: https://products.aspose.app/psd/family

Závěr

Převod AI souborů s typem 1 funkčně založeného stínování do PNG v C# je jednoduchý s Aspose.PSD for .NET. Nainstalujte balíček NuGet, načtěte soubor pomocí Image.Load, nakonfigurujte PngOptions a zavolejte Save: knihovna vyhodnocuje stínování během vykreslování, takže váš PNG odpovídá původnímu uměleckému dílu bez Adobe Illustrator nebo externích nástrojů. S exportem po stránkách, bezpečnými kontrolami typů a explicitním zpracováním chyb lze stejný kód škálovat od jedné náhledové verze až po vysokokapacitní serverové konverzní pipeline.

Často kladené otázky

1. Potřebuji licenci k převodu AI Type 1 shading do PNG?
Žádná licence není potřeba pro vyzkoušení, ale bez ní Aspose.PSD běží v evaluačním režimu, který přidává vodoznak do výstupu. Můžete požádat o bezplatnou 30‑denní dočasnou licenci pro hodnocení bez omezení. Zakoupená licence je vyžadována pro produkční použití.

2. Jak převést vícestránkový AI soubor na PNG v C#?
Přečtěte vlastnost AiImage.PageCount, poté nastavte ActivePageIndex na index každé stránky a zavolejte Save s oddělenou výstupní cestou. Starší AI soubory uvádějí PageCount roven 0, takže je považujte za jednostránkový.

3. Co se stane, pokud AI soubor neobsahuje stínování typu 1?
Nic se ve vašem kódu nezmění. Aspose.PSD vykreslí vše, co soubor obsahuje, včetně dalších typů gradientů, cest a vložených obrázků, a výsledek uloží jako PNG.

4. Dochází při exportu AI do PNG k nějaké ztrátě kvality? PNG je bezztrátový formát, takže pixely vytvořené rendererem jsou uloženy bez kompresních artefaktů. Velikost výstupu odpovídá hodnotám Width a Height, které jsou hlášeny načteným AiImage.

5. Které verze .NET podporuje Aspose.PSD for .NET? Aspose.PSD for .NET podporuje jak .NET Framework, tak moderní .NET, a dedikované sestavení pro .NET 8 a .NET 9 jsou k dispozici od verze 25.4. Zkontrolujte kartu Frameworks balíčku Aspose.PSD na NuGet pro přesné cíle verze, kterou instalujete.

6. Jak mohu řídit úroveň komprese PNG? Nastavte PngOptions.CompressionLevel na hodnotu od 0 (uložit, nejrychlejší) do 9 (maximální komprese, nejmenší soubor) před voláním Save. Komprese je bezztrátová na každé úrovni, takže ovlivňuje pouze velikost souboru a čas kódování.

Číst více

• Převést AI na PNG, JPG, PSD a PDF soubor pomocí C# .NET
• Změnit AI soubor na PNG – AI na PNG online
• Jak převést AI soubory na SVG v Pythonu přes .NET
• Python přes .NET: Jednoduchá konverze AI do PDF