bdf.h File Reference

#include <ft2build.h>

Include dependency graph for bdf.h:

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

Go to the source code of this file.

Classes
struct	bdf_options_t_
struct	bdf_property_t_
struct	bdf_bbx_t_
struct	bdf_glyph_t_
struct	bdf_font_t_

Macros
#define	_bdf_glyph_modified(map, e)    ( (map)[(e) >> 5] & ( 1UL << ( (e) & 31 ) ) )
#define	_bdf_set_glyph_modified(map, e)    ( (map)[(e) >> 5] |= ( 1UL << ( (e) & 31 ) ) )
#define	_bdf_clear_glyph_modified(map, e)    ( (map)[(e) >> 5] &= ~( 1UL << ( (e) & 31 ) ) )
#define	BDF_CORRECT_METRICS   0x01 /* Correct invalid metrics when loading. */
#define	BDF_KEEP_COMMENTS   0x02 /* Preserve the font comments. */
#define	BDF_KEEP_UNENCODED   0x04 /* Keep the unencoded glyphs. */
#define	BDF_PROPORTIONAL   0x08 /* Font has proportional spacing. */
#define	BDF_MONOWIDTH   0x10 /* Font has mono width. */
#define	BDF_CHARCELL   0x20 /* Font has charcell spacing. */
#define	BDF_ALL_SPACING
#define	BDF_DEFAULT_LOAD_OPTIONS
#define	BDF_ATOM   1
#define	BDF_INTEGER   2
#define	BDF_CARDINAL   3
#define	BDF_MISSING_START   -1
#define	BDF_MISSING_FONTNAME   -2
#define	BDF_MISSING_SIZE   -3
#define	BDF_MISSING_CHARS   -4
#define	BDF_MISSING_STARTCHAR   -5
#define	BDF_MISSING_ENCODING   -6
#define	BDF_MISSING_BBX   -7
#define	BDF_OUT_OF_MEMORY   -20
#define	BDF_INVALID_LINE   -100

Typedefs
typedef struct bdf_options_t_	bdf_options_t
typedef int(*	bdf_options_callback_t) (bdf_options_t *opts, char **params, unsigned long nparams, void *client_data)
typedef struct bdf_property_t_	bdf_property_t
typedef struct bdf_bbx_t_	bdf_bbx_t
typedef struct bdf_glyph_t_	bdf_glyph_t
typedef struct bdf_font_t_	bdf_font_t

Functions
	bdf_load_font (FT_Stream stream, FT_Memory memory, bdf_options_t *opts, bdf_font_t **font)
	bdf_free_font (bdf_font_t *font)
	bdf_get_property (char *name, bdf_font_t *font)
	bdf_get_font_property (bdf_font_t *font, const char *name)

Macro Definition Documentation

_bdf_clear_glyph_modified

#define _bdf_clear_glyph_modified	(		map,
			e
	)		( (map)[(e) >> 5] &= ~( 1UL << ( (e) & 31 ) ) )

Definition at line 48 of file bdf.h.

_bdf_glyph_modified

#define _bdf_glyph_modified	(		map,
			e
	)		( (map)[(e) >> 5] & ( 1UL << ( (e) & 31 ) ) )

Definition at line 44 of file bdf.h.

_bdf_set_glyph_modified

#define _bdf_set_glyph_modified	(		map,
			e
	)		( (map)[(e) >> 5] |= ( 1UL << ( (e) & 31 ) ) )

Definition at line 46 of file bdf.h.

BDF_ALL_SPACING

#define BDF_ALL_SPACING

Value:

                           ( BDF_PROPORTIONAL | \
                           BDF_MONOWIDTH    | \
                           BDF_CHARCELL     )

Definition at line 68 of file bdf.h.

BDF_ATOM

#define BDF_ATOM   1

Definition at line 103 of file bdf.h.

BDF_CARDINAL

#define BDF_CARDINAL   3

