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     92
  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);
 280
 281 FcBool
 282 FcDirCacheHasCurrentArch (const FcChar8 *dir);
 283
 284 FcBool
 285 FcDirCacheUnlink (const FcChar8 *dir);
 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 FcStrList *
 332 FcConfigGetConfigDirs (FcConfig   *config);
 333
 334 FcStrList *
 335 FcConfigGetConfigFiles (FcConfig    *config);
 336
 337 FcChar8 *
 338 FcConfigGetCache (FcConfig  *config);
 339
 340 FcBlanks *
 341 FcConfigGetBlanks (FcConfig *config);
 342
 343 int
 344 FcConfigGetRescanInverval (FcConfig *config);
 345
 346 FcBool
 347 FcConfigSetRescanInverval (FcConfig *config, int rescanInterval);
 348
 349 FcFontSet *
 350 FcConfigGetFonts (FcConfig      *config,
 351                   FcSetName     set);
 352
 353 FcBool
 354 FcConfigAppFontAddFile (FcConfig    *config,
 355                         const FcChar8  *file);
 356
 357 FcBool
 358 FcConfigAppFontAddDir (FcConfig     *config,
 359                        const FcChar8   *dir);
 360
 361 void
 362 FcConfigAppFontClear (FcConfig      *config);
 363
 364 FcBool
 365 FcConfigSubstituteWithPat (FcConfig     *config,
 366                            FcPattern    *p,
 367                            FcPattern    *p_pat,
 368                            FcMatchKind  kind);
 369
 370 FcBool
 371 FcConfigSubstitute (FcConfig    *config,
 372                     FcPattern   *p,
 373                     FcMatchKind kind);
 374
 375 /* fccharset.c */
 376 FcCharSet *
 377 FcCharSetCreate (void);
 378
 379 void
 380 FcCharSetDestroy (FcCharSet *fcs);
 381
 382 FcBool
 383 FcCharSetAddChar (FcCharSet *fcs, FcChar32 ucs4);
 384
 385 FcCharSet *
 386 FcCharSetCopy (FcCharSet *src);
 387
 388 FcBool
 389 FcCharSetEqual (const FcCharSet *a, const FcCharSet *b);
 390
 391 FcCharSet *
 392 FcCharSetIntersect (const FcCharSet *a, const FcCharSet *b);
 393
 394 FcCharSet *
 395 FcCharSetUnion (const FcCharSet *a, const FcCharSet *b);
 396
 397 FcCharSet *
 398 FcCharSetSubtract (const FcCharSet *a, const FcCharSet *b);
 399
 400 FcBool
 401 FcCharSetHasChar (const FcCharSet *fcs, FcChar32 ucs4);
 402
 403 FcChar32
 404 FcCharSetCount (const FcCharSet *a);
 405
 406 FcChar32
 407 FcCharSetIntersectCount (const FcCharSet *a, const FcCharSet *b);
 408
 409 FcChar32
 410 FcCharSetSubtractCount (const FcCharSet *a, const FcCharSet *b);
 411
 412 FcBool
 413 FcCharSetIsSubset (const FcCharSet *a, const FcCharSet *b);
 414
 415 #define FC_CHARSET_MAP_SIZE (256/32)
 416 #define FC_CHARSET_DONE ((FcChar32) -1)
 417
 418 FcChar32
 419 FcCharSetFirstPage (const FcCharSet *a,
 420                     FcChar32        map[FC_CHARSET_MAP_SIZE],
 421                     FcChar32        *next);
 422
 423 FcChar32
 424 FcCharSetNextPage (const FcCharSet  *a,
 425                    FcChar32         map[FC_CHARSET_MAP_SIZE],
 426                    FcChar32         *next);
 427
 428
 429 /* fcdbg.c */
 430 void
 431 FcValuePrint (const FcValue v);
 432
 433 void
 434 FcPatternPrint (const FcPattern *p);
 435
 436 void
 437 FcFontSetPrint (const FcFontSet *s);
 438
 439 /* fcdefault.c */
 440 void
 441 FcDefaultSubstitute (FcPattern *pattern);
 442
 443 /* fcdir.c */
 444 FcBool
 445 FcFileScan (FcFontSet       *set,
 446             FcStrSet        *dirs,
 447             FcFileCache     *cache,
 448             FcBlanks        *blanks,
 449             const FcChar8   *file,
 450             FcBool          force);
 451
 452 FcBool
 453 FcDirScan (FcFontSet        *set,
 454            FcStrSet         *dirs,
 455            FcFileCache      *cache,
 456            FcBlanks         *blanks,
 457            const FcChar8    *dir,
 458            FcBool           force);
 459
 460 FcBool
 461 FcDirSave (FcFontSet *set, FcStrSet *dirs, const FcChar8 *dir);
 462
 463 /* fcfreetype.c */
 464 FcPattern *
 465 FcFreeTypeQuery (const FcChar8 *file, int id, FcBlanks *blanks, int *count);
 466
 467 /* fcfs.c */
 468
 469 FcFontSet *
 470 FcFontSetCreate (void);
 471
 472 void
 473 FcFontSetDestroy (FcFontSet *s);
 474
 475 FcBool
 476 FcFontSetAdd (FcFontSet *s, FcPattern *font);
 477
 478 /* fcinit.c */
 479 FcConfig *
 480 FcInitLoadConfig (void);
 481
 482 FcConfig *
 483 FcInitLoadConfigAndFonts (void);
 484
 485 FcBool
 486 FcInit (void);
 487
 488 void
 489 FcFini (void);
 490
 491 int
 492 FcGetVersion (void);
 493
 494 FcBool
 495 FcInitReinitialize (void);
 496
 497 FcBool
 498 FcInitBringUptoDate (void);
 499
 500 /* fclang.c */
 501 FcLangSet *
 502 FcLangSetCreate (void);
 503
 504 void
 505 FcLangSetDestroy (FcLangSet *ls);
 506
 507 FcLangSet *
 508 FcLangSetCopy (const FcLangSet *ls);
 509
 510 FcBool
 511 FcLangSetAdd (FcLangSet *ls, const FcChar8 *lang);
 512
 513 FcLangResult
 514 FcLangSetHasLang (const FcLangSet *ls, const FcChar8 *lang);
 515
 516 FcLangResult
 517 FcLangSetCompare (const FcLangSet *lsa, const FcLangSet *lsb);
 518
 519 FcBool
 520 FcLangSetContains (const FcLangSet *lsa, const FcLangSet *lsb);
 521
 522 FcBool
 523 FcLangSetEqual (const FcLangSet *lsa, const FcLangSet *lsb);
 524
 525 FcChar32
 526 FcLangSetHash (const FcLangSet *ls);
 527
 528 /* fclist.c */
 529 FcObjectSet *
 530 FcObjectSetCreate (void);
 531
 532 FcBool
 533 FcObjectSetAdd (FcObjectSet *os, const char *object);
 534
 535 void
 536 FcObjectSetDestroy (FcObjectSet *os);
 537
 538 FcObjectSet *
 539 FcObjectSetVaBuild (const char *first, va_list va);
 540
 541 FcObjectSet *
 542 FcObjectSetBuild (const char *first, ...) FC_ATTRIBUTE_SENTINEL(0);
 543
 544 FcFontSet *
 545 FcFontSetList (FcConfig     *config,
 546                FcFontSet    **sets,
 547                int          nsets,
 548                FcPattern    *p,
 549                FcObjectSet  *os);
 550
 551 FcFontSet *
 552 FcFontList (FcConfig    *config,
 553             FcPattern   *p,
 554             FcObjectSet *os);
 555
 556 /* fcatomic.c */
 557
 558 FcAtomic *
 559 FcAtomicCreate (const FcChar8   *file);
 560
 561 FcBool
 562 FcAtomicLock (FcAtomic *atomic);
 563
 564 FcChar8 *
 565 FcAtomicNewFile (FcAtomic *atomic);
 566
 567 FcChar8 *
 568 FcAtomicOrigFile (FcAtomic *atomic);
 569
 570 FcBool
 571 FcAtomicReplaceOrig (FcAtomic *atomic);
 572
 573 void
 574 FcAtomicDeleteNew (FcAtomic *atomic);
 575
 576 void
 577 FcAtomicUnlock (FcAtomic *atomic);
 578
 579 void
 580 FcAtomicDestroy (FcAtomic *atomic);
 581
 582 /* fcmatch.c */
 583 FcPattern *
 584 FcFontSetMatch (FcConfig    *config,
 585                 FcFontSet   **sets,
 586                 int         nsets,
 587                 FcPattern   *p,
 588                 FcResult    *result);
 589
 590 FcPattern *
 591 FcFontMatch (FcConfig   *config,
 592              FcPattern  *p,
 593              FcResult   *result);
 594
 595 FcPattern *
 596 FcFontRenderPrepare (FcConfig       *config,
 597                      FcPattern      *pat,
 598                      FcPattern      *font);
 599
 600 FcFontSet *
 601 FcFontSetSort (FcConfig     *config,
 602                FcFontSet    **sets,
 603                int          nsets,
 604                FcPattern    *p,
 605                FcBool       trim,
 606                FcCharSet    **csp,
 607                FcResult     *result);
 608
 609 FcFontSet *
 610 FcFontSort (FcConfig     *config,
 611             FcPattern    *p,
 612             FcBool       trim,
 613             FcCharSet    **csp,
 614             FcResult     *result);
 615
 616 void
 617 FcFontSetSortDestroy (FcFontSet *fs);
 618
 619 /* fcmatrix.c */
 620 FcMatrix *
 621 FcMatrixCopy (const FcMatrix *mat);
 622
 623 FcBool
 624 FcMatrixEqual (const FcMatrix *mat1, const FcMatrix *mat2);
 625
 626 void
 627 FcMatrixMultiply (FcMatrix *result, const FcMatrix *a, const FcMatrix *b);
 628
 629 void
 630 FcMatrixRotate (FcMatrix *m, double c, double s);
 631
 632 void
 633 FcMatrixScale (FcMatrix *m, double sx, double sy);
 634
 635 void
 636 FcMatrixShear (FcMatrix *m, double sh, double sv);
 637
 638 /* fcname.c */
 639
 640 FcBool
 641 FcNameRegisterObjectTypes (const FcObjectType *types, int ntype);
 642
 643 FcBool
 644 FcNameUnregisterObjectTypes (const FcObjectType *types, int ntype);
 645
 646 const FcObjectType *
 647 FcNameGetObjectType (const char *object);
 648
 649 FcBool
 650 FcNameRegisterConstants (const FcConstant *consts, int nconsts);
 651
 652 FcBool
 653 FcNameUnregisterConstants (const FcConstant *consts, int nconsts);
 654
 655 const FcConstant *
 656 FcNameGetConstant (FcChar8 *string);
 657
 658 FcBool
 659 FcNameConstant (FcChar8 *string, int *result);
 660
 661 FcPattern *
 662 FcNameParse (const FcChar8 *name);
 663
 664 FcChar8 *
 665 FcNameUnparse (FcPattern *pat);
 666
 667 FcChar8 *
 668 FcNameUnparseEscaped (FcPattern *pat, FcBool escape);
 669
 670 /* fcpat.c */
 671 FcPattern *
 672 FcPatternCreate (void);
 673
 674 FcPattern *
 675 FcPatternDuplicate (const FcPattern *p);
 676
 677 void
 678 FcPatternReference (FcPattern *p);
 679
 680 void
 681 FcValueDestroy (FcValue v);
 682
 683 FcBool
 684 FcValueEqual (FcValue va, FcValue vb);
 685
 686 FcValue
 687 FcValueSave (FcValue v);
 688
 689 void
 690 FcPatternDestroy (FcPattern *p);
 691
 692 FcBool
 693 FcPatternEqual (const FcPattern *pa, const FcPattern *pb);
 694
 695 FcBool
 696 FcPatternEqualSubset (const FcPattern *pa, const FcPattern *pb, const FcObjectSet *os);
 697
 698 FcChar32
 699 FcPatternHash (const FcPattern *p);
 700
 701 FcBool
 702 FcPatternAdd (FcPattern *p, const char *object, FcValue value, FcBool append);
 703
 704 FcBool
 705 FcPatternAddWeak (FcPattern *p, const char *object, FcValue value, FcBool append);
 706
 707 FcResult
 708 FcPatternGet (const FcPattern *p, const char *object, int id, FcValue *v);
 709
 710 FcBool
 711 FcPatternDel (FcPattern *p, const char *object);
 712
 713 FcBool
 714 FcPatternRemove (FcPattern *p, const char *object, int id);
 715
 716 FcBool
 717 FcPatternAddInteger (FcPattern *p, const char *object, int i);
 718
 719 FcBool
 720 FcPatternAddDouble (FcPattern *p, const char *object, double d);
 721
 722 FcBool
 723 FcPatternAddString (FcPattern *p, const char *object, const FcChar8 *s);
 724
 725 FcBool
 726 FcPatternAddMatrix (FcPattern *p, const char *object, const FcMatrix *s);
 727
 728 FcBool
 729 FcPatternAddCharSet (FcPattern *p, const char *object, const FcCharSet *c);
 730
 731 FcBool
 732 FcPatternAddBool (FcPattern *p, const char *object, FcBool b);
 733
 734 FcBool
 735 FcPatternAddLangSet (FcPattern *p, const char *object, const FcLangSet *ls);
 736
 737 FcResult
 738 FcPatternGetInteger (const FcPattern *p, const char *object, int n, int *i);
 739
 740 FcResult
 741 FcPatternGetDouble (const FcPattern *p, const char *object, int n, double *d);
 742
 743 FcResult
 744 FcPatternGetString (const FcPattern *p, const char *object, int n, FcChar8 ** s);
 745
 746 FcResult
 747 FcPatternGetMatrix (const FcPattern *p, const char *object, int n, FcMatrix **s);
 748
 749 FcResult
 750 FcPatternGetCharSet (const FcPattern *p, const char *object, int n, FcCharSet **c);
 751
 752 FcResult
 753 FcPatternGetBool (const FcPattern *p, const char *object, int n, FcBool *b);
 754
 755 FcResult
 756 FcPatternGetLangSet (const FcPattern *p, const char *object, int n, FcLangSet **ls);
 757
 758 FcPattern *
 759 FcPatternVaBuild (FcPattern *orig, va_list va);
 760
 761 FcPattern *
 762 FcPatternBuild (FcPattern *orig, ...) FC_ATTRIBUTE_SENTINEL(0);
 763
 764 /* fcstr.c */
 765
 766 FcChar8 *
 767 FcStrCopy (const FcChar8 *s);
 768
 769 FcChar8 *
 770 FcStrCopyFilename (const FcChar8 *s);
 771
 772 /* These are ASCII only, suitable only for pattern element names */
 773 #define FcIsUpper(c)    ((0101 <= (c) && (c) <= 0132))
 774 #define FcIsLower(c)    ((0141 <= (c) && (c) <= 0172))
 775 #define FcToLower(c)    (FcIsUpper(c) ? (c) - 0101 + 0141 : (c))
 776
 777 FcChar8 *
 778 FcStrDowncase (const FcChar8 *s);
 779
 780 int
 781 FcStrCmpIgnoreCase (const FcChar8 *s1, const FcChar8 *s2);
 782
 783 int
 784 FcStrCmp (const FcChar8 *s1, const FcChar8 *s2);
 785
 786 const FcChar8 *
 787 FcStrStrIgnoreCase (const FcChar8 *s1, const FcChar8 *s2);
 788
 789 const FcChar8 *
 790 FcStrStr (const FcChar8 *s1, const FcChar8 *s2);
 791
 792 int
 793 FcUtf8ToUcs4 (const FcChar8 *src_orig,
 794               FcChar32      *dst,
 795               int           len);
 796
 797 FcBool
 798 FcUtf8Len (const FcChar8    *string,
 799            int              len,
 800            int              *nchar,
 801            int              *wchar);
 802
 803 #define FC_UTF8_MAX_LEN 6
 804
 805 int
 806 FcUcs4ToUtf8 (FcChar32  ucs4,
 807               FcChar8   dest[FC_UTF8_MAX_LEN]);
 808
 809 int
 810 FcUtf16ToUcs4 (const FcChar8    *src_orig,
 811                FcEndian         endian,
 812                FcChar32         *dst,
 813                int              len);       /* in bytes */
 814
 815 FcBool
 816 FcUtf16Len (const FcChar8   *string,
 817             FcEndian        endian,
 818             int             len,            /* in bytes */
 819             int             *nchar,
 820             int             *wchar);
 821
 822 FcChar8 *
 823 FcStrDirname (const FcChar8 *file);
 824
 825 FcChar8 *
 826 FcStrBasename (const FcChar8 *file);
 827
 828 FcStrSet *
 829 FcStrSetCreate (void);
 830
 831 FcBool
 832 FcStrSetMember (FcStrSet *set, const FcChar8 *s);
 833
 834 FcBool
 835 FcStrSetEqual (FcStrSet *sa, FcStrSet *sb);
 836
 837 FcBool
 838 FcStrSetAdd (FcStrSet *set, const FcChar8 *s);
 839
 840 FcBool
 841 FcStrSetAddFilename (FcStrSet *set, const FcChar8 *s);
 842
 843 FcBool
 844 FcStrSetDel (FcStrSet *set, const FcChar8 *s);
 845
 846 void
 847 FcStrSetDestroy (FcStrSet *set);
 848
 849 FcStrList *
 850 FcStrListCreate (FcStrSet *set);
 851
 852 FcChar8 *
 853 FcStrListNext (FcStrList *list);
 854
 855 void
 856 FcStrListDone (FcStrList *list);
 857
 858 /* fcxml.c */
 859 FcBool
 860 FcConfigParseAndLoad (FcConfig *config, const FcChar8 *file, FcBool complain);
 861
 862 _FCFUNCPROTOEND
 863
 864 #undef FC_ATTRIBUTE_SENTINEL
 865
 866 #endif /* _FONTCONFIG_H_ */