オプションコンテンツのビューアステート

ネイティブラスタライズは、ISO 32000-1:2008 セクション 8.11.4.4 と 8.11.4.5 の、ビューアスタイルのオプションコンテンツ推奨を明示的に適用できます

デフォルトのオプションは ViewerState=nil のまま、注釈の両方の使用でスタンドアロンの最終形 D 動作を保持し、AS を自動適用しません

Access := Document.GetRenderAccess(0);
Context := THPDFOptionalContentContext.Default;
Context.Zoom := 2;
Context.Language := 'en-US';
Viewer := THPDFHeadlessOptionalContentState.Create(Access, Context);
try
  Viewer.SetGroupState(10, 0, True);
  Options := THPDFHeadlessRenderOptions.Default;
  Options.ViewerState := Viewer;
  Viewer.Event := hocePrint;
  Options.Usage := hruPrint;
  HPDFRenderHeadlessPagePNGFile(Access, OutputFile, Options);
finally
  Viewer.Free;
end;

View は D を初期化し、一致する View 適用を適用してから手動上書きを適用します。Print や Export の適用はその操作の間だけ現在の推奨を置き換え、ステートオブジェクトや PDF ディクショナリは変更しません

一致する適用とカテゴリ全体で、アクティブな推奨がすべて ON でなければグループは ON になりません。使用情報がない場合は推奨が提供されず、そのグループの現在状態が保持されます

サポートされるカテゴリは View、Print、Export、Zoom、Language、User です。CreatorInfo と PageElement は情報提供のままです

Zoom は包含的最小値と排他的最大値を使い、少なくとも 1 つの境界が要求され、デフォルトはゼロと無限大です。Language はアプリケーションの OCG 内で、大文字小文字を区別しない完全一致のタグを優先し、なければ Preferred ON の主要言語グループに一致します

User は、明示的に供給された Individual、Title、Organization を、完全一致の Unicode テキストで文字列または名前の配列と比較します。PDFDocEncoding、UTF-16、PDF 2.0 の UTF-8 テキスト文字列は、デコードされた意味を保持します

OCG を省略した適用はデフォルトで空のグループ集合になります。既存 Print 使用ディクショナリから PrintState が省略されると推奨は提供されません

AS はカテゴリを同名イベントに限定しないため、Print 適用は同じ明示的コンテキストで Zoom や Language の推奨を適用し得ます

OCMD ポリシー、再帰的な VE 式、ネストしたマーク付きコンテンツ、Form XObject、画像、注釈外観は、既存の上限付き可視性パスを通じて結果のグループ状態を消費します

手動変更は、クリアまたは元に戻されるまでコンテキスト変更をまたいで保持されます。ドキュメントの再ロード、変更、クローズ、破棄はステートを永久に失効させ、新しいアクセスと新しいオブジェクトが必要です

各レンダリングの間、借り受けたステートを生かしたまま変更しないでください。基盤アダプタのコールバック並行性契約が有効である限り、読み取り専用の再利用は許可されます

レンダリング作業、グループ検索、言語候補スキャン、手動選択検索、上限付きの 16 進・UTF-8 テキストデコード、一時ステート格納は、操作・トークン・デコードバイト・作業バイト・キャンセルの各上限に参加します

SetGroupState は呼び出し側駆動のステートコンテナ操作で、選択容量は 100000 です。レンダリング上限は消費を独立して制限します。アプリケーションは外部からの選択要求に適切な上限を課すべきです

ビューアイベントは注釈の Usage から独立しています。どちらのオプションも印刷権限を与えず、SetOCGState アクションを実行せず、リッチメディアを有効化せず、ユーザーインターフェイスも作りません

受け入れは、独立して宣言されたステートと正確な RGB 矩形マスク、生存期間と変更のテスト、再入可能・直列化コールバックによる並行レンダリング、MuPDF と Poppler の別々の観察を使います

リーダのデフォルトコンテキスト観察は、明示的なネイティブの Zoom・Language・User・手動ステートの式の代わりにはなりません。プレーンな幾何コンパニオンがラスタ座標を独立して検証します

Linux バージョン付き JSON 操作

{
  "schemaVersion": 1,
  "type": "render",
  "dpi": 72,
  "usage": "view",
  "optionalContent": {
    "event": "print",
    "zoom": 2,
    "language": "en-US",
    "individual": "Alice",
    "title": "Engineer",
    "organization": "Example",
    "selections": [
      {"objectNumber": 10, "generationNumber": 0, "enabled": true}
    ]
  }
}

optionalContent を省略すると静的な D 動作が保持されます。オブジェクトがあると、デフォルトの View イベント、ズーム 1、空の言語・ユーザーコンテキスト文字列で自動ステートが有効になります

イベントは view、print、export を受け付け、注釈の usage から独立しています。OS の言語、ユーザー ID、表示ズームは推測されません

コンテキスト文字列はそれぞれ最大 4096 UTF-16 コード単位です。ズームは有限・正・最大 1000000000 でなければなりません

選択は正のオブジェクト番号、0〜65535 の世代番号、明示的な Boolean enabled 値を要求します。操作は作業メモリ上限内で最大 1024 選択を許可し、繰り返し参照は最後に供給された状態を使います

各操作は自身の借り受けネイティブステートを作成・解放するため、後続の要求では希望する手動選択を再送してください。PDF ディクショナリと、このオブジェクトなしの後続レンダリングは以前の設定を保持します

不正な JSON オプションは invalid-argument ステータスを、許可予算の失敗は budget-exceeded ステータスを返します。不正なドキュメントメタデータや陳腐化したグループ参照は、PNG 公開の前に既存のレンダリング解析エラーステータスを保持します

機能は optionalContent.automaticState、3 つのイベント、明示的コンテキストメンバー、手動選択サポート、操作単位の生存期間を報告します

実際のプレーンおよび AES R5/R6 の Language/User ソースは Tests/Linux/Build-LinuxABIOptionalAutomaticFixtures.py OUTPUT で生成し、各ネイティブ ABI ビルドに対して Tests/Linux/Run-LinuxABIOptionalAutomaticAcceptance.sh LIBRARY FIXTURES NEW_OUTPUT を実行してください

コールバック受け入れは、独立したピクセル式、厳格な JSON 型、暗号化、予算、キャンセル、粘着的な出力・結果失敗、同一ハンドル復元、ビューアステート非保持を検査します。pypdf、cryptography、NumPy、Pillow が必要で、デスクトップビューアの起動を抑制します

THPDFHeadlessOptionalContentState、THPDFOptionalContentContext、IHPDFHeadlessRenderLifetime を参照してください