mutool trace#
The trace
command prints a trace of device calls needed to render a page.
mutool trace [options] file [pages]
Note
Command line parameters within square brackets []
are optional.
[options]
Options are as follows:
-p
passwordUse the specified password if the file is encrypted.
-W
widthPage width in points for EPUB layout.
-H
heightPage height in points for EPUB layout.
-S
sizeFont size in points for EPUB layout.
-U
filenameUser CSS stylesheet for EPUB layout.
-X
Disable document styles for EPUB layout.
-d
Use display list.
file
Input file name. The input can be any of the document formats supported by MuPDF.
[pages]
Comma separated list of page ranges. The first page is “1”, and the last page is “N”. The default is “1-N”.
The trace takes the form of an XML document, with the root element being the document, its children each page, and one page child element for each device call on that page.
An example trace:
<document filename="hello.pdf">
<page number="1" mediabox="0 0 595 842">
<fill_path winding="nonzero" colorspace="DeviceRGB" color="1 0 0" transform="1 0 0 -1 0 842">
<moveto x="50" y="50"/>
<lineto x="100" y="200"/>
<lineto x="200" y="50"/>
</fill_path>
<fill_text colorspace="DeviceRGB" color="0" transform="1 0 0 -1 0 842">
<span font="Times-Roman" wmode="0" trm="100 0 0 100">
<g unicode="H" glyph="H" x="50" y="500" />
<g unicode="e" glyph="e" x="122.2" y="500" />
<g unicode="l" glyph="l" x="166.6" y="500" />
<g unicode="l" glyph="l" x="194.4" y="500" />
<g unicode="o" glyph="o" x="222.2" y="500" />
<g unicode="!" glyph="exclam" x="272.2" y="500" />
</span>
</fill_text>
</page>
</document>
This software is provided AS-IS with no warranty, either express or implied. This software is distributed under license and may not be copied, modified or distributed except as expressly authorized under the terms of that license. Refer to licensing information at artifex.com or contact Artifex Software, Inc., 39 Mesa Street, Suite 108A, San Francisco, CA 94129, USA, for further information.