THotPDF.RegisterImageTilingPattern Method

Registra un pattern di tiling PDF a colori la cui cella riutilizza un unico image XObject esistente in uno o più placement affine indipendenti con clipping

Dichiarazione

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

Parametri

• ImageIndex seleziona un'immagine restituita in precedenza da AddImage o da una API di registrazione immagini equivalente
• BBoxLLx, BBoxLLy, BBoxURx e BBoxURy definiscono i limiti finiti e positivi della pattern cell
• XStep e YStep definiscono una spaziatura di cella finita e diversa da zero
• Placements fornisce da 1 a 1024 matrici finite e invertibili con rettangoli di clipping finiti e positivi
• TilingType seleziona la regola di placement del tiling PDF
• PatternMatrix mappa le coordinate del pattern nel sistema di coordinate default del content stream padre
• UseImageSoftMask riutilizza l'XObject /SMask in grayscale dell'immagine selezionata come immagine della cella

Comportamento

Il metodo emette una sola risorsa image XObject nel pattern dictionary e la invoca da ogni placement, così le celle ripetute e specchiate non duplicano i byte dell'immagine

Ogni placement è isolato da q e Q, riceve clipping prima che la sua matrice venga concatenata e viene serializzato con numeri PDF indipendenti dal locale

L'overload con soft mask collega una sola immagine alpha esistente sotto un nome di risorsa SMIm stabile, consentendo celle alpha ripetute e riflesse senza duplicare o decodificare i byte dell'immagine

Il metodo lancia ERangeError per indici immagine non validi, conteggi di placement, rettangoli di clipping, matrici, limiti, step o pattern matrix non validi

Valore restituito

Restituisce il nome di risorsa pattern stabile per THPDFPage.SetFillPattern o THPDFPage.SetStrokePattern

API correlate

THPDFImageTilingPlacement · THotPDF.RegisterTilingPattern · THPDFPage.SetFillPattern