InsertFormObjectFromXObject - TPdf - PDFium Delphi Component

컴포넌트: TPdf · 유닛: PDFium

TPdfXObject로 감싼 page의 복사본 하나를 이 document의 current page에 삽입하고, caller가 position / scale / rotate할 수 있도록 FPDF_PAGEOBJECT를 반환합니다

Syntax

function InsertFormObjectFromXObject(XObject: TPdfXObject): FPDF_PAGEOBJECT;

Description

InsertFormObjectFromXObject는 v1.25.0 Form XObject 재사용 API의 후반부입니다. TPdfXObject 핸들(CreateXObjectFromPage로 만든 것)을 받아 그 XObject를 참조하는 FPDF_PAGEOBJECT 하나를 이 문서의 현재 페이지에 삽입합니다. 호출할 때마다 새 페이지 객체가 삽입되므로 같은 XObject를 대상 문서의 여러 페이지에 여러 번 스탬프할 수 있습니다 — 모든 스탬프가 기반 페이지 콘텐츠 캐시를 공유하므로 워터마크 / 템플릿이 복잡해도 파일 크기가 작게 유지됩니다

반환된 FPDF_PAGEOBJECT 핸들로 호출자는 FPDFPageObj_SetMatrix나 TPdfMatrix 헬퍼를 써서 스탬프를 페이지 어디든 배치 / 스케일 / 회전할 수 있습니다. 명시적 변환을 주지 않으면 삽입된 페이지는 왼쪽 아래 모서리에 1:1 크기로 놓이는데 원하는 모양은 거의 아닐 것입니다. UpdatePage를 호출하기 전에 반드시 매트릭스를 설정하세요

실패하면(XObject가 nil, 이 TPdf가 Active 아님, 현재 페이지 없음) nil을 반환합니다. 삽입 후 페이지 객체의 소유자는 페이지이지 XObject가 아닙니다 — XObject를 해제해도 삽입된 페이지 객체는 무효화되지 않습니다

Remarks

대상 페이지는 이 TPdf의 PageNumber로 결정됩니다. PageNumber를 먼저 설정한 뒤 InsertFormObjectFromXObject를 호출하세요
스탬프 위치를 정한 뒤 UpdatePage를 호출해 PDFium이 페이지 콘텐츠 스트림을 다시 그리게 하세요
같은 XObject를 N 페이지에 스탬프하면 N개의 페이지 콘텐츠 스트림에 N개의 FPDF_PAGEOBJECT 참조가 생기고 모두 하나의 XObject 정의를 가리킵니다 — 기반 콘텐츠를 N번 복사하는 것보다 훨씬 쌉니다
XObject의 수명은 대상 페이지 객체보다 짧아도 됩니다. 삽입된 순간 참조는 페이지가 소유합니다

Example

uses FPdfMatrix;

var
  PageObj: FPDF_PAGEOBJECT;
  M: TPdfMatrix;
begin
  Pdf1.PageNumber := 3;
  PageObj := Pdf1.InsertFormObjectFromXObject(XObj);
  if PageObj <> nil then
  begin
    M := TPdfMatrix.Create;
    try
      M.Translate(100, 200);
      M.Scale(0.5, 0.5);
      M.Rotate(15);
      FPDFPageObj_SetMatrix(PageObj, M.AsMatrix);
    finally
      M.Free;
    end;
    Pdf1.UpdatePage;
  end;
end;

InsertFormObjectFromXObject 메서드

컴포넌트: TPdf · 유닛: PDFium

Syntax

Description

Remarks

Example

See Also