From 7f8892525f897b17049f9e59bc4ce8ac28c9e082 Mon Sep 17 00:00:00 2001 From: Jay Berkenbilt Date: Thu, 27 Jul 2017 23:42:27 -0400 Subject: Add precheck streams capability When requested, QPDFWriter will do more aggress prechecking of streams to make sure it can actually succeed in decoding them before attempting to do so. This will allow preservation of raw data even when the raw data is corrupted relative to the specified filters. --- manual/qpdf-manual.xml | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) (limited to 'manual') diff --git a/manual/qpdf-manual.xml b/manual/qpdf-manual.xml index a4c34e90..cd35718d 100644 --- a/manual/qpdf-manual.xml +++ b/manual/qpdf-manual.xml @@ -821,6 +821,23 @@ outfile.pdf + + + + + Tells qpdf to precheck each stream for the ability to decode + it. Ordinarily qpdf tries to decode streams that it thinks it + can decode based on the filters, and if there ends up being an + error when actually trying to do the decode, the stream data + is truncated. This flag causes qpdf to actually read the + stream fully before deciding whether to filter the stream. + This option will slow qpdf down since it will have to read the + stream twice, but it allows raw stream data to be preserved in + cases where the decoding of the stream would fail for some + reason. This may be useful in working with some damaged files. + + + -- cgit v1.2.3-54-g00ecf