THotPDF.RegisterImageTilingPattern 方法

注册一个彩色的 PDF 平铺图案，其图案单元在多个独立裁剪的仿射放置之间复用同一个已有的图像 XObject

声明

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 定义有限正值的图案单元边界
• XStep 和 YStep 定义有限非零的单元间距
• Placements 提供 1 到 1024 个有限可逆矩阵，每个矩阵都带有限正值的裁剪矩形
• TilingType 选择 PDF 平铺放置规则
• PatternMatrix 把图案坐标映射到父内容流的默认坐标系
• UseImageSoftMask 复用所选图像的灰度 /SMask XObject 作为单元图像

行为

该方法在 Pattern 字典中写入一个图像 XObject 资源，并在每个放置处引用它，因此重复和镜像的单元不会复制图像字节

每个放置都用 q 和 Q 隔离，在矩阵级联之前完成裁剪，并以与 locale 无关的 PDF 数字序列化

soft mask 重载把一个已有的 alpha 图像链接到稳定的 SMIm 资源名下，从而支持重复和反射的 alpha 单元，同时不复制也不解码图像字节

图像序号、放置数量、裁剪矩形、矩阵、边界、步长或图案矩阵非法时，该方法抛出 ERangeError

返回值

返回稳定的 pattern 资源名称，供 THPDFPage.SetFillPattern 或 THPDFPage.SetStrokePattern 使用

相关 API

THPDFImageTilingPlacement · THotPDF.RegisterTilingPattern · THPDFPage.SetFillPattern