Document new -obj extensions

This commit is contained in:
John Whitington 2024-06-27 15:49:02 +01:00
parent 28ba1849d3
commit 4f68e7355d
2 changed files with 22 additions and 2 deletions

Binary file not shown.

View File

@ -4508,7 +4508,7 @@ A basic text to PDF convertor is included in \texttt{cpdf}. It takes a UTF8 text
\noindent The standard paper sizes are listed in Section \ref{papersizes}, or you may specify the width and height directly, as described in the same chapter. The font may be specified as described in Section \ref{fonts}. The default font is Times-Roman and the default size is 12. \noindent The standard paper sizes are listed in Section \ref{papersizes}, or you may specify the width and height directly, as described in the same chapter. The font may be specified as described in Section \ref{fonts}. The default font is Times-Roman and the default size is 12.
\section{Make a PDF from a PNG or JPEG image} \section{Make a PDF from a PNG, JPEG or JPEG2000 image}
\index{image!convert to PDF} \index{image!convert to PDF}
Simple facilities for making PDFs from PNG and JPEG images are included in \texttt{cpdf}. The resulting file can be written out, or used for further operations. Simple facilities for making PDFs from PNG and JPEG images are included in \texttt{cpdf}. The resulting file can be written out, or used for further operations.
@ -4520,12 +4520,18 @@ For PNG files, the file must have no transparency and no interlacing, and must n
\noindent\small\verb?cpdf image.png AND -add-text "My Image" -o out.pdf? \noindent\small\verb?cpdf image.png AND -add-text "My Image" -o out.pdf?
\end{framed} \end{framed}
\noindent Notice that the \texttt{-png} can be omitted if your file has a standard file extension. Almost any JPEG file may be used with \texttt{-jpeg} or again, with a standard extension: \noindent Notice that the \texttt{-png} can be omitted if your file has a standard file extension. Almost any JPEG file may be used with \texttt{-jpeg} or again, with a \texttt{-jpg} or \texttt{-jpeg} extension:
\begin{framed} \begin{framed}
\noindent\small\verb?cpdf -jpeg image.jpg -o out.pdf? \noindent\small\verb?cpdf -jpeg image.jpg -o out.pdf?
\end{framed} \end{framed}
\noindent JPEG2000 images may be used similarly, with \texttt{-jpeg2000} or alone with a \texttt{jp2}, \texttt{jpx} or \texttt{jpf} extension:
\begin{framed}
\noindent\small\verb?cpdf -jpeg2000 image.jp2 -o out.pdf?
\end{framed}
\noindent The output file will have one point of width or height for each pixel in the input. \noindent The output file will have one point of width or height for each pixel in the input.
\section{Make a PDF from one or more JBIG2 images} \section{Make a PDF from one or more JBIG2 images}
@ -5423,6 +5429,20 @@ $ cpdf -obj 1238 out.pdf
"<</D[1225 0 R/Fit]/S/GoTo>>" "<</D[1225 0 R/Fit]/S/GoTo>>"
\end{verbatim}} \end{verbatim}}
\noindent Alternatively, we may follow a chain of dictionary entries from the trailer dictionary:
{\small\begin{verbatim}
$ ./cpdf -obj /Root,/Pages,/Count cpdfmanual.pdf
"133"
\end{verbatim}}
\noindent We may also begin at a numbered page instead of at the trailer dictionary:
{\small\begin{verbatim}
./cpdf -obj P20/Resources,/Font,/F58,/BaseFont cpdfmanual.pdf
"/MCBERL+URWPalladioL-Roma"
\end{verbatim}}
\noindent A stream may be extracted with \texttt{-extract-stream} or \texttt{-extract-stream-decompress}, which decompresses it first where possible: \noindent A stream may be extracted with \texttt{-extract-stream} or \texttt{-extract-stream-decompress}, which decompresses it first where possible:
{\small\begin{verbatim} {\small\begin{verbatim}