typedef struct  FT_SfntName_
  {
    FT_UShort  platform_id;
    FT_UShort  encoding_id;
    FT_UShort  language_id;
    FT_UShort  name_id;

    FT_Byte*   string;      /* this string is *not* null-terminated! */
    FT_UInt    string_len;  /* in bytes */

  } FT_SfntName;

A structure used to model an SFNT `name' table entry.

Possible values for `platform_id', `encoding_id', `language_id', and `name_id' are given in the file `ttnameid.h'. For details please refer to the TrueType or OpenType specification.

  FT_EXPORT( FT_UInt )
  FT_Get_Sfnt_Name_Count( FT_Face  face );

Retrieves the number of name strings in the SFNT `name' table.

The number of strings in the `name' table.

  FT_EXPORT( FT_Error )
  FT_Get_Sfnt_Name( FT_Face       face,
                    FT_UInt       idx,
                    FT_SfntName  *aname );

Retrieves a string of the SFNT `name' table for a given index.

FreeType error code. 0 means success.

The `string' array returned in the `aname' structure is not null-terminated.

Use FT_Get_Sfnt_Name_Count() to get the total number of available `name' table entries, then do a loop until you get the right platform, encoding, and name ID.

  typedef struct FT_StreamRec_*    FT_Stream;

handle to an input stream object. These are also ?FT_Object handles

  typedef const struct FT_Stream_ClassRec_*   FT_Stream_Class;

opaque handle to a FT_Stream_ClassRec class structure describing the methods of input streams

  typedef FT_ULong  (*FT_Stream_ReadFunc)( FT_Stream   stream,
                                           FT_Byte*    buffer,
                                           FT_ULong    size );

a method used to read bytes from an input stream into memory

number of bytes effectively read. Must be <= 'size'.

  typedef FT_Error  (*FT_Stream_SeekFunc)( FT_Stream   stream,
                                           FT_ULong    pos );

a method used to seek to a new position within a stream

error code. 0 means success

  typedef struct FT_Stream_ClassRec_
  {
    FT_ClassRec          clazz;
    FT_Stream_ReadFunc   stream_read;
    FT_Stream_SeekFunc   stream_seek;

  } FT_Stream_ClassRec;

a structure used to describe an input stream class

  typedef struct FT_StreamRec_
  {
    FT_ObjectRec        object;
    FT_ULong            size;
    FT_ULong            pos;
    const FT_Byte*      base;
    const FT_Byte*      cursor;
    const FT_Byte*      limit;

  } FT_StreamRec;

the input stream object structure. See FT_Stream_ClassRec for its class descriptor

  typedef struct FT_MemoryRec_*   FT_Memory;

opaque handle to a memory manager handle. Note that since FreeType 2.2, the memory manager structure FT_MemoryRec is hidden to client applications.

however, you can still define custom allocators easily using the ft_memory_new API

  typedef FT_Pointer  (*FT_Memory_AllocFunc)( FT_ULong   size,
                                              FT_Pointer mem_data );

a function used to allocate a block of memory.

address of new block. NULL in case of memory exhaustion

  typedef void        (*FT_Memory_FreeFunc) ( FT_Pointer  block,
                                              FT_Pointer  mem_data );

a function used to release a block of memory created through FT_Memory_AllocFunc or FT_Memory_ReallocFunc

  typedef FT_Pointer  (*FT_Memory_ReallocFunc)( FT_Pointer   block,
                                                FT_ULong     new_size,
                                                FT_ULong     cur_size,
                                                FT_Pointer   mem_data );

a function used to reallocate a memory block.

  typedef FT_Pointer  (*FT_Memory_CreateFunc)( FT_UInt     size,
                                               FT_Pointer  init_data,
                                               FT_Pointer *amem_data );

a function used to create a FT_Memory object to model a memory manager

handle to new memory manager object. NULL in case of failure

  typedef void        (*FT_Memory_DestroyFunc)( FT_Memory  memory,
                                                FT_Pointer mem_data );

a function used to destroy a given FT_Memory manager

  typedef struct FT_Memory_FuncsRec_
  {
    FT_Memory_AllocFunc     mem_alloc;
    FT_Memory_FreeFunc      mem_free;
    FT_Memory_ReallocFunc   mem_realloc;
    FT_Memory_CreateFunc    mem_create;
    FT_Memory_DestroyFunc   mem_destroy;

  } FT_Memory_FuncsRec, *FT_Memory_Funcs;

a function used to hold all methods of a given memory manager implementation.

  typedef const FT_Memory_FuncsRec*  FT_Memory_Funcs;

a pointer to a constant FT_Memory_FuncsRec structure used to describe a given memory manager implementation.

  FT_BASE( FT_Memory )
  ft_memory_new( FT_Memory_Funcs  mem_funcs,
                 FT_Pointer       mem_init_data );

create a new memory manager, given a set of memory methods

new memory manager handle. NULL in case of failure

  FT_BASE( void )
  ft_memory_destroy( FT_Memory  memory );

destroy a given memory manager