text: /****************************************************************************
   *
   * t1load.c
   *
   *   Type 1 font loader (body).
   *
   * Copyright (C) 1996-2022 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.
   *
   */
  
  
    /**************************************************************************
     *
     * This is the new and improved Type 1 data loader for FreeType 2.  The
     * old loader has several problems: it is slow, complex, difficult to
     * maintain, and contains incredible hacks to make it accept some
     * ill-formed Type 1 fonts without hiccup-ing.  Moreover, about 5% of
     * the Type 1 fonts on my machine still aren't loaded correctly by it.
     *
     * This version is much simpler, much faster and also easier to read and
     * maintain by a great order of magnitude.  The idea behind it is to
     * _not_ try to read the Type 1 token stream with a state machine (i.e.
     * a Postscript-like interpreter) but rather to perform simple pattern
     * matching.
     *
     * Indeed, nearly all data definitions follow a simple pattern like
     *
     * ... /Field <data> ...
     *
     * where <data> can be a number, a boolean, a string, or an array of
     * numbers.  There are a few exceptions, namely the encoding, font name,
     * charstrings, and subrs; they are handled with a special pattern
     * matching routine.
     *
     * All other common cases are handled very simply.  The matching rules
     * are defined in the file `t1tokens.h' through the use of several
     * macros calls PARSE_XXX.  This file is included twice here; the first
     * time to generate parsing callback functions, the second time to
     * generate a table of keywords (with pointers to the associated
     * callback functions).
     *
     * The function `parse_dict' simply scans *linearly* a given dictionary
     * (either the top-level or private one) and calls the appropriate
     * callback when it encounters an immediate keyword.
     *
     * This is by far the fastest way one can find to parse and read all
     * data.
     *
     * This led to tremendous code size reduction.  Note that later, the
     * glyph loader will also be _greatly_ simplified, and the automatic
     * hinter will replace the clumsy `t1hinter'.
     *
     */
  
  
  #include <ft2build.h>
  #include <freetype/internal/ftdebug.h>
  #include FT_CONFIG_CONFIG_H
  #include <freetype/ftmm.h>
  #include <freetype/internal/t1types.h>
  #include <freetype/internal/ftcalc.h>
  #include <freetype/internal/fthash.h>
  
  #include "t1load.h"
  #include "t1errors.h"
  
  
  #ifdef FT_CONFIG_OPTION_INCREMENTAL
  #define IS_INCREMENTAL  FT_BOOL( face->root.internal->incremental_interface )
  #else
  #define IS_INCREMENTAL  0
  #endif
  
  
    /**************************************************************************
     *
     * The macro FT_COMPONENT is used in trace mode.  It is an implicit
     * parameter of the FT_TRACE() and FT_ERROR() macros, used to print/log
     * messages during execution.
     */
  #undef  FT_COMPONENT
  #define FT_COMPONENT  t1load
  
  
  #ifndef T1_CONFIG_OPTION_NO_MM_SUPPORT
  
  
    /*************************************************************************/
    /*************************************************************************/
    /*****                                                               *****/
    /*****                    MULTIPLE MASTERS SUPPORT                   *****/
    /*****                                                               *****/
    /*************************************************************************/
    /*************************************************************************/
  
    static FT_Error
    t1_allocate_blend( T1_Face  face,
                       FT_UInt  num_designs,
                       FT_UInt  num_axis )
    {
      PS_Blend   blend;
      FT_Memory  memory = face->root.memory;
      FT_Error   error  = FT_Err_Ok;
  
  
      blend = face->blend;
      if ( !blend )
      {
        if ( FT_NEW( blend ) )
          goto Exit;
  
        blend->num_default_design_vector = 0;
        blend->weight_vector             = NULL;
        blend->default_weight_vector     = NULL;
        blend->design_pos[0]             = NULL;
  
        face->blend = blend;
      }
  
      /* allocate design data if needed */
      if ( num_designs > 0 )
      {
        if ( blend->num_designs == 0 )
        {
          FT_UInt  nn;
  
  
          /* allocate the blend `private' and `font_info' dictionaries */
          if ( FT_NEW_ARRAY( blend->font_infos[1], num_designs ) ||
               FT_NEW_ARRAY( blend->privates  [1], num_designs ) ||
               FT_NEW_ARRAY( blend->bboxes    [1], num_designs ) )
            goto Exit;
  
          blend->font_infos[0] = &face->type1.font_info;
          blend->privates  [0] = &face->type1.private_dict;
          blend->bboxes    [0] = &face->type1.font_bbox;
  
          for ( nn = 2; nn <= num_designs; nn++ )
          {
            blend->font_infos[nn] = blend->font_infos[nn - 1] + 1;
            blend->privates  [nn] = blend->privates  [nn - 1] + 1;
            blend->bboxes    [nn] = blend->bboxes    [nn - 1] + 1;
          }
  
          blend->num_designs = num_designs;
        }
        else if ( blend->num_designs != num_designs )
          goto Fail;
      }
  
      /* allocate axis data if needed */
      if ( num_axis > 0 )
      {
        if ( blend->num_axis != 0 && blend->num_axis != num_axis )
          goto Fail;
  
        blend->num_axis = num_axis;
      }
  
    Exit:
      return error;
  
    Fail:
      error = FT_THROW( Invalid_File_Format );
      goto Exit;
    }
  
  
    FT_LOCAL_DEF( FT_Error )
    T1_Get_Multi_Master( T1_Face           face,
                         FT_Multi_Master*  master )
    {
      PS_Blend  blend = face->blend;
      FT_UInt   n;
      FT_Error  error;
  
  
      error = FT_THROW( Invalid_Argument );
  
      if ( blend )
      {
        master->num_axis    = blend->num_axis;
        master->num_designs = blend->num_designs;
  
        for ( n = 0; n < blend->num_axis; n++ )
        {
          FT_MM_Axis*   axis = master->axis + n;
          PS_DesignMap  map = blend->design_map + n;
  
  
          axis->name    = blend->axis_names[n];
          axis->minimum = map->design_points[0];
          axis->maximum = map->design_points[map->num_points - 1];
        }
  
        error = FT_Err_Ok;
      }
  
      return error;
    }
  
  
    /**************************************************************************
     *
     * Given a normalized (blend) coordinate, figure out the design
     * coordinate appropriate for that value.
     */
    static FT_Fixed
    mm_axis_unmap( PS_DesignMap  axismap,
                   FT_Fixed      ncv )
    {
      int  j;
  
  
      if ( ncv <= axismap->blend_points[0] )
        return INT_TO_FIXED( axismap->design_points[0] );
  
      for ( j = 1; j < axismap->num_points; j++ )
      {
        if ( ncv <= axismap->blend_points[j] )
          return INT_TO_FIXED( axismap->design_points[j - 1] ) +
                 ( axismap->design_points[j] - axismap->design_points[j - 1] ) *
                 FT_DivFix( ncv - axismap->blend_points[j - 1],
                            axismap->blend_points[j] -
                              axismap->blend_points[j - 1] );
      }
  
      return INT_TO_FIXED( axismap->design_points[axismap->num_points - 1] );
    }
  
  
    /**************************************************************************
     *
     * Given a vector of weights, one for each design, figure out the
     * normalized axis coordinates which gave rise to those weights.
     */
    static void
    mm_weights_unmap( FT_Fixed*  weights,
                      FT_Fixed*  axiscoords,
                      FT_UInt    axis_count )
    {
      FT_ASSERT( axis_count <= T1_MAX_MM_AXIS );
  
      if ( axis_count == 1 )
        axiscoords[0] = weights[1];
  
      else if ( axis_count == 2 )
      {
        axiscoords[0] = weights[3] + weights[1];
        axiscoords[1] = weights[3] + weights[2];
      }
  
      else if ( axis_count == 3 )
      {
        axiscoords[0] = weights[7] + weights[5] + weights[3] + weights[1];
        axiscoords[1] = weights[7] + weights[6] + weights[3] + weights[2];
        axiscoords[2] = weights[7] + weights[6] + weights[5] + weights[4];
      }
  
      else
      {
        axiscoords[0] = weights[15] + weights[13] + weights[11] + weights[9] +
                          weights[7] + weights[5] + weights[3] + weights[1];
        axiscoords[1] = weights[15] + weights[14] + weights[11] + weights[10] +
                          weights[7] + weights[6] + weights[3] + weights[2];
        axiscoords[2] = weights[15] + weights[14] + weights[13] + weights[12] +
                          weights[7] + weights[6] + weights[5] + weights[4];
        axiscoords[3] = weights[15] + weights[14] + weights[13] + weights[12] +
                          weights[11] + weights[10] + weights[9] + weights[8];
      }
    }
  
  
    /**************************************************************************
     *
     * Just a wrapper around T1_Get_Multi_Master to support the different
     * arguments needed by the GX var distortable fonts.
     */
    FT_LOCAL_DEF( FT_Error )
    T1_Get_MM_Var( T1_Face      face,
                   FT_MM_Var*  *master )
    {
      FT_Memory        memory = face->root.memory;
      FT_MM_Var       *mmvar = NULL;
      FT_Multi_Master  mmaster;
      FT_Error         error;
      FT_UInt          i;
      FT_Fixed         axiscoords[T1_MAX_MM_AXIS];
      PS_Blend         blend = face->blend;
      FT_UShort*       axis_flags;
  
      FT_Offset  mmvar_size;
      FT_Offset  axis_flags_size;
      FT_Offset  axis_size;
  
  
      error = T1_Get_Multi_Master( face, &mmaster );
      if ( error )
        goto Exit;
  
      /* the various `*_size' variables, which we also use as     */
      /* offsets into the `mmvar' array, must be multiples of the */
      /* pointer size (except the last one); without such an      */
      /* alignment there might be runtime errors due to           */
      /* misaligned addresses                                     */
  #undef  ALIGN_SIZE
  #define ALIGN_SIZE( n ) \
            ( ( (n) + sizeof (void*) - 1 ) & ~( sizeof (void*) - 1 ) )
  
      mmvar_size      = ALIGN_SIZE( sizeof ( FT_MM_Var ) );
      axis_flags_size = ALIGN_SIZE( mmaster.num_axis *
                                    sizeof ( FT_UShort ) );
      axis_size       = mmaster.num_axis * sizeof ( FT_Var_Axis );
  
      if ( FT_ALLOC( mmvar, mmvar_size +
                            axis_flags_size +
                            axis_size ) )
        goto Exit;
  
      mmvar->num_axis        = mmaster.num_axis;
      mmvar->num_designs     = mmaster.num_designs;
      mmvar->num_namedstyles = 0;                           /* Not supported */
  
      /* while axis flags are meaningless here, we have to provide the array */
      /* to make `FT_Get_Var_Axis_Flags' work: the function expects that the */
      /* values directly follow the data of `FT_MM_Var'                      */
      axis_flags = (FT_UShort*)( (char*)mmvar + mmvar_size );
      for ( i = 0; i < mmaster.num_axis; i++ )
        axis_flags[i] = 0;
  
      mmvar->axis       = (FT_Var_Axis*)( (char*)axis_flags + axis_flags_size );
      mmvar->namedstyle = NULL;
  
      for ( i = 0; i < mmaster.num_axis; i++ )
      {
        mmvar->axis[i].name    = mmaster.axis[i].name;
        mmvar->axis[i].minimum = INT_TO_FIXED( mmaster.axis[i].minimum );
        mmvar->axis[i].maximum = INT_TO_FIXED( mmaster.axis[i].maximum );
        mmvar->axis[i].strid   = ~0U;                      /* Does not apply */
        mmvar->axis[i].tag     = ~0U;                      /* Does not apply */
  
        if ( !mmvar->axis[i].name )
          continue;
  
        if ( ft_strcmp( mmvar->axis[i].name, "Weight" ) == 0 )
          mmvar->axis[i].tag = FT_MAKE_TAG( 'w', 'g', 'h', 't' );
        else if ( ft_strcmp( mmvar->axis[i].name, "Width" ) == 0 )
          mmvar->axis[i].tag = FT_MAKE_TAG( 'w', 'd', 't', 'h' );
        else if ( ft_strcmp( mmvar->axis[i].name, "OpticalSize" ) == 0 )
          mmvar->axis[i].tag = FT_MAKE_TAG( 'o', 'p', 's', 'z' );
      }
  
      mm_weights_unmap( blend->default_weight_vector,
                        axiscoords,
                        blend->num_axis );
  
      for ( i = 0; i < mmaster.num_axis; i++ )
        mmvar->axis[i].def = mm_axis_unmap( &blend->design_map[i],
                                            axiscoords[i] );
  
      *master = mmvar;
  
    Exit:
      return error;
    }
  
  
    static FT_Error
    t1_set_mm_blend( T1_Face    face,
                     FT_UInt    num_coords,
                     FT_Fixed*  coords )
    {
      PS_Blend  blend = face->blend;
      FT_UInt   n, m;
  
      FT_Bool  have_diff = 0;
  
  
      if ( !blend )
        return FT_THROW( Invalid_Argument );
  
      if ( num_coords > blend->num_axis )
        num_coords = blend->num_axis;
  
      /* recompute the weight vector from the blend coordinates */
      for ( n = 0; n < blend->num_designs; n++ )
      {
        FT_Fixed  result = 0x10000L;  /* 1.0 fixed */
        FT_Fixed  factor;
  
  
        for ( m = 0; m < blend->num_axis; m++ )
        {
          /* use a default value if we don't have a coordinate */
          if ( m >= num_coords )
          {
            result >>= 1;
            continue;
          }
  
          /* get current blend axis position */
          factor = coords[m];
          if ( ( n & ( 1 << m ) ) == 0 )
            factor = 0x10000L - factor;
  
          if ( factor <= 0 )
          {
            result = 0;
            break;
          }
          else if ( factor >= 0x10000L )
            continue;
  
          result = FT_MulFix( result, factor );
        }
  
        if ( blend->weight_vector[n] != result )
        {
          blend->weight_vector[n] = result;
          have_diff               = 1;
        }
      }
  
      /* return value -1 indicates `no change' */
      return have_diff ? FT_Err_Ok : -1;
    }
  
  
    FT_LOCAL_DEF( FT_Error )
    T1_Set_MM_Blend( T1_Face    face,
                     FT_UInt    num_coords,
                     FT_Fixed*  coords )
    {
      FT_Error  error;
  
  
      error = t1_set_mm_blend( face, num_coords, coords );
      if ( error )
        return error;
  
      if ( num_coords )
        face->root.face_flags |= FT_FACE_FLAG_VARIATION;
      else
        face->root.face_flags &= ~FT_FACE_FLAG_VARIATION;
  
      return FT_Err_Ok;
    }
  
  
    FT_LOCAL_DEF( FT_Error )
    T1_Get_MM_Blend( T1_Face    face,
                     FT_UInt    num_coords,
                     FT_Fixed*  coords )
    {
      PS_Blend  blend = face->blend;
  
      FT_Fixed  axiscoords[4];
      FT_UInt   i, nc;
  
  
      if ( !blend )
        return FT_THROW( Invalid_Argument );
  
      mm_weights_unmap( blend->weight_vector,
                        axiscoords,
                        blend->num_axis );
  
      nc = num_coords;
      if ( num_coords > blend->num_axis )
      {
        FT_TRACE2(( "T1_Get_MM_Blend: only using first %d of %d coordinates\n",
                    blend->num_axis, num_coords ));
        nc = blend->num_axis;
      }
  
      for ( i = 0; i < nc; i++ )
        coords[i] = axiscoords[i];
      for ( ; i < num_coords; i++ )
        coords[i] = 0x8000;
  
      return FT_Err_Ok;
    }
  
  
    FT_LOCAL_DEF( FT_Error )
    T1_Set_MM_WeightVector( T1_Face    face,
                            FT_UInt    len,
                            FT_Fixed*  weightvector )
    {
      PS_Blend  blend = face->blend;
      FT_UInt   i, n;
  
  
      if ( !blend )
       return FT_THROW( Invalid_Argument );
  
      if ( !len && !weightvector )
      {
        for ( i = 0; i < blend->num_designs; i++ )
          blend->weight_vector[i] = blend->default_weight_vector[i];
      }
      else
      {
        if ( !weightvector )
          return FT_THROW( Invalid_Argument );
  
        n = len < blend->num_designs ? len : blend->num_designs;
  
        for ( i = 0; i < n; i++ )
          blend->weight_vector[i] = weightvector[i];
  
        for ( ; i < blend->num_designs; i++ )
          blend->weight_vector[i] = (FT_Fixed)0;
  
        if ( len )
          face->root.face_flags |= FT_FACE_FLAG_VARIATION;
        else
          face->root.face_flags &= ~FT_FACE_FLAG_VARIATION;
      }
  
      return FT_Err_Ok;
    }
  
  
    FT_LOCAL_DEF( FT_Error )
    T1_Get_MM_WeightVector( T1_Face    face,
                            FT_UInt*   len,
                            FT_Fixed*  weightvector )
    {
      PS_Blend  blend = face->blend;
      FT_UInt   i;
  
  
      if ( !blend )
        return FT_THROW( Invalid_Argument );
  
      if ( *len < blend->num_designs )
      {
        *len = blend->num_designs;
        return FT_THROW( Invalid_Argument );
      }
  
      for ( i = 0; i < blend->num_designs; i++ )
        weightvector[i] = blend->weight_vector[i];
      for ( ; i < *len; i++ )
        weightvector[i] = (FT_Fixed)0;
  
      *len = blend->num_designs;
  
      return FT_Err_Ok;
    }
  
  
    FT_LOCAL_DEF( FT_Error )
    T1_Set_MM_Design( T1_Face   face,
                      FT_UInt   num_coords,
                      FT_Long*  coords )
    {
      FT_Error  error;
      PS_Blend  blend = face->blend;
      FT_UInt   n;
      FT_Fixed  final_blends[T1_MAX_MM_DESIGNS];
  
  
      if ( !blend )
        return FT_THROW( Invalid_Argument );
  
      if ( num_coords > blend->num_axis )
        num_coords = blend->num_axis;
  
      /* compute the blend coordinates through the blend design map */
  
      for ( n = 0; n < blend->num_axis; n++ )
      {
        FT_Long       design;
        FT_Fixed      the_blend;
        PS_DesignMap  map     = blend->design_map + n;
        FT_Long*      designs = map->design_points;
        FT_Fixed*     blends  = map->blend_points;
        FT_Int        p, before  = -1, after = -1;
  
  
        /* use a default value if we don't have a coordinate */
        if ( n < num_coords )
          design = coords[n];
        else
          design = ( designs[map->num_points - 1] - designs[0] ) / 2;
  
        for ( p = 0; p < (FT_Int)map->num_points; p++ )
        {
          FT_Long  p_design = designs[p];
  
  
          /* exact match? */
          if ( design == p_design )
          {
            the_blend = blends[p];
            goto Found;
          }
  
          if ( design < p_design )
          {
            after = p;
            break;
          }
  
          before = p;
        }
  
        /* now interpolate if necessary */
        if ( before < 0 )
          the_blend = blends[0];
  
        else if ( after < 0 )
          the_blend = blends[map->num_points - 1];
  
        else
          the_blend = FT_MulDiv( design         - designs[before],
                                 blends [after] - blends [before],
                                 designs[after] - designs[before] );
  
      Found:
        final_blends[n] = the_blend;
      }
  
      error = t1_set_mm_blend( face, blend->num_axis, final_blends );
      if ( error )
        return error;
  
      if ( num_coords )
        face->root.face_flags |= FT_FACE_FLAG_VARIATION;
      else
        face->root.face_flags &= ~FT_FACE_FLAG_VARIATION;
  
      return FT_Err_Ok;
    }
  
  
    /* MM fonts don't have named instances, so only the design is reset */
  
    FT_LOCAL_DEF( FT_Error )
    T1_Reset_MM_Blend( T1_Face  face,
                       FT_UInt  instance_index )
    {
      FT_UNUSED( instance_index );
  
      return T1_Set_MM_Blend( face, 0, NULL );
    }
  
  
    /**************************************************************************
     *
     * Just a wrapper around T1_Set_MM_Design to support the different
     * arguments needed by the GX var distortable fonts.
     */
    FT_LOCAL_DEF( FT_Error )
    T1_Set_Var_Design( T1_Face    face,
                       FT_UInt    num_coords,
                       FT_Fixed*  coords )
    {
       FT_Long  lcoords[T1_MAX_MM_AXIS];
       FT_UInt  i;
  
  
       if ( num_coords > T1_MAX_MM_AXIS )
         num_coords = T1_MAX_MM_AXIS;
  
       for ( i = 0; i < num_coords; i++ )
         lcoords[i] = FIXED_TO_INT( coords[i] );
  
       return T1_Set_MM_Design( face, num_coords, lcoords );
    }
  
  
    FT_LOCAL_DEF( FT_Error )
    T1_Get_Var_Design( T1_Face    face,
                       FT_UInt    num_coords,
                       FT_Fixed*  coords )
    {
      PS_Blend  blend = face->blend;
  
      FT_Fixed  axiscoords[4];
      FT_UInt   i, nc;
  
  
      if ( !blend )
        return FT_THROW( Invalid_Argument );
  
      mm_weights_unmap( blend->weight_vector,
                        axiscoords,
                        blend->num_axis );
  
      nc = num_coords;
      if ( num_coords > blend->num_axis )
      {
        FT_TRACE2(( "T1_Get_Var_Design:"
                    " only using first %d of %d coordinates\n",
                    blend->num_axis, num_coords ));
        nc = blend->num_axis;
      }
  
      for ( i = 0; i < nc; i++ )
        coords[i] = mm_axis_unmap( &blend->design_map[i], axiscoords[i] );
      for ( ; i < num_coords; i++ )
        coords[i] = 0;
  
      return FT_Err_Ok;
    }
  
  
    FT_LOCAL_DEF( void )
    T1_Done_Blend( T1_Face  face )
    {
      FT_Memory  memory = face->root.memory;
      PS_Blend   blend  = face->blend;
  
  
      if ( blend )
      {
        FT_UInt  num_designs = blend->num_designs;
        FT_UInt  num_axis    = blend->num_axis;
        FT_UInt  n;
  
  
        /* release design pos table */
        FT_FREE( blend->design_pos[0] );
        for ( n = 1; n < num_designs; n++ )
          blend->design_pos[n] = NULL;
  
        /* release blend `private' and `font info' dictionaries */
        FT_FREE( blend->privates[1] );
        FT_FREE( blend->font_infos[1] );
        FT_FREE( blend->bboxes[1] );
  
        for ( n = 0; n < num_designs; n++ )
        {
          blend->privates  [n] = NULL;
          blend->font_infos[n] = NULL;
          blend->bboxes    [n] = NULL;
        }
  
        /* release weight vectors */
        FT_FREE( blend->weight_vector );
        blend->default_weight_vector = NULL;
  
        /* release axis names */
        for ( n = 0; n < num_axis; n++ )
          FT_FREE( blend->axis_names[n] );
  
        /* release design map */
        for ( n = 0; n < num_axis; n++ )
        {
          PS_DesignMap  dmap = blend->design_map + n;
  
  
          FT_FREE( dmap->design_points );
          dmap->num_points = 0;
        }
  
        FT_FREE( face->blend );
      }
    }
  
  
    static void
    parse_blend_axis_types( T1_Face    face,
                            T1_Loader  loader )
    {
      T1_TokenRec  axis_tokens[T1_MAX_MM_AXIS];
      FT_Int       n, num_axis;
      FT_Error     error = FT_Err_Ok;
      PS_Blend     blend;
      FT_Memory    memory;
  
  
      /* take an array of objects */
      T1_ToTokenArray( &loader->parser, axis_tokens,
                       T1_MAX_MM_AXIS, &num_axis );
      if ( num_axis < 0 )
      {
        error = FT_ERR( Ignore );
        goto Exit;
      }
      if ( num_axis == 0 || num_axis > T1_MAX_MM_AXIS )
      {
        FT_ERROR(( "parse_blend_axis_types: incorrect number of axes: %d\n",
                   num_axis ));
        error = FT_THROW( Invalid_File_Format );
        goto Exit;
      }
  
      /* allocate blend if necessary */
      error = t1_allocate_blend( face, 0, (FT_UInt)num_axis );
      if ( error )
        goto Exit;
  
      FT_TRACE4(( " [" ));
  
      blend  = face->blend;
      memory = face->root.memory;
  
      /* each token is an immediate containing the name of the axis */
      for ( n = 0; n < num_axis; n++ )
      {
        T1_Token  token = axis_tokens + n;
        FT_Byte*  name;
        FT_UInt   len;
  
  
        /* skip first slash, if any */
        if ( token->start[0] == '/' )
          token->start++;
  
        len = (FT_UInt)( token->limit - token->start );
        if ( len == 0 )
        {
          error = FT_THROW( Invalid_File_Format );
          goto Exit;
        }
  
        FT_TRACE4(( " /%.*s", len, token->start ));
  
        name = (FT_Byte*)blend->axis_names[n];
        if ( name )
        {
          FT_TRACE0(( "parse_blend_axis_types:"
                      " overwriting axis name `%s' with `%.*s'\n",
                      name, len, token->start ));
          FT_FREE( name );
        }
  
        if ( FT_QALLOC( blend->axis_names[n], len + 1 ) )
          goto Exit;
  
        name = (FT_Byte*)blend->axis_names[n];
        FT_MEM_COPY( name, token->start, len );
        name[len] = '\0';
      }
  
      FT_TRACE4(( "]\n" ));
  
    Exit:
      loader->parser.root.error = error;
    }
  
  
    static void
    parse_blend_design_positions( T1_Face    face,
                                  T1_Loader  loader )
    {
      T1_TokenRec  design_tokens[T1_MAX_MM_DESIGNS];
      FT_Int       num_designs;
      FT_Int       num_axis = 0; /* make compiler happy */
      T1_Parser    parser   = &loader->parser;
      FT_Memory    memory   = face->root.memory;
      FT_Error     error    = FT_Err_Ok;
      FT_Fixed*    design_pos[T1_MAX_MM_DESIGNS];
  
  
      design_pos[0] = NULL;
  
      /* get the array of design tokens -- compute number of designs */
      T1_ToTokenArray( parser, design_tokens,
                       T1_MAX_MM_DESIGNS, &num_designs );
      if ( num_designs < 0 )
      {
        error = FT_ERR( Ignore );
        goto Exit;
      }
      if ( num_designs == 0 || num_designs > T1_MAX_MM_DESIGNS )
      {
        FT_ERROR(( "parse_blend_design_positions:"
                   " incorrect number of designs: %d\n",
                   num_designs ));
        error = FT_THROW( Invalid_File_Format );
        goto Exit;
      }
  
      {
        FT_Byte*  old_cursor = parser->root.cursor;
        FT_Byte*  old_limit  = parser->root.limit;
        FT_Int    n, nn;
        PS_Blend  blend;
  
  
        FT_TRACE4(( " [" ));
  
        for ( n = 0; n < num_designs; n++ )
        {
          T1_TokenRec  axis_tokens[T1_MAX_MM_AXIS];
          T1_Token     token;
          FT_Int       axis, n_axis;
  
  
          /* read axis/coordinates tokens */
          token = design_tokens + n;
          parser->root.cursor = token->start;
          parser->root.limit  = token->limit;
          T1_ToTokenArray( parser, axis_tokens, T1_MAX_MM_AXIS, &n_axis );
  
          if ( n == 0 )
          {
            if ( n_axis <= 0 || n_axis > T1_MAX_MM_AXIS )
            {
              FT_ERROR(( "parse_blend_design_positions:"
                         " invalid number of axes: %d\n",
                         n_axis ));
              error = FT_THROW( Invalid_File_Format );
              goto Exit;
            }
  
            num_axis = n_axis;
            error = t1_allocate_blend( face,
                                       (FT_UInt)num_designs,
                                       (FT_UInt)num_axis );
            if ( error )
              goto Exit;
  
            /* allocate a blend design pos table */
            if ( FT_QNEW_ARRAY( design_pos[0], num_designs * num_axis ) )
              goto Exit;
  
            for ( nn = 1; nn < num_designs; nn++ )
              design_pos[nn] = design_pos[0] + num_axis * nn;
          }
          else if ( n_axis != num_axis )
          {
            FT_ERROR(( "parse_blend_design_positions: incorrect table\n" ));
            error = FT_THROW( Invalid_File_Format );
            goto Exit;
          }
  
          /* now read each axis token into the design position */
          FT_TRACE4(( " [" )) ;
          for ( axis = 0; axis < n_axis; axis++ )
          {
            T1_Token  token2 = axis_tokens + axis;
  
  
            parser->root.cursor = token2->start;
            parser->root.limit  = token2->limit;
            design_pos[n][axis] = T1_ToFixed( parser, 0 );
            FT_TRACE4(( " %f", (double)design_pos[n][axis] / 65536 ));
          }
          FT_TRACE4(( "]" )) ;
        }
  
        FT_TRACE4(( "]\n" ));
  
        loader->parser.root.cursor = old_cursor;
        loader->parser.root.limit  = old_limit;
  
        /* a valid BlendDesignPosition has been parsed */
        blend = face->blend;
        if ( blend->design_pos[0] )
          FT_FREE( blend->design_pos[0] );
  
        for ( n = 0; n < num_designs; n++ )
        {
          blend->design_pos[n] = design_pos[n];
          design_pos[n]        = NULL;
        }
      }
  
    Exit:
      FT_FREE( design_pos[0] );
      loader->parser.root.error = error;
    }
  
  
    static void
    parse_blend_design_map( T1_Face    face,
                            T1_Loader  loader )
    {
      FT_Error     error  = FT_Err_Ok;
      T1_Parser    parser = &loader->parser;
      PS_Blend     blend;
      T1_TokenRec  axis_tokens[T1_MAX_MM_AXIS];
      FT_Int       n, num_axis;
      FT_Byte*     old_cursor;
      FT_Byte*     old_limit;
      FT_Memory    memory = face->root.memory;
  
  
      T1_ToTokenArray( parser, axis_tokens,
                       T1_MAX_MM_AXIS, &num_axis );
      if ( num_axis < 0 )
      {
        error = FT_ERR( Ignore );
        goto Exit;
      }
      if ( num_axis == 0 || num_axis > T1_MAX_MM_AXIS )
      {
        FT_ERROR(( "parse_blend_design_map: incorrect number of axes: %d\n",
                   num_axis ));
        error = FT_THROW( Invalid_File_Format );
        goto Exit;
      }
  
      old_cursor = parser->root.cursor;
      old_limit  = parser->root.limit;
  
      error = t1_allocate_blend( face, 0, (FT_UInt)num_axis );
      if ( error )
        goto Exit;
      blend = face->blend;
  
      FT_TRACE4(( " [" ));
  
      /* now read each axis design map */
      for ( n = 0; n < num_axis; n++ )
      {
        PS_DesignMap  map = blend->design_map + n;
        T1_Token      axis_token;
        T1_TokenRec   point_tokens[T1_MAX_MM_MAP_POINTS];
        FT_Int        p, num_points;
  
  
        axis_token = axis_tokens + n;
  
        parser->root.cursor = axis_token->start;
        parser->root.limit  = axis_token->limit;
        T1_ToTokenArray( parser, point_tokens,
                         T1_MAX_MM_MAP_POINTS, &num_points );
  
        FT_TRACE4(( " [" ));
  
        if ( num_points <= 0 || num_points > T1_MAX_MM_MAP_POINTS )
        {
          FT_ERROR(( "parse_blend_design_map: incorrect table\n" ));
          error = FT_THROW( Invalid_File_Format );
          goto Exit;
        }
  
        if ( map->design_points )
        {
          FT_ERROR(( "parse_blend_design_map: duplicate table\n" ));
          error = FT_THROW( Invalid_File_Format );
          goto Exit;
        }
  
        /* allocate design map data */
        if ( FT_QNEW_ARRAY( map->design_points, num_points * 2 ) )
          goto Exit;
        map->blend_points = map->design_points + num_points;
        map->num_points   = (FT_Byte)num_points;
  
        for ( p = 0; p < num_points; p++ )
        {
          T1_Token  point_token;
  
  
          point_token = point_tokens + p;
  
          /* don't include delimiting brackets */
          parser->root.cursor = point_token->start + 1;
          parser->root.limit  = point_token->limit - 1;
  
          map->design_points[p] = T1_ToInt( parser );
          map->blend_points [p] = T1_ToFixed( parser, 0 );
  
          FT_TRACE4(( " [%ld %f]",
                      map->design_points[p],
                      (double)map->blend_points[p] / 65536 ));
        }
  
        FT_TRACE4(( "]" ));
      }
  
      FT_TRACE4(( "]\n" ));
  
      parser->root.cursor = old_cursor;
      parser->root.limit  = old_limit;
  
    Exit:
      parser->root.error = error;
    }
  
  
    static void
    parse_weight_vector( T1_Face    face,
                         T1_Loader  loader )
    {
      T1_TokenRec  design_tokens[T1_MAX_MM_DESIGNS];
      FT_Int       num_designs;
      FT_Error     error  = FT_Err_Ok;
      FT_Memory    memory = face->root.memory;
      T1_Parser    parser = &loader->parser;
      PS_Blend     blend  = face->blend;
      T1_Token     token;
      FT_Int       n;
      FT_Byte*     old_cursor;
      FT_Byte*     old_limit;
  
  
      T1_ToTokenArray( parser, design_tokens,
                       T1_MAX_MM_DESIGNS, &num_designs );
      if ( num_designs < 0 )
      {
        error = FT_ERR( Ignore );
        goto Exit;
      }
      if ( num_designs == 0 || num_designs > T1_MAX_MM_DESIGNS )
      {
        FT_ERROR(( "parse_weight_vector:"
                   " incorrect number of designs: %d\n",
                   num_designs ));
        error = FT_THROW( Invalid_File_Format );
        goto Exit;
      }
  
      if ( !blend || !blend->num_designs )
      {
        error = t1_allocate_blend( face, (FT_UInt)num_designs, 0 );
        if ( error )
          goto Exit;
        blend = face->blend;
      }
      else if ( blend->num_designs != (FT_UInt)num_designs )
      {
        FT_ERROR(( "parse_weight_vector:"
                   " /BlendDesignPosition and /WeightVector have\n" ));
        FT_ERROR(( "                    "
                   " different number of elements\n" ));
        error = FT_THROW( Invalid_File_Format );
        goto Exit;
      }
  
      if ( !blend->weight_vector )
        if ( FT_QNEW_ARRAY( blend->weight_vector, num_designs * 2 ) )
          goto Exit;
  
      blend->default_weight_vector = blend->weight_vector + num_designs;
  
      old_cursor = parser->root.cursor;
      old_limit  = parser->root.limit;
  
      FT_TRACE4(( "[" ));
  
      for ( n = 0; n < num_designs; n++ )
      {
        token = design_tokens + n;
        parser->root.cursor = token->start;
        parser->root.limit  = token->limit;
  
        blend->default_weight_vector[n] =
        blend->weight_vector[n]         = T1_ToFixed( parser, 0 );
  
        FT_TRACE4(( " %f", (double)blend->weight_vector[n] / 65536 ));
      }
  
      FT_TRACE4(( "]\n" ));
  
      parser->root.cursor = old_cursor;
      parser->root.limit  = old_limit;
  
    Exit:
      parser->root.error = error;
    }
  
  
    /* e.g., /BuildCharArray [0 0 0 0 0 0 0 0] def           */
    /* we're only interested in the number of array elements */
    static void
    parse_buildchar( T1_Face    face,
                     T1_Loader  loader )
    {
      face->len_buildchar = (FT_UInt)T1_ToFixedArray( &loader->parser,
                                                      0, NULL, 0 );
  
  #ifdef FT_DEBUG_LEVEL_TRACE
      {
        FT_UInt  i;
  
  
        FT_TRACE4(( " [" ));
        for ( i = 0; i < face->len_buildchar; i++ )
          FT_TRACE4(( " 0" ));
  
        FT_TRACE4(( "]\n" ));
      }
  #endif
  
      return;
    }
  
  
  #endif /* !T1_CONFIG_OPTION_NO_MM_SUPPORT */
  
  
  
  
    /*************************************************************************/
    /*************************************************************************/
    /*****                                                               *****/
    /*****                      TYPE 1 SYMBOL PARSING                    *****/
    /*****                                                               *****/
    /*************************************************************************/
    /*************************************************************************/
  
    static FT_Error
    t1_load_keyword( T1_Face         face,
                     T1_Loader       loader,
                     const T1_Field  field )
    {
      FT_Error  error;
      void*     dummy_object;
      void**    objects;
      FT_UInt   max_objects;
      PS_Blend  blend = face->blend;
  
  
      if ( blend && blend->num_designs == 0 )
        blend = NULL;
  
      /* if the keyword has a dedicated callback, call it */
      if ( field->type == T1_FIELD_TYPE_CALLBACK )
      {
        FT_TRACE4(( "  %s", field->ident ));
  
        field->reader( (FT_Face)face, loader );
        error = loader->parser.root.error;
        goto Exit;
      }
  
      /* now, the keyword is either a simple field, or a table of fields; */
      /* we are now going to take care of it                              */
      switch ( field->location )
      {
      case T1_FIELD_LOCATION_FONT_INFO:
        dummy_object = &face->type1.font_info;
        objects      = &dummy_object;
        max_objects  = 0;
  
        if ( blend )
        {
          objects     = (void**)blend->font_infos;
          max_objects = blend->num_designs;
        }
        break;
  
      case T1_FIELD_LOCATION_FONT_EXTRA:
        dummy_object = &face->type1.font_extra;
        objects      = &dummy_object;
        max_objects  = 0;
        break;
  
      case T1_FIELD_LOCATION_PRIVATE:
        dummy_object = &face->type1.private_dict;
        objects      = &dummy_object;
        max_objects  = 0;
  
        if ( blend )
        {
          objects     = (void**)blend->privates;
          max_objects = blend->num_designs;
        }
        break;
  
      case T1_FIELD_LOCATION_BBOX:
        dummy_object = &face->type1.font_bbox;
        objects      = &dummy_object;
        max_objects  = 0;
  
        if ( blend )
        {
          objects     = (void**)blend->bboxes;
          max_objects = blend->num_designs;
        }
        break;
  
      case T1_FIELD_LOCATION_LOADER:
        dummy_object = loader;
        objects      = &dummy_object;
        max_objects  = 0;
        break;
  
      case T1_FIELD_LOCATION_FACE:
        dummy_object = face;
        objects      = &dummy_object;
        max_objects  = 0;
        break;
  
  #ifndef T1_CONFIG_OPTION_NO_MM_SUPPORT
      case T1_FIELD_LOCATION_BLEND:
        dummy_object = face->blend;
        objects      = &dummy_object;
        max_objects  = 0;
        break;
  #endif
  
      default:
        dummy_object = &face->type1;
        objects      = &dummy_object;
        max_objects  = 0;
      }
  
      FT_TRACE4(( "  %s", field->ident ));
  
      if ( *objects )
      {
        if ( field->type == T1_FIELD_TYPE_INTEGER_ARRAY ||
             field->type == T1_FIELD_TYPE_FIXED_ARRAY   )
          error = T1_Load_Field_Table( &loader->parser, field,
                                       objects, max_objects, 0 );
        else
          error = T1_Load_Field( &loader->parser, field,
                                 objects, max_objects, 0 );
      }
      else
      {
        FT_TRACE1(( "t1_load_keyword: ignoring keyword `%s'"
                    " which is not valid at this point\n",
                   field->ident ));
        FT_TRACE1(( "                 (probably due to missing keywords)\n" ));
        error = FT_Err_Ok;
      }
  
      FT_TRACE4(( "\n" ));
  
    Exit:
      return error;
    }
  
  
    static void
    parse_private( T1_Face    face,
                   T1_Loader  loader )
    {
      FT_UNUSED( face );
  
      loader->keywords_encountered |= T1_PRIVATE;
  
      FT_TRACE4(( "\n" ));
    }
  
  
    /* return 1 in case of success */
  
    static int
    read_binary_data( T1_Parser  parser,
                      FT_ULong*  size,
                      FT_Byte**  base,
                      FT_Bool    incremental )
    {
      FT_Byte*  cur;
      FT_Byte*  limit = parser->root.limit;
  
  
      /* the binary data has one of the following formats */
      /*                                                  */
      /*   `size' [white*] RD white ....... ND            */
      /*   `size' [white*] -| white ....... |-            */
      /*                                                  */
  
      T1_Skip_Spaces( parser );
  
      cur = parser->root.cursor;
  
      if ( cur < limit && ft_isdigit( *cur ) )
      {
        FT_Long  s = T1_ToInt( parser );
  
  
        T1_Skip_PS_Token( parser );   /* `RD' or `-|' or something else */
  
        /* there is only one whitespace char after the */
        /* `RD' or `-|' token                          */
        *base = parser->root.cursor + 1;
  
        if ( s >= 0 && s < limit - *base )
        {
          parser->root.cursor += s + 1;
          *size = (FT_ULong)s;
          return !parser->root.error;
        }
      }
  
      if( !incremental )
      {
        FT_ERROR(( "read_binary_data: invalid size field\n" ));
        parser->root.error = FT_THROW( Invalid_File_Format );
      }
  
      return 0;
    }
  
  
    /* We now define the routines to handle the `/Encoding', `/Subrs', */
    /* and `/CharStrings' dictionaries.                                */
  
    static void
    t1_parse_font_matrix( T1_Face    face,
                          T1_Loader  loader )
    {
      T1_Parser   parser = &loader->parser;
      FT_Matrix*  matrix = &face->type1.font_matrix;
      FT_Vector*  offset = &face->type1.font_offset;
      FT_Face     root   = (FT_Face)&face->root;
      FT_Fixed    temp[6];
      FT_Fixed    temp_scale;
      FT_Int      result;
  
  
      /* input is scaled by 1000 to accommodate default FontMatrix */
      result = T1_ToFixedArray( parser, 6, temp, 3 );
  
      if ( result < 6 )
      {
        parser->root.error = FT_THROW( Invalid_File_Format );
        return;
      }
  
      FT_TRACE4(( " [%f %f %f %f %f %f]\n",
                  (double)temp[0] / 65536 / 1000,
                  (double)temp[1] / 65536 / 1000,
                  (double)temp[2] / 65536 / 1000,
                  (double)temp[3] / 65536 / 1000,
                  (double)temp[4] / 65536 / 1000,
                  (double)temp[5] / 65536 / 1000 ));
  
      temp_scale = FT_ABS( temp[3] );
  
      if ( temp_scale == 0 )
      {
        FT_ERROR(( "t1_parse_font_matrix: invalid font matrix\n" ));
        parser->root.error = FT_THROW( Invalid_File_Format );
        return;
      }
  
      /* atypical case */
      if ( temp_scale != 0x10000L )
      {
        /* set units per EM based on FontMatrix values */
        root->units_per_EM = (FT_UShort)FT_DivFix( 1000, temp_scale );
  
        temp[0] = FT_DivFix( temp[0], temp_scale );
        temp[1] = FT_DivFix( temp[1], temp_scale );
        temp[2] = FT_DivFix( temp[2], temp_scale );
        temp[4] = FT_DivFix( temp[4], temp_scale );
        temp[5] = FT_DivFix( temp[5], temp_scale );
        temp[3] = temp[3] < 0 ? -0x10000L : 0x10000L;
      }
      matrix->xx = temp[0];
      matrix->yx = temp[1];
      matrix->xy = temp[2];
      matrix->yy = temp[3];
  
      if ( !FT_Matrix_Check( matrix ) )
      {
        FT_ERROR(( "t1_parse_font_matrix: invalid font matrix\n" ));
        parser->root.error = FT_THROW( Invalid_File_Format );
        return;
      }
  
      /* note that the offsets must be expressed in integer font units */
      offset->x = temp[4] >> 16;
      offset->y = temp[5] >> 16;
    }
  
  
    static void
    parse_encoding( T1_Face    face,
                    T1_Loader  loader )
    {
      T1_Parser  parser = &loader->parser;
      FT_Byte*   cur;
      FT_Byte*   limit  = parser->root.limit;
  
      PSAux_Service  psaux = (PSAux_Service)face->psaux;
  
  
      T1_Skip_Spaces( parser );
      cur = parser->root.cursor;
      if ( cur >= limit )
      {
        FT_ERROR(( "parse_encoding: out of bounds\n" ));
        parser->root.error = FT_THROW( Invalid_File_Format );
        return;
      }
  
      /* if we have a number or `[', the encoding is an array, */
      /* and we must load it now                               */
      if ( ft_isdigit( *cur ) || *cur == '[' )
      {
        T1_Encoding  encode          = &face->type1.encoding;
        FT_Int       count, array_size, n;
        PS_Table     char_table      = &loader->encoding_table;
        FT_Memory    memory          = parser->root.memory;
        FT_Error     error;
        FT_Bool      only_immediates = 0;
  
  
        /* read the number of entries in the encoding; should be 256 */
        if ( *cur == '[' )
        {
          count           = 256;
          only_immediates = 1;
          parser->root.cursor++;
        }
        else
          count = (FT_Int)T1_ToInt( parser );
  
        array_size = count;
        if ( count > 256 )
        {
          FT_TRACE2(( "parse_encoding:"
                      " only using first 256 encoding array entries\n" ));
          array_size = 256;
        }
  
        T1_Skip_Spaces( parser );
        if ( parser->root.cursor >= limit )
          return;
  
        /* PostScript happily allows overwriting of encoding arrays */
        if ( encode->char_index )
        {
          FT_FREE( encode->char_index );
          FT_FREE( encode->char_name );
          T1_Release_Table( char_table );
        }
  
        /* we use a T1_Table to store our charnames */
        loader->num_chars = encode->num_chars = array_size;
        if ( FT_QNEW_ARRAY( encode->char_index, array_size )    ||
             FT_QNEW_ARRAY( encode->char_name,  array_size )    ||
             FT_SET_ERROR( psaux->ps_table_funcs->init(
                             char_table, array_size, memory ) ) )
        {
          parser->root.error = error;
          return;
        }
  
        /* We need to `zero' out encoding_table.elements */
        for ( n = 0; n < array_size; n++ )
          (void)T1_Add_Table( char_table, n, ".notdef", 8 );
  
        /* Now we need to read records of the form                */
        /*                                                        */
        /*   ... charcode /charname ...                           */
        /*                                                        */
        /* for each entry in our table.                           */
        /*                                                        */
        /* We simply look for a number followed by an immediate   */
        /* name.  Note that this ignores correctly the sequence   */
        /* that is often seen in type1 fonts:                     */
        /*                                                        */
        /*   0 1 255 { 1 index exch /.notdef put } for dup        */
        /*                                                        */
        /* used to clean the encoding array before anything else. */
        /*                                                        */
        /* Alternatively, if the array is directly given as       */
        /*                                                        */
        /*   /Encoding [ ... ]                                    */
        /*                                                        */
        /* we only read immediates.                               */
  
        n = 0;
        T1_Skip_Spaces( parser );
  
        while ( parser->root.cursor < limit )
        {
          cur = parser->root.cursor;
  
          /* we stop when we encounter a `def' or `]' */
          if ( *cur == 'd' && cur + 3 < limit )
          {
            if ( cur[1] == 'e'         &&
                 cur[2] == 'f'         &&
                 IS_PS_DELIM( cur[3] ) )
            {
              FT_TRACE6(( "encoding end\n" ));
              cur += 3;
              break;
            }
          }
          if ( *cur == ']' )
          {
            FT_TRACE6(( "encoding end\n" ));
            cur++;
            break;
          }
  
          /* check whether we've found an entry */
          if ( ft_isdigit( *cur ) || only_immediates )
          {
            FT_Int  charcode;
  
  
            if ( only_immediates )
              charcode = n;
            else
            {
              charcode = (FT_Int)T1_ToInt( parser );
              T1_Skip_Spaces( parser );
  
              /* protect against invalid charcode */
              if ( cur == parser->root.cursor )
              {
                parser->root.error = FT_THROW( Unknown_File_Format );
                return;
              }
            }
  
            cur = parser->root.cursor;
  
            if ( cur + 2 < limit && *cur == '/' && n < count )
            {
              FT_UInt  len;
  
  
              cur++;
  
              parser->root.cursor = cur;
              T1_Skip_PS_Token( parser );
              if ( parser->root.cursor >= limit )
                return;
              if ( parser->root.error )
                return;
  
              len = (FT_UInt)( parser->root.cursor - cur );
  
              if ( n < array_size )
              {
                parser->root.error = T1_Add_Table( char_table, charcode,
                                                   cur, len + 1 );
                if ( parser->root.error )
                  return;
                char_table->elements[charcode][len] = '\0';
              }
  
              n++;
            }
            else if ( only_immediates )
            {
              /* Since the current position is not updated for           */
              /* immediates-only mode we would get an infinite loop if   */
              /* we don't do anything here.                              */
              /*                                                         */
              /* This encoding array is not valid according to the type1 */
              /* specification (it might be an encoding for a CID type1  */
              /* font, however), so we conclude that this font is NOT a  */
              /* type1 font.                                             */
              parser->root.error = FT_THROW( Unknown_File_Format );
              return;
            }
          }
          else
          {
            T1_Skip_PS_Token( parser );
            if ( parser->root.error )
              return;
          }
  
          T1_Skip_Spaces( parser );
        }
  
  #ifdef FT_DEBUG_LEVEL_TRACE
        FT_TRACE4(( " [" ));
  
        /* XXX show encoding vector */
        FT_TRACE4(( "..." ));
  
        FT_TRACE4(( "]\n" ));
  #endif
  
        face->type1.encoding_type = T1_ENCODING_TYPE_ARRAY;
        parser->root.cursor       = cur;
      }
  
      /* Otherwise, we should have either `StandardEncoding', */
      /* `ExpertEncoding', or `ISOLatin1Encoding'             */
      else
      {
        if ( cur + 17 < limit                                            &&
             ft_strncmp( (const char*)cur, "StandardEncoding", 16 ) == 0 )
        {
          face->type1.encoding_type = T1_ENCODING_TYPE_STANDARD;
          FT_TRACE4(( " StandardEncoding\n" ));
        }
  
        else if ( cur + 15 < limit                                          &&
                  ft_strncmp( (const char*)cur, "ExpertEncoding", 14 ) == 0 )
        {
          face->type1.encoding_type = T1_ENCODING_TYPE_EXPERT;
          FT_TRACE4(( " ExpertEncoding\n" ));
        }
  
        else if ( cur + 18 < limit                                             &&
                  ft_strncmp( (const char*)cur, "ISOLatin1Encoding", 17 ) == 0 )
        {
          face->type1.encoding_type = T1_ENCODING_TYPE_ISOLATIN1;
          FT_TRACE4(( " ISOLatin1Encoding\n" ));
        }
  
        else
        {
          parser->root.error = FT_ERR( Ignore );
          FT_TRACE4(( "<unknown>\n" ));
        }
      }
    }
  
  
    static void
    parse_subrs( T1_Face    face,
                 T1_Loader  loader )
    {
      T1_Parser  parser = &loader->parser;
      PS_Table   table  = &loader->subrs;
      FT_Memory  memory = parser->root.memory;
      FT_Error   error;
      FT_Int     num_subrs;
      FT_UInt    count;
  
      PSAux_Service  psaux = (PSAux_Service)face->psaux;
  
  
      T1_Skip_Spaces( parser );
  
      /* test for empty array */
      if ( parser->root.cursor < parser->root.limit &&
           *parser->root.cursor == '['              )
      {
        T1_Skip_PS_Token( parser );
        T1_Skip_Spaces  ( parser );
        if ( parser->root.cursor >= parser->root.limit ||
             *parser->root.cursor != ']'               )
          parser->root.error = FT_THROW( Invalid_File_Format );
        return;
      }
  
      num_subrs = (FT_Int)T1_ToInt( parser );
      if ( num_subrs < 0 )
      {
        parser->root.error = FT_THROW( Invalid_File_Format );
        return;
      }
  
      /* we certainly need more than 8 bytes per subroutine */
      if ( parser->root.limit >= parser->root.cursor                     &&
           num_subrs > ( parser->root.limit - parser->root.cursor ) >> 3 )
      {
        /*
         * There are two possibilities.  Either the font contains an invalid
         * value for `num_subrs', or we have a subsetted font where the
         * subroutine indices are not adjusted, e.g.
         *
         *   /Subrs 812 array
         *     dup 0 { ... } NP
         *     dup 51 { ... } NP
         *     dup 681 { ... } NP
         *   ND
         *
         * In both cases, we use a number hash that maps from subr indices to
         * actual array elements.
         */
  
        FT_TRACE0(( "parse_subrs: adjusting number of subroutines"
                    " (from %d to %ld)\n",
                    num_subrs,
                    ( parser->root.limit - parser->root.cursor ) >> 3 ));
        num_subrs = ( parser->root.limit - parser->root.cursor ) >> 3;
  
        if ( !loader->subrs_hash )
        {
          if ( FT_QNEW( loader->subrs_hash ) )
            goto Fail;
  
          error = ft_hash_num_init( loader->subrs_hash, memory );
          if ( error )
            goto Fail;
        }
      }
  
      /* position the parser right before the `dup' of the first subr */
      T1_Skip_PS_Token( parser );         /* `array' */
      if ( parser->root.error )
        return;
      T1_Skip_Spaces( parser );
  
      /* initialize subrs array -- with synthetic fonts it is possible */
      /* we get here twice                                             */
      if ( !loader->num_subrs )
      {
        error = psaux->ps_table_funcs->init( table, num_subrs, memory );
        if ( error )
          goto Fail;
      }
  
      /* the format is simple:   */
      /*                         */
      /*   `index' + binary data */
      /*                         */
      for ( count = 0; ; count++ )
      {
        FT_Long   idx;
        FT_ULong  size;
        FT_Byte*  base;
  
  
        /* If we are out of data, or if the next token isn't `dup', */
        /* we are done.                                             */
        if ( parser->root.cursor + 4 >= parser->root.limit          ||
            ft_strncmp( (char*)parser->root.cursor, "dup", 3 ) != 0 )
          break;
  
        T1_Skip_PS_Token( parser );       /* `dup' */
  
        idx = T1_ToInt( parser );
  
        if ( !read_binary_data( parser, &size, &base, IS_INCREMENTAL ) )
          return;
  
        /* The binary string is followed by one token, e.g. `NP' */
        /* (bound to `noaccess put') or by two separate tokens:  */
        /* `noaccess' & `put'.  We position the parser right     */
        /* before the next `dup', if any.                        */
        T1_Skip_PS_Token( parser );   /* `NP' or `|' or `noaccess' */
        if ( parser->root.error )
          return;
        T1_Skip_Spaces  ( parser );
  
        if ( parser->root.cursor + 4 < parser->root.limit            &&
             ft_strncmp( (char*)parser->root.cursor, "put", 3 ) == 0 )
        {
          T1_Skip_PS_Token( parser ); /* skip `put' */
          T1_Skip_Spaces  ( parser );
        }
  
        /* if we use a hash, the subrs index is the key, and a running */
        /* counter specified for `T1_Add_Table' acts as the value      */
        if ( loader->subrs_hash )
        {
          ft_hash_num_insert( idx, count, loader->subrs_hash, memory );
          idx = count;
        }
  
        /* with synthetic fonts it is possible we get here twice */
        if ( loader->num_subrs )
          continue;
  
        /* some fonts use a value of -1 for lenIV to indicate that */
        /* the charstrings are unencoded                           */
        /*                                                         */
        /* thanks to Tom Kacvinsky for pointing this out           */
        /*                                                         */
        if ( face->type1.private_dict.lenIV >= 0 )
        {
          FT_Byte*  temp = NULL;
  
  
          /* some fonts define empty subr records -- this is not totally */
          /* compliant to the specification (which says they should at   */
          /* least contain a `return'), but we support them anyway       */
          if ( size < (FT_ULong)face->type1.private_dict.lenIV )
          {
            error = FT_THROW( Invalid_File_Format );
            goto Fail;
          }
  
          /* t1_decrypt() shouldn't write to base -- make temporary copy */
          if ( FT_QALLOC( temp, size ) )
            goto Fail;
          FT_MEM_COPY( temp, base, size );
          psaux->t1_decrypt( temp, size, 4330 );
          size -= (FT_ULong)face->type1.private_dict.lenIV;
          error = T1_Add_Table( table, (FT_Int)idx,
                                temp + face->type1.private_dict.lenIV, size );
          FT_FREE( temp );
        }
        else
          error = T1_Add_Table( table, (FT_Int)idx, base, size );
        if ( error )
          goto Fail;
      }
  
      if ( !loader->num_subrs )
        loader->num_subrs = num_subrs;
  
  #ifdef FT_DEBUG_LEVEL_TRACE
        FT_TRACE4(( " <" ));
  
        /* XXX show subrs? */
        FT_TRACE4(( "%d elements", num_subrs ));
  
        FT_TRACE4(( ">\n" ));
  #endif
  
      return;
  
    Fail:
      parser->root.error = error;
    }
  
  
  #define TABLE_EXTEND  5
  
  
    static void
    parse_charstrings( T1_Face    face,
                       T1_Loader  loader )
    {
      T1_Parser      parser       = &loader->parser;
      PS_Table       code_table   = &loader->charstrings;
      PS_Table       name_table   = &loader->glyph_names;
      PS_Table       swap_table   = &loader->swap_table;
      FT_Memory      memory       = parser->root.memory;
      FT_Error       error;
  
      PSAux_Service  psaux        = (PSAux_Service)face->psaux;
  
      FT_Byte*       cur          = parser->root.cursor;
      FT_Byte*       limit        = parser->root.limit;
      FT_Int         n, num_glyphs;
      FT_Int         notdef_index = 0;
      FT_Byte        notdef_found = 0;
  
  
      num_glyphs = (FT_Int)T1_ToInt( parser );
      if ( num_glyphs < 0 )
      {
        error = FT_THROW( Invalid_File_Format );
        goto Fail;
      }
  
      /* we certainly need more than 8 bytes per glyph */
      if ( num_glyphs > ( limit - cur ) >> 3 )
      {
        FT_TRACE0(( "parse_charstrings: adjusting number of glyphs"
                    " (from %d to %ld)\n",
                    num_glyphs, ( limit - cur ) >> 3 ));
        num_glyphs = ( limit - cur ) >> 3;
      }
  
      /* some fonts like Optima-Oblique not only define the /CharStrings */
      /* array but access it also                                        */
      if ( num_glyphs == 0 || parser->root.error )
        return;
  
      /* initialize tables, leaving space for addition of .notdef, */
      /* if necessary, and a few other glyphs to handle buggy      */
      /* fonts which have more glyphs than specified.              */
  
      /* for some non-standard fonts like `Optima' which provides  */
      /* different outlines depending on the resolution it is      */
      /* possible to get here twice                                */
      if ( !loader->num_glyphs )
      {
        error = psaux->ps_table_funcs->init(
                  code_table, num_glyphs + 1 + TABLE_EXTEND, memory );
        if ( error )
          goto Fail;
  
        error = psaux->ps_table_funcs->init(
                  name_table, num_glyphs + 1 + TABLE_EXTEND, memory );
        if ( error )
          goto Fail;
  
        /* Initialize table for swapping index notdef_index and */
        /* index 0 names and codes (if necessary).              */
  
        error = psaux->ps_table_funcs->init( swap_table, 4, memory );
        if ( error )
          goto Fail;
      }
  
      n = 0;
  
      for (;;)
      {
        FT_ULong  size;
        FT_Byte*  base;
  
  
        /* the format is simple:        */
        /*   `/glyphname' + binary data */
  
        T1_Skip_Spaces( parser );
  
        cur = parser->root.cursor;
        if ( cur >= limit )
          break;
  
        /* we stop when we find a `def' or `end' keyword */
        if ( cur + 3 < limit && IS_PS_DELIM( cur[3] ) )
        {
          if ( cur[0] == 'd' &&
               cur[1] == 'e' &&
               cur[2] == 'f' )
          {
            /* There are fonts which have this: */
            /*                                  */
            /*   /CharStrings 118 dict def      */
            /*   Private begin                  */
            /*   CharStrings begin              */
            /*   ...                            */
            /*                                  */
            /* To catch this we ignore `def' if */
            /* no charstring has actually been  */
            /* seen.                            */
            if ( n )
              break;
          }
  
          if ( cur[0] == 'e' &&
               cur[1] == 'n' &&
               cur[2] == 'd' )
            break;
        }
  
        T1_Skip_PS_Token( parser );
        if ( parser->root.cursor >= limit )
        {
          error = FT_THROW( Invalid_File_Format );
          goto Fail;
        }
        if ( parser->root.error )
          return;
  
        if ( *cur == '/' )
        {
          FT_UInt  len;
  
  
          if ( cur + 2 >= limit )
          {
            error = FT_THROW( Invalid_File_Format );
            goto Fail;
          }
  
          cur++;                              /* skip `/' */
          len = (FT_UInt)( parser->root.cursor - cur );
  
          if ( !read_binary_data( parser, &size, &base, IS_INCREMENTAL ) )
            return;
  
          /* for some non-standard fonts like `Optima' which provides */
          /* different outlines depending on the resolution it is     */
          /* possible to get here twice                               */
          if ( loader->num_glyphs )
            continue;
  
          error = T1_Add_Table( name_table, n, cur, len + 1 );
          if ( error )
            goto Fail;
  
          /* add a trailing zero to the name table */
          name_table->elements[n][len] = '\0';
  
          /* record index of /.notdef */
          if ( *cur == '.'                                                &&
               ft_strcmp( ".notdef",
                          (const char*)( name_table->elements[n] ) ) == 0 )
          {
            notdef_index = n;
            notdef_found = 1;
          }
  
          if ( face->type1.private_dict.lenIV >= 0 &&
               n < num_glyphs + TABLE_EXTEND       )
          {
            FT_Byte*  temp = NULL;
  
  
            if ( size <= (FT_ULong)face->type1.private_dict.lenIV )
            {
              error = FT_THROW( Invalid_File_Format );
              goto Fail;
            }
  
            /* t1_decrypt() shouldn't write to base -- make temporary copy */
            if ( FT_QALLOC( temp, size ) )
              goto Fail;
            FT_MEM_COPY( temp, base, size );
            psaux->t1_decrypt( temp, size, 4330 );
            size -= (FT_ULong)face->type1.private_dict.lenIV;
            error = T1_Add_Table( code_table, n,
                                  temp + face->type1.private_dict.lenIV, size );
            FT_FREE( temp );
          }
          else
            error = T1_Add_Table( code_table, n, base, size );
          if ( error )
            goto Fail;
  
          n++;
        }
      }
  
      if ( !n )
      {
        error = FT_THROW( Invalid_File_Format );
        goto Fail;
      }
  
      loader->num_glyphs = n;
  
      /* if /.notdef is found but does not occupy index 0, do our magic. */
      if ( notdef_found                                                 &&
           ft_strcmp( ".notdef", (const char*)name_table->elements[0] ) )
      {
        /* Swap glyph in index 0 with /.notdef glyph.  First, add index 0  */
        /* name and code entries to swap_table.  Then place notdef_index   */
        /* name and code entries into swap_table.  Then swap name and code */
        /* entries at indices notdef_index and 0 using values stored in    */
        /* swap_table.                                                     */
  
        /* Index 0 name */
        error = T1_Add_Table( swap_table, 0,
                              name_table->elements[0],
                              name_table->lengths [0] );
        if ( error )
          goto Fail;
  
        /* Index 0 code */
        error = T1_Add_Table( swap_table, 1,
                              code_table->elements[0],
                              code_table->lengths [0] );
        if ( error )
          goto Fail;
  
        /* Index notdef_index name */
        error = T1_Add_Table( swap_table, 2,
                              name_table->elements[notdef_index],
                              name_table->lengths [notdef_index] );
        if ( error )
          goto Fail;
  
        /* Index notdef_index code */
        error = T1_Add_Table( swap_table, 3,
                              code_table->elements[notdef_index],
                              code_table->lengths [notdef_index] );
        if ( error )
          goto Fail;
  
        error = T1_Add_Table( name_table, notdef_index,
                              swap_table->elements[0],
                              swap_table->lengths [0] );
        if ( error )
          goto Fail;
  
        error = T1_Add_Table( code_table, notdef_index,
                              swap_table->elements[1],
                              swap_table->lengths [1] );
        if ( error )
          goto Fail;
  
        error = T1_Add_Table( name_table, 0,
                              swap_table->elements[2],
                              swap_table->lengths [2] );
        if ( error )
          goto Fail;
  
        error = T1_Add_Table( code_table, 0,
                              swap_table->elements[3],
                              swap_table->lengths [3] );
        if ( error )
          goto Fail;
  
      }
      else if ( !notdef_found )
      {
        /* notdef_index is already 0, or /.notdef is undefined in   */
        /* charstrings dictionary.  Worry about /.notdef undefined. */
        /* We take index 0 and add it to the end of the table(s)    */
        /* and add our own /.notdef glyph to index 0.               */
  
        /* 0 333 hsbw endchar */
        FT_Byte  notdef_glyph[] = { 0x8B, 0xF7, 0xE1, 0x0D, 0x0E };
  
  
        error = T1_Add_Table( swap_table, 0,
                              name_table->elements[0],
                              name_table->lengths [0] );
        if ( error )
          goto Fail;
  
        error = T1_Add_Table( swap_table, 1,
                              code_table->elements[0],
                              code_table->lengths [0] );
        if ( error )
          goto Fail;
  
        error = T1_Add_Table( name_table, 0, ".notdef", 8 );
        if ( error )
          goto Fail;
  
        error = T1_Add_Table( code_table, 0, notdef_glyph, 5 );
  
        if ( error )
          goto Fail;
  
        error = T1_Add_Table( name_table, n,
                              swap_table->elements[0],
                              swap_table->lengths [0] );
        if ( error )
          goto Fail;
  
        error = T1_Add_Table( code_table, n,
                              swap_table->elements[1],
                              swap_table->lengths [1] );
        if ( error )
          goto Fail;
  
        /* we added a glyph. */
        loader->num_glyphs += 1;
      }
  
  #ifdef FT_DEBUG_LEVEL_TRACE
        FT_TRACE4(( " <" ));
  
        /* XXX show charstrings? */
        FT_TRACE4(( "%d elements", loader->num_glyphs ));
  
        FT_TRACE4(( ">\n" ));
  #endif
  
      return;
  
    Fail:
      parser->root.error = error;
    }
  
  
    /**************************************************************************
     *
     * Define the token field static variables.  This is a set of
     * T1_FieldRec variables.
     *
     */
  
  
    static
    const T1_FieldRec  t1_keywords[] =
    {
  
  #include "t1tokens.h"
  
      /* now add the special functions... */
      T1_FIELD_CALLBACK( "FontMatrix",           t1_parse_font_matrix,
                         T1_FIELD_DICT_FONTDICT )
      T1_FIELD_CALLBACK( "Encoding",             parse_encoding,
                         T1_FIELD_DICT_FONTDICT )
      T1_FIELD_CALLBACK( "Subrs",                parse_subrs,
                         T1_FIELD_DICT_PRIVATE )
      T1_FIELD_CALLBACK( "CharStrings",          parse_charstrings,
                         T1_FIELD_DICT_PRIVATE )
      T1_FIELD_CALLBACK( "Private",              parse_private,
                         T1_FIELD_DICT_FONTDICT )
  
  #ifndef T1_CONFIG_OPTION_NO_MM_SUPPORT
      T1_FIELD_CALLBACK( "BlendDesignPositions", parse_blend_design_positions,
                         T1_FIELD_DICT_FONTDICT )
      T1_FIELD_CALLBACK( "BlendDesignMap",       parse_blend_design_map,
                         T1_FIELD_DICT_FONTDICT )
      T1_FIELD_CALLBACK( "BlendAxisTypes",       parse_blend_axis_types,
                         T1_FIELD_DICT_FONTDICT )
      T1_FIELD_CALLBACK( "WeightVector",         parse_weight_vector,
                         T1_FIELD_DICT_FONTDICT )
      T1_FIELD_CALLBACK( "BuildCharArray",       parse_buildchar,
                         T1_FIELD_DICT_PRIVATE )
  #endif
  
      { 0, T1_FIELD_LOCATION_CID_INFO, T1_FIELD_TYPE_NONE, 0, 0, 0, 0, 0, 0 }
    };
  
  
    static FT_Error
    parse_dict( T1_Face    face,
                T1_Loader  loader,
                FT_Byte*   base,
                FT_ULong   size )
    {
      T1_Parser  parser = &loader->parser;
      FT_Byte   *limit, *start_binary = NULL;
      FT_Bool    have_integer = 0;
  
  
      parser->root.cursor = base;
      parser->root.limit  = base + size;
      parser->root.error  = FT_Err_Ok;
  
      limit = parser->root.limit;
  
      T1_Skip_Spaces( parser );
  
      while ( parser->root.cursor < limit )
      {
        FT_Byte*  cur;
  
  
        cur = parser->root.cursor;
  
        /* look for `eexec' */
        if ( IS_PS_TOKEN( cur, limit, "eexec" ) )
          break;
  
        /* look for `closefile' which ends the eexec section */
        else if ( IS_PS_TOKEN( cur, limit, "closefile" ) )
          break;
  
        /* in a synthetic font the base font starts after a           */
        /* `FontDictionary' token that is placed after a Private dict */
        else if ( IS_PS_TOKEN( cur, limit, "FontDirectory" ) )
        {
          if ( loader->keywords_encountered & T1_PRIVATE )
            loader->keywords_encountered |=
              T1_FONTDIR_AFTER_PRIVATE;
          parser->root.cursor += 13;
        }
  
        /* check whether we have an integer */
        else if ( ft_isdigit( *cur ) )
        {
          start_binary = cur;
          T1_Skip_PS_Token( parser );
          if ( parser->root.error )
            goto Exit;
          have_integer = 1;
        }
  
        /* in valid Type 1 fonts we don't see `RD' or `-|' directly */
        /* since those tokens are handled by parse_subrs and        */
        /* parse_charstrings                                        */
        else if ( *cur == 'R' && cur + 6 < limit && *( cur + 1 ) == 'D' &&
                  have_integer                                          )
        {
          FT_ULong  s;
          FT_Byte*  b;
  
  
          parser->root.cursor = start_binary;
          if ( !read_binary_data( parser, &s, &b, IS_INCREMENTAL ) )
            return FT_THROW( Invalid_File_Format );
          have_integer = 0;
        }
  
        else if ( *cur == '-' && cur + 6 < limit && *( cur + 1 ) == '|' &&
                  have_integer                                          )
        {
          FT_ULong  s;
          FT_Byte*  b;
  
  
          parser->root.cursor = start_binary;
          if ( !read_binary_data( parser, &s, &b, IS_INCREMENTAL ) )
            return FT_THROW( Invalid_File_Format );
          have_integer = 0;
        }
  
        /* look for immediates */
        else if ( *cur == '/' && cur + 2 < limit )
        {
          FT_UInt  len;
  
  
          cur++;
  
          parser->root.cursor = cur;
          T1_Skip_PS_Token( parser );
          if ( parser->root.error )
            goto Exit;
  
          len = (FT_UInt)( parser->root.cursor - cur );
  
          if ( len > 0 && len < 22 && parser->root.cursor < limit )
          {
            /* now compare the immediate name to the keyword table */
            T1_Field  keyword = (T1_Field)t1_keywords;
  
  
            for (;;)
            {
              FT_Byte*  name;
  
  
              name = (FT_Byte*)keyword->ident;
              if ( !name )
                break;
  
              if ( cur[0] == name[0]                      &&
                   len == ft_strlen( (const char *)name ) &&
                   ft_memcmp( cur, name, len ) == 0       )
              {
                /* We found it -- run the parsing callback!     */
                /* We record every instance of every field      */
                /* (until we reach the base font of a           */
                /* synthetic font) to deal adequately with      */
                /* multiple master fonts; this is also          */
                /* necessary because later PostScript           */
                /* definitions override earlier ones.           */
  
                /* Once we encounter `FontDirectory' after      */
                /* `/Private', we know that this is a synthetic */
                /* font; except for `/CharStrings' we are not   */
                /* interested in anything that follows this     */
                /* `FontDirectory'.                             */
  
                /* MM fonts have more than one /Private token at */
                /* the top level; let's hope that all the junk   */
                /* that follows the first /Private token is not  */
                /* interesting to us.                            */
  
                /* According to Adobe Tech Note #5175 (CID-Keyed */
                /* Font Installation for ATM Software) a `begin' */
                /* must be followed by exactly one `end', and    */
                /* `begin' -- `end' pairs must be accurately     */
                /* paired.  We could use this to distinguish     */
                /* between the global Private and the Private    */
                /* dict that is a member of the Blend dict.      */
  
                const FT_UInt dict =
                  ( loader->keywords_encountered & T1_PRIVATE )
                      ? T1_FIELD_DICT_PRIVATE
                      : T1_FIELD_DICT_FONTDICT;
  
  
                if ( !( dict & keyword->dict ) )
                {
                  FT_TRACE1(( "parse_dict: found `%s' but ignoring it"
                              " since it is in the wrong dictionary\n",
                              keyword->ident ));
                  break;
                }
  
                if ( !( loader->keywords_encountered &
                        T1_FONTDIR_AFTER_PRIVATE     )                  ||
                     ft_strcmp( (const char*)name, "CharStrings" ) == 0 )
                {
                  parser->root.error = t1_load_keyword( face,
                                                        loader,
                                                        keyword );
                  if ( parser->root.error )
                  {
                    if ( FT_ERR_EQ( parser->root.error, Ignore ) )
                      parser->root.error = FT_Err_Ok;
                    else
                      return parser->root.error;
                  }
                }
                break;
              }
  
              keyword++;
            }
          }
  
          have_integer = 0;
        }
        else
        {
          T1_Skip_PS_Token( parser );
          if ( parser->root.error )
            goto Exit;
          have_integer = 0;
        }
  
        T1_Skip_Spaces( parser );
      }
  
    Exit:
      return parser->root.error;
    }
  
  
    static void
    t1_init_loader( T1_Loader  loader,
                    T1_Face    face )
    {
      FT_UNUSED( face );
  
      FT_ZERO( loader );
    }
  
  
    static void
    t1_done_loader( T1_Loader  loader )
    {
      T1_Parser  parser = &loader->parser;
      FT_Memory  memory = parser->root.memory;
  
  
      /* finalize tables */
      T1_Release_Table( &loader->encoding_table );
      T1_Release_Table( &loader->charstrings );
      T1_Release_Table( &loader->glyph_names );
      T1_Release_Table( &loader->swap_table );
      T1_Release_Table( &loader->subrs );
  
      /* finalize hash */
      ft_hash_num_free( loader->subrs_hash, memory );
      FT_FREE( loader->subrs_hash );
  
      /* finalize parser */
      T1_Finalize_Parser( parser );
    }
  
  
    FT_LOCAL_DEF( FT_Error )
    T1_Open_Face( T1_Face  face )
    {
      T1_LoaderRec   loader;
      T1_Parser      parser;
      T1_Font        type1 = &face->type1;
      PS_Private     priv  = &type1->private_dict;
      FT_Error       error;
  
      PSAux_Service  psaux = (PSAux_Service)face->psaux;
  
  
      t1_init_loader( &loader, face );
  
      /* default values */
      face->ndv_idx          = -1;
      face->cdv_idx          = -1;
      face->len_buildchar    = 0;
  
      priv->blue_shift       = 7;
      priv->blue_fuzz        = 1;
      priv->lenIV            = 4;
      priv->expansion_factor = (FT_Fixed)( 0.06 * 0x10000L );
      priv->blue_scale       = (FT_Fixed)( 0.039625 * 0x10000L * 1000 );
  
      parser = &loader.parser;
      error  = T1_New_Parser( parser,
                              face->root.stream,
                              face->root.memory,
                              psaux );
      if ( error )
        goto Exit;
  
      FT_TRACE4(( " top dictionary:\n" ));
      error = parse_dict( face, &loader,
                          parser->base_dict, parser->base_len );
      if ( error )
        goto Exit;
  
      error = T1_Get_Private_Dict( parser, psaux );
      if ( error )
        goto Exit;
  
      FT_TRACE4(( " private dictionary:\n" ));
      error = parse_dict( face, &loader,
                          parser->private_dict, parser->private_len );
      if ( error )
        goto Exit;
  
      /* ensure even-ness of `num_blue_values' */
      priv->num_blue_values &= ~1;
  
  #ifndef T1_CONFIG_OPTION_NO_MM_SUPPORT
  
      /* we don't support Multiple Master fonts with intermediate designs; */
      /* this implies that `num_designs' must be equal to `2^^num_axis'    */
      if ( face->blend                                                 &&
           face->blend->num_designs != ( 1U << face->blend->num_axis ) )
      {
        FT_ERROR(( "T1_Open_Face:"
                   " number-of-designs != 2 ^^ number-of-axes\n" ));
        T1_Done_Blend( face );
      }
  
      if ( face->blend                                                     &&
           face->blend->num_default_design_vector != 0                     &&
           face->blend->num_default_design_vector != face->blend->num_axis )
      {
        /* we don't use it currently so just warn, reset, and ignore */
        FT_ERROR(( "T1_Open_Face(): /DesignVector contains %u entries "
                   "while there are %u axes.\n",
                   face->blend->num_default_design_vector,
                   face->blend->num_axis ));
  
        face->blend->num_default_design_vector = 0;
      }
  
      /* the following can happen for MM instances; we then treat the */
      /* font as a normal PS font                                     */
      if ( face->blend                                             &&
           ( !face->blend->num_designs || !face->blend->num_axis ) )
        T1_Done_Blend( face );
  
      /* the font may have no valid WeightVector */
      if ( face->blend && !face->blend->weight_vector )
        T1_Done_Blend( face );
  
      /* the font may have no valid BlendDesignPositions */
      if ( face->blend && !face->blend->design_pos[0] )
        T1_Done_Blend( face );
  
      /* the font may have no valid BlendDesignMap */
      if ( face->blend )
      {
        FT_UInt  i;
  
  
        for ( i = 0; i < face->blend->num_axis; i++ )
          if ( !face->blend->design_map[i].num_points )
          {
            T1_Done_Blend( face );
            break;
          }
      }
  
      if ( face->blend )
      {
        if ( face->len_buildchar > 0 )
        {
          FT_Memory  memory = face->root.memory;
  
  
          if ( FT_NEW_ARRAY( face->buildchar, face->len_buildchar ) )
          {
            FT_ERROR(( "T1_Open_Face: cannot allocate BuildCharArray\n" ));
            face->len_buildchar = 0;
            goto Exit;
          }
        }
      }
      else
        face->len_buildchar = 0;
  
  #endif /* !T1_CONFIG_OPTION_NO_MM_SUPPORT */
  
      /* now, propagate the subrs, charstrings, and glyphnames tables */
      /* to the Type1 data                                            */
      type1->num_glyphs = loader.num_glyphs;
  
      if ( loader.subrs.init )
      {
        type1->num_subrs   = loader.num_subrs;
        type1->subrs_block = loader.subrs.block;
        type1->subrs       = loader.subrs.elements;
        type1->subrs_len   = loader.subrs.lengths;
        type1->subrs_hash  = loader.subrs_hash;
  
        /* prevent `t1_done_loader' from freeing the propagated data */
        loader.subrs.init = 0;
        loader.subrs_hash = NULL;
      }
  
      if ( !IS_INCREMENTAL )
        if ( !loader.charstrings.init )
        {
          FT_ERROR(( "T1_Open_Face: no `/CharStrings' array in face\n" ));
          error = FT_THROW( Invalid_File_Format );
        }
  
      loader.charstrings.init  = 0;
      type1->charstrings_block = loader.charstrings.block;
      type1->charstrings       = loader.charstrings.elements;
      type1->charstrings_len   = loader.charstrings.lengths;
  
      /* we copy the glyph names `block' and `elements' fields; */
      /* the `lengths' field must be released later             */
      type1->glyph_names_block    = loader.glyph_names.block;
      type1->glyph_names          = (FT_String**)loader.glyph_names.elements;
      loader.glyph_names.block    = NULL;
      loader.glyph_names.elements = NULL;
  
      /* we must now build type1.encoding when we have a custom array */
      if ( type1->encoding_type == T1_ENCODING_TYPE_ARRAY )
      {
        FT_Int  charcode, idx, min_char, max_char;
  
  
        /* OK, we do the following: for each element in the encoding  */
        /* table, look up the index of the glyph having the same name */
        /* the index is then stored in type1.encoding.char_index, and */
        /* the name to type1.encoding.char_name                       */
  
        min_char = 0;
        max_char = 0;
  
        charcode = 0;
        for ( ; charcode < loader.encoding_table.max_elems; charcode++ )
        {
          const FT_String*  char_name =
                (const FT_String*)loader.encoding_table.elements[charcode];
  
  
          type1->encoding.char_index[charcode] = 0;
          type1->encoding.char_name [charcode] = ".notdef";
  
          if ( char_name )
            for ( idx = 0; idx < type1->num_glyphs; idx++ )
            {
              const FT_String*  glyph_name = type1->glyph_names[idx];
  
  
              if ( ft_strcmp( char_name, glyph_name ) == 0 )
              {
                type1->encoding.char_index[charcode] = (FT_UShort)idx;
                type1->encoding.char_name [charcode] = glyph_name;
  
                /* Change min/max encoded char only if glyph name is */
                /* not /.notdef                                      */
                if ( ft_strcmp( ".notdef", glyph_name ) != 0 )
                {
                  if ( charcode < min_char )
                    min_char = charcode;
                  if ( charcode >= max_char )
                    max_char = charcode + 1;
                }
                break;
              }
            }
        }
  
        type1->encoding.code_first = min_char;
        type1->encoding.code_last  = max_char;
        type1->encoding.num_chars  = loader.num_chars;
      }
  
      /* some sanitizing to avoid overflows later on; */
      /* the upper limits are ad-hoc values           */
      if ( priv->blue_shift > 1000 || priv->blue_shift < 0 )
      {
        FT_TRACE2(( "T1_Open_Face:"
                    " setting unlikely BlueShift value %d to default (7)\n",
                    priv->blue_shift ));
        priv->blue_shift = 7;
      }
  
      if ( priv->blue_fuzz > 1000 || priv->blue_fuzz < 0 )
      {
        FT_TRACE2(( "T1_Open_Face:"
                    " setting unlikely BlueFuzz value %d to default (1)\n",
                    priv->blue_fuzz ));
        priv->blue_fuzz = 1;
      }
  
    Exit:
      t1_done_loader( &loader );
      return error;
    }
  
  
  /* END */
  