This package contains example programs for the FreeType 2 library.


WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING

  The Makefile and Jamfile contained in this directory assume that the
  FreeType 2  library sources are  located in `../freetype2'.   If you
  downloaded one  of the  stable FreeType 2  source packages  from our
  server, you most probably have to rename its directory, for example:

    mv freetype-2.8.1 freetype2       on Unix
    rename freetype-2.8.1 freetype2   on Windows

WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING


  First compile the FreeType 2 library, then say `make'.  However, you
  must rename  the directory of the FreeType 2  library to `freetype2'
  (or create a symlink) before doing this.

  Note  that  the  demonstration  programs  include  a  tiny  graphics
  sub-system that includes `drivers' to display Windows on Win32, X11,
  BeOS, Mac,  and OS/2.  The build system  should automatically detect
  which driver to use based on the current platform.

  UNIX USERS
  ==========

    X11 issues
    ----------

    When building the demos, the build system tries to detect your X11
    path  by  looking for  the  patterns  `X11/bin', `X11R6/bin',  and
    `X11R5/bin' in your current path  (in this order).  If no X11 path
    is found, some demo programs  will not be able to display graphics
    and  will fail.   If you  have X11  in an  unusual place,  use the
    X11_PATH make  variable.  More  than one directory,  if necessary,
    must be separated with spaces.  Example:

        make X11_PATH="/usr/openwin /usr/local/X11R6"

    The build  system then derives  the X11_INCLUDE include  file path
    from X11_PATH by appending `/include'  to all path components.  It
    also derives the  X11_LIB library path from  X11_PATH by appending
    `/lib64' and `/lib' to all  components (in that order).  You might
    override  those  variables similar  to  X11_PATH  as arguments  to
    `make'.

    If  you don't  have X11  at all,  fix the  definition of  the EXES
    variable as described in the top-level Makefile.

    Recent versions of Mac OS X no longer deliver X11 by default;  you
    have to install XQuartz, see

      https://support.apple.com/en-us/HT201341

    for more details.


    Using a different build directory
    ---------------------------------

    If the `configure' script of the FreeType 2 library is  run from a
    separate build directory,  it creates a dummy  Makefile which sets
    some  variables before  including  the top-level  Makefile of  the
    source  directory.  This dummy  Makefile can also be  used for the
    ft2demos package to be compiled in a different build directory:

       make FT2DEMOS=1 -f /path/to/freetype2/build-dir/Makefile

    If necessary, adapt  the `TOP_DIR_2' variable to make it  point to
    the ft2demos source directory.

--- end of README ---
