procedure TransformPageObjectClipPath(Index: Integer; const Matrix: FS_MATRIX);
| Index | Integer. אינדקס מבוסס-אפס של אובייקט העמוד, בטווח 0 .. ObjectCount - 1. |
| Matrix | FS_MATRIX. טרנספורמציה אפינית (a, b, c, d, e, f) שמשורשרת אל גיאומטריית נתיב החיתוך הקיימת. |
בעוד ש-TransformPageObject מזיז, משנה גודל או מסובב אובייקט, קריאה זו מטרנספורמת אך ורק את נתיב החיתוך של האובייקט דרך נקודת הכניסה ה-native FPDFPageObj_TransformClipPath: האובייקט שומר על המטריצה שלו בעוד שהאזור שאליו הוא נחתך מעוצב מחדש. השתמשו בה כדי להרחיב חלון חיתוך אחרי הגדלת אובייקט, או כדי למקם מחדש חיתוך שכבר אינו תואם את התוכן שלו
המטריצה משורשרת אל גיאומטריית נתיב החיתוך הנוכחית במקום להחליף אותה, ולכן קריאות חוזרות מצטברות. בדקו תחילה את החיתוך הנוכחי באמצעות PageObjectClipPath
מטמון דפי הטקסט מפונה לפני השינוי והעמוד נוצר מחדש לאחר מכן (UpdatePage), כך שחיפושים תלויים בו מקבלים את הגיאומטריה החדשה. הקריאה דורשת שהעמוד הנוכחי יהיה פעיל, ומעלה EPdfError (Page object clip path transforms are not available) כאשר ה-build הטעון של PDFium אינו מייצא את נקודת הכניסה ה-native
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;