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