fenix
/
cpdf-source
mirror of https://github.com/johnwhitington/cpdf-source.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

more

This commit is contained in:
John Whitington 2019-07-22 17:35:15 +01:00
parent 0505d574d3
commit 03615cf38a
2 changed files with 41 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

BIN
cpdfmanual.pdf
View File

Binary file not shown.

57
cpdfmanual.tex
View File

@ -102,7 +102,9 @@ verbosity. Under Microsoft Windows, type \texttt{cpdf.exe} instead of \texttt{cp
-keep-l -no-preserve-objstm -create-objstm -keep-l -no-preserve-objstm -create-objstm
-control <filename> -args <filename> -utf8 -control <filename> -args <filename> -utf8
-stripped -raw -no-embed-font -stripped -raw -no-embed-font
-create-pdf -create-pdf-pages -create-pdf-papersize\end{verbatim}\end{framed} -create-pdf -create-pdf-pages -create-pdf-papersize
-gs -gs-malformed -gs-force-malformed
-gs-quiet\end{verbatim}\end{framed}
The Coherent PDF tools provide a wide range of facilities for modifying PDF The Coherent PDF tools provide a wide range of facilities for modifying PDF
files created by other means. There is a single command-line program files created by other means. There is a single command-line program
@ -356,12 +358,13 @@ are intended to support:
PDF 1.4 & Acrobat 5.0 \\ PDF 1.4 & Acrobat 5.0 \\
PDF 1.5 & Acrobat 6.0 \\ PDF 1.5 & Acrobat 6.0 \\
PDF 1.6 & Acrobat 7.0 \\ PDF 1.6 & Acrobat 7.0 \\
PDF 1.7 & Acrobat 8.0, 9.0, 10.0 PDF 1.7 & Acrobat 8.0, 9.0, 10.0\\
PDF 2.0 & Acrobat 11.0, DC
\end{tabular} \end{tabular}
\vspace{2mm} \vspace{2mm}
\noindent If you wish to manually alter the PDF version of a file, use the \noindent If you wish to manually alter the PDF version of a file, use the
\texttt{-set-version} option described in Section \ref{setversion}. \texttt{-set-version} operation described in Section \ref{setversion}.
\section{File IDs} \section{File IDs}
PDF files contain an ID (consisting of two parts), used by some workflow PDF files contain an ID (consisting of two parts), used by some workflow
@ -450,6 +453,21 @@ progress is shown on \verb!stderr! (Standard Error):
\small\verb$Malformed PDF reconstruction succeeded!$ \small\verb$Malformed PDF reconstruction succeeded!$
\end{framed} \end{framed}
If cpdf cannot reconstruct a malformed file, it is able to use the \texttt{gs} program to try to reconstruct the program, if you have it installed. For example, if \texttt{gs} is installed and in your path, we might try:
\begin{framed}
\noindent\small\verb!./cpdf -gs gs -gs-malformed in.pdf -o out.pdf!\end{framed}
If the malformity lies inside an individual page of the PDF, rather than in its gross structure, cpdf may appear to succeed in reconstruction, only to fail when processing a page (e.g when adding text). To force the use of \texttt{gs} to pre-process such files so cpdf cannot fail on them, use \texttt{-gs-malformed-force}:
\begin{framed}
\noindent\small\verb!./cpdf -gs gs -gs-malformed-force in.pdf -o out.pdf!\end{framed}
The command line for \texttt{-gs-malformed-force} must be of \textit{precisely} this form.
To suppress the output of \texttt{gs} use the \texttt{-gs-quiet} option.
\noindent Sometimes files can be technically well-formed but use inefficient PDF \noindent Sometimes files can be technically well-formed but use inefficient PDF
constructs. If you are sure the input files you are using are constructs. If you are sure the input files you are using are
impeccably formed, the \texttt{-fast} option added to the command line (or, if impeccably formed, the \texttt{-fast} option added to the command line (or, if
@ -915,7 +933,7 @@ page rotation when considering what "horizontally" and "vertically" mean, so you
\index{media box} \index{media box}
All PDF files contain a \textit{media box} for each page, giving the All PDF files contain a \textit{media box} for each page, giving the
dimensions of the paper. To change these dimensions (without altering the page dimensions of the paper. To change these dimensions (without altering the page
contents in any way), use the \texttt{-mediabox} option. contents in any way), use the \texttt{-mediabox} operation.
\begin{framed} \begin{framed}
\small\verb!cpdf -mediabox "0pt 0pt 500pt 500pt" in.pdf -o out.pdf! \small\verb!cpdf -mediabox "0pt 0pt 500pt 500pt" in.pdf -o out.pdf!
@ -1185,7 +1203,7 @@ the ASCII range. To prevent this, and return unicode UTF8 output, add the
\index{bookmarks!adding} \index{bookmarks!adding}
The \texttt{-add-bookmarks} file adds bookmarks as specified by a The \texttt{-add-bookmarks} file adds bookmarks as specified by a
\textit{bookmarks file}, a text file in ASCII or UTF8 encoding and in the same format as that produced by the \textit{bookmarks file}, a text file in ASCII or UTF8 encoding and in the same format as that produced by the
\texttt{-list-bookmarks} option. If there are any bookmarks in the input PDF \texttt{-list-bookmarks} operation. If there are any bookmarks in the input PDF
already, they are discarded. For example, if the file \texttt{bookmarks.txt} already, they are discarded. For example, if the file \texttt{bookmarks.txt}
contains the output from \texttt{-list-bookmarks} above, then the command contains the output from \texttt{-list-bookmarks} above, then the command
\begin{framed} \begin{framed}
@ -1198,7 +1216,7 @@ tree with no entry being more than one greater than the last).
\section{Opening bookmarks} \section{Opening bookmarks}
As an alternative to extracting a bookmark file and manipulating the open-status of bookmarks, mass manipulation may be achieved by the following option. As an alternative to extracting a bookmark file and manipulating the open-status of bookmarks, mass manipulation may be achieved by the following operation:
\begin{framed} \begin{framed}
\small\verb!cpdf -open-bookmarks-to-level <level> in.pdf -o out.pdf! \small\verb!cpdf -open-bookmarks-to-level <level> in.pdf -o out.pdf!
@ -1826,7 +1844,7 @@ name, the fifth the PDF font encoding.
\section{Reading Document Information} \section{Reading Document Information}
\label{info} \label{info}
The \texttt{-info} option prints entries from the document information The \texttt{-info} operation prints entries from the document information
dictionary, and from any XMP metadata to standard output. dictionary, and from any XMP metadata to standard output.
\begin{framed} \begin{framed}
@ -1857,7 +1875,7 @@ Appendix~\ref{dates}.
By default, cpdf strips to ASCII, discarding character codes in excess of 127. In order to preserve the original unicode, add the \texttt{-utf8} option. To disable all postprocessing of the string, add \texttt{-raw}. By default, cpdf strips to ASCII, discarding character codes in excess of 127. In order to preserve the original unicode, add the \texttt{-utf8} option. To disable all postprocessing of the string, add \texttt{-raw}.
\vspace{4mm} \vspace{4mm}
The \texttt{-page-info} option prints the page label, media box and other boxes The \texttt{-page-info} operation prints the page label, media box and other boxes
page-by-page to standard output, for all pages in the current range. page-by-page to standard output, for all pages in the current range.
\begin{framed} \begin{framed}
@ -1926,7 +1944,7 @@ option is added---in which case, it is unprocessed, save for the replacement of
\subsection{Page Layout} \subsection{Page Layout}
\index{page!layout} \index{page!layout}
The \texttt{-set-page-layout} option specifies the page layout to be used The \texttt{-set-page-layout} operation specifies the page layout to be used
when a document is opened in, for instance, Acrobat. The possible when a document is opened in, for instance, Acrobat. The possible
(case-sensitive) values are: (case-sensitive) values are:
@ -2084,7 +2102,7 @@ attachments} --- that is, ones which are associated with the document as a
whole rather than with an individual page, and also \textit{page-level attachments}, associated with a particular page. whole rather than with an individual page, and also \textit{page-level attachments}, associated with a particular page.
\section{Adding Attachments} \section{Adding Attachments}
\index{attachments!adding} \index{attachments!adding}
To add an attachment, use the \texttt{-attach-file} option. For instance, To add an attachment, use the \texttt{-attach-file} operation. For instance,
\begin{framed} \begin{framed}
\small\verb!cpdf -attach-file sheet.xls in.pdf -o out.pdf! \small\verb!cpdf -attach-file sheet.xls in.pdf -o out.pdf!
\end{framed} \end{framed}
@ -2145,7 +2163,7 @@ The \texttt{-dump-attachments} operation, when given a PDF file and a directory
\section{Remove an image} \section{Remove an image}
To remove a particular image, find its name using \texttt{-image-resolution} with a sufficiently high resolution (so as to list all images), and then apply the \texttt{-draft} and \texttt{-draft-remove-only} options from Section \ref{draft}. To remove a particular image, find its name using \texttt{-image-resolution} with a sufficiently high resolution (so as to list all images), and then apply the \texttt{-draft} and \texttt{-draft-remove-only} operations from Section \ref{draft}.
% \section{Extracting Images} % \section{Extracting Images}
% \begin{framed} % \begin{framed}
@ -2170,6 +2188,9 @@ To remove a particular image, find its name using \texttt{-image-resolution} wit
\vspace{1.5mm} \vspace{1.5mm}
\noindent\verb!cpdf -missing-fonts in.pdf! \noindent\verb!cpdf -missing-fonts in.pdf!
\vspace{1.5mm}
\noindent\verb!cpdf -embed-missing-fonts -gs <path to gs> in.pdf -o out.pdf!
\end{framed}} \end{framed}}
\section{Copying Fonts} \section{Copying Fonts}
\label{copyfont} \label{copyfont}
@ -2208,17 +2229,21 @@ recommended when file size is the sole consideration.
\vspace{2.5mm} \vspace{2.5mm}
\end{framed} \end{framed}
\section{Listing Missing Fonts} \section{Missing Fonts}
The \verb!-missing-fonts! operation lists any unembedded fonts in the document, one per line. The \verb!-missing-fonts! operation lists any unembedded fonts in the document, one per line.
\begin{framed} \begin{framed}
\small\noindent\verb!cpdf -missing-fonts in.pdf! \small\noindent\verb!cpdf -missing-fonts in.pdf!
\vspace{2.5mm}
\end{framed} \end{framed}
\noindent The format is \noindent The format is
\begin{framed} \begin{framed}
\small\noindent\verb!Page number, Name, Subtype, Basefont, Encoding! \small\noindent\verb!Page number, Name, Subtype, Basefont, Encoding!
\vspace{2.5mm} \end{framed}
\noindent The operation \texttt{-embed-missing-fonts} will process the file with \texttt{gs} (which must be installed) to embed missing fonts (where found):
\begin{framed}
\small\noindent\verb!cpdf -embed-missing-fonts -gs gs in.pdf -o out.pdf!
\end{framed} \end{framed}
\label{listmisingfonts} \label{listmisingfonts}
@ -2263,7 +2288,7 @@ recommended when file size is the sole consideration.
\section{Draft Documents} \section{Draft Documents}
\index{draft} \index{draft}
\label{draft} \label{draft}
The \texttt{-draft} option removes bitmap (photographic) images from a The \texttt{-draft} operation removes bitmap (photographic) images from a
file, so that it can be printed with less ink. Optionally, the file, so that it can be printed with less ink. Optionally, the
\texttt{-boxes} option can be added, filling the spaces left blank with a \texttt{-boxes} option can be added, filling the spaces left blank with a
crossed box denoting where the image was. This is not guaranteed to be fully crossed box denoting where the image was. This is not guaranteed to be fully
@ -2316,7 +2341,7 @@ which is part of a form.
which in PDF means "The thinnest possible line on the output device". This which in PDF means "The thinnest possible line on the output device". This
might be fine for on-screen work, but when printed on a high resolution device, might be fine for on-screen work, but when printed on a high resolution device,
such as by a commercial printer, they may be too faint, or disappear such as by a commercial printer, they may be too faint, or disappear
altogether. The \texttt{-thinlines} option prevents this by changing all lines altogether. The \texttt{-thinlines} operation prevents this by changing all lines
thinner than \texttt{<minimal~thickness>} to the given thickness. For example: thinner than \texttt{<minimal~thickness>} to the given thickness. For example:
\begin{framed} \begin{framed}
\small\noindent\verb!cpdf -thinlines 0.2mm in.pdf [<range>] -o out.pdf! \small\noindent\verb!cpdf -thinlines 0.2mm in.pdf [<range>] -o out.pdf!