Font Configuration in Amaya

How Amaya selects fonts

Amaya works with a fonts configuration file. By default that fonts configuration file is located in the Amaya/config/ directory and used fonts are located in the Amaya/fonts directory.

• The "Amaya/config/fonts.gl" file is used on Mac OSX and Linux versions of Amaya
• The "Amaya/config/fonts.gl.win" file is used on Windows versions of Amaya

Format of Font Configuration files

Criteria used to select a font are:

• the script: 0 for unicode ( for japanese), 1-17 for ISO-8859-1 to ISO-8859-17, 20 for Symbol , 21 for Stix fonts.
• the font family: 1 for serif, 2 for sans-serif, 3 for monospace
• the font face: 1 for normal, 2 for bold, 3 for italic, 4 bold italic

The principle is to attach the path of of the font file (example : "/usr/share/fonts/truetype/msttcorefonts/arial.ttf" on a Linux platform or "$OSDIR\fonts\arial.ttf" on a Windows platform) to each set of criteria in fonts configuration files.

The syntax of these files is:

• One line that declares the script + a comment

  <script>,#<a comment>

• Followed by several lines that declare the connection between a font family and a font face with a font selector. For optimization purpose, it's possible to declare several font faces in the same line. In this case only the first font face identifier (1 for example) is declare. The second font selector is connected to the first font face identifier incremented to 1, etc.

  <font-family>;<font-face>=<font descriptor>;<font descriptor>;....

Amaya applies its standard strategy to select a font (as if no Font Configuration file exists).

Windows example ($OSDIR points to the OS location)

1;#Latin1 (US and Western Europe)

1;1=$OSDIR\fonts\times.ttf;2=$OSDIR\fonts\timesbd.ttf;3=$OSDIR\fonts\timesi.ttf;4=$OSDIR\fonts\timesbi.ttf;

2;1=$OSDIR\fonts\arial.ttf;2=$OSDIR\fonts\arialbd.ttf;3=$OSDIR\fonts\ariali.ttf;4=$OSDIR\fonts\arialbi.ttf;

3;1=$OSDIR\fonts\cour.ttf;2=$OSDIR\fonts\courbd.ttf;3=$OSDIR\fonts\couri.ttf;4=$OSDIR\fonts\courbi.ttf;

Linux example ($THOTDIR points to the Amaya root)

1;#Latin1 (US and Western Europe)

1;1=$THOTDIR/fonts/FreeSerif.ttf;2=$THOTDIR/fonts/FreeSerifBold.ttf;3=$THOTDIR/fonts/FreeSerifItalic.ttf;4=$THOTDIR/fonts/FreeSerifBoldItalic.ttf;

2;1=$THOTDIR/fonts/FreeSans.ttf;2=$THOTDIR/fonts/FreeSansBold.ttf;3=$THOTDIR/fonts/FreeSansOblique.ttf;4=$THOTDIR/fonts/FreeSansBoldOblique.ttf;

3;1=$THOTDIR/fonts/FreeMono.ttf;2=$THOTDIR/fonts/FreeMonoBold.ttf;3=$THOTDIR/fonts/FreeMonoOblique.ttf;4=$THOTDIR/fonts/FreeMonoBoldOblique.ttf;

How to select other fonts

In order to let you choose your own fonts, you have to create your own fonts configuration file in your AmayaHome:

• "~/Library/Application Support/amaya/fonts.gl" for a Mac OSX platform
• "$HOME/.amaya/fonts.gl" for a Linux platform
• "$HOMEDRIVE:\$HOMEPATH\amaya\fonts.gl.win" for a Windows platform