developer/debug/test/freetype/README

   1 This package contains example programs for the FreeType 2 library.
   2
   3
   4 WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
   5
   6   The Makefile and Jamfile contained in this directory assume that the
   7   FreeType 2  library sources are  located in `../freetype2'.   If you
   8   downloaded one  of the  stable FreeType 2  source packages  from our
   9   server, you most probably have to rename its directory, for example:
  10
  11     mv freetype-2.10.0 freetype2       on Unix
  12     rename freetype-2.10.0 freetype2   on Windows
  13
  14 WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
  15
  16
  17   First compile the FreeType 2 library, then say `make'.  However, you
  18   must rename  the directory of the FreeType 2  library to `freetype2'
  19   (or create a symlink) before doing this.
  20
  21   Note  that  the  demonstration  programs  include  a  tiny  graphics
  22   sub-system that includes `drivers' to display Windows on Win32, X11,
  23   BeOS, Mac,  and OS/2.  The build system  should automatically detect
  24   which driver to use based on the current platform.
  25
  26   UNIX USERS
  27   ==========
  28
  29     X11 issues
  30     ----------
  31
  32     When building the demos, the build system tries to detect your X11
  33     path  by  looking for  the  patterns  `X11/bin', `X11R6/bin',  and
  34     `X11R5/bin' in your current path  (in this order).  If no X11 path
  35     is found, some demo programs  will not be able to display graphics
  36     and  will fail.   If you  have X11  in an  unusual place,  use the
  37     X11_PATH make  variable.  More  than one directory,  if necessary,
  38     must be separated with spaces.  Example:
  39
  40         make X11_PATH="/usr/openwin /usr/local/X11R6"
  41
  42     The build  system then derives  the X11_INCLUDE include  file path
  43     from X11_PATH by appending `/include'  to all path components.  It
  44     also derives the  X11_LIB library path from  X11_PATH by appending
  45     `/lib64' and `/lib' to all  components (in that order).  You might
  46     override  those  variables similar  to  X11_PATH  as arguments  to
  47     `make'.
  48
  49     If  you don't  have X11  at all,  fix the  definition of  the EXES
  50     variable as described in the top-level Makefile.
  51
  52     Recent versions of Mac OS X no longer deliver X11 by default;  you
  53     have to install XQuartz, see
  54
  55       https://support.apple.com/en-us/HT201341
  56
  57     for more details.
  58
  59
  60     Using a different build directory
  61     ---------------------------------
  62
  63     If the `configure' script of the FreeType 2 library is  run from a
  64     separate build directory,  it creates a dummy  Makefile which sets
  65     some  variables before  including  the top-level  Makefile of  the
  66     source  directory.  This dummy  Makefile can also be  used for the
  67     ft2demos package to be compiled in a different build directory:
  68
  69        make FT2DEMOS=1 -f /path/to/freetype2/build-dir/Makefile
  70
  71     If necessary, adapt  the `TOP_DIR_2' variable to make it  point to
  72     the ft2demos source directory.
  73
  74 --- end of README ---