mutool draw

The draw command will render a document to image files, convert to another vector format, or extract the text content.

The supported input document formats are: pdf, xps, cbz, and epub.
The supported output image formats are: pbm, pgm, ppm, pam, png, pwg, pcl and ps.
The supported output vector formats are: svg, pdf, and debug trace (as xml).
The supported output text formats are: plain text, html, and structured text (as xml or json).

.. code-block:: bash

mutool draw [options] file [pages]

[options] Options are as follows:

``-p`` password
	Use the specified password if the file is encrypted.
``-o`` output
	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`` for text output formats, for image output formats nothing is outputted.
``-F`` format
	Enforce a specific output format. Only necessary when outputting to ``stdout`` since normally the output filename is used to infer the output format.
``-q``
	Be quiet, do not print progress messages.
``-R`` angle
	Rotate clockwise by given number of degrees.
``-r`` resolution
	Render the page at the specified resolution. The default resolution is 72 dpi.
``-w`` width
	Render the page at the specified width (or, if the ``-r`` flag is used, render with a maximum width).
``-h`` height
	Render the page at the specified height (or, if the ``-r`` flag is used, render with a maximum height).
``-f``
	Fit exactly; ignore the aspect ratio when matching specified width/heights.
``-b`` box
	Use named page box (``MediaBox``, ``CropBox``, ``BleedBox``, ``TrimBox``, or ``ArtBox``).
``-B`` bandheight
	Render in banded mode with each band no taller than the given height. This uses less memory during rendering. Only compatible with ``pam``, ``pgm``, ``ppm``, ``pnm`` and ``png`` output formats. Banded rendering and md5 checksumming may not be used at the same time.
``-T`` threads
	Number of threads to use for rendering (banded mode only).
``-W`` width
	Page width in points for EPUB layout.
``-H`` height
	Page height in points for EPUB layout.
``-S`` size
	Font size in points for EPUB layout.
``-U`` filename
	User CSS stylesheet for EPUB layout.
``-X``
	Disable document styles for EPUB layout.
``-a``
	Disable usage of accelerator file.
``-c`` colorspace
	Render in the specified colorspace. Supported colorspaces are: ``mono``, ``gray``, ``grayalpha``, ``rgb``, ``rgbalpha``, ``cmyk``, ``cmykalpha``. Some abbreviations are allowed: ``m``, ``g``, ``ga``, ``rgba``, ``cmyka``. The default is chosen based on the output format.
``-e`` filename
	Proof ICC profile filename for rendering.
``-G`` gamma
	Apply gamma correction. Some typical values are 0.7 or 1.4 to thin or darken text rendering.
``-I``
	Invert colors.
``-s`` [mft5]
	Show various bits of information: ``m`` for glyph cache and total memory usage, ``f`` for page features such as whether the page is grayscale or color, ``t`` for per page rendering times as well statistics, and ``5`` for md5 checksums of rendered images that can be used to check if rendering has changed.
``-A`` bits
	Specify how many bits of anti-aliasing to use. The default is ``8``. ``0`` means no anti-aliasing, ``9`` means no anti-aliasing, centre-of-pixel rule, ``10`` means no anti-aliasing, any-part-of-a-pixel rule.
``-A`` graphics-bits/text-bits
	Specify separate numbers of bits for anti-aliasing for graphics and for text, use a slash ``/`` as separator.
``-l`` width
	Minimum stroke line width (in pixels).
``-K``
	Do not draw text.
``-KK``
	Only draw text.
``-D``
	Disable use of display lists. May cause slowdowns, but should reduce the amount of memory used.
``-i``
	Ignore errors.
``-m`` limit
	Limit memory usage in bytes.
``-L``
	Low memory mode (avoid caching objects by clearing cache after each page).
``-P``
	Run interpretation and rendering at the same time.
``-N``
	Disable ICC workflow.
``-O`` overprint
	Control spot/overprint rendering: ``0`` for no spot rendering, ``1`` for Overprint simulation (default), or ``2`` for full spot rendering.
``-t`` language
	Specify language/script for OCR (default: eng)
``-d`` ocr-file-path
	Specify path for OCR files (default: rely on ``TESSDATA_PREFIX`` environment variable.
``-k`` correction
	Set the skew correction, either one of ``auto``, ``0`` for increase size, ``1`` for maintain size, or ``2`` for decrease size.
``-k`` correction,angle
	Set the skew correction as well as the angle.
``-y l``
	Print the layer configs to stderr.
``-y`` layer-number
	Select layer config (by number from ``-y l``).
``-y`` layer-number,item1,item2,...
	Select layer config (by number from ``-y l``) and toggle the listed items.
``-Y``
	Print the individual layers to stderr.
``-z`` layer-number
	Hide individual layer.
``-Z`` layer-number
	Show individual layer.

file Input file name.

[pages] Comma separated list of page ranges. The first page is "1", and the last page is "N". The default is "1-N".