src/base/ftinit.c

/***************************************************************************/
/*                                                                         */
/*  ftinit.c                                                               */
/*                                                                         */
/*    FreeType initialisation layer (body).                                */
/*                                                                         */
/*  Copyright 1996-1999 by                                                 */
/*  David Turner, Robert Wilhelm, and Werner Lemberg.                      */
/*                                                                         */
/*  This file is part of the FreeType project, and may only be used        */
/*  modified and distributed under the terms of the FreeType project       */
/*  license, LICENSE.TXT.  By continuing to use, modify, or distribute     */
/*  this file you indicate that you have read the license and              */
/*  understand and accept it fully.                                        */
/*                                                                         */
/***************************************************************************/

 /**************************************************************************
  *
  *  The purpose of this file is to implement the three following
  *  functions:
  *
  *	 FT_Default_Drivers:
  *		This function is used to add the set of default drivers
  *		to a fresh new library object. The set is computed at compile
  *		time from the Makefiles inclusions in Makefile.lib. See the
  *		document "FreeType Internals" for more info.
  *
  *
  *	 FT_Init_FreeType:
  *		This function creates a system object for the current platform,
  *		builds a library out of it, then calls FT_Default_Drivers
  *
  *
  *	 FT_Done_FreeType:
  *		This function simply finalise the library and the corresponding
  *		system object.
  *
  *
  *	 Note that even if FT_Init_FreeType uses the implementation of the
  *	 system object defined at build time, client applications are still
  *	 able to provide their own "ftsystem.c"
  *
  *
  *
  *
  *
  ************************************************************************/

#include <ftobjs.h>
#include <ftdriver.h>
#include <ftconfig.h>
#include <ftdebug.h>

#undef  FT_COMPONENT
#define FT_COMPONENT  trace_init

  /*************************************************************************/
  /*                                                                       */
  /* The macros FT_SUPPORT_xxxx are defined by Makefile.lib when this file */
  /* is compiled.  They come from a make variable called FTINIT_MACROS     */
  /* which is updated by each driver Makefile.                             */
  /*                                                                       */
  /* This means that when a driver isn't part of the build, ftinit.o       */
  /* won't try to reference it.                                            */
  /*                                                                       */
  /*************************************************************************/

#define  FTINIT_DRIVER_CHAIN
#define  FT_INIT_LAST_DRIVER_CHAIN    ((FT_DriverChain*) 0)

  /* Include the SFNT driver interface if needed */

#ifdef FT_SUPPORT_SFNT
#include "sfdriver.h"
#endif

  /* Include the TrueType driver interface if needed */

#ifdef FT_SUPPORT_TRUETYPE
#include "ttdriver.h"
#endif


  /* Include the Type1 driver interface if needed */

#ifdef FT_SUPPORT_TYPE1
#include "t1driver.h"
#endif



  /*************************************************************************/
  /*                                                                       */
  /* <Function>                                                            */
  /*    FT_Default_Drivers                                                 */
  /*                                                                       */
  /* <Description>                                                         */
  /*    Adds the set of default drivers to a given library object.         */
  /*                                                                       */
  /* <Input>                                                               */
  /*    library :: A handle to a new library object.                       */
  /*                                                                       */
  EXPORT_FUNC
  void  FT_Default_Drivers( FT_Library  library )
  {
    FT_Error               error;
    const FT_DriverChain*  chain = FT_INIT_LAST_DRIVER_CHAIN;

    while (chain)
    {
      error = FT_Add_Driver( library, chain->interface );

      /* notify errors, but don't stop */
      if (error)
      {
        FT_ERROR(( "FT.Default_Drivers: cannot install `%s', error = %x\n",
                   chain->interface->driver_name,
                   error ));
      }

      chain = chain->next;
      error = 0;  /* clear error */
    }
  }


  /*************************************************************************/
  /*                                                                       */
  /* <Function>                                                            */
  /*    FT_Init_FreeType                                                   */
  /*                                                                       */
  /* <Description>                                                         */
  /*    Initializes a new FreeType library object.  The set of drivers     */
  /*    that are registered by this function is determined at build time.  */
  /*                                                                       */
  /* <Output>                                                              */
  /*    library :: A handle to a new library object.                       */
  /*                                                                       */
  /* <Return>                                                              */
  /*    Error code.  0 means success.                                      */
  /*                                                                       */
  EXPORT_FUNC
  FT_Error  FT_Init_FreeType( FT_Library*  library )
  {
    FT_Error   error;
    FT_Memory  memory;

    /* First of all, allocate a new system object -this function is part */
    /* of the system-specific component, i.e. ftsystem.c                 */
    memory = FT_New_Memory();
    if (!memory)
    {
      FT_ERROR(( "FT_Init_FreeType:" ));
      FT_ERROR(( " cannot find memory manager" ));
      return FT_Err_Unimplemented_Feature;
    }
    
    /* builds a library out of it, then fill it with the set of */
    /* default drivers..										*/
    error = FT_New_Library( memory, library );
    if ( !error )
      FT_Default_Drivers(*library);
    
    return error;
  }


/* END */