diff --git a/Changes b/Changes index b1f3b1d..5b56f4e 100644 --- a/Changes +++ b/Changes @@ -1,4 +1,6 @@ -2.7 (to come) +2.8 (to come) + +2.7 (February 2024) New features: diff --git a/cpdfmanual.pdf b/cpdfmanual.pdf index 5cf7552..73c0a41 100644 Binary files a/cpdfmanual.pdf and b/cpdfmanual.pdf differ diff --git a/cpdfmanual.tex b/cpdfmanual.tex index 7e00762..06bf3ca 100644 --- a/cpdfmanual.tex +++ b/cpdfmanual.tex @@ -61,7 +61,7 @@ Command Line Tools} \vspace{12mm} {\Huge User Manual}\\ -Version 2.6 (July 2023) +Version 2.7 (February 2024) \vspace{25mm} @@ -110,7 +110,7 @@ These examples demonstrate just a few of the facilities provided by the Coherent \noindent Select the even pages (2, 4, 6...) from \texttt{in.pdf} and write those pages to \texttt{out.pdf}. -\begin{framed}\noindent\texttt{cpdf -merge in.pdf in2.pdf AND -add-text "Copyright 2023"\\\phantom{\ \ \ \ } -o out.pdf}\end{framed} +\begin{framed}\noindent\texttt{cpdf -merge in.pdf in2.pdf AND -add-text "Copyright 2024"\\\phantom{\ \ \ \ } -o out.pdf}\end{framed} \noindent Using \texttt{AND} to perform several operations in order, here merging two files together and adding a copyright stamp to every page. @@ -132,6 +132,14 @@ These examples demonstrate just a few of the facilities provided by the Coherent \noindent Split \texttt{in.pdf} on bookmark boundaries, writing each to a file whose name is the bookmark label. +\begin{framed}\noindent\texttt{cpdf -split-max 1Mb in.pdf -o \%\%\%.pdf}\end{framed} + +\noindent Split \texttt{in.pdf} into files of 1Mb or less + +\begin{framed}\noindent\texttt{cpdf -spray in.pdf -o a.pdf -o b.pdf -o c.pdf}\end{framed} + +\noindent Split \texttt{in.pdf}, writing pages 1,4,7... to \texttt{a.pdf}, 2,5,8... to \texttt{b.pdf} and 3,6,9... to \texttt{c.pdf}. + \section*{\hyperref[chap:3]{Chapter 3: Pages}} \begin{framed}\noindent\texttt{cpdf -scale-page "2 2" in.pdf -o out.pdf}\end{framed} @@ -191,6 +199,10 @@ These examples demonstrate just a few of the facilities provided by the Coherent \noindent Add bookmarks in the same form from a prepared file \texttt{bookmarks.txt} to \texttt{in.pdf}, writing to \texttt{out.pdf}. JSON alternatives are also available. +\begin{framed}\noindent\texttt{cpdf -table-of-contents in.pdf -o out.pdf}\end{framed} + +\noindent Typeset a table of contents from existing bookmarks and prepend to the document. + \section*{\hyperref[chap:7]{Chapter 7: Presentations}} \begin{framed}\noindent\texttt{cpdf -presentation in.pdf 2-end -trans Split -duration 10\\\phantom{\ \ \ \ } -o out.pdf}\end{framed} @@ -217,6 +229,10 @@ These examples demonstrate just a few of the facilities provided by the Coherent \noindent Add extra blank pages after pages one, three and four of a document. +\begin{framed}\noindent\texttt{cpdf -chop "2 2" in.pdf -o out.pdf}\end{framed} + +\noindent Chop each page into four quarters, including each in the output. + \section*{\hyperref[chap:10]{Chapter 10: Annotations}} \begin{framed}\noindent\texttt{cpdf -list-annotations-json in.pdf > out.json}\end{framed} @@ -227,6 +243,10 @@ These examples demonstrate just a few of the facilities provided by the Coherent \noindent Add the annotations from a JSON annotations file to \texttt{in.pdf}, writing to \texttt{out.pdf}. +\begin{framed}\noindent\texttt{cpdf -remove-annotations in.pdf -o out.pdf}\end{framed} + +\noindent Remove the annotations from \texttt{in.pdf}, writing to \texttt{out.pdf}. + \section*{\hyperref[chap:11]{Chapter 11: Document Information and Metadata}} \begin{framed}\noindent\texttt{cpdf -info -utf8 in.pdf -o out.pdf}\end{framed} @@ -253,6 +273,14 @@ These examples demonstrate just a few of the facilities provided by the Coherent \noindent Set the document \texttt{in.pdf} to open in PDF Viewer in full screen mode, putting the result in \texttt{out.pdf}. +\begin{framed}\noindent\texttt{cpdf -print-page-labels-json in.pdf}\end{framed} + +\noindent Show, in JSON format, the page labels in \texttt{in.pdf}. + +\begin{framed}\noindent\texttt{cpdf -composition in.pdf}\end{framed} + +\noindent Show how much data in \texttt{in.pdf} is used for images, fonts etc. + \section*{\hyperref[chap:12]{Chapter 12: File Attachments}} \begin{framed}\noindent\texttt{cpdf -attach-file sheet.xls in.pdf -o out.pdf}\end{framed} @@ -277,6 +305,9 @@ These examples demonstrate just a few of the facilities provided by the Coherent \noindent Extract images from \texttt{in.pdf} to directory \texttt{output} (with the help of imagemagick). +\begin{framed}\noindent\texttt{cpdf -process-images -jpeg-to-jpeg 65 in.pdf -o out.pdf}\end{framed} + +\noindent Process JPEG images in \texttt{in.pdf} to 65\% quality, writing the output to \texttt{out.pdf}. \section*{\hyperref[chap:14]{Chapter 14: Fonts}} @@ -284,13 +315,13 @@ These examples demonstrate just a few of the facilities provided by the Coherent \noindent List the fonts in use, and what pages they are used on. -\begin{framed}\noindent\texttt{cpdf -list-missing-fonts in.pdf}\end{framed} +\begin{framed}\noindent\texttt{cpdf -missing-fonts in.pdf}\end{framed} \noindent List missing fonts. \section*{\hyperref[chap:15]{Chapter 15: PDF and JSON}} -\begin{framed}\noindent\texttt{cpdf in.pdf -output-json -output-json-parse-content-streams\\\phantom{\ \ \ \ } -o out.json}\end{framed} +\begin{framed}\noindent\texttt{cpdf in.pdf -output-json -utf8 -output-json-parse-content-streams\\\phantom{\ \ \ \ } -o out.json}\end{framed} \noindent Write the PDF in JSON format to the given file, parsing its content streams into individual JSON objects too.