GroupDocs.Conversion for .NET を使用して DGN を PNG に変換する方法：完全ガイド

DGN ファイルを PNG 画像に変換することは、エンジニアや建築家、そして CAD 図面を軽量でウェブフレンドリーな画像として共有する必要があるすべての人にとって一般的な作業です。このチュートリアルでは、GroupDocs.Conversion for .NET を使用して convert dgn to png を迅速かつ確実に行う方法を学びます。インストール、DGN ファイルの読み込み、PNG オプションの設定、結果の保存までを順に解説し、各ステップがパフォーマンスと精度にどのように影響するかを説明します。

クイック回答

  • どのライブラリが変換を処理しますか？ GroupDocs.Conversion for .NET.
  • 一度の呼び出しでマルチページ DGN を変換できますか？ Yes – the API processes each page automatically.
  • 基本的な使用にライセンスは必要ですか？ A trial works for development; a full license is required for production.
  • サポートされている .NET バージョンはどれですか？ .NET Framework 4.5+, .NET Core 3.1+, .NET 5/6/7.
  • 変換はメモリ効率が良いですか？ Yes, it streams pages and never loads the whole file into RAM.

GroupDocs.Conversion for .NET とは？

GroupDocs.Conversion for .NET は、CAD 図面、PDF、画像、オフィス文書など、100 以上のファイル形式間のプログラムによる変換を可能にする堅牢な SDK です。500 MB までのファイルを、ドキュメント全体をメモリに読み込むことなく処理できるため、サーバー側のバッチジョブに最適です。

CAD 図面に GroupDocs.Conversion を使用する理由

GroupDocs.Conversion は、速度、精度、スケーラビリティを兼ね備えており、CAD 図面の取り扱いに最適です。複雑な DGN ファイルを高速に変換しながらベクターデータを保持し、バッチ処理をサポートし、プラットフォームを横断して動作するため、エンジニアリングや建築のワークフローで信頼性の高い結果を提供します。

  • Speed: Typical cloud VM で 300 ページの DGN を PNG に変換すると、12 秒未満で完了します。
  • Accuracy: ベクタージオメトリ、レイヤー、ラスタ画像を 99.9 % の忠実度で保持します。
  • Scalability: 非同期および並列処理をサポートし、1 日に数千ファイルの処理が可能です。
  • Cross‑platform: .NET Core で Windows、Linux、macOS 上で動作します。

前提条件

  • Required library: GroupDocs.Conversion for .NET (install via NuGet).
  • Development environment: Visual Studio 2022 or any IDE that supports .NET 6+.
  • Basic C# knowledge: Familiarity with namespaces, classes, and async patterns.

GroupDocs.Conversion のインストール方法

NuGet を使用すれば SDK のインストールは簡単です。このパッケージには必要なバイナリと依存関係がすべて含まれており、プロジェクトに追加した直後からファイルの変換を開始できます。Package Manager Console または .NET CLI のいずれかを選択でき、どちらも最新の安定版を取得してビルドパイプラインに統合します。

Package Manager Console

Install-Package GroupDocs.Conversion -Version 25.3.0

.NET CLI

dotnet add package GroupDocs.Conversion --version 25.3.0

パッケージを追加したら、GroupDocs のウェブサイトからトライアルまたはフルライセンスを取得（purchase page）するか、評価用の一時ライセンスをリクエスト（temporary license）し、アプリケーションの設定に追加してください。

dgn を png に変換する方法

Converter インスタンスで DGN ファイルを読み込み、PNG オプションを設定し、Convert メソッドを呼び出します。API は各ページを MemoryStream にストリームし、これをディスクに書き込むかクライアントに返します。このアプローチにより、大きな図面でもメモリ使用量を抑えることができます。

.NET プロジェクトで GroupDocs.Conversion を設定する方法

セットアップは、ライセンスキーを追加し、ソースファイルを指す Converter インスタンスを作成することから始めます。これにより SDK が変換を実行できるようになり、すべての操作がライセンス条件に従うことが保証されます。
Converter クラスは、GroupDocs.Conversion 内でファイルの読み込みと変換を管理するコアコンポーネントです。

using GroupDocs.Conversion;

