fontconfig/fontconfig.h

   1 /*
   2  * $XFree86: xc/lib/fontconfig/fontconfig/fontconfig.h,v 1.4 2002/02/28 16:51:48 keithp Exp $
   3  *
   4  * Copyright © 2001 Keith Packard, member of The XFree86 Project, Inc.
   5  *
   6  * Permission to use, copy, modify, distribute, and sell this software and its
   7  * documentation for any purpose is hereby granted without fee, provided that
   8  * the above copyright notice appear in all copies and that both that
   9  * copyright notice and this permission notice appear in supporting
  10  * documentation, and that the name of Keith Packard not be used in
  11  * advertising or publicity pertaining to distribution of the software without
  12  * specific, written prior permission.  Keith Packard makes no
  13  * representations about the suitability of this software for any purpose.  It
  14  * is provided "as is" without express or implied warranty.
  15  *
  16  * KEITH PACKARD DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
  17  * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
  18  * EVENT SHALL KEITH PACKARD BE LIABLE FOR ANY SPECIAL, INDIRECT OR
  19  * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
  20  * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
  21  * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  22  * PERFORMANCE OF THIS SOFTWARE.
  23  */
  24
  25 #ifndef _FONTCONFIG_H_
  26 #define _FONTCONFIG_H_
  27
  28 #include <stdarg.h>
  29
  30 typedef unsigned char   FcChar8;
  31 typedef unsigned short  FcChar16;
  32 typedef unsigned int    FcChar32;
  33 typedef int             FcBool;
  34
  35 /*
  36  * Current Fontconfig version number
  37  */
  38 #define FC_MAJOR        1
  39 #define FC_MINOR        0
  40 #define FC_REVISION     0
  41
  42 #define FC_VERSION      ((FC_MAJOR * 10000) + (FC_MINOR * 100) + (FC_REVISION))
  43
  44 #define FcTrue          1
  45 #define FcFalse         0
  46
  47 #define FC_FAMILY           "family"            /* String */
  48 #define FC_STYLE            "style"             /* String */
  49 #define FC_SLANT            "slant"             /* Int */
  50 #define FC_WEIGHT           "weight"            /* Int */
  51 #define FC_SIZE             "size"              /* Double */
  52 #define FC_PIXEL_SIZE       "pixelsize"         /* Double */
  53 #define FC_SPACING          "spacing"           /* Int */
  54 #define FC_FOUNDRY          "foundry"           /* String */
  55 #define FC_ANTIALIAS        "antialias"         /* Bool (depends) */
  56 #define FC_HINTING          "hinting"           /* Bool (true) */
  57 #define FC_VERTICAL_LAYOUT  "verticallayout"    /* Bool (false) */
  58 #define FC_AUTOHINT         "autohint"          /* Bool (false) */
  59 #define FC_GLOBAL_ADVANCE   "globaladvance"     /* Bool (true) */
  60 #define FC_FILE             "file"              /* String */
  61 #define FC_INDEX            "index"             /* Int */
  62 #define FC_RASTERIZER       "rasterizer"        /* String */
  63 #define FC_OUTLINE          "outline"           /* Bool */
  64 #define FC_SCALABLE         "scalable"          /* Bool */
  65 #define FC_SCALE            "scale"             /* double */
  66 #define FC_DPI              "dpi"               /* double */
  67 #define FC_RGBA             "rgba"              /* Int */
  68 #define FC_MINSPACE         "minspace"          /* Bool use minimum line spacing */
  69 #define FC_SOURCE           "source"            /* String (X11, freetype) */
  70 #define FC_CHARSET          "charset"           /* CharSet */
  71 #define FC_LANG             "lang"              /* String OS/2 CodePageRange */
  72
  73 #define FC_DIR_CACHE_FILE           "fonts.cache"
  74 #define FC_USER_CACHE_FILE          ".fonts.cache"
  75
  76 /* Adjust outline rasterizer */
  77 #define FC_CHAR_WIDTH       "charwidth" /* Int */
  78 #define FC_CHAR_HEIGHT      "charheight"/* Int */
  79 #define FC_MATRIX           "matrix"    /* FcMatrix */
  80
  81 #define FC_WEIGHT_LIGHT     0
  82 #define FC_WEIGHT_MEDIUM    100
  83 #define FC_WEIGHT_DEMIBOLD  180
  84 #define FC_WEIGHT_BOLD      200
  85 #define FC_WEIGHT_BLACK     210
  86
  87 #define FC_SLANT_ROMAN      0
  88 #define FC_SLANT_ITALIC     100
  89 #define FC_SLANT_OBLIQUE    110
  90
  91 #define FC_PROPORTIONAL     0
  92 #define FC_MONO             100
  93 #define FC_CHARCELL         110
  94
  95 /* sub-pixel order */
  96 #define FC_RGBA_NONE        0
  97 #define FC_RGBA_RGB         1
  98 #define FC_RGBA_BGR         2
  99 #define FC_RGBA_VRGB        3
 100 #define FC_RGBA_VBGR        4
 101
 102 /* language groups from the OS/2 CodePageRange bits */
 103 #define FC_LANG_LATIN_1                 "latin1"                /* 0 */
 104 #define FC_LANG_LATIN_2_EASTERN_EUROPE  "latin2easterneurope"   /* 1 */
 105 #define FC_LANG_CYRILLIC                "cyrillic"              /* 2 */
 106 #define FC_LANG_GREEK                   "greek"                 /* 3 */
 107 #define FC_LANG_TURKISH                 "turkish"               /* 4 */
 108 #define FC_LANG_HEBREW                  "hebrew"                /* 5 */
 109 #define FC_LANG_ARABIC                  "arabic"                /* 6 */
 110 #define FC_LANG_WINDOWS_BALTIC          "windowsbaltic"         /* 7 */
 111 #define FC_LANG_VIETNAMESE              "vietnamese"            /* 8 */
 112 /* 9-15 reserved for Alternate ANSI */
 113 #define FC_LANG_THAI                    "thai"                  /* 16 */
 114 #define FC_LANG_JAPANESE                "japanese"              /* 17 */
 115 #define FC_LANG_SIMPLIFIED_CHINESE      "simplifiedchinese"     /* 18 */
 116 #define FC_LANG_KOREAN_WANSUNG          "koreanwansung"         /* 19 */
 117 #define FC_LANG_TRADITIONAL_CHINESE     "traditionalchinese"    /* 20 */
 118 #define FC_LANG_KOREAN_JOHAB            "koreanjohab"           /* 21 */
 119 /* 22-28 reserved for Alternate ANSI & OEM */
 120 #define FC_LANG_MACINTOSH               "macintosh"             /* 29 */
 121 #define FC_LANG_OEM                     "oem"                   /* 30 */
 122 #define FC_LANG_SYMBOL                  "symbol"                /* 31 */
 123 /* 32-47 reserved for OEM */
 124 #define FC_LANG_IBM_GREEK               "ibmgreek"              /* 48 */
 125 #define FC_LANG_MSDOS_RUSSIAN           "msdosrussian"          /* 49 */
 126 #define FC_LANG_MSDOS_NORDIC            "msdosnordic"           /* 50 */
 127 #define FC_LANG_ARABIC_864              "arabic864"             /* 51 */
 128 #define FC_LANG_MSDOS_CANADIAN_FRENCH   "msdoscanadianfrench"   /* 52 */
 129 #define FC_LANG_HEBREW_862              "hebrew862"             /* 53 */
 130 #define FC_LANG_MSDOS_ICELANDIC         "msdosicelandic"        /* 54 */
 131 #define FC_LANG_MSDOS_PORTUGUESE        "msdosportuguese"       /* 55 */
 132 #define FC_LANG_IBM_TURKISH             "ibmturkish"            /* 56 */
 133 #define FC_LANG_IBM_CYRILLIC            "ibmcyrillic"           /* 57 */
 134 #define FC_LANG_LATIN_2                 "latin2"                /* 58 */
 135 #define FC_LANG_MSDOS_BALTIC            "msdosbaltic"           /* 59 */
 136 #define FC_LANG_GREEK_437_G             "greek437g"             /* 60 */
 137 #define FC_LANG_ARABIC_ASMO_708         "arabicasmo708"         /* 61 */
 138 #define FC_LANG_WE_LATIN_1              "welatin1"              /* 62 */
 139 #define FC_LANG_US                      "us"                    /* 63 */
 140
 141 typedef enum _FcType {
 142     FcTypeVoid,
 143     FcTypeInteger,
 144     FcTypeDouble,
 145     FcTypeString,
 146     FcTypeBool,
 147     FcTypeMatrix,
 148     FcTypeCharSet
 149 } FcType;
 150
 151 typedef struct _FcMatrix {
 152     double xx, xy, yx, yy;
 153 } FcMatrix;
 154
 155 #define FcMatrixInit(m) ((m)->xx = (m)->yy = 1, \
 156                          (m)->xy = (m)->yx = 0)
 157
 158 /*
 159  * A data structure to represent the available glyphs in a font.
 160  * This is represented as a sparse boolean btree.
 161  */
 162
 163 typedef struct _FcCharSet FcCharSet;
 164
 165 typedef struct _FcObjectType {
 166     const char  *object;
 167     FcType      type;
 168 } FcObjectType;
 169
 170 typedef struct _FcConstant {
 171     const FcChar8  *name;
 172     const char  *object;
 173     int         value;
 174 } FcConstant;
 175
 176 typedef enum _FcResult {
 177     FcResultMatch, FcResultNoMatch, FcResultTypeMismatch, FcResultNoId
 178 } FcResult;
 179
 180 typedef struct _FcValue {
 181     FcType      type;
 182     union {
 183         const FcChar8   *s;
 184         int             i;
 185         FcBool          b;
 186         double          d;
 187         const FcMatrix  *m;
 188         const FcCharSet *c;
 189     } u;
 190 } FcValue;
 191
 192 typedef struct _FcPattern   FcPattern;
 193
 194 typedef struct _FcFontSet {
 195     int         nfont;
 196     int         sfont;
 197     FcPattern   **fonts;
 198 } FcFontSet;
 199
 200 typedef struct _FcObjectSet {
 201     int         nobject;
 202     int         sobject;
 203     const char  **objects;
 204 } FcObjectSet;
 205
 206 typedef enum _FcMatchKind {
 207     FcMatchPattern, FcMatchFont
 208 } FcMatchKind;
 209
 210 typedef enum _FcSetName {
 211     FcSetSystem = 0,
 212     FcSetApplication = 1
 213 } FcSetName;
 214
 215 #if defined(__cplusplus) || defined(c_plusplus) /* for C++ V2.0 */
 216 #define _FCFUNCPROTOBEGIN extern "C" {  /* do not leave open across includes */
 217 #define _FCFUNCPROTOEND }
 218 #else
 219 #define _FCFUNCPROTOBEGIN
 220 #define _FCFUNCPROTOEND
 221 #endif
 222
 223 typedef struct _FcConfig    FcConfig;
 224
 225 typedef struct _FcFileCache FcFileCache;
 226
 227 typedef struct _FcBlanks    FcBlanks;
 228
 229 _FCFUNCPROTOBEGIN
 230
 231 /* fcblanks.c */
 232 FcBlanks *
 233 FcBlanksCreate (void);
 234
 235 void
 236 FcBlanksDestroy (FcBlanks *b);
 237
 238 FcBool
 239 FcBlanksAdd (FcBlanks *b, FcChar32 ucs4);
 240
 241 FcBool
 242 FcBlanksIsMember (FcBlanks *b, FcChar32 ucs4);
 243
 244 /* fccfg.c */
 245 FcChar8 *
 246 FcConfigFilename (const FcChar8 *url);
 247
 248 FcConfig *
 249 FcConfigCreate (void);
 250
 251 void
 252 FcConfigDestroy (FcConfig *config);
 253
 254 FcBool
 255 FcConfigSetCurrent (FcConfig *config);
 256
 257 FcConfig *
 258 FcConfigGetCurrent (void);
 259
 260 FcBool
 261 FcConfigBuildFonts (FcConfig *config);
 262
 263 FcChar8 **
 264 FcConfigGetDirs (FcConfig   *config);
 265
 266 FcChar8 **
 267 FcConfigGetConfigFiles (FcConfig    *config);
 268
 269 FcChar8 *
 270 FcConfigGetCache (FcConfig  *config);
 271
 272 FcBlanks *
 273 FcConfigGetBlanks (FcConfig *config);
 274
 275 FcFontSet *
 276 FcConfigGetFonts (FcConfig      *config,
 277                   FcSetName     set);
 278
 279 FcBool
 280 FcConfigAppFontAddFile (FcConfig    *config,
 281                         const FcChar8  *file);
 282
 283 FcBool
 284 FcConfigAppFontAddDir (FcConfig     *config,
 285                        const FcChar8   *dir);
 286
 287 void
 288 FcConfigAppFontClear (FcConfig      *config);
 289
 290 FcBool
 291 FcConfigSubstitute (FcConfig    *config,
 292                     FcPattern   *p,
 293                     FcMatchKind kind);
 294
 295 /* fccharset.c */
 296 FcCharSet *
 297 FcCharSetCreate (void);
 298
 299 void
 300 FcCharSetDestroy (FcCharSet *fcs);
 301
 302 FcBool
 303 FcCharSetAddChar (FcCharSet *fcs, FcChar32 ucs4);
 304
 305 FcCharSet *
 306 FcCharSetCopy (FcCharSet *src);
 307
 308 FcBool
 309 FcCharSetEqual (const FcCharSet *a, const FcCharSet *b);
 310
 311 FcCharSet *
 312 FcCharSetIntersect (const FcCharSet *a, const FcCharSet *b);
 313
 314 FcCharSet *
 315 FcCharSetUnion (const FcCharSet *a, const FcCharSet *b);
 316
 317 FcCharSet *
 318 FcCharSetSubtract (const FcCharSet *a, const FcCharSet *b);
 319
 320 FcBool
 321 FcCharSetHasChar (const FcCharSet *fcs, FcChar32 ucs4);
 322
 323 FcChar32
 324 FcCharSetCount (const FcCharSet *a);
 325
 326 FcChar32
 327 FcCharSetIntersectCount (const FcCharSet *a, const FcCharSet *b);
 328
 329 FcChar32
 330 FcCharSetSubtractCount (const FcCharSet *a, const FcCharSet *b);
 331
 332 FcChar32
 333 FcCharSetCoverage (const FcCharSet *a, FcChar32 page, FcChar32 *result);
 334
 335 /* fcdbg.c */
 336 void
 337 FcValuePrint (FcValue v);
 338
 339 void
 340 FcPatternPrint (FcPattern *p);
 341
 342 void
 343 FcFontSetPrint (FcFontSet *s);
 344
 345 /* fcdefault.c */
 346 void
 347 FcDefaultSubstitute (FcPattern *pattern);
 348
 349 /* fcdir.c */
 350 FcBool
 351 FcFileScan (FcFontSet       *set,
 352             FcFileCache     *cache,
 353             FcBlanks        *blanks,
 354             const FcChar8   *file,
 355             FcBool          force);
 356
 357 FcBool
 358 FcDirScan (FcFontSet        *set,
 359            FcFileCache      *cache,
 360            FcBlanks         *blanks,
 361            const FcChar8    *dir,
 362            FcBool           force);
 363
 364 FcBool
 365 FcDirSave (FcFontSet *set, const FcChar8 *dir);
 366
 367 /* fcfreetype.c */
 368 FcPattern *
 369 FcFreeTypeQuery (const FcChar8 *file, int id, FcBlanks *blanks, int *count);
 370
 371 /* fcfs.c */
 372
 373 FcFontSet *
 374 FcFontSetCreate (void);
 375
 376 void
 377 FcFontSetDestroy (FcFontSet *s);
 378
 379 FcBool
 380 FcFontSetAdd (FcFontSet *s, FcPattern *font);
 381
 382 /* fcinit.c */
 383 FcBool
 384 FcInitFonts (void);
 385
 386 FcBool
 387 FcInitConfig (void);
 388
 389 FcBool
 390 FcInit (void);
 391
 392 /* fclist.c */
 393 FcObjectSet *
 394 FcObjectSetCreate (void);
 395
 396 FcBool
 397 FcObjectSetAdd (FcObjectSet *os, const char *object);
 398
 399 void
 400 FcObjectSetDestroy (FcObjectSet *os);
 401
 402 FcObjectSet *
 403 FcObjectSetVaBuild (const char *first, va_list va);
 404
 405 FcObjectSet *
 406 FcObjectSetBuild (const char *first, ...);
 407
 408 FcFontSet *
 409 FcFontSetList (FcConfig     *config,
 410                FcFontSet    **sets,
 411                int          nsets,
 412                FcPattern    *p,
 413                FcObjectSet  *os);
 414
 415 FcFontSet *
 416 FcFontList (FcConfig    *config,
 417             FcPattern   *p,
 418             FcObjectSet *os);
 419
 420 /* fcmatch.c */
 421 FcPattern *
 422 FcFontSetMatch (FcConfig    *config,
 423                 FcFontSet   **sets,
 424                 int         nsets,
 425                 FcPattern   *p,
 426                 FcResult    *result);
 427
 428 FcPattern *
 429 FcFontMatch (FcConfig   *config,
 430              FcPattern  *p,
 431              FcResult   *result);
 432
 433 /* fcmatrix.c */
 434 FcMatrix *
 435 FcMatrixCopy (const FcMatrix *mat);
 436
 437 FcBool
 438 FcMatrixEqual (const FcMatrix *mat1, const FcMatrix *mat2);
 439
 440 void
 441 FcMatrixMultiply (FcMatrix *result, const FcMatrix *a, const FcMatrix *b);
 442
 443 void
 444 FcMatrixRotate (FcMatrix *m, double c, double s);
 445
 446 void
 447 FcMatrixScale (FcMatrix *m, double sx, double sy);
 448
 449 void
 450 FcMatrixShear (FcMatrix *m, double sh, double sv);
 451
 452 /* fcname.c */
 453
 454 FcBool
 455 FcNameRegisterObjectTypes (const FcObjectType *types, int ntype);
 456
 457 FcBool
 458 FcNameUnregisterObjectTypes (const FcObjectType *types, int ntype);
 459
 460 const FcObjectType *
 461 FcNameGetObjectType (const char *object);
 462
 463 FcBool
 464 FcNameRegisterConstants (const FcConstant *consts, int nconsts);
 465
 466 FcBool
 467 FcNameUnregisterConstants (const FcConstant *consts, int nconsts);
 468
 469 const FcConstant *
 470 FcNameGetConstant (FcChar8 *string);
 471
 472 FcBool
 473 FcNameConstant (FcChar8 *string, int *result);
 474
 475 FcPattern *
 476 FcNameParse (const FcChar8 *name);
 477
 478 FcChar8 *
 479 FcNameUnparse (FcPattern *pat);
 480
 481 /* fcpat.c */
 482 FcPattern *
 483 FcPatternCreate (void);
 484
 485 FcPattern *
 486 FcPatternDuplicate (FcPattern *p);
 487
 488 void
 489 FcValueDestroy (FcValue v);
 490
 491 FcValue
 492 FcValueSave (FcValue v);
 493
 494 void
 495 FcPatternDestroy (FcPattern *p);
 496
 497 FcBool
 498 FcPatternAdd (FcPattern *p, const char *object, FcValue value, FcBool append);
 499
 500 FcResult
 501 FcPatternGet (FcPattern *p, const char *object, int id, FcValue *v);
 502
 503 FcBool
 504 FcPatternDel (FcPattern *p, const char *object);
 505
 506 FcBool
 507 FcPatternAddInteger (FcPattern *p, const char *object, int i);
 508
 509 FcBool
 510 FcPatternAddDouble (FcPattern *p, const char *object, double d);
 511
 512 FcBool
 513 FcPatternAddString (FcPattern *p, const char *object, const FcChar8 *s);
 514
 515 FcBool
 516 FcPatternAddMatrix (FcPattern *p, const char *object, const FcMatrix *s);
 517
 518 FcBool
 519 FcPatternAddCharSet (FcPattern *p, const char *object, const FcCharSet *c);
 520
 521 FcBool
 522 FcPatternAddBool (FcPattern *p, const char *object, FcBool b);
 523
 524 FcResult
 525 FcPatternGetInteger (FcPattern *p, const char *object, int n, int *i);
 526
 527 FcResult
 528 FcPatternGetDouble (FcPattern *p, const char *object, int n, double *d);
 529
 530 FcResult
 531 FcPatternGetString (FcPattern *p, const char *object, int n, FcChar8 ** s);
 532
 533 FcResult
 534 FcPatternGetMatrix (FcPattern *p, const char *object, int n, FcMatrix **s);
 535
 536 FcResult
 537 FcPatternGetCharSet (FcPattern *p, const char *object, int n, FcCharSet **c);
 538
 539 FcResult
 540 FcPatternGetBool (FcPattern *p, const char *object, int n, FcBool *b);
 541
 542 FcPattern *
 543 FcPatternVaBuild (FcPattern *orig, va_list va);
 544
 545 FcPattern *
 546 FcPatternBuild (FcPattern *orig, ...);
 547
 548 /* fcstr.c */
 549
 550 FcChar8 *
 551 FcStrCopy (const FcChar8 *s);
 552
 553 #define FcToLower(c)    (('A' <= (c) && (c) <= 'Z') ? (c) - 'A' + 'a' : (c))
 554
 555 int
 556 FcStrCmpIgnoreCase (const FcChar8 *s1, const FcChar8 *s2);
 557
 558 int
 559 FcUtf8ToUcs4 (FcChar8   *src_orig,
 560               FcChar32  *dst,
 561               int       len);
 562
 563 FcBool
 564 FcUtf8Len (FcChar8      *string,
 565            int          len,
 566            int          *nchar,
 567            int          *wchar);
 568
 569 /* fcxml.c */
 570 FcBool
 571 FcConfigParseAndLoad (FcConfig *config, const FcChar8 *file, FcBool complain);
 572
 573 _FCFUNCPROTOEND
 574
 575 #endif /* _FONTCONFIG_H_ */