C#でPDFのテキストを回転

WebGLサイトをC#でレンダリングする方法

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF は、Chrome の GPU モードを Hardware に設定し、SingleProcess モードを使用することで、WebGL ウェブサイトを PDF にレンダリングすることを可能にし、Mapbox などのサイトから動的な 3D グラフィックを静的な PDF ドキュメントにキャプチャできるようにします。

Webgl Logo related to WebGLサイトをC#でレンダリングする方法

WebGLは、ウェブブラウザ内でインタラクティブな3Dグラフィックスを作成するための強力なツールですが、これらのダイナミックで高度にインタラクティブな体験を静的なPDF形式に変換することは困難な場合があります。 WebGLウェブサイトをPDFにレンダリングするには、WebGLコンテキストによって生成された視覚コンテンツをキャプチャし、それをPDFドキュメントに適した形式に変換することが含まれます。 このプロセスでは、HTMLからPDFへの変換プロセスの間にGPUアクセラレーションによるグラフィックが適切にキャプチャされるように、特別な設定が必要です。

IronPDFは、MapboxWebGLサンプルコレクションなどのWebGLを使用したウェブサイトをキャプチャおよびレンダリングするために必要なツールを提供します。 標準的なHTMLレンダリングとは異なり、WebGLコンテンツにはGPUへのアクセスと、レンダリングパイプラインとPDF生成の適切な同期が必要です。 ライブラリのChrome Rendering Engineは、これらの複雑な処理を行い、3Dビジュアライゼーション、複雑なシェーダー、インタラクティブなグラフィックを静的なPDFフォーマットで保持することを可能にします。

クイックスタート: .NETで WebGL コンテンツを PDF にレンダリングする

.NET C#でIronPDFを使用してインタラクティブなWebGLグラフィックスを静的PDFに変換します。 このガイドでは、WebサイトからWebGLコンテンツをセットアップしてレンダリングする方法を説明します。 Chrome GPU モードを Hardware に設定し、SingleProcess を有効にすると、動的な Web グラフィックをキャプチャできます。 このステップでは、3Dウェブコンテンツを共有可能なPDFドキュメントに変換します。

  1. IronPDF をNuGetパッケージマネージャでインストール

    PM > Install-Package IronPdf
  2. このコード スニペットをコピーして実行します。

    IronPdf.Installation.SingleProcess = true; IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Hardware;
    new IronPdf.ChromePdfRenderer { RenderingOptions = { WaitFor = IronPdf.Rendering.WaitFor.RenderDelay(5000) } }
        .RenderUrlAsPdf("https://example.com/webgl-demo")
        .SaveAs("webgl-output.pdf");
  3. 実際の環境でテストするためにデプロイする

    今日プロジェクトで IronPDF を使い始めましょう無料トライアル

    arrow pointer


WebGLウェブサイトをレンダリングするためにIronPdfを設定するには?

WebGLレンダリングを有効にするには、以下のIronPdf設定を行います:

  • SingleProcess = true. これにより、Chromeはサブプロセスではなく、現在のプロセス内ですべてを実行します。 すべてのGPU操作が同じプロセスコンテキスト内で行われるようにするため、これはWebGLレンダリングにとって非常に重要です。
  • ChromeGpuMode = Hardware. これにより、ハードウェアアクセラレーションが可能になり、GPUがWebGLコンテンツを適切にレンダリングできるようになります。

さらに、Web サイトが適切に表示されるまでにレンダリングの遅延が必要な場合は、WaitFor.RenderDelay メソッドを使用します。 これは、複雑な3Dシーンが完全に読み込まれ、レンダリングされるまでに数秒かかる可能性があるため、WebGLコンテンツにとって特に重要です。 より高度なタイミング制御については、WaitFor を使用して PDF レンダリングを遅延させるガイドを参照してください。

例として、Mapbox's GeoJSON Layer のサンプルをレンダリングしてみましょう:

:path=/static-assets/pdf/content-code-examples/how-to/render-webgl-render-webgl.cs
using IronPdf;

