Vývojářská reference PDFiumPas

Přehled produktu

PDFiumPas je rozsáhlá, profesionální knihovna komponent, která přináší do aplikací v Delphi a C++Builderu výkonné možnosti pro zpracování a prohlížení PDF. Je postavená na robustním vykreslovacím jádru PDFium od Googlu a nabízí vývojářům kompletní řešení pro integraci PDF funkcí do desktopových aplikací

Knihovna se skládá ze dvou hlavních komponent, které spolu hladce spolupracují: TPdf pro zpracování a úpravy dokumentů a TPdfView pro interaktivní vizuální prezentaci. Ať už potřebujete vytvořit jednoduchý prohlížeč PDF, složitější systém správy dokumentů nebo přidat PDF podporu do existující aplikace, PDFiumPas poskytuje potřebné nástroje i flexibilitu

Jádrové komponenty

Komponenta TPdf - jádro zpracování dokumentů

Srdce systému pro zpracování PDF, TPdf zajišťuje všechny operace na úrovni dokumentu včetně načítání, ukládání, extrakce textu, práce s formuláři a správy metadat

Správa dokumentů: Otevírání ze souborů, streamů nebo paměťových bufferů
Zpracování textu: Pokročilá extrakce textu a možnost vyhledávání
Práce s formuláři: Plná podpora interaktivních formulářů včetně JavaScriptu
Zabezpečení: Podpora PDF chráněných heslem a správa oprávnění
Přístup k metadatům: Kompletní vlastnosti dokumentu a načítání informací

Komponenta TPdfView - interaktivní ovládací prvek pro prohlížení

Pokročilý vizuální prvek, který poskytuje bohaté prostředí pro prohlížení PDF s plnými možnostmi uživatelské interakce

Vysoká kvalita vykreslování: Optimalizované zobrazení s více režimy vykreslení
Interaktivní navigace: Přibližování, posun, rotace a pohyb mezi stránkami
Výběr textu: Označování, kopírování a práce s textovým obsahem
Zobrazení anotací: Prohlížení a interakce s PDF anotacemi
Myš a klávesnice: Plná podpora vstupních zařízení včetně mapování souřadnic

Klíčové funkce a možnosti

Zpracování dokumentů

Načítání PDF dokumentů ze souborů, streamů, paměťových bufferů nebo adaptérů TStream na vyžádání přes LoadCustomDocument
Ukládání a export dokumentů s různými volbami, včetně přírůstkového zápisu, odebrání zabezpečení a volby cílové verze PDF
Kontrola shody verze PDF odmítá funkce novější než zvolený cíl (PDF 1.0 až 1.7)
Vytváření PDF/A-1b přes SaveAsPdfA / SaveAsPdfAToStream s přiloženým profilem sRGB ICC a podporou vlastních profilů
Ověřování PDF/A přes ValidatePdfA a jen pro čtení dostupnou vlastnost PdfAConformance
Práce s PDF chráněnými heslem a šifrovanými dokumenty
Správa metadat a vlastností dokumentu
Skládání stránek: ImportPagesByIndex (import výřezu), ImportNPagesToOne (mřížka N-up), MovePages (přeskládání na místě)
Znovupoužití stránky jako Form XObject: otisk jedné stránky do více cílů přes CreateXObjectFromPage a InsertFormObjectFromXObject
Podpora záložek a cílů
Zploštění formulářů: znovu vytvoří appearance streamy (/AP) z hodnot polí a pak vloží anotace a widgety formuláře do statického obsahu stránky

Textové a obsahové operace

Pokročilá extrakce textu se zachováním formátování
Výkonné vyhledávání textu s více volbami
Analýza textu na úrovni znaků a jeho pozicování
Přístup k informacím o fontech a jejich vlastnostech
Výběr textu a operace se schránkou
Podpora více jazyků a Unicode

Interaktivní formuláře a anotace

Plná podpora interaktivních formulářových polí
Textová pole, zaškrtávací políčka, přepínače, rozbalovací seznamy
Validace formulářů a spouštění JavaScriptu
Zobrazení a interakce s anotacemi
Odkazové anotace a webové odkazy
Podpora digitálních podpisů

Vizuální vykreslování a zobrazení

