THotPDF.RegisterImageTilingPattern Method

Registrerar ett färglagt PDF-tilingmönster vars cell återanvänder ett befintligt bild-XObject över en eller flera oberoende klippta affina placeringar

Deklaration

function RegisterImageTilingPattern(ImageIndex: Integer; BBoxLLx,
  BBoxLLy, BBoxURx, BBoxURy: Single; XStep, YStep: Single;
  const Placements: THPDFImageTilingPlacements;
  TilingType: THPDFTilingPatternType;
  const PatternMatrix: THPDFAffineMatrix): AnsiString; overload;

function RegisterImageTilingPattern(ImageIndex: Integer; BBoxLLx,
  BBoxLLy, BBoxURx, BBoxURy: Single; XStep, YStep: Single;
  const Placements: THPDFImageTilingPlacements;
  TilingType: THPDFTilingPatternType;
  const PatternMatrix: THPDFAffineMatrix;
  UseImageSoftMask: boolean): AnsiString; overload;

Enhet

HPDFDoc

Parametrar

• ImageIndex väljer en bild som tidigare returnerats av AddImage eller en motsvarande bildregistrerings-API
• BBoxLLx, BBoxLLy, BBoxURx och BBoxURy definierar de ändliga positiva mönstercellsgränserna
• XStep och YStep definierar ändliga icke-noll cellavstånd
• Placements tillhandahåller 1 till 1024 ändliga inverterbara matriser med ändliga positiva klipprektanglar
• TilingType väljer PDF:ens tilingplaceringstegel
• PatternMatrix avbildar mönsterkoordinater till det härledda innehållsströmmens standardkoordinatsystem
• UseImageSoftMask återanvänder den valda bildens gråskale-/SMask-XObject som cellbild

Beteende

Metoden sänder en bild-XObject-resurs i mönsterordlistan och anropar den från varje placering, så upprepade och speglade celler duplicerar inte bildbytes

Varje placering isoleras av q och Q, klipps innan dess matris sammanfogas, och serialiseras med språkoberoende PDF-nummer

Softmask-överlagringen länkar ett befintligt alfabild under ett stabilt SMIm-resursnamn, vilket tillåter upprepade och speglade alfaceller utan att duplicera eller avkoda bildbytes

Metoden gör att ERangeError utlöses för ogiltiga bildindex, placeringsantal, klipprektanglar, matriser, gränser, steg eller mönstermatriser

Returvärde

Returnerar det stabila mönsterresursnamnet för THPDFPage.SetFillPattern eller THPDFPage.SetStrokePattern

Relaterade API:er

THPDFImageTilingPlacement · THotPDF.RegisterTilingPattern · THPDFPage.SetFillPattern