freetype.h

a very goog book

  /*    very likely to be faster anyway...                                 */
  /*                                                                       */
#define FT_FACE_FLAG_FAST_GLYPHS  0x80


  /*************************************************************************/
  /*                                                                       */
  /* <Constant>                                                            */
  /*    FT_FACE_FLAG_MULTIPLE_MASTERS                                      */
  /*                                                                       */
  /* <Description>                                                         */
  /*    A bit-field constant, used to indicate that the font contains      */
  /*    multiple masters and is capable of interpolating between them.     */
  /*    See the multiple-masters specific API for more details             */
  /*                                                                       */
#define FT_FACE_FLAG_MULTIPLE_MASTERS  0x100


  /*************************************************************************/
  /*                                                                       */
  /* <Constant>                                                            */
  /*    FT_FACE_FLAG_GLYPH_NAMES                                           */
  /*                                                                       */
  /* <Description>                                                         */
  /*    A bit-field constant, used to indicate that the font contains      */
  /*    glyph names that can be retrieved through @FT_Get_Glyph_Name().    */
  /*                                                                       */
#define FT_FACE_FLAG_GLYPH_NAMES  0x200


  /*************************************************************************/
  /*                                                                       */
  /* <Constant>                                                            */
  /*    FT_FACE_FLAG_EXTERNAL_STREAM                                       */
  /*                                                                       */
  /* <Description>                                                         */
  /*    This bit field is used internally by FreeType to indicate that     */
  /*    a face's stream was provided by the client application and should  */
  /*    not be destroyed by @FT_Done_Face().                               */
  /*                                                                       */
#define FT_FACE_FLAG_EXTERNAL_STREAM  0x4000


  /* */


  /*************************************************************************/
  /*                                                                       */
  /* @macro: FT_HAS_HORIZONTAL (face)                                      */
  /*                                                                       */
  /* @description:                                                         */
  /*   A macro that returns true whenever a face object contains           */
  /*   horizontal metrics (this is true for all font formats though).      */
  /*                                                                       */
  /* @also:                                                                */
  /*   @FT_HAS_VERTICAL can be used to check for vertical metrics.         */
  /*                                                                       */
#define FT_HAS_HORIZONTAL( face ) \
          ( face->face_flags & FT_FACE_FLAG_HORIZONTAL )


  /*************************************************************************/
  /*                                                                       */
  /* @macro: FT_HAS_VERTICAL (face)                                        */
  /*                                                                       */
  /* @description:                                                         */
  /*   A macro that returns true whenever a face object contains vertical  */
  /*   metrics.                                                            */
  /*                                                                       */
#define FT_HAS_VERTICAL( face ) \
          ( face->face_flags & FT_FACE_FLAG_VERTICAL )


  /*************************************************************************/
  /*                                                                       */
  /* @macro: FT_HAS_KERNING (face)                                         */
  /*                                                                       */
  /* @description:                                                         */
  /*   A macro that returns true whenever a face object contains kerning   */
  /*   data that can be accessed with @FT_Get_Kerning.                     */
  /*                                                                       */
#define FT_HAS_KERNING( face ) \
          ( face->face_flags & FT_FACE_FLAG_KERNING )


  /*************************************************************************/
  /*                                                                       */
  /* @macro: FT_IS_SCALABLE (face)                                         */
  /*                                                                       */
  /* @description:                                                         */
  /*   A macro that returns true whenever a face object contains a         */
  /*   scalable font face (true for TrueType, Type 1, CID, and             */
  /*   OpenType/CFF font formats.                                          */
  /*                                                                       */
#define FT_IS_SCALABLE( face ) \
          ( face->face_flags & FT_FACE_FLAG_SCALABLE )


  /*************************************************************************/
  /*                                                                       */
  /* @macro: FT_IS_SFNT (face)                                             */
  /*                                                                       */
  /* @description:                                                         */
  /*   A macro that returns true whenever a face object contains a font    */
  /*   whose format is based on the SFNT storage scheme.  This usually     */
  /*   means: TrueType fonts, OpenType fonts, as well as SFNT-based        */
  /*   embedded bitmap fonts.                                              */
  /*                                                                       */
  /*   If this macro is true, all functions defined in @FT_SFNT_NAMES_H    */
  /*   and @FT_TRUETYPE_TABLES_H are available.                            */
  /*                                                                       */
