summaryrefslogtreecommitdiff
path: root/docs/index.html
blob: 59a11a5bcaf533b81f8dc1330fb8d18e9fba3a93 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
<!DOCTYPE html>
<html>
<head>
<title>MuPDF Documentation</title>
<link rel="stylesheet" href="style.css" type="text/css">
<meta name="viewport" content="width=device-width, initial-scale=1">
</head>

<body>

<header>
<h1>MuPDF Documentation</h1>
</header>

<nav>
<a href="http://mupdf.com/index.html">About</a>
<a href="http://mupdf.com/news.html">News</a>
<a href="index.html">Documentation</a>
<a href="http://mupdf.com/downloads/">Downloads</a>
<a href="http://git.ghostscript.com/?p=mupdf.git;a=summary">Source</a>
<a href="https://bugs.ghostscript.com/">Bugs</a>
</nav>

<article>

<p>
MuPDF is an open source software framework for viewing and converting PDF, XPS, and E-book documents.
There are viewers for various platforms,
several command line tools,
and a software library for building tools and applications.

<h2>Viewers</h2>

<p>
For Linux and Windows there are two viewers. One is a very basic viewer using x11 and win32, respectively.
It has been supplanted by a newer viewer using OpenGL for rendering, which has more features
such as table of contents, unicode search, etc.
We keep the old viewers around for older systems where OpenGL is not available.

<p>
Read the <a href="manual-mupdf-gl.html">manual for the new Linux and Windows viewer</a>.

<p>
Android currently has several different viewers with varying degrees of complexity:

<dl>
<dt><a href="https://play.google.com/store/apps/details?id=com.artifex.mupdfdemo">MuPDF</a>
<dd>The main app on Google Play. Supports forms and annotations.
<dt><a href="https://play.google.com/store/apps/details?id=com.artifex.mupdf.viewer.app">MuPDF viewer</a>
<dd>A slimmed down viewer only variant of the main app.
<dt><a href="https://play.google.com/store/apps/details?id=com.artifex.mupdf.mini.app">MuPDF mini</a>
<dd>A minimal code example of a document viewer.
</dl>

<p>
The iOS viewer is available on the <a href="https://itunes.apple.com/us/app/mupdf/id482941798">App Store</a>.

<h2>Command Line Tools</h2>

<p>
The command line tools are all gathered into one umbrella command: mutool.

<p>
For rendering and converting documents there are three commands available:

<dl>
<dt><a href="manual-mutool-draw.html">mutool draw</a>
<dd>This is the more customizable tool, but also has a more difficult set of command line options.
It is primarily used for rendering a document to image files.
<dt><a href="manual-mutool-convert.html">mutool convert</a>
<dd>This tool is used for converting documents into other formats, and is easier to use.
<dt><a href="manual-mutool-trace.html">mutool trace</a>
<dd>This is a debugging tool used for printing a trace of the graphics device calls on a page.
</dl>

<p>
There are also several tools specifically for working with PDF files:

<dl>
<dt><a href="manual-mutool-show.html">mutool show</a>
<dd>A tool for displaying the internal objects in a PDF file.
<dt><a href="manual-mutool-extract.html">mutool extract</a>
<dd>Extract images and embedded font resources.
<dt><a href="manual-mutool-clean.html">mutool clean</a>
<dd>Rewrite PDF file. Used to fix broken files, or to make a PDF file human editable.
<dt><a href="manual-mutool-merge.html">mutool merge</a>
<dd>Merge pages from multiple input files into a new PDF.
<dt><a href="manual-mutool-create.html">mutool create</a>
<dd>Create a new PDF file from a text file with graphics commands.
<dt><a href="manual-mutool-portfolio.html">mutool portfolio</a>
<dd>Manipulate PDF portfolios.
</dl>

<p>
And finally, there is a tool for doing anything you can imagine:

<dl>
<dt><a href="manual-mutool-run.html">mutool run</a>
<dd>A tool for running Javascript programs with access to the MuPDF library functions.
</dl>

<h2>Library</h2>

<p>
The library is written in portable C.
<!--
To learn more about the C interface, read the <a href="book/nav.xhtml">MuPDF Explored</a> book.
The book is also available as a <a href="book.pdf">PDF</a> and <a href="book.epub">EPUB</a> file.
-->

<ul>
<li><a href="building.html">How to build the library</a>.
<li><a href="coding-overview.html">Overview</a>.
<li><a href="coding-style.html">Coding style</a>.
<li><a href="coding-progressive.html">Progressive loading</a>.
<li><a href="thirdparty.html">List of third party libraries</a>.
</ul>

<p>
There is also a Java library, which uses JNI to provide access to the C library.
The Java classes provide an interface very similar to that available in the
<a href="manual-mutool-run.html">mutool run</a> command line tool.
This Java library also powers the Android SDK.

<p>
If you want to build an application for Android, you have several options. You
can base it off one of the existing viewers, or build a new app using the Java
library directly.

<ul>
<li><a href="android-sdk.html">Android SDK documentation</a>.
</ul>

<h2>Contributing</h2>

<p>
We welcome patches from outside contributors.
If you want to contribute patches to MuPDF, please review and sign the
<a href="http://artifex.com/wp-content/uploads/2017/02/Contributor-License-Agreement-2012.pdf">
Artifex Contributor License Agreement</a>.

<p>
Artifex Software also has a <a href="https://artifex.com/developers-bug-bounty-program/">bug bounty program</a>.

</article>

<footer>
<a href="http://artifex.com"><img src="artifex-logo.png" align="right"></a>
Copyright &copy; 2006-2017 Artifex Software Inc.
</footer>

</body>
</html>