shithub: freetype+ttf2subf

Download patch

ref: dd33561ecb0cb0cf7459e49d11d53a55199f3891
parent: 3dc4374f433c7da0520ac4cbf5a4e6da7eae1f14
author: Werner Lemberg <[email protected]>
date: Tue Oct 31 14:42:53 EST 2000

Formatting.

Adding a .cvsignore file.

git/fs: mount .git/fs: mount/attach disallowed
--- /dev/null
+++ b/.cvsignore
@@ -1,0 +1,1 @@
+config.mk
--- a/include/freetype/cache/ftcmanag.h
+++ b/include/freetype/cache/ftcmanag.h
@@ -23,11 +23,11 @@
   /*  - Maintain a mapping between generic FTC_FaceIDs and live FT_Face    */
   /*    objects.  The mapping itself is performed through a user-provided  */
   /*    callback.  However, the manager maintains a small cache of FT_Face */
-  /*    & FT_Size objects in order to speed things considerably.           */
+  /*    & FT_Size objects in order to speed up things considerably.        */
   /*                                                                       */
   /*  - Manage one or more cache objects.  Each cache is in charge of      */
   /*    holding a varying number of `cache nodes'.  Each cache node        */
-  /*    represents a minimal amount of individually-accessible cached      */
+  /*    represents a minimal amount of individually accessible cached      */
   /*    data.  For example, a cache node can be an FT_Glyph image          */
   /*    containing a vector outline, or some glyph metrics, or anything    */
   /*    else.                                                              */
@@ -81,40 +81,41 @@
 #define FTC_MAX_CACHES         16
 
 
- /****************************************************************
-  *
-  * <Struct> FTC_ManagerRec
-  *
-  * <Description>
-  *    the cache manager structure. Each cache manager is in
-  *    charge of performing two tasks:
-  *
-  * <Fields>
-  *    library     :: handle to FreeType library instance
-  *    faces_lru   :: lru list of FT_Face objects in cache
-  *    sizes_lru   :: lru list of FT_Size objects in cache
-  *
-  *    max_bytes   :: maximum number of bytes to be allocated
-  *                   in the cache. this is only related to
-  *                   the byte size of the nodes cached by
-  *                   the manager.
-  * 
-  *    num_bytes   :: current number of bytes allocated in
-  *                   the cache. only related to the byte size
-  *                   of cached nodes.
-  *
-  *    num_nodes   :: current number of nodes in the manager
-  *
-  *    global_lru  :: the global lru list of all cache nodes
-  *
-  *    caches      :: a table of installed/registered cache
-  *                   objects
-  *
-  *    request_data :: user-provided data passed to the requester
-  *    request_face :: user-provided function used to implement
-  *                    a mapping between abstract FTC_FaceIDs
-  *                    and real FT_Face objects..
-  */
+  /*************************************************************************/
+  /*                                                                       */
+  /* <Struct>                                                              */
+  /*    FTC_ManagerRec                                                     */
+  /*                                                                       */
+  /* <Description>                                                         */
+  /*    The cache manager structure.                                       */
+  /*                                                                       */
+  /* <Fields>                                                              */
+  /*    library      :: A handle to a FreeType library instance.           */
+  /*                                                                       */
+  /*    faces_lru    :: The lru list of FT_Face objects in the cache.      */
+  /*                                                                       */
+  /*    sizes_lru    :: The lru list of FT_Size objects in the cache.      */
+  /*                                                                       */
+  /*    max_bytes    :: The maximum number of bytes to be allocated in the */
+  /*                    cache.  This is only related to the byte size of   */
+  /*                    the nodes cached by the manager.                   */
+  /*                                                                       */
+  /*    num_bytes    :: The current number of bytes allocated in the       */
+  /*                    cache.  Only related to the byte size of cached    */
+  /*                    nodes.                                             */
+  /*                                                                       */
+  /*    num_nodes    :: The current number of nodes in the manager.        */
+  /*                                                                       */
+  /*    global_lru   :: The global lru list of all cache nodes.            */
+  /*                                                                       */
+  /*    caches       :: A table of installed/registered cache objects.     */
+  /*                                                                       */
+  /*    request_data :: User-provided data passed to the requester.        */
+  /*                                                                       */
+  /*    request_face :: User-provided function used to implement a mapping */
+  /*                    between abstract FTC_FaceIDs and real FT_Face      */
+  /*                    objects.                                           */
+  /*                                                                       */
   typedef struct  FTC_ManagerRec_
   {
     FT_Library          library;
@@ -133,28 +134,27 @@
   } FTC_ManagerRec;
 
 
