| Index: third_party/freetype2/src/src/pcf/README
|
| diff --git a/third_party/freetype2/src/src/pcf/README b/third_party/freetype2/src/src/pcf/README
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..10eff15fbe8a9bca55d879fba1c59164ae172878
|
| --- /dev/null
|
| +++ b/third_party/freetype2/src/src/pcf/README
|
| @@ -0,0 +1,96 @@
|
| + FreeType font driver for PCF fonts
|
| +
|
| + Francesco Zappa Nardelli
|
| + <francesco.zappa.nardelli@ens.fr>
|
| +
|
| +
|
| +Introduction
|
| +************
|
| +
|
| +PCF (Portable Compiled Format) is a binary bitmap font format, largely used
|
| +in X world. This code implements a PCF driver for the FreeType library.
|
| +Glyph images are loaded into memory only on demand, thus leading to a small
|
| +memory footprint.
|
| +
|
| +Information on the PCF font format can only be worked out from
|
| +`pcfread.c', and `pcfwrite.c', to be found, for instance, in the XFree86
|
| +(www.xfree86.org) source tree (xc/lib/font/bitmap/).
|
| +
|
| +Many good bitmap fonts in bdf format come with XFree86: they can be
|
| +compiled into the pcf format using the `bdftopcf' utility.
|
| +
|
| +
|
| +Supported hardware
|
| +******************
|
| +
|
| +The driver has been tested on linux/x86 and sunos5.5/sparc. In both
|
| +cases the compiler was gcc. When back in Paris, I will test it also
|
| +on linux/alpha.
|
| +
|
| +
|
| +Encodings
|
| +*********
|
| +
|
| +Use `FT_Get_BDF_Charset_ID' to access the encoding and registry.
|
| +
|
| +The driver always exports `ft_encoding_none' as face->charmap.encoding.
|
| +FT_Get_Char_Index() behavior is unmodified, that is, it converts the ULong
|
| +value given as argument into the corresponding glyph number.
|
| +
|
| +
|
| +Known problems
|
| +**************
|
| +
|
| +- dealing explicitly with encodings breaks the uniformity of freetype2
|
| + api.
|
| +
|
| +- except for encodings properties, client applications have no
|
| + visibility of the PCF_Face object. This means that applications
|
| + cannot directly access font tables and are obliged to trust
|
| + FreeType.
|
| +
|
| +- currently, glyph names and ink_metrics are ignored.
|
| +
|
| +I plan to give full visibility of the PCF_Face object in the next
|
| +release of the driver, thus implementing also glyph names and
|
| +ink_metrics.
|
| +
|
| +- height is defined as (ascent - descent). Is this correct?
|
| +
|
| +- if unable to read size information from the font, PCF_Init_Face
|
| + sets available_size->width and available_size->height to 12.
|
| +
|
| +- too many english grammar errors in the readme file :-(
|
| +
|
| +
|
| +License
|
| +*******
|
| +
|
| +Copyright (C) 2000 by Francesco Zappa Nardelli
|
| +
|
| +Permission is hereby granted, free of charge, to any person obtaining
|
| +a copy of this software and associated documentation files (the
|
| +"Software"), to deal in the Software without restriction, including
|
| +without limitation the rights to use, copy, modify, merge, publish,
|
| +distribute, sublicense, and/or sell copies of the Software, and to
|
| +permit persons to whom the Software is furnished to do so, subject to
|
| +the following conditions:
|
| +
|
| +The above copyright notice and this permission notice shall be
|
| +included in all copies or substantial portions of the Software.
|
| +
|
| +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
| +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
| +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
|
| +IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
|
| +CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
|
| +TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
|
| +SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
| +
|
| +
|
| +Credits
|
| +*******
|
| +
|
| +Keith Packard wrote the pcf driver found in XFree86. His work is at
|
| +the same time the specification and the sample implementation of the
|
| +PCF format. Undoubtedly, this driver is inspired from his work.
|
|
|