| 1 |
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 2 |
|
| 3 |
MagicPoint - an X11 based presentation tool |
| 4 |
|
| 5 |
September 9, 2003 |
| 6 |
|
| 7 |
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 8 |
|
| 9 |
MagicPoint is an X11 based presentation tool. It is designed to make |
| 10 |
simple presentations easy while to make complicated presentations |
| 11 |
possible. Its presentation file (whose suffix is typically .mgp) is |
| 12 |
just text so that you can create presentation files quickly with your |
| 13 |
favorite editor (e.g. Emacs). |
| 14 |
|
| 15 |
This is one of the alpha releases of MagicPoint. We're planing to add |
| 16 |
a version control mechanism of .mgp file for forward compatibly. But |
| 17 |
currently, such a mechanism is missing. Please use this package at |
| 18 |
your own risk. |
| 19 |
|
| 20 |
MagicPoint is completely free but absolutely no warranty. For more |
| 21 |
information, please refer to COPYRIGHT or COPYRIGHT.jp. Please note |
| 22 |
that some of the source codes is derived from other people's works, |
| 23 |
and may have different distribution policies. Be sure to check the |
| 24 |
comments in the source codes. |
| 25 |
|
| 26 |
|
| 27 |
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 28 |
|
| 29 |
INSTALLATION |
| 30 |
|
| 31 |
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 32 |
|
| 33 |
Since MagicPoint extensively uses fonts in various sizes, we recommend |
| 34 |
you to install good font rendering systems in your system. |
| 35 |
|
| 36 |
THIS DOCUMENT ASSUMES THAT YOU WILL USE MAGICPOINT WITH **TRUETYPE** |
| 37 |
FONTS. YOU SHOULD INSTALL *FREETYPE* BEFORE YOU INSTALL MAGICPOINT. |
| 38 |
|
| 39 |
To install "libttf.a", see: |
| 40 |
http://www.freetype.org/ |
| 41 |
|
| 42 |
If you want to use other rendering systems, read "README.fonts" or |
| 43 |
"README.fonts.jp". |
| 44 |
|
| 45 |
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 46 |
|
| 47 |
Follow the steps below to make MagicPoint: |
| 48 |
|
| 49 |
English or European: |
| 50 |
% ./configure |
| 51 |
|
| 52 |
Japanese: |
| 53 |
% ./configure --enable-freetype-charset16 |
| 54 |
|
| 55 |
% xmkmf |
| 56 |
% make Makefiles |
| 57 |
% make |
| 58 |
|
| 59 |
Invoking `configure' updates Imakefile. So, do NOT forget to invoke |
| 60 |
`xmkmf' everytime you update Imakefile. |
| 61 |
|
| 62 |
Note: if you have to use a non-standard compiler, you must declare |
| 63 |
your compiler by using "env" command, like: |
| 64 |
|
| 65 |
% env CC=gcc ./configure # force gcc |
| 66 |
% env CC=shlicc2 ./configure # force shlicc2 (bsdi3) |
| 67 |
|
| 68 |
We cannot make a guess in the configure script, since "imake" |
| 69 |
may dislike the compiler that was guessed by configure. This |
| 70 |
applies to, for example, Solaris without the Sun compiler |
| 71 |
license (gcc-only environment). |
| 72 |
|
| 73 |
|
| 74 |
Note 1: If you are willing to use the iso-8859-x character set (i.e. you |
| 75 |
would like setlocale() to be called at startup), specify the |
| 76 |
"--enable-locale" option. |
| 77 |
|
| 78 |
Note 2: If you have libraries installed at odd places, use the option |
| 79 |
--with-searchpath=/your/odd/path. E.g. if you have installed libfreetype |
| 80 |
on MAcOS X from Fink, use ./configure --with-searchpath=/sw |
| 81 |
Multiple directories need to be included in quotes and seperated with |
| 82 |
spaces. |
| 83 |
|
| 84 |
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 85 |
|
| 86 |
It's a good idea to preview sample files before installation. For more |
| 87 |
information, see "sample/README" or "sample/README.jp", which |
| 88 |
describes how to install TrueType fonts. |
| 89 |
|
| 90 |
To visualize the sample{,-jp}.mgp file, type: |
| 91 |
|
| 92 |
% ./mgp sample/sample.mgp |
| 93 |
% ./mgp sample/sample-jp.mgp |
| 94 |
|
| 95 |
To visualize the tutorial{,-jp}.mgp file, type: |
| 96 |
|
| 97 |
% ./mgp sample/tutorial.mgp |
| 98 |
% ./mgp sample/tutorial-jp.mgp |
| 99 |
|
| 100 |
WE STRONGLY RECOMMEND TO BUY TRUETYPE FONTS IF YOU WANT TO GIVE YOUR |
| 101 |
PRESENTATION WITH BEAUTIFUL FONTS. |
| 102 |
|
| 103 |
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 104 |
|
| 105 |
When you believe that everything is OK, install MagicPoint as follows: |
| 106 |
|
| 107 |
% su |
| 108 |
# make install |
| 109 |
# make install.man |
| 110 |
|
| 111 |
Alternatively you can build a native package (RPM, DEB, PKG, ...) for |
| 112 |
your operating system with the EPM package manager (freely available |
| 113 |
from http://www.easysw.com/epm/) and install this package. The configu- |
| 114 |
ration file for the packages is "mgp.list". |
| 115 |
|
| 116 |
The EPM method has the advantage that you can uninstall magicpoint later |
| 117 |
if you no longer need it or want to upgarde to a new version. The following |
| 118 |
commands for instance generate a Debian package and a RPM package on linux |
| 119 |
systems: |
| 120 |
|
| 121 |
% su # necessary on Debian only |
| 122 |
$ epm -f deb -nm mgp # creates DEB in subdirectory linux-*/ |
| 123 |
$ epm -f rpm -nm mgp # creates RPM in subdirectory linux-*/ |
| 124 |
|
| 125 |
If you want to paste EPS figures into your presentation, you will need |
| 126 |
to install "ghostscript" or "alike". |
| 127 |
|
| 128 |
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 129 |
|
| 130 |
FOR MORE INFO |
| 131 |
|
| 132 |
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 133 |
|
| 134 |
Official home page of MagicPoint is: |
| 135 |
http://member.wide.ad.jp/wg/mgp/ |
| 136 |
|
| 137 |
Stable release packages are available from: |
| 138 |
ftp://sh.wide.ad.jp/WIDE/free-ware/mgp/ |
| 139 |
|
| 140 |
To join the mailing-list for MagicPoint, See: |
| 141 |
http://member.wide.ad.jp/wg/mgp/ml.html |
| 142 |
http://member.wide.ad.jp/wg/mgp/ml-jp.html (in Japanese) |
| 143 |
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |