[Index] [TOC]

FreeType-2.5.2 API Reference

BDF and PCF Files

Synopsis

FT_PropertyTypeBDF_PropertyRecFT_Get_BDF_Property
BDF_PropertyFT_Get_BDF_Charset_ID


This section contains the declaration of functions specific to BDF and PCF fonts.


FT_PropertyType

Defined in FT_BDF_H (ftbdf.h).


  typedef enum  BDF_PropertyType_
  {
    BDF_PROPERTY_TYPE_NONE     = 0,
    BDF_PROPERTY_TYPE_ATOM     = 1,
    BDF_PROPERTY_TYPE_INTEGER  = 2,
    BDF_PROPERTY_TYPE_CARDINAL = 3

  } BDF_PropertyType;


A list of BDF property types.


values

BDF_PROPERTY_TYPE_NONE

Value 0 is used to indicate a missing property.

BDF_PROPERTY_TYPE_ATOM

Property is a string atom.

BDF_PROPERTY_TYPE_INTEGER

Property is a 32-bit signed integer.

BDF_PROPERTY_TYPE_CARDINAL

Property is a 32-bit unsigned integer.


[Index] [TOC]

BDF_Property

Defined in FT_BDF_H (ftbdf.h).


  typedef struct BDF_PropertyRec_*  BDF_Property;


A handle to a BDF_PropertyRec structure to model a given BDF/PCF property.



[Index] [TOC]

BDF_PropertyRec

Defined in FT_BDF_H (ftbdf.h).


  typedef struct  BDF_PropertyRec_
  {
    BDF_PropertyType  type;
    union {
      const char*     atom;
      FT_Int32        integer;
      FT_UInt32       cardinal;

    } u;

  } BDF_PropertyRec;


This structure models a given BDF/PCF property.


fields

type

The property type.

u.atom

The atom string, if type is BDF_PROPERTY_TYPE_ATOM.

u.integer

A signed integer, if type is BDF_PROPERTY_TYPE_INTEGER.

u.cardinal

An unsigned integer, if type is BDF_PROPERTY_TYPE_CARDINAL.


[Index] [TOC]

FT_Get_BDF_Charset_ID

Defined in FT_BDF_H (ftbdf.h).


  FT_EXPORT( FT_Error )
  FT_Get_BDF_Charset_ID( FT_Face       face,
                         const char*  *acharset_encoding,
                         const char*  *acharset_registry );


Retrieve a BDF font character set identity, according to the BDF specification.


input

face

A handle to the input face.

output

acharset_encoding

Charset encoding, as a C string, owned by the face.

acharset_registry

Charset registry, as a C string, owned by the face.

return

FreeType error code. 0 means success.

note

This function only works with BDF faces, returning an error otherwise.


[Index] [TOC]

FT_Get_BDF_Property

Defined in FT_BDF_H (ftbdf.h).


  FT_EXPORT( FT_Error )
  FT_Get_BDF_Property( FT_Face           face,
                       const char*       prop_name,
                       BDF_PropertyRec  *aproperty );


Retrieve a BDF property from a BDF or PCF font file.


input

face

A handle to the input face.

name

The property name.

output

aproperty

The property.

return

FreeType error code. 0 means success.

note

This function works with BDF and PCF fonts. It returns an error otherwise. It also returns an error if the property is not in the font.

A ‘property’ is a either key-value pair within the STARTPROPERTIES ... ENDPROPERTIES block of a BDF font or a key-value pair from the ‘info->props’ array within a ‘FontRec’ structure of a PCF font.

Integer properties are always stored as ‘signed’ within PCF fonts; consequently, BDF_PROPERTY_TYPE_CARDINAL is a possible return value for BDF fonts only.

In case of error, ‘aproperty->type’ is always set to BDF_PROPERTY_TYPE_NONE.


[Index] [TOC]