高度なページコンテンツ API

PageObjectInfo は、ハンドル、オブジェクト型、通常および回転後の境界、実効マトリックス、アクティブ状態、透過性、塗りと線の色、アルファ値、線幅、線接合、線端、破線配列、破線位相を含む 1 つの TPdfPageObjectInfo スナップショットを返します

HasRotatedBounds、HasActiveState、その他の Has* フィールドは、利用できないネイティブ値と有効なゼロ値を区別します

RotatedBounds は回転後の四角形を保持し、HasLineJoin と HasLineCap は接合と端点のスタイルの有無を示し、DashPhase は破線パターンの開始位置をオフセットします

UpdatePageObject は選択されたすべてのフィールドを同じネイティブオブジェクトに適用し、ページコンテンツを 1 回だけ再生成します

TransformPageObject はアフィン FS_MATRIX を選択されたオブジェクトと合成します

• PathInfo はすべてのパスセグメントの塗りモード、線の状態、セグメント種別、終点、閉じ状態を返します
• PageObjectClipPath はページオブジェクトに関連付けられたすべてのクリップサブパスとセグメントを返します
• TransformPageObjectClipPath(Index, Matrix) はそのクリップジオメトリだけを変換し、ページオブジェクトのマトリックスは変更しません
• FormObjectChildren は Form XObject の直接の子に対する詳細なスナップショットを返します
• DetachFormObjectChild(FormIndex, ChildIndex) は 1 つの子を取り除き、返される FPDF_PAGEOBJECT の所有権を呼び出し側へ移します。呼び出し側はそれを挿入するか破棄しなければなりません

• PageObjectMarks、PageObjectMarkedContentID、AddPageObjectMark、SharePageObjectMark、SetPageObjectMarkParam、RemovePageObjectMarkParam、RemovePageObjectMark は、無関係なプロパティを置き換えることなくマーク付きコンテンツの関連付けを検査、再利用、更新します
• TextObjectGlyphOutline はグリフパスのジオメトリを公開し、TextObjectGlyphWidth(Index, GlyphIndex, FontSize) は要求されたサイズでのネイティブなグリフアドバンスを返します
• TextObjectFontSize(Index) はネイティブなテキストオブジェクトのサイズを読み取り、SetTextObjectFontSize(Index, FontSize) はマトリックス変換による近似なしでそれを編集します
• GetImageObjectRenderedBitmap(Index) は、画像マスク、色変換、イメージマトリックスが PDFium によって適用された、呼び出し側所有のビットマップを返します
• AnnotationObjectCount、AnnotationObjectInfo、AddPathToAnnotation、RemoveAnnotationObject は注釈アピアランスオブジェクトを操作します
• IsAnnotationObjectSubtypeSupported(Subtype) は、読み込まれた PDFium モジュールがそのサブタイプに対するアピアランスオブジェクトの抽出、更新、削除をサポートするかどうかを調べます
• PerformNamedAction は既知のドキュメントアクションをディスパッチし、OnNamedAction は名前付きアクションのコールバックを報告します

CharacterInfo は塗りと線の色、フォント名、PDF フォントフラグ、ルーズなグリフ境界、実効マトリックス、および関連するテキストオブジェクトのハンドルを返します

CharacterIndexToTextIndex と TextIndexToCharacterIndex は、PDFium の文字インデックスと生成されたテキストストリームのインデックスの間を相互変換します

TPdfAnnotation は HasBorder、BorderHorizontalRadius、BorderVerticalRadius、BorderWidth を通じて境界線の半径と幅を公開します

色の対応範囲は ColorAlpha、InteriorColor、InteriorColorAlpha に及びます。マークアップメタデータは HasAuthor、HasName、HasSubject、HasModificationDate、HasCreationDate、HasIcon で判定され、インクジェスチャ、四分点ジオメトリ、リンクターゲットは InkList、HasAttachmentPoints、HasLinkUri、LinkUri で公開されます

通常、ロールオーバー、押下の各アピアランスストリームは、HasAppearanceNormal、HasAppearanceRollover、HasAppearanceDown のセンチネルと、それに対応する AppearanceNormal、AppearanceRollover、AppearanceDown の各文字列を通じて利用できます

注釈の読み込み時、これらのセンチネルは空でないアピアランスコンテンツを識別します。ネイティブ API はストリームが存在しない場合と空の場合に同じ空文字列を返すため、どちらも False と報告され、レコードの書き戻し時には変更されずに残ります。空のアピアランスを書き込みたいときは、センチネルに明示的に True を設定できます

