lib/freetype/src/bdf/bdf.h

   1 /*
   2  * Copyright 2000 Computing Research Labs, New Mexico State University
   3  * Copyright 2001, 2002 Francesco Zappa Nardelli
   4  *
   5  * Permission is hereby granted, free of charge, to any person obtaining a
   6  * copy of this software and associated documentation files (the "Software"),
   7  * to deal in the Software without restriction, including without limitation
   8  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
   9  * and/or sell copies of the Software, and to permit persons to whom the
  10  * Software is furnished to do so, subject to the following conditions:
  11  *
  12  * The above copyright notice and this permission notice shall be included in
  13  * all copies or substantial portions of the Software.
  14  *
  15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  16  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  17  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  18  * THE COMPUTING RESEARCH LAB OR NEW MEXICO STATE UNIVERSITY BE LIABLE FOR ANY
  19  * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT
  20  * OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR
  21  * THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  22  */
  23
  24
  25 #ifndef __BDF_H__
  26 #define __BDF_H__
  27
  28
  29 /*
  30  * Based on bdf.h,v 1.16 2000/03/16 20:08:51 mleisher
  31  */
  32
  33 #include <ft2build.h>
  34 #include FT_INTERNAL_OBJECTS_H
  35 #include FT_INTERNAL_STREAM_H
  36
  37
  38 FT_BEGIN_HEADER
  39
  40
  41 /* Imported from bdfP.h */
  42
  43 #define _bdf_glyph_modified( map, e )                 \
  44           ( (map)[(e) >> 5] & ( 1 << ( (e) & 31 ) ) )
  45 #define _bdf_set_glyph_modified( map, e )              \
  46           ( (map)[(e) >> 5] |= ( 1 << ( (e) & 31 ) ) )
  47 #define _bdf_clear_glyph_modified( map, e )             \
  48           ( (map)[(e) >> 5] &= ~( 1 << ( (e) & 31 ) ) )
  49
  50 /* end of bdfP.h */
  51
  52
  53   /*************************************************************************/
  54   /*                                                                       */
  55   /* BDF font options macros and types.                                    */
  56   /*                                                                       */
  57   /*************************************************************************/
  58
  59
  60 #define BDF_CORRECT_METRICS  0x01 /* Correct invalid metrics when loading. */
  61 #define BDF_KEEP_COMMENTS    0x02 /* Preserve the font comments.           */
  62 #define BDF_KEEP_UNENCODED   0x04 /* Keep the unencoded glyphs.            */
  63 #define BDF_PROPORTIONAL     0x08 /* Font has proportional spacing.        */
  64 #define BDF_MONOWIDTH        0x10 /* Font has mono width.                  */
  65 #define BDF_CHARCELL         0x20 /* Font has charcell spacing.            */
  66
  67 #define BDF_ALL_SPACING  ( BDF_PROPORTIONAL | \
  68                            BDF_MONOWIDTH    | \
  69                            BDF_CHARCELL     )
  70
  71 #define BDF_DEFAULT_LOAD_OPTIONS  ( BDF_CORRECT_METRICS | \
  72                                     BDF_KEEP_COMMENTS   | \
  73                                     BDF_KEEP_UNENCODED  | \
  74                                     BDF_PROPORTIONAL    )
  75
  76
  77   typedef struct  bdf_options_t_
  78   {
  79     int            correct_metrics;
  80     int            keep_unencoded;
  81     int            keep_comments;
  82     int            font_spacing;
  83
  84   } bdf_options_t;
  85
  86
  87   /* Callback function type for unknown configuration options. */
  88   typedef int
  89   (*bdf_options_callback_t)( bdf_options_t*  opts,
  90                              char**          params,
  91                              unsigned long   nparams,
  92                              void*           client_data );
  93
  94
  95   /*************************************************************************/
  96   /*                                                                       */
  97   /* BDF font property macros and types.                                   */
  98   /*                                                                       */
  99   /*************************************************************************/
 100
 101
 102 #define BDF_ATOM      1
 103 #define BDF_INTEGER   2
 104 #define BDF_CARDINAL  3
 105
 106
 107   /* This structure represents a particular property of a font. */
 108   /* There are a set of defaults and each font has their own.   */
 109   typedef struct  bdf_property_t_
 110   {
 111     char*  name;         /* Name of the property.   */
 112     int    format;       /* Format of the property. */
 113     int    builtin;      /* A builtin property.     */
 114     union
 115     {
 116       char*          atom;
 117       long           int32;
 118       unsigned long  card32;
 119
 120     } value;             /* Value of the property.  */
 121
 122   } bdf_property_t;
 123
 124
 125   /*************************************************************************/
 126   /*                                                                       */
 127   /* BDF font metric and glyph types.                                      */
 128   /*                                                                       */
 129   /*************************************************************************/
 130
 131
 132   typedef struct  bdf_bbx_t_
 133   {
 134     unsigned short  width;
 135     unsigned short  height;
 136
 137     short           x_offset;
 138     short           y_offset;
 139
 140     short           ascent;
 141     short           descent;
 142
 143   } bdf_bbx_t;
 144
 145
 146   typedef struct  bdf_glyph_t_
 147   {
 148     char*           name;        /* Glyph name.                          */
 149     long            encoding;    /* Glyph encoding.                      */
 150     unsigned short  swidth;      /* Scalable width.                      */
 151     unsigned short  dwidth;      /* Device width.                        */
 152     bdf_bbx_t       bbx;         /* Glyph bounding box.                  */
 153     unsigned char*  bitmap;      /* Glyph bitmap.                        */
 154     unsigned long   bpr;         /* Number of bytes used per row.        */
 155     unsigned short  bytes;       /* Number of bytes used for the bitmap. */
 156
 157   } bdf_glyph_t;
 158
 159
 160   typedef struct  _hashnode_
 161   {
 162     char*  key;
 163     void*  data;
 164
 165   } _hashnode, *hashnode;
 166
 167
 168   typedef struct  hashtable_
 169   {
 170     int        limit;
 171     int        size;
 172     int        used;
 173     hashnode*  table;
 174
 175   } hashtable;
 176
 177
 178   typedef struct  bdf_glyphlist_t_
 179   {
 180     unsigned short  pad;          /* Pad to 4-byte boundary.              */
 181     unsigned short  bpp;          /* Bits per pixel.                      */
 182     long            start;        /* Beginning encoding value of glyphs.  */
 183     long            end;          /* Ending encoding value of glyphs.     */
 184     bdf_glyph_t*    glyphs;       /* Glyphs themselves.                   */
 185     unsigned long   glyphs_size;  /* Glyph structures allocated.          */
 186     unsigned long   glyphs_used;  /* Glyph structures used.               */
 187     bdf_bbx_t       bbx;          /* Overall bounding box of glyphs.      */
 188
 189   } bdf_glyphlist_t;
 190
 191
 192   typedef struct  bdf_font_t_
 193   {
 194     char*            name;           /* Name of the font.                   */
 195     bdf_bbx_t        bbx;            /* Font bounding box.                  */
 196
 197     long             point_size;     /* Point size of the font.             */
 198     unsigned long    resolution_x;   /* Font horizontal resolution.         */
 199     unsigned long    resolution_y;   /* Font vertical resolution.           */
 200
 201     int              spacing;        /* Font spacing value.                 */
 202
 203     unsigned short   monowidth;      /* Logical width for monowidth font.   */
 204
 205     long             default_glyph;  /* Encoding of the default glyph.      */
 206
 207     long             font_ascent;    /* Font ascent.                        */
 208     long             font_descent;   /* Font descent.                       */
 209
 210     unsigned long    glyphs_size;    /* Glyph structures allocated.         */
 211     unsigned long    glyphs_used;    /* Glyph structures used.              */
 212     bdf_glyph_t*     glyphs;         /* Glyphs themselves.                  */
 213
 214     unsigned long    unencoded_size; /* Unencoded glyph struct. allocated.  */
 215     unsigned long    unencoded_used; /* Unencoded glyph struct. used.       */
 216     bdf_glyph_t*     unencoded;      /* Unencoded glyphs themselves.        */
 217
 218     unsigned long    props_size;     /* Font properties allocated.          */
 219     unsigned long    props_used;     /* Font properties used.               */
 220     bdf_property_t*  props;          /* Font properties themselves.         */
 221
 222     char*            comments;       /* Font comments.                      */
 223     unsigned long    comments_len;   /* Length of comment string.           */
 224
 225     bdf_glyphlist_t  overflow;       /* Storage used for glyph insertion.   */
 226
 227     void*            internal;       /* Internal data for the font.         */
 228
 229     unsigned long    nmod[2048];     /* Bitmap indicating modified glyphs.  */
 230     unsigned long    umod[2048];     /* Bitmap indicating modified          */
 231                                      /* unencoded glyphs.                   */
 232     unsigned short   modified;       /* Boolean indicating font modified.   */
 233     unsigned short   bpp;            /* Bits per pixel.                     */
 234
 235     FT_Memory        memory;
 236
 237     bdf_property_t*  user_props;
 238     unsigned long    nuser_props;
 239     hashtable        proptbl;
 240
 241   } bdf_font_t;
 242
 243
 244   /*************************************************************************/
 245   /*                                                                       */
 246   /* Types for load/save callbacks.                                        */
 247   /*                                                                       */
 248   /*************************************************************************/
 249
 250
 251   /* Error codes. */
 252 #define BDF_MISSING_START       -1
 253 #define BDF_MISSING_FONTNAME    -2
 254 #define BDF_MISSING_SIZE        -3
 255 #define BDF_MISSING_CHARS       -4
 256 #define BDF_MISSING_STARTCHAR   -5
 257 #define BDF_MISSING_ENCODING    -6
 258 #define BDF_MISSING_BBX         -7
 259
 260 #define BDF_OUT_OF_MEMORY      -20
 261
 262 #define BDF_INVALID_LINE      -100
 263
 264
 265   /*************************************************************************/
 266   /*                                                                       */
 267   /* BDF font API.                                                         */
 268   /*                                                                       */
 269   /*************************************************************************/
 270
 271   FT_LOCAL( FT_Error )
 272   bdf_load_font( FT_Stream       stream,
 273                  FT_Memory       memory,
 274                  bdf_options_t*  opts,
 275                  bdf_font_t*    *font );
 276
 277   FT_LOCAL( void )
 278   bdf_free_font( bdf_font_t*  font );
 279
 280   FT_LOCAL( bdf_property_t * )
 281   bdf_get_property( char*        name,
 282                     bdf_font_t*  font );
 283
 284   FT_LOCAL( bdf_property_t * )
 285   bdf_get_font_property( bdf_font_t*  font,
 286                          char*        name );
 287
 288
 289 FT_END_HEADER
 290
 291
 292 #endif /* __BDF_H__ */
 293
 294
 295 /* END */