Skip to content
Snippets Groups Projects
README 2.92 KiB
Newer Older
Werner Lemberg's avatar
 
Werner Lemberg committed
This package contains example programs for the FreeType 2 library.


David Turner's avatar
David Turner committed
WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING

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

    mv freetype-2.10.4 freetype       on Unix
    rename freetype-2.10.4 freetype   on Windows
David Turner's avatar
David Turner committed

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 `freetype`
Werner Lemberg's avatar
 
Werner Lemberg committed
  (or create a symlink) before doing this.
Werner Lemberg's avatar
Werner Lemberg committed

  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
Werner Lemberg's avatar
 
Werner Lemberg committed
  which driver to use based on the current platform.
Werner Lemberg's avatar
Werner Lemberg committed

Werner Lemberg's avatar
 
Werner Lemberg committed
  UNIX USERS
  ==========

    X11 issues
    ----------
Werner Lemberg's avatar
Werner Lemberg committed

    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
Werner Lemberg's avatar
Werner Lemberg committed
    and  will fail.   If you  have X11  in an  unusual place,  use the
    `X11_PATH` make variable.  More  than one directory, if necessary,
Werner Lemberg's avatar
Werner Lemberg committed
    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`
Werner Lemberg's avatar
Werner Lemberg committed
    variable as described in the top-level Makefile.
Werner Lemberg's avatar
 
Werner Lemberg committed

    Recent versions of Mac OS X  no longer deliver X11 by default; you
Werner Lemberg's avatar
Werner Lemberg committed
    have  to  install 'XQuartz'  or  'xorg-server'  (the successor  of
    XQuartz).   Those  bundles  are  provided  by  distributions  like
    MacPorts or homebrew.
Werner Lemberg's avatar
 
Werner Lemberg committed
    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` file that
    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:
Werner Lemberg's avatar
 
Werner Lemberg committed

       make FT2DEMOS=1 -f /path/to/freetype/build-dir/Makefile
Werner Lemberg's avatar
 
Werner Lemberg committed

    If necessary, adapt  the `TOP_DIR_2` variable to make  it point to
    the 'ft2demos' source directory.
Werner Lemberg's avatar
 
Werner Lemberg committed

--- end of README ---