procedure TransformPageObjectClipPath(Index: Integer; const Matrix: FS_MATRIX);
| Index | Integer. Índice basado en cero del objeto de página, en el rango 0 .. ObjectCount - 1 |
| Matrix | FS_MATRIX. Transformación afín (a, b, c, d, e, f) concatenada a la geometría existente de la ruta de recorte |
Mientras que TransformPageObject mueve, escala o rota un objeto, esta llamada transforma únicamente la ruta de recorte del objeto a través del punto de entrada nativo FPDFPageObj_TransformClipPath: el objeto conserva su propia matriz mientras la región a la que se recorta se reformatea. Úsela para ampliar una ventana de recorte tras agrandar un objeto, o para reposicionar un recorte que ya no coincide con su contenido
La matriz se concatena con la geometría actual de la ruta de recorte en lugar de reemplazarla, de modo que las llamadas repetidas se acumulan. Inspeccione primero el recorte actual con PageObjectClipPath
La caché de páginas de texto se descarga antes del cambio y la página se regenera después (UpdatePage), de modo que las búsquedas dependientes recogen la nueva geometría. La llamada exige que la página actual esté activa y genera un EPdfError (Page object clip path transforms are not available) cuando la build de PDFium cargada no exporta el punto de entrada nativo
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;