Definition at line 105 of file bdf.h.

BDF_CHARCELL

#define BDF_CHARCELL   0x20 /* Font has charcell spacing. */

Definition at line 66 of file bdf.h.

BDF_CORRECT_METRICS

#define BDF_CORRECT_METRICS   0x01 /* Correct invalid metrics when loading. */

Definition at line 61 of file bdf.h.

BDF_DEFAULT_LOAD_OPTIONS

#define BDF_DEFAULT_LOAD_OPTIONS

Value:

                                    ( BDF_CORRECT_METRICS | \
                                    BDF_KEEP_COMMENTS   | \
                                    BDF_KEEP_UNENCODED  | \
                                    BDF_PROPORTIONAL    )

Definition at line 72 of file bdf.h.

BDF_INTEGER

#define BDF_INTEGER   2

Definition at line 104 of file bdf.h.

BDF_INVALID_LINE

#define BDF_INVALID_LINE   -100

Definition at line 225 of file bdf.h.

BDF_KEEP_COMMENTS

#define BDF_KEEP_COMMENTS   0x02 /* Preserve the font comments. */

Definition at line 62 of file bdf.h.

BDF_KEEP_UNENCODED

#define BDF_KEEP_UNENCODED   0x04 /* Keep the unencoded glyphs. */

Definition at line 63 of file bdf.h.

BDF_MISSING_BBX

#define BDF_MISSING_BBX   -7

Definition at line 221 of file bdf.h.

BDF_MISSING_CHARS

#define BDF_MISSING_CHARS   -4

Definition at line 218 of file bdf.h.

BDF_MISSING_ENCODING

#define BDF_MISSING_ENCODING   -6

Definition at line 220 of file bdf.h.

BDF_MISSING_FONTNAME

#define BDF_MISSING_FONTNAME   -2

Definition at line 216 of file bdf.h.

BDF_MISSING_SIZE

#define BDF_MISSING_SIZE   -3

Definition at line 217 of file bdf.h.

BDF_MISSING_START

#define BDF_MISSING_START   -1

Definition at line 215 of file bdf.h.

BDF_MISSING_STARTCHAR

#define BDF_MISSING_STARTCHAR   -5

Definition at line 219 of file bdf.h.

BDF_MONOWIDTH

#define BDF_MONOWIDTH   0x10 /* Font has mono width. */

Definition at line 65 of file bdf.h.

BDF_OUT_OF_MEMORY

#define BDF_OUT_OF_MEMORY   -20

Definition at line 223 of file bdf.h.

BDF_PROPORTIONAL

#define BDF_PROPORTIONAL   0x08 /* Font has proportional spacing. */

Definition at line 64 of file bdf.h.

Typedef Documentation

bdf_bbx_t

typedef struct bdf_bbx_t_ bdf_bbx_t

bdf_font_t

typedef struct bdf_font_t_ bdf_font_t

bdf_glyph_t

typedef struct bdf_glyph_t_ bdf_glyph_t

bdf_options_callback_t

typedef int(* bdf_options_callback_t) (bdf_options_t *opts, char **params, unsigned long nparams, void *client_data)

Definition at line 89 of file bdf.h.

bdf_options_t

typedef struct bdf_options_t_ bdf_options_t

bdf_property_t

typedef struct bdf_property_t_ bdf_property_t

Function Documentation

bdf_free_font()

bdf_free_font

(

bdf_font_t *

font

)

