fontconfig/fontconfig.h

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