CharacterOrigin - TPdf

Component: TPdf · Unit: PDFium

Read-only indexed access to the origin (baseline-left anchor) of the character in PDF user-space points.

Syntax

property CharacterOrigin[CharIndex: Integer]: TPdfPoint; // read only

Description

Indexed read-only access to the origin (baseline-left anchor) of the character in PDF user-space points. The valid range is 0 .. CharacterCount - 1 for the current page; passing an out-of-range index raises EPdfError.

Characters are returned in their logical reading order — the order in which PDFium parsed the content stream — not necessarily in visual order (right-to-left scripts may appear reversed).

All coordinates are in PDF user-space points with the origin at the bottom-left. Use PdfView1.PointsToScreen or your own coordinate transform when overlaying on a VCL canvas.

Parameters

CharIndex Zero-based character index in the current page (0 .. CharacterCount - 1).

Remarks

CharacterCount resets to 0 when Active is False or no page is open.
Whitespace and control characters are included in the count; filter them in your loop if needed.
PDFium synthesises space characters where the content stream uses positioning rather than explicit whitespace (see CharacterGenerated).

Example

var
  I: Integer;
begin
  for I := 0 to Pdf1.CharacterCount - 1 do
    P := Pdf1.CharacterOrigin[I]; // origin of glyph I, in points
end;

CharacterOrigin property