Método THotPDF.RegisterImageTilingPattern

Registra um padrão de tiling colorido do PDF cuja célula reutiliza um único XObject de imagem existente em uma ou mais colocações afins, cada uma com seu próprio recorte

Declaração

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;

Unidade

HPDFDoc

Parâmetros

• ImageIndex seleciona uma imagem retornada anteriormente por AddImage ou por uma API equivalente de registro de imagens
• BBoxLLx, BBoxLLy, BBoxURx e BBoxURy definem os limites finitos e positivos da célula do padrão
• XStep e YStep definem o espaçamento finito e não nulo entre células
• Placements fornece de 1 a 1024 matrizes finitas invertíveis com retângulos de recorte finitos e positivos
• TilingType seleciona a regra de colocação de tiling do PDF
• PatternMatrix mapeia as coordenadas do padrão para o sistema de coordenadas padrão do fluxo de conteúdo pai
• UseImageSoftMask reutiliza o XObject /SMask em escala de cinzentos da imagem selecionada como a imagem da célula

Comportamento

O método emite um único recurso de XObject de imagem no dicionário do padrão e o invoca a partir de cada colocação, de modo que células repetidas e espelhadas não duplicam bytes de imagem

Cada colocação é isolada por q e Q, recortada antes da concatenação de sua matriz e serializada com números de PDF independentes de localidade

A sobrecarga de soft mask vincula uma imagem de alfa existente sob um nome de recurso SMIm estável, permitindo células de alfa repetidas e refletidas sem duplicar nem decodificar bytes de imagem

O método lança ERangeError para índices de imagem, contagens de colocações, retângulos de recorte, matrizes, limites, passos ou matrizes de padrão inválidos

Valor de retorno

Retorna o nome estável do recurso de padrão para THPDFPage.SetFillPattern ou THPDFPage.SetStrokePattern

APIs relacionadas

THPDFImageTilingPlacement · THotPDF.RegisterTilingPattern · THPDFPage.SetFillPattern