THotPDF.RegisterImageTilingPattern Method

Rejestruje barwny wzór kafelkowania PDF, którego komórka ponownie używa jednego istniejącego obrazu XObject w jednym lub kilku niezależnie przycinanych rozmieszczeniach afinicznych

Deklaracja

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;

Jednostka

HPDFDoc

Parametry

• ImageIndex wybiera obraz wcześniej zwrócony przez AddImage lub równoważne API rejestracji obrazów
• BBoxLLx, BBoxLLy, BBoxURx i BBoxURy definiują skończone dodatnie granice komórki wzoru
• XStep i YStep definiują skończony, niezerowy rozstaw komórek
• Placements dostarcza od 1 do 1024 skończonych odwracalnych macierzy ze skończonymi dodatnimi prostokątami przycinania
• TilingType wybiera regułę rozmieszczania kafelków PDF
• PatternMatrix mapuje współrzędne wzoru do domyślnego układu współrzędnych nadrzędnego content stream
• UseImageSoftMask ponownie używa XObject /SMask w skali szarości wybranego obrazu jako obrazu komórki

Zachowanie

Metoda emituje jeden zasób obrazu XObject w słowniku wzoru i odwołuje się do niego z każdego rozmieszczenia, dzięki czemu powtórzone i odbite komórki nie duplikują bajtów obrazu

Każde rozmieszczenie jest izolowane przez q i Q, przycinane przed złożeniem swojej macierzy i serializowane liczbami PDF niezależnymi od locale

Wariant z soft maską podpina jeden istniejący obraz alfa pod stabilną nazwą zasobu SMIm, co pozwala powtarzać i odbijać komórki alfa bez duplikowania ani dekodowania bajtów obrazu

Metoda podnosi ERangeError dla niepoprawnych indeksów obrazów, liczby rozmieszczeń, prostokątów przycinania, macierzy, granic, kroków lub macierzy wzoru

Wartość zwracana

Zwraca stabilną nazwę zasobu wzoru dla THPDFPage.SetFillPattern lub THPDFPage.SetStrokePattern

Powiązane API

THPDFImageTilingPlacement · THotPDF.RegisterTilingPattern · THPDFPage.SetFillPattern