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