- /**********************************************************************
-  *
-  * <Function> FTC_Manager_Compress
-  *
-  * <Description>
-  *    this function is used to check the state of the cache manager
-  *    if its "num_bytes" field is greater than its "max_bytes"
-  *    field, this function will flush as many old cache nodes as
-  *    possible (ignoring cache nodes with a non-zero reference
-  *    count).
-  *
-  * <input>
-  *    manager ::  handle to cache manager
-  *
-  * <note>
-  *    client applications should not call this function directly.
-  *    it is normally invoked by specific cache implementations.
-  *
-  *    the reason this function is exported is to allow client-
-  *    specific cache classes..
-  *
-  */
+  /*************************************************************************/
+  /*                                                                       */
+  /* <Function>                                                            */
+  /*    FTC_Manager_Compress                                               */
+  /*                                                                       */
+  /* <Description>                                                         */
+  /*    This function is used to check the state of the cache manager if   */
+  /*    its `num_bytes' field is greater than its `max_bytes' field.  It   */
+  /*    will flush as many old cache nodes as possible (ignoring cache     */
+  /*    nodes with a non-zero reference count).                            */
+  /*                                                                       */
+  /* <Input>                                                               */
+  /*    manager :: A handle to the cache manager.                          */
+  /*                                                                       */
+  /* <Note>                                                                */
+  /*    Client applications should not call this function directly.  It is */
+  /*    normally invoked by specific cache implementations.                */
+  /*                                                                       */
+  /*    The reason this function is exported is to allow client-specific   */
+  /*    cache classes.                                                     */
+  /*                                                                       */
   FT_EXPORT_DEF( void )  FTC_Manager_Compress( FTC_Manager  manager );
 
 
@@ -182,7 +182,7 @@
   typedef FTC_CacheNodeRec*  FTC_CacheNode;
 
 
-  /* the fields `cachenode.data' is typecasted to this type */
+  /* the field `cachenode.data' is typecast to this type */
   typedef struct  FTC_CacheNode_Data_
   {
     FT_UShort  cache_index;
@@ -190,63 +190,73 @@
 
   } FTC_CacheNode_Data;
 
-  /* return a pointer to the FTC_CacheNode_Data contained in a */
-  /* CacheNode's `data' field                                  */
+
+  /* return a pointer to FTC_CacheNode_Data contained in a */
+  /* CacheNode's `data' field                              */
 #define FTC_CACHENODE_TO_DATA_P( n ) \
           ( (FTC_CacheNode_Data*)&(n)->data )
 
 #define FTC_LIST_TO_CACHENODE( n )  ( (FTC_CacheNode)(n) )
 
- /**********************************************************************
-  *
-  * <FuncType> FTC_CacheNode_SizeFunc
-  *
-  * <Description>
-  *    a function used to compute the total size in bytes of a given
-  *    cache node. It is used by the cache manager to compute the
-  *    number of old nodes to flush when the cache is full..
-  *
-  * <Input>
-  *    node       :: handle to target cache node
-  *    cache_data :: a generic pointer passed to the destructor.
-  */
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* <FuncType>                                                            */
+  /*    FTC_CacheNode_SizeFunc                                             */
+  /*                                                                       */
+  /* <Description>                                                         */
+  /*    A function used to compute the total size in bytes of a given      */
+  /*    cache node.  It is used by the cache manager to compute the number */
+  /*    of old nodes to flush when the cache is full.                      */
+  /*                                                                       */
+  /* <Input>                                                               */
+  /*    node       :: A handle to the target cache node.                   */
+  /*                                                                       */
+  /*    cache_data :: A generic pointer passed to the destructor.          */
+  /*                                                                       */
   typedef FT_ULong  (*FTC_CacheNode_SizeFunc)( FTC_CacheNode  node,
                                                FT_Pointer     cache_data );
 
- /**********************************************************************
-  *
-  * <FuncType> FTC_CacheNode_DestroyFunc
-  *
-  * <Description>
-  *    a function used to destroy a given cache node. It is called
-  *    by the manager when the cache is full and old nodes need to
-  *    be flushed out..
-  *
-  * <Input>
-  *    node       :: handle to target cache node
-  *    cache_data :: a generic pointer passed to the destructor.
-  */
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* <FuncType>                                                            */
+  /*    FTC_CacheNode_DestroyFunc                                          */
+  /*                                                                       */
+  /* <Description>                                                         */
+  /*    A function used to destroy a given cache node.  It is called by    */
+  /*    the manager when the cache is full and old nodes need to be        */
+  /*    flushed out.                                                       */
+  /*                                                                       */
+  /* <Input>                                                               */
+  /*    node       :: A handle to the target cache node.                   */
+  /*                                                                       */
+  /*    cache_data :: A generic pointer passed to the destructor.          */
+  /*                                                                       */
   typedef void  (*FTC_CacheNode_DestroyFunc)( FTC_CacheNode  node,
                                               FT_Pointer     cache_data );
 
