Geavanceerde pagina-content-API's - TPdf

Component: TPdf · Unit: PDFium

Inspecteert en bewerkt native pagina-inhoud zonder dat toepassingen PDFium-handles of bitmapbuffers hoeven te beheren

Page object inspection

PageObjectInfo geeft één TPdfPageObjectInfo-snapshot terug met de handle, objecttype, normale en gedraaide bounds, effectieve matrix, actieve status, transparantie, vul- en lijnkleuren, alpha-waarden, lijndikte, line join, line cap, dash-array en dash-fase

HasRotatedBounds, HasActiveState en de andere Has*-velden onderscheiden een niet-beschikbare native waarde van een geldige nulwaarde

RotatedBounds draagt de gedraaide vierhoek, HasLineJoin en HasLineCap schermen de join- en cap-stijlen af, en DashPhase verschuift het begin van het dash-patroon

Batched page object editing

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 past elk geselecteerd veld toe op hetzelfde native object en regenereert de pagina-inhoud één keer

TransformPageObject composeert een affiene FS_MATRIX met het geselecteerde object

Paths, clip paths, and Form XObjects

PathInfo geeft vulmodus, stroke-status, segmenttype, eindpunt en sluitstatus voor elk padsegment terug
PageObjectClipPath geeft elk clip-subpad en elke segment terug die bij een page-object horen
TransformPageObjectClipPath(Index, Matrix) transformeert alleen die clip-geometrie en laat de page-objectmatrix ongewijzigd
FormObjectChildren geeft gedetailleerde snapshots terug voor de directe kinderen van een Form XObject
DetachFormObjectChild(FormIndex, ChildIndex) verwijdert één kind en draagt het eigendom van de teruggegeven FPDF_PAGEOBJECT over aan de aanroeper, die het moet invoegen of vernietigen

Content marks, glyphs, and native object helpers

PageObjectMarks, PageObjectMarkedContentID, AddPageObjectMark, SharePageObjectMark, SetPageObjectMarkParam, RemovePageObjectMarkParam en RemovePageObjectMark inspecteren, hergebruiken en werken marked-content-koppelingen bij zonder ongerelateerde eigenschappen te vervangen
TextObjectGlyphOutline stelt de glyph-pad-geometrie bloot, terwijl TextObjectGlyphWidth(Index, GlyphIndex, FontSize) de native glyph-advance op de gevraagde grootte teruggeeft
TextObjectFontSize(Index) leest de native tekstobjectgrootte en SetTextObjectFontSize(Index, FontSize) bewerkt die zonder benadering via een matrixtransformatie
GetImageObjectRenderedBitmap(Index) geeft een bitmap in eigendom van de aanroeper terug waarin het afbeeldingsmasker, de kleurconversie en de afbeeldingsmatrix door PDFium zijn toegepast
AnnotationObjectCount, AnnotationObjectInfo, AddPathToAnnotation en RemoveAnnotationObject werken op annotatie-appearance-objecten
IsAnnotationObjectSubtypeSupported(Subtype) test of de geladen PDFium-module appearance-objectextractie, -bijwerking en -verwijdering voor het subtype ondersteunt
PerformNamedAction voert een bekende documentactie uit en OnNamedAction rapporteert named-action-callbacks

Character inspection and index mapping

CharacterInfo geeft vul- en lijnkleuren, fontnaam, PDF-fontvlaggen, losse glyph-bounds, effectieve matrix en de bijbehorende tekstobjecthandle terug

CharacterIndexToTextIndex en TextIndexToCharacterIndex converteren tussen PDFium-tekenindexen en indexen in de gegenereerde tekststroom

Annotation borders and appearance streams

TPdfAnnotation stelt border-radii en breedte bloot via HasBorder, BorderHorizontalRadius, BorderVerticalRadius en BorderWidth

Kleurdekking strekt zich uit tot ColorAlpha, InteriorColor en InteriorColorAlpha, markup-metadata wordt afgeschermd door HasAuthor, HasName, HasSubject, HasModificationDate, HasCreationDate en HasIcon, en ink-gebaren, quad-point-geometrie en linkdoelen worden blootgesteld via InkList, HasAttachmentPoints, HasLinkUri en LinkUri

Normale, rollover- en down-appearance-streams zijn beschikbaar via de sentinels HasAppearanceNormal, HasAppearanceRollover en HasAppearanceDown en hun bijbehorende strings AppearanceNormal, AppearanceRollover en AppearanceDown

