Advanced page content APIs - TPdf - PDFium Delphi Component

Component: TPdf · Unit: PDFium

ตรวจสอบและแก้ไขเนื้อหาหน้าแบบ native โดยไม่บังคับให้แอปพลิเคชันจัดการ handle ของ PDFium หรือบัฟเฟอร์ bitmap เอง

Page object inspection

PageObjectInfo คืน snapshot TPdfPageObjectInfo หนึ่งชุด ที่บรรจุ handle, ชนิดอ็อบเจกต์, ขอบเขตแบบปกติและแบบหมุน, เมทริกซ์ที่มีผลจริง, สถานะ active, ความโปร่งใส, สี fill กับ stroke, ค่า alpha, ความกว้าง stroke, line join, line cap, dash array และ dash phase

HasRotatedBounds, HasActiveState และฟิลด์ Has* อื่น ๆ ช่วยแยกค่า native ที่หาไม่ได้ออกจากค่าศูนย์ที่ถูกต้อง

RotatedBounds แบกสี่เหลี่ยมด้านขนานที่หมุนแล้ว, HasLineJoin กับ HasLineCap คุมสไตล์ join กับ cap และ DashPhase เลื่อนจุดเริ่มของรูปแบบ dash

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 ใช้ทุกฟิลด์ที่เลือกกับอ็อบเจกต์ native ตัวเดิม แล้ว regenerate เนื้อหาหน้าเพียงครั้งเดียว

TransformPageObject ประกอบเมทริกซ์ affine แบบ FS_MATRIX เข้ากับอ็อบเจกต์ที่เลือก

Paths, clip paths, and Form XObjects

PathInfo คืน fill mode, สถานะ stroke, ชนิด segment, จุดปลาย และสถานะการปิด ของ segment ทุกชิ้นใน path
PageObjectClipPath คืน subpath และ segment ของ clip ทุกชิ้นที่ผูกกับ page object
TransformPageObjectClipPath(Index, Matrix) แปลงเฉพาะเรขาคณิตของ clip นั้น แล้วปล่อยเมทริกซ์ของ page object ไว้เหมือนเดิม
FormObjectChildren คืน snapshot ละเอียดของลูกโดยตรงทั้งหมดของ Form XObject
DetachFormObjectChild(FormIndex, ChildIndex) ถอดลูกหนึ่งตัวออกแล้วโอนความเป็นเจ้าของ FPDF_PAGEOBJECT ที่คืนกลับให้ผู้เรียก ซึ่งต้องแทรกหรือทำลายมันต่อ

Content marks, glyphs, and native object helpers

PageObjectMarks, PageObjectMarkedContentID, AddPageObjectMark, SharePageObjectMark, SetPageObjectMarkParam, RemovePageObjectMarkParam และ RemovePageObjectMark ตรวจดู ใช้ซ้ำ และอัปเดตความสัมพันธ์ marked-content โดยไม่แทนที่ property อื่นที่ไม่เกี่ยวข้อง
TextObjectGlyphOutline เปิดเผยเรขาคณิตเส้นทางของ glyph ส่วน TextObjectGlyphWidth(Index, GlyphIndex, FontSize) คืน advance แบบ native ของ glyph ที่ขนาดที่ร้องขอ
TextObjectFontSize(Index) อ่านขนาดของ text object แบบ native และ SetTextObjectFontSize(Index, FontSize) แก้ไขมันโดยไม่ประมาณผ่านการแปลงด้วยเมทริกซ์
GetImageObjectRenderedBitmap(Index) คืน bitmap ที่ผู้เรียกเป็นเจ้าของ พร้อม image mask, การแปลงสี และเมทริกซ์ของภาพที่ PDFium ใช้แล้ว
AnnotationObjectCount, AnnotationObjectInfo, AddPathToAnnotation และ RemoveAnnotationObject ทำงานกับ appearance object ของคำอธิบายประกอบ
IsAnnotationObjectSubtypeSupported(Subtype) สอบถามว่ามอดูล PDFium ที่โหลดไว้รองรับการสกัด อัปเดต และถอด appearance object ของ subtype นั้นหรือไม่
PerformNamedAction ส่ง action เอกสารที่รู้จักไปทำงาน และ OnNamedAction รายงาน callback ของ named action

Character inspection and index mapping

CharacterInfo คืนสี fill กับ stroke, ชื่อฟอนต์, flag ฟอนต์ของ PDF, ขอบเขต glyph แบบหลวม, เมทริกซ์ที่มีผลจริง และ handle ของ text object ที่เกี่ยวข้อง

CharacterIndexToTextIndex กับ TextIndexToCharacterIndex แปลงกลับไปมาระหว่างดัชนีอักขระของ PDFium กับดัชนีใน text stream ที่สร้างขึ้น

Annotation borders and appearance streams

TPdfAnnotation เปิดเผยรัศมีและความกว้างของขอบผ่าน HasBorder, BorderHorizontalRadius, BorderVerticalRadius และ BorderWidth

ความครอบคลุมของสียืดไปถึง ColorAlpha, InteriorColor และ InteriorColorAlpha, metadata ของ markup ถูกคุมด้วย HasAuthor, HasName, HasSubject, HasModificationDate, HasCreationDate และ HasIcon ส่วน ink gesture, เรขาคณิต quad-point และเป้าหมายลิงก์เปิดเผยผ่าน InkList, HasAttachmentPoints, HasLinkUri และ LinkUri

appearance stream แบบปกติ, rollover และแบบกดอยู่ เข้าถึงได้ผ่าน sentinel HasAppearanceNormal, HasAppearanceRollover, HasAppearanceDown และสตริงคู่กันคือ AppearanceNormal, AppearanceRollover, AppearanceDown