// Configure IronPdf settings
IronPdf.Installation.SingleProcess = true;
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Hardware;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Set delay before rendering
renderer.RenderingOptions.WaitFor.RenderDelay(5000);

// Render from URL
PdfDocument pdf = renderer.RenderUrlAsPdf("https://docs.mapbox.com/mapbox-gl-js/example/geojson-layer-in-slot/");

pdf.SaveAs("webGL.pdf");
$vbLabelText   $csharpLabel

設定オプションを理解する

WebGL レンダリングはメイン プロセスと GPU プロセス間の共有メモリに依存するため、SingleProcess 構成は不可欠です。 Chromeをマルチプロセスモード(デフォルト)で実行すると、PDFキャプチャが発生する前にGPU操作が正しく完了しない場合があります。 シングルプロセスモードを強制することで、すべてのレンダリング操作が順次完了するようにしています。

ハードウェアGPUモードは、Chromeのハードウェアアクセラレーション機能を有効にします。 この設定がないと、Chromeはソフトウェアレンダリングに戻り、シェーダ、テクスチャ、3D変換などのWebGLの高度なグラフィック機能を適切に扱うことができません。 レンダリング オプションの詳細については、包括的なレンダリング オプション ガイドをご覧ください。

レンダリングされた WebGL PDF はどのように見えますか?

出来上がったPDFは、レンダリングの瞬間にWebGLコンテンツをキャプチャし、3Dグラフィックス、マップの視覚化、複雑なシェーダー効果の視覚状態を保持します。 静的なPDFフォーマットではインタラクティブな機能は失われますが、視覚的な忠実度は高く保たれているため、ドキュメント、レポート、アーカイブの目的に適しています。

一般的な WebGL レンダリングのシナリオ

WebGLレンダリングは、特に次のような場合に役立ちます:

1.地理的ビジュアライゼーション:3D地形、天候オーバーレイ、または地理データのビジュアライゼーションで地図をキャプチャする。 2.データダッシュボード:インタラクティブな 3D チャートやグラフを静的レポートに変換する 3.CADおよび3Dモデル:3Dデザインや建築ビジュアライゼーションの文書化 4.科学的視覚化:分子構造、天文データ、シミュレーション結果の保存

WebGL以外 for JavaScriptを多用するコンテンツについては、JavaScriptからPDFへの変換のガイドを参照してください。

Dockerの制限と回避策

DockerセットアップでWebGLをレンダリングすることは現在不可能です。Docker上でのWebGLのレンダリングは挑戦的です。なぜなら、Dockerコンテナは通常GUIを持たないヘッドレス環境であるためです。 WebGLはグラフィックスをレンダリングするためにGPUへのアクセスを必要としますが、ヘッドレス環境ではGPUへのアクセスが制限されているか存在しません。

私たちの開発者はこの可能性をまだ調査中です。 WebGLをサポートしたIronPDFを導入する必要がある場合は、ご検討ください:

1.コンテナの代わりにVMまたは専用サーバーを使用する。 2.WebGLレンダリングがGPU対応ホスト上で行われるマイクロサービスアーキテクチャの実装 3.可能であれば、WebGLコンテンツを静止画像にプリレンダリングする。

WebGLを必要としない標準的なDockerのデプロイについては、Dockerインストールガイドを参照してください。 Docker WebGLのサポートについて結論が出たら通知を希望される方は、support@ironsoftware.comまでご連絡ください。

WebGLレンダリングのトラブルシューティング

WebGLレンダリングで問題が発生した場合:

1.GPUの可用性を確認する: システムに互換性のあるGPUがあり、ドライバが更新されていることを確認してください。 2.Chromeの依存関係を確認する:WebGLは特定のChromeコンポーネントを必要とします。 Chrome依存関係のトラブルシューティングガイドをご覧ください。 3.レンダリング遅延を調整する:複雑な WebGL シーンでは、より長い遅延が必要になることがあります。 3000~10000ミリ秒の間で実験してください。 4.メモリ使用量を監視する:WebGL のレンダリングはメモリを消費します。十分なシステムリソースを確保してください。

