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

You can build it either using the Meson build tool (see `README.meson`
for  more details),  or  using GNU  Make,  following the  instructions
below.
Werner Lemberg's avatar
 
Werner Lemberg committed

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.13.3 freetype       on Unix
    rename freetype-2.13.3 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 X11 by
    using pkg-config.   If X11 is  not found, some demo  programs will
    not be able to display graphics and will fail.
    Users with  X11 installed in  a non-standard location  can specify
    the paths  to the development  headers and library by  passing the
    X11_CFLAGS and X11_LIBS variables on the command line.

    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 ---