- /**********************************************************************
-  *
-  * <Struct> FTC_CacheNode_Class
-  *
-  * <Description>
-  *    a very simple structure used to describe a cache node's class
-  *    to the cache manager
-  *
-  * <Fields>
-  *    size_node    :: a function used to size the node
-  *    destroy_node :: a function used to destroy the node
-  *
-  * <Note>
-  *    the cache node class doesn't include a "new_node" function
-  *    because the cache manager never allocates cache node directly,
-  *    it delegates this task to its cache objects..
-  *
-  */
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* <Struct>                                                              */
+  /*    FTC_CacheNode_Class                                                */
+  /*                                                                       */
+  /* <Description>                                                         */
+  /*    A very simple structure used to describe a cache node's class to   */
+  /*    the cache manager.                                                 */
+  /*                                                                       */
+  /* <Fields>                                                              */
+  /*    size_node    :: A function used to size the node.                  */
+  /*                                                                       */
+  /*    destroy_node :: A function used to destroy the node.               */
+  /*                                                                       */
+  /* <Note>                                                                */
+  /*    The cache node class doesn't include a `new_node' function because */
+  /*    the cache manager never allocates cache node directly; it          */
+  /*    delegates this task to its cache objects.                          */
+  /*                                                                       */
+  /*                                                                       */
   typedef struct  FTC_CacheNode_Class_
   {
     FTC_CacheNode_SizeFunc     size_node;
@@ -264,45 +274,50 @@
   /*************************************************************************/
 
 
- /**********************************************************************
-  *
-  * <FuncType> FTC_Cache_InitFunc
-  *
-  * <Description>
-  *    a function used to initialize a given cache object
-  *
-  * <Input>
-  *    cache  :: handle to new cache
-  */
+  /*************************************************************************/
+  /*                                                                       */
+  /* <FuncType>                                                            */
+  /*    FTC_Cache_InitFunc                                                 */
+  /*                                                                       */
+  /* <Description>                                                         */
+  /*    A function used to initialize a given cache object.                */
+  /*                                                                       */
+  /* <Input>                                                               */
+  /*    cache :: A handle to the new cache.                                */
+  /*                                                                       */
   typedef FT_Error  (*FTC_Cache_InitFunc)( FTC_Cache  cache );
 
 
- /**********************************************************************
-  *
-  * <FuncType> FTC_Cache_DoneFunc
-  *
-  * <Description>
-  *    a function used to finalize a given cache object
-  *
-  * <Input>
-  *    cache  :: handle to target cache
-  */
-  typedef void      (*FTC_Cache_DoneFunc)( FTC_Cache  cache );
+  /*************************************************************************/
+  /*                                                                       */
+  /* <FuncType>                                                            */
+  /*    FTC_Cache_DoneFunc                                                 */
+  /*                                                                       */
+  /* <Description>                                                         */
+  /*    A function to finalize a given cache object.                       */
+  /*                                                                       */
+  /* <Input>                                                               */
+  /*    cache :: A handle to the target cache.                             */
+  /*                                                                       */
+  typedef void  (*FTC_Cache_DoneFunc)( FTC_Cache  cache );
 
 
- /**********************************************************************
-  *
-  * <Struct> FTC_Cache_Class
-  *
-  * <Description>
-  *    a structure used to describe a given cache object class to
-  *    the cache manager.
-  *
-  * <Fields>
-  *    cache_byte_size  :: size of cache object in bytes
-  *    init_cache       :: cache object initializer
-  *    done_cache       :: cache object finalizer
-  */
+  /*************************************************************************/
+  /*                                                                       */
+  /* <Struct>                                                              */
+  /*    FTC_Cache_Class                                                    */
+  /*                                                                       */
+  /* <Description>                                                         */
+  /*    A structure used to describe a given cache object class to the     */
+  /*    cache manager.                                                     */
+  /*                                                                       */
+  /* <Fields>                                                              */
+  /*    cache_byte_size :: The size of the cache object in bytes.          */
+  /*                                                                       */
+  /*    init_cache      :: The cache object initializer.                   */
+  /*                                                                       */
+  /*    done_cache      :: The cache object finalizer.                     */
+  /*                                                                       */
   struct  FTC_Cache_Class_
   {
     FT_UInt             cache_byte_size;
@@ -311,22 +326,28 @@
   };
 
 
- /**********************************************************************
-  *
-  * <Struct> FTC_CacheRec
-  *
-  * <Description>
-  *    a structure used to describe an abstract cache object
-  *
-  * <Fields>
-  *    manager     :: handle to parent cache manager
-  *    memory      :: handle to memory manager
-  *    clazz       :: pointer to cache clazz
-  *    node_clazz  :: pointer to cache's node clazz
-  *
-  *    cache_index :: index of cache in manager's table
-  *    cache_data  :: data passed to the cache node constructor/finalizer
-  */
+  /*************************************************************************/
+  /*                                                                       */
+  /* <Struct>                                                              */
+  /*    FTC_CacheRec                                                       */
+  /*                                                                       */
+  /* <Description>                                                         */
+  /*    A structure used to describe an abstract cache object.             */
+  /*                                                                       */
+  /* <Fields>                                                              */
+  /*    manager     :: A handle to the parent cache manager.               */
+  /*                                                                       */
+  /*    memory      :: A handle to the memory manager.                     */
+  /*                                                                       */
+  /*    clazz       :: A pointer to the cache class.                       */
+  /*                                                                       */
+  /*    node_clazz  :: A pointer to the cache's node class.                */
+  /*                                                                       */
+  /*    cache_index :: An index of the cache in the manager's table.       */
+  /*                                                                       */
+  /*    cache_data  :: Data passed to the cache node                       */
+  /*                   constructor/finalizer.                              */
+  /*                                                                       */
   typedef struct  FTC_CacheRec_
   {
     FTC_Manager           manager;
@@ -338,7 +359,6 @@
     FT_Pointer            cache_data;   /* passed to cache node methods */
 
   } FTC_CacheRec;
-
 
 
 #ifdef __cplusplus
--- a/include/freetype/cache/ftcsbits.h
+++ b/include/freetype/cache/ftcsbits.h
@@ -2,7 +2,7 @@
 /*                                                                         */
 /*  ftcsbits.h                                                             */
 /*                                                                         */
-/*    a small-bitmaps cache (specification).                               */
+/*    A small-bitmap cache (specification).                                */
 /*                                                                         */
 /*  Copyright 2000 by                                                      */
 /*  David Turner, Robert Wilhelm, and Werner Lemberg.                      */
@@ -15,25 +15,27 @@
 /*                                                                         */
 /***************************************************************************/
 
+
 #ifndef FTCSBITS_H
 #define FTCSBITS_H
 
+
 #include <freetype/cache/ftcchunk.h> 
 
+
 #ifdef __cplusplus
   extern "C" {
 #endif
 
- /* handle to small bitmap */
-  typedef struct FTC_SBitRec_*   FTC_SBit;
 
+  /* handle to small bitmap */
+  typedef struct FTC_SBitRec_*  FTC_SBit;
 
- /* handle to small bitmap cache */
-  typedef struct FTC_SBit_CacheRec_*   FTC_SBit_Cache;
+  /* handle to small bitmap cache */
+  typedef struct FTC_SBit_CacheRec_*  FTC_SBit_Cache;
 
-
- /* a compact structure used to hold a single small bitmap */  
-  typedef struct FTC_SBitRec_
+  /* a compact structure used to hold a single small bitmap */  
+  typedef struct  FTC_SBitRec_
   {
     FT_Byte   width;
     FT_Byte   height;
@@ -50,18 +52,15 @@
   } FTC_SBitRec;
 
 
-  FT_EXPORT_DEF( FT_Error )
-  FTC_SBit_Cache_New( FTC_Manager      manager,
-                      FTC_SBit_Cache  *acache );
+  FT_EXPORT_DEF( FT_Error )  FTC_SBit_Cache_New( FTC_Manager      manager,
+                                                 FTC_SBit_Cache*  acache );
 
+  FT_EXPORT_DEF( FT_Error )  FTC_SBit_Cache_Lookup( FTC_SBit_Cache   cache,
+                                                    FTC_Image_Desc*  desc,
+                                                    FT_UInt          gindex,
+                                                    FTC_SBit        *sbit );
 
-  FT_EXPORT_DEF( FT_Error )
-  FTC_SBit_Cache_Lookup( FTC_SBit_Cache   cache,
-                         FTC_Image_Desc*  desc,
-                         FT_UInt          gindex,
-                         FTC_SBit        *sbit );
 
-
 #ifdef __cplusplus
   }
 #endif
@@ -69,5 +68,5 @@
 
 #endif /* FTCSBITS_H */
 
-/* END */
 
+/* END */