THotPDF.RegisterImageTilingPattern Method

패턴 셀이 기존 이미지 XObject 하나를 재사용하는 색상 PDF 타일링 패턴을 등록합니다. 셀은 하나 이상의 독립적으로 클리핑된 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는 유한한 양수 패턴 셀 경계를 정의합니다
• XStep과 YStep은 유한하고 0이 아닌 셀 간격을 정의합니다
• Placements는 유한한 양수 클리핑 사각형을 갖는, 유한하고 가역적인 행렬 1~1024개를 제공합니다
• TilingType은 PDF 타일링 배치 규칙을 고릅니다
• PatternMatrix는 패턴 좌표를 상위 content stream 기본 좌표계로 사상합니다
• UseImageSoftMask는 선택한 이미지의 그레이스케일 /SMask XObject를 셀 이미지로 재사용합니다

동작

메서드는 pattern 딕셔너리에 이미지 XObject 리소스 하나를 기록하고 모든 배치에서 그것을 호출하므로, 반복되거나 미러된 셀이 이미지 바이트를 복제하지 않습니다

각 배치는 q와 Q로 격리되고, 행렬이 곱해지기 전에 클리핑되며, locale 독립적인 PDF 숫자로 직렬화됩니다

소프트 마스크 오버로드는 기존 alpha 이미지 하나를 안정적인 SMIm 리소스 이름 아래 연결하여, 이미지 바이트를 복제하거나 디코딩하지 않고도 반복·반사된 alpha 셀을 씁니다

이미지 인덱스, 배치 개수, 클리핑 사각형, 행렬, 경계, 스텝 또는 패턴 행렬이 올바르지 않으면 이 메서드는 ERangeError를 발생시킵니다

반환 값

THPDFPage.SetFillPattern 또는 THPDFPage.SetStrokePattern에 사용할 안정적인 패턴 리소스 이름을 반환합니다

관련 API

THPDFImageTilingPlacement · THotPDF.RegisterTilingPattern · THPDFPage.SetFillPattern