annotate admin/notes/font-backend @ 93634:72b3466c2c1e

*** empty log message ***
author Glenn Morris <rgm@gnu.org>
date Fri, 04 Apr 2008 04:38:58 +0000
parents 850ec4b2f0bc
children c6cad0a1a68b
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
92006
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1 Copyright (C) 2002, 2003, 2004, 2005, 2006, 2007, 2008
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2 Free Software Foundation, Inc.
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3 See the end of the file for license conditions.
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6 New font handling mechanism with font backend method
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7 ----------------------------------------------------
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9 The configure script, if invoked with "--enable-font-backend", checks
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
10 if libraries freetype and fontconfig exist. If they are both
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
11 available, macro "USE_FONT_BACKEND" is defined in src/config.h. In
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
12 that case, the existence of Xft library is checked too.
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
13
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
14 The new files are:
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
15 font.h -- header providing font-backend related structures
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
16 (most important ones are "struct font" and "struct
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
17 font_driver"), macros, and etc.
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
18 font.c -- main font handling code.
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
19 xfont.c -- font-driver on X for X core fonts.
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
20 ftfont.c -- generic font-driver for FreeType fonts providing
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
21 device-independent methods of struct font_driver.
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
22 xftfont.c -- font-driver on X using Xft for FreeType fonts
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
23 utilizing methods provided by ftfont.c.
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
24 ftxfont.c -- font-driver on X directly using FreeType fonts
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
25 utilizing methods provided by ftfont.c.
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
26 w32font.c -- font driver on w32 using Windows native fonts,
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
27 corresponding to xfont.c
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
28
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
29 So we already have codes for X. For the other systems (w32 and mac),
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
30 it seems that we need these files:
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
31 atmfont.c -- font-driver on mac using ATM fonts, corresponding
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
32 to xfont.c
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
33 As BDF fonts are currently used on w32, we may also implement these:
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
34 bdffont.c -- generic font-driver for BDF fonts, corresponding to
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
35 ftfont.c
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
36 bdfw32font.c -- font-driver on w32 using BDF fonts,
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
37 corresponding to ftxfont.c
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
38 But, as FreeType already supports BDF fonts, if FreeType and
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
39 Fontconfig are also available on w32, what we need may be:
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
40 ftw32font.c -- font-driver on w32 directly using FreeType fonts
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
41 utilizing methods provided by ftfont.c.
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
42
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
43 And, for those to work, macterm.c and macfns.c must be changed by the
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
44 similar way as xterm.c and xfns.c (the parts "#ifdef USE_FONT_BACKEND"
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
45 ... "#endif" should be checked).
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
46
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
47 It may be interesting if Emacs supports a frame buffer directly and
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
48 has these font driver.
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
49 ftfbfont.c -- font-driver on FB for FreeType fonts.
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
50 bdffbfont.c -- font-driver on FB for BDF fonts.
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
51
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
52 Note: The fontset related codes are not yet matured to work well with
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
53 the font backend method. So, for instance, even if you start Emacs
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
54 as something like this:
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
55 % emacs -fn tahoma
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
56 Non-ASCII Latin characters will not be displayed by the font "tahoma".
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
57 In such a case, please try this:
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
58
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
59 (set-fontset-font "fontset-default" 'latin '("tahoma" . "unicode-bmp"))
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
60
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
61
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
62 This file is part of GNU Emacs.
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
63
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
64 GNU Emacs is free software; you can redistribute it and/or modify
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
65 it under the terms of the GNU General Public License as published by
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
66 the Free Software Foundation; either version 3, or (at your option)
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
67 any later version.
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
68
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
69 GNU Emacs is distributed in the hope that it will be useful,
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
70 but WITHOUT ANY WARRANTY; without even the implied warranty of
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
71 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
72 GNU General Public License for more details.
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
73
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
74 You should have received a copy of the GNU General Public License
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
75 along with GNU Emacs; see the file COPYING. If not, write to the
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
76 Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
850ec4b2f0bc Split off from README.unicode
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
77 Boston, MA 02110-1301, USA.