ttcmap.h File Reference

#include <freetype/internal/tttypes.h>
#include <freetype/internal/ftvalid.h>
#include <freetype/internal/services/svttcmap.h>
#include "ttcmapc.h"

Include dependency graph for ttcmap.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
struct	TT_CMapRec_
struct	TT_CMap_ClassRec_
struct	TT_ValidatorRec_

Macros
#define	TT_CMAP_FLAG_UNSORTED   1
#define	TT_CMAP_FLAG_OVERLAPPING   2
#define	FT_DEFINE_TT_CMAP(class_, size_, init_, done_, char_index_, char_next_, char_var_index_, char_var_default_, variant_list_, charvariant_list_, variantchar_list_, format_, validate_, get_cmap_info_)
#define	TTCMAPCITEM(a)   FT_CALLBACK_TABLE const TT_CMap_ClassRec a;
#define	TT_VALIDATOR(x)   ( (TT_Validator)( x ) )
#define	TT_VALID_GLYPH_COUNT(x)   TT_VALIDATOR( x )->num_glyphs

Typedefs
typedef struct TT_CMapRec_	TT_CMapRec
typedef struct TT_CMapRec_ *	TT_CMap
typedef const struct TT_CMap_ClassRec_ *	TT_CMap_Class
typedef FT_Error(*	TT_CMap_ValidateFunc) (FT_Byte *data, FT_Validator valid)
typedef struct TT_CMap_ClassRec_	TT_CMap_ClassRec
typedef struct TT_ValidatorRec_	TT_ValidatorRec
typedef struct TT_ValidatorRec_ *	TT_Validator

Functions
	tt_face_build_cmaps (TT_Face face)
	tt_get_cmap_info (FT_CharMap charmap, TT_CMapInfo *cmap_info)

Variables
FT_CALLBACK_TABLE const TT_CMap_ClassRec	tt_cmap_unicode_class_rec

Macro Definition Documentation

FT_DEFINE_TT_CMAP

#define FT_DEFINE_TT_CMAP	(		class_,
			size_,
			init_,
			done_,
			char_index_,
			char_next_,
			char_var_index_,
			char_var_default_,
			variant_list_,
			charvariant_list_,
			variantchar_list_,
			format_,
			validate_,
			get_cmap_info_
	)

Value:

  FT_CALLBACK_TABLE_DEF                        \
  const TT_CMap_ClassRec  class_ =             \
  {                                            \
    { size_,                                   \
      init_,                                   \
      done_,                                   \
      char_index_,                             \
      char_next_,                              \
      char_var_index_,                         \
      char_var_default_,                       \
      variant_list_,                           \
      charvariant_list_,                       \
      variantchar_list_                        \
    },                                         \
                                               \
    format_,                                   \
    validate_,                                 \
    get_cmap_info_                             \
  };

Definition at line 58 of file ttcmap.h.

TT_CMAP_FLAG_OVERLAPPING

#define TT_CMAP_FLAG_OVERLAPPING   2

Definition at line 31 of file ttcmap.h.

TT_CMAP_FLAG_UNSORTED

#define TT_CMAP_FLAG_UNSORTED   1

Definition at line 30 of file ttcmap.h.

TT_VALID_GLYPH_COUNT

#define TT_VALID_GLYPH_COUNT

(

x

)

TT_VALIDATOR( x )->num_glyphs

Definition at line 107 of file ttcmap.h.

TT_VALIDATOR

#define TT_VALIDATOR

(

x

)

( (TT_Validator)( x ) )

Definition at line 106 of file ttcmap.h.

TTCMAPCITEM

#define TTCMAPCITEM

(

a

)

FT_CALLBACK_TABLE const TT_CMap_ClassRec a;

Definition at line 94 of file ttcmap.h.

Typedef Documentation

TT_CMap

typedef struct TT_CMapRec_ * TT_CMap

TT_CMap_Class

typedef const struct TT_CMap_ClassRec_* TT_CMap_Class

Definition at line 41 of file ttcmap.h.

TT_CMap_ClassRec

typedef struct TT_CMap_ClassRec_ TT_CMap_ClassRec

TT_CMap_ValidateFunc

typedef FT_Error(* TT_CMap_ValidateFunc) (FT_Byte *data, FT_Validator valid)

Definition at line 44 of file ttcmap.h.

TT_CMapRec

typedef struct TT_CMapRec_ TT_CMapRec

TT_Validator

typedef struct TT_ValidatorRec_ * TT_Validator

TT_ValidatorRec

typedef struct TT_ValidatorRec_ TT_ValidatorRec

Function Documentation

