cpdf.1

.\" Automatically generated by Pandoc 3.9.0.2
.\"
.TH "CPDF" "1" "February 2026" ""
.SH NAME
cpdf \- PDF command line tools.
.SH SYNOPSIS
Simple operation:
.PP
\f[B]cpdf\f[R] [in.pdf] [operation] [options] [\-o out.pdf]
.PP
Operation on password\-protected file:
.PP
\f[B]cpdf\f[R] in.pdf [user=<password>] [owner=<password>] \&...
[\-o out.pdf]
.PP
Multiple operations, one after another:
.PP
\f[B]cpdf\f[R] [in.pdf] [operation] [options] \f[B]AND\f[R] [operation]
[options] \f[B]AND\f[R] \&...
[\-o out.pdf]
.SH DESCRIPTION
\f[B]Cpdf\f[R] is an AGPL\-licensed command line tool for processing PDF
files.
The rest of this document gives a brief description of each command line
operation and option.
The file cpdfmanual.pdf which you should find installed on your system
or otherwise at https://www.coherentpdf.com/cpdfmanual.pdf gives the
full usage details.
.PP
The sections in this document follow the chapters of cpdfmanual.pdf, for
easy cross\-referencing.
.SH 1. BASIC USAGE
.TP
\f[B]\-version\f[R]
Print the Cpdf version number.
.TP
\f[B]\-help, \(enhelp\f[R]
Gives links to sources of help.
.TP
\f[B]\-summary\f[R]
Lists and describes very briefly each command line option.
.TP
\f[B]\-o\f[R] <filename>
The output filename.
Beware of writing back to the input file.
.TP
\f[B]\-i\f[R] <filename>
Cpdf automatically treats any filename ending with .pdf (any case) as an
input PDF.
If your file does not end with .pdf, you can supply the file with
\f[B]\-i\f[R] instead.
.TP
\f[B]\-range\f[R] <range>
Gives the range of pages to be affected by an operation.
By default, all pages are affected.
The range may be specified without \f[B]\-range\f[R] simply by writing
it directly after the filename it relates to.
Example ranges: \(lq2\(rq \(lq1\-5\(rq \(lq1,2,3\-end\(rq \(lqodd\(rq
\(lqNOT1\-5\(rq.
See cpdfmanual.pdf for a full description.
.TP
\f[B]\-progress\f[R]
Show which operations and on which pages they are operating, as it
happens, on standard error.
.TP
\f[B]\-keep\-version\f[R]
Keep the PDF version of the input document even if features are used
which would otherwise make it increase.
.TP
\f[B]\-fast\f[R]
Presume ISO\-compliant content streams when processing page content.
This is faster, because it does not involve re\-parsing whole streams to
add content.
.TP
\f[B]\-idir\f[R] <path>
Add a whole directory of PDFs as inputs.
.TP
\f[B]\-idir\-only\-pdfs\f[R]
Restrict \f[B]\-idir\f[R] to only files ending in .pdf (any case).
Must appear before \f[B]\-idir\f[R].
.TP
\f[B]\-recrypt\f[R]
Re\-encrypt output files using the same encryption parameters (if any)
as the input file.
.TP
\f[B]\-decrypt\-force\f[R]
Allow the output file to be written decrypted even if permissions would
otherwise prevent it.
.TP
\f[B]\-stdout\f[R]
Write the output file to standard output instead of to a file with
\f[B]\-o\f[R].
.TP
\f[B]\-stdin\f[R]
Read the input PDF from standard input instead of from a named file.
.TP
\f[B]\-stdin\-user\f[R] <password>
Supply the user password for the PDF which is from standard input.
.TP
\f[B]\-stdin\-owner\f[R] <password>
Supply the owner password the the PDF which is from standard input.
.TP
\f[B]\-producer\f[R] <string>
Set the producer of the output file.
.TP
\f[B]\-creator\f[R] <string>
Set the creator of the output file.
.TP
\f[B]\-change\-id\f[R]
Change the PDF\(cqs ID field when writing the output file.
.TP
\f[B]\-l\f[R]
Linearize the PDF when writing.
Requires a linearizer to be supplied with \f[B]\-cpdflin\f[R].
.TP
\f[B]\-cpdflin\f[R] <path>
Give the path of an external linearizer.
For example, Qpdf.
.TP
\f[B]\-keep\-l\f[R]
Keep the linearization status (either linearized or not) of the input
file upon output.
Requires a linearizer to be supplied with \f[B]\-cpdflin\f[R].
.TP
\f[B]\-no\-preserve\-objstm\f[R]
Do not preserve existing object streams when writing the output file.
Note that \f[B]\-create\-objstm\f[R] and
\f[B]\-no\-preserve\-objstm\f[R] may be used together \- the effect is
then to redo all object streams.
.TP
\f[B]\-create\-objstm\f[R]
Create new object streams when writing the output file.
Note that \f[B]\-create\-objstm\f[R] and
\f[B]\-no\-preserve\-objstm\f[R] may be used together \- the effect is
then to redo all object streams.
.TP
\f[B]\-args\f[R] <filename>
Read command line arguments from the given file by direct textual
substitution into the command line, prior to any other processing.
.TP
\f[B]\-args\-json\f[R] <filename>
Read command line arguments from a JSON file consisting of a single
array of strings.
.TP
\f[B]\-utf8\f[R]
Read and write string data as UTF8.
Almost always the sensible option, and will become the default in a
future version.
.TP
\f[B]\-stripped\f[R]
Convert string output to 7 bit ASCII by dropping any high characters.
To be used with caution.
.TP
\f[B]\-raw\f[R]
Perform no processing on string outputs.
.TP
\f[B]\-gs\f[R] <path>
A very few of Cpdf\(cqs functions rely upon the \f[B]gs\f[R] command.
Its path may be supplied with \f[B]\-gs\f[R].
.TP
\f[B]\-gs\-malformed\f[R]
This option is used to allow Cpdf to call out to the \f[B]gs\f[R]
command to pre\-process badly malformed files as a last resort.
.TP
\f[B]\-gs\-malformed\-force\f[R]
See cpdfmanual.pdf for details of this fragile command.
.TP
\f[B]\-gs\-quiet\f[R]
Do not show the output of \f[B]gs\f[R] when used.
.TP
\f[B]\-error\-on\-malformed\f[R]
Do not attempt to reconstruct malformed files by any method, but exit
with an error.
.TP
\f[B]\-revisions\f[R]
Print the number of incremental\-update revisions in the file.
.TP
\f[B]\-revision\f[R] <n>
Extract a revision from the file.
Revision 1 is the latest, 2 the next back and so on.
Must come after file name.
.TP
\f[B]\-update\f[R]
Update a file incrementally.
As in \f[B]cpdf\f[R] \f[B]in.pdf\f[R] \&...
\-update \f[B]\-o in.pdf\f[R].
.SH 2. MERGING AND SPLITTING
.SS Merging
\f[B]cpdf \-merge in1.pdf\f[R] [<range>] \f[B]in2.pdf\f[R] [<range>]
[<more names/ranges>] [\-collate] [\-collate\-n <n>]
[\-retain\-numbering] [\-merge\-add\-bookmarks
[\-merge\-add\-bookmarks\-use\-titles]] [\-remove\-duplicate\-fonts]
[\-process\-struct\-trees] [\-subformat <subformat>] \f[B]\-o
out.pdf\f[R]
.PP
The \f[B]\-merge\f[R] operation allows the merging of several files into
one.
Ranges can be used to select only a subset of pages from each input file
in the output.
The output file consists of the concatenation of all the input pages in
the order specified on the command line.
Actually, the \f[B]\-merge\f[R] can be omitted, since this is the
default operation of Cpdf.
.TP
\f[B]\-collate\f[R]
Instead of ordinary operation, take the first page from the first
document, then the first from the second and so on.
Then the second page from the first document and on until all pages are
exhausted.
.TP
\f[B]\-collate\-n\f[R] <n>
Like \f[B]\-collate\f[R], but in chunks of more than one page.
.TP
\f[B]\-retain\-numbering\f[R]
Keep the page numbering of each input file intact, rather than
renumbering the pages in the output document beginning at 1.
.TP
\f[B]\-merge\-add\-bookmarks [\-merge\-add\-bookmarks\-use\-titles]\f[R]
Add a top\-level bookmark for each file, using the filename.
The option \f[B]\-merge\-add\-bookmarks\-use\-titles\f[R], when used in
conjunction with \f[B]\-merge\-add\-bookmarks\f[R], uses the titles from
document metadata instead.
.TP
\f[B]\-remove\-duplicate\-fonts\f[R]
Ensures that fonts used in more than one input appear only once in the
output.
.TP
\f[B]\-process\-struct\-trees\f[R]
Merge input structure trees in the output.
.TP
\f[B]\-subformat\f[R] <subformat>
If \f[B]\-subformat\f[R] \(lqPDF/UA\-2\(rq is given, together with
\f[B]\-process\-struct\-trees\f[R], Cpdf will add a top\-level Document
structure tree element.
.SS Portfolios
A PDF portfolio is a special kind of PDF which contains other documents
(PDF and otherwise) within it.
Support is mostly limited to Adobe products at time of writing.
.PP
\f[B]cpdf\f[R] \f[B]\-portfolio\f[R] \f[B]in.pdf\f[R] \-pf <filename>
[\-pfd <string>] [\-pfr <relationship>] [\-pf \&...]
\f[B]\-o out.pdf\f[R]
.PP
The input \f[B]in.pdf\f[R] here is the main file.
You can build a blank one with \f[B]\-create\-pdf\f[R].
.TP
\f[B]\-pf\f[R] <filename>
The filename for each file to include in the portfolio.
.TP
\f[B]\-pfd\f[R] <description>
The description for the file (must appear after \f[B]\-pf\f[R]).
.TP
\f[B]\-pfr\f[R] <relationship>
The so\-called relationship for the file (must appear after
\f[B]\-pf\f[R]).
.SS Splitting
We can split an input PDF into its constituent pages, and output one PDF
for each page or each chunk of pages.
.PP
\f[B]cpdf \-split in.pdf\f[R] [\-chunk <n>] [\-process\-struct\-trees]
[\-utf8] \f[B]\-o <format>\f[R]
.PP
The output format has many options (see cpdfmanual.pdf for details).
But the simplest is just to number the outputs in sequence.
For example \f[B]cpdf in.pdf \-o out%%%.pdf\f[R] will produce
out001.pdf, out002.pdf and so on.
.TP
\f[B]\-chunk\f[R] <n>
Choose a chunk size other than 1.
.TP
\f[B]\-process\-struct\-trees\f[R]
Split the input document\(cqs structure tree into the output documents.
.TP
\f[B]\-utf8\f[R]
This option may be required in the case of some output formats.
See cpdfmanual.pdf for details.
.SS Splitting on bookmarks
\f[B]cpdf \-split\-bookmarks <level> in.pdf\f[R]
[\-process\-struct\-trees] [\-utf8] \f[B]\-o <format>\f[R]
.PP
Split on bookmark boundaries at a given level, instead of splitting on
each page.
Level 0 is top level, level 1 next, and so on.
See above for format details.
.TP
\f[B]\-process\-struct\-trees\f[R]
Split the input document\(cqs structure tree into the output documents.
.TP
\f[B]\-utf8\f[R]
This option may be required in the case of some output formats.
See cpdfmanual.pdf for details.
.SS Splitting to a given size
\f[B]cpdf \-split\-max <n> in.pdf\f[R] [\-process\-struct\-trees]
[\-utf8] \f[B]\-o <format> \f[R]
.PP
Split the file, if possible, to a maximum file size (in bytes) for each
output PDF.
See above for format details.
.TP
\f[B]\-process\-struct\-trees\f[R]
Split the input document\(cqs structure tree into the output documents.
.TP
\f[B]\-utf8\f[R]
This option may be required in the case of some output formats.
See cpdfmanual.pdf for details.
.SS Interleaved splitting
We can use \f[B]\-spray\f[R] to write the split pages to more than one
named output file.
When Cpdf runs out of output files, it adds the next page to the first
output file, and so on until all input pages are exhausted.
.PP
\f[B]cpdf \-spray in.pdf\f[R] [\-process\-struct\-trees] [\-utf8]
\f[B]\-o a.pdf\f[R] [\-o b.pdf [\-o \&...]]
.TP
\f[B]\-process\-struct\-trees\f[R]
Split the input document\(cqs structure tree into the output documents.
.TP
\f[B]\-utf8\f[R]
This option may be required in the case of some output formats.
See cpdfmanual.pdf for details.
.SH 3. PAGES
\f[B]cpdf \-scale\-page \(lq<x scale> <y scale>\(rq\f[R]
\f[B]in.pdf\f[R] [<range>] [\-fast] [<position>] \f[B]\-o out.pdf\f[R]
.PP
Scale pages in the given range by the given factor e.g \(lq2 2\(rq.
See Chapter 8 for information on positions.
.PP
\f[B]cpdf \-scale\-to\-fit \(lq<x size> <y size>\(rq\f[R]
\f[B]in.pdf\f[R] [<range>] [\-fast] [\-prerotate] [<position>]
[\-scale\-to\-fit\-scale <scale>] [\-scale\-to\-fit\-rotate\-clockwise]
[\-scale\-to\-fit\-rotate\-anticlockwise] \f[B]\-o out.pdf\f[R]
.PP
Scale pages in the given range to fit the given size e.g \(lqa4paper\(rq
or \(lq10in 7in\(rq, without altering the aspect ratio.
By default the content will be centered on the new page.
See Chapter 8 for information on positions.
.TP
\f[B]\-scale\-to\-fit\-scale\f[R] <n>
Scale to a proportion of the available area, instead of filling it.
For example 0.9 for 90 percent.
.TP
\f[B]\-scale\-to\-fit\-rotate\-clockwise \-scale\-to\-fit\-rotate\-anticlockwise\f[R]
Automatically rotate page to maximise use of area.
.TP
\f[B]\-prerotate\f[R]
Remove any viewing rotation before beginning.
.PP
\f[B]cpdf \-stretch \(lq<x size> <y size>\(rq\f[R] \f[B]in.pdf\f[R]
[<range>] [\-fast] \f[B]\-o out.pdf\f[R]
.PP
Scale pages without regard to aspect ratio.
.PP
\f[B]cpdf \-center\-to\-fit \(lq<x size> <y size>\(rq\f[R]
\f[B]in.pdf\f[R] [<range>] [\-fast] \f[B]\-o out.pdf\f[R]
.PP
Center each page on a new page size, without scaling it.
.PP
\f[B]cpdf \-scale\-contents <scale>\f[R] \f[B]in.pdf\f[R] [<range>]
[<position>] [\-fast] \f[B]\-o out.pdf\f[R]
.PP
Scale the content of pages by a given factor, without changing the size
of the page.
See the end of this chapter for position.
.PP
\f[B]cpdf \-shift \(lq<shift x> <shift y>\(rq\f[R] \f[B]in.pdf\f[R]
[<range>] [\-fast] \f[B]\-o out.pdf\f[R]
.PP
Shift the content of pages by a given displacement.
.PP
\f[B]cpdf \-shift\-boxes \(lq<shift x> <shift y>\(rq\f[R]
\f[B]in.pdf\f[R] [<range>] \f[B]\-o out.pdf\f[R]
.PP
Shift the boxes of a page by a given displacement, without moving the
content.
.PP
\f[B]cpdf \-rotate <angle> in.pdf\f[R] [<range>] \f[B]\-o out.pdf\f[R]
.PP
Change the PDF viewing rotation of pages to 0, 90, 180 or 270 degrees
clockwise.
.PP
\f[B]cpdf \-rotateby <angle> in.pdf\f[R] [<range>] \f[B]\-o out.pdf\f[R]
.PP
Change the PDF viewing rotation of pages by 0, 90, 180 or 270 degrees
clockwise.
.PP
\f[B]cpdf \-upright\f[R] \f[B]in.pdf\f[R] [<range>] [\-fast] \f[B]\-o
out.pdf\f[R]
.PP
The \f[B]\-upright\f[R] operation does whatever combination of
\f[B]\-rotate\f[R] and \f[B]\-rotate\-contents\f[R] is required to
change the rotation of the document to zero without altering its
appearance.
In addition, it makes sure the media box has its origin at (0,0),
changing other boxes to compensate.
.PP
\f[B]cpdf \-rotate\-contents <angle>\f[R] \f[B]in.pdf\f[R] [<range>]
[\-fast] \f[B]\-o out.pdf\f[R]
.PP
Rotates the content of the page around its center point by the given
angle.
.PP
\f[B]cpdf \-hflip\f[R] \f[B]in.pdf\f[R] [<range>] [\-fast] \f[B]\-o
out.pdf\f[R]
.PP
Flip page content horizontally.
.PP
\f[B]cpdf \-vflip\f[R] \f[B]in.pdf\f[R] [<range>] [\-fast] \f[B]\-o
out.pdf\f[R]
.PP
Flip page content vertically.
.PP
\f[B]cpdf \-[media | crop | art | trim | bleed]box <boxspec> in.pdf\f[R]
[<range>] \f[B]\-o out.pdf\f[R]
.PP
Set the media, crop, art, trim or bleed box.
For example \f[B]\-cropbox \(lq50 50 300 200\(rq\f[R] sets minx 50, miny
50, width 300, height 200.
To use absolute numbers instead of width and height, prefix with a
question mark, writing \f[B]\(lq?50 50 350 250\(rq\f[R] instead.
.PP
\f[B]cpdf \-remove\-[crop | art | trim | bleed]box in.pdf\f[R] [<range>]
\f[B]\-o out.pdf\f[R]
.PP
Remove a crop, art, trim or bleed box from pages.
.PP
\f[B]cpdf \-frombox <boxname> \-tobox <boxname>\f[R] \f[B]in.pdf\f[R]
[<range>] [\-mediabox\-if\-missing] \f[B]\-o out.pdf\f[R]
.PP
Copy a box to another.
For example from \f[B]/TrimBox\f[R] to \f[B]/CropBox\f[R].
.TP
\f[B]\-mediabox\-if\-missing\f[R]
Use media box, rather than failing, if the \f[B]\-frombox\f[R] is
missing.
.PP
\f[B]cpdf \-hard\-box <boxname>\f[R] \f[B]in.pdf\f[R] [<range>] [\-fast]
[\-mediabox\-if\-missing] \f[B]\-o out.pdf\f[R]
.PP
Create a hard box for a given box name \- that is to say, one which
clips its content.
.PP
\f[B]cpdf \-show\-boxes\f[R] \f[B]in.pdf\f[R] [<range>] [\-fast]
\f[B]\-o out.pdf\f[R]
.PP
Show the media, crop, art, trim, and bleed boxes in Red, Green, Blue,
Orange and Pink respectively.
.PP
\f[B]cpdf \-trim\-marks\f[R] \f[B]in.pdf\f[R] [<range>] [\-fast]
\f[B]\-o out.pdf\f[R]
.PP
Add trim marks to a PDF.
The trim box must be present.
.SH 4. ENCRYPTION AND DECRYPTION
\f[B]cpdf \-encrypt <method> [\-pw=]<owner password> [\-pw=]<user
password>\f[R] \f[B]in.pdf\f[R] [\-no\-encrypt\-metadata] <permissions>
\f[B]\-o out.pdf\f[R]
.PP
Encrypt a document given the method (e.g \f[B]AES256ISO\f[R] for modern
usage), owner and user passwords, and optionally permissions.
E.g \f[B]cpdf \-encrypt AES256ISO secret \(lq\(rq in.pdf \-o
out.pdf\f[R].
.TP
\f[B]\-no\-encrypt\-metadata\f[R]
Do not encrypt metadata (AES encryption only).
.TP
\f[B]\-pw=\f[R]<password>
Useful if a password may begin with a dash.
.PP
Permissions:
.TP
\f[B]\-no\-edit\f[R]
Cannot change the document.
.TP
\f[B]\-no\-print\f[R]
Cannot print the document.
.TP
\f[B]\-no\-copy\f[R]
Cannot select or copy text or graphics.
.TP
\f[B]\-no\-annot\f[R]
Cannot add or change form fields or annotations.
.TP
\f[B]\-no\-forms\f[R]
Cannot edit form fields.
.TP
\f[B]\-no\-extract\f[R]
Cannot extract text or graphics.
.TP
\f[B]\-no\-assemble\f[R]
Cannot, for example, merge files.
.TP
\f[B]\-no\-hq\-print\f[R]
Cannot print high\-quality.
.PP
Note: Adobe Acrobat and Adobe Reader may show slightly different
permissions in info dialogues \(en this is a result of policy changes
and not a bug in Cpdf.
You may need to experiment.
.TP
\f[B]cpdf \-decrypt\f[R] \f[B]in.pdf owner=<owner password>\f[R] [\-decrypt\-force] \f[B]\-o out.pdf\f[R]
Decrypt a document, given its owner password.
.TP
\f[B]\-decrypt\-force\f[R]
Decrypt even without the owner password, using just the user password.
The user password is often blank.
.SH 5. COMPRESSION
\f[B]cpdf \-decompress\f[R] \f[B]in.pdf\f[R] [\-just\-content]
[\-jbig2dec <path>] \f[B]\-o out.pdf\f[R]
.PP
Decompress the streams in a PDF file, for instance to manually inspect
it.
.TP
\f[B]\-just\-content\f[R]
Only decompress page content streams.
.TP
\f[B]\-jbig2dec\f[R] <path>
Give the path to the jbig2dec program which Cpdf uses, if available, to
decompress JBIG2 streams.
.PP
\f[B]cpdf \-compress in.pdf \-o out.pdf\f[R]
.PP
Compress any streams which are uncompressed using the FlateDecode
method, with the exception of metadata streams.
.PP
\f[B]cpdf \-squeeze in.pdf\f[R] [\-squeeze\-log\-to <filename>]
[\-squeeze\-no\-pagedata] \f[B]\-o out.pdf\f[R]
.PP
Squeeze a file by coalescing like objects, and various other methods.
.TP
\f[B]\-squeeze\-log\-to\f[R] <filename>
Write the squeeze log to file rather than standard output.
.TP
\f[B]\-squeeze\-no\-pagedata\f[R]
Avoid processing page data, making the squeeze process much faster at
the cost of a little compression.
.PP
\f[B]cpdf \-remove\-article\-threads in.pdf \-o out.pdf\f[R]
.PP
Remove article threads.
.PP
\f[B]cpdf \-remove\-page\-piece in.pdf \-o out.pdf\f[R]
.PP
Remove page piece information.
.PP
\f[B]cpdf \-remove\-web\-capture in.pdf \-o out.pdf\f[R]
.PP
Remove web capture data.
.PP
\f[B]cpdf \-remove\-procsets in.pdf \-o out.pdf\f[R]
.PP
Remove ProcSets, a now\-irrelevant data structure from early PDFs.
.PP
\f[B]cpdf \-remove\-output\-intents in.pdf \-o out.pdf\f[R]
.PP
Remove output intents, a colour\-matching system for documents intended
to be printed.
.SH 6. BOOKMARKS
\f[B]cpdf \-list\-bookmarks\f[R] \f[B]in.pdf\f[R] [\-utf8]
.PP
Print bookmark data to standard output.
The data includes level, title, page number linked to, and full link
data.
Use \f[B]\-utf8\f[R] always.
For example:
.IP
.EX
0 \(dqPart 1\(dq 1 open
1 \(dqPart 1A\(dq 2 \(dq[2 /XYZ 200 400 null]\(dq
1 \(dqPart 1B\(dq 3
0 \(dqPart 2\(dq 4
1 \(dqPart 2a\(dq 5
.EE
.PP
\f[B]cpdf \-list\-bookmarks\-json\f[R] \f[B]in.pdf\f[R]
[\-preserve\-actions]
.PP
Print bookmark data to standard output in JSON format instead.
Here is a single entry in the JSON array of bookmarks:
.IP
.EX
{ \(dqlevel\(dq: 0,
  \(dqtext\(dq: \(dq1 Basic Usage\(dq,
  \(dqpage\(dq: 17,
  \(dqopen\(dq: false,
  \(dqtarget\(dq:
    [ { \(dqI\(dq: 17 },
      { \(dqN\(dq: \(dq/XYZ\(dq },
      { \(dqF\(dq: 85.039 },
      { \(dqF\(dq: 609.307 },
      null ]
  \(dqcolour\(dq: [ 0.0, 0.0, 0.0 ],
  \(dqitalic\(dq: false,
  \(dqbold\(dq: false
}
.EE
.TP
\f[B]\-preserve\-actions\f[R]
Instead of resolving complex destinations types to simple ones, keep the
originals.
.PP
\f[B]cpdf \-remove\-bookmarks in.pdf \-o out.pdf\f[R]
.PP
Remove all bookmarks from a PDF.
.PP
\f[B]cpdf \-add\-bookmarks <filename> in.pdf \-o out.pdf\f[R]
.PP
Add bookmarks, given an old\-style bookmark file.
.PP
\f[B]cpdf \-add\-bookmarks\-json <filename> in.pdf \-o out.pdf\f[R]
.PP
Add bookmarks, given a new\-style JSON bookmark file.
.PP
\f[B]cpdf \-bookmarks\-open\-to\-level <n> in.pdf \-o out.pdf\f[R]
.PP
Set all bookmarks up to and including a given level to be open.
.PP
\f[B]cpdf \-table\-of\-contents\f[R] \f[B]in.pdf\f[R] [\-toc\-title
<string>] [\-toc\-no\-bookmark] [\-toc\-dot\-leaders] [\-font <font>]
[\-font\-size <n>] [\-embed\-std14 <path>] [\-process\-struct\-trees]
[\-subformat <subformat>] \f[B]\-o out.pdf\f[R]
.PP
Generate a typeset table of contents from existing bookmarks, adding it
to the beginning of the document.
.TP
\f[B]\-toc\-title\f[R] <string>
Title (default is \(lqTable of Contents\(rq).
.TP
\f[B]\-toc\-no\-bookmark\f[R]
Do not add an entry for the new table of contents in the document\(cqs
bookmarks.
.TP
\f[B]\-toc\-dot\-leaders\f[R]
Add dot leaders.
.TP
\f[B]\-font\f[R] <font>
Give the font (default Times Roman).
.TP
\f[B]\-font\-size\f[R] <n>
Give the font size (default 12pt).
.TP
\f[B]\-embed\-std14\f[R]
Embed standard 14 fonts given their path (see cpdfmanual.pdf for
details).
.TP
\f[B]\-process\-struct\-trees\f[R]
Create a structure tree for the new table of contents and merge it with
the document\(cqs.
.TP
\f[B]\-subformat\f[R] <subformat>
Add \f[B]\-subformat \(lqPDF/UA\-2\(rq\f[R] when adding a table of
contents to a PDF/UA\-2 file to keep compatibility.
.SH 7. PRESENTATIONS
\f[B]cpdf \-presentation in.pdf\f[R] [<range>] \f[B]\-o out.pdf\f[R]
[\-trans <transition\-name>] [\-duration <float>] [\-vertical]
[\-outward] [\-direction <n>] [\-effect\-duration <float>]
.PP
Make a slide\-show presentation from a PDF.
.PP
\f[B]\-trans\f[R] <transition>
.PP
The transition style, one of \f[B]Split\f[R], \f[B]Blinds\f[R],
\f[B]Box\f[R], \f[B]Wipe\f[R], \f[B]Dissolve\f[R], \f[B]Glitter\f[R].
.TP
\f[B]\-duration\f[R] <n>
Time in seconds before presentation advances (default: no automatic
advancement).
.TP
\f[B]\-vertical\f[R]
Select vertical blinds for transition type Blinds.
.TP
\f[B]\-outward\f[R]
Select outward sweep for transition type Box.
.TP
\f[B]\-direction\f[R] <n>
Direction for Wipe and Glitter styles.
See cpdfmanual.pdf for full information.
.TP
\f[B]\-effect\-duration\f[R] <n>
Length in seconds of the transition itself.
.SH 8. TEXT AND STAMPS
\f[B]cpdf [\-stamp\-on | \-stamp\-under] stamp.pdf\f[R] \f[B]in.pdf\f[R]
[<range>] [\-scale\-stamp\-to\-fit] [<positioning command>]
[\-relative\-to\-[crop|trim|art|bleed]box] [\-process\-struct\-trees]
[\-fast] \f[B]\-o out.pdf\f[R]
.PP
Stamp a one\-page PDF over or under each page in the given range.
The positioning commands described later in this chapter may be used to
choose where to stamp it (default, bottom left of media box).
.TP
\f[B]\-scale\-stamp\-to\-fit\f[R]
Scale the stamp to fit the page before applying it.
.TP
\f[B]\-relative\-to\-[crop|trim|art|bleed]box\f[R]
Take the positioning command relative to the given box rather than the
media box.
.TP
\f[B]\-process\-struct\-trees\f[R]
Maintain tagged PDF.
The main file will keep its structure; the stamp will be marked as an
artifact.
.PP
\f[B]cpdf \-combine\-pages over.pdf under.pdf\f[R] [\-fast]
[\-prerotate] [\-no\-warn\-rotate] [\-process\-struct\-trees]
[\-underneath] [\-stamp\-scale\-to\-fit] \f[B]\-o out.pdf\f[R]
.PP
Combine the pages of two PDFs, page 1 of the first with page 1 of the
second and so on.
.TP
\f[B]\-prerotate\f[R]
Remove any rotation differences between the files before combining.
.TP
\f[B]\-no\-warn\-rotate\f[R]
Do not warn of unresolved rotation differences.
.TP
\f[B]\-underneath\f[R]
Reverse the order of \(lqover\(rq and \(lqunder\(rq files.
.TP
\f[B]\-process\-struct\-trees\f[R]
Maintain tagged PDF.
The \(lqunder\(rq file will keep its structure; the \(lqover\(rq file
will be marked as an artifact.
.PP
\f[B]cpdf [\-add\-text <string> | \-add\-rectangle \(lq<x size> <y
size>\(rq]\f[R] [\-font <fontname>] [\-font\-size <n>] [\-load\-ttf
<name>=<filename>] [\-embed\-std14 <path>] [\-color <color>]
[\-line\-spacing <n>] [\-outline] [\-linewidth <n>] [\-underneath]
[\-relative\-to\-[crop|trim|art|bleed]box] [\-prerotate]
[\-no\-warn\-rotate] [\-bates <n>] [\-bates\-at\-range <n>]
[\-bates\-pad\-to <n>] [\-opacity <n>] [\-midline] [\-topline]
[\-text\-[90|180|270]] [\-fast] [\-process\-struct\-trees]
\f[B]in.pdf\f[R] [<range>] \f[B]\-o out.pdf\f[R]
.PP
Add text to a PDF.
Various special codes for page numbers or time and date may be used.
For example:
.IP
.EX
%Page          Page number in arabic notation (1, 2, 3. . . )
%PageDiv2      Page number in arabic notation divided by two
%roman         Page number in lower\-case roman notation (i, ii, iii. . . )
%Roman         Page number in upper\-case roman notation (I, II, III. . . )
%EndPage       Last page of document in arabic notation
%Label         The page label of the page
%EndLabel      The page label of the last page
%filename      The full file name of the input document
%URL[text|URL] Add text, which links to URL (does not work for diagonal text)
%Bookmark<n>   Bookmark text at level n (0, 1, 2, 3, 4)
%Bates         Bates number
.EE
.PP
And date and time formats:
.IP
.EX
%a Abbreviated weekday name (Sun, Mon etc.)
%A Full weekday name (Sunday, Monday etc.)
%b Abbreviated month name (Jan, Feb etc.)
%B Full month name (January, February etc.)
%d Day of the month (01\-31)
%e Day of the month (1\-31)
%H Hour in 24\-hour clock (00\-23)
%I Hour in 12\-hour clock (01\-12)
%j Day of the year (001\-366)
%m Month of the year (01\-12)
%M Minute of the hour (00\-59)
%p \(dqa.m\(dq or \(dqp.m\(dq
%S Second of the minute (00\-61)
%T Same as %H:%M:%S
%u Weekday (1\-7, 1 = Sunday)
%w Weekday (0\-6, 0 = Sunday)
%Y Year (0000\-9999)
%% The % character
.EE
.PP
\(rsn may be used to demarcate multiple lines.
.TP
\f[B]\-font\f[R] <font>
Give the font (default Times Roman).
Options are:
.IP
.EX
Times\-Roman
Times\-Bold
Times\-Italic
Times\-BoldItalic
Helvetica
Helvetica\-Bold
Helvetica\-Oblique
Helvetica\-BoldOblique
Courier
Courier\-Bold
Courier\-Oblique
Courier\-BoldOblique
.EE
.TP
\f[B]\-font\-size\f[R] <n>
Give the font size (default 12pt).
.TP
\f[B]\-load\-ttf\f[R] <name>=<filename>
Load a truetype font, and give it name which may be used with \-font.
For example \f[B]\-load\-ttf A=NotoSans\-Black.ttf\f[R].
.TP
\f[B]\-embed\-std14\f[R] <path>
Embed the standard 14 fonts given the path to the URW Base35 free fonts.
.TP
\f[B]\-color\f[R] <color>
Choose the text colour using one (Grey), three (RGB), or four (CMYK)
numbers from 0\-1.
E.g \f[B]\-color \(lq0.5 0.4 0.5\(rq\f[R].
.TP
\f[B]\-line\-spacing\f[R] <n>
Set the spacing for multi\-line text (default 1).
.TP
\f[B]\-outline\f[R]
Use outline text.
.TP
\f[B]\-linewidth\f[R] <n>
Line width for outline text.
.TP
\f[B]\-underneath\f[R]
Put the text underneath the page instead of on top of the page.
.TP
\f[B]\-relative\-to\-[crop|trim|art|bleed]box\f[R]
Positions are relative to the given box, rather than the media box.
.TP
\f[B]\-prerotate\f[R]
Remove any viewing rotation before adding text.
.TP
\f[B]\-no\-warn\-rotate\f[R]
Do not warn of unresolved viewing rotation.
.TP
\f[B]\-bates\f[R] <n>
Set the bates number for use with \f[B]%Bates\f[R].
.TP
\f[B]\-bates\-at\-range\f[R] <n>
Set the bates number for the first page in the range.
.TP
\f[B]\-bates\-pad\-to\f[R] <n>
Pad bates numbers to a given number of leading zeros.
.TP
\f[B]\-opacity\f[R] <n>
Set text opacity.
Wholly opaque is 1, wholly transparent is 0.
.TP
\f[B]\-midline\f[R]
Position is relative to the midline of text rather than the baseline.
.TP
\f[B]\-topline\f[R]
Position is relative to the topline of text rather than the baseline.
.TP
\f[B]\-process\-struct\-trees\f[R]
Maintain tagged PDF, for example with PDF/UA.
The main file will keep its structure; the stamped text will be marked
as an artifact.
.PP
Positioning commands:
.TP
\f[B]\-pos\-left\f[R] \(lq<x> <y>\(rq
Position the left of the baseline of the text at (x, y).
.TP
\f[B]\-pos\-center\f[R] \(lq<x> <y>\(rq
Position the center of the baseline of the text at (x, y).
.TP
\f[B]\-pos\-right\f[R] \(lq<x> <y>\(rq
Position the right of the baseline of the text at (x, y).
.TP
\f[B]\-top\f[R] <n>
Position the baseline of the text n pts from the top middle of the page.
.TP
\f[B]\-topleft\f[R] <n>
Position the left of the baseline of the text n pts below and right of
the top left of the page.
.TP
\f[B]\-topleft\f[R] \(lq<x> <y>\(rq
Position the left of the baseline of the text y pts below and x pts
right of the top left of the page.
.TP
\f[B]\-topright\f[R] <n>
Position the right of the baseline of the text n pts below and left of
the top right of the page.
.TP
\f[B]\-topright\f[R] \(lq<x> <y>\(rq
Position the right of the baseline of the text y pts below and x pts
left of the top right of the page.
.TP
\f[B]\-left\f[R] <n>
Position the left of the baseline of the text n pts right of the left
middle of the page.
.TP
\f[B]\-bottomleft\f[R] <n>
Position the left of the baseline of the text n pts up and right of the
bottom left of the page.
.TP
\f[B]\-bottomleft\f[R] \(lq<x> <y>\(rq
Position the left of the baseline of the text y pts up and x pts right
of the bottom left of the page.
.TP
\f[B]\-bottom\f[R] <n>
Position the center of the baseline of the text n pts up from the bottom
middle of the page.
.TP
\f[B]\-bottomright\f[R] <n>
Position the right of the baseline of the text n pts up and left from
the bottom right of the page.
.TP
\f[B]\-bottomright\f[R] \(lq<x> <y>\(rq
Position the right of the baseline of the text y pts up and x pts left
from the bottom right of the page.
.TP
\f[B]\-right\f[R] <n>
Position the right of the baseline of the text n pts left of the center
right of the page.
.TP
\f[B]\-diagonal\f[R]
Position text diagonally, bottom left to top right.
.TP
\f[B]\-reverse\-diagonal\f[R]
Position text diagonally, top left to bottom right.
.TP
\f[B]\-center\f[R]
Position text centered on the page.
.TP
\f[B]\-text\-90\f[R]
Rotate text 90 degrees.
.TP
\f[B]\-text\-180\f[R]
Rotate text 180 degrees.
.TP
\f[B]\-text\-270\f[R]
Rotate text 270 degrees.
.TP
\f[B]\-justify\-left\f[R]
Set left justification for multi\-line text.
Default depends upon position.
.TP
\f[B]\-justify\-right\f[R]
Set right justification for multi\-line text.
Default depends upon position.
.TP
\f[B]\-justify\-center\f[R]
Set center justification for multi\-line text.
Default depends upon position.
.TP
\f[B]\-url\-border\f[R]
Show the border for %URL text specials.
.PP
\f[B]cpdf \-remove\-text in.pdf\f[R] [<range>] \f[B]\-o out.pdf\f[R]
.PP
Remove text previously added by Cpdf.
.PP
\f[B]cpdf \-prepend\-content <content> in.pdf\f[R] [<range>] \f[B]\-o
out.pdf\f[R]
.PP
A low\-level operation to prepend raw content to the beginning of page
streams.
.PP
\f[B]cpdf \-postpend\-content <content> in.pdf\f[R] [<range>] \f[B]\-o
out.pdf\f[R]
.PP
A low\-level operation to postpend raw content to the end of page
streams.
.PP
\f[B]cpdf \-stamp\-as\-xobject stamp.pdf in.pdf\f[R] [<range>] \f[B]\-o
out.pdf\f[R]
.PP
A low\-level operation to add stamp.pdf as a Form XObject in the given
pages of a PDF and write to standard output its name.
.SH 9. MULTIPAGE FACILITIES
\f[B]cpdf [\-pad\-before | \-pad\-after] in.pdf\f[R] [<range>]
[\-pad\-with pad.pdf] \f[B]\-o out.pdf\f[R]
.PP
Add blank pages before or after each page in the given range.
.TP
\f[B]\-pad\-with\f[R] <filename>
Use a separate PDF to act as the padding.
.TP
\f[B]cpdf \-pad\-every <n> in.pdf\f[R] [\-pad\-with pad.pdf] \f[B]\-o out.pdf\f[R]
Add a blank page after every n pages.
.TP
\f[B]\-pad\-with\f[R] <filename>
Use a separate PDF to act as the padding.
.PP
\f[B]cpdf [\-pad\-multiple | \-pad\-multiple\-before]\f[R] [<n>]
\f[B]in.pdf \-o out.pdf\f[R]
.PP
Add as many blank pages as are required before or after the original
pages to make the file\(cqs length a multiple of the given number of
pages
.PP
\f[B]cpdf \-redact\f[R] \f[B]in.pdf\f[R] [<range>]
[\-process\-struct\-trees] \f[B]\-o out.pdf\f[R]
.PP
Remove the content of the pages in the given range entirely, including
annotations and any resources.
.TP
\f[B]\-process\-struct\-trees\f[R]
Process the document\(cqs structure tree to remove any parts which are
marked as relating to the now\-redacted pages.
.PP
\f[B]cpdf [\-impose <pagesize> | impose\-xy \(lq<x> <y>\(rq]\f[R]
\f[B]in.pdf\f[R] [\-impose\-columns] [\-impose\-rtl] [\-impose\-btt]
[\-impose\-margin <n>] [\-impose\-spacing <n>] [\-impose\-linewidth <n>]
[\-fast] [\-process\-struct\-trees] \f[B]\-o out.pdf\f[R]
.PP
Cpdf has two imposition operations:
.PP
\f[B]\-impose\f[R] fits multiple pages onto a given page size e.g
\f[B]\-impose a4portrait\f[R] or \f[B]\-impose \(lq8in 12in\(rq\f[R]
.PP
\f[B]\-impose\-xy\f[R] builds an output page with the x pages
horizontally and y pages vertically e.g \f[B]\-impose\-xy \(lq2
3\(rq\f[R]
.TP
\f[B]\-impose\-columns\f[R]
Lay the pages out in columns rather than rows.
.TP
\f[B]\-impose\-rtl\f[R]
Lay the pages out right to left.
.TP
\f[B]\-impose\-btt\f[R]
Lay the pages out bottom to top.
.TP
\f[B]\-impose\-margin\f[R] <n>
Add a margin around the edge of each page.
When using \f[B]\-impose\-xy\f[R] the page size increases; with
\f[B]\-impose\f[R] the pages are scaled.
.TP
\f[B]\-impose\-spacing\f[R] <n>
Add spacing between rows and columns.
When using \f[B]\-impose\-xy\f[R] the page size increases; with
\f[B]\-impose\f[R] the pages are scaled.
.TP
\f[B]\-impose\-linewidth\f[R] <n>
Add a border around each input page.
With \f[B]\-impose\f[R] the pages are scaled after the border is added,
so you must account for this yourself.
.TP
\f[B]\-process\-struct\-trees\f[R]
Mark the file\(cqs content as an artifact for the purposes of
imposition.
.PP
\f[B]cpdf \-twoup\-stack\f[R] \f[B]in.pdf\f[R] [\-fast]
[\-process\-struct\-trees] \f[B]\-o out.pdf\f[R]
.PP
\f[B]cpdf \-twoup\f[R] \f[B]in.pdf\f[R] [\-fast]
[\-process\-struct\-trees] \f[B]\-o out.pdf\f[R]
.PP
Two old imposition functions which can now both be done with
\f[B]\-impose\f[R] / \f[B]\-impose\-xy\f[R].
The \f[B]\-twoup\-stack\f[R] operation puts two logical pages on each
physical page, rotating them 90 degrees to do so.
The new mediabox is thus larger.
Whereas the \f[B]\-twoup\f[R] operation does the same, but scales the
new sides down so that the media box is unchanged.
.TP
\f[B]\-process\-struct\-trees\f[R]
Mark the file\(cqs content as an artifact for the purposes of
imposition.
.PP
\f[B]cpdf \-chop \(lq<x> <y>\(rq\f[R] \f[B]in.pdf\f[R] [<range>]
[\-chop\-columns] [\-chop\-rtl] [\-chop\-btt] \f[B]\-o out.pdf\f[R]
.PP
The \f[B]\-chop\f[R] operation cuts up a page into multiple pages,
according to the chosen grid.
.TP
\f[B]\-chop\-columns\f[R]
Arrange by columns instead of rows.
.TP
\f[B]\-chop\-rtl\f[R]
Arrange right to left.
.TP
\f[B]\-chop\-btt\f[R]
Arrange bottom to top.
.PP
\f[B]cpdf [\-chop\-h <y> | \-chop\-v <x>]\f[R] \f[B]in.pdf\f[R]
[<range>] [\-chop\-columns] \f[B]\-o out.pdf\f[R]
.PP
Chop each page into two, vertically or horizontally, at the given
position.
E.g \f[B]\-chop\-h 200pt\f[R].
.TP
\f[B]\-chop\-columns\f[R]
Reverse the order of pages in the output.
.SH 10. ANNOTATIONS
\f[B]cpdf \-list\-annotations in.pdf\f[R] [<range>]
.PP
List textual content of annotations to standard output.
Each annotation is preceded by the page number and followed by a
newline.
.PP
\f[B]cpdf \-list\-annotations\-json in.pdf\f[R] [<range>]
.PP
List annotation objects in JSON format.
This includes all ancillary objects, to support round\-tripping.
See cpdfmanual.pdf for full format details.
.PP
\f[B]cpdf \-set\-annotations <filename>\f[R] \f[B]in.pdf\f[R] [<range>]
[\-underneath] \f[B]\-o out.pdf\f[R]
.PP
Set annotations from a JSON file.
They will be added on top of any annotations already present.
.TP
\f[B]\-underneath\f[R]
Put the annotations underneath instead of on top of existing ones.
.PP
\f[B]cpdf \-copy\-annotations from.pdf to.pdf\f[R] [<range>] \f[B]\-o
out.pdf\f[R]
.PP
Copy annotations from \f[B]from.pdf\f[R] to \f[B]to.pdf\f[R].
.PP
\f[B]cpdf \-remove\-annotations in.pdf\f[R] [<range>] \f[B]\-o
out.pdf\f[R]
.PP
Remove annotations from the document.
.SH 11. DOCUMENT INFORMATION AND METADATA
\f[B]cpdf \-info[\-json]\f[R] \f[B]in.pdf\f[R] [\-utf8] [\-in | \-cm |
\-mm]
.PP
Print info about a document in plain text (\f[B]\-info\f[R]) or JSON
(\f[B]\-info\-json\f[R]).
For example:
.IP
.EX
cpdf \-info pdf_reference.pdf
Encryption: Not encrypted
Permissions: 
Linearized: true
Object streams: true
ID: <0b1f990718e2a92c0c112fbf08b233fb> <b2f1dbee369e11d9b951000393c97fd8>
Version: 1.5
Pages: 1236
Title: PDF Reference, version 1.6
Author: Adobe Systems Incorporated
Subject: Adobe Portable Document Format (PDF)
Keywords: 
Creator: FrameMaker 7.0
Producer: Acrobat Distiller 6.0.1 for Macintosh
Created: D:20041114084116Z
Modified: D:20041114163850\-08\(aq00\(aq
Trapped: False
PageMode: UseOutlines
PageLayout: 
OpenAction: [1/XYZ \-32768 \-32768 1]
HideToolbar: 
HideMenubar: 
HideWindowUI: 
FitWindow: 
CenterWindow: 
DisplayDocTitle: True
NonFullScreenPageMode: 
AcroForm: False
XFA: False
Marked: False
UserProperties: False
Suspects: False
MediaBox: 0.000000 0.000000 612.000000 792.000000
CropBox: 41.000000 63.000000 572.000000 729.000000
BleedBox: 
TrimBox: various
ArtBox: various
Subformats: 
Language: en\-us
XMP dc:title: PDF Reference, version 1.6
XMP dc:creator: Adobe Systems Incorporated
XMP dc:description: Adobe Portable Document Format (PDF)
.EE
.TP
\f[B]\-utf8\f[R]
Output in UTF8 format (plain text only)
.TP
\f[B]\-in\f[R] / \f[B]\-mm\f[R] / \f[B]\-cm\f[R]
Output dimensions in inches, millimetres or centimetres instead of
points.
.PP
\f[B]cpdf \-page\-info[\-json]\f[R] \f[B]in.pdf\f[R] [<range>] [\-in |
\-cm | \-mm]
.PP
List page information in plain (\f[B]\-page\-info\f[R]) or JSON
(\f[B]\-page\-info\-json\f[R]) format.
.IP
.EX
cpdf \-page\-info 14psfonts.pdf
Page 1:
Label: i
MediaBox: 0.000000 0.000000 600.000000 450.000000
CropBox: 200.000000 200.000000 500.000000 500.000000
BleedBox:
TrimBox:
ArtBox:
Rotation: 0
Annotations: 0
.EE
.TP
\f[B]\-in\f[R] / \f[B]\-mm\f[R] / \f[B]\-cm\f[R]
Output dimensions in inches, millimetres or centimetres instead of
points.
.PP
\f[B]cpdf \-pages in.pdf\f[R]
.PP
Print the number of pages in the file.
.PP
\f[B]cpdf \-sig\-info [\-json] in.pdf\f[R]
.PP
Print information about digital signatures.
.PP
\f[B]cpdf \-set\-title <string>\f[R] \f[B]in.pdf\f[R] [\-also\-set\-xmp]
[\-just\-set\-xmp] \f[B]\-o out.pdf\f[R]
.PP
\f[B]cpdf \-set\-author <string>\f[R] \f[B]in.pdf\f[R]
[\-also\-set\-xmp] [\-just\-set\-xmp] \f[B]\-o out.pdf\f[R]
.PP
\f[B]cpdf \-set\-subject <string>\f[R] \f[B]in.pdf\f[R]
[\-also\-set\-xmp] [\-just\-set\-xmp] \f[B]\-o out.pdf\f[R]
.PP
\f[B]cpdf \-set\-keywords <string>\f[R] \f[B]in.pdf\f[R]
[\-also\-set\-xmp] [\-just\-set\-xmp] \f[B]\-o out.pdf\f[R]
.PP
\f[B]cpdf \-set\-creator <string>\f[R] \f[B]in.pdf\f[R]
[\-also\-set\-xmp] [\-just\-set\-xmp] \f[B]\-o out.pdf\f[R]
.PP
\f[B]cpdf \-set\-producer <string>\f[R] \f[B]in.pdf\f[R]
[\-also\-set\-xmp] [\-just\-set\-xmp] \f[B]\-o out.pdf\f[R]
.PP
Set metadata.
.PP
\f[B]cpdf \-set\-create <date>\f[R] \f[B]in.pdf\f[R] [\-also\-set\-xmp]
[\-just\-set\-xmp] \f[B]\-o out.pdf\f[R]
.PP
\f[B]cpdf \-set\-modify <date>\f[R] \f[B]in.pdf\f[R] [\-also\-set\-xmp]
[\-just\-set\-xmp] \f[B]\-o out.pdf\f[R]
.PP
Set creation or modification dates.
See Appendix A of cpdfmanual.pdf for details of the PDF date format.
.PP
\f[B]cpdf \-set\-trapped in.pdf\f[R] [\-also\-set\-xmp]
[\-just\-set\-xmp] \f[B]\-o out.pdf\f[R]
.PP
\f[B]cpdf \-set\-untrapped in.pdf\f[R] [\-also\-set\-xmp]
[\-just\-set\-xmp] \f[B]\-o out.pdf\f[R]
.PP
Set the trapped status of a PDF.
.TP
\f[B]\-also\-set\-xmp\f[R]
Set the XMP metadata if the field is present, in addition to setting the
old\-style PDF metadata.
.TP
\f[B]\-just\-set\-xmp\f[R]
Just set the XMP metadata, if the field is present, in addition to the
old\-style PDF metadata.
.PP
\f[B]cpdf \-set\-page\-layout <layout> in.pdf \-o out.pdf\f[R]
.PP
Set the page layout: one of \f[B]SinglePage\f[R], \f[B]OneColumn\f[R],
\f[B]TwoColumnLeft\f[R], \f[B]TwoColumnRight\f[R],
\f[B]TwoPageLeft\f[R], \f[B]TwoPageRight\f[R]
.PP
\f[B]cpdf \-set\-page\-mode <mode> in.pdf \-o out.pdf\f[R]
.PP
Set the page mode: one of \f[B]UseNone\f[R], \f[B]UseOutlines\f[R],
\f[B]UseThumbs\f[R], \f[B]FullScreen\f[R], \f[B]UseOC\f[R],
\f[B]UseAttachments\f[R].
.PP
\f[B]cpdf \-set\-non\-full\-screen\-page\-mode <mode> in.pdf \-o
out.pdf\f[R]
.PP
Set the non full screen mode for a PDF with FullScreen page mode: one of
\f[B]UseNone\f[R], \f[B]UseOutlines\f[R], \f[B]UseThumbs\f[R],
\f[B]UseAttachments\f[R].
.PP
\f[B]cpdf \-hide\-toolbar <true | false> in.pdf \-o out.pdf\f[R]
.PP
Hide or reveal the viewer\(cqs toolbar.
.PP
\f[B]cpdf \-hide\-menubar <true | false> in.pdf \-o out.pdf\f[R]
.PP
Hide or reveal the viewer\(cqs menubar.
.PP
\f[B]cpdf \-hide\-window\-ui <true | false> in.pdf \-o out.pdf\f[R]
.PP
Hide or reveal the window\(cqs scroll bars.
.PP
\f[B]cpdf \-fit\-window <true | false> in.pdf \-o out.pdf\f[R]
.PP
Resize the document\(cqs windows to fit the size of the first page.
.PP
\f[B]cpdf \-center\-window <true | false> in.pdf \-o out.pdf\f[R]
.PP
Position the document window in the center of the screen.
.PP
\f[B]cpdf \-display\-doc\-title <true | false> in.pdf \-o out.pdf\f[R]
.PP
Display the document title instead of the file name in the title bar.
.PP
\f[B]cpdf \-open\-at\-page <n> in.pdf \-o out.pdf\f[R]
.PP
Set the document to open at the given page number.
.PP
\f[B]cpdf \-open\-at\-page\-fit <n> in.pdf \-o out.pdf\f[R]
.PP
Set the document to open at the given page number scaled to fit the
window.
.PP
\f[B]cpdf \-open\-at\-page\-custom <destination> in.pdf \-o out.pdf\f[R]
.PP
Set the document to open at a custom destination.
See cpdfmanual.pdf for details.
.PP
\f[B]cpdf \-set\-language <language> in.pdf \-o out.pdf\f[R]
.PP
Set the document\(cqs global language, for example \(lqen\-US\(rq
.PP
\f[B]cpdf \-set\-metadata <filename> in.pdf \-o out.pdf\f[R]
.PP
Replace or add XMP metadata.
.PP
\f[B]cpdf \-remove\-metadata in.pdf \-o out.pdf\f[R]
.PP
Remove the main XMP metadata stream.
.PP
\f[B]cpdf \-remove\-all\-metadata in.pdf \-o out.pdf\f[R]
.PP
Remove all XMP metadata streams.
.PP
\f[B]cpdf \-print\-metadata in.pdf\f[R]
.PP
Print the XMP metadata stream to standard output.
.PP
\f[B]cpdf \-extract\-all\-metadata in.pdf \-o <path>\f[R]
.PP
Extract XMP metadata streams to the given directory.
.PP
\f[B]cpdf \-create\-metadata in.pdf \-o out.pdf\f[R]
.PP
Create or replace XMP metadata from old\-style metadata.
.PP
\f[B]cpdf \-set\-metadata\-date <date> in.pdf \-o out.pdf\f[R]
.PP
Set the XMP metadata date.
See Appendix A in cpdfmanual.pdf for date format details.
.PP
\f[B]cpdf \-add\-page\-labels in.pdf\f[R] [<range>] [\-label\-style
<style>] [\-label\-prefix <string>] [\-label\-startval <n>]
[\-labels\-progress] \f[B]\-o out.pdf\f[R]
.PP
Add page labels to a PDF.
Multiple calls may be used to add multiple ranges of page labels.
.TP
\f[B]\-label\-style\f[R]
One of \f[B]DecimalArabic\f[R], \f[B]LowercaseRoman\f[R],
\f[B]UppercaseRoman\f[R], \f[B]LowercaseLetters\f[R],
\f[B]UppercaseLetters\f[R], \f[B]NoLabelPrefixOnly\f[R].
.TP
\f[B]\-label\-prefix\f[R]
The textual prefix for these labels.
.TP
\f[B]\-label\-startval\f[R]
By default the labels begin at page number 1 for each range.
To override this, we can use \f[B]\-label\-startval\f[R].
.TP
\f[B]\-labels\-progress\f[R]
make sure the start value progresses between sub\-ranges when the page
range specified is disjoint, e.g \(lq1\-9, 30\-40\(rq or \(lqodd\(rq.
.PP
\f[B]cpdf \-add\-page\-labels\-json in.json \-o out.pdf\f[R]
.PP
Add page labels from a file like that produced by
\f[B]\-print\-page\-labels\-json \-include\-data\f[R].
.PP
\f[B]cpdf \-remove\-page\-labels in.pdf \-o out.pdf\f[R]
.PP
Remove the page labels.
.PP
\f[B]cpdf \-print\-page\-labels[\-json] in.pdf\f[R]
.PP
Print the page labels in plain text (\f[B]\-print\-page\-labels\f[R]) or
JSON (\f[B]\-print\-page\-labels\-json\f[R]) format.
.TP
\f[B]\-include\-data\f[R]
In JSON format, include the attachment data as well as metadata.
.PP
\f[B]cpdf \-composition[\-json] in.pdf\f[R]
.PP
Print the composition of a PDF, showing how much space is taken by
images, fonts etc.
.IP
.EX
cpdf \-composition cpdfmanual.pdf
Images: 0 bytes (0.00%)
Fonts: 144731 bytes (46.72%)
Content streams: 132767 bytes (42.85%)
Structure Info: 0 bytes (0.00%)
Attached Files: 0 bytes (0.00%)
XRef Table: 21082 bytes (6.80%)
Piece Info: 0 bytes (0.00%)
Unclassified: 11229 bytes (3.62%)
.EE
.SH 12. FILE ATTACHMENTS
\f[B]cpdf \-attach\-file <filename>\f[R] \f[B]in.pdf\f[R] [\-to\-page
<n>] [\-afd <string>] [\-afr <relationship>] [\-attach\-file \&...]
\f[B]\-o out.pdf\f[R]
.PP
Attach a file to a PDF, given its filename.
.TP
\f[B]\-to\-page\f[R] <n>
Instead of attaching globally, add it as an attachment on a single page.
.TP
\f[B]\-afd\f[R] <string>
Supply the textual description for this attachment.
.TP
\f[B]\-afr\f[R] <relationship>
Supply the so\-called Relationship for this attachment.
.PP
\f[B]cpdf \-add\-attached\-files in.json in.pdf \-o out.pdf\f[R]
.PP
Add attached files from JSON produced by
\f[B]\-list\-attached\-files\f[R] or otherwise.
.PP
\f[B]cpdf \-list\-attached\-files\f[R] \f[B]in.pdf\f[R] [\-json]
[\-include\-data]
.PP
List attached files.
.TP
\f[B]\-json\f[R]
List attached files in JSON format.
See cpdfmanual.pdf for full details.
.TP
\f[B]\-include\-data\f[R]
Include the attachment file data when listing in JSON format.
.PP
\f[B]cpdf \-remove\-files in.pdf \-o out.pdf\f[R]
.PP
Remove attached files from a PDF.
.PP
\f[B]cpdf \-dump\-attachments in.pdf \-o <path>\f[R]
.PP
Extract the attachments to a given directory.
.SH 13. IMAGES
\f[B]cpdf \-list\-images[\-json]\f[R] \f[B]in.pdf\f[R] [<range>]
[\-inline]
.PP
List the images in a file together with their object number, page
numbers, image name, width, height, size in bytes, bits per pixel,
colour space, compression method, mask type and mask object number.
Either in plain text (\f[B]\-list\-images\f[R]) or JSON
(\f[B]\-list\-images\-json\f[R]).
.TP
\f[B]\-inline\f[R]
Also list inline images.
.PP
\f[B]cpdf \-list\-images\-used[\-json]\f[R] \f[B]in.pdf\f[R] [<range>]
[\-inline]
.PP
\f[B]cpdf \-image\-resolution[\-json] <n>\f[R] \f[B]in.pdf\f[R]
[<range>] [\-inline]
.PP
The \f[B]\-list\-images\-used\f[R] and
\f[B]\-list\-images\-used\-json\f[R] operations list the images at point
of use with their page number, image name, width in pixels, height in
pixels, x resolution, y resolution and object number.
Using \f[B]\-image\-resolution\f[R] or
\f[B]\-image\-resolution\-json\f[R] instead reports only such images as
do not reach a minimum resolution.
.TP
\f[B]\-inline\f[R]
Also list inline images.
.PP
\f[B]cpdf \-extract\-images in.pdf\f[R] [<range>] [\-im <path>] [\-p2p
<path>] [\-dedup | \-dedup\-perpage] [\-raw] [\-inline] [\-merge\-masks]
\f[B]\-o <path>\f[R]
.PP
Extract images to a given path e.g \(lqoutput/%%%\(rq, which would
create output/001.jpg, output/002.png and so on.
JPEG, JPEG2000 and lossless JBIG2 images are extracted directly.
Lossy JBIG2 images are extracted in sections.
Other images are written as PNGs, processed with ImageMagick.
.TP
\f[B]\-im\f[R] <path>
Provide path to ImageMagick.
.TP
\f[B]\-p2p\f[R] <path>
Provide path to pnmtopng if ImageMagick not available.
.TP
\f[B]\-dedup\f[R]
Deduplicate images, extracting only once even if multiply\-included.
.TP
\f[B]\-dedup\-per\-page\f[R]
Deduplicate images, but only per\-page.
.TP
\f[B]\-raw\f[R]
Output .pnm files instead of .png.
.TP
\f[B]\-inline\f[R]
Also extract inline images.
.TP
\f[B]\-merge\-masks\f[R]
Merge soft masks with their images when extracting.
.PP
\f[B]cpdf \-extract\-single\-image <object number>\f[R] \f[B]in.pdf\f[R]
[\-im <path>] [\-p2p <path>] [\-raw] [\-merge\-masks] \f[B]\-o
<filename>\f[R]
.PP
Extract a single image, given its object number.
Other flags as above.
.PP
\f[B]cpdf \-process\-images\f[R] \f[B]in.pdf\f[R] [<range>]
[\-process\-images\-info] [\-process\-images\-force] [\-im <filename>]
[\-jbig2enc <filename>] [\-jbig2dec <filename>]
[\-lossless\-resample[\-dpi] <n> | \-lossless\-to\-jpeg <n>]
[\-jpeg\-to\-jpeg <n>] [\-jpeg\-to\-jpeg\-scale <n>]
[\-lossless\-to\-jpeg2000 <n>] [\-jpeg2000\-to\-jpeg2000 <n>]
[\-jpeg\-to\-jpeg\-dpi <n>] [\-1bpp\-method <method>]
[\-jbig2\-lossy\-threshold <n>] [\-pixel\-threshold <n>]
[\-length\-threshold <n>] [\-percentage\-threshold <n>]
[\-dpi\-threshold <n>] [\-resample\-interpolate] \f[B]\-o out.pdf\f[R]
.PP
Re\-process existing images within the PDF, typically to reduce size.
For a full commentary, see cpdfmanual.pdf.
.TP
\f[B]\-process\-images\-info\f[R]
Show the work being done.
.TP
\f[B]\-process\-images\-force\f[R]
Process image even when size would increase.
.TP
\f[B]\-im\f[R] <path>
Supply path to ImageMagick.
.TP
\f[B]\-jbig2enc\f[R] <path>
Supply path to jbig2enc.
.TP
\f[B]\-jbig2dec\f[R] <path>
Supply path to jbig2dec.
.TP
\f[B]\-lossless\-resample\f[R] <n>
Resample lossless images to the given percentage scale.
.TP
\f[B]\-lossless\-resample\-dpi\f[R] <n>
Resample lossless images to a given DPI resolution.
.TP
\f[B]\-lossless\-to\-jpeg\f[R] <n>
Convert lossless images to JPEG at the given quality level.
.TP
\f[B]\-jpeg\-to\-jpeg\f[R] <n>
Reprocess JPEG images to the given quality level.
.TP
\f[B]\-jpeg\-to\-jpeg\-scale\f[R] <n>
Reprocess JPEG images to the given percentage scale.
.TP
\f[B]\-jpeg\-to\-jpeg\-dpi\f[R] <n>
Reprocess JPEG images to the given DPI resolution.
.TP
\f[B]\-lossless\-to\-jpeg2000\f[R] <n>
Convert lossless images to JPEG 2000 at the given quality level.
.TP
\f[B]\-jpeg2000\-to\-jpeg2000\f[R] <n>
Reprocess JPEG 2000 images to the given quality level.
.TP
\f[B]\-1bpp\-method\f[R] <1bppmethod>
Specify method for 1bpp images.
One of \f[B]JBIG2Lossy\f[R], \f[B]JBIG2Lossless\f[R], \f[B]CCITT\f[R],
\f[B]CCITTG4\f[R].
.TP
\f[B]\-jbig2\-lossy\-threshold\f[R] <n>
Set the threshold for lossy JBIG2 compression.
.TP
\f[B]\-pixel\-threshold\f[R] <n>
Images below this number of pixels not processed (default 25).
.TP
\f[B]\-length\-threshold\f[R] <n>
Images with less than this number of bytes not processed (default 100).
.TP
\f[B]\-percentage\-threshold\f[R] <n>
Results not below this percentage of original size discarded (default
90).
.TP
\f[B]\-dpi\-threshold\f[R] <n>
Only image above this threshold at all use points processed (default no
dpi threshold).
.TP
\f[B]\-resample\-interpolate\f[R]
Use interpolation when resampling.
.PP
\f[B]cpdf \-rasterize in.pdf\f[R] [<range>] [\-gs <path>]
[\-rasterize[\-gray | \-1bpp | \-jpeg | \-jpeggray]] [\-rasterize\-res
<n>] [\-rasterize\-jpeg\-quality <n>] [\-rasterize\-no\-antialias |
\-rasterize\-downsample] [\-rasterize\-annots] [\-rasterize\-alpha]
\f[B]\-o out.pdf\f[R]
.PP
Rasterize each page, replacing the page content with the rasterized
version in the output PDF.
.TP
\f[B]\-gs\f[R] <path>
Supply path to gs.
.TP
\f[B]\-rasterize\-gray\f[R]
Use grayscale instead of colour.
.TP
\f[B]\-rasterize\-1bpp\f[R]
Use monochrome instead of colour.
.TP
\f[B]\-rasterize\-jpeg\f[R]
Use JPEG instead of lossless compression.
.TP
\f[B]\-rasterize\-jpeggray\f[R]
Use grayscale JPEG instead of lossless compression.
.TP
\f[B]\-rasterize\-res\f[R] <n>
Set the resolution (default 144dpi).
.TP
\f[B]\-rasterize\-jpeg\-quality\f[R] <n>
Set JPEG image quality (0..100).
.TP
\f[B]\-rasterize\-no\-antialias\f[R]
Turn off anti\-aliasing.
.TP
\f[B]\-rasterize\-downsample\f[R]
Use better but slower anti\-aliasing.
.TP
\f[B]\-rasterize\-annots\f[R]
Rasterize annotations instead of retaining.
.TP
\f[B]\-rasterize\-alpha\f[R]
Produce an alpha channel (lossless only)
.PP
\f[B]cpdf \-output\-image in.pdf\f[R] [<range>] [\-gs <path>]
[\-rasterize[\-gray | \-1bpp | \-jpeg | \-jpeggray] [\-rasterize\-res
<n>] [\-rasterize\-jpeg\-quality <n>] [\-rasterize\-no\-antialias |
\-rasterize\-downsample] [\-rasterize\-annots] [\-rasterize\-alpha]
[\-tobox <boxname>] \f[B]\-o <format>\f[R]
.PP
Output rasterized images for each page to the given folder and format
e.g \(lqdir/%%%.png\(rq would create dir/001.png and so on.
Options as above and:
.TP
\f[B]\-tobox\f[R] <boxname>
Specify the box to rasterize (default \f[B]/MediaBox\f[R]).
.SH 14. FONTS
\f[B]cpdf \-list\-fonts[\-json] in.pdf\f[R]
.PP
List the fonts on each page in a file together with their types.
Either in plain text (\f[B]\-list\-fonts\f[R]) or JSON
(\f[B]\-list\-fonts\-json\f[R]) format.
.PP
\f[B]cpdf \-print\-font\-table <font name>\f[R] \f[B]in.pdf\f[R]
[\-print\-font\-table\-page <n>]
.PP
Print a font table for a given font name and page, e.g:
.IP
.EX
cpdf \-print\-font\-table /XYPLPB+NimbusSanL\-Bold \-print\-font\-table\-page 2 cpdfmanual.pdf
67 = U+0043 (C \- LATIN CAPITAL LETTER C) = /C
68 = U+0044 (D \- LATIN CAPITAL LETTER D) = /D
70 = U+0046 (F \- LATIN CAPITAL LETTER F) = /F
71 = U+0047 (G \- LATIN CAPITAL LETTER G) = /G
\&...
.EE
.PP
\f[B]cpdf \-copy\-font fromfile.pdf\f[R] \f[B]in.pdf\f[R] [<range>]
\-copy\-font\-page <n> \-copy\-font\-name <name> \f[B]\-o out.pdf\f[R]
.PP
A low\-level operation to copy a font from one file to another.
.TP
\f[B]\-copy\-font\-page\f[R] <n>
The page from which to copy the font.
.TP
\f[B]\-copy\-font\-name\f[R] <n>
The (PDF) name of the font.
.PP
\f[B]cpdf \-remove\-fonts in.pdf \-o out.pdf\f[R]
.PP
Remove fonts from a file.
.PP
\f[B]cpdf \-missing\-fonts in.pdf\f[R]
.PP
Report missing fonts \- i.e those which are unembedded.
.PP
\f[B]cpdf \-embed\-missing\-fonts \-gs <path to gs> in.pdf \-o
out.pdf\f[R]
.PP
Use gs to embed missing fonts into a PDF.
Note: putting a PDF file through gs in this manner may not be lossless:
some metadata may not be preserved.
.PP
\f[B]cpdf \-extract\-font <n>,<pdf font name> in.pdf \-o out.font\f[R]
.PP
Extract a font file from a PDF given a page number, font name pair e.g:
.PP
cpdf \-extract\-font 5,/F50 in.pdf \-o out.ttf
.SH 15. PDF AND JSON
\f[B]cpdf in.pdf \-output\-json\f[R]
[\-output\-json\-parse\-content\-streams]
[\-output\-json\-no\-stream\-data] [\-output\-json\-decompress\-streams]
[\-output\-json\-clean\-strings] [\-utf8] \f[B]\-o out.json\f[R]
.PP
Convert PDF to a JSON format which may be inspected, or edited and
round\-tripped back into PDF.
.TP
\f[B]\-output\-json\-parse\-content\-streams\f[R]
Parse the content streams into JSON too.
.TP
\f[B]\-output\-json\-no\-stream\-data\f[R]
Elide stream data.
This makes a smaller file, but bars round\-tripping.
.TP
\f[B]\-output\-json\-decompress\-streams\f[R]
Keep the streams intact, and decompress them.
.TP
\f[B]\-output\-json\-clean\-strings\f[R]
Deprecated in favour of \f[B]\-utf8\f[R] below.
.TP
\f[B]\-utf8\f[R]
Use UTF8 rather than PDFDocEncoding for strings, to make them more
easily editable.
.PP
\f[B]cpdf \-j in.json \-o out.pdf\f[R]
.PP
Convert a JSON file to a PDF file.
.SH 16. OPTIONAL CONTENT GROUPS
\f[B]cpdf \-ocg\-list in.pdf\f[R]
.PP
List the optional content groups in the PDF, one per line, to standard
output.
.PP
\f[B]cpdf \-ocg\-list\-json in.pdf\f[R]
.PP
List the optional content groups in JSON format, suitable for
modificationn and roundtripping.
.PP
\f[B]cpdf \-ocg\-replace in.json in.pdf \-o out.pdf\f[R]
.PP
Replace the optional content groups in a PDF with the (possibly
modified) output of \f[B]\-ocg\-list\-json\f[R].
.PP
\f[B]cpdf \-ocg\-rename in.pdf \-ocg\-rename\-from <a> \-ocg\-rename\-to
<b> \-o out.pdf\f[R]
.PP
Rename an optional content group given the old and new names.
.PP
\f[B]cpdf \-ocg\-order\-all in.pdf \-o out.pdf\f[R]
.PP
Ensure that every optional content group appears in the order list.
.PP
\f[B]cpdf \-ocg\-coalesce\-on\-name in.pdf \-o out.pdf\f[R]
.PP
Coalesce optional content groups.
For example, if we merge or stamp two files both with an OCG called
\(lqLayer 1\(rq, we will have two different optional content groups.
This command will merge them into a single optional content group.
.SH 17. CREATING NEW PDFS
\f[B]cpdf \-create\-pdf\f[R] [\-create\-pdf\-pages <n>]
[\-create\-pdf\-papersize <papersize>] \f[B]\-o out.pdf\f[R]
.PP
Create a new PDF (default: one page, A4 portrait).
.TP
\f[B]\-create\-pdf\-pages\f[R] <n>
Give the number of pages.
.TP
\f[B]\-create\-pdf\-papersize\f[R] <papersize>
Give the paper size, e.g \(lqa3landscape\(rq or \(lq200pt 600pt\(rq
.PP
\f[B]cpdf \-typeset <filename>\f[R] [\-create\-pdf\-papersize
<papersize>] [\-font <font>] [\-font\-size <n>] [\-subformat
<subformat>] [\-title <string>] \f[B]\-o out.pdf\f[R]
.PP
Typeset a text file into a PDF.
.TP
\f[B]\-create\-pdf\-papersize\f[R] <papersize>
Give the paper size.
.TP
\f[B]\-font\f[R] <font>
The font (default Times\-Roman)
.TP
\f[B]\-font\-size\f[R] <n>
The font size (default 12pt)
.TP
\f[B]\-subformat\f[R] <subformat>
Specify PDF/UA\-1 or PDF/UA\-2 to make a conforming file.
.TP
\f[B]\-title\f[R] <string>
Specify a title when using \f[B]\-subformat\f[R] for a PDF/UA file.
.PP
\f[B]cpdf \-jpeg <filename>\f[R] [\-subformat <subformat>] [\-title
<string>] \f[B]\-o out.pdf\f[R]
.PP
\f[B]cpdf \-png <filename>\f[R] [\-subformat <subformat>] [\-title
<string>] \f[B]\-o out.pdf\f[R]
.PP
\f[B]cpdf \-jpeg2000 <filename>\f[R] [\-subformat <subformat>] [\-title
<string>] \f[B]\-o out.pdf\f[R]
.PP
Build a PDF from an image file (JPEG, PNG or JPEG2000).
.TP
\f[B]\-subformat\f[R] <subformat>
Specify PDF/UA\-1 or PDF/UA\-2 to make a conforming file.
.TP
\f[B]\-title\f[R] <string>
Specify a title when using \f[B]\-subformat\f[R] for a PDF/UA file.
.PP
\f[B]cpdf\f[R] [\-jbig2\-global <filename>] \f[B]\-jbig2 <filename>\f[R]
[\-jbig2\-global | \-jbig2\-global\-clear] [\-jbig2 <filename>] \&...
[\-subformat <subformat>] [\-title <string>] \f[B]\-o out.pdf\f[R]
.PP
Make a multi\-page PDF from one or more PDF\-appropriate JBIG2 fragments
prepared by the jbig2enc program.
For example, in lossless mode:
.PP
\f[B]cpdf \-jbig2 1.jbig2 \-jbig2 2.jbig2 \-jbig2 3.jbig2 \-o
out.pdf\f[R]
.PP
In lossy mode, jbig2globals segments may be specified:
.PP
\f[B]cpdf \-jbig2\-global 0.jbig2globals \-jbig2 1.jbig2 \-jbig2 2.jbig2
\-jbig2 3.jbig2 \-o out.pdf\f[R]
.TP
\f[B]\-jbig2\-global\f[R] <filename>
Change the jbig2global segment in use.
.TP
\f[B]\-jbig2\-global\-clear\f[R]
Cease use of jbig2global segment, and return to lossless mode.
.TP
\f[B]\-subformat\f[R] <subformat>
Specify PDF/UA\-1 or PDF/UA\-2 to make a conforming file.
.TP
\f[B]\-title\f[R] <string>
Specify a title when using \f[B]\-subformat\f[R] for a PDF/UA file.
.SH 18. DRAWING ON PDFS
\f[B]cpdf in.pdf\f[R] [<range>] [\-draw\-struct\-tree] \f[B]\-draw <draw
operations>\f[R] [\-underneath] \f[B]\-o out.pdf\f[R]
.PP
Draw on a PDF.
See cpdfmanual.pdf for a tutorial, and full information.
.TP
\f[B]\-draw\-struct\-tree\f[R]
Produce structure information.
.TP
\f[B]\-underneath\f[R]
Draw underneath instead of on top of any existing page content.
.PP
\f[B]cpdf \-text\-width <string>\f[R] [\-font <font>] [\-fontsize <n>]
.PP
Return the width of a string of text in a one of the standard 14 fonts.
Used for calculations of text position (e.g right\-alignment).
.TP
\f[B]\-font\f[R] <font>
Specify the font.
.TP
\f[B]\-fontsize\f[R] <n>
Specify the font size.
.PP
\f[B]Building and showing paths\f[R]
.TP
\f[B]\-rect\f[R] \(lqx y w h\(rq
Draw rectangle.
.TP
\f[B]\-to\f[R] \(lqx y\(rq
Move to.
.TP
\f[B]\-line\f[R] \(lqx y\(rq
Add line to path.
.TP
\f[B]\-bez\f[R] \(lqx1 y1 x2 y2 x3 y3\(rq
Add Bezier curve to path.
.TP
\f[B]\-bez23\f[R] \(lqx2 y2 x3 y3\(rq
Add Bezier curve to path.
.TP
\f[B]\-bez13\f[R] \(lqx1 y1 x3 y3\(rq
Add Bezier curve to path.
.TP
\f[B]\-circle\f[R] \(lqx y r\(rq
Add circle to path.
.TP
\f[B]\-stroke\f[R]
Stroke path.
.TP
\f[B]\-fill\f[R]
Fill path.
.TP
\f[B]\-filleo\f[R]
Fill path, even odd.
.TP
\f[B]\-strokefill\f[R]
Stroke and fill path.
.TP
\f[B]\-strokefilleo\f[R]
Stroke and fill path, even odd.
.TP
\f[B]\-close\f[R]
Close path.
.PP
\f[B]Clipping with paths\f[R]
.TP
\f[B]\-clip\f[R]
Clip.
.TP
\f[B]\-clipeo\f[R]
Clip, even odd.
.PP
\f[B]Path parameters\f[R]
.TP
\f[B]\-strokecol\f[R] \(lqg\(rq | \(lqr g b\(rq | \(lqc y m k\(rq | <namedcolour>
Set stroke colour.
.TP
\f[B]\-fillcol\f[R] \(lqg\(rq | \(lqr g b\(rq | \(lqc y m k\(rq | <namedcolour>
Set fill colour.
.TP
\f[B]\-thick\f[R] <n>
Set stroke thickness.
.TP
\f[B]\-cap\f[R] <butt | round | square>
Set cap.
.TP
\f[B]\-join\f[R] <miter | round | bevel>
Set join.
.TP
\f[B]\-miter\f[R] <n>
Set miter limit.
.TP
\f[B]\-dash\f[R] <pattern>
Set dash pattern.
.PP
\f[B]The graphics stack and matrices\f[R]
.TP
\f[B]\-push\f[R]
Push graphics stack.
.TP
\f[B]\-pop\f[R]
Pop graphics stack.
.TP
\f[B]\-matrix\f[R] \(lqa b c d e f\(rq
Append to graphics matrix.
.TP
\f[B]\-mtrans\f[R] \(lqtx ty\(rq
Translate the graphics matrix.
.TP
\f[B]\-mrot\f[R] \(lqx y a\(rq
Rotate the graphics matrix.
.TP
\f[B]\-mscale\f[R] \(lqx y sx sy\(rq
Scale the graphics matrix.
.TP
\f[B]\-mshearx\f[R] \(lqx y a\(rq
Shear the graphics matrix in X.
.TP
\f[B]\-msheary\f[R] \(lqx y a\(rq
Shear the graphics matrix in Y.
.PP
\f[B]Re\-use with XObjects\f[R]
.TP
\f[B]\-xobj\-bbox\f[R] \(lqx y w h\(rq
Specify the bounding box for xobjects.
.TP
\f[B]\-xobj\f[R] <name>
Begin saving a sequence of graphics operators.
.TP
\f[B]\-end\-xobj\f[R]
End saving a sequence of graphics operators.
.TP
\f[B]\-use\f[R] <name>
Use a saved sequence of graphics operators.
.PP
\f[B]Images\f[R]
.TP
\f[B]\-draw\-jpeg\f[R] <name>=<filename>
Load a JPEG from file and name it.
.TP
\f[B]\-draw\-png\f[R] <name>=<filename>
Load a PNG from file and name it.
.TP
\f[B]\-draw\-jpeg2000\f[R] <name>=<filename>
Load a JPEG2000 from file and name it.
.TP
\f[B]\-image\f[R] <name>
Draw an image which has already been loaded.
.PP
\f[B]Transparency\f[R]
.TP
\f[B]\-fill\-opacity\f[R] <n>
Set opacity.
.TP
\f[B]\-stroke\-opacity\f[R] <n>
Set stroke opacity.
.PP
\f[B]Text\f[R]
.TP
\f[B]\-bt\f[R]
Begin text.
.TP
\f[B]\-et\f[R]
End text.
.TP
\f[B]\-text\f[R] <string>
Draw text.
.TP
\f[B]\-stext\f[R] <string>
Draw text with %specials.
.TP
\f[B]\-para\f[R] <paragraph>
Typeset a paragraph.
.TP
\f[B]\-paras\f[R] <paragraph>
Typeset multiple paragraphs.
.TP
\f[B]\-indent\f[R] <n>
Set paragraph indent.
.TP
\f[B]\-leading\f[R] <n>
Set leading.
.TP
\f[B]\-charspace\f[R] <n>
Set character spacing.
.TP
\f[B]\-wordspace\f[R] <n>
Set word space.
.TP
\f[B]\-textscale\f[R] <n>
Set text scale.
.TP
\f[B]\-rendermode\f[R] <n>
Set text rendering mode.
.TP
\f[B]\-rise\f[R] <n>
Set text rise.
.TP
\f[B]\-nl\f[R]
New line.
.PP
\f[B]The Next Page\f[R]
.TP
\f[B]\-newpage\f[R]
Move to a fresh page.
.PP
\f[B]Structure Information\f[R]
.TP
\f[B]\-draw\-struct\-tree\f[R]
Add structure information.
Must precede \f[B]\-draw\f[R] on command line.
.TP
\f[B]\-tag\f[R] <name>
Begin marked content.
.TP
\f[B]\-end\-tag\f[R]
End marked content.
.TP
\f[B]\-stag\f[R] <name>
Begin structure tree branch.
.TP
\f[B]\-end\-stag\f[R]
End structure tree branch.
.TP
\f[B]\-auto\-tags\f[R]
Automatically tag paragraphs and images.
.TP
\f[B]\-no\-auto\-tags\f[R]
Refrain from automatically tagging paragraphs and images.
.TP
\f[B]\-artifact\f[R]
Begin manual artifact.
.TP
\f[B]\-end\-artifact\f[R]
End manual artifact.
.TP
\f[B]\-no\-auto\-artifacts\f[R]
Prevent automatic addition of artifacts during post\-processing.
.TP
\f[B]\-namespace\f[R] <namespace>
Set the namespace for future branches of the tree.
.TP
\f[B]\-eltinfo\f[R] <elt=string>
Set element information.
.TP
\f[B]\-end\-eltinfo\f[R]
Erase element information.
.TP
\f[B]\-rolemap\f[R] <rolemap>
Set role map.
.SH 19. ACCESSIBLE PDFS WITH PDF/UA
\f[B]cpdf \-print\-struct\-tree in.pdf\f[R]
.PP
Print a PDF\(cqs structure tree to standard output for inspection.
.PP
\f[B]cpdf \-extract\-struct\-tree in.pdf \-o out.json\f[R]
.PP
Extract the whole structure tree in JSON format.
See cpdfmanual.pdf for details.
.PP
\f[B]cpdf \-replace\-struct\-tree in.json in.pdf \-o out.pdf\f[R]
.PP
Replace a PDF\(cqs structure tree with one from a JSON file.
.PP
\f[B]cpdf \-remove\-struct\-tree in.pdf \-o out.pdf\f[R]
.PP
Remove the structure tree from a file.
.PP
\f[B]cpdf \-mark\-as\-artifact in.pdf \-o out.pdf\f[R]
.PP
Mark all the content of the file as being an artifact.
.PP
\f[B]cpdf \-verify \(lqPDF/UA\-1(matterhorn)\(rq\f[R] \f[B]in.pdf\f[R]
[\-verify\-single <test>] [\-json]
.PP
Verify conformance with PDF/UA\-1.
.TP
\f[B]\-json\f[R]
Output conformance failures in JSON rather than plain text format.
.TP
\f[B]\-verify\-single\f[R] <test>
Verify just one test.
See cpdfmanual.pdf for list of tests.
.PP
\f[B]cpdf \-mark\-as [\(lqPDF/UA\-1\(rq | \(lqPDF/UA\-2\(rq] in.pdf \-o
out.pdf\f[R]
.PP
Mark a PDF as conforming to PDF/UA\-1 or PDF/UA\-2
.PP
\f[B]cpdf \-remove\-mark [\(lqPDF/UA\-1\(rq | \(lqPDF/UA\-2\(rq] in.pdf
\-o out.pdf\f[R]
.PP
Remove conformance marker from a PDF.
.PP
\f[B]cpdf \-create\-pdf\-ua\-<1 | 2> <string>\f[R] [\-create\-pdf\-pages
<n>] [\-create\-pdf\-papersize <papersize>] \f[B]\-o out.pdf\f[R]
.PP
Create a new, blank, PDF/UA\-1 or PDF/UA\-2 file with the given title.
.TP
\f[B]\-create\-pdf\-pages\f[R] <n>
Give the number of pages.
.TP
\f[B]\-create\-pdf\-papersize\f[R] <papersize>
Give the paper size, e.g \(lqa3landscape\(rq or \(lq200pt 600pt\(rq
.SH 20. MISCELLANEOUS
\f[B]cpdf \-draft\f[R] \f[B]in.pdf\f[R] [<range>] [\-boxes]
[\-draft\-remove\-only <n>] \f[B]\-o out.pdf\f[R]
.PP
Remove bit\-mapped (photographic) images from a PDF.
.TP
\f[B]\-boxes\f[R]
Replace each image with a crossed box to show where it was.
.TP
\f[B]\-draft\-remove\-only\f[R]
Remove only one image, with the given name.
The name can be obtained from, for example,
\f[B]\-list\-images\-used\f[R].
.PP
\f[B]cpdf \-remove\-all\-text in.pdf\f[R] [<range>] \f[B]\-o
out.pdf\f[R]
.PP
Remove all text from a PDF.
.PP
\f[B]cpdf \-blacktext in.pdf\f[R] [<range>] \f[B]\-o out.pdf\f[R]
.PP
Make all text black.
.PP
\f[B]cpdf \-blacklines in.pdf\f[R] [<range>] \f[B]\-o out.pdf\f[R]
.PP
Make all lines black.
.PP
\f[B]cpdf \-blackfills in.pdf\f[R] [<range>] \f[B]\-o out.pdf\f[R]
.PP
Make all fills black.
.PP
\f[B]cpdf \-thinlines <min thickness> in.pdf\f[R] [<range>] \f[B]\-o
out.pdf\f[R]
.PP
Make each line a minimum thickness.
A negative value will instead thin lines to the absolute of the value
given.
By processing twice, with a positive then negative figure, it is
therefore possible to clamp thicknesses to a range or single value.
.PP
\f[B]cpdf \-clean in.pdf \-o out.pdf\f[R]
.PP
Deprecated.
This work is now done by default upon writing any file.
.PP
\f[B]cpdf \-set\-version <version number> in.pdf \-o out.pdf\f[R]
.PP
Set the version of a PDF.
E.g for version 1.4, use \f[B]\-set\-version 4\f[R].
For PDF versions starting with 2, add ten to the number.
E.g for PDF 2.0, use \f[B]\-set\-version 10\f[R].
.PP
\f[B]cpdf \-copy\-id\-from source.pdf in.pdf \-o out.pdf\f[R]
.PP
Copy the ID from one PDF to another.
.PP
\f[B]cpdf \-remove\-id in.pdf \-o out.pdf\f[R]
.PP
Remove the ID from a PDF.
.PP
\f[B]cpdf \-list\-spot\-colors in.pdf\f[R]
.PP
List the names of any separation colour spaces in a PDF.
.PP
\f[B]cpdf \-print\-dict\-entry\f[R] \f[B]<key> in.pdf\f[R] [\-json]
.PP
\f[B]cpdf \-remove\-dict\-entry <key>\f[R] \f[B]in.pdf\f[R]
[\-dict\-entry\-search <term>] \f[B]\-o out.pdf\f[R]
.PP
\f[B]cpdf \-replace\-dict\-entry <key> \-replace\-dict\-entry\-value
<value>\f[R] \f[B]in.pdf\f[R] [\-dict\-entry\-search <term>] \f[B]\-o
out.pdf\f[R]
.PP
Low level operations to edit PDF objects directly.
See cpdfmanual.pdf for details.
.PP
\f[B]cpdf \-remove\-clipping in.pdf\f[R] [<range>] \f[B]\-o out.pdf\f[R]
.PP
Remove any clipping paths from a PDF.
.PP
\f[B]cpdf \-obj[\-json] <object specification> in.pdf\f[R]
.PP
\f[B]cpdf \-replace\-obj <object specification>=<object> in.pdf \-o
out.pdf\f[R]
.PP
\f[B]cpdf \-remove\-obj <object number> in.pdf \-o out.pdf\f[R]
.PP
\f[B]cpdf \-extract\-stream[\-decompress] <object specification> in.pdf
\-o out.dat\f[R]
.PP
\f[B]cpdf \-replace\-stream <object specification>
\-replace\-stream\-with <filename> in.pdf \-o out.pdf\f[R]
.PP
Low level operations to explore and edit PDF files object\-by\-object.
See cpdfmanual.pdf for details.
.PP
\f[B]cpdf \-contains\-javascript in.pdf\f[R]
.PP
Prints true if the PDF contains JavaScript, false otherwise.
.PP
\f[B]cpdf \-remove\-javascript in.pdf \-o out.pdf\f[R]
.PP
Remove JavaScript from a PDF.
.PP
\f[B]cpdf \-debug in.pdf \&...\f[R]
.PP
Show debug information.
.PP
\f[B]cpdf \-debug\-crypt in.pdf \&...\f[R]
.PP
Show extra debug information to do with encryption.
.PP
\f[B]cpdf \-debug\-malformed in.pdf \&...\f[R]
.PP
Treat file as if malformed.
.PP
\f[B]cpdf \-debug\-stderr\-to\-stdout in.pdf \&...\f[R]
.PP
Intermingle \f[B]stderr\f[R] and \f[B]stdout\f[R] output on
\f[B]stdout\f[R].
.PP
\f[B]cpdf \-debug\-readable\-ops in.pdf \&...\f[R]
.PP
Use newlines instead of spaces in page stream content.
.PP
\f[B]cpdf \-stay\-on\-error in.pdf \&...\f[R]
.PP
Do not call exit() after an error.
.PP
\f[B]cpdf \-remove\-stream\-content in.pdf \-o out.pdf\f[R]
.PP
Remove stream content when writing.
.SH ENVIRONMENT
.TP
\f[B]CPDF_SHOW_EXT\f[R]
Show command line of external commands as they are called if equal to
\(lqtrue\(rq.
.TP
\f[B]CPDF_DEBUG\f[R]
Same as adding \f[B]\-debug\f[R] to command line, if equal to
\(lqtrue\(rq.
.TP
\f[B]CPDF_REPRODUCIBLE_DATES\f[R]
Expand data \(lqnow\(rq to the same, false value each time, if equal to
\(lqtrue\(rq.
.TP
\f[B]CAMLPDF_REPRODUCIBLE_IDS\f[R]
Produce the same file ID each time, if equal to \(lqtrue\(rq.
.SH BUGS
See https://github.com/johnwhitington/cpdf\-source/issues or email
contact\(atcoherentgraphics.co.uk
.SH AUTHORS
Coherent Graphics Ltd.