// Initialize a converter object with the path to your DGN file
string dgnFilePath = "YOUR_DOCUMENT_DIRECTORY/sample.dgn";
Converter converter = new Converter(dgnFilePath);

変換用に DGN ファイルを読み込む方法

ファイルパスを指定して Converter を構築することで DGN ファイルを読み込みます。このステップでファイルが検証され、以降の変換操作の準備が整います。
Converter クラスは、ソースドキュメントのオープンとページの公開を処理します。

string dgnFilePath = "YOUR_DOCUMENT_DIRECTORY/sample.dgn";

// Load the DGN file using GroupDocs.Conversion's Converter class
Converter converter = new Converter(dgnFilePath);

PNG 変換オプションを設定する方法

ImageConvertOptions オブジェクトで PNG 変換設定を定義します。これにより出力形式、解像度、視覚的プロパティを指定できます。これらのオプションを調整することで、生成される画像の品質とサイズを制御します。
ImageConvertOptions クラスは、DPI、背景色、ページサイズなど、画像出力に関するすべての設定パラメータをカプセル化しています。

using GroupDocs.Conversion.Options.Convert;

// Initialize image conversion options with desired output format
ImageConvertOptions options = new ImageConvertOptions
{
    Format = GroupDocs.Conversion.FileTypes.ImageFileType.Png
};

変換を実行し PNG ファイルを保存する方法

Converter の Convert メソッドを呼び出し、オプションと各ページ用のストリームを作成するデリゲートを渡すことで変換が開始されます。このメソッドはドキュメントをページ単位で処理し、提供されたストリームに PNG データを書き込みます。
Convert メソッドは、指定されたオプションを使用してソース形式からターゲット形式への実際の変換を実行します。

using System.IO;

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

// Define a method to create file streams for each page being converted
Func<SavePageContext, Stream> getPageStream = savePageContext =>
    new FileStream(string.Format(outputFileTemplate, savePageContext.Page), FileMode.Create);

// Perform the conversion from DGN to PNG using the Converter object and options defined earlier
converter.Convert(getPageStream, options);

実用的なユースケース

  1. Architectural firms は、CAD ソフトを持たないクライアントと設計スナップショットを共有します。
  2. Construction managers は、プロジェクト管理ツールに PNG プレビューを埋め込み、迅速な視覚チェックを可能にします。
  3. Marketing teams は、元の CAD ソースを公開せずに、パンフレットやオンラインポートフォリオ用の高解像度画像を抽出します。

パフォーマンスのヒント

  • Converter オブジェクトは使用後すぐに破棄し、アンマネージドリソースを解放してください。
  • 多数のファイルを Web API で処理する場合は、リクエストスレッドを解放するために非同期変換（ConvertAsync）を優先してください。
  • CPU とメモリ使用率を監視し、200 MB を超えるファイルはページをバッチ処理することを検討してください。

よくある質問

Q: DGN と PNG 以外に GroupDocs.Conversion が扱えるフォーマットは何ですか？
A: PDF、DOCX、XLSX、PPTX、SVG、JPEG、BMP、DWG や DXF など、100 種類以上のフォーマットに対応しています。

Q: パスワードで保護された DGN ファイルはどう扱いますか？
A: LoadOptions パラメータを使用して Converter コンストラクタにパスワードを渡すと、SDK が変換前にファイルを復号化します。

Q: Linux コンテナで変換を実行できますか？
A: はい、GroupDocs.Conversion for .NET は Linux 上の .NET Core と完全に互換性があり、Docker を使用してサービスをコンテナ化できます。

Q: 1 回のリクエストで変換できるページ数に制限はありますか？
A: 厳密な上限はありませんが、非常に大きな図面（500 ページ超）では、長時間実行リクエストを避けるためにページを分割して処理することを推奨します。

Q: 評価用の一時ライセンスはどこで取得できますか？
A: GroupDocs のウェブサイトにアクセスし、トライアルライセンスをリクエストしてください。30 日間有効で、すべての変換機能が利用可能です。

最終更新日: 2026-06-25
テスト環境: GroupDocs.Conversion 25.3.0 for .NET
作者: GroupDocs

関連チュートリアル