PDFium Delphi Component Docs

TransformPageObjectClipPath Metod

Component: TPdf  ·  Unit: PDFium
Applicerar en transformationsmatris på ett sidobjekts klippbana och lämnar själva objektet kvar där det är

Syntax

procedure TransformPageObjectClipPath(Index: Integer; const Matrix: FS_MATRIX);

IndexInteger. Nollbaserat index för sidobjektet, i intervallet 0 .. ObjectCount - 1
MatrixFS_MATRIX. Affin transform (a, b, c, d, e, f) som sammansätts med den befintliga klippbanans geometri

Description

Där TransformPageObject flyttar, skalar eller roterar ett objekt transformerar det här anropet bara objektets klippbana via det nativa startpunktsanropet FPDFPageObj_TransformClipPath: objektet behåller sin egen matris medan det område det klipps mot formas om. Använd den för att utvidga ett klippfönster efter att ett objekt vuxit, eller för att flytta en klippbana som inte längre matchar sitt innehåll

Matrisen sammansätts med den aktuella klippbanans geometri i stället för att ersätta den, så upprepade anrop ackumuleras. Inspektera den aktuella klippbanan först med PageObjectClipPath

Textsidcachen töms innan ändringen och sidan genereras om därefter (UpdatePage), så beroende uppslagningar får den nya geometrin. Anropet kräver att den aktuella sidan är aktiv och utlöser ett EPdfError (Page object clip path transforms are not available) när den inlästa PDFium-builden inte exporterar det nativa startpunktsanropet

Remarks

Example

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;

See Also

TransformPageObject, PageObjectClipPath, InsertClipPath, UpdatePageObject