Avancerade API:er för sidinnehåll - TPdf

Component: TPdf · Unit: PDFium

Inspekterar och redigerar nativt sidinnehåll utan att applikationer behöver hantera PDFium-handtag eller bitmapbuffertar

Page object inspection

PageObjectInfo returnerar en TPdfPageObjectInfo-ögonblicksbild som innehåller handtaget, objekttypen, normala och roterade gränser, den effektiva matrisen, aktivt tillstånd, transparens, fyllnads- och strykfärger, alfavärden, strykbredd, line join, line cap, streckarray och streckfas

HasRotatedBounds, HasActiveState och de andra Has*-fälten skiljer ett otillgängligt nativt värde från ett giltigt nollvärde

RotatedBounds bär den roterade fyrhörningen, HasLineJoin och HasLineCap styr join- och kapp-stilarna, och DashPhase förskjuter starten av streckmönstret

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 tillämpar varje valt fält på samma nativa objekt och genererar sidinnehållet om en gång

TransformPageObject komponerar en affin FS_MATRIX med det valda objektet

Paths, clip paths, and Form XObjects

PathInfo returnerar fyllnadsläge, stryktillstånd, segmenttyp, ändpunkt och stängningstillstånd för varje bansegment
PageObjectClipPath returnerar varje clip-underbana och segment som är kopplade till ett sidobjekt
TransformPageObjectClipPath(Index, Matrix) transformerar bara den clip-geometrin och lämnar sidobjektets matris oförändrad
FormObjectChildren returnerar detaljerade ögonblicksbilder för de direkta barnen till ett Form XObject
DetachFormObjectChild(FormIndex, ChildIndex) tar bort ett barn och överför ägarskapet av den returnerade FPDF_PAGEOBJECT till anroparen, som måste infoga eller förstöra den

Content marks, glyphs, and native object helpers

PageObjectMarks, PageObjectMarkedContentID, AddPageObjectMark, SharePageObjectMark, SetPageObjectMarkParam, RemovePageObjectMarkParam och RemovePageObjectMark inspekterar, återanvänder och uppdaterar marked-content-kopplingar utan att ersätta orelaterade egenskaper
TextObjectGlyphOutline exponerar glyphbanans geometri, medan TextObjectGlyphWidth(Index, GlyphIndex, FontSize) returnerar den nativa glyph-advancen vid den begärda storleken
TextObjectFontSize(Index) läser den nativa textobjektstorleken och SetTextObjectFontSize(Index, FontSize) redigerar den utan att approximera via en matristransformering
GetImageObjectRenderedBitmap(Index) returnerar en anroparägd bitmap med bildmasken, färgkonverteringen och bildmatrisen tillämpade av PDFium
AnnotationObjectCount, AnnotationObjectInfo, AddPathToAnnotation och RemoveAnnotationObject arbetar på annoteringars utseendeobjekt
IsAnnotationObjectSubtypeSupported(Subtype) sonderar om det inlästa PDFium-modulen stödjer utseendeobjektextraktion, uppdatering och borttagning för subtypen
PerformNamedAction skickar en känd dokumentåtgärd och OnNamedAction rapporterar callback:ar för namngivna åtgärder

Character inspection and index mapping

CharacterInfo returnerar fyllnads- och strykfärger, typsnittsnamn, PDF-typsnittsflaggor, lösa glyphgränser, den effektiva matrisen och det kopplade textobjektshandtaget

CharacterIndexToTextIndex och TextIndexToCharacterIndex konverterar mellan PDFium:s teckenindex och index i den genererade textströmmen

Annotation borders and appearance streams

TPdfAnnotation exponerar kantradie och bredd via HasBorder, BorderHorizontalRadius, BorderVerticalRadius och BorderWidth

Färgtäckningen sträcker sig till ColorAlpha, InteriorColor och InteriorColorAlpha, markupmetadata styrs av HasAuthor, HasName, HasSubject, HasModificationDate, HasCreationDate och HasIcon, och ink-gestures, quad point-geometri och länkmål exponeras via InkList, HasAttachmentPoints, HasLinkUri och LinkUri

Normal-, rollover- och down-utseendeströmmar finns via sentinelvärdena HasAppearanceNormal, HasAppearanceRollover och HasAppearanceDown och deras matchande strängar AppearanceNormal, AppearanceRollover och AppearanceDown

