Maintenance Release

PDF 2.0 Support

PDF 2.0 encryption is now supported and you are free to use the following commands with your PDF 2.0 input files:

• encrypt
• decrypt
• changeopw
• changeupw
• permissions

Performance

We can report another 🚀 @fancycode parser improvement resulting in a significant performance boost and lower memory overhead especially for large files:

Before:

$ time go run test.go 
2024/03/21 09:03:55.874443 Parsing ...
2024/03/21 09:04:07.947987 Done, uses 4244 MiBytes heap memory, 6755 MiBytes system memory
2024/03/21 09:04:07.948013 Parsed 1133 pages

real	0m12,743s
user	0m21,830s
sys	0m2,589s

After:

$ time go run test.go 
2024/03/21 09:04:30.639673 Parsing ...
2024/03/21 09:04:30.899588 Done, uses 12 MiBytes heap memory, 11 MiBytes system memory
2024/03/21 09:04:30.899609 Parsed 1133 pages

real	0m0,568s
user	0m0,881s
sys	0m0,228s

Configuration Changes

We have added options to skip some optimization steps or disable internal optimization alltogether:

If you disable the following option there will be no internal optimization of the cross reference table once it is loaded into memory. This will only affect commands that do not rely on optimization like e.g. optimize

# toggle optimization
optimize: true

The following will disable the parsing of page content streams in order to detect unused resources like images or fonts.

# optimize page resources via content stream analysis.
optimizeResourceDicts: true

The following option decides if pdfcpu will scan for and remove duplicate content streams.

# optimize duplicate content streams across pages.
optimizeDuplicateContentStreams: false

⚡ Caution is advised and you have to know what you are doing when using these options. Tuning or turning optimization off can make sense in environments where you deal with large PDF files that usually look the same structure wise so there are no surprises.

Since the pdfcpu configuration has changed you are encouraged to recreate your config.yml:

1. Locate your config.yml using pdfcpu conf
2. Remove/backup your config.yml
3. Create a new config.yml from scratch by executing any pdfcpu cmd on the CLI eg. execute one more time pdfcpu conf
4. Edit your configuration

Thanks

for all of you test driving pdfcpu and reporting 🐛 s along the way. Special PR thanks 👍🏻 also to @adamgreenhall for improving the booklet command and to @xelan as well.

Changelog

• 576f15e Bump version
• 38b2992 Fix #851
• 41333df Cancel parsing in "buffer" if context is cancelled.
• b462c01 Handle case where referenced stream length does not exist.
• ca6d15e Avoid pointer receiver and don't call PDFString of lazy objects internally.
• 91619f0 Write out LazyObjectStreamObject without temporary decoding.
• df5d53d Lazily decode data of StreamObject objects.
• 82f1929 filter: Add API to partially decode data.
• fc09c1f Lazily parse ObjectStream objects.
• 7188e6a Fix #852
• 5bafded Merge PR #855
• 2d06bc7 Add missing author info
• 0988c5e Add PDF 2.0 encryption
• f783bf2 Fix #834
• 87abdcc Fix #849
• d568466 Fix #844
• deb697d Fix #847
• a647579 Fix #843
• 05d2d1f Fix #841
• 6d95797 Fix #839
• 9d76f84 Merge in PR #817
• b9c7a89 Fix #838
• c5db1d9 Fix #826
• 26c5fb2 Fix #826
• aff022f Fix #835, Add config flags for optimization
• 3282d8a Fix #823
• 6158a91 Another fix for #828
• 57030ec Fix #828
• 5ccea97 Fix #135
• fd34b05 Fix #821

Hello!

🧑‍🔬 We packed lots of goodies into this release for you..

Performance

You will like this ✨ Thanks to @fancycode we have improved PDF parsing significantly. While this is not easily comparable running the pdfcpu testsuite is now 8 seconds faster under MacOS 14.2.1:

Before:

./coverage.sh  67.60s user 13.35s system 119% cpu 1:07.93 total

After:

./coverage.sh  59.64s user 12.55s system 107% cpu 1:07.01 total

PDF 2.0 Support

We now have basic support for writing back PDF 2.0 files. This means you may start using all pdfcpu operations that update validated PDF 2.0 files. Basic support means, your mileage may vary, especially when you try to process a file using one of the new 2.0 features.

