If both PDF-file and stream-object-number are given as arguments, and stream-object-number is positive, pdftosrc extracts and uncompresses the PDF stream of the object given by its stream-object-number from the PDF-file and writes it to a file named PDF-file.stream-object-number with the ending .pdf or .PDF stripped from the original PDF-file name.
A special case is related to XRef object streams that are part of the PDF standard from PDF-1.5 onward: If stream-object-number equals -1, then pdftosrc decompresses the XRef stream from the PDF file and writes it in human-readable PDF cross-reference table format to a file named PDF-file.xref (these XRef streams can not be extracted just by giving their object number).
In any case an existing file with the output file name will be overwritten.
All messages go to stderr. At program invocation, pdftosrc issues the current version number of the program xpdf, on which pdftosrc is based:
When the object given by the stream-object-number does not contain a stream, pdftosrc issues the following error message:
Only the stream of the object will be written, i. e. not the dictionary of that object.
Knowing which stream-object-number to query requires information about the PDF file that has to be gained elsewhere, e. g. by looking into the PDF file with an editor.
The stream extraction capabilities of pdftosrc (e. g. regarding understood PDF versions and filter types) follow the capabilities of the underlying xpdf program version.
Currently the generation number of the stream object is not supported. The default value 0 (zero) is taken.
The wording stream-object-number has nothing to do with the `object streams' introduced by the Adobe PDF Reference, 5th edition, version 1.6.
\immediate\pdfobj
stream attr {/Type /SourceFile /SourceName (myfile.zip)}
Then this zip file can be extracted from the PDF-file by calling pdftosrc PDF-file.
Email bug reports to pdftex@tug.org.
Man page written by Hartmut Henkel.
This file is part of pdfTeX.
pdfTeX is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
pdfTeX is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with pdfTeX; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA