CharacterCount - TPdf

Ten wpis API zachowuje identyfikatory, sygnatury, bloki kodu i terminy PDF w oryginalnej postaci.

Komponent: TPdf · Moduł: PDFium

Liczba znaków możliwych do wyodrębnienia na aktualnie aktywnej stronie

Składnia

property CharacterCount: Integer; // read only

Opis

CharacterCount zwraca liczbę znaków, które PDFium identyfikuje na aktywnej stronie w FPDF_TEXTPAGE — tym samym indeksowaniu, z którego korzystają Character[Index], CharacterRectangle[Index], CharacterOrigin[Index] oraz warstwa wyszukiwania i zaznaczania. Licznik odzwierciedla glify po rozwiązaniu ToUnicode CMap, więc każdy wpis odpowiada jednemu punktowi kodowemu Unicode zdekodowanemu przez PDFium, a nie jednemu glifowi programu fontu PDF

Wartość wynosi 0, gdy Active ma wartość False, gdy strona nie zawiera tekstu (czysto graficzne / wektorowe strony) albo gdy treść tekstowa jest rysowana fontami bez ToUnicode CMap i żaden zapasowy heurystyczny mechanizm nie zdołał jej zdekodować. PDFium uwzględnia też „wygenerowane” znaki odstępu, które sam tworzy, aby modelować podziały wierszy i granice słów — użyj CharacterGenerated[Index], aby odróżnić prawdziwe glify od syntetycznych

Typowa pętla ma postać for I := 0 to Pdf.CharacterCount - 1 do, a Pdf.Character[I] zwraca WideChar. Sklejenie tych wartości w jeden łańcuch daje zawartość tekstową strony w kolejności czytania CharacterCount samo w sobie ma złożoność O(1) po sparsowaniu strony; dostęp indeksowany wykonuje pracę dla każdego znaku

Uwagi

Pary zastępcze w planes uzupełniających (emoji, rzadkie ideogramy CJK) zajmują dwa indeksy znaków — jeden high surrogate i jeden low surrogate — zgodnie z jednostkami kodowymi UTF-16, a nie z punktami kodowymi Unicode
Użyj CharacterMapError[Index], aby wykryć glify, których PDFium nie potrafił zmapować z powrotem na Unicode; takie glify zwykle wymagają OCR albo inspekcji programu fontu
Aby policzyć wszystko dla całego dokumentu, przejdź po każdej stronie i zsumuj wynik CharacterCount jest liczony per strona, a PDFium nie udostępnia bezpośrednio łącznej liczby dla wszystkich stron

Przykład

var S: string;
var I: Integer;
SetLength(S, Pdf1.CharacterCount);
for I := 1 to Length(S) do
S[I] := Pdf1.Character[I - 1];
Memo1.Lines.Add(S);

Zobacz też

Character, CharacterRectangle, CharacterOrigin, TextPage