FlattenPageRotation - TPdf - PDFium Delphi Component

컴포넌트: TPdf · 유닛: PDFium

모든 페이지의 현재 /Rotate를 콘텐츠 스트림, 페이지 박스, 주석 사각형에 반영한 뒤 /Rotate를 0으로 되돌려, 회전 표시 힌트에 의존하지 않고도 시각적 레이아웃이 유지되게 합니다

Syntax

function FlattenPageRotation(
const Options : TPdfFlattenRotationOptions;
out Report : TPdfFlattenRotationReport): Boolean; overload;

function FlattenPageRotation(
  const PageNumbers : array of Integer;
  const Options : TPdfFlattenRotationOptions;
  out Report : TPdfFlattenRotationReport): Boolean; overload;

Description

많은 다운스트림 도구(구형 인쇄 파이프라인, 이미지 추출기, OCR 전처리기, 래스터 변환기)는 /Rotate 페이지 항목을 무시하고 회전된 페이지를 잘못된 방향으로 렌더링합니다. FlattenPageRotation은 현재 회전의 역변환을 페이지 콘텐츠, 주석 사각형, 페이지 박스에 적용한 뒤 /Rotate를 0으로 설정합니다. 호출 후 보이는 페이지는 회전된 원본과 동일하지만 더 이상 뷰어가 회전 힌트를 적용할 필요가 없습니다

인자 하나짜리 오버로드는 모든 페이지를 처리하고, PageNumbers 오버로드는 0 기반 배열을 받아 일부 페이지만 평탄화할 수 있습니다. 이미 /Rotate=0인 페이지는 Report.SkippedPageCount에 집계되며 그대로 둡니다

내부적으로 회전된 각 페이지는 콘텐츠에 대해 FPDFPage_CountObjects + FPDFPage_GetObject + FPDFPageObj_TransformF를, 그다음 주석에 대해 FPDFPage_GetAnnot + FPDFAnnot_GetRect / FPDFAnnot_SetRect를, 그다음 페이지 박스에 대해 FPDFPage_SetMediaBox / FPDFPage_SetCropBox를 실행하고 마지막으로 FPDFPage_SetRotation을 0으로 호출합니다. 행렬은 FPDFPage_GetMediaBox가 반환한 회전 전 MediaBox에서 유도됩니다

Parameters

PageNumbers — 처리할 0 기반 페이지 인덱스입니다. 모든 페이지를 평탄화하려면 빈 배열을 전달하거나 인자 하나짜리 오버로드를 사용하세요
Options — TransformAnnotations, TransformPageBoxes, AutoUpdate를 가진 TPdfFlattenRotationOptions입니다. Default는 주석을 변환하고 페이지 박스를 교환하며 회전된 페이지마다 UpdatePage를 호출합니다
Report — ProcessedPageCount, SkippedPageCount, FailedPageCount, TotalObjectsTransformed, TotalAnnotationsTransformed와 더불어 Succeeded, ErrorMessage를 가진 TPdfFlattenRotationReport입니다

Remarks

회전 행렬: 90°는 [0, 1, -1, 0, H, 0], 180°는 [-1, 0, 0, -1, W, H], 270°는 [0, -1, 1, 0, 0, W]이며, W와 H는 회전 전 MediaBox 크기입니다
90°와 270° 회전에서는 MediaBox와 CropBox 크기가 서로 바뀌어 보이는 페이지가 가로세로 비를 유지합니다. 호출자가 박스를 직접 다시 쓰려면 TransformPageBoxes=False로 끄세요
주석 사각형은 같은 행렬로 재매핑되며, 축이 바뀌면 left <= right / bottom <= top 불변식이 뒤집힐 수 있으므로 변환된 네 모서리에서 다시 만들어집니다
호출자의 현재 PageNumber는 호출 전후로 저장되고 복원되므로, 이전에 활성이던 페이지에서 안전하게 계속 작업할 수 있습니다
이미 /Rotate=0인 페이지는 건너뛰어 Report.SkippedPageCount에 집계됩니다. 모두 건너뛴 실행도 실패한 것이 없으므로 True를 반환합니다

Example

var
  Options: TPdfFlattenRotationOptions;
  Report: TPdfFlattenRotationReport;
begin
  Pdf1.FileName := 'C:\Scanned.pdf';
  Pdf1.Active := True;
  Options := TPdfFlattenRotationOptions.Default;
  Pdf1.FlattenPageRotation(Options, Report);
  Pdf1.SaveAs('C:\Scanned_flat.pdf');
end;

FlattenPageRotation 메서드