Bij het lezen van een annotatie identificeren deze sentinels niet-lege appearance-inhoud: de native API geeft voor een ontbrekende stream en een lege stream dezelfde lege string terug, dus beide rapporteren False en blijven onaangetast wanneer het record wordt teruggeschreven; aanroepers kunnen een sentinel nog steeds expliciet op True zetten om een lege appearance weg te schrijven

Wijs het bijgewerkte annotatierecord terug toe aan Annotation[Index] om geselecteerde border- of appearance-waarden weg te schrijven

Native library, annotation, and form diagnostics

ConfigurePdfLibrary, GetPdfLibraryConfiguration en PdfLibraryConfigurationSealed configureren en auditen het onveranderlijke procesbrede native initialisatie- en sandboxbeleid vóór de eerste load
TPdfLibraryConfiguration draagt UserFontPaths, V8Isolate, V8EmbedderSlot, V8Platform, Renderer, FontBackend, BrotliEnabled, IsolatePerDocument en AllowMachineTime, en gebruikt TPdfRendererPreference (prpDefault, prpAgg, prpSkia) en TPdfFontBackendPreference (pfbpDefault, pfbpFreeType, pfbpFontations) om alleen de native velden te selecteren die de gevraagde configuratie nodig heeft
PdfDefaultTtfMapCount en TryGetPdfDefaultTtfMapEntry sommeren native standaardfontvervangingen op met gecontroleerde geïndexeerde toegang
TPdfDefaultTtfMapEntry kopieert de facenaam, charset en native platformfont-metadata uit één geïndexeerd toewijzingsitem
FormFieldZOrderAtPoint en LinkZOrderAtPoint geven de voorste native z-order terug of -1 wanneer er geen doel bestaat
TryGetAnnotationFileAttachment kopieert begrensde bestandsmetadata en payload zolang de native annotatiehandle geldig is
TPdfAnnotationAttachment is eigenaar van die gekopieerde metadata en payload, onafhankelijk van de pagina- en annotatiehandles
GetLinkedAnnotationIndex en GetLinkedAnnotationChain lossen Popup- en IRT-relaties op met bescherming tegen hangende verwijzingen, cycli en diepte
TPdfAnnotationRelationship kiest de Popup-relatie (parPopup) of de IRT-relatie (parInReplyTo) en TPdfAnnotationSubtypes bewaart de subtypearray van het focusbeleid
GetAnnotationDictionaryValue en GetAttachmentDictionaryValue rapporteren de exacte native waardesoort voordat een ondersteunde scalaire waarde wordt teruggegeven
TPdfDictionaryValueKind behoudt de native objectcategorie (pdvkUnknown, pdvkBoolean, pdvkNumber, pdvkString, pdvkName, pdvkArray, pdvkDictionary, pdvkStream, pdvkNull, pdvkReference) en TPdfDictionaryValue draagt de ondersteunde getal- of string-scalair in NumberValue en StringValue met HasScalarValue als expliciete sentinel
SetFocusableAnnotationSubtypes en GetFocusableAnnotationSubtypes sturen keyboard-focusgeschiktheid via de native form-handle
TPdfStructureElement.Attributes is een vlakke TPdfStructureAttributeValues-boom waarvan de TPdfStructureAttributeValue-knooppunten via AttributeIndex teruggrijpen op hun eigen attributenwoordenboek en getypeerde geneste waarden en verliesvrije blobs in BlobValue bewaren
TPdfView.FormFieldZOrderAt, TPdfView.LinkZOrderAt en TPdfView.ReplaceFormTextAndKeepSelection stellen de bijbehorende coördinaatconversie en de selectiebehoudende formulierbewerkingen bloot via de visuele control

Thumbnails and affine page transforms

ThumbnailRawData geeft de ingesloten thumbnail-stream vóór filterdecoding terug
ThumbnailDecodedData geeft de ingesloten thumbnail-stream ná filterdecoding terug
TransformPageContent transformeert en clipst alle page-objecten, regenereert de pagina en herlaadt de afgeleide handles
TransformPageAnnotations past hetzelfde affiene coördinaatmodel toe op alle annotaties op de huidige pagina

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 accepteert een inverteerbare FS_MATRIX en een cliprechthoek in apparaatcoördinaten

De overload die een TBitmap in eigendom van de aanroeper ontvangt, rendert direct in een compatibele 32-bit DIB en valt slechts terug op één kopie wanneer geen externe PDFium-bitmap kan worden aangemaakt

Matrix-rendering tekent pagina-inhoud en niet-interactieve annotaties die via rendervlaggen zijn geselecteerd, maar roept de form-fill-overlayrenderer niet aan