THotPDF.RegisterImageTilingPattern Método

Registra un patrón de teselado PDF con color cuya celda reutiliza un XObject de imagen existente en una o más colocaciones afines recortadas de forma independiente

Declaración

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;

Unidad

HPDFDoc

Parámetros

• ImageIndex selecciona una imagen devuelta previamente por AddImage o por una API equivalente de registro de imágenes
• BBoxLLx, BBoxLLy, BBoxURx y BBoxURy definen los límites finitos y positivos de la celda del patrón
• XStep y YStep definen un espaciado de celda finito y distinto de cero
• Placements aporta de 1 a 1024 matrices finitas e invertibles con rectángulos de recorte finitos y positivos
• TilingType selecciona la regla de colocación del teselado PDF
• PatternMatrix lleva las coordenadas del patrón al sistema de coordenadas por defecto del content stream padre
• UseImageSoftMask reutiliza el XObject /SMask en escala de grises de la imagen seleccionada como imagen de la celda

Comportamiento

El método emite un único recurso XObject de imagen en el diccionario del patrón y lo invoca desde cada colocación, de modo que las celdas repetidas y espejadas no duplican los bytes de la imagen

Cada colocación se aísla con q y Q, se recorta antes de concatenar su matriz y se serializa con números PDF independientes del locale

La sobrecarga con soft mask enlaza una imagen alfa existente bajo el nombre de recurso estable SMIm, lo que permite celdas alfa repetidas y reflejadas sin duplicar ni decodificar bytes de imagen

El método lanza ERangeError ante índices de imagen, conteos de colocaciones, rectángulos de recorte, matrices, límites, pasos o matrices de patrón inválidos

Valor de retorno

Devuelve el nombre de recurso de patrón estable para THPDFPage.SetFillPattern o THPDFPage.SetStrokePattern

APIs relacionadas

THPDFImageTilingPlacement · THotPDF.RegisterTilingPattern · THPDFPage.SetFillPattern