ftcmanag.c File Reference

#include <ft2build.h>
#include "ftcmanag.h"
#include "ftccback.h"
#include "ftcerror.h"

Include dependency graph for ftcmanag.c:

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

Go to the source code of this file.

Classes
struct	FTC_SizeNodeRec_
struct	FTC_FaceNodeRec_

Macros
#define	FT_COMPONENT   trace_cache
#define	FTC_SIZE_NODE(x)   ( (FTC_SizeNode)( x ) )
#define	FTC_FACE_NODE(x)   ( ( FTC_FaceNode )( x ) )

Typedefs
typedef struct FTC_SizeNodeRec_	FTC_SizeNodeRec
typedef struct FTC_SizeNodeRec_ *	FTC_SizeNode
typedef struct FTC_FaceNodeRec_	FTC_FaceNodeRec
typedef struct FTC_FaceNodeRec_ *	FTC_FaceNode

Functions
static FT_Error	ftc_scaler_lookup_size (FTC_Manager manager, FTC_Scaler scaler, FT_Size *asize)
	ftc_size_node_done (FTC_MruNode ftcnode, FT_Pointer data)
	ftc_size_node_compare (FTC_MruNode ftcnode, FT_Pointer ftcscaler)
	ftc_size_node_init (FTC_MruNode ftcnode, FT_Pointer ftcscaler, FT_Pointer ftcmanager)
	ftc_size_node_reset (FTC_MruNode ftcnode, FT_Pointer ftcscaler, FT_Pointer ftcmanager)
static FT_Bool	ftc_size_node_compare_faceid (FTC_MruNode ftcnode, FT_Pointer ftcface_id)
	FTC_Manager_LookupSize (FTC_Manager manager, FTC_Scaler scaler, FT_Size *asize)
	ftc_face_node_init (FTC_MruNode ftcnode, FT_Pointer ftcface_id, FT_Pointer ftcmanager)
	ftc_face_node_done (FTC_MruNode ftcnode, FT_Pointer ftcmanager)
	ftc_face_node_compare (FTC_MruNode ftcnode, FT_Pointer ftcface_id)
	FTC_Manager_LookupFace (FTC_Manager manager, FTC_FaceID face_id, FT_Face *aface)
	FTC_Manager_New (FT_Library library, FT_UInt max_faces, FT_UInt max_sizes, FT_ULong max_bytes, FTC_Face_Requester requester, FT_Pointer req_data, FTC_Manager *amanager)
	FTC_Manager_Done (FTC_Manager manager)
	FTC_Manager_Reset (FTC_Manager manager)
	FTC_Manager_Compress (FTC_Manager manager)
	FTC_Manager_RegisterCache (FTC_Manager manager, FTC_CacheClass clazz, FTC_Cache *acache)
	FTC_Manager_FlushN (FTC_Manager manager, FT_UInt count)
	FTC_Manager_RemoveFaceID (FTC_Manager manager, FTC_FaceID face_id)
	FTC_Node_Unref (FTC_Node node, FTC_Manager manager)

Variables
static const FTC_MruListClassRec	ftc_size_list_class
static const FTC_MruListClassRec	ftc_face_list_class

Macro Definition Documentation

FT_COMPONENT

#define FT_COMPONENT   trace_cache

Definition at line 35 of file ftcmanag.c.

FTC_FACE_NODE

#define FTC_FACE_NODE

(

x

)

( ( FTC_FaceNode )( x ) )

Definition at line 231 of file ftcmanag.c.

FTC_SIZE_NODE

#define FTC_SIZE_NODE

(

x

)

( (FTC_SizeNode)( x ) )

Definition at line 86 of file ftcmanag.c.

Typedef Documentation

FTC_FaceNode

typedef struct FTC_FaceNodeRec_ * FTC_FaceNode

FTC_FaceNodeRec

typedef struct FTC_FaceNodeRec_ FTC_FaceNodeRec

FTC_SizeNode

typedef struct FTC_SizeNodeRec_ * FTC_SizeNode

FTC_SizeNodeRec

