comparison mupdf-source/docs/tools/mutool-convert.rst @ 2:b50eed0cc0ef upstream

ADD: MuPDF v1.26.7: the MuPDF source as downloaded by a default build of PyMuPDF 1.26.4. The directory name has changed: no version number in the expanded directory now.
author Franz Glasner <fzglas.hg@dom66.de>
date Mon, 15 Sep 2025 11:43:07 +0200
parents
children
comparison
equal deleted inserted replaced
1:1d09e1dec1d9 2:b50eed0cc0ef
1 .. _mutool_convert:
2
3 mutool convert
4 ==========================================
5
6 The ``convert`` command converts an input file into another format.
7
8 .. code-block::
9
10 mutool convert [options] file [pages]
11
12 ``[options]``
13 Options are as follows:
14
15 ``-p`` password
16 Use the specified password if the file is encrypted.
17 ``-o`` output
18 The output file name. The output format is inferred from the output filename. Embed ``%d`` in the name to indicate the page number (for example: "page%d.png"). Printf modifiers are supported, for example "%03d". If no output is specified, the output will go to ``stdout``.
19 ``-F`` output format (default inferred from output file name)
20 - raster: ``cbz``, ``png``, ``pnm``, ``pgm``, ``ppm``, ``pam``, ``pbm``, ``pkm``.
21 - print-raster: ``pcl``, ``pclm``, ``ps``, ``pwg``.
22 - vector: ``pdf``, ``svg``.
23 - text: ``html``, ``xhtml``, ``text``, ``stext``.
24 ``-b`` box
25 Use named page box (``MediaBox``, ``CropBox``, ``BleedBox``, ``TrimBox``, or ``ArtBox``).
26 ``-A`` bits
27 Specify how many bits of anti-aliasing to use. The default is ``8``.
28 ``-W`` width
29 Page width in points for EPUB layout.
30 ``-H`` height
31 Page height in points for EPUB layout.
32 ``-S`` size
33 Font size in points for EPUB layout.
34
35 ``-U`` filename
36 User CSS stylesheet for EPUB layout.
37
38 ``-X``
39 Disable document styles for EPUB layout.
40
41 ``-O`` comma separated list of options for output format.
42 See
43 :doc:`/reference/common/pdf-write-options`
44 and
45 :doc:`/reference/common/document-writer-options`.
46
47 ``file``
48 Input file name. The file can be any of the supported input formats.
49
50 ``[pages]``
51 Comma separated list of page ranges. The first page is "1", and the
52 last page is "N". The default is "1-N".