procedure TransformPageObjectClipPath(Index: Integer; const Matrix: FS_MATRIX);
| Index | Integer. Index de la zero al obiectului de pagină, în intervalul 0 .. ObjectCount - 1 |
| Matrix | FS_MATRIX. Transformare afină (a, b, c, d, e, f) concatenată geometriei existente a traseului de decupare |
Acolo unde TransformPageObject mută, scalează sau rotește un obiect, acest apel transformă doar traseul de decupare al obiectului, prin punctul de intrare nativ FPDFPageObj_TransformClipPath: obiectul își păstrează propria matrice, în timp ce regiunea în care este decupat este remodelată. Folosiți-l pentru a mări o fereastră de decupare după ce ați mărit un obiect, sau pentru a repoziționa un decupaj care nu se mai potrivește cu conținutul său
Matricea este concatenată cu geometria curentă a traseului de decupare, nu în locuită, deci apelurile repetate se cumulează. Inspectați mai întâi decupajul curent cu PageObjectClipPath
Cache-ul paginii de text este descărcat înainte de modificare, iar pagina este regenerată ulterior (UpdatePage), astfel încât căutările dependente preiau noua geometrie. Apelul cere ca pagina curentă să fie activă și ridică un EPdfError (Page object clip path transforms are not available) când build-ul PDFium încărcat nu exportă punctul de intrare nativ
var
M: FS_MATRIX;
begin
// widen the clip region of object 4 to twice its size, same origin
FillChar(M, SizeOf(M), 0);
M.a := 2;
M.d := 2;
Pdf1.TransformPageObjectClipPath(4, M);
end;