問題が解決しない場合は、パフォーマンス最適化ガイドを参照するか、エンジニアリング サポート リクエストを送信してください。

高度な WebGL レンダリング テクニック

より複雑なWebGLのシナリオについては、IronPDFのレンダリング機能と追加オプションを組み合わせてください:

  • カスタムビューポートサイズビューポートとズームの設定を使用して、WebGL コンテンツの特定の部分をキャプチャします。
  • 複数のページキャプチャ:大規模な WebGL ビジュアライゼーションの場合、複数のビューをキャプチャし、PDFをマージすることを検討してください。
  • 後処理圧縮を適用して、グラフィックの多い PDF のファイルサイズを縮小します。

次に何ができるのかを見てみましょうか? チュートリアルのページはこちらをご覧ください:追加機能. HTML to PDFの詳細については、包括的なHTML to PDFチュートリアルをご覧ください。

よくある質問

WebGLとは何ですか?なぜPDFに変換するのが難しいのですか?

WebGLは、Webブラウザ内でインタラクティブな3Dグラフィックスを作成するための強力なツールです。WebGLをPDFに変換することは、動的でGPUで加速されたグラフィックをキャプチャし、静的なフォーマットに変換することを含むため、困難です。IronPDFは、適切なGPUアクセスとレンダリングパイプラインとPDF生成間の同期を可能にする特別な設定オプションを提供することでこの課題に対処します。

IronPDFでWebGLレンダリングを有効にするには?

IronPDFでWebGLレンダリングを有効にするには、2つの重要な設定を行う必要があります:SingleProcess=trueに設定して、Chromeが現在のプロセスですべての処理を実行するようにし、ChromeGpuMode=Hardwareに設定してハードウェアアクセラレーションを有効にします。これらの設定により、WebGLコンテンツをレンダリングするための適切なGPUアクセスが保証されます。

どのような種類のWebGLウェブサイトをPDFにレンダリングできますか?

IronPDFはMapboxのようなマッピングサービスやWebGL Samplesコレクションを含む様々なWebGLウェブサイトをレンダリングすることができます。このライブラリのChromeレンダリングエンジンは、複雑な3Dビジュアライゼーション、シェーダー、インタラクティブグラフィックを扱い、静的なPDFフォーマットに保存します。

WebGLをPDFに変換するとき、なぜレンダリング遅延が必要なのですか?

WebGLのコンテンツを変換する際には、レンダリング遅延を設定することをお勧めします。IronPDFではWaitFor.RenderDelay()を設定し、PDF生成が始まる前にWebGLコンテンツが完全にレンダリングされるようにすることができます。

WebGLをPDFにレンダリングするための最小限のワークフローは何ですか?

最小限のワークフローは以下の5ステップです:1) IronPDF C#ライブラリをダウンロードする、2) SingleProcessプロパティをtrueに設定する、3) ChromeGpuModeをHardwareに変更する、4) 適切なレンダリングのためにレンダリング遅延を適用する、5) RenderUrlAsPdf()を使用してWebGLページを変換し、結果を保存する。

IronPDFはWebGLから複雑な3Dグラフィックスやシェーダーをキャプチャできますか?

はい、IronPDFのChromeレンダリングエンジンはWebGLウェブサイトから複雑な3Dビジュアライゼーション、シェーダー、インタラクティブグラフィックをキャプチャして保存することができます。ハードウェアアクセラレーションサポートにより、GPUでレンダリングされたコンテンツは変換プロセス中に適切にキャプチャされます。

カーティス・チャウ
テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

開発以外にも、CurtisはIoT(Internet of Things)への強い関心を持ち、ハードウェアとソフトウェアの統合方法を模索しています。余暇には、ゲームをしたりDiscordボットを作成したりして、技術に対する愛情と創造性を組み合わせています。

準備はできましたか?
Nuget ダウンロード 17,803,474 | バージョン: 2026.3 リリース
Still Scrolling Icon

まだスクロールしていますか?

すぐに証拠が欲しいですか? PM > Install-Package IronPdf
サンプルを実行するHTML が PDF に変換されるのを確認します。