Since it is hard to get a hand on PDF 2.0 files using a specific new 2.0 feature there is a disclaimer printed on the command line asking for your input and contribution. Please open an issue and share your file in case pdfcpu has a problem digesting your file. The same applies if you just want to see some specific 2.0 feature supported.

In general, please 🙏🏻 report back any issues - there is no way to fix something that does not get reported!

New Zoom Command

pdfcpu zoom [-p(ages) selectedPages] -- description inFile [outFile]

Zoom in/out of selected pages either by magnification factor or corresponding margin. When zooming out the unused page content space results into horizontal and vertical margins. These are different from each other but correspond to a certain factor.

Examples:

Zoom into magnification of 200%

pdfcpu zoom -- "factor: 2"  in.pdf out.pdf

Zoom out to magnification of 50%

pdfcpu zoom -- "factor: .5" in.pdf out.pdf

Zoom out to a magnification equivalent to a horizontal margin of 1 cm

pdfcpu zoom -unit cm -- "hmargin: 1" in.pdf out.pdf

Zoom out to a magnification equivalent to a vertical margin of 30 points. Draw a border around zoomed out page content and fill unused page space light gray

pdfcpu zoom -- "vmargin: 30, border:true, bgcolor:lightgray" in.pdf out.pdf ... 

Please consult pdfcpu help zoom for more and also the official documentation

Enhanced Booklet command

Thanks to @adamgreenhall we have an even more powerful booklet command for producing zines:

We now have booklet styles 2, 4, 6 and 8 and you may choose one of the following booklet types, each representing a certain method for arranging pages into a booklet:

booklet, bookletadvanced, perfectbound

Examples:

Arrange pages of in.pdf 2 per sheet side (4 per sheet, back and front) onto out.pdf

pdfcpu booklet -- "formsize:Letter" out.pdf 2 in.pdf

Arrange pages of in.pdf 4 per sheet side (8 per sheet, back and front) onto out.pdf:

pdfcpu booklet -- "formsize:Ledger" out.pdf 4 in.pdf

Arrange pages of in.pdf 6 per sheet side (12 per sheet, back and front) onto out.pdf

pdfcpu booklet -- "formsize:Ledger" out.pdf 6 in.pdf

Arrange pages of in.pdf 8 per sheet side (16 per sheet, back and front) onto out.pdf

pdfcpu booklet -- "formsize:A3" out.pdf 8 in.pdf

Arrange pages of in.pdf 4 per sheet side, with short-edge binding onto out.pdf

pdfcpu booklet -- "formsize:A3, binding:short" out.pdf 4 in.pdf

Arrange pages of in.pdf 2 per sheetside as sequence of folios covering 4*foliosize pages each.

pdfcpu booklet -- "formsize:A4, multifolio:on" hardbackbook.pdf 2 in.pdf

Arrange pages of in.pdf 2 per sheet side, arranged for perfect binding, onto out.pdf

pdfcpu booklet -- "formsize:A4, btype:perfectbound" out.pdf 2 in.pdf

Arrange pages of in.pdf 4 per sheet side, arranged for advanced binding, onto out.pdf

pdfcpu booklet -- "formsize:A3, btype:bookletadvanced" out.pdf 4 in.pdf

Please consult pdfcpu help booklet for more and also the official documentation

Configuration Changes

There are two changes to the configuration:

1. validationNone was eliminated
2. postProcessValidate is new and enables safeguard validation

Validation mode ValidationNone has been eliminated for a couple of reasons. First of all during validation there are a lot of things happening like internalizing and caching needed for command processing, secondly PDF validation has become quite performant.

We are introducing the new config flag postProcessValidate. This flag which is turned on by default enables the validation of your processed cross reference table right before writing. This is considered a useful safeguard, since in cases when writing back a problematic cross reference table without problems, only the next read/parse/validation attempt will take notice of a problem. If you disable this you will get an additional performance boost overall but with the caveat described above.

As usual please renew your configuration!

Form filling now expects the user font Roboto-Regular when using eastern european scripts. You can do this manually or just remove your pdfcpu configuration all together and recreate it like so:

1. Locate the pdfcpu folder using pdfcpu conf
2. Remove/backup the pdfcpu folder
3. Recreate a brand new pdfcpu folder by executing any pdfcpu cmd on the CLI eg. execute one more time pdfcpu conf
4. Edit your configuration

Samples And Tests

This all is complementing the official documentation

To get a better understanding of pdfcpu's operations please make sure you check out all tests and the corresponding PDF output and all json input where appropriate:

