PDFium Delphi Component Docs

TransformPageObjectClipPath metoda

Komponenta: TPdf  ·  Jednotka: PDFium
Aplikuje transformační matici na ořezovou cestu jednoho objektu stránky a samotný objekt nechá na místě

Syntaxe

procedure TransformPageObjectClipPath(Index: Integer; const Matrix: FS_MATRIX);

IndexInteger. Nulový index objektu stránky v rozsahu 0 .. ObjectCount - 1
MatrixFS_MATRIX. Afinní transformace (a, b, c, d, e, f) zřetězená ke stávající geometrii ořezové cesty

Popis

Zatímco TransformPageObject posouvá, škáluje nebo otáčí objekt, toto volání transformuje jen ořezovou cestu objektu přes nativní vstupní bod FPDFPageObj_TransformClipPath: objekt si drží svou vlastní matici, zatímco oblast, do níž je ořezán, se přetvaruje. Použijte ho, chcete-li po zvětšení objektu zvětšit ořezové okno, nebo přesunout ořez, který už neodpovídá svému obsahu

Matice se zřetězuje se stávající geometrií ořezové cesty, nikoli ji nahrazuje, takže opakovaná volání se kumulují. Aktuální ořez si nejdřív prohlédněte přes PageObjectClipPath

Mezipaměť textové stránky se před změnou uvolní a stránka se poté regeneruje (UpdatePage), takže závislá vyhledání zachytí novou geometrii. Volání vyžaduje, aby aktuální stránka byla aktivní, a vyvolá EPdfError (Page object clip path transforms are not available), když načtený build PDFium neexportuje nativní vstupní bod

Poznámky

Příklad

var
  M: FS_MATRIX;
begin
  // zvětší ořezovou oblast objektu 4 na dvojnásobek, stejný počátek
  FillChar(M, SizeOf(M), 0);
  M.a := 2;
  M.d := 2;
  Pdf1.TransformPageObjectClipPath(4, M);
end;

Viz také

TransformPageObject, PageObjectClipPath, InsertClipPath, UpdatePageObject