PDFium Delphi Component Docs

TransformPageObjectClipPath metode

Komponent: TPdf  ·  Enhed: PDFium
Anvender en transformationsmatrix på klippestien for ét sideobjekt og lader selve objektet stå

Syntax

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

IndexInteger. Nul-baseret indeks for sideobjektet i intervallet 0 .. ObjectCount - 1
MatrixFS_MATRIX. Affin transformation (a, b, c, d, e, f), der konkateneres på den eksisterende klippesti-geometri

Description

Hvor TransformPageObject flytter, skalerer eller roterer et objekt, transformerer dette kald kun objektets klippesti via det native indgangspunkt FPDFPageObj_TransformClipPath: objektet beholder sin egen matrix, mens det område, det klippes til, omformes. Brug det til at udvide et klippevindue, efter at et objekt er blevet forstørret, eller til at flytte et klip, der ikke længere matcher sit indhold

Matricen konkateneres med den aktuelle klippesti-geometri i stedet for at erstatte den, så gentagne kald akkumulerer. Undersøg først det aktuelle klip med PageObjectClipPath

Tekstside-cachen aflæsses før ændringen, og siden gendannes bagefter (UpdatePage), så afhængige opslag registrerer den nye geometri. Kaldet kræver, at den aktuelle side er aktiv, og rejser en EPdfError (Page object clip path transforms are not available), når det indlæste PDFium-build ikke eksporterer det native indgangspunkt

Remarks

Example

var
  M: FS_MATRIX;
begin
  // udvid klippeområdet for objekt 4 til det dobbelte, samme oprindelse
  FillChar(M, SizeOf(M), 0);
  M.a := 2;
  M.d := 2;
  Pdf1.TransformPageObjectClipPath(4, M);
end;

See Also

TransformPageObject, PageObjectClipPath, InsertClipPath, UpdatePageObject