Метод THotPDF.RegisterImageTilingPattern

Регистрирует цветной PDF tiling pattern, ячейка которого переиспользует один существующий image XObject в одном или нескольких независимо обрезаемых affine-размещениях

Объявление

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;

Модуль

HPDFDoc

Параметры

• ImageIndex выбирает изображение, ранее возвращённое AddImage или аналогичным API регистрации изображений
• BBoxLLx, BBoxLLy, BBoxURx и BBoxURy задают конечные положительные границы ячейки pattern
• XStep и YStep задают конечный ненулевой шаг ячеек
• Placements поставляет от 1 до 1024 конечных обратимых матриц с конечными положительными прямоугольниками clipping
• TilingType выбирает правило размещения PDF tiling
• PatternMatrix отображает координаты pattern в систему координат по умолчанию родительского content stream
• UseImageSoftMask переиспользует grayscale /SMask XObject выбранного изображения как изображение ячейки

Поведение

Метод помещает один ресурс image XObject в dictionary pattern и вызывает его из каждого размещения, поэтому повторяющиеся и зеркальные ячейки не дублируют байты изображения

Каждое размещение изолируется q и Q, обрезается до конкатенации своей матрицы и сериализуется с не зависящими от locale числами PDF

Перегрузка с soft mask связывает одно существующее alpha-изображение под стабильным именем ресурса SMIm, что позволяет повторяющиеся и отражённые alpha-ячейки без дублирования и декодирования байтов изображения

Метод выбрасывает ERangeError для некорректных индексов изображений, числа размещений, прямоугольников clipping, матриц, границ, шагов или pattern-матриц

Возвращаемое значение

Возвращает стабильное имя ресурса pattern для THPDFPage.SetFillPattern или THPDFPage.SetStrokePattern

Связанные API

THPDFImageTilingPlacement · THotPDF.RegisterTilingPattern · THPDFPage.SetFillPattern