pdfcpu/pkg/samples/* comes loaded with 230 MB worth of PDFs produced by corresponding tests and json input located at:

• pdfcpu/pkg/api/test
• pdfcpu/pkg/testdata/json

Thanks

🙏 to all bug reporters and feature requestors. Special thanks for contributed PRs go to @adamgreenhall, @fancycode, @kalimit, @sivukhin and @afh

Little Commercial Break

pdfcpu is in need of more frequent financial supporters! Please consider becoming a sponsor especially if you are a (small) business 🙏 If you are a developer within a business please go to your superior or team lead and have them compare the benefits/costs vs. commercial solutions. If you prefer to operate in stealth mode that's fine - you can always become a private sponsor. What's important is to keep the project funded and on a clear, steady path 🚀

Meet The Maintainer

I will be in the San Francisco Bay Area this fall. If you are a recurring sponsor or not but a business using pdfcpu I would like to get to know you and your pdfcpu use case. I'll be happy to meet also one-on-one possibly over 🍻 for a technical chat/discussion and to get feedback right from the trenches. Just get in touch with me: [email protected]

Next Steps

Support for PDF 2.0 encryption will be tackled next, after that digital signatures. A Beta version is within reach 👍🏻

Have fun 💚 with pdfcpu!

Changelog

• dfaa588 Bump version, fix #818
• c0a39e9 Add zoom cmd, fix #756
• d581dc1 Fix #809
• 5b7d844 Add config flag postProcessValidate
• 8735421 Fix #815
• 88f1b3d Fix #814
• 268e6bb Merge PR #811
• da12eed Fix #813
• dedaddc Merge #795, cleanup
• 95c2d64 Avoid copying from "bytes.Buffer" to get underlying bytes.
• 044a6c0 Use type switch instead of long list of type tests.
• 3d4cbdb Further improve parsing of dictionaries / names.
• fc87a22 Fix #794
• b4af9ea Eliminate model.ValidationNone
• d5fd063 Fix #807
• 8f3e992 Fix #628
• cfd7627 Finalize extended booklet cmd as contributed by Adam Greenhall
• a893411 Fix booklet cmd parsing, clean up
• d3e607d Fix #807
• 4527ff4 Fix #806
• 18b8e77 Fix #805
• a8b4a4a Fix #798
• 694f81f Fix #794 , add PDF 2.0 disclaimer
• 1d5da77 cli documentation
• 032b32d Fix #773
• 055e03f Fix #765
• 261c563 Fix #758, #770
• 9295163 Fix #779, #780
• 865e6b7 Fix #724
• 222cf6c Fix #796
• 6ae90db Fix #772
• 96659b7 Fix #789
• dae09eb Fix #786
• ac6f14a Fix #766
• 60e13f3 Fix #760
• 6e235c0 Fix #759
• 793c509 Fix #771
• 6935271 Fix bug with types when splitting pdf
• ef9bfc9 add type cast check
• ef759de fix validation in ParseXRefStreamDict for even sized arrays
• 6e5acd7 fix bug in clone for FilterPipeline DecodeParams in StreamDict object
• 12e046d Fix building from distribution archive
• 043541b Fix #775, #490
• 04634d3 Add testcase that parses a large dictionary.
• bec27a4 Avoid calling "DecodeName" when parsing dictionaries.
• d5443fe Add tests for new reading functions that take a Context.
• f2e4421 Add new reading / parsing functions that take a Context object.
• b89d7b1 Fix #766
• e33b502 Fix #755

Hello! 💫

This release comes ready for you to play around with during the 🎄 holidays. It is packed with new features and the first one 🔥 dealing with PDF 2.0 (ISO 32000:2) support. Let's get right into it..

PDF 2.0 Support

We start with basic support for validation and you can play around with the validate and info commands. The work around this is ongoing and will stretch over the next couple of releases. Please 🙏🏻 report back any issues.

CLI

There are three new commands:

Manage the page layout which shall be used when the document is opened:

pdfcpu pagelayout list  inFile
pdfcpu pagelayout set   inFile value
pdfcpu pagelayout reset inFile

➡️ pdfcpu help pagelayout and pagelayout

Manage how the document shall be displayed when opened:

pdfcpu pagemode list  inFile
pdfcpu pagemode set   inFile value
pdfcpu pagemode reset inFile

➡️ pdfcpu help pagemode and pagemode

Manage the way the document shall be displayed on the screen and shall be printed:

pdfcpu viewerpref list [-a(ll)] [-j(son)] inFile
pdfcpu viewerpref set                     inFile (inFileJSON | JSONstring)
pdfcpu viewerpref reset                   inFile

➡️ pdfcpu help viewerpref and viewerpref

The split command now also allows for splitting along page boundaries:

pdfcpu split [-m(ode) span|bookmark|page] inFile outDir [span|pageNr...]

➡️ pdfcpu help split and split

The merge command allows for divider pages at file boundaries and zipping two files together:

pdfcpu merge [-m(ode) create|append|zip] [-s(ort) -b(ookmarks) -d(ivider)] outFile inFile...

➡️ pdfcpu help merge and merge

The permission command is now more useful:

pdfcpu permissions list [-upw userpw] [-opw ownerpw] inFile...
pdfcpu permissions set [-perm none|print|all|max4Hex|max12Bits] [-upw userpw] -opw ownerpw inFile

It now also allows for conveniently setting individual PDF access bits either via a binary or hexadecimal number. ➡️ pdfcpu help permissions and permissions

API

Thanks to @vsenko the stamp command in combination with PDF stamps has become more powerful.

1. You can set the PDF attribute in your Watermark struct with a cached reader which should save you some memory.
2. Multi stamping is the process where the pages of some input PDF file will be stamped one by one with the next page from a stamp PDF file, eg: pdfcpu stamp add -mode pdf -- "stamp.pdf" "" in.pdf out.pdf There is now a way to fine tune multi stamping eg: pdfcpu stamp add -mode pdf -- "stamp.pdf:2:3" "" in.pdf out.pdf will initiate multi stamping at page 2 of stamp.pdf and page 3 of in.pdf

Configuration

There are three changes to the configuration:

1. headerBufSize was eliminated since PDF 2.0 comes with a flexible header location specification.
2. permissions are now a 4 digit hex number instead of a negative integer.
3. needAppearances is a flag you can set for form filling.

Since the pdfcpu configuration has changed you are encouraged to recreate your config.yml:

1. Locate your config.yml using pdfcpu conf
2. Remove/backup your config.yml
3. Create a new config.yml from scratch by executing any pdfcpu cmd on the CLI eg. execute one more time pdfcpu conf
4. Edit your configuration

If and only if you are having fun using pdfcpu...

pdfcpu is in need of financial supporters. There are membership fees, meetings and countless hours I am putting into this project. Please 🙏 consider supporting me in any way you can by becoming a sponsor. Go to your superior or team lead and have them compare the benefits/costs vs. commercial solutions.

Big Thanks

🙏 to all bug reporters and PRs. Have fun 💚 with pdfcpu!

Changelog

• e3358c4c PDF 2.0 safe guard, fix #740, bump version
• dce50855 Fix #665, #473
• cad9003d Fix #723
• 297212bf Fix #732, #733, #734, #472, add vsenko to contr.
• d7a02315 Fix #747
• f7d021cd Fix #739
• 99643282 Fix #727
• cf3b64a4 Fix #738
• d6f60e1a Fix #737
• b34248d2 Fix #736
• 125cee27 Fix #716, add option for merging with divider
• 4f993281 Fix #722, 713
• 18073713 Add Split by page number command
• 821def59 Add viewerpref command
• 9cdf2fd3 add pagemode, pagelayout commands
• 4a2298ca Fix #717
• b4d3bd5e Fix #711
• 685340dc validate PageMode, PageLayout
• 4fbc44ea Fix #710, #635
• 04840dd2 Fix #708
• c5e44051 Fix #701
• 2a899ed3 Fix #705
• 3987bb6e Fix #706
• 5349a52d Fix layout ParsePageFormat
• b4556cce Cleanup table column paddings
• 27f04647 ColPaddings
• d298613c Fix #689
• 7a908c85 Fix #677
• d1a66fd5 Add State/Statemodel validation for TextAnnotation
• c135369f Fix #679, #680
• b42e6eba Fix #676
• 91b6234d Fix #675

🧑‍🔬 The Bookmark Release

Hello!

This release features the new bookmark command and there are substantial changes to the API including better support for scenarios with parallel execution.

CLI

Finally you are able to get rid of unwanted bookmarks, replace existing bookmarks or create even new ones. There are four commands to list your bookmarks, import/export bookmarks via JSON or to remove all bookmarks:

pdfcpu bookmarks list   inFile
pdfcpu bookmarks import [-r(eplace)] inFile inFileJSON [outFile]
pdfcpu bookmarks export inFile [outFileJSON]
pdfcpu bookmarks remove inFile [outFile]

Please check out the documentation.

API

pdfcpu is ready for go 1.21 ! Many API calls now return structs for corresponding objects and thanks to @semvis123 and @yyoshiki41 we were able to remove two significant points of contention. These changes should result in a much better experience running pdfcpu within goroutines. Your feedback is highly appreciated 💚

Parser

As always there is steady improvement to the PDF parser and thanks goes to every single user reporting issues. Remember, only because you are stuck parsing a specific file does not mean we can't do anything about it - but you are encouraged to take the time and file an issue.

pdfcpu is now a proud member of the PDF association

This is a long term commitment for using the optimal resources, going in the right direction in order to make pdfcpu a sound tool for both developers and CLI users for the time to come.

If and only if you are having fun using pdfcpu...

There are membership fees, meetings and countless hours I am putting into this project. Please 🙏 consider supporting me in any way you can by becoming a sponsor. Go to your superior or team lead and have them compare the benefits/costs vs. commercial solutions.

Thanks!

As always 🙏 to all bug reporters and PRs. Have fun 💚 processing your PDFs with pdfcpu!

Changelog

• 1d309dc Add bookmarks cmd, Fix #506, #621, #671, bump version
• be32323 Fix #664, #666, #667, #669
• a9afcfe Fix #663
• 3161cdf Fix #659
• f0e5a70 Fix #664
• 70de7fc Fix concurrent write to map userfontmetrics
• bda08dd Fix #660
• c676831 Cleanup #604
• 7c02e0d fix(api): Protects DisableConfigDir from concurrent access using mutex
• fff3853 Fix #657
• 337d257 Export form errors

Maintenance Release

This release is a cut-off after fixing a couple of issues.

A notable feature of this release is bookmark support for merging PDFs. Existing bookmarks will be preserved during merging and from now on the output file also has a bookmark hierarchy representing the input files.

Bookmarks during merging will be created per default. You can skip bookmark creation on the CLI by supplying -bookmarks=false

If you want to skip bookmark creation when using the API you need to reset a new configuration parameter:

# merge creates bookmarks
createBookmarks: true

Since the pdfcpu configuration has changed you are encouraged to recreate your config.yml:

1. Locate your config.yml using pdfcpu conf
2. Remove/backup your config.yml
3. Create a new config.yml from scratch by executing any pdfcpu cmd on the CLI eg. execute one more time pdfcpu conf
4. Edit your configuration

Please 🙏

pdfcpu is in need of more supporters. If you use it please consider the hard work put into this and consider sponsorship. Go to your superior or team lead and have them compare the benefits/costs vs. commercial solutions.

Thanks!

As always 🙏 to all bug reporters and PRs. Have fun 💚 processing your PDFs with pdfcpu!

Changelog

• 4aef7f7 Bump version
• bc1661f Cleanup
• 7da9606 Fix #649
• 9b69fb1 Fix #654
• d77fba2 Fix #608, #632, #650
• fd12f8b Fix #637
• 353d3c0 Fix #626
• 53c7728 Fix #617, #635
• b36ed33 Merge in PR #631
• b1c460e Fix #636
• 05d0e93 Fix #624
• b17ba03 Fix #644
• df2a612 Fix #623
• bec6f91 Fix #606
• 6bf4168 Fix #622
• 5248cad Fix #630
• 8315a3e Fix #627
• 9dfe68b Fix #618
• a7fd28e Skip PieceInfo validation in relaxed mode

A Release About Cutting PDF Pages

There are three new commands that will cut your PDF page in one way or another:

1. Cut

pdfcpu cut [-p(ages) selectedPages] -- description inFile outDir [outFileName]

A low level command for fine grained custom page cutting. Apply any number of horizontal or vertical page cuts:

➡️ Documentation and examples

---

2. N-down

pdfcpu ndown [-p(ages) selectedPages] -- [description] n inFile outDir [outFileName]

Cut selected page into n pages symmetrically. Think the inverse operation of n-up:

➡️ Documentation and examples

---

3. Poster

pdfcpu poster [-p(ages) selectedPages] -- description inFile outDir [outFileName]

Create a poster with full control over scaling and tile size and more:

➡️ Documentation and examples

---

API-Change

A notable API change is an additional parameter for AddBookmarks. The replace flag enforces deleting any old bookmarks that may be present in the input file: AddBookmarksFile(inFile, outFile string, bms []pdf.Bookmark, replace bool, conf *model.Configuration)

---

As always 🙏 to all bug reporters and PRs. pdfcpu is getting better & better every day 💚 Have fun fiddling around with your PDFs!

.. Ohh, and before jumping right in please do me a favor and click here

---

Changelog

• 0342a83 Bump version
• b80cf0f Fix #383
• c411201 Upgrade dependencies
• 30f3667 Fix #474
• bdf5fd1 Add replace flag to AddBookmarks
• adcdddd Fix #557
• 73c50d3 Fix #448
• e560c3e Fix #586
• add1372 Fix #483
• bb20b1e Fix #598
• 9ffd937 Cleanup
• 7059d42 Cleanup
• 256b5ef Fix #591
• 7fbccb8 Fix #467, #557, #573
• f965b0a wip
• 91d97f3 Fix #583
• 6c0092e Fix #589
• 71a87ec Fix #571
• 8295bb4 compute watermark position in floats, not ints (#610)
• 5348f88 Fix #593
• a410fdc Fix #584
• 92f7b2b Fix #575, #579
• 768cf96 Fix #571, #572
• 25f7cef Bump go.mod
• 1fab2dc Fix #566
• 6e87941 add missing refactoring due to rename (#565)

Hello, the main focus of this release is PDF form management!

This release has been a long time coming 😓 Thank you 🙏 for your patience!

---

API-Users, please proceed with caution! The codebase has been refactored heavily and there may be some side effects.

E.g. usages of: api.Merge(rsc []io.ReadSeeker,...) need to be migrated to api.MergeRaw(rsc []io.ReadSeeker, ...)

---

pdfcpu v0.4.0 is now based on go1.20 and comes with two new commands:

1. The new powerful formcommand solves all major form handling usecases:

pdfcpu form list   inFile...
pdfcpu form remove inFile [outFile] fieldID...
pdfcpu form lock   inFile [outFile] [fieldID...]
pdfcpu form unlock inFile [outFile] [fieldID...]
pdfcpu form reset  inFile [outFile] [fieldID...]
pdfcpu form export inFile [outFileJSON]
pdfcpu form fill inFile inFileJSON [outFile]
pdfcpu form multifill [-m(ode) single|merge] inFile inFileData outDir [outName]

---

DISCLAIMER 1 You are free to export and fill already existing PDF forms - this may or may not work! Feel free to open an issue and we may be able to make it work.

---

DISCLAIMER 2 All forms generated with pdfcpu create are optimized for Adobe Reader. Mac Preview is not suited well for form handling!

---

The following workflows are supported:

The Regular Workflow

• Create your form with the already introduced create command.
• Print a list of your form fields on the command line.
• export your form to JSON,
• Edit your JSON and enter your form data.
• fill your form with this JSON payload.
• Optionally write protect individual fields using lock.

---

The Fill & Merge Workflow

"Give me access to your contacts db and I will generate a single PDF containing a page sequence of contact sheets"

This usecase is implemented by extending the regular workflow by an additional integrated merge step.

As for automatically filling a form with your data pdfcpu gives you two options:

• JSON - better suited for API providers, verbose but powerful JSON elements, allows full fledged imageBoxes for image fields
• CSV - for on-premises bulk fill scenarios, one CSV line representing a form instance, has its limitations eg. need to fake image fields

---

2. The new resize command comes to the rescue when you're stuck with some large pages in front of a regular small form printer:

pdfcpu resize [-p(ages) selectedPages] -- [description] inFile [outFile]

Scale your pages up or down or resize to one of the many supported standard form sizes (pdfcpu paper prints a list ) optionally enforcing portrait or landscape mode:

Examples:

         pdfcpu resize "scale:2" in.pdf out.pdf
            Enlarge pages by doubling the page dimensions, keep orientation.

         pdfcpu resize -pages 1-3 -- "sc:.5" in.pdf out.pdf
            Shrink first 3 pages by cutting in half the page dimensions, keep orientation.

         pdfcpu resize -u cm -- "dim:40 0" in.pdf out.pdf
            Resize pages to width of 40 cm, keep orientation.

         pdfcpu resize "form:A4" in.pdf out.pdf
            Resize pages to A4, keep orientation.

         pdfcpu resize "f:A4P, bgcol:#d0d0d0" in.pdf out.pdf
            Resize pages to A4 and enforce orientation(here: portrait mode), apply background color.

         pdfcpu resize "dim:400 200" in.pdf out.pdf
            Resize pages to 400 x 200 points, keep orientation.

         pdfcpu resize "dim:400 200, enforce:true" in.pdf out.pdf
            Resize pages to 400 x 200 points, enforce orientation.

Countless bugs have been rolling in and many of those have been fixed. Thank you 🙏 all also for your PRs 👍 💚 Unfortunately due to heavy refactoring of the code base some of them had to be merged in manually or still will be.

Changelog

• 7ff654b Bump version
• 580f9d7 Update form samples
• 4ac95e3 Fix #461
• 98c062b Fix #537
• 4e12e03 Fix #363,#524
• 73a7d98 Fix #535
• b45bfb7 Fix #539
• 74efd88 Fix #515
• d26377a Fix #481 Add Rene Kaufmann to contributors
• de1d264 Fix #430 Add Dmitry Ivanov to contributors
• 7af9343 Eliminate io.ReadAll
• a86469b Fix #447
• 7a47cb5 Bump go.mod
• 363a1f2 Add form handling
• 07d9762 Fix #523
• 97106ac Fix #511
• 8f6a813 Fix #466
• a45919b Fix #522
• aa87096 Update Dockerfile (#518)
• 9aa382a fix ListImages comment (#516)
• a021566 Fix #479
• ba2518c Fix #459
• bfaf786 Fix #489
• 4382301 Fix #458
• d8d83be Fix #469
• b9818b8 Fix #497
• d16027e Fix #493
• 5ef3bae Fix #494
• 3decd49 Fix #488
• 5d37c49 Fix #487
• fe532c2 Fix #485
• 0ce7ef0 Fix #471, #475, #478
• 8b9e92e Fix #480
• 11d755a Fix #457
• 432b649 Fix #453
• c54a411 Cleanup
• c202488 Fix free list validation
• e456479 Fix #357, #451
• 74d211b Fix #389
• 8f9a93c Add Fedora instructions (#439)
• a056f85 Fix #446
• 15f4842 Fix #380
• 437ac57 Fix #440
• 437b0a0 Fix #438
• e3d3f26 Fix #429
• adf6c1b Fix #434
• 515c2ef Fix #437
• 17e5f68 Fix #442, #443
• 8c35cdc Cleanup
• 92c29f7 Cleanup
• 1b1f5e4 go lint
• a002745 Fix #385
• 96a0a30 Fix #391
• b8b77ee Fix #411
• 31d2490 Fix #414
• f23a3da Fix #418
• 68200b9 Fix #413
• ad65664 Add issue template
• c78f959 Cleanup
• 013a11b Fix #402
• 8767334 Fix #400
• 6b5d856 Fix of a bug in Fix #407
• df8cec3 Fix #407
• f5de06f Fix #404
• 5a3802e Fix #379
• 9d3225c Add Eng Zer Jun as contributor
• 8e53ad6 refactor: move from io/ioutil to io and os packages (#403)
• c37ef1a Integrate #397, Add Juan Iscar as contributor
• e9f927d Fix #396, Add config cmd
• a8a031e Fix #398

Hello, this release is all about PDF generation!

 

A new command interprets a JSON structure representing page declarations and renders PDF pages accordingly:

pdfcpu create in.json [in.pdf] out.pdf

in.json contains a page sequence with content composed of text, images, colored boxes, tables and more. Each content element follows a box model consisting of margin, border and padding and may define fonts and colors where appropriate. You may also set general page attributes like paper size, background color or your crop box and you may also define your page headers and footers.

in.pdf if present, existing page content of in.pdf will be modified by appending to it.

out.pdf is where rendered pages are written to.

How it works

The way this command is setup allows for repeatedly adding content to a PDF. This fosters an incremental approach to PDF generation which may be during the design phase or in production.

 

Learning

The best documentation for this command is the combination of the content of:

• pkg/testdata/json/ and
• pkg/samples/create/ - the home of the corresponding result PDFs.

If you are a Go developer you can play around with createFromJSON_test.go by modifying the JSON file and then executing the test which will give you immediate visual feedback by regenerating the corresponding result PDF.

The JSON is self explanatory and I highly recommend working through all the examples!

Many of the examples are multi page PDFs so make sure you don't miss anything!

You will learn about

• setting up your layout coordinate system
• absolute vs. anchored positioning
• inheritance of fonts, margin, border, padding
• setting up your custom colors
• setting up your resource dirs for imageBoxes
• setting up pools for reused boxes, images and text
• using guides throughout the layout process
• how to highlight your crop box and content boxes

Note

Although this command allows for the modification of any PDF it works best for PDFs generated by pdfcpu itself.

PDF Forms

Eventually and this release is really the preparation you will be able to create your PDF forms with this command.

To catch a glimpse of this effort have a look at:

• pkg/testdata/json/textfield.json
• pkg/testdata/json/textarea.json
• pkg/testdata/json/checkbox.json
• pkg/testdata/json/radiobuttonsHor.json

and again the corresponding PDF files in pkg/samples/create/

You are welcome to experiment with form generation based on these form element samples but PDF form creation has NOT been released!

🙏 Thanks everybody for submitting issues and PRs 🙏

Thank you for using pdfcpu 💚

Changelog

e89570a Fix OS agnostic fileName resolving dc0561f Bump version 72e4e71 Relax validation for FontDescriptor Lang 9616d4b Add create cmd 3c08a45 Add Stefan Huber as contributor 92bfd3e Extend relaxed validation for CIDToGIDMap c3eb4c0 Fix #335, #358 ba9f089 Fix #349 281745f Fix #353 b80c13b Fix #354 64e3df6 Fix #356 5e1ae87 Fix #362 befba81 Fix #366 5a7da1d Fix #371 437ef37 Fix #380, #387 4adf70c Fix #381 0c4c829 Fix #386 af9e334 Fix #388 6509cea Fix #394 8837dd1 Fix io.Reader based encryption #372 ce70c15 Merge branch 'pr/signalwerk/360' into master 16f43aa stamping: Fix OCG reuse 7e1546b validate cmd: wildcard support

This release is based on go1.16 and comes with two new commands and a wide array of improvements and fixes for both CLI and API:

The new annotation handling supports listing, adding and removing annotations via the API and listing and removing annotations via the CLI:

pdfcpu annotations list   [-p(ages) selectedPages] inFile
pdfcpu annotations remove [-p(ages) selectedPages] inFile [objNr...]

Image extraction was improved in several ways. There is support for cascaded filters and as of now pdfcpu also recognizes thumbnails. There is also a related command that prints a list of images for selected pages including available details:

pdfcpu images list [-p(ages) selectedPages] inFile

• The boxes and info command now include the effective page rotation and orientation.
• You can now include links in your stamps using the url parameter.

Using the API you can now generate your own bookmarks aka outline hierarchy. See more: bookmarks_test.go

🙏 Thanks everybody for submitting issues and PRs 🙏 There were lots of bugs fixed and PRs processed. Not all of the PRs were actually merged in, because of the state of things, but rest assured digested into the code base and honored under the contributors list on the README.md. Special thanks go to @petervwyatt and @kpym for their continued suggestions and valuable input.

Changelog

b911d21 info/boxes: add page rotation and orientation 6d519ce Add simple annotation handling 5b54825 Add stamps with links, Add annotation cmd b4ed6bb Embed config.yml cafccf8 Extract file writing fd08184 Extract images in memory 49c75a6 Fix #300, #323, #329, #336 b0c73af Fix #320 075feb9 Fix #322 7100142 Fix #324 680ae89 Fix #325 7a62cd0 Fix #326 e4890f2 Fix #330 694d519 Fix #331 c796f33 Fix #332 573ad83 Fix #333 2616a40 Fix #334, #342 662f7e8 Fix #350 f2aa684 Fix #335 19c3126 Fix #338 9fe5913 Fix #341 b8f382a Fix #343 c7d720b Fix #347 6c0ee1e Fix date validation f06c608 Fix rename err ac9adc6 Improve error context during validation 72223c3 Merge AcroForms 4ae05ab Merge branch 'extract-img-inmem' into master f189660 Simplify test

This release introduces stamping/watermark support for right to left scripts such as Arabic, Hebrew, Persian or Urdu:

Check out some samples at pdfcpu/pkg/samples/stamp/text/utf8 and the corresponding test at pdfcpu/pkg/api/test/stampUserFont_test.go

❗ Since this is really a piggyback release don't forget to check the v0.3.10 release notes as well.

Changelog

956f29f Add right to left stamping