THotPDF.RegisterImageTilingPattern Method

Enregistre un motif de pavage PDF (tiling pattern) coloré dont la cellule réutilise un même XObject image sur un ou plusieurs placements affines découpés indépendamment

Déclaration

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;

Unité

HPDFDoc

Paramètres

• ImageIndex sélectionne une image précédemment renvoyée par AddImage ou par une API équivalente d’enregistrement d’images
• BBoxLLx, BBoxLLy, BBoxURx, and BBoxURy define the finite positive pattern-cell bounds
• XStep and YStep define finite non-zero cell spacing
• Placements fournit de 1 à 1024 matrices inversibles finies avec des rectangles de découpe finis et positifs
• TilingType selects the PDF tiling placement rule
• PatternMatrix maps pattern coordinates into the parent content stream default coordinate system
• UseImageSoftMask réutilise l’XObject /SMask en niveaux de gris de l’image sélectionnée comme image de la cellule

Comportement

La méthode émet une seule ressource XObject image dans le dictionnaire du motif et l’invoque depuis chaque placement ; les cellules répétées ou en miroir ne dupliquent donc pas les octets de l’image

Chaque placement est isolé par q et Q, découpé avant la concaténation de sa matrice, et sérialisé avec des nombres PDF indépendants de la locale

La surcharge à masque doux lie une image alpha existante sous un nom de ressource SMIm stable, ce qui permet des cellules alpha répétées et réfléchies sans dupliquer ni décoder les octets de l’image

La méthode lève ERangeError pour des index d’image, des nombres de placements, des rectangles de découpe, des matrices, des bornes, des pas ou des matrices de motif invalides

Valeur de retour

Renvoie le nom de ressource de motif stable à passer à THPDFPage.SetFillPattern ou THPDFPage.SetStrokePattern

API associées

THPDFImageTilingPlacement · THotPDF.RegisterTilingPattern · THPDFPage.SetFillPattern