procedure TransformPageObjectClipPath(Index: Integer; const Matrix: FS_MATRIX);
| Index | Integer. Indeks obiektu strony liczony od zera, w zakresie 0 .. ObjectCount - 1 |
| Matrix | FS_MATRIX. Transformacja afiniczna (a, b, c, d, e, f) skonkatenowana z istniejącą geometrią ścieżki przycinania |
Tam, gdzie TransformPageObject przesuwa, skaluje lub obraca obiekt, to wywołanie transformuje wyłącznie ścieżkę przycinania obiektu przez natywny punkt wejścia FPDFPageObj_TransformClipPath: obiekt zachowuje własną macierz, a kształtowany jest region, do którego jest przycinany. Użyj go, aby powiększyć okno przycinania po powiększeniu obiektu albo aby przestawić przycinanie, które już nie odpowiada swojej zawartości
Macierz jest łączona z bieżącą geometrią ścieżki przycinania, a nie ją zastępuje, więc powtórzone wywołania się kumulują. Najpierw obejrzyj bieżące przycinanie przez PageObjectClipPath
Cache stron tekstowych jest zwalniany przed zmianą, a strona jest regenerowana po niej (UpdatePage), więc zależne wyszukiwania podchwycą nową geometrię. Wywołanie wymaga, aby bieżąca strona była aktywna, i zgłasza EPdfError (Page object clip path transforms are not available), gdy załadowana wersja PDFium nie eksportuje natywnego punktu wejścia
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;