Vysoce kvalitní antialiasované vykreslování s přímým zápisem bez kopie do cílového bufferu DIB
Přerušitelné progresivní vykreslování přes RenderPageProgressive a IPdfCancellationToken
Více režimů zobrazení, tedy průběžné jedno-sloupcové, průběžné dvousloupcové a dvousloupcové s titulní stránkou
FitMode určuje, jak stránka sedí ve výřezu (ruční zoom, skutečná velikost, přizpůsobení celé stránky, přizpůsobení šířce); po změně velikosti nebo stránky se znovu aplikuje automaticky
PageColor odděluje pozadí vykreslené PDF stránky od Color okolního ovládacího prvku pro prohlížeče v tmavém režimu
Zvýraznění výsledků hledání přes HighlightSearchText a ClearHighlight
Volitelný stín stránky (PageShadowSize / PageShadowColor) a okraj stránky (PageBorderColor)
Bezpečné zpracování kliknutí na odkazy s povolenými akcemi po jednotlivých typech (LinkOptions) a událostmi OnAnnotationLinkClick / OnWebLinkClick
Uzamčení uživatelského vstupu (AllowUserPageChange, ChangePageOnMouseScrolling, AllowUserTextSelection) pro kiosky a jen pro čtení vložené komponenty
Navigace přes miniatury pomocí boční komponenty TPdfThumbnailView
Vykreslování textu optimalizované pro LCD
Výstup v kvalitě pro tisk s volitelnými režimy tisku PDFium (EMF, pouze text, PostScript Level 2 / 3, pass-through, image-mask, Type 42)
Vlastní barevné a odstínové vykreslování

Funkce přívětivé pro vývojáře

Komplexní systém událostí pro přizpůsobení
Přesné mapování souřadnic mezi obrazovkou a PDF
Rozsáhlé API vlastností a metod
Podpora v návrhovém čase včetně editorů vlastností
Vlákny bezpečné operace tam, kde to dává smysl
Paměťově úsporné zpracování velkých dokumentů

Technické specifikace

Oblast	Podrobnosti
Vykreslovací jádro	Google PDFium - průmyslový standard, dlouhodobě prověřené PDF jádro
Podpora PDF	Verze PDF 1.0 až 1.7, šifrované a heslem chráněné soubory
Kompatibilita platforem	Aplikace pro Windows 32bitové i 64bitové
Podpora IDE	Delphi XE5 / C++Builder XE5 (RAD Studio XE5) až Delphi/C++Builder 13.1 Florence (RAD Studio 13.1), Lazarus 3.8+
Kódování znaků	Plná podpora Unicode, zpracování vícejazyčného textu
Správa paměti	Optimalizováno pro velké dokumenty a efektivní využití prostředků
Bezpečnost vláken	Jednovláknový návrh podle požadavků PDFium

Návrh architektury

PDFiumPas používá vrstvenou architekturu, která čistě odděluje odpovědnosti a maximalizuje znovupoužitelnost kódu

Vrstvená architektura

Vrstva	Soubory	Odpovědnost
Komponenty VCL	PDFium.pas, FPdfThumbnail.pas	Delphi VCL komponenty (`TPdf`, `TPdfView`, `TPdfThumbnailView`) s podporou návrhového času
API vazby	FPdfView.pas, FPdfDoc.pas, FPdfText.pas, FPdfEdit.pas, FPdfAnnot.pas, FPdfFormFill.pas, FPdfPageOps.pas, FPdfAttachment.pas, FPdfSignature.pas, FPdfStructTree.pas, FPdfDataAvail.pas, FPdfExtensions.pas, FPdfFWLEvent.pas, FPdfCompress.pas, FPdfUtils.pas	Deklarace ukazatelů na funkce pro volání PDFium DLL
PDF/A pipeline	FPdfPdfa.pas	Vytváření PDF/A-1b (vložením XMP, sRGB ICC OutputIntent a aktualizací katalogu) a validace (zjištění shody, výčet problémů)
Asynchronní infrastruktura	FPdfAsync.pas	`IPdfCancellationToken` / `IPdfCancellationTokenSource`, singleton `PdfNoCancellationToken` a pomocník `TPdfFuture<T>` pro dlouho běžící vykreslování a export
Geometrické pomocníky	FPdfMatrix.pas	OO obal kolem `FS_MATRIX` s pomocníky Translate, Scale, Rotate, Flip, Skew a Multiply
Operace se stránkami	FPdfPageOps.pas	Obaly pro `FPDF_ImportPagesByIndex`, `FPDF_ImportNPagesToOne`, `FPDF_MovePages` a pomocníky Form-XObject (`CreateXObjectFromPage` / `InsertFormObjectFromXObject`)
Boční panel miniatur	FPdfThumbnail.pas	`TPdfThumbnailView` - posuvný panel miniatur po stránkách s najetím myší, výběrem a navigací přes `OnPageClick`
Nativní jádro	DLLs\Win32\|Win64\pdfium.dll a pdfium.v8.dll	Nativní vykreslovací jádro Google PDFium s volitelnými sestaveními s podporou V8

