Преобразование DGN в PSD с помощью GroupDocs.Conversion для .NET

Введение

Если вам нужно преобразовать чертежи AutoCAD DGN в файлы Photoshop PSD, groupdocs conversion .net — надёжная библиотека, которая справится с этой задачей. В этом руководстве вы узнаете, почему этот API является лучшим выбором для разработчиков, как его установить и какой именно код нужен для безошибочного преобразования DGN в PSD. К концу вы сможете внедрить логику конвертации в любое приложение .NET и повысить эффективность рабочего процесса.

Быстрые ответы

  • Какая библиотека обрабатывает конвертацию DGN → PSD? GroupDocs.Conversion for .NET.
  • Нужна ли лицензия для продакшн? Да — полная лицензия снимает ограничения пробной версии.
  • Можно ли конвертировать многостраничные файлы DGN? Каждая страница сохраняется как отдельный файл PSD.
  • Какие версии .NET поддерживаются? .NET Framework 4.5+, .NET Core 3.1+, .NET 5/6+.
  • Сколько времени занимает типичная конвертация? Около 0.5 с на страницу для файлов менее 200 страниц на стандартном сервере.

Что такое groupdocs conversion .net?

GroupDocs.Conversion for .NET — это высокопроизводительный API, позволяющий программно конвертировать более 50 форматов документов, изображений и CAD, включая DGN в PSD, без необходимости внешних приложений. Он обрабатывает файлы в памяти, что снижает нагрузку ввода‑вывода и улучшает задержку. Библиотека также предоставляет встроенную поддержку потоковой передачи, пакетной обработки и детального логирования, что делает её подходящей как для небольших утилит, так и для крупномасштабных корпоративных конвейеров.

Почему стоит использовать GroupDocs.Conversion для DGN → PSD?

GroupDocs.Conversion предоставляет широкий набор поддерживаемых форматов, масштабируемую архитектуру и высокоточное рендеринг. Он может обрабатывать многосотстраничные файлы DGN, удерживая использование памяти ниже 150 МБ за счёт потоковой передачи страниц по одной. Точность сохраняется на уровне 99,9 %, а типичная конвертация 150‑страничного файла DGN завершается менее чем за 45 секунд на процессоре 2.4 ГГц.

Требования

  • GroupDocs.Conversion for .NET (Version 25.3.0 или новее)
  • Среда разработки .NET (Visual Studio 2022 или VS Code)
  • Базовые знания C#

Как установить GroupDocs.Conversion for .NET?

Вы можете установить пакет через NuGet. Откройте Package Manager Console в Visual Studio и выполните:

Install-Package GroupDocs.Conversion

Или, если вы предпочитаете .NET CLI, выполните:

dotnet add package GroupDocs.Conversion

Обе команды загружают последние стабильные бинарные файлы и добавляют необходимые ссылки в ваш файл проекта.

Как получить лицензию GroupDocs conversion?

Действительная лицензия открывает все функции и удаляет водяные знаки. Выберите один из следующих вариантов:

  • Free Trial: Ограничено 5 конверсиями в день.
  • Temporary License: Полный набор функций на 30 дней, идеально для оценки.
  • Paid License: Лицензия на разработчика или на весь сайт для продакшн использования.

Посетите официальную страницу покупки или страницу временной лицензии для получения деталей.

Как инициализировать движок Conversion?

Класс ConversionConfig хранит глобальные настройки, такие как пути к хранилищу и информация о лицензии. Инициализируйте его один раз при запуске приложения:

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

Класс Converter выполняет фактическую конвертацию файлов на основе предоставленной конфигурации.

Как конвертировать файл DGN в PSD пошагово

Загрузите исходный DGN, настройте параметры PSD и потоково передайте каждую страницу в отдельный файл PSD. Процесс разбит на три лаконичных шага.

Шаг 1: Подготовьте каталоги вывода и шаблон именования

Определите, где будут храниться полученные файлы PSD и как они будут называться:

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

Шаг 2: Создайте обработчик потока для каждой страницы

Вспомогательный метод SavePage записывает массив байтов каждой страницы в файловый поток, обеспечивая корректное освобождение ресурсов:

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

Шаг 3: Загрузите DGN и выполните конвертацию

Создайте экземпляр Converter, задайте параметры PSD и пройдитесь по страницам:

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

Приведённый выше код читает каждую страницу DGN, конвертирует её в поток PSD и сохраняет с помощью вспомогательного метода SavePage.

Как эффективно обрабатывать большие файлы DGN?

При работе с файлами более 200 МБ включите режим потоковой передачи, чтобы избежать загрузки всего документа в память. Этот флаг заставляет движок обрабатывать страницы по одной, поддерживая низкое пиковое потребление памяти:

var config = new ConversionConfig { EnableStreaming = true };

Распространённые проблемы и решения

  • File‑path not found: Используйте абсолютные пути или Path.Combine с AppDomain.CurrentDomain.BaseDirectory.
  • Missing dependencies: Убедитесь, что версия пакета NuGet соответствует среде выполнения (.NET Framework vs .NET Core).
  • License errors: Убедитесь, что файл .lic доступен и путь к нему правильно указан в ConversionConfig.

Часто задаваемые вопросы

В: Можно ли конвертировать DGN файл, защищённый паролем?
О: Да. Передайте пароль в конструктор Converter: new Converter("file.dgn", config, "password").

В: Сохраняет ли конвертация информацию о слоях?
О: GroupDocs.Conversion сохраняет векторные слои как отдельные группы в PSD, позволяя дальнейшую обработку в Photoshop.

В: Можно ли пакетно конвертировать несколько файлов DGN?
О: Конечно. Пройдитесь по каталогу, создайте Converter для каждого файла и переиспользуйте один и тот же ConversionConfig.

В: Каковы системные требования для оптимальной производительности?
О: Рекомендуется процессор ≥ 2.4 GHz, 8 ГБ ОЗУ и SSD‑накопитель для файлов менее 500 страниц.

В: Как вести журнал ошибок конвертации для мониторинга?
О: Подпишитесь на событие Converter.OnError и записывайте детали в выбранную вами систему логирования.

Заключение

Теперь у вас есть полное, готовое к продакшн решение для преобразования чертежей DGN в файлы PSD с использованием groupdocs conversion .net. Широкая поддержка форматов API, высокая точность и возможности потоковой передачи делают его идеальным как для небольших утилит, так и для крупномасштабных корпоративных конвейеров. Исследуйте дополнительные форматы, настройте параметры конвертации и интегрируйте этот рабочий процесс в свои существующие сервисы .NET, чтобы открыть новые возможности.

Последнее обновление: 2026-06-10
Тестировано с: GroupDocs.Conversion 25.3.0 for .NET
Автор: GroupDocs

Ресурсы

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

Связанные руководства