ObjectType - TPdf - PDFiumPas

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

Komponent: TPdf · Moduł: PDFium

Zwraca kategorię obiektu strony na podanym indeksie — tekst, ścieżka, obraz, cieniowanie albo form XObject. Klasyfikacja odpowiada operatorowi strumienia zawartości PDF, który utworzył obiekt, i pozwala wywołującym iterować po tablicy obiektów strony przy użyciu jednego przełącznika

Składnia

property ObjectType[Index: Integer]: TObjectType; // read only

Index Zero-based page-object index, in the range 0 to ObjectCount - 1.

Opis

ObjectType zwraca wartość wyliczenia TObjectType opisującą typ obiektu strony na Index:

otText — operator pokazujący tekst (Tj, TJ, ', ") — ciąg glifów współdzielących czcionkę i macierz tekstu
otPath — ścieżka wektorowa: linie, krzywe, prostokąty i wypełnienia Użyj ObjectBounds, aby uzyskać prostokąt na stronie
otImage — obraz rastrowy Połącz z ObjectBitmap, aby pobrać piksele
otShading — wzorzec cieniowania gradientowego albo opartego na funkcji (axial / radial / coon shading PDF)
otForm — form XObject: wielokrotnie używany podstrumień, który sam może zawierać tekst, ścieżki i obrazy

Ta klasyfikacja jest stabilna i tania; wywoływanie jej w ciasnej pętli po ObjectCount to standardowy sposób wstępnej selekcji zawartości strony przed decyzją, który droższy accessor (ObjectBitmap, ObjectBounds, właściwości znaków) wywołać

Form XObjecty nie są przez tę właściwość rozwijane rekurencyjnie — typ zgłasza otForm, a wywołujący muszą zejść do własnej listy obiektów formularza, jeśli potrzebują zawartości liściowej

Uwagi

Przestrzeń indeksów obejmuje pełną listę obiektów strony; jest szersza niż indeks tylko obrazów używany przez Image i Bitmap
Kolejność obiektów strony mniej więcej odpowiada kolejności malowania, więc iteracja rosnąco po indeksach renderuje od dołu do góry
Zwraca otText dla indeksów wykraczających poza prawidłowy zakres; zawsze zabezpieczaj się przez ObjectCount
Wartości wyliczenia odzwierciedlają stałe FPDF_PAGEOBJ_* PDFium z bazowego natywnego API

Przykład

// Histogram typów obiektów na bieżącej stronie
var
  I: Integer;
  Counts: array[TObjectType] of Integer;
  T: TObjectType;
begin
  FillChar(Counts, SizeOf(Counts), 0);
  for I := 0 to Pdf.ObjectCount - 1 do
    Inc(Counts[Pdf.ObjectType[I]]);
  for T := Low(TObjectType) to High(TObjectType) do
    Memo1.Lines.Add(Format('%s: %d', [GetEnumName(TypeInfo(TObjectType), Ord(T)), Counts[T]]));
end;

Zobacz też

ObjectCount, ObjectBounds, ObjectBitmap, RemoveObject