<TeXmacs|1.99.18>

<style|<tuple|tmdoc|english|old-spacing|old-dots|old-lengths>>

<\body>
  <tmdoc-title|<TeXmacs> fonts>

  <section|Classical conceptions of fonts>

  The way <TeXmacs> handles fonts is quite different from classical text
  editors and even from <TeX>. Let us first analyze some classical ways of
  conceiving fonts.

  <\itemize>
    <item>Physical fonts are just given by the name of a file, which contains
    a character set, i.e. a list of bitmaps. Usually the size of a character
    set is limited by 256 (or 65536).

    <item>True type fonts essentially work in the same way, except that the
    bitmaps can now be computed for any desired size.

    <item>In the X-window system, the name of the font is replaced by a more
    systematic name, which explicitly contains a certain number of font
    parameters, such as its size, series and shape. This makes it easier for
    applications to select an appropriate font. However, character sets are
    still limited in size.

    <item>In <TeX>, symbols are seen as commands, which select an appropriate
    physical font (which corresponds to a <verbatim|.tfm> and a
    <verbatim|.pk> file), based on symbol font declarations and environment
    variables (such as size, series and shape).
  </itemize>

  Clearly, among all these methods, <TeX> provides the largest flexibility.
  However, philosophically speaking, we think that it also has some
  drawbacks:

  <\itemize>
    <item>There is no distinction between usual commands and commands to make
    symbols: the current time might be considered as a symbol.

    <item>The encoding of the font is fixed by the names of the commands. For
    instance, for mathematical symbols, no clean general encoding scheme is
    provided, except the default naming of symbols by commands.

    <item>For beginners, it remains extremely hard to use non standard fonts.
  </itemize>

  Actually, in <TeX>, the notion of \Pthe current font\Q is ill-defined: it
  is merely the superposition of all character generating commands.

  <section|The conception of a font in TeXmacs>

  Philosophically speaking, we think that a font should be characterized by
  the following two essential properties:

  <\enumerate>
    <item>A font associates graphical meanings to
    <with|font-shape|italic|words>. The words can always be represented by
    strings.

    <item>The way this association takes place is coherent as a function of
    the word.
  </enumerate>

  By a word, we either mean a word in a natural language, or a sequence of
  mathematical, technical or artistic symbols.

  This way of viewing fonts has several advantages:

  <\enumerate>
    <item>A font may take care of kerning and ligatures.

    <item>A font may consist of several \Pphysical fonts\Q, which are somehow
    merged together.

    <item>A font might in principle automatically build very complicated
    glyphs like hieroglyphs or large delimiters from words in a well chosen
    encoding.

    <item>A font is an irreducible and persistent entity, not a bunch of
    commands whose actions may depend on some environment.
  </enumerate>

  Notice finally that the \Pgraphical meaning\Q of a word might be more than
  just a bitmap: it might also contain some information about a logical
  bounding box, appropriate places for scripts, etc. Similarly, the
  \Pcoherence of the association\Q should be interpreted in its broadest
  sense: the font might contain additional information for the global
  typesetting of the words on a page, like the recommended distance between
  lines, the height of a fraction bar, etc.

  <section|String encodings>

  All text strings in <TeXmacs> consist of sequences of either specific or
  universal symbols. A specific symbol is a character, different from
  <verbatim|'\\0'>, <verbatim|'\<less\>'> and <verbatim|'\<gtr\>'>. Its
  meaning may depend on the particular font which is being used. A universal
  symbol is a string starting with <verbatim|'\<less\>'>, followed by an
  arbitrary sequence of characters different from <verbatim|'\\0'>,
  <verbatim|'\<less\>'> and <verbatim|'\<gtr\>'>, and ending with
  <verbatim|'\<gtr\>'>. The meaning of universal characters does not depend
  on the particular font which is used, but different fonts may render them
  in a different way.

  Universal symbols can also be used to represent mathematical symbols of
  variable sizes like large brackets. The point here is that the shapes of
  such symbols depend on certain size parameters, which can not conveniently
  be thought of as font parameters. This problem is solved by letting the
  extra parameters be part of the symbol. For instance,
  <verbatim|"\<less\>left-(-1\<gtr\>"> would be usual bracket and
  <verbatim|"\<less\>left-(-2\<gtr\>"> a slightly larger one.

  <section|The abstract font class>

  The main abstract <verbatim|font> class is defined in <verbatim|font.hpp>:\ 

  <\cpp-code>
    struct font_rep: rep\<less\>font\<gtr\> {<next-line> \ display \ dis;
    \ \ \ \ \ \ \ \ \ \ \ \ \ // underlying display<next-line> \ encoding
    enc; \ \ \ \ \ \ \ \ \ \ \ \ \ // underlying encoding of the
    font<next-line> \ SI \ \ \ \ \ \ design_size; \ \ \ \ \ // design size in
    points/256<next-line> \ SI \ \ \ \ \ \ display_size; \ \ \ \ // display
    size in points/PIXEL<next-line> \ double \ \ slope;
    \ \ \ \ \ \ \ \ \ \ \ // italic slope<next-line> \ space \ \ \ spc;
    \ \ \ \ \ \ \ \ \ \ \ \ \ // usual space between words<next-line> \ space
    \ \ \ extra; \ \ \ \ \ \ \ \ \ \ \ // extra space at end of
    words<next-line><next-line> \ SI \ \ \ \ \ \ y1;
    \ \ \ \ \ \ \ \ \ \ \ \ \ \ // bottom y position<next-line> \ SI
    \ \ \ \ \ \ y2; \ \ \ \ \ \ \ \ \ \ \ \ \ \ // top y position<next-line>
    \ SI \ \ \ \ \ \ yfrac; \ \ \ \ \ \ \ \ \ \ \ // vertical position
    fraction bar<next-line> \ SI \ \ \ \ \ \ ysub; \ \ \ \ \ \ \ \ \ \ \ \ //
    base line for subscripts<next-line> \ SI \ \ \ \ \ \ ysup;
    \ \ \ \ \ \ \ \ \ \ \ \ // base line for
    superscripts<next-line><next-line> \ SI \ \ \ \ \ \ wpt;
    \ \ \ \ \ \ \ \ \ \ \ \ \ // width of one point in font<next-line> \ SI
    \ \ \ \ \ \ wquad; \ \ \ \ \ \ \ \ \ \ \ // wpt * design size in
    points<next-line> \ SI \ \ \ \ \ \ wunit; \ \ \ \ \ \ \ \ \ \ \ // unit
    width for extendable fonts<next-line> \ SI \ \ \ \ \ \ wfrac;
    \ \ \ \ \ \ \ \ \ \ \ // width fraction bar<next-line> \ SI
    \ \ \ \ \ \ wsqrt; \ \ \ \ \ \ \ \ \ \ \ // width horzontal line in
    square root<next-line> \ SI \ \ \ \ \ \ wneg; \ \ \ \ \ \ \ \ \ \ \ \ //
    width of negation line<next-line><next-line> \ font_rep (display dis,
    string name);<next-line> \ font_rep (display dis, string name, font
    fn);<next-line> \ void copy_math_pars (font fn);<next-line><next-line>
    \ virtual void \ \ get_extents (string s, text_extents& ex) =
    0;<next-line> \ virtual void \ \ draw (ps_device dev, string s, SI x, SI
    y) = 0;<next-line><next-line> \ virtual SI \ \ \ \ get_sub_base (string
    s);<next-line> \ virtual SI \ \ \ \ get_sup_base (string s);<next-line>
    \ virtual double get_left_slope \ (string s);<next-line> \ virtual double
    get_right_slope (string s);<next-line> \ virtual SI
    \ \ \ \ get_left_correction \ (string s);<next-line> \ virtual SI
    \ \ \ \ get_right_correction (string s);<next-line> \ virtual SI
    \ \ \ \ get_lsub_correction (string s, double level);<next-line>
    \ virtual SI \ \ \ \ get_lsup_correction (string s, double
    level);<next-line> \ virtual SI \ \ \ \ get_rsub_correction (string s,
    double level);<next-line> \ virtual SI \ \ \ \ get_rsup_correction
    (string s, double level);<next-line><next-line> \ void var_get_extents
    (string s, text_extents& ex);<next-line> \ void var_draw (ps_device dev,
    string s, SI x, SI y);<next-line> \ virtual bitmap_char get_bitmap
    (string s);<next-line>};
  </cpp-code>

  <\verbatim>
    \ \ \ \ 
  </verbatim>

  The main abstract routines are <verbatim|get_extents> and <verbatim|draw>.
  The first routine determines the logical and physical bounding boxes of a
  graphical representation of a word, the second one draws the string on the
  the screen.

  The additional data are used for global typesetting using the font. The
  other virtual routines are used for determining additional properties of
  typeset strings.

  <section|Implementation of concrete fonts>

  Several types of concrete fonts have been implemented in <TeXmacs>:

  <\description>
    <item*|TeX text fonts>See <verbatim|src/Resource/Fonts/tex_font.cc>.

    <item*|TeX rubber fonts>See <verbatim|src/Resource/Fonts/tex_rubber_font.cpp>.

    <item*|X fonts>See <verbatim|src/Resource/Fonts/ps_font.cpp>.

    <item*|Mathematical fonts>See <verbatim|src/Resource/Fonts/math_font.cpp>.

    <item*|Virtual fonts>See <verbatim|src/Resource/Fonts/virtual_font.cpp>.
  </description>

  In most cases, the lowest layer of the implementation consists of a
  collection of bitmaps, together with some font metric information. The font
  is responsible for putting these bitmaps together on the screen using some
  appropriate spacing. The <verbatim|ps_device> class comes with a method to
  display bitmaps in a nice, anti-aliased way, or to print them out.

  <section|Font selection>

  After having implemented fonts themselves, an important remaining issue is
  the selection of the appropriate font as a function of a certain number of
  parameters, such as its name, series, shape and size. For optimal
  flexibility, <TeXmacs> comes with a powerful macro-based font-selection
  scheme (using the <scheme> syntax), which allows the user to decide which
  parameters should be considered meaningful.

  At the lowest level, we provide a fixed number of macros which directly
  correspond to the above types of concrete fonts. For instance, the macro\ 

  <\scm>
    \ \ \ \ (tex $name $size $dpi)
  </scm>

  corresponds to the constructor

  <\cpp-code>
    font tex_font (display dis, string fam, int size, int dpi, int dsize=10);
  </cpp-code>

  of a <TeX> text font.

  At the middle level, it is possible to specify some rewriting rules like\ 

  <\scm-code>
    ((roman rm medium right $s $d) (ec ecrm $s $d))

    ((avant-garde rm medium right $s $d) (tex rpagk $s $d 0))

    ((x-times rm medium right $s $d) (ps adobe-times-medium-r-normal $s $d))
  </scm-code>

  When a left hand pattern is matched, it is recursively substituted by the
  right hand side. The files in the directory <verbatim|progs/fonts> contain
  a large number of rewriting rules.

  At the top level, <TeXmacs> calls a macro of the form\ 

  <\scm-code>
    ($name $family $series $shape $size $dpi)
  </scm-code>

  as a function of the current environment in the text. In the future, the
  top level macro call might change in order to enable the user to let the
  font depend on other environment variables.

  <tmdoc-copyright|1998\U2021|Joris van der Hoeven|Darcy Shen>

  <tmdoc-license|Permission is granted to copy, distribute and/or modify this
  document under the terms of the GNU Free Documentation License, Version 1.1
  or any later version published by the Free Software Foundation; with no
  Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
  Texts. A copy of the license is included in the section entitled "GNU Free
  Documentation License".>

<initial|<\collection>
</collection>>