procedure TransformPageObjectClipPath(Index: Integer; const Matrix: FS_MATRIX);
| Index | Integer. الفهرس الصفري لكائن الصفحة، في المدى 0 .. ObjectCount - 1۔ |
| Matrix | FS_MATRIX. تحويل أفين (a و b و c و d و e و f) يُربط بهندسة مسار القص الموجودة۔ |
حيث يحرك TransformPageObject كائنًا أو يحجّمه أو يدوّره، يحوّل هذا الاستدعاء مسار قص الكائن فقط عبر المدخل الأصلي FPDFPageObj_TransformClipPath: يحتفظ الكائن بمصفوفته الخاصة بينما يُعاد تشكيل المنطقة التي يقص إليها۔ استخدمه لتوسيع نافذة القص بعد تكبير كائن، أو لإعادة تموضع قص لم يعد يطابق محتواه
ترتبط المصفوفة بهندسة مسار القص الحالية بدلًا من استبدالها، فتتراكم الاستدعاءات المتكررة۔ افحص القص الحالي أولًا عبر PageObjectClipPath
يُفرَّغ ذاكرة صفحات النص قبل التغيير وتُعاد توليد الصفحة بعده عبر UpdatePage، فتلتقط عمليات البحث التابعة الهندسة الجديدة۔ يتطلب الاستدعاء أن تكون الصفحة الحالية نشطة، ويرفع EPdfError بالرسالة Page object clip path transforms are not available عندما لا يصدّر بناء PDFium المحمل المدخل الأصلي
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;