Definition at line 2330 of file bdflib.c.

  {
    bdf_property_t*  prop;
    unsigned long    i;
    bdf_glyph_t*     glyphs;
    FT_Memory        memory;
 
 
    if ( font == 0 )
      return;
 
    memory = font->memory;
 
    FT_FREE( font->name );
 
    /* Free up the internal hash table of property names. */
    if ( font->internal )
    {
      ft_hash_str_free( (FT_Hash)font->internal, memory );
      FT_FREE( font->internal );
    }
 
    /* Free up the comment info. */
    FT_FREE( font->comments );
 
    /* Free up the properties. */
    for ( i = 0; i < font->props_size; i++ )
    {
      if ( font->props[i].format == BDF_ATOM )
        FT_FREE( font->props[i].value.atom );
    }
 
    FT_FREE( font->props );
 
    /* Free up the character info. */
    for ( i = 0, glyphs = font->glyphs;
          i < font->glyphs_used; i++, glyphs++ )
    {
      FT_FREE( glyphs->name );
      FT_FREE( glyphs->bitmap );
    }
 
    for ( i = 0, glyphs = font->unencoded; i < font->unencoded_used;
          i++, glyphs++ )
    {
      FT_FREE( glyphs->name );
      FT_FREE( glyphs->bitmap );
    }
 
    FT_FREE( font->glyphs );
    FT_FREE( font->unencoded );
 
    /* bdf_cleanup */
    ft_hash_str_free( &(font->proptbl), memory );
 
    /* Free up the user defined properties. */
    for ( prop = font->user_props, i = 0;
          i < font->nuser_props; i++, prop++ )
    {
      FT_FREE( prop->name );
      if ( prop->format == BDF_ATOM )
        FT_FREE( prop->value.atom );
    }
 
    FT_FREE( font->user_props );
 
    /* FREE( font ); */ /* XXX Fixme */
  }

Referenced by BDF_Face_Done(), and bdf_load_font().

bdf_get_font_property()

bdf_get_font_property	(	bdf_font_t *	font,
		const char *	name
	)

Definition at line 2401 of file bdflib.c.

  {
    size_t*  propid;
 
 
    if ( font == 0 || font->props_size == 0 || name == 0 || *name == 0 )
      return 0;
 
    propid = ft_hash_str_lookup( name, (FT_Hash)font->internal );
 
    return propid ? ( font->props + *propid ) : 0;
  }

Referenced by _bdf_parse_properties(), BDF_Face_Init(), bdf_get_bdf_property(), and bdf_interpret_style().

bdf_get_property()

bdf_get_property	(	char *	name,
		bdf_font_t *	font
	)

Definition at line 881 of file bdflib.c.

  {
    size_t*  propid;
 
 
    if ( name == 0 || *name == 0 )
      return 0;
 
    if ( ( propid = ft_hash_str_lookup( name, &(font->proptbl) ) ) == NULL )
      return 0;
 
    if ( *propid >= _num_bdf_properties )
      return font->user_props + ( *propid - _num_bdf_properties );
 
    return (bdf_property_t*)_bdf_properties + *propid;
  }

Referenced by _bdf_is_atom().

bdf_load_font()

bdf_load_font	(	FT_Stream	stream,
		FT_Memory	memory,
		bdf_options_t *	opts,
		bdf_font_t **	font
	)

