Skip to content

Commit a6318bb

Browse files
committed
Add sample PDF files and update documentation
- Add two sample PDF files from PDF Association (CC BY-SA 4.0): - Simple PDF 2.0 file.pdf (basic example) - pdf20-utf8-test.pdf (complex example with UTF-8, bookmarks, layers) - Update README.md with sample files section and attribution - Add PDF Association to acknowledgments - Remove README.pdf (replaced by comprehensive README.md)
1 parent 7777143 commit a6318bb

File tree

4 files changed

+26
-0
lines changed

4 files changed

+26
-0
lines changed

README.md

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -282,6 +282,9 @@ DX-Pdfium4D/
282282
├── assets/ # Icons and logos
283283
│ ├── Icon.svg # Application icon (source)
284284
│ └── Logo.svg # DX Pdfium4D logo
285+
├── samples/ # Sample PDF files for testing
286+
│ ├── Simple PDF 2.0 file.pdf # Basic PDF 2.0 example
287+
│ └── pdf20-utf8-test.pdf # Complex PDF with UTF-8, bookmarks, layers
285288
└── lib/ # Third-party libraries
286289
├── pdfium-bin/ # PDFium binaries
287290
└── DUnitX/ # Unit testing framework
@@ -338,6 +341,28 @@ Unit testing framework:
338341

339342
---
340343

344+
## Sample PDF Files
345+
346+
The `samples/` directory contains example PDF files for testing and demonstration purposes:
347+
348+
### Simple PDF 2.0 file.pdf
349+
A basic single-page PDF 2.0 file demonstrating:
350+
- Simple text and path operators
351+
- Commented content stream for educational purposes
352+
- Example XMP metadata fields
353+
354+
### pdf20-utf8-test.pdf
355+
A more complex PDF 2.0 file featuring:
356+
- UTF-8 encoded text strings (new in PDF 2.0)
357+
- Outlines (bookmarks) with Unicode characters
358+
- Optional Content layers with UTF-8 names
359+
- AltText and Information dictionary with UTF-8 values
360+
- Non-trivial Unicode characters for testing
361+
362+
**Attribution:** Sample PDF files are provided by the [PDF Association](https://github.com/pdf-association/pdf20examples) under the [Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)](https://creativecommons.org/licenses/by-sa/4.0/) license.
363+
364+
---
365+
341366
## Testing
342367

343368
DX Pdfium4D includes comprehensive unit tests for the PDFium wrapper classes.
@@ -449,6 +474,7 @@ Special thanks to:
449474

450475
- **Google** - For creating and maintaining the [PDFium library](https://pdfium.googlesource.com/pdfium/)
451476
- **Benoît Blanchon** - For maintaining [PDFium binaries](https://github.com/bblanchon/pdfium-binaries)
477+
- **PDF Association** - For providing [PDF 2.0 example files](https://github.com/pdf-association/pdf20examples) for testing
452478
- **VSoft Technologies** - For the excellent [DUnitX](https://github.com/VSoftTechnologies/DUnitX) testing framework
453479
- **Embarcadero** - For Delphi and the FireMonkey framework
454480
- **The Delphi Community** - For continuous support and feedback

README.pdf

-144 KB
Binary file not shown.

samples/Simple PDF 2.0 file.pdf

5.09 KB
Binary file not shown.

samples/pdf20-utf8-test.pdf

13.6 KB
Binary file not shown.

0 commit comments

Comments
 (0)