sfobjs.c
上传用户:yisoukefu
上传日期:2020-08-09
资源大小:39506k
文件大小:35k
源码类别:

其他游戏

开发平台:

Visual C++

  1. /***************************************************************************/
  2. /*                                                                         */
  3. /*  sfobjs.c                                                               */
  4. /*                                                                         */
  5. /*    SFNT object management (base).                                       */
  6. /*                                                                         */
  7. /*  Copyright 1996-2001, 2002, 2003, 2004, 2005, 2006, 2007 by             */
  8. /*  David Turner, Robert Wilhelm, and Werner Lemberg.                      */
  9. /*                                                                         */
  10. /*  This file is part of the FreeType project, and may only be used,       */
  11. /*  modified, and distributed under the terms of the FreeType project      */
  12. /*  license, LICENSE.TXT.  By continuing to use, modify, or distribute     */
  13. /*  this file you indicate that you have read the license and              */
  14. /*  understand and accept it fully.                                        */
  15. /*                                                                         */
  16. /***************************************************************************/
  17. #include <ft2build.h>
  18. #include "sfobjs.h"
  19. #include "ttload.h"
  20. #include "ttcmap.h"
  21. #include "ttkern.h"
  22. #include FT_INTERNAL_SFNT_H
  23. #include FT_INTERNAL_DEBUG_H
  24. #include FT_TRUETYPE_IDS_H
  25. #include FT_TRUETYPE_TAGS_H
  26. #include FT_SERVICE_POSTSCRIPT_CMAPS_H
  27. #include "sferrors.h"
  28. #ifdef TT_CONFIG_OPTION_BDF
  29. #include "ttbdf.h"
  30. #endif
  31.   /*************************************************************************/
  32.   /*                                                                       */
  33.   /* The macro FT_COMPONENT is used in trace mode.  It is an implicit      */
  34.   /* parameter of the FT_TRACE() and FT_ERROR() macros, used to print/log  */
  35.   /* messages during execution.                                            */
  36.   /*                                                                       */
  37. #undef  FT_COMPONENT
  38. #define FT_COMPONENT  trace_sfobjs
  39.   /* convert a UTF-16 name entry to ASCII */
  40.   static FT_String*
  41.   tt_name_entry_ascii_from_utf16( TT_NameEntry  entry,
  42.                                   FT_Memory     memory )
  43.   {
  44.     FT_String*  string;
  45.     FT_UInt     len, code, n;
  46.     FT_Byte*    read = (FT_Byte*)entry->string;
  47.     FT_Error    error;
  48.     len = (FT_UInt)entry->stringLength / 2;
  49.     if ( FT_NEW_ARRAY( string, len + 1 ) )
  50.       return NULL;
  51.     for ( n = 0; n < len; n++ )
  52.     {
  53.       code = FT_NEXT_USHORT( read );
  54.       if ( code < 32 || code > 127 )
  55.         code = '?';
  56.       string[n] = (char)code;
  57.     }
  58.     string[len] = 0;
  59.     return string;
  60.   }
  61.   /* convert an Apple Roman or symbol name entry to ASCII */
  62.   static FT_String*
  63.   tt_name_entry_ascii_from_other( TT_NameEntry  entry,
  64.                                   FT_Memory     memory )
  65.   {
  66.     FT_String*  string;
  67.     FT_UInt     len, code, n;
  68.     FT_Byte*    read = (FT_Byte*)entry->string;
  69.     FT_Error    error;
  70.     len = (FT_UInt)entry->stringLength;
  71.     if ( FT_NEW_ARRAY( string, len + 1 ) )
  72.       return NULL;
  73.     for ( n = 0; n < len; n++ )
  74.     {
  75.       code = *read++;
  76.       if ( code < 32 || code > 127 )
  77.         code = '?';
  78.       string[n] = (char)code;
  79.     }
  80.     string[len] = 0;
  81.     return string;
  82.   }
  83.   typedef FT_String*  (*TT_NameEntry_ConvertFunc)( TT_NameEntry  entry,
  84.                                                    FT_Memory     memory );
  85.   /*************************************************************************/
  86.   /*                                                                       */
  87.   /* <Function>                                                            */
  88.   /*    tt_face_get_name                                                   */
  89.   /*                                                                       */
  90.   /* <Description>                                                         */
  91.   /*    Returns a given ENGLISH name record in ASCII.                      */
  92.   /*                                                                       */
  93.   /* <Input>                                                               */
  94.   /*    face   :: A handle to the source face object.                      */
  95.   /*                                                                       */
  96.   /*    nameid :: The name id of the name record to return.                */
  97.   /*                                                                       */
  98.   /* <Return>                                                              */
  99.   /*    Character string.  NULL if no name is present.                     */
  100.   /*                                                                       */
  101.   static FT_String*
  102.   tt_face_get_name( TT_Face    face,
  103.                     FT_UShort  nameid )
  104.   {
  105.     FT_Memory         memory = face->root.memory;
  106.     FT_String*        result = NULL;
  107.     FT_UShort         n;
  108.     TT_NameEntryRec*  rec;
  109.     FT_Int            found_apple         = -1;
  110.     FT_Int            found_apple_roman   = -1;
  111.     FT_Int            found_apple_english = -1;
  112.     FT_Int            found_win           = -1;
  113.     FT_Int            found_unicode       = -1;
  114.     FT_Bool           is_english = 0;
  115.     TT_NameEntry_ConvertFunc  convert;
  116.     rec = face->name_table.names;
  117.     for ( n = 0; n < face->num_names; n++, rec++ )
  118.     {
  119.       /* According to the OpenType 1.3 specification, only Microsoft or  */
  120.       /* Apple platform IDs might be used in the `name' table.  The      */
  121.       /* `Unicode' platform is reserved for the `cmap' table, and the    */
  122.       /* `Iso' one is deprecated.                                        */
  123.       /*                                                                 */
  124.       /* However, the Apple TrueType specification doesn't say the same  */
  125.       /* thing and goes to suggest that all Unicode `name' table entries */
  126.       /* should be coded in UTF-16 (in big-endian format I suppose).     */
  127.       /*                                                                 */
  128.       if ( rec->nameID == nameid && rec->stringLength > 0 )
  129.       {
  130.         switch ( rec->platformID )
  131.         {
  132.         case TT_PLATFORM_APPLE_UNICODE:
  133.         case TT_PLATFORM_ISO:
  134.           /* there is `languageID' to check there.  We should use this */
  135.           /* field only as a last solution when nothing else is        */
  136.           /* available.                                                */
  137.           /*                                                           */
  138.           found_unicode = n;
  139.           break;
  140.         case TT_PLATFORM_MACINTOSH:
  141.           /* This is a bit special because some fonts will use either    */
  142.           /* an English language id, or a Roman encoding id, to indicate */
  143.           /* the English version of its font name.                       */
  144.           /*                                                             */
  145.           if ( rec->languageID == TT_MAC_LANGID_ENGLISH )
  146.             found_apple_english = n;
  147.           else if ( rec->encodingID == TT_MAC_ID_ROMAN )
  148.             found_apple_roman = n;
  149.           break;
  150.         case TT_PLATFORM_MICROSOFT:
  151.           /* we only take a non-English name when there is nothing */
  152.           /* else available in the font                            */
  153.           /*                                                       */
  154.           if ( found_win == -1 || ( rec->languageID & 0x3FF ) == 0x009 )
  155.           {
  156.             switch ( rec->encodingID )
  157.             {
  158.             case TT_MS_ID_SYMBOL_CS:
  159.             case TT_MS_ID_UNICODE_CS:
  160.             case TT_MS_ID_UCS_4:
  161.               is_english = FT_BOOL( ( rec->languageID & 0x3FF ) == 0x009 );
  162.               found_win  = n;
  163.               break;
  164.             default:
  165.               ;
  166.             }
  167.           }
  168.           break;
  169.         default:
  170.           ;
  171.         }
  172.       }
  173.     }
  174.     found_apple = found_apple_roman;
  175.     if ( found_apple_english >= 0 )
  176.       found_apple = found_apple_english;
  177.     /* some fonts contain invalid Unicode or Macintosh formatted entries; */
  178.     /* we will thus favor names encoded in Windows formats if available   */
  179.     /* (provided it is an English name)                                   */
  180.     /*                                                                    */
  181.     convert = NULL;
  182.     if ( found_win >= 0 && !( found_apple >= 0 && !is_english ) )
  183.     {
  184.       rec = face->name_table.names + found_win;
  185.       switch ( rec->encodingID )
  186.       {
  187.         /* all Unicode strings are encoded using UTF-16BE */
  188.       case TT_MS_ID_UNICODE_CS:
  189.       case TT_MS_ID_SYMBOL_CS:
  190.         convert = tt_name_entry_ascii_from_utf16;
  191.         break;
  192.       case TT_MS_ID_UCS_4:
  193.         /* Apparently, if this value is found in a name table entry, it is */
  194.         /* documented as `full Unicode repertoire'.  Experience with the   */
  195.         /* MsGothic font shipped with Windows Vista shows that this really */
  196.         /* means UTF-16 encoded names (UCS-4 values are only used within   */
  197.         /* charmaps).                                                      */
  198.         convert = tt_name_entry_ascii_from_utf16;
  199.         break;
  200.       default:
  201.         ;
  202.       }
  203.     }
  204.     else if ( found_apple >= 0 )
  205.     {
  206.       rec     = face->name_table.names + found_apple;
  207.       convert = tt_name_entry_ascii_from_other;
  208.     }
  209.     else if ( found_unicode >= 0 )
  210.     {
  211.       rec     = face->name_table.names + found_unicode;
  212.       convert = tt_name_entry_ascii_from_utf16;
  213.     }
  214.     if ( rec && convert )
  215.     {
  216.       if ( rec->string == NULL )
  217.       {
  218.         FT_Error   error  = SFNT_Err_Ok;
  219.         FT_Stream  stream = face->name_table.stream;
  220.         FT_UNUSED( error );
  221.         if ( FT_QNEW_ARRAY ( rec->string, rec->stringLength ) ||
  222.              FT_STREAM_SEEK( rec->stringOffset )              ||
  223.              FT_STREAM_READ( rec->string, rec->stringLength ) )
  224.         {
  225.           FT_FREE( rec->string );
  226.           rec->stringLength = 0;
  227.           result            = NULL;
  228.           goto Exit;
  229.         }
  230.       }
  231.       result = convert( rec, memory );
  232.     }
  233.   Exit:
  234.     return result;
  235.   }
  236.   static FT_Encoding
  237.   sfnt_find_encoding( int  platform_id,
  238.                       int  encoding_id )
  239.   {
  240.     typedef struct  TEncoding
  241.     {
  242.       int          platform_id;
  243.       int          encoding_id;
  244.       FT_Encoding  encoding;
  245.     } TEncoding;
  246.     static
  247.     const TEncoding  tt_encodings[] =
  248.     {
  249.       { TT_PLATFORM_ISO,           -1,                  FT_ENCODING_UNICODE },
  250.       { TT_PLATFORM_APPLE_UNICODE, -1,                  FT_ENCODING_UNICODE },
  251.       { TT_PLATFORM_MACINTOSH,     TT_MAC_ID_ROMAN,     FT_ENCODING_APPLE_ROMAN },
  252.       { TT_PLATFORM_MICROSOFT,     TT_MS_ID_SYMBOL_CS,  FT_ENCODING_MS_SYMBOL },
  253.       { TT_PLATFORM_MICROSOFT,     TT_MS_ID_UCS_4,      FT_ENCODING_UNICODE },
  254.       { TT_PLATFORM_MICROSOFT,     TT_MS_ID_UNICODE_CS, FT_ENCODING_UNICODE },
  255.       { TT_PLATFORM_MICROSOFT,     TT_MS_ID_SJIS,       FT_ENCODING_SJIS },
  256.       { TT_PLATFORM_MICROSOFT,     TT_MS_ID_GB2312,     FT_ENCODING_GB2312 },
  257.       { TT_PLATFORM_MICROSOFT,     TT_MS_ID_BIG_5,      FT_ENCODING_BIG5 },
  258.       { TT_PLATFORM_MICROSOFT,     TT_MS_ID_WANSUNG,    FT_ENCODING_WANSUNG },
  259.       { TT_PLATFORM_MICROSOFT,     TT_MS_ID_JOHAB,      FT_ENCODING_JOHAB }
  260.     };
  261.     const TEncoding  *cur, *limit;
  262.     cur   = tt_encodings;
  263.     limit = cur + sizeof ( tt_encodings ) / sizeof ( tt_encodings[0] );
  264.     for ( ; cur < limit; cur++ )
  265.     {
  266.       if ( cur->platform_id == platform_id )
  267.       {
  268.         if ( cur->encoding_id == encoding_id ||
  269.              cur->encoding_id == -1          )
  270.           return cur->encoding;
  271.       }
  272.     }
  273.     return FT_ENCODING_NONE;
  274.   }
  275.   /* Fill in face->ttc_header.  If the font is not a TTC, it is */
  276.   /* synthesized into a TTC with one offset table.              */
  277.   static FT_Error
  278.   sfnt_open_font( FT_Stream  stream,
  279.                   TT_Face    face )
  280.   {
  281.     FT_Memory  memory = stream->memory;
  282.     FT_Error   error;
  283.     FT_ULong   tag, offset;
  284.     static const FT_Frame_Field  ttc_header_fields[] =
  285.     {
  286. #undef  FT_STRUCTURE
  287. #define FT_STRUCTURE  TTC_HeaderRec
  288.       FT_FRAME_START( 8 ),
  289.         FT_FRAME_LONG( version ),
  290.         FT_FRAME_LONG( count   ),
  291.       FT_FRAME_END
  292.     };
  293.     face->ttc_header.tag     = 0;
  294.     face->ttc_header.version = 0;
  295.     face->ttc_header.count   = 0;
  296.     offset = FT_STREAM_POS();
  297.     if ( FT_READ_ULONG( tag ) )
  298.       return error;
  299.     if ( tag != 0x00010000UL                      &&
  300.          tag != TTAG_ttcf                         &&
  301.          tag != FT_MAKE_TAG( 'O', 'T', 'T', 'O' ) &&
  302.          tag != TTAG_true                         &&
  303.          tag != 0x00020000UL                      )
  304.       return SFNT_Err_Unknown_File_Format;
  305.     face->ttc_header.tag = TTAG_ttcf;
  306.     if ( tag == TTAG_ttcf )
  307.     {
  308.       FT_Int  n;
  309.       FT_TRACE3(( "sfnt_open_font: file is a collectionn" ));
  310.       if ( FT_STREAM_READ_FIELDS( ttc_header_fields, &face->ttc_header ) )
  311.         return error;
  312.       /* now read the offsets of each font in the file */
  313.       if ( FT_NEW_ARRAY( face->ttc_header.offsets, face->ttc_header.count ) )
  314.         return error;
  315.       if ( FT_FRAME_ENTER( face->ttc_header.count * 4L ) )
  316.         return error;
  317.       for ( n = 0; n < face->ttc_header.count; n++ )
  318.         face->ttc_header.offsets[n] = FT_GET_ULONG();
  319.       FT_FRAME_EXIT();
  320.     }
  321.     else
  322.     {
  323.       FT_TRACE3(( "sfnt_open_font: synthesize TTCn" ));
  324.       face->ttc_header.version = 1 << 16;
  325.       face->ttc_header.count   = 1;
  326.       if ( FT_NEW( face->ttc_header.offsets) )
  327.         return error;
  328.       face->ttc_header.offsets[0] = offset;
  329.     }
  330.     return error;
  331.   }
  332.   FT_LOCAL_DEF( FT_Error )
  333.   sfnt_init_face( FT_Stream      stream,
  334.                   TT_Face        face,
  335.                   FT_Int         face_index,
  336.                   FT_Int         num_params,
  337.                   FT_Parameter*  params )
  338.   {
  339.     FT_Error        error;
  340.     FT_Library      library = face->root.driver->root.library;
  341.     SFNT_Service    sfnt;
  342.     /* for now, parameters are unused */
  343.     FT_UNUSED( num_params );
  344.     FT_UNUSED( params );
  345.     sfnt = (SFNT_Service)face->sfnt;
  346.     if ( !sfnt )
  347.     {
  348.       sfnt = (SFNT_Service)FT_Get_Module_Interface( library, "sfnt" );
  349.       if ( !sfnt )
  350.         return SFNT_Err_Invalid_File_Format;
  351.       face->sfnt       = sfnt;
  352.       face->goto_table = sfnt->goto_table;
  353.     }
  354.     FT_FACE_FIND_GLOBAL_SERVICE( face, face->psnames, POSTSCRIPT_CMAPS );
  355.     error = sfnt_open_font( stream, face );
  356.     if ( error )
  357.       return error;
  358.     FT_TRACE2(( "sfnt_init_face: %08p, %ldn", face, face_index ));
  359.     if ( face_index < 0 )
  360.       face_index = 0;
  361.     if ( face_index >= face->ttc_header.count )
  362.         return SFNT_Err_Bad_Argument;
  363.     if ( FT_STREAM_SEEK( face->ttc_header.offsets[face_index] ) )
  364.       return error;
  365.     /* check that we have a valid TrueType file */
  366.     error = sfnt->load_font_dir( face, stream );
  367.     if ( error )
  368.       return error;
  369.     face->root.num_faces = face->ttc_header.count;
  370.     return error;
  371.   }
  372. #define LOAD_( x )                                            
  373.   do {                                                        
  374.     FT_TRACE2(( "`" #x "' " ));                               
  375.     FT_TRACE3(( "-->n" ));                                   
  376.                                                               
  377.     error = sfnt->load_##x( face, stream );                   
  378.                                                               
  379.     FT_TRACE2(( "%sn", ( !error )                            
  380.                         ? "loaded"                            
  381.                         : ( error == SFNT_Err_Table_Missing ) 
  382.                           ? "missing"                         
  383.                           : "failed to load" ));              
  384.     FT_TRACE3(( "n" ));                                      
  385.   } while ( 0 )
  386. #define LOADM_( x, vertical )                                 
  387.   do {                                                        
  388.     FT_TRACE2(( "`%s" #x "' ",                                
  389.                 vertical ? "vertical " : "" ));               
  390.     FT_TRACE3(( "-->n" ));                                   
  391.                                                               
  392.     error = sfnt->load_##x( face, stream, vertical );         
  393.                                                               
  394.     FT_TRACE2(( "%sn", ( !error )                            
  395.                         ? "loaded"                            
  396.                         : ( error == SFNT_Err_Table_Missing ) 
  397.                           ? "missing"                         
  398.                           : "failed to load" ));              
  399.     FT_TRACE3(( "n" ));                                      
  400.   } while ( 0 )
  401.   FT_LOCAL_DEF( FT_Error )
  402.   sfnt_load_face( FT_Stream      stream,
  403.                   TT_Face        face,
  404.                   FT_Int         face_index,
  405.                   FT_Int         num_params,
  406.                   FT_Parameter*  params )
  407.   {
  408.     FT_Error      error, psnames_error;
  409.     FT_Bool       has_outline;
  410.     FT_Bool       is_apple_sbit;
  411.     SFNT_Service  sfnt = (SFNT_Service)face->sfnt;
  412.     FT_UNUSED( face_index );
  413.     FT_UNUSED( num_params );
  414.     FT_UNUSED( params );
  415.     /* Load tables */
  416.     /* We now support two SFNT-based bitmapped font formats.  They */
  417.     /* are recognized easily as they do not include a `glyf'       */
  418.     /* table.                                                      */
  419.     /*                                                             */
  420.     /* The first format comes from Apple, and uses a table named   */
  421.     /* `bhed' instead of `head' to store the font header (using    */
  422.     /* the same format).  It also doesn't include horizontal and   */
  423.     /* vertical metrics tables (i.e. `hhea' and `vhea' tables are  */
  424.     /* missing).                                                   */
  425.     /*                                                             */
  426.     /* The other format comes from Microsoft, and is used with     */
  427.     /* WinCE/PocketPC.  It looks like a standard TTF, except that  */
  428.     /* it doesn't contain outlines.                                */
  429.     /*                                                             */
  430.     FT_TRACE2(( "sfnt_load_face: %08pnn", face ));
  431.     /* do we have outlines in there? */
  432. #ifdef FT_CONFIG_OPTION_INCREMENTAL
  433.     has_outline   = FT_BOOL( face->root.internal->incremental_interface != 0 ||
  434.                              tt_face_lookup_table( face, TTAG_glyf )    != 0 ||
  435.                              tt_face_lookup_table( face, TTAG_CFF )     != 0 );
  436. #else
  437.     has_outline   = FT_BOOL( tt_face_lookup_table( face, TTAG_glyf ) != 0 ||
  438.                              tt_face_lookup_table( face, TTAG_CFF )  != 0 );
  439. #endif
  440.     is_apple_sbit = 0;
  441.     /* if this font doesn't contain outlines, we try to load */
  442.     /* a `bhed' table                                        */
  443.     if ( !has_outline && sfnt->load_bhed )
  444.     {
  445.       LOAD_( bhed );
  446.       is_apple_sbit = FT_BOOL( !error );
  447.     }
  448.     /* load the font header (`head' table) if this isn't an Apple */
  449.     /* sbit font file                                             */
  450.     if ( !is_apple_sbit )
  451.     {
  452.       LOAD_( head );
  453.       if ( error )
  454.         goto Exit;
  455.     }
  456.     if ( face->header.Units_Per_EM == 0 )
  457.     {
  458.       error = SFNT_Err_Invalid_Table;
  459.       goto Exit;
  460.     }
  461.     /* the following tables are often not present in embedded TrueType */
  462.     /* fonts within PDF documents, so don't check for them.            */
  463.     LOAD_( maxp );
  464.     LOAD_( cmap );
  465.     /* the following tables are optional in PCL fonts -- */
  466.     /* don't check for errors                            */
  467.     LOAD_( name );
  468.     LOAD_( post );
  469.     psnames_error = error;
  470.     /* do not load the metrics headers and tables if this is an Apple */
  471.     /* sbit font file                                                 */
  472.     if ( !is_apple_sbit )
  473.     {
  474.       /* load the `hhea' and `hmtx' tables */
  475.       LOADM_( hhea, 0 );
  476.       if ( !error )
  477.       {
  478.         LOADM_( hmtx, 0 );
  479.         if ( error == SFNT_Err_Table_Missing )
  480.         {
  481.           error = SFNT_Err_Hmtx_Table_Missing;
  482. #ifdef FT_CONFIG_OPTION_INCREMENTAL
  483.           /* If this is an incrementally loaded font and there are */
  484.           /* overriding metrics, tolerate a missing `hmtx' table.  */
  485.           if ( face->root.internal->incremental_interface          &&
  486.                face->root.internal->incremental_interface->funcs->
  487.                  get_glyph_metrics                                 )
  488.           {
  489.             face->horizontal.number_Of_HMetrics = 0;
  490.             error = SFNT_Err_Ok;
  491.           }
  492. #endif
  493.         }
  494.       }
  495.       else if ( error == SFNT_Err_Table_Missing )
  496.       {
  497.         /* No `hhea' table necessary for SFNT Mac fonts. */
  498.         if ( face->format_tag == TTAG_true )
  499.         {
  500.           FT_TRACE2(( "This is an SFNT Mac font.n" ));
  501.           has_outline = 0;
  502.           error = SFNT_Err_Ok;
  503.         }
  504.         else
  505.         {
  506.           error = SFNT_Err_Horiz_Header_Missing;
  507. #ifdef FT_CONFIG_OPTION_INCREMENTAL
  508.           /* If this is an incrementally loaded font and there are */
  509.           /* overriding metrics, tolerate a missing `hhea' table.  */
  510.           if ( face->root.internal->incremental_interface          &&
  511.                face->root.internal->incremental_interface->funcs->
  512.                  get_glyph_metrics                                 )
  513.           {
  514.             face->horizontal.number_Of_HMetrics = 0;
  515.             error = SFNT_Err_Ok;
  516.           }
  517. #endif
  518.         }
  519.       }
  520.       if ( error )
  521.         goto Exit;
  522.       /* try to load the `vhea' and `vmtx' tables */
  523.       LOADM_( hhea, 1 );
  524.       if ( !error )
  525.       {
  526.         LOADM_( hmtx, 1 );
  527.         if ( !error )
  528.           face->vertical_info = 1;
  529.       }
  530.       if ( error && error != SFNT_Err_Table_Missing )
  531.         goto Exit;
  532.       LOAD_( os2 );
  533.       if ( error )
  534.       {
  535.         if ( error != SFNT_Err_Table_Missing )
  536.           goto Exit;
  537.         face->os2.version = 0xFFFFU;
  538.       }
  539.     }
  540.     /* the optional tables */
  541.     /* embedded bitmap support. */
  542.     if ( sfnt->load_eblc )
  543.     {
  544.       LOAD_( eblc );
  545.       if ( error )
  546.       {
  547.         /* return an error if this font file has no outlines */
  548.         if ( error == SFNT_Err_Table_Missing && has_outline )
  549.           error = SFNT_Err_Ok;
  550.         else
  551.           goto Exit;
  552.       }
  553.     }
  554.     LOAD_( pclt );
  555.     if ( error )
  556.     {
  557.       if ( error != SFNT_Err_Table_Missing )
  558.         goto Exit;
  559.       face->pclt.Version = 0;
  560.     }
  561.     /* consider the kerning and gasp tables as optional */
  562.     LOAD_( gasp );
  563.     LOAD_( kern );
  564.     error = SFNT_Err_Ok;
  565.     face->root.num_glyphs = face->max_profile.numGlyphs;
  566.     face->root.family_name = tt_face_get_name( face,
  567.                                                TT_NAME_ID_PREFERRED_FAMILY );
  568.     if ( !face->root.family_name )
  569.       face->root.family_name = tt_face_get_name( face,
  570.                                                  TT_NAME_ID_FONT_FAMILY );
  571.     face->root.style_name = tt_face_get_name( face,
  572.                                               TT_NAME_ID_PREFERRED_SUBFAMILY );
  573.     if ( !face->root.style_name )
  574.       face->root.style_name  = tt_face_get_name( face,
  575.                                                  TT_NAME_ID_FONT_SUBFAMILY );
  576.     /* now set up root fields */
  577.     {
  578.       FT_Face    root = &face->root;
  579.       FT_Int32   flags = root->face_flags;
  580.       /*********************************************************************/
  581.       /*                                                                   */
  582.       /* Compute face flags.                                               */
  583.       /*                                                                   */
  584.       if ( has_outline == TRUE )
  585.         flags |= FT_FACE_FLAG_SCALABLE;   /* scalable outlines */
  586.       /* The sfnt driver only supports bitmap fonts natively, thus we */
  587.       /* don't set FT_FACE_FLAG_HINTER.                               */
  588.       flags |= FT_FACE_FLAG_SFNT       |  /* SFNT file format  */
  589.                FT_FACE_FLAG_HORIZONTAL;   /* horizontal data   */
  590. #ifdef TT_CONFIG_OPTION_POSTSCRIPT_NAMES
  591.       if ( psnames_error == SFNT_Err_Ok &&
  592.            face->postscript.FormatType != 0x00030000L )
  593.         flags |= FT_FACE_FLAG_GLYPH_NAMES;
  594. #endif
  595.       /* fixed width font? */
  596.       if ( face->postscript.isFixedPitch )
  597.         flags |= FT_FACE_FLAG_FIXED_WIDTH;
  598.       /* vertical information? */
  599.       if ( face->vertical_info )
  600.         flags |= FT_FACE_FLAG_VERTICAL;
  601.       /* kerning available ? */
  602.       if ( TT_FACE_HAS_KERNING( face ) )
  603.         flags |= FT_FACE_FLAG_KERNING;
  604. #ifdef TT_CONFIG_OPTION_GX_VAR_SUPPORT
  605.       /* Don't bother to load the tables unless somebody asks for them. */
  606.       /* No need to do work which will (probably) not be used.          */
  607.       if ( tt_face_lookup_table( face, TTAG_glyf ) != 0 &&
  608.            tt_face_lookup_table( face, TTAG_fvar ) != 0 &&
  609.            tt_face_lookup_table( face, TTAG_gvar ) != 0 )
  610.         flags |= FT_FACE_FLAG_MULTIPLE_MASTERS;
  611. #endif
  612.       root->face_flags = flags;
  613.       /*********************************************************************/
  614.       /*                                                                   */
  615.       /* Compute style flags.                                              */
  616.       /*                                                                   */
  617.       flags = 0;
  618.       if ( has_outline == TRUE && face->os2.version != 0xFFFFU )
  619.       {
  620.         /* we have an OS/2 table; use the `fsSelection' field */
  621.         if ( face->os2.fsSelection & 1 )
  622.           flags |= FT_STYLE_FLAG_ITALIC;
  623.         if ( face->os2.fsSelection & 32 )
  624.           flags |= FT_STYLE_FLAG_BOLD;
  625.       }
  626.       else
  627.       {
  628.         /* this is an old Mac font, use the header field */
  629.         if ( face->header.Mac_Style & 1 )
  630.           flags |= FT_STYLE_FLAG_BOLD;
  631.         if ( face->header.Mac_Style & 2 )
  632.           flags |= FT_STYLE_FLAG_ITALIC;
  633.       }
  634.       root->style_flags = flags;
  635.       /*********************************************************************/
  636.       /*                                                                   */
  637.       /* Polish the charmaps.                                              */
  638.       /*                                                                   */
  639.       /*   Try to set the charmap encoding according to the platform &     */
  640.       /*   encoding ID of each charmap.                                    */
  641.       /*                                                                   */
  642.       tt_face_build_cmaps( face );  /* ignore errors */
  643.       /* set the encoding fields */
  644.       {
  645.         FT_Int  m;
  646.         for ( m = 0; m < root->num_charmaps; m++ )
  647.         {
  648.           FT_CharMap  charmap = root->charmaps[m];
  649.           charmap->encoding = sfnt_find_encoding( charmap->platform_id,
  650.                                                   charmap->encoding_id );
  651. #if 0
  652.           if ( root->charmap     == NULL &&
  653.                charmap->encoding == FT_ENCODING_UNICODE )
  654.           {
  655.             /* set 'root->charmap' to the first Unicode encoding we find */
  656.             root->charmap = charmap;
  657.           }
  658. #endif
  659.         }
  660.       }
  661.       /*********************************************************************/
  662.       /*                                                                   */
  663.       /*  Set up metrics.                                                  */
  664.       /*                                                                   */
  665.       if ( has_outline == TRUE )
  666.       {
  667.         /* XXX What about if outline header is missing */
  668.         /*     (e.g. sfnt wrapped bitmap)?             */
  669.         root->bbox.xMin    = face->header.xMin;
  670.         root->bbox.yMin    = face->header.yMin;
  671.         root->bbox.xMax    = face->header.xMax;
  672.         root->bbox.yMax    = face->header.yMax;
  673.         root->units_per_EM = face->header.Units_Per_EM;
  674.         /* XXX: Computing the ascender/descender/height is very different */
  675.         /*      from what the specification tells you.  Apparently, we    */
  676.         /*      must be careful because                                   */
  677.         /*                                                                */
  678.         /*      - not all fonts have an OS/2 table; in this case, we take */
  679.         /*        the values in the horizontal header.  However, these    */
  680.         /*        values very often are not reliable.                     */
  681.         /*                                                                */
  682.         /*      - otherwise, the correct typographic values are in the    */
  683.         /*        sTypoAscender, sTypoDescender & sTypoLineGap fields.    */
  684.         /*                                                                */
  685.         /*        However, certain fonts have these fields set to 0.      */
  686.         /*        Rather, they have usWinAscent & usWinDescent correctly  */
  687.         /*        set (but with different values).                        */
  688.         /*                                                                */
  689.         /*      As an example, Arial Narrow is implemented through four   */
  690.         /*      files ARIALN.TTF, ARIALNI.TTF, ARIALNB.TTF & ARIALNBI.TTF */
  691.         /*                                                                */
  692.         /*      Strangely, all fonts have the same values in their        */
  693.         /*      sTypoXXX fields, except ARIALNB which sets them to 0.     */
  694.         /*                                                                */
  695.         /*      On the other hand, they all have different                */
  696.         /*      usWinAscent/Descent values -- as a conclusion, the OS/2   */
  697.         /*      table cannot be used to compute the text height reliably! */
  698.         /*                                                                */
  699.         /* The ascender/descender/height are computed from the OS/2 table */
  700.         /* when found.  Otherwise, they're taken from the horizontal      */
  701.         /* header.                                                        */
  702.         /*                                                                */
  703.         root->ascender  = face->horizontal.Ascender;
  704.         root->descender = face->horizontal.Descender;
  705.         root->height    = (FT_Short)( root->ascender - root->descender +
  706.                                       face->horizontal.Line_Gap );
  707. #if 0
  708.         /* if the line_gap is 0, we add an extra 15% to the text height --  */
  709.         /* this computation is based on various versions of Times New Roman */
  710.         if ( face->horizontal.Line_Gap == 0 )
  711.           root->height = (FT_Short)( ( root->height * 115 + 50 ) / 100 );
  712. #endif
  713. #if 0
  714.         /* some fonts have the OS/2 "sTypoAscender", "sTypoDescender" & */
  715.         /* "sTypoLineGap" fields set to 0, like ARIALNB.TTF             */
  716.         if ( face->os2.version != 0xFFFFU && root->ascender )
  717.         {
  718.           FT_Int  height;
  719.           root->ascender  =  face->os2.sTypoAscender;
  720.           root->descender = -face->os2.sTypoDescender;
  721.           height = root->ascender + root->descender + face->os2.sTypoLineGap;
  722.           if ( height > root->height )
  723.             root->height = height;
  724.         }
  725. #endif /* 0 */
  726.         root->max_advance_width   = face->horizontal.advance_Width_Max;
  727.         root->max_advance_height  = (FT_Short)( face->vertical_info
  728.                                       ? face->vertical.advance_Height_Max
  729.                                       : root->height );
  730.         root->underline_position  = face->postscript.underlinePosition;
  731.         root->underline_thickness = face->postscript.underlineThickness;
  732.       }
  733. #ifdef TT_CONFIG_OPTION_EMBEDDED_BITMAPS
  734.       /*
  735.        *  Now allocate the root array of FT_Bitmap_Size records and
  736.        *  populate them.  Unfortunately, it isn't possible to indicate bit
  737.        *  depths in the FT_Bitmap_Size record.  This is a design error.
  738.        */
  739.       {
  740.         FT_UInt  i, count;
  741. #if !defined FT_CONFIG_OPTION_OLD_INTERNALS
  742.         count = face->sbit_num_strikes;
  743. #else
  744.         count = (FT_UInt)face->num_sbit_strikes;
  745. #endif
  746.         if ( count > 0 )
  747.         {
  748.           FT_Memory        memory   = face->root.stream->memory;
  749.           FT_UShort        em_size  = face->header.Units_Per_EM;
  750.           FT_Short         avgwidth = face->os2.xAvgCharWidth;
  751.           FT_Size_Metrics  metrics;
  752.           if ( em_size == 0 || face->os2.version == 0xFFFFU )
  753.           {
  754.             avgwidth = 0;
  755.             em_size = 1;
  756.           }
  757.           if ( FT_NEW_ARRAY( root->available_sizes, count ) )
  758.             goto Exit;
  759.           for ( i = 0; i < count; i++ )
  760.           {
  761.             FT_Bitmap_Size*  bsize = root->available_sizes + i;
  762.             error = sfnt->load_strike_metrics( face, i, &metrics );
  763.             if ( error )
  764.               goto Exit;
  765.             bsize->height = (FT_Short)( metrics.height >> 6 );
  766.             bsize->width = (FT_Short)(
  767.                 ( avgwidth * metrics.x_ppem + em_size / 2 ) / em_size );
  768.             bsize->x_ppem = metrics.x_ppem << 6;
  769.             bsize->y_ppem = metrics.y_ppem << 6;
  770.             /* assume 72dpi */
  771.             bsize->size   = metrics.y_ppem << 6;
  772.           }
  773.           root->face_flags     |= FT_FACE_FLAG_FIXED_SIZES;
  774.           root->num_fixed_sizes = (FT_Int)count;
  775.         }
  776.       }
  777. #endif /* TT_CONFIG_OPTION_EMBEDDED_BITMAPS */
  778.     }
  779.   Exit:
  780.     FT_TRACE2(( "sfnt_load_face: donen" ));
  781.     return error;
  782.   }
  783. #undef LOAD_
  784. #undef LOADM_
  785.   FT_LOCAL_DEF( void )
  786.   sfnt_done_face( TT_Face  face )
  787.   {
  788.     FT_Memory     memory = face->root.memory;
  789.     SFNT_Service  sfnt   = (SFNT_Service)face->sfnt;
  790.     if ( sfnt )
  791.     {
  792.       /* destroy the postscript names table if it is loaded */
  793.       if ( sfnt->free_psnames )
  794.         sfnt->free_psnames( face );
  795.       /* destroy the embedded bitmaps table if it is loaded */
  796.       if ( sfnt->free_eblc )
  797.         sfnt->free_eblc( face );
  798.     }
  799. #ifdef TT_CONFIG_OPTION_BDF
  800.     /* freeing the embedded BDF properties */
  801.     tt_face_free_bdf_props( face );
  802. #endif
  803.     /* freeing the kerning table */
  804.     tt_face_done_kern( face );
  805.     /* freeing the collection table */
  806.     FT_FREE( face->ttc_header.offsets );
  807.     face->ttc_header.count = 0;
  808.     /* freeing table directory */
  809.     FT_FREE( face->dir_tables );
  810.     face->num_tables = 0;
  811.     {
  812.       FT_Stream  stream = FT_FACE_STREAM( face );
  813.       /* simply release the 'cmap' table frame */
  814.       FT_FRAME_RELEASE( face->cmap_table );
  815.       face->cmap_size = 0;
  816.     }
  817.     /* freeing the horizontal metrics */
  818. #if !defined FT_CONFIG_OPTION_OLD_INTERNALS
  819.     {
  820.       FT_Stream  stream = FT_FACE_STREAM( face );
  821.       FT_FRAME_RELEASE( face->horz_metrics );
  822.       FT_FRAME_RELEASE( face->vert_metrics );
  823.       face->horz_metrics_size = 0;
  824.       face->vert_metrics_size = 0;
  825.     }
  826. #else
  827.     FT_FREE( face->horizontal.long_metrics );
  828.     FT_FREE( face->horizontal.short_metrics );
  829. #endif
  830.     /* freeing the vertical ones, if any */
  831.     if ( face->vertical_info )
  832.     {
  833.       FT_FREE( face->vertical.long_metrics  );
  834.       FT_FREE( face->vertical.short_metrics );
  835.       face->vertical_info = 0;
  836.     }
  837.     /* freeing the gasp table */
  838.     FT_FREE( face->gasp.gaspRanges );
  839.     face->gasp.numRanges = 0;
  840.     /* freeing the name table */
  841.     sfnt->free_name( face );
  842.     /* freeing family and style name */
  843.     FT_FREE( face->root.family_name );
  844.     FT_FREE( face->root.style_name );
  845.     /* freeing sbit size table */
  846.     FT_FREE( face->root.available_sizes );
  847.     face->root.num_fixed_sizes = 0;
  848.     FT_FREE( face->postscript_name );
  849.     face->sfnt = 0;
  850.   }
  851. /* END */