Definition at line 2176 of file bdflib.c.

  {
    unsigned long  lineno = 0; /* make compiler happy */
    _bdf_parse_t   *p     = NULL;
 
    FT_Memory  memory = extmemory; /* needed for FT_NEW */
    FT_Error   error  = FT_Err_Ok;
 
 
    if ( FT_NEW( p ) )
      goto Exit;
 
    memory    = NULL;
    p->opts   = (bdf_options_t*)( ( opts != 0 ) ? opts : &_bdf_opts );
    p->minlb  = 32767;
    p->size   = stream->size;
    p->memory = extmemory;  /* only during font creation */
 
    _bdf_list_init( &p->list, extmemory );
 
    error = _bdf_readstream( stream, _bdf_parse_start,
                             (void *)p, &lineno );
    if ( error )
      goto Fail;
 
    if ( p->font != 0 )
    {
      /* If the font is not proportional, set the font's monowidth */
      /* field to the width of the font bounding box.              */
 
      if ( p->font->spacing != BDF_PROPORTIONAL )
        p->font->monowidth = p->font->bbx.width;
 
      /* If the number of glyphs loaded is not that of the original count, */
      /* indicate the difference.                                          */
      if ( p->cnt != p->font->glyphs_used + p->font->unencoded_used )
      {
        FT_TRACE2(( "bdf_load_font: " ACMSG15, p->cnt,
                    p->font->glyphs_used + p->font->unencoded_used ));
      }
 
      /* Once the font has been loaded, adjust the overall font metrics if */
      /* necessary.                                                        */
      if ( p->opts->correct_metrics != 0 &&
           ( p->font->glyphs_used > 0 || p->font->unencoded_used > 0 ) )
      {
        if ( p->maxrb - p->minlb != p->font->bbx.width )
        {
          FT_TRACE2(( "bdf_load_font: " ACMSG3,
                      p->font->bbx.width, p->maxrb - p->minlb ));
          p->font->bbx.width = (unsigned short)( p->maxrb - p->minlb );
        }
 
        if ( p->font->bbx.x_offset != p->minlb )
        {
          FT_TRACE2(( "bdf_load_font: " ACMSG4,
                      p->font->bbx.x_offset, p->minlb ));
          p->font->bbx.x_offset = p->minlb;
        }
 
        if ( p->font->bbx.ascent != p->maxas )
        {
          FT_TRACE2(( "bdf_load_font: " ACMSG5,
                      p->font->bbx.ascent, p->maxas ));
          p->font->bbx.ascent = p->maxas;
        }
 
        if ( p->font->bbx.descent != p->maxds )
        {
          FT_TRACE2(( "bdf_load_font: " ACMSG6,
                      p->font->bbx.descent, p->maxds ));
          p->font->bbx.descent  = p->maxds;
          p->font->bbx.y_offset = (short)( -p->maxds );
        }
 
        if ( p->maxas + p->maxds != p->font->bbx.height )
        {
          FT_TRACE2(( "bdf_load_font: " ACMSG7,
                      p->font->bbx.height, p->maxas + p->maxds ));
          p->font->bbx.height = (unsigned short)( p->maxas + p->maxds );
        }
 
        if ( p->flags & BDF_SWIDTH_ADJ_ )
          FT_TRACE2(( "bdf_load_font: " ACMSG8 ));
      }
    }
 
    if ( p->flags & BDF_START_ )
    {
      /* The ENDFONT field was never reached or did not exist. */
      if ( !( p->flags & BDF_GLYPHS_ ) )
      {
        /* Error happened while parsing header. */
        FT_ERROR(( "bdf_load_font: " ERRMSG2, lineno ));
        error = FT_THROW( Corrupted_Font_Header );
        goto Fail;
      }
      else
      {
        /* Error happened when parsing glyphs. */
        FT_ERROR(( "bdf_load_font: " ERRMSG3, lineno ));
        error = FT_THROW( Corrupted_Font_Glyphs );
        goto Fail;
      }
    }
 
    if ( p->font != 0 )
    {
      /* Make sure the comments are NULL terminated if they exist. */
      memory = p->font->memory;
 
      if ( p->font->comments_len > 0 )
      {
        if ( FT_RENEW_ARRAY( p->font->comments,
                             p->font->comments_len,
                             p->font->comments_len + 1 ) )
          goto Fail;
 
        p->font->comments[p->font->comments_len] = 0;
      }
    }
    else if ( !error )
      error = FT_THROW( Invalid_File_Format );
 
    *font = p->font;
 
  Exit:
    if ( p )
    {
      _bdf_list_done( &p->list );
 
      memory = extmemory;
 
      FT_FREE( p->glyph_name );
      FT_FREE( p );
    }
 
    return error;
 
  Fail:
    bdf_free_font( p->font );
 
    memory = extmemory;
 
    FT_FREE( p->font );
 
    goto Exit;
  }

Referenced by BDF_Face_Init().