typedef struct FTC_SizeNodeRec_ FTC_SizeNodeRec

Function Documentation

ftc_face_node_compare()

ftc_face_node_compare	(	FTC_MruNode	ftcnode,
		FT_Pointer	ftcface_id
	)

Definition at line 284 of file ftcmanag.c.

  {
    FTC_FaceNode  node    = (FTC_FaceNode)ftcnode;
    FTC_FaceID    face_id = (FTC_FaceID)ftcface_id;


    return FT_BOOL( node->face_id == face_id );
  }

Referenced by FTC_Manager_LookupFace(), and FTC_Manager_RemoveFaceID().

ftc_face_node_done()

ftc_face_node_done	(	FTC_MruNode	ftcnode,
		FT_Pointer	ftcmanager
	)

Definition at line 263 of file ftcmanag.c.

  {
    FTC_FaceNode  node    = (FTC_FaceNode)ftcnode;
    FTC_Manager   manager = (FTC_Manager)ftcmanager;


    /* we must begin by removing all scalers for the target face */
    /* from the manager's list                                   */
    FTC_MruList_RemoveSelection( &manager->sizes,
                                 ftc_size_node_compare_faceid,
                                 node->face_id );

    /* all right, we can discard the face now */
    FT_Done_Face( node->face );
    node->face    = NULL;
    node->face_id = NULL;
  }

ftc_face_node_init()

ftc_face_node_init	(	FTC_MruNode	ftcnode,
		FT_Pointer	ftcface_id,
		FT_Pointer	ftcmanager
	)

Definition at line 235 of file ftcmanag.c.

  {
    FTC_FaceNode  node    = (FTC_FaceNode)ftcnode;
    FTC_FaceID    face_id = (FTC_FaceID)ftcface_id;
    FTC_Manager   manager = (FTC_Manager)ftcmanager;
    FT_Error      error;


    node->face_id = face_id;

    error = manager->request_face( face_id,
                                   manager->library,
                                   manager->request_data,
                                   &node->face );
    if ( !error )
    {
      /* destroy initial size object; it will be re-created later */
      if ( node->face->size )
        FT_Done_Size( node->face->size );
    }

    return error;
  }

FTC_Manager_Compress()

FTC_Manager_Compress

(

FTC_Manager

manager

)

Definition at line 538 of file ftcmanag.c.

  {
    FTC_Node   node, first;


    if ( !manager )
      return;

    first = manager->nodes_list;

#ifdef FT_DEBUG_ERROR
    FTC_Manager_Check( manager );

    FT_TRACE0(( "compressing, weight = %ld, max = %ld, nodes = %d\n",
                manager->cur_weight, manager->max_weight,
                manager->num_nodes ));
#endif

    if ( manager->cur_weight < manager->max_weight || !first )
      return;

    /* go to last node -- it's a circular list */
    node = FTC_NODE_PREV( first );
    do
    {
      FTC_Node  prev;


      prev = ( node == first ) ? NULL : FTC_NODE_PREV( node );

      if ( node->ref_count <= 0 )
        ftc_node_destroy( node, manager );

      node = prev;

    } while ( node && manager->cur_weight > manager->max_weight );
  }

Referenced by ftc_cache_add().

FTC_Manager_Done()

FTC_Manager_Done

(

FTC_Manager

manager

)

Definition at line 417 of file ftcmanag.c.

  {
    FT_Memory  memory;
    FT_UInt    idx;


    if ( !manager || !manager->library )
      return;

    memory = manager->memory;

    /* now discard all caches */
    for (idx = manager->num_caches; idx-- > 0; )
    {
      FTC_Cache  cache = manager->caches[idx];


      if ( cache )
      {
        cache->clazz.cache_done( cache );
        FT_FREE( cache );
        manager->caches[idx] = NULL;
      }
    }
    manager->num_caches = 0;

    /* discard faces and sizes */
    FTC_MruList_Done( &manager->sizes );
    FTC_MruList_Done( &manager->faces );

    manager->library = NULL;
    manager->memory  = NULL;

    FT_FREE( manager );
  }

