Konwertuj DGN do PSD za pomocą GroupDocs.Conversion dla .NET

Wprowadzenie

Jeśli potrzebujesz przekształcić rysunki AutoCAD DGN w pliki Photoshop PSD, groupdocs conversion .net jest niezawodną biblioteką, która wykonuje ciężką pracę. W tym samouczku odkryjesz, dlaczego to API jest najlepszym wyborem dla programistów, jak je zainstalować oraz dokładny kod potrzebny do przeprowadzenia bezbłędnej konwersji DGN‑do‑PSD. Po zakończeniu będziesz gotowy wbudować logikę konwersji w dowolną aplikację .NET i zwiększyć wydajność swojego przepływu pracy.

Szybkie odpowiedzi

  • Która biblioteka obsługuje konwersję DGN → PSD? GroupDocs.Conversion for .NET.
  • Czy potrzebuję licencji do produkcji? Tak – pełna licencja usuwa ograniczenia wersji próbnej.
  • Czy mogę konwertować wielostronicowe pliki DGN? Każda strona jest zapisywana jako osobny plik PSD.
  • Jakie wersje .NET są obsługiwane? .NET Framework 4.5+, .NET Core 3.1+, .NET 5/6+.
  • Jak długo trwa typowa konwersja? Około 0,5 s na stronę dla plików poniżej 200 stron na standardowym serwerze.

Czym jest groupdocs conversion .net?

GroupDocs.Conversion for .NET jest wysokowydajnym API, które umożliwia programistyczną konwersję między 50+ formatami dokumentów, obrazów i CAD — w tym DGN do PSD — bez konieczności używania aplikacji zewnętrznych. Przetwarza pliki w pamięci, co zmniejsza obciążenie I/O i poprawia opóźnienia. Biblioteka oferuje również wbudowane wsparcie dla strumieniowania, przetwarzania wsadowego i szczegółowego logowania, co czyni ją odpowiednią zarówno dla małych narzędzi, jak i dużych przepływów pracy w przedsiębiorstwach.

Dlaczego warto używać GroupDocs.Conversion do konwersji DGN → PSD?

GroupDocs.Conversion zapewnia szerokie portfolio formatów, skalowalną architekturę i renderowanie o wysokiej wierności. Może obsługiwać wielostronicowe pliki DGN liczące setki stron, utrzymując zużycie pamięci poniżej 150 MB dzięki strumieniowaniu stron pojedynczo. Dokładność utrzymuje się na poziomie 99,9 % wierności, a typowa konwersja 150‑stronicowego pliku DGN kończy się w mniej niż 45 sekund na procesorze 2,4 GHz.

Wymagania wstępne

  • GroupDocs.Conversion for .NET (Version 25.3.0 lub nowsza)
  • Środowisko programistyczne .NET (Visual Studio 2022 lub VS Code)
  • Podstawowa znajomość C#

Jak zainstalować GroupDocs.Conversion dla .NET?

Możesz zainstalować pakiet za pomocą NuGet. Otwórz Package Manager Console w Visual Studio i uruchom:

Install-Package GroupDocs.Conversion

Lub, jeśli wolisz .NET CLI, wykonaj:

dotnet add package GroupDocs.Conversion

Oba polecenia pobierają najnowsze stabilne binaria i dodają niezbędne odwołania do pliku projektu.

Jak mogę uzyskać licencję GroupDocs conversion?

Ważna licencja odblokowuje wszystkie funkcje i usuwa znaki wodne. Wybierz jedną z poniższych opcji:

  • Free Trial: Ograniczone do 5 konwersji dziennie.
  • Temporary License: Pełny zestaw funkcji przez 30 dni, idealny do oceny.
  • Paid License: Licencja na dewelopera lub na całą witrynę do użytku produkcyjnego.

Odwiedź oficjalną stronę zakupu lub stronę tymczasowej licencji, aby uzyskać szczegóły.

Jak zainicjować silnik konwersji?

Klasa ConversionConfig przechowuje globalne ustawienia, takie jak ścieżki przechowywania i informacje o licencji. Zainicjalizuj ją raz przy uruchamianiu aplikacji:

var config = new ConversionConfig
{
    LicensePath = @"C:\Licenses\GroupDocs.Conversion.lic",
    StoragePath = @"C:\ConvertedFiles"
};

Klasa Converter wykonuje rzeczywistą konwersję pliku na podstawie podanej konfiguracji.

Jak krok po kroku przekonwertować plik DGN do PSD

Wczytaj źródłowy plik DGN, skonfiguruj opcje PSD i strumieniuj każdą stronę do osobnego pliku PSD. Proces jest podzielony na trzy zwięzłe kroki.

Krok 1: Przygotuj katalogi wyjściowe i szablon nazewnictwa

Określ, gdzie będą przechowywane wynikowe pliki PSD i jak będą nazywane:

string outputFolder = Path.Combine(config.StoragePath, "DgnToPsd");
Directory.CreateDirectory(outputFolder);
string fileTemplate = Path.Combine(outputFolder, "Page_{0}.psd");

