FlattenPageRotation - TPdf - PDFium Delphi Component

Komponenta: TPdf · Jednotka: PDFium

Zapeče aktuální /Rotate každé stránky do obsahového proudu, stránekových rámců a obdélníků anotací a poté resetuje /Rotate na 0, takže vizuální rozvržení zůstane zachováno bez spoléhání na rotační hint pro zobrazení

Syntaxe

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;

Popis

Mnoho downstream nástrojů (starší tiskové pipeline, extraktory obrázků, OCR preprocesory, rastrové konvertory) ignoruje stránkovou položku /Rotate a vykresluje otočené stránky ve špatné orientaci. FlattenPageRotation aplikuje inverz aktuální rotace na obsah stránky, obdélníky anotací a stránkové rámce a poté nastaví /Rotate na 0. Po volání je viditelná stránka totožná s otočeným originálem, ale už nespoléhá na to, že prohlížeč aplikuje rotační hint

Overload s jedním argumentem zpracovává každou stránku; overload s PageNumbers přijímá pole indexované od nuly, takže volající mohou zploštit podmnožinu. Stránky už na /Rotate=0 se započítají do Report.SkippedPageCount a zůstanou nedotčeny

Interně projde každá otočená stránka sekvencí FPDFPage_CountObjects + FPDFPage_GetObject + FPDFPageObj_TransformF pro obsah, poté FPDFPage_GetAnnot + FPDFAnnot_GetRect / FPDFAnnot_SetRect pro anotace, dále FPDFPage_SetMediaBox / FPDFPage_SetCropBox pro stránkové rámce a nakonec FPDFPage_SetRotation s 0. Matice se odvozuje z neotočeného MediaBoxu vráceného funkcí FPDFPage_GetMediaBox

Parametry

PageNumbers — indexy stránek od nuly ke zpracování. Prázdné pole (nebo použití overloadu s jedním argumentem) zploští každou stránku
Options — TPdfFlattenRotationOptions s TransformAnnotations, TransformPageBoxes a AutoUpdate. Default transformuje anotace, vyměňuje stránkové rámce a po každé otočené stránce volá UpdatePage
Report — TPdfFlattenRotationReport s ProcessedPageCount, SkippedPageCount, FailedPageCount, TotalObjectsTransformed a TotalAnnotationsTransformed, plus Succeeded a ErrorMessage

Poznámky

Rotační matice: 90° používá [0, 1, -1, 0, H, 0], 180° používá [-1, 0, 0, -1, W, H], 270° používá [0, -1, 1, 0, 0, W], kde W a H jsou rozměry neotočeného MediaBoxu
Při rotacích 90° a 270° se rozměry MediaBoxu a CropBoxu vymění, takže viditelná stránka si zachová poměr stran. Pokud si volající chtějí rámce přepsat sami, zakažte to pomocí TransformPageBoxes=False
Obdélníky anotací se přemapují stejnou maticí a znovu se sestaví ze všech čtyř transformovaných rohů, protože prohození os může převrátit invarianty left <= right / bottom <= top
Aktuální PageNumber volajícího se uloží a kolem volání obnoví, takže volající mohou bezpečně pokračovat v práci na své dříve aktivní stránce
Stránky už na /Rotate=0 se přeskočí a započítají do Report.SkippedPageCount; běh, kdy se přeskočí vše, stále vrací True, protože nic neselhalo

Příklad

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;

Viz také

PageRotation, TransformPageObject, SetPageBox

FlattenPageRotation metoda