Diffstat (limited to 'noncore/unsupported/qpdf/README') (more/less context) (ignore whitespace changes)
-rw-r--r-- | noncore/unsupported/qpdf/README | 89 |
1 files changed, 89 insertions, 0 deletions
diff --git a/noncore/unsupported/qpdf/README b/noncore/unsupported/qpdf/README new file mode 100644 index 0000000..36ce6bc --- a/dev/null +++ b/noncore/unsupported/qpdf/README | |||
@@ -0,0 +1,89 @@ | |||
1 | |||
2 | QPDF - a PDF viewer for the Qtopia environment | ||
3 | |||
4 | This tool is based on xpdf (currently 1.00). It uses the (mostly unmodified - | ||
5 | see below) xpdf PDF rendering engine. The Qtopia adaption was done with a new | ||
6 | OutputDev which renders directly to a QPixmap via QPainter calls. | ||
7 | |||
8 | Changes in 20020406: | ||
9 | - Font substitution handling improved. | ||
10 | - Unknown characters are simply ignored now. | ||
11 | - Fullscreen view added. | ||
12 | |||
13 | Changes in 20020407: | ||
14 | - Crash with FontName == 0 fixed | ||
15 | - Cleanup | ||
16 | - Prepare for CVS import | ||
17 | |||
18 | Changes in 20020408: | ||
19 | - Progress indicator added | ||
20 | - Problems with type 3 fonts (not fully supported by XPDF) solved | ||
21 | - Heavy optimizations in the image rendering code | ||
22 | |||
23 | Changed in 20020413: | ||
24 | - Fixed crash in find routine | ||
25 | - Stylus selection reworked | ||
26 | - Cursor-key navigation added | ||
27 | - Various crashes related to recursive calling of XPDF fixed | ||
28 | |||
29 | |||
30 | Changes to xpdf: | ||
31 | - xpdf calculates nearly everything with doubles. Since ARMs are not equipped | ||
32 | with a FPU, all doubles have been replaced with a C++ class "fouble" (fixed | ||
33 | double), which operates on 32bit integers with fixed point arithmetic. | ||
34 | This gave a speedup of up to 800% for image rendering. | ||
35 | |||
36 | - No Font handling anymore - This means no embedded, no true-type, no type1- | ||
37 | fonts. The task to choose the right font is up to the Qt QFont class. | ||
38 | This works pretty well -- only Symbol fonts give problems. | ||
39 | |||
40 | - Everything that should be rotated (fonts, images) is simply ignored, because | ||
41 | a) the Qtopia Qt/E config has QPainter transformations disabled | ||
42 | b) the transformation is awful slow | ||
43 | c) do you really need rotated images on your iPaq ? ;) | ||
44 | |||
45 | |||
46 | ToDo: | ||
47 | - Clipping has been deactivated, because Qt/E had problems with QPainter | ||
48 | save/restore's with active clipping regions. I need to investigate this | ||
49 | in detail. | ||
50 | |||
51 | - Links are currently simply ignored. | ||
52 | |||
53 | |||
54 | Install: | ||
55 | - xpdf-1.00 | ||
56 | Get the tarball for xpdf, version 1.0, untar it and ./configure it. | ||
57 | (No special flags are needed for ./configure - it simply has to run) | ||
58 | |||
59 | - qpdf | ||
60 | Make sure your QPEDIR / TMAKEPATH variables are correctly ! | ||
61 | |||
62 | cd into the xpdf directory (xpdf-1.00) and untar the qpdf tarball. This | ||
63 | should create a subdirectory qpdf. | ||
64 | cd into this directory and start the script "./setup-qpdf". This | ||
65 | incorporates the above mentioned patches into xpdf. | ||
66 | |||
67 | Now do a make. | ||
68 | |||
69 | Copy the files qpdf, qpdf_icon.png and qpdf.desktop to the appropriate | ||
70 | directories on your iPaq or: | ||
71 | If you want a ipk, just run ./mkipkg | ||
72 | |||
73 | - compress / uncompress | ||
74 | If you run a normal familiar installation, it the standard gzip (I tested | ||
75 | 1.2.4-33 ipkg) can handle the compression format used in PDF files, when | ||
76 | called as uncompress. The BusyBox version of gzip can _not_ handle this | ||
77 | old format. | ||
78 | |||
79 | If you do not have a working uncompress installed on your iPaq, you can | ||
80 | simply use the one in the contrib directory of the tarball (make uncompress | ||
81 | a link to compress). | ||
82 | [I could not find an official tarball for compress -- this is the SuSE | ||
83 | version cross-compiled for ARM] | ||
84 | |||
85 | |||
86 | Have fun ;) | ||
87 | |||
88 | Robert (griebl@gmx.de) | ||
89 | \ No newline at end of file | ||