source: general/graphlib/freetype2.xml@ 0b06e2f

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY freetype2-download-http "&sourceforge-repo;/freetype/freetype-&freetype2-version;.tar.bz2">
  <!ENTITY freetype2-download-ftp  "&gentoo-ftp-repo;/freetype-&freetype2-version;.tar.bz2">
  <!ENTITY freetype2-md5sum        "d6b60f06bfc046e43ab2a6cbfd171d65">
  <!ENTITY freetype2-size          "1.7 MB">
  <!ENTITY freetype2-buildsize     "28 MB (includes installing additional documentation)">
  <!ENTITY freetype2-time          "0.2 SBU">

  <!ENTITY freetype2-doc-version   "2.5.3">
  <!ENTITY freetype2-doc-download-http "&sourceforge-repo;/freetype/freetype-doc-&freetype2-doc-version;.tar.bz2">
  <!ENTITY freetype2-doc-download-ftp  "&gentoo-ftp-repo;/freetype-doc-&freetype2-doc-version;.tar.bz2">
  <!ENTITY freetype2-doc-md5sum        "e192ef88e84ddf10665f34cf418652fb">
  <!ENTITY freetype2-doc-size          "108 KB">
]>

<sect1 id="freetype2" xreflabel="FreeType-&freetype2-version;">
  <?dbhtml filename="freetype2.html"?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>FreeType-&freetype2-version;</title>

  <indexterm zone="freetype2">
    <primary sortas="a-FreeType">FreeType</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to FreeType2</title>

    <para>
      The <application>FreeType2</application> package contains
      a library which allows applications to properly render
      <application>TrueType</application> fonts.
    </para>

    &lfs75_checked;

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>
          Download (HTTP): <ulink url="&freetype2-download-http;"/>
        </para>
      </listitem>
<!--      <listitem>
        <para>
          Download (FTP): <ulink url="&freetype2-download-ftp;"/>
        </para>
      </listitem> -->
      <listitem>
        <para>
          Download MD5 sum: &freetype2-md5sum;
        </para>
      </listitem>
      <listitem>
        <para>
          Download size: &freetype2-size;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated disk space required: &freetype2-buildsize;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated build time: &freetype2-time;
        </para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
    <itemizedlist spacing="compact">
      <title>Additional Documentation</title>
      <listitem>
        <para>
          Download (HTTP): <ulink url="&freetype2-doc-download-http;"/>
        </para>
      </listitem>
<!--      <listitem>
        <para>
          Download (FTP): <ulink url="&freetype2-doc-download-ftp;"/>
        </para>
      </listitem> -->
      <listitem>
        <para>
          Download MD5 sum: &freetype2-doc-md5sum;
        </para>
      </listitem>
      <listitem>
        <para>
          Download size: &freetype2-doc-size;
        </para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">FreeType2 Dependencies</bridgehead>
 
    <bridgehead renderas="sect4">Recommended</bridgehead>
    <para role="recommended">
      <xref linkend="which"/>,
      <xref linkend="harfbuzz"/>,
      (first, install without it, after it is installed, reinstall
      <xref linkend="freetype2"/>), and
      <xref linkend="libpng"/>
    </para>

    <para condition="html" role="usernotes">User Notes:
      <ulink url="&blfs-wiki;/freetype2"/>
    </para>
  </sect2>

  <sect2 role="installation">
    <title>Installation of FreeType2</title>

    <note>
    <para>When building the first time you must add
      <parameter>--without-harfbuzz</parameter> to 
      the below configure line.</para>
    </note>

    <para>
      If you downloaded the additional documentation, unpack it into the
      source tree using the following command:
    </para>

<screen><userinput>tar -xf ../freetype-doc-&freetype2-doc-version;.tar.bz2 --strip-components=2 -C docs</userinput></screen>

    <para>
      Install <application>FreeType2</application> by running the following
      commands:
    </para>

<screen><userinput>sed -i  -e "/AUX.*.gxvalid/s@^# @@" \
        -e "/AUX.*.otvalid/s@^# @@" \
        modules.cfg                        &amp;&amp;

sed -ri -e 's:.*(#.*SUBPIXEL.*) .*:\1:' \
        include/config/ftoption.h          &amp;&amp;

./configure --prefix=/usr --disable-static &amp;&amp;
make</userinput></screen>

    <para>
      This package does not come with a test suite.
    </para>

    <para>
      Now, as the <systemitem class="username">root</systemitem> user:
    </para>

<screen role="root"><userinput>make install &amp;&amp;
install -v -m755 -d /usr/share/doc/freetype-&freetype2-version; &amp;&amp;
cp -v -R docs/*     /usr/share/doc/freetype-&freetype2-version;</userinput></screen>

  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <para>
      <command>sed -e ...</command>: 
      First command enables GX/AAT and OpenType table validation and second
      command enables Subpixel Rendering and Subpixel Hinting in order to
      improve font rendering. Note that Subpixel Rendering may have patent issues.
      Be sure to read the <literal>'Other patent issues'</literal> part of
      <ulink url="http://www.freetype.org/patents.html"/> before enabling this
      option.
    </para>

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
      href="../../xincludes/static-libraries.xml"/>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Program</segtitle>
      <segtitle>Installed Library</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <seg>
          freetype-config
        </seg>
        <seg>
          libfreetype.so
        </seg>
        <seg>
          /usr/include/freetype2 and
          /usr/share/doc/freetype-&freetype2-version;
        </seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="freetype-config">
        <term><command>freetype-config</command></term>
        <listitem>
          <para>
            is used to get <application>FreeType</application> compilation
            and linking information.
          </para>
          <indexterm zone="freetype2 freetype-config">
            <primary sortas="b-freetype-config">freetype-config</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libfreetype">
        <term><filename class="libraryfile">libfreetype.so</filename></term>
        <listitem>
          <para>
            contains functions for rendering various font types, such
            as TrueType and Type1.
          </para>
          <indexterm zone="freetype2 libfreetype">
            <primary sortas="c-libfreetype">libfreetype.so</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>