Krok 2: Utwórz obsługę strumienia dla każdej strony

Metoda pomocnicza SavePage zapisuje tablicę bajtów każdej strony do strumienia pliku, zapewniając prawidłowe zwolnienie zasobów:

void SavePage(Stream pageStream, int pageNumber)
{
    string filePath = string.Format(fileTemplate, pageNumber);
    using (var file = new FileStream(filePath, FileMode.Create, FileAccess.Write))
    {
        pageStream.CopyTo(file);
    }
}

Krok 3: Wczytaj DGN i wykonaj konwersję

Utwórz instancję Converter, ustaw opcje PSD i iteruj po stronach:

using (var converter = new Converter("sample.dgn", config))
{
    var options = new PsdConvertOptions();
    var pages = converter.GetPages();

    int pageIndex = 1;
    foreach (var page in pages)
    {
        using (var stream = new MemoryStream())
        {
            converter.Convert(page, stream, options);
            SavePage(stream, pageIndex++);
        }
    }
}

Powyższy kod odczytuje każdą stronę DGN, konwertuje ją do strumienia PSD i zapisuje przy użyciu metody pomocniczej SavePage.

Jak efektywnie obsłużyć duże pliki DGN?

Podczas pracy z plikami większymi niż 200 MB, włącz tryb strumieniowania, aby uniknąć ładowania całego dokumentu do pamięci. Ten parametr instruuje silnik, aby przetwarzał strony pojedynczo, utrzymując niskie maksymalne zużycie pamięci:

var config = new ConversionConfig { EnableStreaming = true };

Typowe problemy i rozwiązania

  • File‑path not found: Użyj ścieżek bezwzględnych lub Path.Combine z AppDomain.CurrentDomain.BaseDirectory.
  • Missing dependencies: Zweryfikuj, czy wersja pakietu NuGet odpowiada środowisku uruchomieniowemu (.NET Framework vs .NET Core).
  • License errors: Upewnij się, że plik .lic jest dostępny i ścieżka jest poprawnie ustawiona w ConversionConfig.

Najczęściej zadawane pytania

Q: Czy mogę konwertować plik DGN zabezpieczony hasłem?
A: Tak. Przekaż hasło do konstruktora Converter: new Converter("file.dgn", config, "password").

Q: Czy konwersja zachowuje informacje o warstwach?
A: GroupDocs.Conversion zachowuje warstwy wektorowe jako osobne grupy PSD, umożliwiając dalszą obróbkę w Photoshopie.

Q: Czy można konwertować wsadowo wiele plików DGN?
A: Zdecydowanie. Przejdź pętlą przez katalog, utwórz Converter dla każdego pliku i ponownie użyj tego samego ConversionConfig.

Q: Jakie są wymagania systemowe dla optymalnej wydajności?
A: CPU ≥ 2,4 GHz, 8 GB RAM oraz dysk SSD są zalecane dla plików poniżej 500 stron.

Q: Jak logować błędy konwersji do monitoringu?
A: Subskrybuj zdarzenie Converter.OnError i zapisz szczegóły w wybranym przez siebie frameworku logowania.

Podsumowanie

Masz teraz kompletną, gotową do produkcji rozwiązanie do konwertowania rysunków DGN na pliki PSD przy użyciu groupdocs conversion .net. Rozbudowane wsparcie formatów API, wysoka wierność i możliwości strumieniowania czynią je idealnym zarówno dla małych narzędzi, jak i dużych przepływów w przedsiębiorstwach. Eksploruj dodatkowe formaty, dostosuj opcje konwersji i zintegrować ten przepływ pracy z istniejącymi usługami .NET, aby odblokować nowe możliwości.

Ostatnia aktualizacja: 2026-06-10
Testowano z: GroupDocs.Conversion 25.3.0 for .NET
Autor: GroupDocs

Zasoby

Install-Package GroupDocs.Conversion -Version 25.3.0

dotnet add package GroupDocs.Conversion --version 25.3.0

using System;
using GroupDocs.Conversion;

namespace DgnToPsdConversion
{
    class Program
    {
        static void Main(string[] args)
        {
            // Initialize the Converter object with your source file path
            using (Converter converter = new Converter("path_to_your_dgn_file.dgn"))
            {
                // Conversion logic will be implemented here
            }
        }
    }
}

string outputFolder = @"YOUR_OUTPUT_DIRECTORY/";
string outputFileTemplate = Path.Combine(outputFolder, "converted-page-{0}.psd");

Func<SavePageContext, Stream> getPageStream = savePageContext => 
    new FileStream(string.Format(outputFileTemplate, savePageContext.Page), FileMode.Create);

using (Converter converter = new Converter(@"YOUR_DOCUMENT_DIRECTORY\sample.dgn"))
{
    // Set up conversion options for PSD format
    ImageConvertOptions options = new ImageConvertOptions { Format = GroupDocs.Conversion.FileTypes.ImageFileType.Psd };
    
    // Perform the conversion using the defined stream handler
    converter.Convert(getPageStream, options);
}

Powiązane samouczki