Konversi DGN ke PSD dengan GroupDocs.Conversion untuk .NET

Pendahuluan

Jika Anda perlu mengubah gambar AutoCAD DGN menjadi file Photoshop PSD, groupdocs conversion .net adalah pustaka andal yang melakukan pekerjaan berat. Dalam tutorial ini Anda akan menemukan mengapa API ini menjadi pilihan utama bagi pengembang, cara menginstalnya, dan kode tepat yang Anda perlukan untuk menjalankan transformasi DGN‑ke‑PSD yang sempurna. Pada akhir tutorial, Anda akan siap menyematkan logika konversi ke dalam aplikasi .NET apa pun dan meningkatkan efisiensi alur kerja Anda.

Jawaban Cepat

  • Perpustakaan mana yang menangani konversi DGN → PSD? GroupDocs.Conversion for .NET.
  • Apakah saya memerlukan lisensi untuk produksi? Ya – lisensi penuh menghapus batas percobaan.
  • Bisakah saya mengonversi file DGN multi‑halaman? Setiap halaman disimpan sebagai file PSD terpisah.
  • Versi .NET apa yang didukung? .NET Framework 4.5+, .NET Core 3.1+, .NET 5/6+.
  • Berapa lama konversi tipikal memakan waktu? Sekitar 0.5 s per halaman untuk file di bawah 200 halaman pada server standar.

Apa itu groupdocs conversion .net?

GroupDocs.Conversion untuk .NET adalah API berperforma tinggi yang memungkinkan konversi programatis antara 50+ format dokumen, gambar, dan CAD—termasuk DGN ke PSD—tanpa memerlukan aplikasi eksternal. Ia memproses file di memori, yang mengurangi beban I/O dan meningkatkan latensi. Pustaka ini juga menawarkan dukungan bawaan untuk streaming, pemrosesan batch, dan pencatatan terperinci, menjadikannya cocok untuk utilitas kecil maupun pipeline perusahaan berskala besar.

Mengapa menggunakan GroupDocs.Conversion untuk DGN → PSD?

GroupDocs.Conversion menyediakan portofolio format yang luas, arsitektur skalabel, dan rendering dengan fidelitas tinggi. Ia dapat menangani file DGN berisi ratusan halaman sambil menjaga penggunaan memori di bawah 150 MB dengan streaming halaman satu‑per‑satu. Akurasi dipertahankan pada 99.9 % fidelitas, dan konversi tipikal file DGN 150‑halaman selesai dalam waktu kurang dari 45 detik pada CPU 2.4 GHz.

Prasyarat

  • GroupDocs.Conversion for .NET (Versi 25.3.0 atau lebih baru)
  • Lingkungan pengembangan .NET (Visual Studio 2022 atau VS Code)
  • Pengetahuan dasar C#

Bagaimana cara menginstal GroupDocs.Conversion untuk .NET?

Anda dapat menginstal paket melalui NuGet. Buka Package Manager Console di Visual Studio dan jalankan:

Install-Package GroupDocs.Conversion

Atau, jika Anda lebih suka .NET CLI, jalankan:

dotnet add package GroupDocs.Conversion

Kedua perintah tersebut mengunduh binary stabil terbaru dan menambahkan referensi yang diperlukan ke file proyek Anda.

Bagaimana saya dapat memperoleh lisensi konversi GroupDocs?

Lisensi yang valid membuka semua fitur dan menghapus watermark. Pilih salah satu opsi berikut:

  • Free Trial: Terbatas pada 5 konversi per hari.
  • Temporary License: Set lengkap fitur selama 30 hari, ideal untuk evaluasi.
  • Paid License: Lisensi per‑pengembang atau seluruh situs untuk penggunaan produksi.

Kunjungi halaman pembelian resmi atau halaman temporary‑license untuk detail.

Bagaimana cara menginisialisasi mesin Conversion?

Kelas ConversionConfig menyimpan pengaturan global seperti jalur penyimpanan dan informasi lisensi. Inisialisasi sekali saat aplikasi dimulai:

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

Kelas Converter melakukan konversi file sebenarnya berdasarkan konfigurasi yang diberikan.

Cara mengonversi file DGN ke PSD langkah demi langkah

Muat DGN sumber, konfigurasikan opsi PSD, dan streaming setiap halaman ke file PSD terpisah. Proses ini dibungkus dalam tiga langkah singkat.

Langkah 1: Siapkan direktori output dan templat penamaan

Tentukan di mana file PSD hasil akan disimpan dan bagaimana mereka akan dinamai:

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

Langkah 2: Buat penangan aliran untuk setiap halaman

Metode bantu SavePage menulis array byte setiap halaman ke aliran file, memastikan pembuangan yang tepat:

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

Langkah 3: Muat DGN dan jalankan konversi

Buat instance Converter, atur opsi PSD, dan iterasi melalui halaman:

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

Kode di atas membaca setiap halaman DGN, mengonversinya menjadi aliran PSD, dan menyimpannya menggunakan metode bantu SavePage.

Bagaimana cara menangani file DGN besar secara efisien?

Saat menangani file yang lebih besar dari 200 MB, aktifkan mode streaming untuk menghindari memuat seluruh dokumen ke memori. Bendera ini memberi tahu mesin untuk memproses halaman satu per satu, menjaga penggunaan memori puncak tetap rendah:

var config = new ConversionConfig { EnableStreaming = true };

Masalah Umum dan Solusinya

  • File‑path tidak ditemukan: Gunakan jalur absolut atau Path.Combine dengan AppDomain.CurrentDomain.BaseDirectory.
  • Dependensi hilang: Verifikasi bahwa versi paket NuGet cocok dengan runtime (.NET Framework vs .NET Core).
  • Kesalahan lisensi: Pastikan file .lic dapat diakses dan jalurnya telah diatur dengan benar di ConversionConfig.

Pertanyaan yang Sering Diajukan

Q: Bisakah saya mengonversi file DGN yang dilindungi kata sandi?
A: Ya. Berikan kata sandi ke konstruktor Converter: new Converter("file.dgn", config, "password").

Q: Apakah konversi mempertahankan informasi lapisan?
A: GroupDocs.Conversion mempertahankan lapisan vektor sebagai grup PSD terpisah, memungkinkan pemrosesan lanjutan di Photoshop.

Q: Apakah memungkinkan melakukan konversi batch banyak file DGN?
A: Tentu saja. Loop melalui direktori, buat instance Converter untuk setiap file, dan gunakan kembali ConversionConfig yang sama.

Q: Apa persyaratan sistem untuk kinerja optimal?
A: CPU ≥ 2.4 GHz, RAM 8 GB, dan penyimpanan SSD direkomendasikan untuk file di bawah 500 halaman.

Q: Bagaimana cara mencatat kesalahan konversi untuk pemantauan?
A: Langganan ke event Converter.OnError dan tulis detailnya ke kerangka pencatatan pilihan Anda.

Kesimpulan

Anda kini memiliki solusi lengkap dan siap produksi untuk mengonversi gambar DGN ke file PSD menggunakan groupdocs conversion .net. Dukungan format API yang luas, fidelitas tinggi, dan kemampuan streaming menjadikannya ideal untuk utilitas kecil maupun pipeline perusahaan berskala besar. Jelajahi format tambahan, sesuaikan opsi konversi, dan integrasikan alur kerja ini ke dalam layanan .NET Anda yang ada untuk membuka peluang baru.

Terakhir Diperbarui: 2026-06-10
Diuji Dengan: GroupDocs.Conversion 25.3.0 for .NET
Penulis: GroupDocs

Sumber Daya

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

Tutorial Terkait