THotPDF.RegisterImageTilingPattern Method

既存の画像 XObject 1 つを、独立してクリップされた 1 つ以上のアフィン配置にまたがって再利用する、カラーの PDF tiling パターンを登録します

宣言

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, and BBoxURy define the finite positive pattern-cell bounds
XStep and YStep define finite non-zero cell spacing
Placements には、有限で正の値を持つクリッピング矩形を伴う、有限で可逆な行列を 1〜1024 個指定します
TilingType selects the PDF tiling placement rule
PatternMatrix maps pattern coordinates into the parent content stream default coordinate system
UseImageSoftMask を指定すると、選択した画像のグレースケール /SMask XObject が、セル画像として再利用されます

動作

このメソッドはパターン辞書内に画像 XObject リソースを 1 つ出力し、すべての配置からそれを呼び出します。そのため、繰り返しやミラーされたセルでも画像のバイト列は重複しません

各配置は q と Q で分離され、行列を連結する前にクリップされ、ロケールに依存しない PDF 数値としてシリアライズされます

soft-mask のオーバーロードは、既存のアルファ画像 1 つを安定した SMIm リソース名でリンクします。これにより、画像のバイト列を重複させたりデコードしたりせずに、繰り返しや反転したアルファセルを使用できます

画像インデックス、配置数、クリッピング矩形、行列、bounds、ステップ、パターン行列のいずれかが不正な場合、このメソッドは ERangeError を発生させます

戻り値

THPDFPage.SetFillPattern または THPDFPage.SetStrokePattern で使用する、安定したパターンリソース名を返します

THotPDF.RegisterImageTilingPattern Method

宣言

ユニット

パラメータ

動作

戻り値

関連 API