パフォーマンスチューニング
レンダリングとメモリの最適化
Doconut のリソースプロファイルは、レンダー DPI、キャッシュに残るもの、そしてセッションの存続時間の3つが支配しています。このガイドでは、インパクトの順にレバーを説明します。
解像度 — 最大のレバー
ImageResolution (25–300 DPI) は、レンダー時間と画像サイズの両方を左右します。ほとんどのフォーマットはデフォルトで200 DPIです;画像とPSDはデフォルトで100です。
// ドキュメントリストのプレビューは印刷品質を必要としません
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { ImageResolution = 100 });DPI を半分にすると、ページあたりのピクセル数が約4分の1になり、レンダーが速くなり、転送が小さくなり、キャッシュメモリも減ります。ズームが多用されるケース(CAD、エンジニアリング図面)では、250–300 DPI を確保してください。
埋め込み画像が多い PDF では、PdfConfig がより細かい調整を追加します:CompressImages + CompressQuality、ResizeImages + ResizeResolution、そして CompressFast。単純な画像の場合、ImageConfig.MaxImagePixelSize(デフォルト 3000 ピクセル)が出力サイズを上限します。
ページキャッシュ — メモリ vs. 再レンダー
BaseConfig.CachePages(デフォルト true)は、セッションの存続期間中、すべてのレンダー済みページをメモリに保持します。インタラクティブな閲覧に適したデフォルトで、ユーザーは前後にスクロールできます。以下の場合はオフにしてください:
- ドキュメントが非常に大きく、一度だけ前から後ろへ閲覧する場合、
- 多数の同時セッションがキャッシュページを増幅させる場合、
- RAM を保持するよりもビューごとに CPU コストを支払う方が好ましい場合、
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { CachePages = false });クライアント側では、ViewerConfig.CacheEnabled = true がブラウザメモリに次のページ画像の小さな移動ウィンドウを事前読み込みします。これはビューごとのプリフェッチキャッシュであり、永続的な localStorage ではありません。
セッション — 見えないメモリ
開かれたすべてのセッションは、解析されたドキュメントモデルと(CachePages を使用して)レンダーされたページを保持し、スライディング TimeOut(デフォルト 60 分)が 最後のリクエストから 経過するまで保持します。この状態を管理するための2つの習慣があります:
- 使い終わったら閉じる。
viewer.CloseDocument(token)はアイドルウィンドウを待たずにエンジンを即座に解放します。 - タイムアウトを適切に設定する。 ユーザーが2分間だけプレビューを見る場合、1時間のセッションは不要です:
var token = await viewer.OpenDocumentAsync(path, new DocOptions { TimeOut = 10 });トレードオフを覚えておいてください:期限切れになるとウィジェットは Document session not found. Please re-open document. を表示します — 実際の読書セッションに合ったタイムアウトを選択してください。
フォーマット別スイッチ
- Excel:
MemoryOptimizationPreferenceは デフォルトでオン であり、非常に大きなブックのレンダー時にメモリフットプリントを削減します — オンのままにするか、メモリを犠牲にしてわずかな速度向上を得たい場合はfalseに設定してください;SheetNames/PrintAreaは重要な部分だけのレンダーを制限します。 - リダイレクトモードは事前コストがかかります:
DefaultRender = falseはオープン時に 全体 のドキュメントを PDF に変換します。これによりネイティブなテキスト検索が可能になりますが、500ページのドキュメントではオープン呼び出しがその変換を伴います — 反射的に有効にしないでください。 - Linux/Docker 上の Word/PPT:フォントが欠如していると、フォールバックのプロービングが遅くなり、メトリクスが誤ります;
FontFoldersをフォントが入ったディレクトリに指すようにしてください。 - Linux 上のプレゼンテーション:
libgdiplusやSystem.Drawing.EnableUnixSupportスイッチは不要です — Linux のフォント を参照してください。
クライアント側戦略
LargeDoc = true— 非常に大きなドキュメント向けの遅延ロード戦略;ユーザーが近づくとページがロードされます。AutoLoad = false(デフォルト) — 実際にView(token)を呼び出すまでレンダーしません。ShowThumbs = false— 単一ページまたは埋め込みプレビューの場合、サムネイル生成/リクエストをスキップします。FixedZoomを有効にすると、自由形式のズーム変更を回避できます;C# のViewerConfigをマッピングする際は、小画面向けにFixedZoomPercentMobile(C# デフォルト 75)を調整してください。
起動は一度だけ、リクエストごとではなく
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance) は Program.cs に属します — リクエストごとにエンコーディングを登録するのは無駄な作業です;完全に忘れるとレガシーのコードページドキュメントが壊れます。
ノード間で作業を分散する
上記のすべては、オンデマンドで単一ノードのレンダーを調整します。単一ノードが負荷を吸収できない場合、次のレバーは大きなダイヤルではなく、ドキュメントのアーティファクトを共有ストレージに一度公開し、すべてのノードがそれを提供することです。これによりコストモデルが変わります:レンダーはセッションごとではなくドキュメントごとに一度だけ行われ、ページリクエストはファイル読み取りになります。分散デプロイ を参照してください。
チューニングチェックリスト
- ユーザーエクスペリエンスが受け入れる最低の
ImageResolutionを設定してください。 - インタラクティブな閲覧のために
CachePagesをオンに保ち、ワンパスまたは高同時性シナリオではオフにしてください。 - セッションを明示的に閉じ、使用がバースト的な場合は
TimeOutを短くしてください。 - 大きなドキュメントの場合、クライアントで
LargeDocとデフォルトのAutoLoad = falseを使用してください。 - テキストを含む PDF 投影が必要なときだけ
DefaultRender = falseを使用してください。
このページは役に立ちましたか?