THotPDF.RegisterImageTilingPattern Method

Registriert ein farbiges PDF-Tiling-Pattern, dessen Zelle ein vorhandenes Bild-XObject über eine oder mehrere unabhängig beschnittene affine Platzierungen wiederverwendet

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;

Unit

HPDFDoc

Parameter

ImageIndex wählt ein Bild aus, das zuvor von AddImage oder einer gleichwertigen Bildregistrierungs-API zurückgegeben wurde
BBoxLLx, BBoxLLy, BBoxURx, and BBoxURy define the finite positive pattern-cell bounds
XStep and YStep define finite non-zero cell spacing
Placements liefert 1 bis 1024 endliche invertierbare Matrizen mit endlichen positiven Beschneidungsrechtecken
TilingType selects the PDF tiling placement rule
PatternMatrix maps pattern coordinates into the parent content stream default coordinate system
UseImageSoftMask verwendet das /SMask-XObject (Graustufen) des gewählten Bilds als Zellbild wieder

Verhalten

Die Methode schreibt eine einzige Bild-XObject-Ressource in das Pattern-Dictionary und ruft sie aus jeder Platzierung auf, sodass wiederholte und gespiegelte Zellen die Bild-Bytes nicht duplizieren

Jede Platzierung wird durch q und Q isoliert, vor dem Anfügen ihrer Matrix beschnitten und mit locale-unabhängigen PDF-Zahlen serialisiert

Die Soft-Mask-Überladung verknüpft ein vorhandenes Alpha-Bild unter dem stabilen Ressourcennamen SMIm und erlaubt so wiederholte und gespiegelte Alpha-Zellen, ohne Bild-Bytes zu duplizieren oder zu dekodieren

Die Methode löst ERangeError aus bei ungültigen Bildindizes, Platzierungsanzahlen, Beschneidungsrechtecken, Matrizen, Grenzen, Schrittweiten oder Pattern-Matrizen

Rückgabewert