Document -spray

This commit is contained in:
John Whitington 2024-01-26 15:53:17 +00:00
parent 8efda070ee
commit 4f6c9ef68b
2 changed files with 17 additions and 0 deletions

Binary file not shown.

View File

@ -1166,6 +1166,9 @@ cpdf -merge in1.pdf [<range>] in2.pdf [<range>] [<more names/ranges>]
\vspace{1.5mm} \vspace{1.5mm}
\noindent\verb!cpdf -split-max <file size> in.pdf -o <format>! \noindent\verb!cpdf -split-max <file size> in.pdf -o <format>!
\vspace{1.5mm}
\noindent\verb!cpdf -spray in.pdf -o a.pdf [-o b.pdf [-o ...]]!
\end{framed} \end{framed}
\vspace{12mm} \vspace{12mm}
@ -1295,6 +1298,20 @@ The \texttt{-split-max} operation splits a file into chunks of no more than the
\end{framed} \end{framed}
\noindent Should the operation not be possible for the given size, an error message is printed and no output (not even partial output) is produced. \noindent Should the operation not be possible for the given size, an error message is printed and no output (not even partial output) is produced.
\section{Spraying}
Spraying is a sort of de-collation. It takes one input file, and writes pages in turn to one or more outputs:
\begin{framed}\small
\noindent\verb!cpdf -spray in.pdf -o a.pdf -o b.pdf!
\vspace{2.5mm}
\noindent Place odd pages of the input file in one file, and the even in another.
\end{framed}
\noindent This is the only time more than one \texttt{-o} is allowed.
\section{Encrypting with Split operations} \section{Encrypting with Split operations}
\index{encryption} \index{encryption}
The encryption parameters described in Chapter \ref{encryption} may be added to the command line to encrypt each split PDF. Similarly, the \texttt{-recrypt} switch described in Chapter \ref{basicusage} may by given to re-encrypt each file with the existing encryption of the source PDF. The encryption parameters described in Chapter \ref{encryption} may be added to the command line to encrypt each split PDF. Similarly, the \texttt{-recrypt} switch described in Chapter \ref{basicusage} may by given to re-encrypt each file with the existing encryption of the source PDF.