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