http://sourceforge.net/apps/trac/pspkvm/wiki/ConfiguringFourteenFont?format=txt

= Configuring the fourteen-font system =

Test builds 0.5.4 test4 and later have a fourteen font system installed. Essentially, it has support for:

 * four system fonts (plain, italic, bold, bold-italic)
 * four proportional fonts (plain, italic, bold, bold-italic)
 * four monospace fonts (plain, italic, bold, bold-italic)
 * and a fallback font

... this corresponds generally to the specification provided for the MIDP platform, although it adds the 'fallback font' to streamline support especially for large character sets like Han for which bold and italic fonts are rare anyway. The fourteenth font not mentioned here is a 'utility' font containing pictograms and icons for certain parts of the system. It's not generally meant to be user-configurable.

The fonts listed above, however, are fully configurable. You can replace them with whatever works for you. In the demonstration build, various types of Deja Vu--an open-source !TrueType font with good multilingual support--fill the first twelve slots, and Firefly Sung--an open-source font with a reasonably large Han (CJK) character set--is placed in fallback. So, essentially, you get bold and italic support across the European languages supported by Deja Vu, and you still get Han characters when viewing Chinese pages. But you can change this easily to support other languages. The filenames corresponding to the user font list are:

 * sys.ttf, sys_i.ttf, sys_b.ttf, sys_ib.ttf
 * prop.ttf, prop_i.ttf, prop_b.ttf, prop_ib.ttf
 * mono.ttf, mono_i.ttf, mono_b.ttf, mono_ib.ttf
 * fallback.ttf

... and you can switch in whichever fonts you like for all of these.

'''NB: however, do not replace/remove utility.ttf. It has custom glyphs in the user space for fast displays the system relies upon.'''

== Incomplete font sets are still supported ==

Note also that, as before, PSPKVM does not require that you provide a complete font set. Generally, the system falls back as intelligently as it can if you choose to leave any of these fonts out. You can, as before, get by with ''just'' sys.ttf installed, and the system will fall back to it gracefully.

(The exception, again: utility.ttf should not be removed.)

== Just using the built-in fonts is also still supported ==

And, as before, you can turn !FreeType support off entirely if you don't need it. (Though as of test build 4, the semichordal board won't work if you do this... it needs the utility font... we're working on this.)

== Note re !TrueType collection (.ttc) support ==

While the system doesn't explicitly support these yet, if you put one in the position of one of the .ttfs (renamed to the appropriate .ttf filename the system expects there), it will pick up the first font in the collection for that slot. We're working on widening this support, shortly.

[[Image(capture000.png, border=1)]]

(More captures of multilingual support with the fourteen font system are on the MultilingualDemonstration page.)