Vid läsning av en annotering identifierar dessa sentineller icke-tomt utseendeinnehåll: det nativa API:t returnerar samma tomma sträng för en saknad ström som för en tom ström, så båda rapporterar False och lämnas orörda när posten skrivs tillbaka; anroparen kan fortfarande explicit sätta en sentinel till True för att skriva ett tomt utseende

Tilldela den uppdaterade annoteringsposten tillbaka till Annotation[Index] för att skriva valda kant- eller utseendevärden

Native library, annotation, and form diagnostics

ConfigurePdfLibrary, GetPdfLibraryConfiguration och PdfLibraryConfigurationSealed konfigurerar och granskar den oföränderliga, processövergripande nativa initieringen och sandbox-policyn före den första inläsningen
TPdfLibraryConfiguration bär UserFontPaths, V8Isolate, V8EmbedderSlot, V8Platform, Renderer, FontBackend, BrotliEnabled, IsolatePerDocument och AllowMachineTime och använder TPdfRendererPreference (prpDefault, prpAgg, prpSkia) och TPdfFontBackendPreference (pfbpDefault, pfbpFreeType, pfbpFontations) för att välja bara de nativa fält som den begärda konfigurationen behöver
PdfDefaultTtfMapCount och TryGetPdfDefaultTtfMapEntry räknar upp nativa standardtypsnittsersättningar med kontrollerad indexerad åtkomst
TPdfDefaultTtfMapEntry kopierar face-namnet, charset och den nativa plattformstypsnittsmetadatan från en indexerad mappningspost
FormFieldZOrderAtPoint och LinkZOrderAtPoint returnerar den främsta nativa z-ordningen eller -1 när inget mål finns
TryGetAnnotationFileAttachment kopierar avgränsad filmetadata och nyttolast så länge dess nativa annoteringshandtag är giltigt
TPdfAnnotationAttachment äger den kopierade metadata och nyttolasten oberoende av sid- och annoteringshandtagen
GetLinkedAnnotationIndex och GetLinkedAnnotationChain löser upp Popup- och IRT-relationer med skydd mot hängande referenser, cykler och djup
TPdfAnnotationRelationship väljer Popup-relationen (parPopup) eller IRT (parInReplyTo) och TPdfAnnotationSubtypes lagrar fokuspolicy-subtyparrayen
GetAnnotationDictionaryValue och GetAttachmentDictionaryValue rapporterar exakt nativ värdestyp innan ett stött skalärvärde returneras
TPdfDictionaryValueKind bevarar den nativa objektkategorin (pdvkUnknown, pdvkBoolean, pdvkNumber, pdvkString, pdvkName, pdvkArray, pdvkDictionary, pdvkStream, pdvkNull, pdvkReference) och TPdfDictionaryValue bär det stödda tal- eller strängskalärvärdet i NumberValue och StringValue med HasScalarValue som explicit sentinel
SetFocusableAnnotationSubtypes och GetFocusableAnnotationSubtypes styr berättigandet till tangentbordsfokus via det nativa formulärhandtaget
TPdfStructureElement.Attributes är ett platt TPdfStructureAttributeValues-träd vars TPdfStructureAttributeValue-noder knyter tillbaka till sin ägande attributordbok via AttributeIndex och bevarar typade nästlade värden och förlustfria blobbar i BlobValue
TPdfView.FormFieldZOrderAt, TPdfView.LinkZOrderAt och TPdfView.ReplaceFormTextAndKeepSelection exponerar motsvarande koordinatkonvertering och de markeringsbevarande formuläroperationerna via den visuella kontrollen

Thumbnails and affine page transforms

ThumbnailRawData returnerar den inbäddade miniatyrbildsströmmen före filteravkodning
ThumbnailDecodedData returnerar den inbäddade miniatyrbildsströmmen efter filteravkodning
TransformPageContent transformerar och klipper alla sidobjekt, genererar om sidan och läser in dess härledda handtag igen
TransformPageAnnotations tillämpar samma affina koordinatmodell på alla annoteringar på den aktuella sidan

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 accepterar en inverterbar FS_MATRIX och en klippningsrektangel i enhetskoordinater

Overloaden som tar emot en anroparägd TBitmap renderar direkt till en kompatibel 32-bitars DIB och faller tillbaka till en enda kopia först när en extern PDFium-bitmap inte kan skapas

Matrisrendering ritar sidinnehåll och icke-interaktiva annoteringar valda via renderflaggor, men den anropar inte formulärfyllningens överläggsrenderare