src/font.h

   1 /* font.h -- header file for the font module.
   2    Copyright (C) 2003, 2004
   3      National Institute of Advanced Industrial Science and Technology (AIST)
   4      Registration Number H15PRO112
   5
   6    This file is part of the m17n library.
   7
   8    The m17n library is free software; you can redistribute it and/or
   9    modify it under the terms of the GNU Lesser General Public License
  10    as published by the Free Software Foundation; either version 2.1 of
  11    the License, or (at your option) any later version.
  12
  13    The m17n library is distributed in the hope that it will be useful,
  14    but WITHOUT ANY WARRANTY; without even the implied warranty of
  15    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  16    Lesser General Public License for more details.
  17
  18    You should have received a copy of the GNU Lesser General Public
  19    License along with the m17n library; if not, write to the Free
  20    Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
  21    02111-1307, USA.  */
  22
  23 #ifndef _M17N_FONT_H_
  24 #define _M17N_FONT_H_
  25
  26 /** Type of font.  Now obsolete.  */
  27
  28 enum MFontType
  29   {
  30     /** Fonts supproted by a window system natively.  On X Window
  31         System, it is an X font.  */
  32     MFONT_TYPE_WIN,
  33
  34     /** Fonts supported by FreeType library.  */
  35     MFONT_TYPE_FT,
  36
  37     /** anchor */
  38     MFONT_TYPE_MAX
  39   };
  40
  41
  42 enum MFontProperty
  43   {
  44     /* The order of MFONT_FOUNDRY to MFONT_ADSTYLE must be the same as
  45        enum MFaceProperty.  */
  46     MFONT_FOUNDRY,
  47     MFONT_FAMILY,
  48     MFONT_WEIGHT,
  49     MFONT_STYLE,
  50     MFONT_STRETCH,
  51     MFONT_ADSTYLE,
  52     MFONT_REGISTRY,
  53     MFONT_SIZE,
  54     MFONT_RESY,
  55     /* anchor */
  56     MFONT_PROPERTY_MAX
  57   };
  58
  59 /** Information about a font.  This structure is used in three ways:
  60     FONT-OBJ, FONT-OPENED, and FONT-SPEC.
  61
  62     FONT-OBJ: To store information of an existing font.  Instances
  63     appear only in <font_list> of MDisplay.
  64
  65     FONT-OPENED: To store information of an opened font.  Instances
  66     appear only in <opend_list> of MDisplay.
  67
  68     FONT-SPEC: To store specifications of a font.  Instances appear
  69     only in <spec_list> of MFontset.  */
  70
  71 struct MFont
  72 {
  73   /** Numeric value of each font property.  Also used as an index to
  74       the table @c mfont__property_table to get the actual name of the
  75       property.
  76
  77       For FONT-OBJ, FONT-OPENED: The value is greater than zero.
  78
  79       For FONT-SPEC: The value is equal to or greater than zero.  Zero
  80       means that the correponding property is not specified (i.e. wild
  81       card).
  82
  83       <property>[MFONT_SIZE] is the size of the font in 1/10 pixels.
  84
  85       For FONT-OBJ: If the value is 0, the font is scalable or
  86       auto-scaled.
  87
  88       For FONT-OPENED: The actual size of opened font.
  89
  90       <prperty>[MFONT_RESY] is the designed resolution of the font in
  91       DPI, or zero.  Zero means that the font is scalable.
  92
  93       For the time being, we mention only Y-resolution (resy) and
  94       assume that resx is always equal to resy.  */
  95   unsigned short property[MFONT_PROPERTY_MAX];
  96 };
  97
  98 typedef struct
  99 {
 100   int size, inc, used;
 101   MSymbol property;
 102   MSymbol *names;
 103 } MFontPropertyTable;
 104
 105 extern MFontPropertyTable mfont__property_table[MFONT_REGISTRY + 1];
 106
 107 /** Return the symbol of the Nth font property of FONT.  */
 108 #define FONT_PROPERTY(font, n)  \
 109   mfont__property_table[(n)].names[(font)->property[(n)]]
 110
 111 typedef struct MFontEncoding MFontEncoding;
 112
 113 struct MRealizedFont
 114 {
 115   /* Frame on which the font is realized.  */
 116   MFrame *frame;
 117
 118   /* Font spec used to find the font.  */
 119   MFont spec;
 120
 121   /* Font spec requested by a face.  */
 122   MFont request;
 123
 124   /* The found font.  */
 125   MFont font;
 126
 127   /* How well <font> matches with <request>.  */
 128   int score;
 129
 130   MFontDriver *driver;
 131
 132   /* Font Layout Table for the font.  */
 133   MSymbol layouter;
 134
 135   /* 0: not yet tried to open
 136      -1: failed to open
 137      1: succeessfully opened.  */
 138   int status;
 139
 140   /* Extra information set by <driver>->select or <driver>->open.  If
 141      non-NULL, it must be a pointer to a managed object.  */
 142   void *info;
 143
 144   short ascent, descent;
 145
 146   MFontEncoding *encoding;
 147 };
 148
 149 /** Structure to hold a list of fonts of each registry.  */
 150
 151 typedef struct
 152 {
 153   MSymbol tag;
 154   int nfonts;
 155   MFont *fonts;
 156 } MFontList;
 157
 158
 159 struct MFontDriver
 160 {
 161   /** Return a font satisfying REQUEST and best matching with SPEC.
 162       For the moment, LIMITTED_SIZE is ignored.  */
 163   MRealizedFont *(*select) (MFrame *frame, MFont *spec, MFont *request,
 164                             int limitted_size);
 165
 166   /** Open a font specified by RFONT.  */
 167   int (*open) (MRealizedFont *rfont);
 168
 169   /** Set metrics of glyphs in GSTRING from FROM to TO.  */
 170   void (*find_metric) (MRealizedFont *rfont, MGlyphString *gstring,
 171                        int from, int to);
 172
 173   /** Encode C into the glyph code the font.  CODE is a code point of
 174       C in rfont->encoder->encoding_charset.  If the font has no glyph
 175       for C, return MCHAR_INVALID_CODE.  */
 176   unsigned (*encode_char) (MRealizedFont *rfont, int c, unsigned code);
 177
 178   /** Draw glyphs from FROM to TO (exclusive) on window WIN of FRAME
 179       at coordinate (X, Y) relative to WIN.  */
 180   void (*render) (MDrawWindow win, int x, int y,
 181                   MGlyphString *gstring, MGlyph *from, MGlyph *to,
 182                   int reverse, MDrawRegion region);
 183
 184   MFont *(*parse_name) (char *name, MFont *font);
 185   char *(*build_name) (MFont *font);
 186 };
 187
 188 /** Initialize the members of FONT.  */
 189
 190 #define MFONT_INIT(font) memset ((font), 0, sizeof (MFont))
 191
 192 extern MSymbol Mlayouter;
 193
 194 extern int mfont__flt_init ();
 195
 196 extern void mfont__flt_fini ();
 197
 198 #ifdef HAVE_FREETYPE
 199 #include <ft2build.h>
 200 #include FT_FREETYPE_H
 201
 202 #ifdef HAVE_OTF
 203 #include <otf.h>
 204 #endif /* HAVE_OTF */
 205
 206 typedef struct
 207 {
 208   M17NObject control;
 209   MFont font;
 210   char *filename;
 211   int otf_flag; /* This font is OTF (1), may be OTF (0), is not OTF (-1).  */
 212   MPlist *charmap_list;
 213   int charmap_index;
 214   FT_Face ft_face;
 215 #ifdef HAVE_OTF
 216   OTF *otf;
 217 #endif /* HAVE_OTF */
 218   void *extra_info;             /* Xft uses this member.  */
 219 } MFTInfo;
 220
 221 extern MFontDriver mfont__ft_driver;
 222
 223 extern int mfont__ft_init ();
 224
 225 extern void mfont__ft_fini ();
 226
 227 extern int mfont__ft_drive_otf (MGlyphString *gstring, int from, int to,
 228                                 MRealizedFont *rfont,
 229                                 MSymbol script, MSymbol langsys,
 230                                 MSymbol gsub_features, MSymbol gpos_features);
 231 extern int mfont__ft_decode_otf (MGlyph *g);
 232
 233 #endif /* HAVE_FREETYPE */
 234
 235 extern void mfont__free_realized (MRealizedFont *rfont);
 236
 237 extern int mfont__match_p (MFont *font, MFont *spec, int prop);
 238
 239 extern int mfont__score (MFont *font, MFont *spec, MFont *request,
 240                          int limitted_size);
 241
 242 extern void mfont__set_spec_from_face (MFont *spec, MFace *face);
 243
 244 extern MSymbol mfont__set_spec_from_plist (MFont *spec, MPlist *plist);
 245
 246 extern void mfont__resize (MFont *spec, MFont *request);
 247
 248 extern int mfont__encodable_p (MRealizedFont *rfont, MSymbol layouter_name,
 249                                int c);
 250
 251 extern unsigned mfont__encode_char (MRealizedFont *rfont, int c);
 252
 253 extern MRealizedFont *mfont__select (MFrame *frame, MFont *spec,
 254                                      MFont *request, int limitted_size,
 255                                      MSymbol layouter);
 256
 257 extern int mfont__open (MRealizedFont *rfont);
 258
 259 extern void mfont__get_metric (MGlyphString *gstring, int from, int to);
 260
 261 extern void mfont__set_property (MFont *font, enum MFontProperty key,
 262                                  MSymbol val);
 263
 264 extern int mfont__split_name (char *name, int *property_idx,
 265                               unsigned short *point, unsigned short *resy);
 266
 267 extern void mfont__set_spec (MFont *font,
 268                              MSymbol attrs[MFONT_PROPERTY_MAX],
 269                              unsigned short size, unsigned short resy);
 270
 271 extern unsigned mfont__flt_encode_char (MSymbol layouter_name, int c);
 272
 273 extern int mfont__flt_run (MGlyphString *gstring, int from, int to,
 274                            MRealizedFace *rface);
 275
 276 #endif /* _M17N_FONT_H_ */