กำหนดเรกคอร์ดคำอธิบายประกอบที่แก้แล้วกลับเข้า Annotation[Index] เพื่อเขียนค่าขอบหรือ appearance ที่เลือกไว้

Native library, annotation, and form diagnostics

ConfigurePdfLibrary, GetPdfLibraryConfiguration และ PdfLibraryConfigurationSealed ตั้งค่าและ audit นโยบายการเริ่มต้น native ระดับโปรเซสแบบเปลี่ยนแปลงไม่ได้ กับ sandbox ก่อนการโหลดครั้งแรก
TPdfLibraryConfiguration แบก UserFontPaths, V8Isolate, V8EmbedderSlot, V8Platform, Renderer, FontBackend, BrotliEnabled และ AllowMachineTime โดยใช้ TPdfRendererPreference (prpDefault, prpAgg, prpSkia) กับ TPdfFontBackendPreference (pfbpDefault, pfbpFreeType, pfbpFontations) เพื่อเลือกเฉพาะฟิลด์ native ที่การตั้งค่าที่ร้องขอต้องใช้
PdfDefaultTtfMapCount กับ TryGetPdfDefaultTtfMapEntry รวมการแทนฟอนต์ default แบบ native พร้อมการเข้าถึงตามดัชนีที่ตรวจขอบเขต
TPdfDefaultTtfMapEntry คัดลอกชื่อหน้า, charset และ metadata ฟอนต์ระดับแพลตฟอร์มจากรายการแมปหนึ่งรายการ
FormFieldZOrderAtPoint กับ LinkZOrderAtPoint คืนลำดับ z แบบ native ของชิ้นที่อยู่หน้าสุด หรือ -1 เมื่อไม่มีเป้าหมาย
TryGetAnnotationFileAttachment คัดลอก metadata ไฟล์แบบมีขอบเขตกับเพย์โหลด ขณะที่ handle คำอธิบายประกอบแบบ native ยังใช้ได้อยู่
TPdfAnnotationAttachment เป็นเจ้าของ metadata กับเพย์โหลดที่คัดลอกมาอย่างอิสระจาก handle ของหน้าและคำอธิบายประกอบ
GetLinkedAnnotationIndex กับ GetLinkedAnnotationChain resolve ความสัมพันธ์ Popup กับ IRT พร้อมกันเสียที่ห้อยอยู่, cycle และความลึกเกิน
TPdfAnnotationRelationship เลือกความสัมพันธ์แบบ Popup (parPopup) หรือ IRT (parInReplyTo) และ TPdfAnnotationSubtypes เก็บอาร์เรย์ subtype ของนโยบายโฟกัส
GetAnnotationDictionaryValue กับ GetAttachmentDictionaryValue รายงานชนิดค่าแบบ native อย่างเป๊ะก่อนคืนค่า scalar ที่รองรับ
TPdfDictionaryValueKind คงหมวดอ็อบเจกต์แบบ native ไว้ (pdvkUnknown, pdvkBoolean, pdvkNumber, pdvkString, pdvkName, pdvkArray, pdvkDictionary, pdvkStream, pdvkNull, pdvkReference) และ TPdfDictionaryValue แบกค่า scalar แบบตัวเลขหรือข้อความที่รองรับใน NumberValue กับ StringValue โดย HasScalarValue เป็น sentinel ชัดเจน
SetFocusableAnnotationSubtypes กับ GetFocusableAnnotationSubtypes คุมสิทธิ์รับ keyboard focus ผ่าน form handle แบบ native
TPdfStructureElement.Attributes เป็น tree แบบแบนของ TPdfStructureAttributeValues ที่โหนด TPdfStructureAttributeValue ผูกกลับไปยัง attribute dictionary เจ้าของผ่าน AttributeIndex พร้อมคงค่าที่ซ้อนแบบมีชนิดและ blob แบบสูญเสียข้อมูลเป็นศูนย์ใน BlobValue
TPdfView.FormFieldZOrderAt, TPdfView.LinkZOrderAt และ TPdfView.ReplaceFormTextAndKeepSelection เปิดเผยการแปลงพิกัดที่ตรงกันและ operation ฟอร์มที่คงการเลือกไว้ ผ่านคอนโทรลที่มองเห็นได้

Thumbnails and affine page transforms

ThumbnailRawData คืน stream thumbnail ที่ฝังไว้ก่อนถอดรหัสด้วย filter
ThumbnailDecodedData คืน stream thumbnail ที่ฝังไว้หลังถอดรหัสด้วย filter
TransformPageContent แปลงและ clip page object ทุกตัว regenerate หน้า แล้วโหลด handle ที่พึ่งพิงของมันซ้ำ
TransformPageAnnotations ใช้โมเดลพิกัด affine ชุดเดียวกับคำอธิบายประกอบทั้งหมดบนหน้าปัจจุบัน

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 รับ FS_MATRIX ที่ผันกลับได้และสี่เหลี่ยม clip ในพิกัดอุปกรณ์

overload ที่รับ TBitmap ของผู้เรียกจะเรนเดอร์ตรงลง DIB 32 บิตที่เข้ากันได้ และ fallback ไปคัดลอกครั้งเดียวเมื่อสร้าง bitmap แบบ PDFium ภายนอกไม่ได้

การเรนเดอร์ด้วยเมทริกซ์วาดเนื้อหาหน้ากับคำอธิบายประกอบที่ไม่โต้ตอบซึ่งเลือกด้วย render flag แต่ไม่เรียกตัวเรนเดอร์ overlay ของ form-fill

API เนื้อหาหน้าขั้นสูง