Installation Guide
System Requirements
- Delphi XE5 / C++Builder XE5 (RAD Studio XE5) to Delphi/C++Builder 13.1 Florence (RAD Studio 13.1)
- Lazarus 1.0 or later (for Free Pascal)
- Windows XP or later (Win32 / Win64)
- Minimum 50 MB free disk space
Installation Steps
- Run the installer: Execute
PDFiumPas-FULL.exe or PDFiumPas-TRIAL.exe as Administrator
- Select IDE integration: On the RAD Studio Integration page, detected Delphi personalities are listed first with the newest version pre-ticked; C++Builder personalities are listed separately and are off by default
- Select optional content: Tick C++Builder or Lazarus only when those package files and demo projects should be installed
- Choose installation path: Select the directory where components will be installed
- Complete installation: Follow the on-screen instructions
- Verify installation: The following components will be added to the losLab palette:
- TPdf - Core PDF manipulation component
- TPdfView - PDF viewing and interaction component
Localized Help and Demo Builds
- The installer always installs the shared
Docs assets and then copies only the help language folders selected by the Windows locale name and UI language LCID.
- English help uses
en-GB for supported British, Commonwealth, and Caribbean English locales; en-US is used for other English locales and as the fallback when no regional help set matches.
- Spanish help is split between
es for Spain-style locales and es-419 for Latin American locales; Chinese help is split between zh-cn and zh-tw.
- Matching localized help sets are added when available for Arabic, German, French, Italian, Japanese, Korean, Dutch, Polish, Portuguese, Russian, Swedish, Turkish, and Chinese UI languages or locale names.
- Post-install Delphi and C++Builder demo builds use the latest selected RAD Studio root and require the matching Delphi or C++Builder personality plus the requested Win32 / Win64 compiler.
Manual Installation (Advanced)
If automatic installation fails, you can manually install the components:
- Copy the component files to your IDE's library path
- Add the library path to your IDE's search directories
- Install the design-time package through IDE's Package Manager
- Rebuild your IDE to register the components
Redistribution
When distributing applications that use PDFium VCL:
- Include the matching
DLLs\Win32\pdfium.dll or DLLs\Win64\pdfium.dll tree beside your application or in a parent application folder
- For V8/XFA form support, include the matching
DLLs\Win32\pdfium.v8.dll or DLLs\Win64\pdfium.v8.dll in the same DLLs tree and set EnableV8Engine before loading
- No additional runtime licenses required
- Royalty-free distribution for compiled applications
Troubleshooting
Common Issues:
- Components not visible: Ensure IDE was restarted after installation
- Runtime errors: Verify the correct PDFium DLL is in
DLLs\Win32 or DLLs\Win64, or directly in the application path
- Access violations: Check that all required dependencies are installed and DLL architecture matches application (32-bit vs 64-bit)
- Design-time errors: Rebuild packages and restart IDE
- XFA forms not working: Ensure the matching
pdfium.v8.dll is available in the platform DLLs folder and EnableV8Engine is set before loading
Uninstallation
To remove PDFium VCL components:
- Use Windows Add/Remove Programs
- Or run the uninstaller from the installation directory
- Manually remove any remaining files if necessary