summaryrefslogtreecommitdiff
path: root/README
blob: abfebebdb5db1ef34def5d23ed4ea8b9205e28d9 (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
ABOUT

MuPDF is a lightweight PDF viewer and toolkit written in portable C.

The renderer in MuPDF is tailored for high quality anti-aliased
graphics.  MuPDF renders text with metrics and spacing accurate to
within fractions of a pixel for the highest fidelity in reproducing
the look of a printed page on screen.

MuPDF has a small footprint.  A binary that includes the standard
Roman fonts is only one megabyte.  A build with full CJK support
(including an Asian font) is approximately five megabytes.

MuPDF has support for all non-interactive PDF 1.7 features, and the
toolkit provides a simple API for accessing the internal structures of
the PDF document.  Example code for navigating interactive links and
bookmarks, encrypting PDF files, extracting fonts, images, and
searchable text, and rendering pages to image files is provided.

LICENSE

MuPDF -- PDF parsing, rendering and viewing toolkit.

Copyright (C) 2009 Artifex Software, Inc.

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

COMPILING

Before compiling MuPDF you need to install thirdy party dependencies.

	zlib
	libjpeg
	freetype2
	jbig2dec
	OpenJPEG

If you don't have these installed on your system you can download and unzip
the mupdf-thirdparty.zip archive in the mupdf source tree. The makefile
will pick up the existence of this directory automatically.

You must unpack mupdf-thirdparty.zip to build using the Visual Studio project.

You will need to use GNU Make to build with the supplied Makefile.
It may be necessary to edit the Makefile for your system if it
cannot find header files or libraries.

DOWNLOAD

The latest development source is available directly from the darcs repository.
Browse the source or use the following command line to check out the source:

    darcs get http://mupdf.com/repos/mupdf

INSTALLING

Typing "make prefix=/usr/local install" will install the binary,
static library and header files on your system.

REPORTING BUGS AND PROBLEMS

Report bugs on the ghostscript bugzilla, with MuPDF as the
selected component.

	http://bugs.ghostscript.com/

If you are reporting a problem with PDF parsing,
please include the problematic file as an attachment.