Hierarchie komponent

TPdf (TComponent) - Nevizuální komponenta pro operace s PDF dokumenty
TPdfView (TScrollingWinControl) - Vizuální ovládací prvek dědící posouvání a podporu fokusu
TPdfThumbnailView (TCustomControl) - Posuvný boční panel miniatur navázaný na komponentu TPdf

Klíčové návrhové vzory

Dynamické načítání DLL: Funkce PDFium se načítají za běhu přes GetProcAddress
Prostředky založené na handlu: PDF dokumenty, stránky i objekty se spravují přes neprůhledné handly
Architektura řízená událostmi: Rozsáhlé události pro práci s formuláři, změny stránek i vykreslování
Typy založené na recordech: Složitější datové struktury vystavené jako Delphi recordy (TBookmark, TDestination, TPdfAnnotation atd.)
Volitelní pomocníci: FPdfAsync a FPdfMatrix poskytují nástroje pro zrušení, future a transformace, aniž by je vnucovali do hlavní komponenty TPdf

Scénáře použití

Podnikové aplikace

Systémy správy dokumentů: Zobrazení, organizace a zpracování PDF dokumentů
Prohlížeče reportů: Zobrazení generovaných reportů a obchodních dokumentů
Zpracování formulářů: Práce s interaktivními PDF formuláři a sběrem dat
Archivní systémy: Přístup k historickým PDF dokumentům a jejich zobrazení

Vzdělávání a výzkum

E-learningové platformy: Zobrazení studijních materiálů a učebnic
Výzkumné nástroje: Analýza a extrakce dat z odborných prací
Digitální knihovny: Procházení a vyhledávání v dokumentových sbírkách
Aplikace pro poznámky: Anotace a zvýrazňování obsahu PDF

Právo a compliance

Kontrola právních dokumentů: Prohlížení smluv a právních materiálů
Compliance systémy: Ověřování integrity dokumentů a podpisů
Správa případů: Organizace a kontrola právní dokumentace
Auditní nástroje: Zpracování a analýza regulačních dokumentů

Technika a inženýrství

CAD prohlížeče: Zobrazení technických výkresů a specifikací
Manuálové systémy: Přístup k údržbovým a provozním příručkám
Kontrola kvality: Revize zkušebních zpráv a certifikací
Projektové řízení: Práce s projektovou dokumentací a plány

Výhody a přínosy

Výkon a spolehlivost

Osvědčená technologie: Postaveno na jádru PDFium od Googlu používaném v prohlížeči Chrome
Vysoký výkon: Optimalizované vykreslování a správa paměti
Stabilita: Rozsáhle testováno na tisících PDF dokumentů
Škálovatelnost: Zvládá malé formuláře i velké vícestránkové dokumenty

Hodnota pro byznys

Rychlý vývoj: Komplexní API zkracuje čas vývoje
Bez licenčních poplatků: Žádné runtime poplatky ani licenční komplikace
Zdrojový kód v balíčku: Plná možnost přizpůsobení i ladění
Dlouhodobá podpora: Pravidelné aktualizace a údržba kompatibility

Zkušenost vývojáře

Snadná integrace: Komponenty k okamžitému použití s minimem nastavení
Bohatá dokumentace: Komplexní nápověda a příklady
Řízení událostmi: Flexibilní přizpůsobení přes rozsáhlé události
Podpora v návrhovém čase: Editory vlastností a integrace do IDE

Další odkazy

Domů - Vstupní bod webové navigace
Průvodce rychlým startem - Zprovoznění během několika minut
Pokyny k instalaci - Nastavení a konfigurace
Kódové příklady - Praktické scénáře použití
Úplná reference API - Úplná dokumentace komponent
Komponenta TPdf - Podrobnosti o zpracování dokumentů
Komponenta TPdfView - Podrobnosti o ovládacím prvku pro prohlížení

Knihovna komponent PDFiumPas