tt_face_build_cmaps()

tt_face_build_cmaps

(

TT_Face

face

)

Definition at line 3780 of file ttcmap.c.

  {
    FT_Byte* const     table   = face->cmap_table;
    FT_Byte*           limit;
    FT_UInt volatile   num_cmaps;
    FT_Byte* volatile  p       = table;
    FT_Library         library = FT_FACE_LIBRARY( face );
 
    FT_UNUSED( library );
 
 
    if ( !p || face->cmap_size < 4 )
      return FT_THROW( Invalid_Table );
 
    /* Version 1.8.3 of the OpenType specification contains the following */
    /* (https://docs.microsoft.com/en-us/typography/opentype/spec/cmap):  */
    /*                                                                    */
    /*   The 'cmap' table version number remains at 0x0000 for fonts that */
    /*   make use of the newer subtable formats.                          */
    /*                                                                    */
    /* This essentially means that a version format test is useless.      */
 
    /* ignore format */
    p += 2;
 
    num_cmaps = TT_NEXT_USHORT( p );
    FT_TRACE4(( "tt_face_build_cmaps: %d cmaps\n", num_cmaps ));
 
    limit = table + face->cmap_size;
    for ( ; num_cmaps > 0 && p + 8 <= limit; num_cmaps-- )
    {
      FT_CharMapRec  charmap;
      FT_UInt32      offset;
 
 
      charmap.platform_id = TT_NEXT_USHORT( p );
      charmap.encoding_id = TT_NEXT_USHORT( p );
      charmap.face        = FT_FACE( face );
      charmap.encoding    = FT_ENCODING_NONE;  /* will be filled later */
      offset              = TT_NEXT_ULONG( p );
 
      if ( offset && offset <= face->cmap_size - 2 )
      {
        FT_Byte* volatile              cmap   = table + offset;
        volatile FT_UInt               format = TT_PEEK_USHORT( cmap );
        const TT_CMap_Class* volatile  pclazz = tt_cmap_classes;
        TT_CMap_Class volatile         clazz;
 
 
        for ( ; *pclazz; pclazz++ )
        {
          clazz = *pclazz;
          if ( clazz->format == format )
          {
            volatile TT_ValidatorRec  valid;
            volatile FT_Error         error = FT_Err_Ok;
 
 
            ft_validator_init( FT_VALIDATOR( &valid ), cmap, limit,
                               FT_VALIDATE_DEFAULT );
 
            valid.num_glyphs = (FT_UInt)face->max_profile.numGlyphs;
 
            if ( ft_setjmp( FT_VALIDATOR( &valid )->jump_buffer) == 0 )
            {
              /* validate this cmap sub-table */
              error = clazz->validate( cmap, FT_VALIDATOR( &valid ) );
            }
 
            if ( !valid.validator.error )
            {
              FT_CMap  ttcmap;
 
 
              /* It might make sense to store the single variation         */
              /* selector cmap somewhere special.  But it would have to be */
              /* in the public FT_FaceRec, and we can't change that.       */
 
              if ( !FT_CMap_New( (FT_CMap_Class)clazz,
                                 cmap, &charmap, &ttcmap ) )
              {
                /* it is simpler to directly set `flags' than adding */
                /* a parameter to FT_CMap_New                        */
                ((TT_CMap)ttcmap)->flags = (FT_Int)error;
              }
            }
            else
            {
              FT_TRACE0(( "tt_face_build_cmaps:"
                          " broken cmap sub-table ignored\n" ));
            }
            break;
          }
        }
 
        if ( !*pclazz )
        {
          FT_TRACE0(( "tt_face_build_cmaps:"
                      " unsupported cmap sub-table ignored\n" ));
        }
      }
    }
 
    return FT_Err_Ok;
  }

Referenced by sfnt_load_face().

tt_get_cmap_info()

tt_get_cmap_info	(	FT_CharMap	charmap,
		TT_CMapInfo *	cmap_info
	)

Definition at line 3888 of file ttcmap.c.

  {
    FT_CMap        cmap  = (FT_CMap)charmap;
    TT_CMap_Class  clazz = (TT_CMap_Class)cmap->clazz;
 
    if ( clazz->get_cmap_info )
      return clazz->get_cmap_info( charmap, cmap_info );
    else
      return FT_THROW( Invalid_CharMap_Format );
  }

Variable Documentation

tt_cmap_unicode_class_rec

FT_CALLBACK_TABLE const TT_CMap_ClassRec tt_cmap_unicode_class_rec

Definition at line 110 of file ttcmap.h.

Referenced by sfnt_load_face().