FTC_Manager_FlushN()

FTC_Manager_FlushN	(	FTC_Manager	manager,
		FT_UInt	count
	)

Definition at line 632 of file ftcmanag.c.

  {
    FTC_Node  first = manager->nodes_list;
    FTC_Node  node;
    FT_UInt   result;


    /* try to remove `count' nodes from the list */
    if ( !first )  /* empty list! */
      return 0;

    /* go to last node - it's a circular list */
    node = FTC_NODE_PREV(first);
    for ( result = 0; result < count; )
    {
      FTC_Node  prev = FTC_NODE_PREV( node );


      /* don't touch locked nodes */
      if ( node->ref_count <= 0 )
      {
        ftc_node_destroy( node, manager );
        result++;
      }

      if ( node == first )
        break;

      node = prev;
    }
    return  result;
  }

Referenced by FTC_Manager_Reset().

FTC_Manager_LookupFace()

FTC_Manager_LookupFace	(	FTC_Manager	manager,
		FTC_FaceID	face_id,
		FT_Face *	aface
	)

Definition at line 310 of file ftcmanag.c.

  {
    FT_Error     error;
    FTC_MruNode  mrunode;


    if ( !aface )
      return FT_THROW( Invalid_Argument );

    *aface = NULL;

    if ( !manager )
      return FT_THROW( Invalid_Cache_Handle );

    /* we break encapsulation for the sake of speed */
#ifdef FTC_INLINE

    FTC_MRULIST_LOOKUP_CMP( &manager->faces, face_id, ftc_face_node_compare,
                            mrunode, error );

#else
    error = FTC_MruList_Lookup( &manager->faces, face_id, &mrunode );
#endif

    if ( !error )
      *aface = FTC_FACE_NODE( mrunode )->face;

    return error;
  }

Referenced by ftc_basic_family_get_count(), FTC_CMapCache_Lookup(), and ftc_scaler_lookup_size().

FTC_Manager_LookupSize()

FTC_Manager_LookupSize	(	FTC_Manager	manager,
		FTC_Scaler	scaler,
		FT_Size *	asize
	)

Definition at line 183 of file ftcmanag.c.

  {
    FT_Error     error;
    FTC_MruNode  mrunode;


    if ( !asize || !scaler )
      return FT_THROW( Invalid_Argument );

    *asize = NULL;

    if ( !manager )
      return FT_THROW( Invalid_Cache_Handle );

#ifdef FTC_INLINE

    FTC_MRULIST_LOOKUP_CMP( &manager->sizes, scaler, ftc_size_node_compare,
                            mrunode, error );

#else
    error = FTC_MruList_Lookup( &manager->sizes, scaler, &mrunode );
#endif

    if ( !error )
      *asize = FTC_SIZE_NODE( mrunode )->size;

    return error;
  }

Referenced by ftc_basic_family_load_bitmap(), and ftc_basic_family_load_glyph().

FTC_Manager_New()

FTC_Manager_New	(	FT_Library	library,
		FT_UInt	max_faces,
		FT_UInt	max_sizes,
		FT_ULong	max_bytes,
		FTC_Face_Requester	requester,
		FT_Pointer	req_data,
		FTC_Manager *	amanager
	)

Definition at line 355 of file ftcmanag.c.

  {
    FT_Error     error;
    FT_Memory    memory;
    FTC_Manager  manager = 0;


    if ( !library )
      return FT_THROW( Invalid_Library_Handle );

    if ( !amanager || !requester )
      return FT_THROW( Invalid_Argument );

    memory = library->memory;

    if ( FT_NEW( manager ) )
      goto Exit;

    if ( max_faces == 0 )
      max_faces = FTC_MAX_FACES_DEFAULT;

    if ( max_sizes == 0 )
      max_sizes = FTC_MAX_SIZES_DEFAULT;

    if ( max_bytes == 0 )
      max_bytes = FTC_MAX_BYTES_DEFAULT;

    manager->library      = library;
    manager->memory       = memory;
    manager->max_weight   = max_bytes;

    manager->request_face = requester;
    manager->request_data = req_data;

    FTC_MruList_Init( &manager->faces,
                      &ftc_face_list_class,
                      max_faces,
                      manager,
                      memory );

    FTC_MruList_Init( &manager->sizes,
                      &ftc_size_list_class,
                      max_sizes,
                      manager,
                      memory );

    *amanager = manager;

  Exit:
    return error;
  }

