fontconfig/fontconfig.h

   1 /*
   2  * $RCSId: xc/lib/fontconfig/fontconfig/fontconfig.h,v 1.30 2002/09/26 00:17:27 keithp Exp $
   3  *
   4  * Copyright © 2001 Keith Packard
   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 <sys/types.h>
  29 #include <sys/stat.h>
  30 #include <unistd.h>
  31 #include <stdarg.h>
  32
  33 #if defined(__GNUC__) && (__GNUC__ >= 4)
  34 #define FC_ATTRIBUTE_SENTINEL(x) __attribute__((__sentinel__(0)))
  35 #else
  36 #define FC_ATTRIBUTE_SENTINEL(x)
  37 #endif
  38
  39 #ifndef FcPublic
  40 #define FcPublic
  41 #endif
  42
  43 typedef unsigned char   FcChar8;
  44 typedef unsigned short  FcChar16;
  45 typedef unsigned int    FcChar32;
  46 typedef int             FcBool;
  47
  48 /*
  49  * Current Fontconfig version number.  This same number
  50  * must appear in the fontconfig configure.in file. Yes,
  51  * it'a a pain to synchronize version numbers like this.
  52  */
  53
  54 #define FC_MAJOR        2
  55 #define FC_MINOR        4
  56 #define FC_REVISION     1
  57
  58 #define FC_VERSION      ((FC_MAJOR * 10000) + (FC_MINOR * 100) + (FC_REVISION))
  59
  60 /*
  61  * Current font cache file format version
  62  * This is appended to the cache files so that multiple
  63  * versions of the library will peacefully coexist
  64  *
  65  * Change this value whenever the disk format for the cache file
  66  * changes in any non-compatible way.  Try to avoid such changes as
  67  * it means multiple copies of the font information.
  68  */
  69
  70 #define FC_CACHE_VERSION    "2"
  71
  72 #define FcTrue          1
  73 #define FcFalse         0
  74
  75 #define FC_FAMILY           "family"            /* String */
  76 #define FC_STYLE            "style"             /* String */
  77 #define FC_SLANT            "slant"             /* Int */
  78 #define FC_WEIGHT           "weight"            /* Int */
  79 #define FC_SIZE             "size"              /* Double */
  80 #define FC_ASPECT           "aspect"            /* Double */
  81 #define FC_PIXEL_SIZE       "pixelsize"         /* Double */
  82 #define FC_SPACING          "spacing"           /* Int */
  83 #define FC_FOUNDRY          "foundry"           /* String */
  84 #define FC_ANTIALIAS        "antialias"         /* Bool (depends) */
  85 #define FC_HINTING          "hinting"           /* Bool (true) */
  86 #define FC_HINT_STYLE       "hintstyle"         /* Int */
  87 #define FC_VERTICAL_LAYOUT  "verticallayout"    /* Bool (false) */
  88 #define FC_AUTOHINT         "autohint"          /* Bool (false) */
  89 #define FC_GLOBAL_ADVANCE   "globaladvance"     /* Bool (true) */
  90 #define FC_WIDTH            "width"             /* Int */
  91 #define FC_FILE             "file"              /* String */
  92 #define FC_INDEX            "index"             /* Int */
  93 #define FC_FT_FACE          "ftface"            /* FT_Face */
  94 #define FC_RASTERIZER       "rasterizer"        /* String */
  95 #define FC_OUTLINE          "outline"           /* Bool */
  96 #define FC_SCALABLE         "scalable"          /* Bool */
  97 #define FC_SCALE            "scale"             /* double */
  98 #define FC_DPI              "dpi"               /* double */
  99 #define FC_RGBA             "rgba"              /* Int */
 100 #define FC_MINSPACE         "minspace"          /* Bool use minimum line spacing */
 101 #define FC_SOURCE           "source"            /* String (deprecated) */
 102 #define FC_CHARSET          "charset"           /* CharSet */
 103 #define FC_LANG             "lang"              /* String RFC 3066 langs */
 104 #define FC_FONTVERSION      "fontversion"       /* Int from 'head' table */
 105 #define FC_FULLNAME         "fullname"          /* String */
 106 #define FC_FAMILYLANG       "familylang"        /* String RFC 3066 langs */
 107 #define FC_STYLELANG        "stylelang"         /* String RFC 3066 langs */
 108 #define FC_FULLNAMELANG     "fullnamelang"      /* String RFC 3066 langs */
 109 #define FC_CAPABILITY       "capability"        /* String */
 110 #define FC_FONTFORMAT       "fontformat"        /* String */
 111 #define FC_EMBOLDEN         "embolden"          /* Bool - true if emboldening needed*/
 112 #define FC_EMBEDDED_BITMAP  "embeddedbitmap"    /* Bool - true to enable embedded bitmaps */
 113 #define FC_DECORATIVE       "decorative"        /* Bool - true if style is a decorative variant */
 114
 115 #define FC_CACHE_SUFFIX             ".cache-"FC_CACHE_VERSION
 116 #define FC_DIR_CACHE_FILE           "fonts.cache-"FC_CACHE_VERSION
 117 #define FC_USER_CACHE_FILE          ".fonts.cache-"FC_CACHE_VERSION
 118
 119 /* Adjust outline rasterizer */
 120 #define FC_CHAR_WIDTH       "charwidth" /* Int */
 121 #define FC_CHAR_HEIGHT      "charheight"/* Int */
 122 #define FC_MATRIX           "matrix"    /* FcMatrix */
 123
 124 #define FC_WEIGHT_THIN              0
 125 #define FC_WEIGHT_EXTRALIGHT        40
 126 #define FC_WEIGHT_ULTRALIGHT        FC_WEIGHT_EXTRALIGHT
 127 #define FC_WEIGHT_LIGHT             50
 128 #define FC_WEIGHT_BOOK              75
 129 #define FC_WEIGHT_REGULAR           80
 130 #define FC_WEIGHT_NORMAL            FC_WEIGHT_REGULAR
 131 #define FC_WEIGHT_MEDIUM            100
 132 #define FC_WEIGHT_DEMIBOLD          180
 133 #define FC_WEIGHT_SEMIBOLD          FC_WEIGHT_DEMIBOLD
 134 #define FC_WEIGHT_BOLD              200
 135 #define FC_WEIGHT_EXTRABOLD         205
 136 #define FC_WEIGHT_ULTRABOLD         FC_WEIGHT_EXTRABOLD
 137 #define FC_WEIGHT_BLACK             210
 138 #define FC_WEIGHT_HEAVY             FC_WEIGHT_BLACK
 139
 140 #define FC_SLANT_ROMAN              0
 141 #define FC_SLANT_ITALIC             100
 142 #define FC_SLANT_OBLIQUE            110
 143
 144 #define FC_WIDTH_ULTRACONDENSED     50
 145 #define FC_WIDTH_EXTRACONDENSED     63
 146 #define FC_WIDTH_CONDENSED          75
 147 #define FC_WIDTH_SEMICONDENSED      87
 148 #define FC_WIDTH_NORMAL             100
 149 #define FC_WIDTH_SEMIEXPANDED       113
 150 #define FC_WIDTH_EXPANDED           125
 151 #define FC_WIDTH_EXTRAEXPANDED      150
 152 #define FC_WIDTH_ULTRAEXPANDED      200
 153
 154 #define FC_PROPORTIONAL             0
 155 #define FC_DUAL                     90
 156 #define FC_MONO                     100
 157 #define FC_CHARCELL                 110
 158
 159 /* sub-pixel order */
 160 #define FC_RGBA_UNKNOWN     0
 161 #define FC_RGBA_RGB         1
 162 #define FC_RGBA_BGR         2
 163 #define FC_RGBA_VRGB        3
 164 #define FC_RGBA_VBGR        4
 165 #define FC_RGBA_NONE        5
 166
 167 /* hinting style */
 168 #define FC_HINT_NONE        0
 169 #define FC_HINT_SLIGHT      1
 170 #define FC_HINT_MEDIUM      2
 171 #define FC_HINT_FULL        3
 172
 173 typedef enum _FcType {
 174     FcTypeVoid,
 175     FcTypeInteger,
 176     FcTypeDouble,
 177     FcTypeString,
 178     FcTypeBool,
 179     FcTypeMatrix,
 180     FcTypeCharSet,
 181     FcTypeFTFace,
 182     FcTypeLangSet
 183 } FcType;
 184
 185 typedef struct _FcMatrix {
 186     double xx, xy, yx, yy;
 187 } FcMatrix;
 188
 189 #define FcMatrixInit(m) ((m)->xx = (m)->yy = 1, \
 190                          (m)->xy = (m)->yx = 0)
 191
 192 /*
 193  * A data structure to represent the available glyphs in a font.
 194  * This is represented as a sparse boolean btree.
 195  */
 196
 197 typedef struct _FcCharSet FcCharSet;
 198
 199 typedef struct _FcObjectType {
 200     const char  *object;
 201     FcType      type;
 202 } FcObjectType;
 203
 204 typedef struct _FcConstant {
 205     const FcChar8  *name;
 206     const char  *object;
 207     int         value;
 208 } FcConstant;
 209
 210 typedef enum _FcResult {
 211     FcResultMatch, FcResultNoMatch, FcResultTypeMismatch, FcResultNoId,
 212     FcResultOutOfMemory
 213 } FcResult;
 214
 215 typedef struct _FcPattern   FcPattern;
 216
 217 typedef struct _FcLangSet   FcLangSet;
 218
 219 typedef struct _FcValue {
 220     FcType      type;
 221     union {
 222         const FcChar8   *s;
 223         int             i;
 224         FcBool          b;
 225         double          d;
 226         const FcMatrix  *m;
 227         const FcCharSet *c;
 228         void            *f;
 229         const FcPattern *p;
 230         const FcLangSet *l;
 231     } u;
 232 } FcValue;
 233
 234 typedef struct _FcFontSet {
 235     int         nfont;
 236     int         sfont;
 237     FcPattern   **fonts;
 238 } FcFontSet;
 239
 240 typedef struct _FcObjectSet {
 241     int         nobject;
 242     int         sobject;
 243     const char  **objects;
 244 } FcObjectSet;
 245
 246 typedef enum _FcMatchKind {
 247     FcMatchPattern, FcMatchFont, FcMatchScan
 248 } FcMatchKind;
 249
 250 typedef enum _FcLangResult {
 251     FcLangEqual, FcLangDifferentCountry, FcLangDifferentLang
 252 } FcLangResult;
 253
 254 typedef enum _FcSetName {
 255     FcSetSystem = 0,
 256     FcSetApplication = 1
 257 } FcSetName;
 258
 259 typedef struct _FcAtomic FcAtomic;
 260
 261 #if defined(__cplusplus) || defined(c_plusplus) /* for C++ V2.0 */
 262 #define _FCFUNCPROTOBEGIN extern "C" {  /* do not leave open across includes */
 263 #define _FCFUNCPROTOEND }
 264 #else
 265 #define _FCFUNCPROTOBEGIN
 266 #define _FCFUNCPROTOEND
 267 #endif
 268
 269 typedef enum { FcEndianBig, FcEndianLittle } FcEndian;
 270
 271 typedef struct _FcConfig    FcConfig;
 272
 273 typedef struct _FcGlobalCache   FcFileCache;
 274
 275 typedef struct _FcBlanks    FcBlanks;
 276
 277 typedef struct _FcStrList   FcStrList;
 278
 279 typedef struct _FcStrSet    FcStrSet;
 280
 281 typedef struct _FcCache     FcCache;
 282
 283 _FCFUNCPROTOBEGIN
 284
 285 /* fcblanks.c */
 286 FcPublic FcBlanks *
 287 FcBlanksCreate (void);
 288
 289 FcPublic void
 290 FcBlanksDestroy (FcBlanks *b);
 291
 292 FcPublic FcBool
 293 FcBlanksAdd (FcBlanks *b, FcChar32 ucs4);
 294
 295 FcPublic FcBool
 296 FcBlanksIsMember (FcBlanks *b, FcChar32 ucs4);
 297
 298 /* fccache.c */
 299
 300 FcPublic const FcChar8 *
 301 FcCacheDir(const FcCache *c);
 302
 303 FcPublic FcFontSet *
 304 FcCacheCopySet(const FcCache *c);
 305
 306 FcPublic const FcChar8 *
 307 FcCacheSubdir (const FcCache *c, int i);
 308
 309 FcPublic int
 310 FcCacheNumSubdir (const FcCache *c);
 311
 312 FcPublic int
 313 FcCacheNumFont (const FcCache *c);
 314
 315 FcPublic FcBool
 316 FcDirCacheUnlink (const FcChar8 *dir, FcConfig *config);
 317
 318 FcPublic FcBool
 319 FcDirCacheValid (const FcChar8 *cache_file);
 320
 321 /* fccfg.c */
 322 FcPublic FcChar8 *
 323 FcConfigHome (void);
 324
 325 FcPublic FcBool
 326 FcConfigEnableHome (FcBool enable);
 327
 328 FcPublic FcChar8 *
 329 FcConfigFilename (const FcChar8 *url);
 330
 331 FcPublic FcConfig *
 332 FcConfigCreate (void);
 333
 334 FcPublic void
 335 FcConfigDestroy (FcConfig *config);
 336
 337 FcPublic FcBool
 338 FcConfigSetCurrent (FcConfig *config);
 339
 340 FcPublic FcConfig *
 341 FcConfigGetCurrent (void);
 342
 343 FcPublic FcBool
 344 FcConfigUptoDate (FcConfig *config);
 345
 346 FcPublic FcBool
 347 FcConfigBuildFonts (FcConfig *config);
 348
 349 FcPublic FcStrList *
 350 FcConfigGetFontDirs (FcConfig   *config);
 351
 352 FcPublic FcStrList *
 353 FcConfigGetConfigDirs (FcConfig   *config);
 354
 355 FcPublic FcStrList *
 356 FcConfigGetConfigFiles (FcConfig    *config);
 357
 358 FcPublic FcChar8 *
 359 FcConfigGetCache (FcConfig  *config);
 360
 361 FcPublic FcBlanks *
 362 FcConfigGetBlanks (FcConfig *config);
 363
 364 FcPublic FcStrList *
 365 FcConfigGetCacheDirs (FcConfig  *config);
 366
 367 FcPublic int
 368 FcConfigGetRescanInverval (FcConfig *config);
 369
 370 FcPublic FcBool
 371 FcConfigSetRescanInverval (FcConfig *config, int rescanInterval);
 372
 373 FcPublic FcFontSet *
 374 FcConfigGetFonts (FcConfig      *config,
 375                   FcSetName     set);
 376
 377 FcPublic FcBool
 378 FcConfigAppFontAddFile (FcConfig    *config,
 379                         const FcChar8  *file);
 380
 381 FcPublic FcBool
 382 FcConfigAppFontAddDir (FcConfig     *config,
 383                        const FcChar8   *dir);
 384
 385 FcPublic void
 386 FcConfigAppFontClear (FcConfig      *config);
 387
 388 FcPublic FcBool
 389 FcConfigSubstituteWithPat (FcConfig     *config,
 390                            FcPattern    *p,
 391                            FcPattern    *p_pat,
 392                            FcMatchKind  kind);
 393
 394 FcPublic FcBool
 395 FcConfigSubstitute (FcConfig    *config,
 396                     FcPattern   *p,
 397                     FcMatchKind kind);
 398
 399 /* fccharset.c */
 400 FcPublic FcCharSet*
 401 FcCharSetCreate (void);
 402
 403 /* deprecated alias for FcCharSetCreate */
 404 FcPublic FcCharSet *
 405 FcCharSetNew (void);
 406
 407 FcPublic void
 408 FcCharSetDestroy (FcCharSet *fcs);
 409
 410 FcPublic FcBool
 411 FcCharSetAddChar (FcCharSet *fcs, FcChar32 ucs4);
 412
 413 FcPublic FcCharSet*
 414 FcCharSetCopy (FcCharSet *src);
 415
 416 FcPublic FcBool
 417 FcCharSetEqual (const FcCharSet *a, const FcCharSet *b);
 418
 419 FcPublic FcCharSet*
 420 FcCharSetIntersect (const FcCharSet *a, const FcCharSet *b);
 421
 422 FcPublic FcCharSet*
 423 FcCharSetUnion (const FcCharSet *a, const FcCharSet *b);
 424
 425 FcPublic FcCharSet*
 426 FcCharSetSubtract (const FcCharSet *a, const FcCharSet *b);
 427
 428 FcPublic FcBool
 429 FcCharSetHasChar (const FcCharSet *fcs, FcChar32 ucs4);
 430
 431 FcPublic FcChar32
 432 FcCharSetCount (const FcCharSet *a);
 433
 434 FcPublic FcChar32
 435 FcCharSetIntersectCount (const FcCharSet *a, const FcCharSet *b);
 436
 437 FcPublic FcChar32
 438 FcCharSetSubtractCount (const FcCharSet *a, const FcCharSet *b);
 439
 440 FcPublic FcBool
 441 FcCharSetIsSubset (const FcCharSet *a, const FcCharSet *b);
 442
 443 #define FC_CHARSET_MAP_SIZE (256/32)
 444 #define FC_CHARSET_DONE ((FcChar32) -1)
 445
 446 FcPublic FcChar32
 447 FcCharSetFirstPage (const FcCharSet *a,
 448                     FcChar32        map[FC_CHARSET_MAP_SIZE],
 449                     FcChar32        *next);
 450
 451 FcPublic FcChar32
 452 FcCharSetNextPage (const FcCharSet  *a,
 453                    FcChar32         map[FC_CHARSET_MAP_SIZE],
 454                    FcChar32         *next);
 455
 456 /*
 457  * old coverage API, rather hard to use correctly
 458  */
 459
 460 FcPublic FcChar32
 461 FcCharSetCoverage (const FcCharSet *a, FcChar32 page, FcChar32 *result);
 462
 463 /* fcdbg.c */
 464 FcPublic void
 465 FcValuePrint (const FcValue v);
 466
 467 FcPublic void
 468 FcPatternPrint (const FcPattern *p);
 469
 470 FcPublic void
 471 FcFontSetPrint (const FcFontSet *s);
 472
 473 /* fcdefault.c */
 474 FcPublic void
 475 FcDefaultSubstitute (FcPattern *pattern);
 476
 477 /* fcdir.c */
 478 FcPublic FcBool
 479 FcFileIsDir (const FcChar8 *file);
 480
 481 FcPublic FcBool
 482 FcFileScan (FcFontSet       *set,
 483             FcStrSet        *dirs,
 484             FcFileCache     *cache,
 485             FcBlanks        *blanks,
 486             const FcChar8   *file,
 487             FcBool          force);
 488
 489 FcPublic FcBool
 490 FcDirScan (FcFontSet        *set,
 491            FcStrSet         *dirs,
 492            FcFileCache      *cache,
 493            FcBlanks         *blanks,
 494            const FcChar8    *dir,
 495            FcBool           force);
 496
 497 FcPublic FcBool
 498 FcDirSave (FcFontSet *set, FcStrSet *dirs, const FcChar8 *dir);
 499
 500 FcPublic FcCache *
 501 FcDirCacheLoad (const FcChar8 *dir, FcConfig *config, FcChar8 **cache_file);
 502
 503 FcPublic FcCache *
 504 FcDirCacheRead (const FcChar8 *dir, FcBool force, FcConfig *config);
 505
 506 FcPublic FcCache *
 507 FcDirCacheLoadFile (const FcChar8 *cache_file, struct stat *file_stat);
 508
 509 FcPublic void
 510 FcDirCacheUnload (FcCache *cache);
 511
 512 /* fcfreetype.c */
 513 FcPublic FcPattern *
 514 FcFreeTypeQuery (const FcChar8 *file, int id, FcBlanks *blanks, int *count);
 515
 516 /* fcfs.c */
 517
 518 FcPublic FcFontSet *
 519 FcFontSetCreate (void);
 520
 521 FcPublic void
 522 FcFontSetDestroy (FcFontSet *s);
 523
 524 FcPublic FcBool
 525 FcFontSetAdd (FcFontSet *s, FcPattern *font);
 526
 527 /* fcinit.c */
 528 FcPublic FcConfig *
 529 FcInitLoadConfig (void);
 530
 531 FcPublic FcConfig *
 532 FcInitLoadConfigAndFonts (void);
 533
 534 FcPublic FcBool
 535 FcInit (void);
 536
 537 FcPublic void
 538 FcFini (void);
 539
 540 FcPublic int
 541 FcGetVersion (void);
 542
 543 FcPublic FcBool
 544 FcInitReinitialize (void);
 545
 546 FcPublic FcBool
 547 FcInitBringUptoDate (void);
 548
 549 /* fclang.c */
 550 FcPublic FcLangSet*
 551 FcLangSetCreate (void);
 552
 553 FcPublic void
 554 FcLangSetDestroy (FcLangSet *ls);
 555
 556 FcPublic FcLangSet*
 557 FcLangSetCopy (const FcLangSet *ls);
 558
 559 FcPublic FcBool
 560 FcLangSetAdd (FcLangSet *ls, const FcChar8 *lang);
 561
 562 FcPublic FcLangResult
 563 FcLangSetHasLang (const FcLangSet *ls, const FcChar8 *lang);
 564
 565 FcPublic FcLangResult
 566 FcLangSetCompare (const FcLangSet *lsa, const FcLangSet *lsb);
 567
 568 FcPublic FcBool
 569 FcLangSetContains (const FcLangSet *lsa, const FcLangSet *lsb);
 570
 571 FcPublic FcBool
 572 FcLangSetEqual (const FcLangSet *lsa, const FcLangSet *lsb);
 573
 574 FcPublic FcChar32
 575 FcLangSetHash (const FcLangSet *ls);
 576
 577 /* fclist.c */
 578 FcPublic FcObjectSet *
 579 FcObjectSetCreate (void);
 580
 581 FcPublic FcBool
 582 FcObjectSetAdd (FcObjectSet *os, const char *object);
 583
 584 FcPublic void
 585 FcObjectSetDestroy (FcObjectSet *os);
 586
 587 FcPublic FcObjectSet *
 588 FcObjectSetVaBuild (const char *first, va_list va);
 589
 590 FcPublic FcObjectSet *
 591 FcObjectSetBuild (const char *first, ...) FC_ATTRIBUTE_SENTINEL(0);
 592
 593 FcPublic FcFontSet *
 594 FcFontSetList (FcConfig     *config,
 595                FcFontSet    **sets,
 596                int          nsets,
 597                FcPattern    *p,
 598                FcObjectSet  *os);
 599
 600 FcPublic FcFontSet *
 601 FcFontList (FcConfig    *config,
 602             FcPattern   *p,
 603             FcObjectSet *os);
 604
 605 /* fcatomic.c */
 606
 607 FcPublic FcAtomic *
 608 FcAtomicCreate (const FcChar8   *file);
 609
 610 FcPublic FcBool
 611 FcAtomicLock (FcAtomic *atomic);
 612
 613 FcPublic FcChar8 *
 614 FcAtomicNewFile (FcAtomic *atomic);
 615
 616 FcPublic FcChar8 *
 617 FcAtomicOrigFile (FcAtomic *atomic);
 618
 619 FcPublic FcBool
 620 FcAtomicReplaceOrig (FcAtomic *atomic);
 621
 622 FcPublic void
 623 FcAtomicDeleteNew (FcAtomic *atomic);
 624
 625 FcPublic void
 626 FcAtomicUnlock (FcAtomic *atomic);
 627
 628 FcPublic void
 629 FcAtomicDestroy (FcAtomic *atomic);
 630
 631 /* fcmatch.c */
 632 FcPublic FcPattern *
 633 FcFontSetMatch (FcConfig    *config,
 634                 FcFontSet   **sets,
 635                 int         nsets,
 636                 FcPattern   *p,
 637                 FcResult    *result);
 638
 639 FcPublic FcPattern *
 640 FcFontMatch (FcConfig   *config,
 641              FcPattern  *p,
 642              FcResult   *result);
 643
 644 FcPublic FcPattern *
 645 FcFontRenderPrepare (FcConfig       *config,
 646                      FcPattern      *pat,
 647                      FcPattern      *font);
 648
 649 FcPublic FcFontSet *
 650 FcFontSetSort (FcConfig     *config,
 651                FcFontSet    **sets,
 652                int          nsets,
 653                FcPattern    *p,
 654                FcBool       trim,
 655                FcCharSet    **csp,
 656                FcResult     *result);
 657
 658 FcPublic FcFontSet *
 659 FcFontSort (FcConfig     *config,
 660             FcPattern    *p,
 661             FcBool       trim,
 662             FcCharSet    **csp,
 663             FcResult     *result);
 664
 665 FcPublic void
 666 FcFontSetSortDestroy (FcFontSet *fs);
 667
 668 /* fcmatrix.c */
 669 FcPublic FcMatrix *
 670 FcMatrixCopy (const FcMatrix *mat);
 671
 672 FcPublic FcBool
 673 FcMatrixEqual (const FcMatrix *mat1, const FcMatrix *mat2);
 674
 675 FcPublic void
 676 FcMatrixMultiply (FcMatrix *result, const FcMatrix *a, const FcMatrix *b);
 677
 678 FcPublic void
 679 FcMatrixRotate (FcMatrix *m, double c, double s);
 680
 681 FcPublic void
 682 FcMatrixScale (FcMatrix *m, double sx, double sy);
 683
 684 FcPublic void
 685 FcMatrixShear (FcMatrix *m, double sh, double sv);
 686
 687 /* fcname.c */
 688
 689 FcPublic FcBool
 690 FcNameRegisterObjectTypes (const FcObjectType *types, int ntype);
 691
 692 FcPublic FcBool
 693 FcNameUnregisterObjectTypes (const FcObjectType *types, int ntype);
 694
 695 FcPublic const FcObjectType *
 696 FcNameGetObjectType (const char *object);
 697
 698 FcPublic FcBool
 699 FcNameRegisterConstants (const FcConstant *consts, int nconsts);
 700
 701 FcPublic FcBool
 702 FcNameUnregisterConstants (const FcConstant *consts, int nconsts);
 703
 704 FcPublic const FcConstant *
 705 FcNameGetConstant (FcChar8 *string);
 706
 707 FcPublic FcBool
 708 FcNameConstant (FcChar8 *string, int *result);
 709
 710 FcPublic FcPattern *
 711 FcNameParse (const FcChar8 *name);
 712
 713 FcPublic FcChar8 *
 714 FcNameUnparse (FcPattern *pat);
 715
 716 /* fcpat.c */
 717 FcPublic FcPattern *
 718 FcPatternCreate (void);
 719
 720 FcPublic FcPattern *
 721 FcPatternDuplicate (const FcPattern *p);
 722
 723 FcPublic void
 724 FcPatternReference (FcPattern *p);
 725
 726 FcPublic void
 727 FcValueDestroy (FcValue v);
 728
 729 FcPublic FcBool
 730 FcValueEqual (FcValue va, FcValue vb);
 731
 732 FcPublic FcValue
 733 FcValueSave (FcValue v);
 734
 735 FcPublic void
 736 FcPatternDestroy (FcPattern *p);
 737
 738 FcPublic FcBool
 739 FcPatternEqual (const FcPattern *pa, const FcPattern *pb);
 740
 741 FcPublic FcBool
 742 FcPatternEqualSubset (const FcPattern *pa, const FcPattern *pb, const FcObjectSet *os);
 743
 744 FcPublic FcChar32
 745 FcPatternHash (const FcPattern *p);
 746
 747 FcPublic FcBool
 748 FcPatternAdd (FcPattern *p, const char *object, FcValue value, FcBool append);
 749
 750 FcPublic FcBool
 751 FcPatternAddWeak (FcPattern *p, const char *object, FcValue value, FcBool append);
 752
 753 FcPublic FcResult
 754 FcPatternGet (const FcPattern *p, const char *object, int id, FcValue *v);
 755
 756 FcPublic FcBool
 757 FcPatternDel (FcPattern *p, const char *object);
 758
 759 FcPublic FcBool
 760 FcPatternRemove (FcPattern *p, const char *object, int id);
 761
 762 FcPublic FcBool
 763 FcPatternAddInteger (FcPattern *p, const char *object, int i);
 764
 765 FcPublic FcBool
 766 FcPatternAddDouble (FcPattern *p, const char *object, double d);
 767
 768 FcPublic FcBool
 769 FcPatternAddString (FcPattern *p, const char *object, const FcChar8 *s);
 770
 771 FcPublic FcBool
 772 FcPatternAddMatrix (FcPattern *p, const char *object, const FcMatrix *s);
 773
 774 FcPublic FcBool
 775 FcPatternAddCharSet (FcPattern *p, const char *object, const FcCharSet *c);
 776
 777 FcPublic FcBool
 778 FcPatternAddBool (FcPattern *p, const char *object, FcBool b);
 779
 780 FcPublic FcBool
 781 FcPatternAddLangSet (FcPattern *p, const char *object, const FcLangSet *ls);
 782
 783 FcPublic FcResult
 784 FcPatternGetInteger (const FcPattern *p, const char *object, int n, int *i);
 785
 786 FcPublic FcResult
 787 FcPatternGetDouble (const FcPattern *p, const char *object, int n, double *d);
 788
 789 FcPublic FcResult
 790 FcPatternGetString (const FcPattern *p, const char *object, int n, FcChar8 ** s);
 791
 792 FcPublic FcResult
 793 FcPatternGetMatrix (const FcPattern *p, const char *object, int n, FcMatrix **s);
 794
 795 FcPublic FcResult
 796 FcPatternGetCharSet (const FcPattern *p, const char *object, int n, FcCharSet **c);
 797
 798 FcPublic FcResult
 799 FcPatternGetBool (const FcPattern *p, const char *object, int n, FcBool *b);
 800
 801 FcPublic FcResult
 802 FcPatternGetLangSet (const FcPattern *p, const char *object, int n, FcLangSet **ls);
 803
 804 FcPublic FcPattern *
 805 FcPatternVaBuild (FcPattern *orig, va_list va);
 806
 807 FcPublic FcPattern *
 808 FcPatternBuild (FcPattern *orig, ...) FC_ATTRIBUTE_SENTINEL(0);
 809
 810 /* fcstr.c */
 811
 812 FcPublic FcChar8 *
 813 FcStrCopy (const FcChar8 *s);
 814
 815 FcPublic FcChar8 *
 816 FcStrCopyFilename (const FcChar8 *s);
 817
 818 FcPublic FcChar8 *
 819 FcStrPlus (const FcChar8 *s1, const FcChar8 *s2);
 820
 821 FcPublic void
 822 FcStrFree (FcChar8 *s);
 823
 824 /* These are ASCII only, suitable only for pattern element names */
 825 #define FcIsUpper(c)    ((0101 <= (c) && (c) <= 0132))
 826 #define FcIsLower(c)    ((0141 <= (c) && (c) <= 0172))
 827 #define FcToLower(c)    (FcIsUpper(c) ? (c) - 0101 + 0141 : (c))
 828
 829 FcPublic FcChar8 *
 830 FcStrDowncase (const FcChar8 *s);
 831
 832 FcPublic int
 833 FcStrCmpIgnoreCase (const FcChar8 *s1, const FcChar8 *s2);
 834
 835 FcPublic int
 836 FcStrCmp (const FcChar8 *s1, const FcChar8 *s2);
 837
 838 FcPublic const FcChar8 *
 839 FcStrStrIgnoreCase (const FcChar8 *s1, const FcChar8 *s2);
 840
 841 FcPublic const FcChar8 *
 842 FcStrStr (const FcChar8 *s1, const FcChar8 *s2);
 843
 844 FcPublic int
 845 FcUtf8ToUcs4 (const FcChar8 *src_orig,
 846               FcChar32      *dst,
 847               int           len);
 848
 849 FcPublic FcBool
 850 FcUtf8Len (const FcChar8    *string,
 851            int              len,
 852            int              *nchar,
 853            int              *wchar);
 854
 855 #define FC_UTF8_MAX_LEN 6
 856
 857 FcPublic int
 858 FcUcs4ToUtf8 (FcChar32  ucs4,
 859               FcChar8   dest[FC_UTF8_MAX_LEN]);
 860
 861 FcPublic int
 862 FcUtf16ToUcs4 (const FcChar8    *src_orig,
 863                FcEndian         endian,
 864                FcChar32         *dst,
 865                int              len);       /* in bytes */
 866
 867 FcPublic FcBool
 868 FcUtf16Len (const FcChar8   *string,
 869             FcEndian        endian,
 870             int             len,            /* in bytes */
 871             int             *nchar,
 872             int             *wchar);
 873
 874 FcPublic FcChar8 *
 875 FcStrDirname (const FcChar8 *file);
 876
 877 FcPublic FcChar8 *
 878 FcStrBasename (const FcChar8 *file);
 879
 880 FcPublic FcStrSet *
 881 FcStrSetCreate (void);
 882
 883 FcPublic FcBool
 884 FcStrSetMember (FcPublic FcStrSet *set, const FcChar8 *s);
 885
 886 FcPublic FcBool
 887 FcStrSetEqual (FcPublic FcStrSet *sa, FcPublic FcStrSet *sb);
 888
 889 FcPublic FcBool
 890 FcStrSetAdd (FcPublic FcStrSet *set, const FcChar8 *s);
 891
 892 FcPublic FcBool
 893 FcStrSetAddFilename (FcPublic FcStrSet *set, const FcChar8 *s);
 894
 895 FcPublic FcBool
 896 FcStrSetDel (FcPublic FcStrSet *set, const FcChar8 *s);
 897
 898 FcPublic void
 899 FcStrSetDestroy (FcPublic FcStrSet *set);
 900
 901 FcPublic FcStrList *
 902 FcStrListCreate (FcPublic FcStrSet *set);
 903
 904 FcPublic FcChar8 *
 905 FcStrListNext (FcStrList *list);
 906
 907 FcPublic void
 908 FcStrListDone (FcStrList *list);
 909
 910 /* fcxml.c */
 911 FcPublic FcBool
 912 FcConfigParseAndLoad (FcConfig *config, const FcChar8 *file, FcBool complain);
 913
 914 _FCFUNCPROTOEND
 915
 916 #undef FC_ATTRIBUTE_SENTINEL
 917
 918 #endif /* _FONTCONFIG_H_ */