1056N/A<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
1276N/A<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Fonts in X11R7.7</title><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot_9276" /><style xmlns="" type="text/css">/*
1276N/A font-family: "Bitstream Vera Sans Mono", "DejaVu Sans Mono", Courier, "Liberation Mono", Monospace;
1276N/Adiv.titlepage .authorgroup,
1276N/Adiv.titlepage .author,
1276N/Adiv.titlepage .collab,
1276N/Adiv.titlepage .corpauthor,
1276N/Adiv.titlepage .corpcredit,
1276N/Adiv.titlepage .editor,
1276N/Adiv.titlepage .othercredit {
1276N/Adiv.titlepage .affiliation {
1276N/Adiv.titlepage .pubdate {
1276N/A * DocBook XSL guide does: http://www.sagehill.net/docbookxsl/ProgramListings.html
1276N/A * A table with rows and columns is constructed inside div.variablelist
1276N/A</style></head><body><div class="article"><div class="titlepage"><div><div><h2 class="title"><a id="fonts"></a>Fonts in X11R7.7</h2></div><div><div class="author"><h3 class="author"><span class="firstname">Juliusz</span> <span class="surname">Chroboczek</span></h3><code class="email"><<a class="email" href="mailto:jch@freedesktop.org">jch@freedesktop.org</a>></code></div></div><div><p class="releaseinfo">X Version 11, Release 7.7</p></div><div><p class="pubdate">16 March 2012</p></div></div><hr /></div><div class="toc"><p><strong>Table of Contents</strong></p><dl><dt><span class="sect1"><a href="#Introduction">Introduction</a></span></dt><dd><dl><dt><span class="sect2"><a href="#Two_font_systems">Two font systems</a></span></dt></dl></dd><dt><span class="sect1"><a href="#Installing_fonts">Installing fonts</a></span></dt><dd><dl><dt><span class="sect2"><a href="#Configuring_Xft">Configuring Xft</a></span></dt><dt><span class="sect2"><a href="#Configuring_the_core_X11_fonts_system">Configuring the core X11 fonts system</a></span></dt></dl></dd><dt><span class="sect1"><a href="#Fonts_included_with_X11">Fonts included with X11R7.7</a></span></dt><dd><dl><dt><span class="sect2"><a href="#Standard_bitmap_fonts">Standard bitmap fonts</a></span></dt><dt><span class="sect2"><a href="#The_ClearlyU_Unicode_font_family">The ClearlyU Unicode font family</a></span></dt><dt><span class="sect2"><a href="#Standard_scalable_fonts">Standard scalable fonts</a></span></dt><dt><span class="sect2"><a href="#The_Bigelow_and__Holmes_Luxi_family">The Bigelow & Holmes Luxi family</a></span></dt></dl></dd><dt><span class="sect1"><a href="#More_about_core_fonts">More about core fonts</a></span></dt><dd><dl><dt><span class="sect2"><a href="#Core_fonts_and_internationalisation">Core fonts and internationalisation</a></span></dt><dt><span class="sect2"><a href="#Additional_notes_about_scalable_core_fonts">Additional notes about scalable core fonts</a></span></dt></dl></dd><dt><span class="sect1"><a href="#Appendix_background_and_terminology">Appendix: background and terminology</a></span></dt><dd><dl><dt><span class="sect2"><a href="#Characters_and_glyphs">Characters and glyphs</a></span></dt><dt><span class="sect2"><a href="#Font_files_fonts_and_XLFD">Font files, fonts, and XLFD</a></span></dt><dt><span class="sect2"><a href="#Unicode">Unicode</a></span></dt></dl></dd><dt><span class="sect1"><a href="#References">References</a></span></dt></dl></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="Introduction"></a>Introduction</h2></div></div></div><p>
1276N/A<a class="xref" href="#Installing_fonts" title="Installing fonts">Installing fonts</a> is aimed at the
1276N/Aclear to you, please consult <a class="xref" href="#Appendix_background_and_terminology" title="Appendix: background and terminology">Appendix: background and terminology</a> at the
1276N/A</p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="Two_font_systems"></a>Two font systems</h3></div></div></div><p>
1276N/A</p></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="Installing_fonts"></a>Installing fonts</h2></div></div></div><p>
1276N/A</p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="Configuring_Xft"></a>Configuring Xft</h3></div></div></div><p>
1276N/A</p><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="Installing_fonts_in_Xft"></a>Installing fonts in Xft</h4></div></div></div><p>
1276N/A(<span class="quote">“<span class="quote"><code class="filename">/usr/share/fonts/X11/*</code></span>”</span>) by default) as well as a
1276N/Adirectory called <span class="quote">“<span class="quote"><code class="filename">.fonts/</code></span>”</span> in the user's home directory.
1276N/Aline, you may run the command <span class="quote">“<span class="quote"><span class="command"><strong>fc-cache</strong></span></span>”</span>.
1276N/A</p></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="Fine-tuning_Xft"></a>Fine-tuning Xft</h4></div></div></div><p>
1276N/Afiles: a standard configuration file, <span class="quote">“<span class="quote"><code class="filename">/etc/fonts/fonts.conf</code></span>”</span>,
1276N/Aa host-specific configuration file, <span class="quote">“<span class="quote"><code class="filename">/etc/fonts/local.conf</code></span>”</span>,
1276N/Aand a user-specific file called <span class="quote">“<span class="quote"><code class="filename">.fonts.conf</code></span>”</span> in the user's
1276N/A<span class="quote">“<span class="quote"><code class="envar">FONTCONFIG_FILE</code></span>”</span> environment variable).
1276N/A<span class="quote">“<span class="quote"><code class="filename">˜/.fonts/</code></span>”</span> in the list of directories searched for font
1276N/AThe string <span class="quote">“<span class="quote"><code class="literal">rgb</code></span>”</span> within the
1276N/A<span class="quote">“<span class="quote"><code class="literal"><const></code></span>”</span>...<span class="quote">“<span class="quote"><code class="literal"></const></code></span>”</span>
1276N/Achanged to match your hardware; it can be one of <span class="quote">“<span class="quote"><code class="literal">rgb</code></span>”</span> (normal
1276N/ALCD screen), <span class="quote">“<span class="quote"><code class="literal">bgr</code></span>”</span> (backwards LCD screen), <span class="quote">“<span class="quote"><code class="literal">vrgb</code></span>”</span> (LCD
1276N/Ascreen rotated clockwise) or <span class="quote">“<span class="quote"><code class="literal">vbgr</code></span>”</span> (LCD screen rotated
1276N/A</p></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="Configuring_applications"></a>Configuring applications</h4></div></div></div><p>
1276N/A<span class="quote">“<span class="quote"><code class="literal">-fa</code></span>”</span> command line option or by setting the <span class="quote">“<span class="quote"><code class="literal">XTerm*faceName</code></span>”</span>
1276N/AFor KDE applications, you should select <span class="quote">“<span class="quote">Anti-alias fonts</span>”</span> in the
1276N/A<span class="quote">“<span class="quote">Fonts</span>”</span> panel of KDE's <span class="quote">“<span class="quote">Control Center</span>”</span>. Note that this option is
1276N/A</p></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="Configuring_the_core_X11_fonts_system"></a>Configuring the core X11 fonts system</h3></div></div></div><p>
1056N/Ayou need to create a <span class="emphasis"><em>font directory</em></span> that contains all the
1276N/A</p><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="Installing_bitmap_fonts"></a>Installing bitmap fonts</h4></div></div></div><p>
1276N/Acommand <span class="quote">“<span class="quote"><span class="command"><strong>bdftopcf</strong></span></span>”</span>, <span class="emphasis"><em>e.g.</em></span>
1056N/A$ bdftopcf courier12.bdf
1056N/A$ gzip courier12.pcf
1276N/A<span class="quote">“<span class="quote"><code class="filename">/usr/local/share/fonts/bitmap/</code></span>”</span>. You should then create the
1276N/Aindex file <span class="quote">“<span class="quote"><code class="filename">fonts.dir</code></span>”</span> by running the command <span class="quote">“<span class="quote"><span class="command"><strong>mkfontdir</strong></span></span>”</span>
1276N/Anew font directory; see <a class="xref" href="#Setting_the_servers_font_path" title="Setting the server's font path">Setting the server's font path</a> below.
1276N/A</p></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="Installing_scalable_fonts"></a>Installing scalable fonts</h4></div></div></div><p>
1276N/Ayou create a directory with the font files, and run <span class="quote">“<span class="quote"><span class="command"><strong>mkfontdir</strong></span></span>”</span>
1276N/Ato create an index file called <span class="quote">“<span class="quote"><code class="filename">fonts.dir</code></span>”</span>.
1276N/AThere is, however, a big difference: <span class="quote">“<span class="quote"><span class="command"><strong>mkfontdir</strong></span></span>”</span> cannot
1276N/A<span class="quote">“<span class="quote"><code class="filename">fonts.scale</code></span>”</span>. While this can be done by hand, it is best done
1276N/Aby using the <span class="quote">“<span class="quote"><span class="command"><strong>mkfontscale</strong></span></span>”</span> utility.
1276N/A<span class="quote">“<span class="quote"><code class="filename">fonts.scale</code></span>”</span> file generated by <span class="command"><strong>mkfontscale</strong></span>; for more
1276N/Ainformation, please see the <a class="ulink" href="mkfontdir.1.html" target="_top">mkfontdir(1)</a> and <a class="ulink" href="mkfontscale.1.html" target="_top">mkfontscale(1)</a> manual pages and <a class="xref" href="#Core_fonts_and_internationalisation" title="Core fonts and internationalisation">Core fonts and internationalisation</a>
1276N/A</p></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="CID_keyed_fonts"></a>CID-keyed fonts</h4></div></div></div><p>
1276N/A</p></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="Setting_the_servers_font_path"></a>Setting the server's font path</h4></div></div></div><p>
1056N/Aas the <span class="emphasis"><em>font path</em></span>. Informing the server of the existence of a new
1276N/Abitmap fonts when a scalable font can be used. (The <span class="quote">“<span class="quote"><code class="literal">:unscaled</code></span>”</span>
1276N/A</p><div class="sect4"><div class="titlepage"><div><div><h5 class="title"><a id="Font_path_catalogue_directories"></a>Font path catalogue directories</h5></div></div></div><p>
1276N/A</p></div><div class="sect4"><div class="titlepage"><div><div><h5 class="title"><a id="Temporary_modification_of_the_font_path"></a>Temporary modification of the font path</h5></div></div></div><p>
1276N/AThe <span class="quote">“<span class="quote"><span class="command"><strong>xset</strong></span></span>”</span> utility may be used to modify the font path for the
1276N/Acurrent session. The font path is set with the command <span class="command"><strong>xset fp</strong></span>;
1276N/Aa new element is added to the front with <span class="command"><strong>xset +fp</strong></span>, and added to
1276N/Awith <span class="quote">“<span class="quote"><span class="command"><strong>xset -fp</strong></span></span>”</span>, and removed from the end with <span class="quote">“<span class="quote"><span class="command"><strong>xset fp-</strong></span></span>”</span>.
1276N/A<span class="quote">“<span class="quote"><span class="command"><strong>xset fp default</strong></span></span>”</span>.
1276N/AFor more information, please consult the <a class="ulink" href="xset.1.html" target="_top">xset(1)</a> manual page.
1276N/A</p></div><div class="sect4"><div class="titlepage"><div><div><h5 class="title"><a id="Permanent_modification_of_the_font_path"></a>Permanent modification of the font path</h5></div></div></div><p>
1276N/Aafter <span class="quote">“<span class="quote"><span class="command"><strong>xset fp default</strong></span></span>”</span>) may be specified in the
1276N/A<span class="quote">“<span class="quote"><code class="filename">xorg.conf</code></span>”</span> file. It is computed by appending all the
1276N/Adirectories mentioned in the <span class="quote">“<span class="quote"><code class="literal">FontPath</code></span>”</span> entries of the
1276N/A<span class="quote">“<span class="quote"><code class="literal">Files</code></span>”</span> section in the order in which they appear. If no font path is specified in a config file, the server uses a default
1276N/AFor more information, please consult the <a class="ulink" href="xorg.conf.5.html" target="_top">xorg.conf(5)</a> manual page.
1276N/A</p></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="Troubleshooting"></a>Troubleshooting</h4></div></div></div><p>
1276N/Ainstalled, the first thing to check is that the <span class="quote">“<span class="quote"><code class="filename">fonts.dir</code></span>”</span> files
1276N/A bitmap fonts (<span class="quote">“<span class="quote"><code class="filename">*.bdf</code></span>”</span>,
1276N/A and <span class="quote">“<span class="quote"><code class="filename">*.snf</code></span>”</span>);
1276N/A TrueType fonts (<span class="quote">“<span class="quote"><code class="filename">*.ttf</code></span>”</span> and
1276N/A <span class="quote">“<span class="quote"><code class="filename">*.ttc</code></span>”</span>),
1276N/A OpenType fonts (<span class="quote">“<span class="quote"><code class="filename">*.otf</code></span>”</span> and
1276N/A <span class="quote">“<span class="quote"><code class="filename">*.otc</code></span>”</span>) and
1276N/A Type 1 fonts (<span class="quote">“<span class="quote"><code class="filename">*.pfa</code></span>”</span>
1276N/A and <span class="quote">“<span class="quote"><code class="filename">*.pfb</code></span>”</span>).
1276N/A</p></div></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="Fonts_included_with_X11"></a>Fonts included with X11R7.7</h2></div></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="Standard_bitmap_fonts"></a>Standard bitmap fonts</h3></div></div></div><p>
1276N/Abitmap fonts, including the <span class="quote">“<span class="quote"><code class="literal">fixed</code></span>”</span> family, and bitmap versions
1276N/Ais a Unicode-encoded version of the standard <span class="quote">“<span class="quote"><code class="literal">fixed</code></span>”</span> font with
1276N/AThe standard short name <span class="quote">“<span class="quote"><code class="literal">fixed</code></span>”</span> is normally an alias for
1276N/A</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="The_ClearlyU_Unicode_font_family"></a>The ClearlyU Unicode font family</h3></div></div></div><p>
1056N/AThe <span class="emphasis"><em>Alternate Glyphs</em></span> font contains additional glyph shapes that
1056N/AThe <span class="emphasis"><em>PUA</em></span> font contains extra glyphs that are useful for certain
1056N/AThe <span class="emphasis"><em>Arabic Extra</em></span> font contains the glyphs necessary for
1056N/AThe <span class="emphasis"><em>Ligature</em></span> font contains ligatures for various scripts that
1276N/A</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="Standard_scalable_fonts"></a>Standard scalable fonts</h3></div></div></div><p>
1276N/A</p><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="Standard_Type1_fonts"></a>Standard Type 1 fonts</h4></div></div></div><p>
1276N/A</p></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="The_Bigelow_and__Holmes_Luxi_family"></a>The Bigelow & Holmes Luxi family</h3></div></div></div><p>
1276N/AX11R7.7 includes the <span class="emphasis"><em>Luxi</em></span> family of scalable fonts, in both
1056N/Arange, the Latin 1 range, as well as the <span class="emphasis"><em>Extended Latin</em></span>
1276N/A<span class="quote">“<span class="quote"><code class="filename">COPYRIGHT.BH</code></span>”</span>, as well as in the <a href="/License.html#Bigelow_Holmes_Inc_and_URW_GmbH_Luxi_font_license" class="olink">License
1276N/A<code class="email"><<a class="email" href="mailto:design@bigelowandholmes.com">design@bigelowandholmes.com</a>></code> or
1276N/A<code class="email"><<a class="email" href="mailto:info@urwpp.de">info@urwpp.de</a>></code>, or consult
1056N/Aname <span class="emphasis"><em>Lucidux</em></span>. This name should no longer be used due to
1056N/Atrademark uncertainties, and all traces of the <span class="emphasis"><em>Lucidux</em></span>
1276N/A</p></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="More_about_core_fonts"></a>More about core fonts</h2></div></div></div><p>
1276N/A</p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="Core_fonts_and_internationalisation"></a>Core fonts and internationalisation</h3></div></div></div><p>
1276N/AXLFD in <span class="quote">“<span class="quote"><code class="filename">fonts.dir</code></span>”</span>. For example, a <span class="quote">“<span class="quote"><code class="filename">fonts.dir</code></span>”</span> file can
1276N/A</p><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="The_fontenc_layer"></a>The <span class="emphasis"><em>fontenc</em></span> layer</h4></div></div></div><p>
1056N/A<span class="emphasis"><em>FreeType</em></span> TrueType backend) use a common <span class="emphasis"><em>fontenc</em></span> layer for
1056N/A<span class="emphasis"><em>Please note:</em></span> the X-TrueType (X-TT) backend is not included
1056N/AIn the <span class="emphasis"><em>fontenc</em></span> layer, an encoding is defined by a name (such as
1056N/Aencoding can be mapped into one of the <span class="emphasis"><em>target encodings</em></span> known to
1056N/A<span class="emphasis"><em>fontenc</em></span>; currently, these consist of Unicode, Adobe glyph names,
1056N/AA number of encodings are hardwired into <span class="emphasis"><em>fontenc</em></span>, and are
1276N/A <code class="literal">koi8-uni</code>: KOI8 <span class="quote">“<span class="quote">Unified</span>”</span> (Russian, Ukrainian, and
1276N/A <code class="literal">koi8-e</code>: KOI8 <span class="quote">“<span class="quote">European,</span>”</span> ISO-IR-111, or ECMA-Cyrillic;
1056N/A <code class="literal">microsoft-symbol</code> and <code class="literal">apple-roman</code>: these are only
1056N/AAdditional encodings can be added by defining <span class="emphasis"><em>encoding files</em></span>.
1056N/AWhen a font encoding is requested that the <span class="emphasis"><em>fontenc</em></span> layer doesn't
1276N/Afile named <span class="quote">“<span class="quote"><code class="filename">encodings.dir</code></span>”</span>. If found, this file is scanned for
1276N/Aread in. The <span class="quote">“<span class="quote"><span class="command"><strong>mkfontdir</strong></span></span>”</span> utility, when invoked with the
1276N/A<span class="quote">“<span class="quote"><code class="literal">-e</code></span>”</span> option followed by the name of a directory containing
1276N/Aencoding files, can be used to automatically build <span class="quote">“<span class="quote"><code class="filename">encodings.dir</code></span>”</span>
1276N/Afiles. Please see the <a class="ulink" href="mkfontdir.1.html" target="_top">mkfontdir(1)</a>
1276N/A<a class="xref" href="#Format_of_encoding_directory_files" title="Format of encoding directory files">Format of encoding directory files</a>
1276N/Aand <a class="xref" href="#Format_of_encoding_files" title="Format of encoding files">Format of encoding files</a> later in this document.
1276N/A</p></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="Backend-specific_notes_about_fontenc"></a>Backend-specific notes about fontenc</h4></div></div></div><div class="sect4"><div class="titlepage"><div><div><h5 class="title"><a id="The_FreeType_backend"></a>The <span class="emphasis"><em>FreeType</em></span> backend</h5></div></div></div><p>
1276N/A<a class="xref" href="#Hints_about_using_badly_encoded_fonts" title="Hints about using badly encoded fonts">Hints about using badly encoded fonts</a> below).
1276N/A</p></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="Format_of_encoding_directory_files"></a>Format of encoding directory files</h4></div></div></div><p>
1276N/Anot know about, you need to have an <span class="quote">“<span class="quote"><code class="filename">encodings.dir</code></span>”</span> file either
1276N/Alocation (<span class="quote">“<span class="quote"><code class="filename">/usr/share/fonts/X11/encodings/</code></span>”</span> by default).
1276N/AThe <span class="quote">“<span class="quote"><code class="filename">encodings.dir</code></span>”</span> file has a similar format to
1276N/A<span class="quote">“<span class="quote"><code class="filename">fonts.dir</code></span>”</span>. Its first line specifies the number of encodings,
1056N/AThe name of an encoding <span class="emphasis"><em>must</em></span> be specified in the encoding file's
1276N/A<span class="quote">“<span class="quote"><code class="literal">STARTENCODING</code></span>”</span> or <span class="quote">“<span class="quote"><code class="literal">ALIAS</code></span>”</span> line. It is not enough to create
1276N/Aan <span class="quote">“<span class="quote"><code class="filename">encodings.dir</code></span>”</span> entry.
1276N/AThe <span class="quote">“<span class="quote"><code class="filename">encoding.dir</code></span>”</span> files are best maintained by the
1276N/A<span class="quote">“<span class="quote"><span class="command"><strong>mkfontdir</strong></span></span>”</span> utility. Please see the <a class="ulink" href="mkfontdir.1.html" target="_top">mkfontdir(1)</a> manual page for more information.
1276N/A</p></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="Format_of_encoding_files"></a>Format of encoding files</h4></div></div></div><p>
1276N/AThe encoding files are <span class="quote">“<span class="quote">free form,</span>”</span> <span class="emphasis"><em>i.e.</em></span> any string of
1276N/Anon-case-sensitive manner, meaning that <span class="quote">“<span class="quote"><code class="literal">size</code></span>”</span>, <span class="quote">“<span class="quote"><code class="literal">SIZE</code></span>”</span>, and
1276N/A<span class="quote">“<span class="quote"><code class="literal">SiZE</code></span>”</span> all parse as the same keyword; on the other hand, case is
1276N/ANumbers can be written in decimal, as in <span class="quote">“<span class="quote"><code class="literal">256</code></span>”</span>, in hexadecimal,
1276N/Aas in <span class="quote">“<span class="quote"><code class="literal">0x100</code></span>”</span>, or in octal, as in <span class="quote">“<span class="quote"><code class="literal">0400</code></span>”</span>.
1276N/AComments are introduced by a hash sign <span class="quote">“<span class="quote"><code class="literal">#</code></span>”</span>. A <span class="quote">“<span class="quote"><code class="literal">#</code></span>”</span> may
1276N/A<span class="quote">“<span class="quote"><code class="literal">#</code></span>”</span> are ignored, up to the end of the line.
1276N/Aan XLFD font name, and therefore contain exactly one dash <span class="quote">“<span class="quote"><code class="literal">-</code></span>”</span>.
1276N/Anumber plus one. In the case of <span class="quote">“<span class="quote"><code class="literal">jisx0208.1990-0</code></span>”</span>
1276N/AIn the case of a matrix encoding, a <span class="quote">“<span class="quote"><code class="literal">FIRSTINDEX</code></span>”</span> line may be
1276N/Akeyword <span class="quote">“<span class="quote"><code class="literal">FIRSTINDEX</code></span>”</span> is followed by two integers, the minimum row
1276N/AIn the case of a linear encoding, a <span class="quote">“<span class="quote"><code class="literal">FIRSTINDEX</code></span>”</span> line is not very
1276N/ANote that in most font backends inclusion of a <span class="quote">“<span class="quote"><code class="literal">FIRSTINDEX</code></span>”</span> line
1276N/ACodes outside the region defined by the <span class="quote">“<span class="quote"><code class="literal">SIZE</code></span>”</span> and
1276N/A<span class="quote">“<span class="quote"><code class="literal">FIRSTINDEX</code></span>”</span> lines are understood to be undefined. Encodings
1276N/Astarts with a <span class="quote">“<span class="quote"><code class="literal">STARTMAPPING</code></span>”</span> line stating the target of the mapping.
1056N/A<span class="emphasis"><em>start</em></span>+1 <span class="emphasis"><em>target</em></span>+1
1056N/A<span class="emphasis"><em>end</em></span> <span class="emphasis"><em>target</em></span>+<span class="emphasis"><em>end</em></span>-<span class="emphasis"><em>start</em></span>
1056N/ACodes not listed are assumed to map through the identity (<span class="emphasis"><em>i.e.</em></span> to
1276N/A<span class="quote">“<span class="quote"><code class="literal">UNDEFINE</code></span>”</span> line:
1276N/A</p></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="Using_symbol_fonts"></a>Using symbol fonts</h4></div></div></div><p>
1056N/Aone of the <code class="literal">microsoft-symbol</code> and <code class="literal">apple-roman</code> encodings. A
1056N/Ashould be installed using <code class="literal">microsoft-cp1252</code>, or, for older fonts,
1276N/A<span class="quote">“<span class="quote"><code class="filename">encodings/adobe-dingbats.enc</code></span>”</span>.
1276N/A</p></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="Hints_about_using_badly_encoded_fonts"></a>Hints about using badly encoded fonts</h4></div></div></div><p>
1056N/Aencoding they were designed for, and creating an <span class="emphasis"><em>ad hoc</em></span> encoding
1276N/A</p><div class="sect4"><div class="titlepage"><div><div><h5 class="title"><a id="Using_fonts_with_the_designers_encoding"></a>Using fonts with the designer's encoding</h5></div></div></div><p>
1276N/A<span class="quote">“<span class="quote"><code class="literal">adobe-fontspecific</code></span>”</span> encoding in the XLFD name. Sometimes, the
1276N/Awhich case you should experiment with <span class="quote">“<span class="quote"><code class="literal">adobe-standard</code></span>”</span>,
1276N/A<span class="quote">“<span class="quote"><code class="literal">iso8859-1</code></span>”</span>, <span class="quote">“<span class="quote"><code class="literal">microsoft-cp1252</code></span>”</span>, and
1276N/A<span class="quote">“<span class="quote"><code class="literal">microsoft-win3.1</code></span>”</span>. (The encoding <span class="quote">“<span class="quote"><code class="literal">microsoft-symbol</code></span>”</span> doesn't
1276N/Aso one of <span class="quote">“<span class="quote"><code class="literal">microsoft-symbol</code></span>”</span>, <span class="quote">“<span class="quote"><code class="literal">microsoft-cp1252</code></span>”</span>,
1276N/A<span class="quote">“<span class="quote"><code class="literal">microsoft-win3.1</code></span>”</span>, or <span class="quote">“<span class="quote"><code class="literal">apple-roman</code></span>”</span> should yield reasonable
1276N/A</p></div><div class="sect4"><div class="titlepage"><div><div><h5 class="title"><a id="Specifying_an_ad_hoc_encoding_file"></a>Specifying an <span class="emphasis"><em>ad hoc</em></span> encoding file</h5></div></div></div><p>
1276N/A<span class="quote">“<span class="quote"><code class="filename">encodings/adobe-dingbats.enc</code></span>”</span> file to see how this is done.
1276N/A</p></div><div class="sect4"><div class="titlepage"><div><div><h5 class="title"><a id="Specifying_font_aliases"></a>Specifying font aliases</h5></div></div></div><p>
1276N/A<span class="quote">“<span class="quote"><code class="literal">adobe-fontspecific</code></span>”</span>, <span class="quote">“<span class="quote"><code class="literal">microsoft-win3.1</code></span>”</span> <span class="emphasis"><em>etc</em></span>. In order
1276N/AThis is done by writing a <span class="quote">“<span class="quote"><code class="filename">fonts.alias</code></span>”</span> file. The format of this file
1276N/Aname to a font name. A <span class="quote">“<span class="quote"><code class="filename">fonts.alias</code></span>”</span> file might look as follows:
1276N/A<span class="quote">“<span class="quote"><code class="filename">fonts.alias</code></span>”</span> file is more precisely described in the
1276N/A</p></div></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="Additional_notes_about_scalable_core_fonts"></a>Additional notes about scalable core fonts</h3></div></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="About_the_FreeType_backend"></a>About the <span class="emphasis"><em>FreeType</em></span> backend</h4></div></div></div><p>
1056N/AThe <span class="emphasis"><em>FreeType</em></span> backend (formerly <span class="emphasis"><em>xfsft</em></span>)
1276N/Ais a backend based on version 2 of the FreeType library (see <a class="ulink" href="http://www.freetype.org/" target="_top">the FreeType web site</a>) and has
1276N/AProject (see <a class="ulink" href="http://x-tt.sourceforge.jp/" target="_top">the After X-TT Project web site</a>). The <span class="emphasis"><em>FreeType</em></span> backend has support for the
1276N/A<span class="quote">“<span class="quote">fontenc</span>”</span> style of internationalisation (see
1276N/A<a class="xref" href="#The_fontenc_layer" title="The fontenc layer">The <span class="emphasis"><em>fontenc</em></span> layer</a>). This backend supports TrueType font files
1276N/A(<span class="quote">“<span class="quote"><code class="filename">*.ttf</code></span>”</span>), OpenType font files (<span class="quote">“<span class="quote"><code class="filename">*.otf</code></span>”</span>), TrueType Collections
1276N/A(<span class="quote">“<span class="quote"><code class="filename">*.ttc</code></span>”</span>), OpenType Collections (<span class="quote">“<span class="quote"><code class="filename">*.otc</code></span>”</span>) and Type 1 font
1276N/Afiles (<span class="quote">“<span class="quote"><code class="filename">*.pfa</code></span>”</span> and <span class="quote">“<span class="quote"><code class="filename">*.pfb</code></span>”</span>).
1056N/A:1:mincho.ttc -misc-pmincho-medium-r-normal--0-0-0-0-p-0-jisx0208.1990-0
1276N/Arefers to face 1 in the <span class="quote">“<span class="quote"><code class="filename">mincho.ttc</code></span>”</span> TrueType Collection file.
1276N/A<span class="quote">“<span class="quote"><code class="filename">fonts.dir</code></span>”</span> syntax introduced by X-TrueType with a number
1276N/Aof options, collectively known as <span class="quote">“<span class="quote">TTCap</span>”</span>. A <span class="quote">“<span class="quote">TTCap</span>”</span> entry follows the
1056N/Aand should be specified before the filename. The new <span class="emphasis"><em>FreeType</em></span>
1276N/A1.4. The Automatic Italic (<span class="quote">“<span class="quote"><code class="literal">ai</code></span>”</span>), Double Strike (<span class="quote">“<span class="quote"><code class="literal">ds</code></span>”</span>) and
1276N/ABounding box Width (<span class="quote">“<span class="quote"><code class="literal">bw</code></span>”</span>) options are indispensable in CJKV.
1056N/Amincho.ttc -misc-mincho-medium-r-normal--0-0-0-0-c-0-jisx0208.1990-0
1056N/Ads=y:mincho.ttc -misc-mincho-bold-r-normal--0-0-0-0-c-0-jisx0208.1990-0
1056N/Aai=0.2:mincho.ttc -misc-mincho-medium-i-normal--0-0-0-0-c-0-jisx0208.1990-0
1056N/Ads=y:ai=0.2:mincho.ttc -misc-mincho-bold-i-normal--0-0-0-0-c-0-jisx0208.1990-0
1056N/Abw=0.5:mincho.ttc -misc-mincho-medium-r-normal--0-0-0-0-c-0-jisx0201.1976-0
1056N/Abw=0.5:ds=y:mincho.ttc -misc-mincho-bold-r-normal--0-0-0-0-c-0-jisx0201.1976-0
1056N/Abw=0.5:ai=0.2:mincho.ttc -misc-mincho-medium-i-normal--0-0-0-0-c-0-jisx0201.1976-0
1056N/Abw=0.5:ds=y:ai=0.2:mincho.ttc -misc-mincho-bold-i-normal--0-0-0-0-c-0-jisx0201.1976-0
1056N/Asetup the complete combination of jisx0208 and jisx0201 using mincho.ttc
1276N/Aonly. More information on the TTCap syntax is found on <a class="ulink" href="http://x-tt.sourceforge.jp/" target="_top">the After X-TT Project page</a>.
1056N/AThe <span class="emphasis"><em>FreeType</em></span> backend uses the <span class="emphasis"><em>fontenc</em></span> layer in order to support
1276N/Arecoding of fonts; this was described in <a class="xref" href="#The_fontenc_layer" title="The fontenc layer">The <span class="emphasis"><em>fontenc</em></span> layer</a>
1276N/Aand especially <a class="xref" href="#The_FreeType_backend" title="The FreeType backend">The <span class="emphasis"><em>FreeType</em></span> backend</a> earlier in this document.
1276N/A</p></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="Delayed_glyph_rasterisation"></a>Delayed glyph rasterisation</h4></div></div></div><p>
1056N/Athe old <span class="emphasis"><em>FreeType</em></span> delayed glyph rasterisation until the time at which
1276N/Aimproved <span class="quote">“<span class="quote">very lazy</span>”</span> metric calculation method to speed up the process when
1056N/Aloading TrueType or OpenType fonts. Although the <span class="emphasis"><em>X-TT</em></span> module also
1056N/Ahas this method, the "<code class="literal">vl=y</code>" TTCap option must be set if you want to
1056N/Ause it. This is the default method for <span class="emphasis"><em>FreeType</em></span> when it loads
1276N/Athe new <span class="emphasis"><em>FreeType</em></span> backend -- its <span class="quote">“<span class="quote">very lazy</span>”</span> method is super-fast.
1276N/AThe maximum error of bitmap position using <span class="quote">“<span class="quote">very lazy</span>”</span> method is 1 pixel,
1276N/Abackend is used with the <span class="quote">“<span class="quote"><code class="literal">vl=y</code></span>”</span> option, a chipped bitmap is displayed
1276N/A<span class="quote">“<span class="quote">italicAngle</span>”</span> in the TrueType/OpenType post table, and does automatic
1276N/Aare not displayed. Nevertheless if you don't want to use the <span class="quote">“<span class="quote">very lazy</span>”</span>
1276N/Amethod when using multi-bytes fonts, set <span class="quote">“<span class="quote"><code class="literal">vl=n</code></span>”</span> in the TTCap option to
1056N/Avl=n:luxirr.ttf -b&h-Luxi Serif-medium-r-normal--0-0-0-0-p-0-iso10646-1
1276N/Awith an XLFD specifying a character-cell spacing <span class="quote">“<span class="quote"><code class="literal">c</code></span>”</span>, as in
1056N/Afs=c:mincho.ttc -misc-mincho-medium-r-normal--0-0-0-0-p-0-jisx0208.1990-0
1276N/A</p></div></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="Appendix_background_and_terminology"></a>Appendix: background and terminology</h2></div></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="Characters_and_glyphs"></a>Characters and glyphs</h3></div></div></div><p>
1056N/A<span class="emphasis"><em>glyphs</em></span>, small pictures that are assembled on paper or on a
1056N/Asequence of two keystrokes <<code class="literal">f</code>><<code class="literal">i</code>> will typically
1056N/A<span class="emphasis"><em>characters</em></span> and from characters to glyphs. You may want to think
1056N/Aof characters as the basic unit of text that is stored <span class="emphasis"><em>e.g.</em></span> in
1056N/AA <span class="emphasis"><em>coded character set</em></span> is a set of characters together with a
1056N/Amapping from integer codes --- known as <span class="emphasis"><em>codepoints</em></span> --- to
1276N/A</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="Font_files_fonts_and_XLFD"></a>Font files, fonts, and XLFD</h3></div></div></div><p>
1056N/A<span class="emphasis"><em>founts</em></span>. A typeface is a particular style or design, such as
1056N/ADigital fonts come in <span class="emphasis"><em>font files</em></span>. A font file contains the
1056N/Ato be <span class="emphasis"><em>bitmap fonts</em></span>. They may also consist of a mathematical
1056N/A<span class="emphasis"><em>scalable fonts</em></span>. Common formats for scalable font files are
1056N/A<span class="emphasis"><em>Type 1</em></span> (sometimes incorrectly called <span class="emphasis"><em>ATM fonts</em></span> or
1056N/A<span class="emphasis"><em>PostScript fonts</em></span>), <span class="emphasis"><em>TrueType</em></span> and <span class="emphasis"><em>OpenType</em></span>.
1056N/AType 1 fonts, glyphs are identified by <span class="emphasis"><em>glyph names</em></span>. In the
1056N/A<span class="emphasis"><em>font instances</em></span>, which are collections of glyphs at a given size
1056N/Aas the <span class="emphasis"><em>X Logical Font Description</em></span> (XLFD). An XLFD starts with a
1276N/Adash <span class="quote">“<span class="quote"><code class="literal">-</code></span>”</span>, and consists of fourteen fields separated by dashes,
1276N/AOr particular interest are the last two fields <span class="quote">“<span class="quote"><code class="literal">iso8859-1</code></span>”</span>, which
1276N/Aopened. These are <span class="quote">“<span class="quote"><code class="literal">fixed</code></span>”</span>, which specifies the fallback font to
1276N/Ause when the requested font cannot be opened, and <span class="quote">“<span class="quote"><code class="literal">cursor</code></span>”</span>, which
1276N/Astandard <span class="quote">“<span class="quote"><code class="literal">fixed</code></span>”</span> and <span class="quote">“<span class="quote"><code class="literal">cursor</code></span>”</span> aliases are defined in
1276N/A</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="Unicode"></a>Unicode</h3></div></div></div><p>
1276N/AUnicode (<a class="ulink" href="http://www.unicode.org" target="_top">http://www.unicode.org</a>) is a coded character
1056N/AUnicode is an <span class="emphasis"><em>open</em></span> character set, meaning that codepoint
1056N/AUnicode font will be <span class="emphasis"><em>sparse</em></span>, meaning that it only defines glyphs
1276N/Ahave the last two fields of their XLFD set to <span class="quote">“<span class="quote"><code class="literal">iso10646-1</code></span>”</span>.
1276N/A</p></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="References"></a>References</h2></div></div></div><p>
1276N/A<a class="ulink" href="Xserver.1.html" target="_top">Xserver(1)</a>, <a class="ulink" href="xset.1.html" target="_top">xset(1)</a>, <a class="ulink" href="Xft.3.html" target="_top">Xft(3)</a>, <a class="ulink" href="xlsfonts.1.html" target="_top">xlsfonts(1)</a> and <a class="ulink" href="showfont.1.html" target="_top">showfont(1)</a>. In addition, you may want to read the <a href="/xlfd/xlfd.html#xlfd" class="olink">X Logical Font Description document</a> by Jim Flowers.
1276N/AThe <a class="ulink" href="http://www.faqs.org/faqs/by-newsgroup/comp/comp.fonts.html" target="_top">comp.fonts FAQ</a>,
1276N/A<a class="ulink" href="http://www.dcs.ed.ac.uk/home/jec/programs/xfsft/" target="_top">xfsft home page</a>
1276N/A<a class="ulink" href="http://www.joerg-pommnitz.de/TrueType/xfsft.html" target="_top">Joerg Pommnitz' xfsft page</a>
1276N/Ais the canonical source for the <span class="quote">“<span class="quote"><span class="command"><strong>ttmkfdir</strong></span></span>”</span> utility, which is the
1276N/A<a class="ulink" href="http://www.pps.jussieu.fr/~jch/software/" target="_top">The author's software pages</a>
1276N/AThe documentation of <span class="emphasis"><em>X-TrueType</em></span> is available from <a class="ulink" href="http://x-tt.sourceforge.jp/" target="_top">the After X-TT Project page</a>.
1276N/AWhile the <a class="ulink" href="http://www.unicode.org" target="_top">Unicode consortium site</a>
1276N/AMarkus Kuhn's <a class="ulink" href="http://www.cl.cam.ac.uk/~mgk25/unicode.html" target="_top">UTF-8 and Unicode FAQ</a>.
1276N/Aissues; see for example <a class="ulink" href="https://datatracker.ietf.org/doc/rfc373/" target="_top">RFC 373</a>.