FTC_Manager_RegisterCache()

FTC_Manager_RegisterCache	(	FTC_Manager	manager,
		FTC_CacheClass	clazz,
		FTC_Cache *	acache
	)

Definition at line 580 of file ftcmanag.c.

  {
    FT_Error   error = FT_ERR( Invalid_Argument );
    FTC_Cache  cache = NULL;


    if ( manager && clazz && acache )
    {
      FT_Memory  memory = manager->memory;


      if ( manager->num_caches >= FTC_MAX_CACHES )
      {
        error = FT_THROW( Too_Many_Caches );
        FT_ERROR(( "FTC_Manager_RegisterCache:"
                   " too many registered caches\n" ));
        goto Exit;
      }

      if ( !FT_ALLOC( cache, clazz->cache_size ) )
      {
        cache->manager   = manager;
        cache->memory    = memory;
        cache->clazz     = clazz[0];
        cache->org_class = clazz;

        /* THIS IS VERY IMPORTANT!  IT WILL WRETCH THE MANAGER */
        /* IF IT IS NOT SET CORRECTLY                          */
        cache->index = manager->num_caches;

        error = clazz->cache_init( cache );
        if ( error )
        {
          clazz->cache_done( cache );
          FT_FREE( cache );
          goto Exit;
        }

        manager->caches[manager->num_caches++] = cache;
      }
    }

  Exit:
    if ( acache )
      *acache = cache;
    return error;
  }

Referenced by FTC_CMapCache_New(), and FTC_GCache_New().

FTC_Manager_RemoveFaceID()

FTC_Manager_RemoveFaceID	(	FTC_Manager	manager,
		FTC_FaceID	face_id
	)

Definition at line 670 of file ftcmanag.c.

  {
    FT_UInt  nn;


    if ( !manager )
      return;

    /* this will remove all FTC_SizeNode that correspond to
     * the face_id as well
     */
    FTC_MruList_RemoveSelection( &manager->faces,
                                 ftc_face_node_compare,
                                 face_id );

    for ( nn = 0; nn < manager->num_caches; nn++ )
      FTC_Cache_RemoveFaceID( manager->caches[nn], face_id );
  }

FTC_Manager_Reset()

FTC_Manager_Reset

(

FTC_Manager

manager

)

Definition at line 457 of file ftcmanag.c.

  {
    if ( !manager )
      return;

    FTC_MruList_Reset( &manager->sizes );
    FTC_MruList_Reset( &manager->faces );

    FTC_Manager_FlushN( manager, manager->num_nodes );
  }

FTC_Node_Unref()

FTC_Node_Unref	(	FTC_Node	node,
		FTC_Manager	manager
	)

Definition at line 694 of file ftcmanag.c.

  {
    if ( node                                             &&
         manager                                          &&
         (FT_UInt)node->cache_index < manager->num_caches )
      node->ref_count--;
  }

ftc_scaler_lookup_size()

static FT_Error ftc_scaler_lookup_size ( FTC_Manager  manager, FTC_Scaler  scaler, FT_Size *  asize  )

static

Definition at line 39 of file ftcmanag.c.

  {
    FT_Face   face;
    FT_Size   size = NULL;
    FT_Error  error;


    error = FTC_Manager_LookupFace( manager, scaler->face_id, &face );
    if ( error )
      goto Exit;

    error = FT_New_Size( face, &size );
    if ( error )
      goto Exit;

    FT_Activate_Size( size );

    if ( scaler->pixel )
      error = FT_Set_Pixel_Sizes( face, scaler->width, scaler->height );
    else
      error = FT_Set_Char_Size( face,
                                (FT_F26Dot6)scaler->width,
                                (FT_F26Dot6)scaler->height,
                                scaler->x_res,
                                scaler->y_res );
    if ( error )
    {
      FT_Done_Size( size );
      size = NULL;
    }

  Exit:
    *asize = size;
    return error;
  }

