%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

	    Configuring fonts for MagicPoint presentation

			    March 15, 2001

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

For better presentations with the "MagicPoint" presentation tool, it
is necessary to configure your MagicPoint, and maybe your X11 server
to handle large-size fonts.  The document tries to summarize steps to
make use of large-size fonts with MagicPoint.


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

			   Standard methods

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%


- Scalable English fonts, with the FreeType library

FreeType project, a free software project for TrueType scalable font
renderer, provides the FreeType library at:
	http://www.freetype.org/
MagicPoint implements native support for the FreeType library.  You
can compile the renderer into MagicPoint.  If you have the FreeType
library (libttf.a) somewhere in your system, the "configure" script
will find the library and links the library into the MagicPoint
binary.

To avoid linking libttf.a into the MagicPoint binary, you can specify
the --disable-freetype option to the "configure" script, as below:

	./configure --disable-freetype

If you want to get Free/Commercial TrueType fonts, read the section
"How to get TrueType fonts" below.

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

- Scalable English fonts, with a standard X11 server

A standard X11 server is capable of rendering "Adobe Type-1" scalable
fonts.  To use Adobe Type-1 fonts, you have to install their font
files.  You can find some fonts in /usr/X11R6/lib/X11/fonts/Type1,
which is a part of the X11 standard distribution.  If you do not have
the directory (or a similar directory), please install adequate font
files into your system.

Some good additional fonts can be found at:
	http://www.gimp.org/fonts.html
	ftp://ftp.gimp.org/pub/gimp/fonts/

You may also add some directories to the X11 font search path.  Refer
to the manual for your system.  Also, please do not forget to perform
"xset fp rehash", if you modify the X11 font path while your X11 sever
is running.

You can query these fonts by using XLFD (X11 font specification
string) starting with "-adobe-".  Use "xfontsel" to see whether or not
it is installed.

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

- Scalable Japanese fonts, with VFLib

For non-Adobe and Adobe scalable fonts, a library called VFLib is
available from:
	ftp://gull.se.hiroshima-u.ac.jp/pub/VFlib/.
MagicPoint implements native support for VFlib library.  You can
compile the renderer into MagicPoint.  If you have the VFlib library
(libVFlib.a) somewhere in your system, "configure" script will find
the library and links the library into the MagicPoint binary.

To avoid compiling libVFlib.a into the MagicPoint binary, you can
specify --disable-vflib option to "configure" script, as below:

	./configure --disable-vflib

English fonts will become scalable as well, however, this method is
not very suitable for western readers since this approach usually uses
Japanese font files.  The Japanese font files include several thousand
of letters and will occupies several megabytes on your disk.

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

- Scalable Japanese fonts, with FreeType

Recent MagicPoint can use the FreeType library for rendering Japanese
fonts.  You can use this function by executing configure script as
below:

	./configure --enable-freetype-charset16

You also need to specify Japanese truetype font files with 'tmfont'
directive.  The usage of 'tmfont' directive is described in the SYNTAX
file.

Note: 
If you have already installed the VFlib library and you want to use
the FreeType library to render Japanese fonts, you have to disable
VFlib as below:

	./configure --disable-vflib --enable-freetype-charset16

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

		       Advanced/complex methods

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

- Scalable fonts, with a FreeType-ready X11 server

There seems to be several projects for implementing FreeType into X11
server, or X11 font servers (xfs).  By using these kind of
implementation, a X11 server will be able to render wide variety of
TrueType scalable fonts.  For obtaining implementation, visit the
following URL:
	http://www.freetype.org/projects.htm
	http://www.gimp.org/fonts.html
		See the "Using TrueType fonts with Gimp and X" section.

The projects listed below support not only Western languages but also
Asian languages:
	http://cclub.cc.tut.ac.jp/~go/unix/xtt.html
	http://hawk.ise.chuo-u.ac.jp/student/person/tshiozak/x-tt/index-eng.html

By specifying proper XLFD, you can use those scalable fonts with
MagicPoint.  You may have to modify some of the FreeType-X11 font
specification file as well.


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

- Scalable Japanese/English fonts, with a VFlib-ready X11 server

There are several project to compiling VFlib into X11 server, or X11
font server (xfs), for example:
	http://karin.ip.titech.ac.jp/~takagi/X-VFlib/index.html

By specifying proper XLFD, you can use those scalable fonts with
MagicPoint.  You may have to modify some of the VFlib-X11 font
specification file as well.


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

- Scalable Japanese fonts, with the VFlib/FreeType-hetero library

It may be really confusing (even for the authors), but there are
several attempts to merge VFlib and FreeType.  Some try to provide
functionality of FreeType under VFlib API (FreeType-in-VFlib), and
others try to do the other way around (VFlib-in-FreeType).

In either cases, you can link the library into MagicPoint itself.

There are, of course, attempts to merge those font renderers into X11
servers or X11 font servers (xfs).  In this case, you can use scalable
font by using proper XLFD.


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

			    Miscellaneous

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

- How to get TrueType fonts.

You can get freely available TrueType fonts from following:
	http://www.aaa.nl/people/mkatwijk/freettf.html
	http://come.to/freefonts
	CTAN mirros, pub/CTAN/fonts/cm/ps-type1/bakoma/ttf
		Computer modern fonts in TrueType format
	ftp://www.mew.org/MagicPoint/xtt-fonts_0.19981020-3.tar.gz
		Freely redistributable Japanese fonts are converted into
		TrueType format.  (Wadalab gothic and Watanabe mincho)

	http://members.aol.com/JR9er/index.html
	http://members.xoom.com/acidfonts/
	http://dingbats.i-us.com/
	http://www.freestuffcenter.com/fonts.html
	http://www.fontpool.com/
		TrueType font collections and collections of links.

Also there are several sources for free-of-charge fonts, with some
licensing things:
	http://microsoft.com/typography/fontpack/default.htm
		NOTE: Because that MS fonts package is Self Extract type 
		windows executable, you must extract it on windows 
		platform.  mmmm...
	http://www.bitstream.com/products/world/cyberbits/index.html
		NOTE: You can download it without fee.
		You must sign a form to download this.
		You can also purchase their CD-ROM.

Of course, it's also good for you to purchase commercial font
products.  Here are some online stores for font files, including
TrueType fonts:
	http://www3.digitalriver.com/bit/index.html
	http://www.arttoday.com/
	http://www.matchfonts.com/

You may also able to purchase "font collection CD-ROM", at computer
store near you.

NOTE: TeX-deribed fonts (including computer modern fonts) places marks
like "<" or ">" in strange places.  Therefore, you may have some trouble
writing formulas and other non-plain text.

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
