Fortgeschrittene Seiteninhalt-APIs - TPdf

Komponente: TPdf · Unit: PDFium

Prüft und bearbeitet nativen Seiteninhalt, ohne dass Anwendungen PDFium-Handles oder Bitmap-Puffer verwalten müssen

Prüfung von Seitenobjekten

PageObjectInfo gibt einen TPdfPageObjectInfo-Schnappschuss zurück, der Handle, Objekttyp, normale und gedrehte Begrenzungen, effektive Matrix, Aktivzustand, Transparenz, Füll- und Strichfarben, Alpha-Werte, Strichbreite, Line-Join, Line-Cap, Dash-Array und Dash-Phase enthält

HasRotatedBounds, HasActiveState und die anderen Has*-Felder unterscheiden einen nicht verfügbaren nativen Wert von einem gültigen Nullwert

RotatedBounds trägt das gedrehte Viereck, HasLineJoin und HasLineCap schalten die Join- und Cap-Stile frei, und DashPhase verschiebt den Start des Dash-Musters

Stapelweise Seitenobjekt-Bearbeitung

Info := Pdf1.PageObjectInfo(0);
Info.StrokeWidth := 4;
SetLength(Info.DashArray, 2);
Info.DashArray[0] := 8;
Info.DashArray[1] := 4;
Pdf1.UpdatePageObject(0, Info, [pocStrokeWidth, pocDashPattern]);

UpdatePageObject wendet jedes ausgewählte Feld auf dasselbe native Objekt an und erzeugt den Seiteninhalt einmal neu

TransformPageObject kombiniert eine affine FS_MATRIX mit dem ausgewählten Objekt

Pfade, Clip-Pfade und Form-XObjects

PathInfo gibt Füllmodus, Strichzustand, Segmenttyp, Endpunkt und Schließzustand für jedes Pfadsegment zurück
PageObjectClipPath gibt jeden Clip-Teilpfad und jedes Segment zurück, die einem Seitenobjekt zugeordnet sind
TransformPageObjectClipPath(Index, Matrix) transformiert nur diese Clip-Geometrie und lässt die Matrix des Seitenobjekts unverändert
FormObjectChildren gibt detaillierte Schnappschüsse der unmittelbaren Kinder eines Form-XObjects zurück
DetachFormObjectChild(FormIndex, ChildIndex) entfernt ein Kind und überträgt das Eigentum am zurückgegebenen FPDF_PAGEOBJECT an den Aufrufer, der es einfügen oder zerstören muss

Inhalts-Marks, Glyphen und Helfer für native Objekte

PageObjectMarks, PageObjectMarkedContentID, AddPageObjectMark, SharePageObjectMark, SetPageObjectMarkParam, RemovePageObjectMarkParam und RemovePageObjectMark prüfen, wiederverwenden und aktualisieren Marked-Content-Zuordnungen, ohne unabhängige Eigenschaften zu ersetzen
TextObjectGlyphOutline legt die Glyphenpfad-Geometrie offen, während TextObjectGlyphWidth(Index, GlyphIndex, FontSize) den nativen Glyphenvorschub in der angeforderten Größe zurückgibt
TextObjectFontSize(Index) liest die native Textobjektgröße, und SetTextObjectFontSize(Index, FontSize) bearbeitet sie, ohne über eine Matrix-Transformation zu approximieren
GetImageObjectRenderedBitmap(Index) gibt eine Bitmap im Eigentum des Aufrufers zurück, bei der Bildmaske, Farbumwandlung und Bildmatrix von PDFium angewendet wurden
AnnotationObjectCount, AnnotationObjectInfo, AddPathToAnnotation und RemoveAnnotationObject arbeiten auf Erscheinungsbild-Objekten von Anmerkungen
IsAnnotationObjectSubtypeSupported(Subtype) testet, ob das geladene PDFium-Modul Extraktion, Aktualisierung und Entfernung von Erscheinungsbild-Objekten für den Subtyp unterstützt
PerformNamedAction löst eine bekannte Dokumentaktion aus, und OnNamedAction meldet Named-Action-Callbacks

Zeichenprüfung und Indexabbildung

CharacterInfo gibt Füll- und Strichfarben, den Schriftartnamen, PDF-Font-Flags, lose Glyphengrenzen, die effektive Matrix und das zugeordnete Textobjekt-Handle zurück

CharacterIndexToTextIndex und TextIndexToCharacterIndex wandeln zwischen PDFium-Zeichenindizes und Indizes im erzeugten Textstrom um

Anmerkungs-Rahmen und Appearance-Streams

TPdfAnnotation legt Rahmenradien und -breite über HasBorder, BorderHorizontalRadius, BorderVerticalRadius und BorderWidth offen

Die Farbabdeckung umfasst ColorAlpha, InteriorColor und InteriorColorAlpha, Markup-Metadaten werden von HasAuthor, HasName, HasSubject, HasModificationDate, HasCreationDate und HasIcon geschützt, und Tintengesten, Vierecksgeometrie und Linkziele werden über InkList, HasAttachmentPoints, HasLinkUri und LinkUri offengelegt

Normale, Rollover- und Down-Appearance-Streams sind über die Sentinel-Werte HasAppearanceNormal, HasAppearanceRollover und HasAppearanceDown sowie die zugehörigen Strings AppearanceNormal, AppearanceRollover und AppearanceDown verfügbar

Beim Lesen einer Annotation melden diese Sentinel-Werte nicht leeren Appearance-Inhalt: Die native API liefert für einen fehlenden Stream und einen leeren Stream dieselbe leere Zeichenkette, daher melden beide False und bleiben beim Zurückschreiben des Records unangetastet; ein Sentinel lässt sich weiterhin ausdrücklich auf True setzen, um eine leere Appearance zu schreiben

Weisen Sie den aktualisierten Anmerkungs-Record wieder Annotation[Index] zu, um ausgewählte Rahmen- oder Appearance-Werte zu schreiben

Diagnose für native Bibliothek, Anmerkungen und Formulare

ConfigurePdfLibrary, GetPdfLibraryConfiguration und PdfLibraryConfigurationSealed konfigurieren und auditieren die unveränderliche prozessweite native Initialisierungs- und Sandbox-Richtlinie vor dem ersten Laden
TPdfLibraryConfiguration trägt UserFontPaths, V8Isolate, V8EmbedderSlot, V8Platform, Renderer, FontBackend, BrotliEnabled, IsolatePerDocument und AllowMachineTime und verwendet TPdfRendererPreference (prpDefault, prpAgg, prpSkia) und TPdfFontBackendPreference (pfbpDefault, pfbpFreeType, pfbpFontations), um nur die nativen Felder auszuwählen, die die angeforderte Konfiguration benötigt
PdfDefaultTtfMapCount und TryGetPdfDefaultTtfMapEntry zählen native Standard-Schriftartersetzungen mit geprüftem Indexzugriff auf
TPdfDefaultTtfMapEntry kopiert Face-Name, Zeichensatz und native Plattform-Schriftartmetadaten aus einem indizierten Zuordnungseintrag
FormFieldZOrderAtPoint und LinkZOrderAtPoint geben die vorderste native Z-Ordnung oder -1 zurück, wenn kein Ziel existiert
TryGetAnnotationFileAttachment kopiert begrenzte Dateimetadaten und Nutzdaten, solange das native Anmerkungs-Handle gültig ist
TPdfAnnotationAttachment besitzt diese kopierten Metadaten und Nutzdaten unabhängig von den Seiten- und Anmerkungs-Handles
GetLinkedAnnotationIndex und GetLinkedAnnotationChain lösen Popup- und IRT-Beziehungen mit Schutz vor hängenden Verweisen, Zyklen und übermäßiger Tiefe auf
TPdfAnnotationRelationship wählt die Popup-Beziehung (parPopup) oder die IRT-Beziehung (parInReplyTo), und TPdfAnnotationSubtypes speichert das Subtyp-Array der Fokus-Richtlinie
GetAnnotationDictionaryValue und GetAttachmentDictionaryValue melden die exakte native Wertart, bevor ein unterstützter Skalarwert zurückgegeben wird
TPdfDictionaryValueKind bewahrt die native Objektkategorie (pdvkUnknown, pdvkBoolean, pdvkNumber, pdvkString, pdvkName, pdvkArray, pdvkDictionary, pdvkStream, pdvkNull, pdvkReference), und TPdfDictionaryValue trägt den unterstützten Zahlen- oder String-Skalar in NumberValue und StringValue, mit HasScalarValue als explizitem Sentinel
SetFocusableAnnotationSubtypes und GetFocusableAnnotationSubtypes steuern die Tastaturfokus-Eignung über das native Formular-Handle
TPdfStructureElement.Attributes ist ein flacher TPdfStructureAttributeValues-Baum, dessen TPdfStructureAttributeValue-Knoten über AttributeIndex an ihr besitzendes Attributwörterbuch zurückgebunden sind und typisierte verschachtelte Werte sowie verlustfreie Blobs in BlobValue bewahren
TPdfView.FormFieldZOrderAt, TPdfView.LinkZOrderAt und TPdfView.ReplaceFormTextAndKeepSelection stellen die passenden Koordinatenumwandlungen und die auswahlbewahrenden Formularoperationen über das visuelle Steuerelement bereit

Miniaturansichten und affine Seitentransformationen

ThumbnailRawData gibt den eingebetteten Miniaturansichten-Stream vor der Filter-Dekodierung zurück
ThumbnailDecodedData gibt den eingebetteten Miniaturansichten-Stream nach der Filter-Dekodierung zurück
TransformPageContent transformiert und beschneidet alle Seitenobjekte, erzeugt die Seite neu und lädt ihre abgeleiteten Handles neu
TransformPageAnnotations wendet dasselbe affine Koordinatenmodell auf alle Anmerkungen der aktuellen Seite an

Matrix-Rendering

Matrix.a := 0.5;
Matrix.b := 0;
Matrix.c := 0;
Matrix.d := -0.5;
Matrix.e := 0;
Matrix.f := 421;
Clip.Left := 0;
Clip.Top := 0;
Clip.Right := 300;
Clip.Bottom := 421;
Bitmap := Pdf1.RenderPageWithMatrix(300, 421, Matrix, Clip);

RenderPageWithMatrix akzeptiert eine invertierbare FS_MATRIX und ein Clipping-Rechteck in Gerätekoordinaten

Die Überladung, die eine TBitmap im Eigentum des Aufrufers entgegennimmt, rendert direkt in eine kompatible 32-Bit-DIB und fällt nur dann auf eine Kopie zurück, wenn keine externe PDFium-Bitmap erzeugt werden kann

Matrix-Rendering zeichnet Seiteninhalt und nicht interaktive Anmerkungen, die über Render-Flags ausgewählt wurden, ruft jedoch den Form-Fill-Overlay-Renderer nicht auf