Referenced by ftc_size_node_init(), and ftc_size_node_reset().

ftc_size_node_compare()

ftc_size_node_compare	(	FTC_MruNode	ftcnode,
		FT_Pointer	ftcscaler
	)

Definition at line 104 of file ftcmanag.c.

  {
    FTC_SizeNode  node    = (FTC_SizeNode)ftcnode;
    FTC_Scaler    scaler  = (FTC_Scaler)ftcscaler;
    FTC_Scaler    scaler0 = &node->scaler;


    if ( FTC_SCALER_COMPARE( scaler0, scaler ) )
    {
      FT_Activate_Size( node->size );
      return 1;
    }
    return 0;
  }

Referenced by FTC_Manager_LookupSize().

ftc_size_node_compare_faceid()

static FT_Bool ftc_size_node_compare_faceid ( FTC_MruNode  ftcnode, FT_Pointer  ftcface_id  )

static

Definition at line 169 of file ftcmanag.c.

  {
    FTC_SizeNode  node    = (FTC_SizeNode)ftcnode;
    FTC_FaceID    face_id = (FTC_FaceID)ftcface_id;


    return FT_BOOL( node->scaler.face_id == face_id );
  }

Referenced by ftc_face_node_done().

ftc_size_node_done()

ftc_size_node_done	(	FTC_MruNode	ftcnode,
		FT_Pointer	data
	)

Definition at line 90 of file ftcmanag.c.

  {
    FTC_SizeNode  node = (FTC_SizeNode)ftcnode;
    FT_Size       size = node->size;
    FT_UNUSED( data );


    if ( size )
      FT_Done_Size( size );
  }

ftc_size_node_init()

ftc_size_node_init	(	FTC_MruNode	ftcnode,
		FT_Pointer	ftcscaler,
		FT_Pointer	ftcmanager
	)

Definition at line 122 of file ftcmanag.c.

  {
    FTC_SizeNode  node    = (FTC_SizeNode)ftcnode;
    FTC_Scaler    scaler  = (FTC_Scaler)ftcscaler;
    FTC_Manager   manager = (FTC_Manager)ftcmanager;


    node->scaler = scaler[0];

    return ftc_scaler_lookup_size( manager, scaler, &node->size );
  }

ftc_size_node_reset()

ftc_size_node_reset	(	FTC_MruNode	ftcnode,
		FT_Pointer	ftcscaler,
		FT_Pointer	ftcmanager
	)

Definition at line 138 of file ftcmanag.c.

  {
    FTC_SizeNode  node    = (FTC_SizeNode)ftcnode;
    FTC_Scaler    scaler  = (FTC_Scaler)ftcscaler;
    FTC_Manager   manager = (FTC_Manager)ftcmanager;


    FT_Done_Size( node->size );

    node->scaler = scaler[0];

    return ftc_scaler_lookup_size( manager, scaler, &node->size );
  }

Variable Documentation

ftc_face_list_class

const FTC_MruListClassRec ftc_face_list_class

static

Initial value:

=
  {
    sizeof ( FTC_FaceNodeRec),

    ftc_face_node_compare,  
    ftc_face_node_init,     
    NULL,                   
    ftc_face_node_done      
  }

Definition at line 296 of file ftcmanag.c.

Referenced by FTC_Manager_New().

ftc_size_list_class

const FTC_MruListClassRec ftc_size_list_class

static

Initial value:

=
  {
    sizeof ( FTC_SizeNodeRec ),

    ftc_size_node_compare,  
    ftc_size_node_init,     
    ftc_size_node_reset,    
    ftc_size_node_done      
  }

Definition at line 156 of file ftcmanag.c.

Referenced by FTC_Manager_New().