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
pdfium.exe as Administrator
- Select IDE: Choose your development environment (Delphi/C++Builder/Lazarus)
- 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
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