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:
-ppasswordUse the specified password if the file is encrypted.
-WwidthPage width in points for EPUB layout.
-HheightPage height in points for EPUB layout.
-SsizeFont size in points for EPUB layout.
-UfilenameUser CSS stylesheet for EPUB layout.
-XDisable document styles for EPUB layout.
-dUse display list.
fileInput 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.