More drawing documentation

This commit is contained in:
John Whitington 2023-06-05 14:28:10 +01:00
parent 5cedaa5df9
commit 6ce0f3875d
2 changed files with 32 additions and 4 deletions

Binary file not shown.

View File

@ -4101,13 +4101,13 @@ For PNG files, the file must be 24bit RGB with no transparency and no interlacin
\clearpage\pagestyle{empty} \clearpage\pagestyle{empty}
\chapter{Drawing on PDFs}\label{chap:18}\pagestyle{fancy}\index{Draw} \chapter{Drawing on PDFs}\label{chap:18}\pagestyle{fancy}\index{Draw}
FIXME -underneath, URLs don't work, add -text-width
{\small\begin{framed} {\small\begin{framed}
\noindent\verb!cpdf in.pdf -draw <draw operations> -o out.pdf!\\ \noindent\verb!cpdf in.pdf -draw <draw operations> [-underneath] -o out.pdf!\\
\noindent\verb!cpdf -text-width <text> [-font <font>] [-fontsize <fontsize>]!\\
\vspace{1.5mm} \vspace{1.5mm}
\noindent \textsc{Building and showing paths}\\
\noindent\verb!-rect! Draw rectangle\\ \noindent\verb!-rect! Draw rectangle\\
\noindent\verb!-to! Move to\\ \noindent\verb!-to! Move to\\
\noindent\verb!-line! Add line to\\ \noindent\verb!-line! Add line to\\
@ -4122,14 +4122,23 @@ FIXME -underneath, URLs don't work, add -text-width
\noindent\verb!-filleo! Fill path, even odd\\ \noindent\verb!-filleo! Fill path, even odd\\
\noindent\verb!-strokefill! Stroke and fill path\\ \noindent\verb!-strokefill! Stroke and fill path\\
\noindent\verb!-strokefilleo! Stroke and fill path, even odd\\ \noindent\verb!-strokefilleo! Stroke and fill path, even odd\\
\noindent\verb!-close! Close path\\
\vspace{1.5mm}
\noindent \textsc{Clipping with paths}\\
\noindent\verb!-clip! Clip\\ \noindent\verb!-clip! Clip\\
\noindent\verb!-clipeo! Clip, even odd\\ \noindent\verb!-clipeo! Clip, even odd\\
\noindent\verb!-close! Close path\\
\vspace{1.5mm}
\noindent \textsc{Path parameters}\\
\noindent\verb!-thick! Set stroke thickness\\ \noindent\verb!-thick! Set stroke thickness\\
\noindent\verb!-cap! Set cap\\ \noindent\verb!-cap! Set cap\\
\noindent\verb!-join! Set join\\ \noindent\verb!-join! Set join\\
\noindent\verb!-miter! Set miter limit\\ \noindent\verb!-miter! Set miter limit\\
\noindent\verb!-dash! Set dash pattern\\ \noindent\verb!-dash! Set dash pattern\\
\vspace{1.5mm}
\noindent \textsc{The graphics stack and matrices}\\
\noindent\verb!-push! Push graphics stack\\ \noindent\verb!-push! Push graphics stack\\
\noindent\verb!-pop! Pop graphics stack\\ \noindent\verb!-pop! Pop graphics stack\\
\noindent\verb!-matrix! Append to graphics matrix\\ \noindent\verb!-matrix! Append to graphics matrix\\
@ -4138,15 +4147,27 @@ FIXME -underneath, URLs don't work, add -text-width
\noindent\verb!-mscale! Scale the graphics matrix\\ \noindent\verb!-mscale! Scale the graphics matrix\\
\noindent\verb!-mshearx! Shear the graphics matrix in X\\ \noindent\verb!-mshearx! Shear the graphics matrix in X\\
\noindent\verb!-msheary! Shear the graphics matrix in Y\\ \noindent\verb!-msheary! Shear the graphics matrix in Y\\
\vspace{1.5mm}
\noindent \textsc{Re-use with XObjects}\\
\noindent\verb!-xobj-bbox! Specify the bounding box for xobjects\\ \noindent\verb!-xobj-bbox! Specify the bounding box for xobjects\\
\noindent\verb!-xobj! Begin saving a sequence of graphics operators\\ \noindent\verb!-xobj! Begin saving a sequence of graphics operators\\
\noindent\verb!-end-xobj! End saving a sequence of graphics operators\\ \noindent\verb!-end-xobj! End saving a sequence of graphics operators\\
\noindent\verb!-use! Use a saved sequence of graphics operators\\ \noindent\verb!-use! Use a saved sequence of graphics operators\\
\vspace{1.5mm}
\noindent \textsc{Images}\\
\noindent\verb!-draw-jpeg! Load a JPEG from file and name it\\ \noindent\verb!-draw-jpeg! Load a JPEG from file and name it\\
\noindent\verb!-draw-png! Load a PNG from file and name it\\ \noindent\verb!-draw-png! Load a PNG from file and name it\\
\noindent\verb!-image! Draw an image which has already been loaded\\ \noindent\verb!-image! Draw an image which has already been loaded\\
\vspace{1.5mm}
\noindent \textsc{Transparency}\\
\noindent\verb!-fill-opacity! Set opacity\\ \noindent\verb!-fill-opacity! Set opacity\\
\noindent\verb!-stroke-opacity! Set stroke opacity\\ \noindent\verb!-stroke-opacity! Set stroke opacity\\
\vspace{1.5mm}
\noindent \textsc{Text}\\
\noindent\verb!-bt! Begin text\\ \noindent\verb!-bt! Begin text\\
\noindent\verb!-et! End text\\ \noindent\verb!-et! End text\\
\noindent\verb!-text! Draw text\\ \noindent\verb!-text! Draw text\\
@ -4158,8 +4179,13 @@ FIXME -underneath, URLs don't work, add -text-width
\noindent\verb!-rendermode! Set text rendering mode\\ \noindent\verb!-rendermode! Set text rendering mode\\
\noindent\verb!-rise! Set text rise\\ \noindent\verb!-rise! Set text rise\\
\noindent\verb!-nl! New line\\ \noindent\verb!-nl! New line\\
\vspace{1.5mm}
\noindent \textsc{The next page}\\
\noindent\verb!-newpage! Move to a fresh page \noindent\verb!-newpage! Move to a fresh page
\end{framed}} \end{framed}}
\section{Basics} \section{Basics}
@ -4180,6 +4206,8 @@ FIXME -underneath, URLs don't work, add -text-width
\section{Text} \section{Text}
URLs don't work in special text.
\section{The next page} \section{The next page}