#define FT_IS_SFNT( face ) \
          ( face->face_flags & FT_FACE_FLAG_SFNT )


  /*************************************************************************/
  /*                                                                       */
  /* @macro: FT_IS_FIXED_WIDTH (face)                                      */
  /*                                                                       */
  /* @description:                                                         */
  /*   A macro that returns true whenever a face object contains a font    */
  /*   face that contains fixed-width (or "monospace", "fixed-pitch",      */
  /*   etc.) glyphs.                                                       */
  /*                                                                       */
#define FT_IS_FIXED_WIDTH( face ) \
          ( face->face_flags & FT_FACE_FLAG_FIXED_WIDTH )


  /*************************************************************************/
  /*                                                                       */
  /* @macro: FT_IS_FIXED_SIZES (face)                                      */
  /*                                                                       */
  /* @description:                                                         */
  /*   A macro that returns true whenever a face object contains some      */
  /*   embedded bitmaps.  See the `fixed_sizes' field of the @FT_FaceRec   */
  /*   structure.                                                          */
  /*                                                                       */
#define FT_HAS_FIXED_SIZES( face ) \
          ( face->face_flags & FT_FACE_FLAG_FIXED_SIZES )


   /* */


  /*************************************************************************/
  /*                                                                       */
  /* @macro: FT_HAS_FAST_GLYPHS (face)                                     */
  /*                                                                       */
  /* @description:                                                         */
  /*   Deprecated, indicates that the face contains so-called "fast"       */
  /*   glyph bitmaps.                                                      */
  /*                                                                       */
#define FT_HAS_FAST_GLYPHS( face ) \
          ( face->face_flags & FT_FACE_FLAG_FAST_GLYPHS )


  /*************************************************************************/
  /*                                                                       */
  /* @macro: FT_HAS_GLYPH_NAMES (face)                                     */
  /*                                                                       */
  /* @description:                                                         */
  /*   A macro that returns true whenever a face object contains some      */
  /*   glyph names that can be accessed through @FT_Get_Glyph_Names.       */
  /*                                                                       */
#define FT_HAS_GLYPH_NAMES( face ) \
          ( face->face_flags & FT_FACE_FLAG_GLYPH_NAMES )


  /*************************************************************************/
  /*                                                                       */
  /* @macro: FT_HAS_MULTIPLE_MASTERS (face)                                */
  /*                                                                       */
  /* @description:                                                         */
  /*   A macro that returns true whenever a face object contains some      */
  /*   multiple masters.  The functions provided by                        */
  /*   @FT_MULTIPLE_MASTERS_H are then available to choose the exact       */
  /*   design you want.                                                    */
  /*                                                                       */
#define FT_HAS_MULTIPLE_MASTERS( face ) \
          ( face->face_flags & FT_FACE_FLAG_MULTIPLE_MASTERS )


  /*************************************************************************/
  /*                                                                       */
  /* <Constant>                                                            */
  /*    FT_STYLE_FLAG_ITALIC                                               */
  /*                                                                       */
  /* <Description>                                                         */
  /*    A bit-field constant, used to indicate that a given face is        */
  /*    italicized.                                                        */
  /*                                                                       */
#define FT_STYLE_FLAG_ITALIC  1


  /*************************************************************************/
  /*                                                                       */
  /* <Constant>                                                            */
  /*    FT_STYLE_FLAG_BOLD                                                 */
  /*                                                                       */
  /* <Description>                                                         */
  /*    A bit-field constant, used to indicate that a given face is        */
  /*    emboldened.                                                        */
  /*                                                                       */
#define FT_STYLE_FLAG_BOLD  2


  /****************************************