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