更新した注釈レコードを Annotation[Index] に代入し直すと、選択した境界またはアピアランスの値が書き込まれます

• ConfigurePdfLibrary、GetPdfLibraryConfiguration、PdfLibraryConfigurationSealed は、最初の読み込みの前に、不変のプロセス全体ネイティブ初期化とサンドボックスポリシーを構成し監査します
• TPdfLibraryConfiguration は UserFontPaths、V8Isolate、V8EmbedderSlot、V8Platform、Renderer、FontBackend、BrotliEnabled、IsolatePerDocument、AllowMachineTime を保持し、TPdfRendererPreference (prpDefault、prpAgg、prpSkia) と TPdfFontBackendPreference (pfbpDefault、pfbpFreeType、pfbpFontations) を使って、要求された構成に必要なネイティブフィールドだけを選択します
• PdfDefaultTtfMapCount と TryGetPdfDefaultTtfMapEntry は、チェック付きのインデックスアクセスでネイティブのデフォルトフォント置換を列挙します
• TPdfDefaultTtfMapEntry は、1 つのインデックス指定マッピングエントリからフェース名、文字セット、ネイティブプラットフォームフォントのメタデータをコピーします
• FormFieldZOrderAtPoint と LinkZOrderAtPoint は最前面のネイティブ z-order を返し、対象が存在しない場合は -1 を返します
• TryGetAnnotationFileAttachment は、ネイティブな注釈ハンドルが有効な間、上限付きでファイルのメタデータとペイロードをコピーします
• TPdfAnnotationAttachment は、コピーされたメタデータとペイロードをページや注釈のハンドルから独立して所有します
• GetLinkedAnnotationIndex と GetLinkedAnnotationChain は、参照切れ、循環、深度の保護を備えながら Popup と IRT の関係を解決します
• TPdfAnnotationRelationship は Popup (parPopup) または IRT (parInReplyTo) の関係を選択し、TPdfAnnotationSubtypes はフォーカスポリシーのサブタイプ配列を保持します
• GetAnnotationDictionaryValue と GetAttachmentDictionaryValue は、サポートされたスカラー値を返す前に、正確なネイティブ値の種類を報告します
• TPdfDictionaryValueKind はネイティブオブジェクトのカテゴリ (pdvkUnknown、pdvkBoolean、pdvkNumber、pdvkString、pdvkName、pdvkArray、pdvkDictionary、pdvkStream、pdvkNull、pdvkReference) を保持し、TPdfDictionaryValue はサポートされた数値または文字列のスカラーを NumberValue と StringValue に保持し、HasScalarValue が明示的なセンチネルになります
• SetFocusableAnnotationSubtypes と GetFocusableAnnotationSubtypes は、ネイティブフォームハンドルを通じてキーボードフォーカスの対象可否を制御します
• TPdfStructureElement.Attributes は TPdfStructureAttributeValues のフラットツリーで、その TPdfStructureAttributeValue ノードは AttributeIndex によって所有する属性辞書に結び付き、型付きの入れ子値と BlobValue の可逆 blob を保持します
• TPdfView.FormFieldZOrderAt、TPdfView.LinkZOrderAt、TPdfView.ReplaceFormTextAndKeepSelection は、対応する座標変換と選択を保持するフォーム操作をビジュアルコントロール経由で公開します

• ThumbnailRawData はフィルターデコード前の埋め込みサムネイルストリームを返します
• ThumbnailDecodedData はフィルターデコード後の埋め込みサムネイルストリームを返します
• TransformPageContent はすべてのページオブジェクトを変換してクリップし、ページを再生成して派生ハンドルを再読み込みします
• TransformPageAnnotations は同じアフィン座標モデルを現在のページのすべての注釈に適用します

RenderPageWithMatrix は可逆な FS_MATRIX とデバイス座標でのクリッピング矩形を受け取ります

呼び出し側所有の TBitmap を受け取るオーバーロードは、互換性のある 32 ビット DIB へ直接レンダリングし、外部 PDFium ビットマップを作成できない場合にのみ 1 回のコピーへフォールバックします

マトリックスレンダリングは、レンダリングフラグで選択されたページコンテンツと非対話の注釈を描画しますが、フォームフィルオーバーレイレンダラーは呼び出しません