procedure TransformPageObjectClipPath(Index: Integer; const Matrix: FS_MATRIX);
| Index | Integer. Indice a base zero dell'oggetto di pagina, nell'intervallo 0 .. ObjectCount - 1. |
| Matrix | FS_MATRIX. Trasformazione affine (a, b, c, d, e, f) concatenata alla geometria esistente del clip path. |
Mentre TransformPageObject sposta, ridimensiona o ruota un oggetto, questa chiamata trasforma solo il clip path dell'oggetto tramite il punto di ingresso nativo FPDFPageObj_TransformClipPath: l'oggetto conserva la propria matrice mentre la regione a cui è ritagliato viene ridisegnata. Usarlo per allargare una finestra di ritaglio dopo aver ingrandito un oggetto, o per riposizionare un ritaglio che non corrisponde più al suo contenuto
La matrice viene concatenata alla geometria corrente del clip path invece di sostituirla, quindi le chiamate ripetute si accumulano. Ispezionare prima il ritaglio corrente con PageObjectClipPath
La cache testo-pagina viene scaricata prima della modifica e la pagina viene rigenerata dopo (UpdatePage), quindi le ricerche dipendenti recepiscono la nuova geometria. La chiamata richiede che la pagina corrente sia attiva e solleva un EPdfError (Page object clip path transforms are not available) quando la build di PDFium caricata non esporta il punto di ingresso 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;