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 1
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 *
546FcDirCacheRescan (const FcChar8 *dir, FcConfig *config);
547
548FcPublic FcCache *
549FcDirCacheRead (const FcChar8 *dir, FcBool force, FcConfig *config);
550
551FcPublic FcCache *
552FcDirCacheLoadFile (const FcChar8 *cache_file, struct stat *file_stat);
553
554FcPublic void
555FcDirCacheUnload (FcCache *cache);
556
557/* fcfreetype.c */
558FcPublic FcPattern *
559FcFreeTypeQuery (const FcChar8 *file, int id, FcBlanks *blanks, int *count);
560
561/* fcfs.c */
562
563FcPublic FcFontSet *
564FcFontSetCreate (void);
565
566FcPublic void
567FcFontSetDestroy (FcFontSet *s);
568
569FcPublic FcBool
570FcFontSetAdd (FcFontSet *s, FcPattern *font);
571
572/* fcinit.c */
573FcPublic FcConfig *
574FcInitLoadConfig (void);
575
576FcPublic FcConfig *
577FcInitLoadConfigAndFonts (void);
578
579FcPublic FcBool
580FcInit (void);
581
582FcPublic void
583FcFini (void);
584
585FcPublic int
586FcGetVersion (void);
587
588FcPublic FcBool
589FcInitReinitialize (void);
590
591FcPublic FcBool
592FcInitBringUptoDate (void);
593
594/* fclang.c */
595FcPublic FcStrSet *
596FcGetLangs (void);
597
598FcPublic FcChar8 *
599FcLangNormalize (const FcChar8 *lang);
600
601FcPublic const FcCharSet *
602FcLangGetCharSet (const FcChar8 *lang);
603
604FcPublic FcLangSet*
605FcLangSetCreate (void);
606
607FcPublic void
608FcLangSetDestroy (FcLangSet *ls);
609
610FcPublic FcLangSet*
611FcLangSetCopy (const FcLangSet *ls);
612
613FcPublic FcBool
614FcLangSetAdd (FcLangSet *ls, const FcChar8 *lang);
615
616FcPublic FcBool
617FcLangSetDel (FcLangSet *ls, const FcChar8 *lang);
618
619FcPublic FcLangResult
620FcLangSetHasLang (const FcLangSet *ls, const FcChar8 *lang);
621
622FcPublic FcLangResult
623FcLangSetCompare (const FcLangSet *lsa, const FcLangSet *lsb);
624
625FcPublic FcBool
626FcLangSetContains (const FcLangSet *lsa, const FcLangSet *lsb);
627
628FcPublic FcBool
629FcLangSetEqual (const FcLangSet *lsa, const FcLangSet *lsb);
630
631FcPublic FcChar32
632FcLangSetHash (const FcLangSet *ls);
633
634FcPublic FcStrSet *
635FcLangSetGetLangs (const FcLangSet *ls);
636
637FcPublic FcLangSet *
638FcLangSetUnion (const FcLangSet *a, const FcLangSet *b);
639
640FcPublic FcLangSet *
641FcLangSetSubtract (const FcLangSet *a, const FcLangSet *b);
642
643/* fclist.c */
644FcPublic FcObjectSet *
645FcObjectSetCreate (void);
646
647FcPublic FcBool
648FcObjectSetAdd (FcObjectSet *os, const char *object);
649
650FcPublic void
651FcObjectSetDestroy (FcObjectSet *os);
652
653FcPublic FcObjectSet *
654FcObjectSetVaBuild (const char *first, va_list va);
655
656FcPublic FcObjectSet *
657FcObjectSetBuild (const char *first, ...) FC_ATTRIBUTE_SENTINEL(0);
658
659FcPublic FcFontSet *
660FcFontSetList (FcConfig *config,
661 FcFontSet **sets,
662 int nsets,
663 FcPattern *p,
664 FcObjectSet *os);
665
666FcPublic FcFontSet *
667FcFontList (FcConfig *config,
668 FcPattern *p,
669 FcObjectSet *os);
670
671/* fcatomic.c */
672
673FcPublic FcAtomic *
674FcAtomicCreate (const FcChar8 *file);
675
676FcPublic FcBool
677FcAtomicLock (FcAtomic *atomic);
678
679FcPublic FcChar8 *
680FcAtomicNewFile (FcAtomic *atomic);
681
682FcPublic FcChar8 *
683FcAtomicOrigFile (FcAtomic *atomic);
684
685FcPublic FcBool
686FcAtomicReplaceOrig (FcAtomic *atomic);
687
688FcPublic void
689FcAtomicDeleteNew (FcAtomic *atomic);
690
691FcPublic void
692FcAtomicUnlock (FcAtomic *atomic);
693
694FcPublic void
695FcAtomicDestroy (FcAtomic *atomic);
696
697/* fcmatch.c */
698FcPublic FcPattern *
699FcFontSetMatch (FcConfig *config,
700 FcFontSet **sets,
701 int nsets,
702 FcPattern *p,
703 FcResult *result);
704
705FcPublic FcPattern *
706FcFontMatch (FcConfig *config,
707 FcPattern *p,
708 FcResult *result);
709
710FcPublic FcPattern *
711FcFontRenderPrepare (FcConfig *config,
712 FcPattern *pat,
713 FcPattern *font);
714
715FcPublic FcFontSet *
716FcFontSetSort (FcConfig *config,
717 FcFontSet **sets,
718 int nsets,
719 FcPattern *p,
720 FcBool trim,
721 FcCharSet **csp,
722 FcResult *result);
723
724FcPublic FcFontSet *
725FcFontSort (FcConfig *config,
726 FcPattern *p,
727 FcBool trim,
728 FcCharSet **csp,
729 FcResult *result);
730
731FcPublic void
732FcFontSetSortDestroy (FcFontSet *fs);
733
734/* fcmatrix.c */
735FcPublic FcMatrix *
736FcMatrixCopy (const FcMatrix *mat);
737
738FcPublic FcBool
739FcMatrixEqual (const FcMatrix *mat1, const FcMatrix *mat2);
740
741FcPublic void
742FcMatrixMultiply (FcMatrix *result, const FcMatrix *a, const FcMatrix *b);
743
744FcPublic void
745FcMatrixRotate (FcMatrix *m, double c, double s);
746
747FcPublic void
748FcMatrixScale (FcMatrix *m, double sx, double sy);
749
750FcPublic void
751FcMatrixShear (FcMatrix *m, double sh, double sv);
752
753/* fcname.c */
754
755/* Deprecated. Does nothing. Returns FcFalse. */
756FcPublic FcBool
757FcNameRegisterObjectTypes (const FcObjectType *types, int ntype);
758
759/* Deprecated. Does nothing. Returns FcFalse. */
760FcPublic FcBool
761FcNameUnregisterObjectTypes (const FcObjectType *types, int ntype);
762
763FcPublic const FcObjectType *
764FcNameGetObjectType (const char *object);
765
766/* Deprecated. Does nothing. Returns FcFalse. */
767FcPublic FcBool
768FcNameRegisterConstants (const FcConstant *consts, int nconsts);
769
770/* Deprecated. Does nothing. Returns FcFalse. */
771FcPublic FcBool
772FcNameUnregisterConstants (const FcConstant *consts, int nconsts);
773
774FcPublic const FcConstant *
775FcNameGetConstant (const FcChar8 *string);
776
777FcPublic FcBool
778FcNameConstant (const FcChar8 *string, int *result);
779
780FcPublic FcPattern *
781FcNameParse (const FcChar8 *name);
782
783FcPublic FcChar8 *
784FcNameUnparse (FcPattern *pat);
785
786/* fcpat.c */
787FcPublic FcPattern *
788FcPatternCreate (void);
789
790FcPublic FcPattern *
791FcPatternDuplicate (const FcPattern *p);
792
793FcPublic void
794FcPatternReference (FcPattern *p);
795
796FcPublic FcPattern *
797FcPatternFilter (FcPattern *p, const FcObjectSet *os);
798
799FcPublic void
800FcValueDestroy (FcValue v);
801
802FcPublic FcBool
803FcValueEqual (FcValue va, FcValue vb);
804
805FcPublic FcValue
806FcValueSave (FcValue v);
807
808FcPublic void
809FcPatternDestroy (FcPattern *p);
810
811FcPublic FcBool
812FcPatternEqual (const FcPattern *pa, const FcPattern *pb);
813
814FcPublic FcBool
815FcPatternEqualSubset (const FcPattern *pa, const FcPattern *pb, const FcObjectSet *os);
816
817FcPublic FcChar32
818FcPatternHash (const FcPattern *p);
819
820FcPublic FcBool
821FcPatternAdd (FcPattern *p, const char *object, FcValue value, FcBool append);
822
823FcPublic FcBool
824FcPatternAddWeak (FcPattern *p, const char *object, FcValue value, FcBool append);
825
826FcPublic FcResult
827FcPatternGet (const FcPattern *p, const char *object, int id, FcValue *v);
828
829FcPublic FcBool
830FcPatternDel (FcPattern *p, const char *object);
831
832FcPublic FcBool
833FcPatternRemove (FcPattern *p, const char *object, int id);
834
835FcPublic FcBool
836FcPatternAddInteger (FcPattern *p, const char *object, int i);
837
838FcPublic FcBool
839FcPatternAddDouble (FcPattern *p, const char *object, double d);
840
841FcPublic FcBool
842FcPatternAddString (FcPattern *p, const char *object, const FcChar8 *s);
843
844FcPublic FcBool
845FcPatternAddMatrix (FcPattern *p, const char *object, const FcMatrix *s);
846
847FcPublic FcBool
848FcPatternAddCharSet (FcPattern *p, const char *object, const FcCharSet *c);
849
850FcPublic FcBool
851FcPatternAddBool (FcPattern *p, const char *object, FcBool b);
852
853FcPublic FcBool
854FcPatternAddLangSet (FcPattern *p, const char *object, const FcLangSet *ls);
855
856FcPublic FcResult
857FcPatternGetInteger (const FcPattern *p, const char *object, int n, int *i);
858
859FcPublic FcResult
860FcPatternGetDouble (const FcPattern *p, const char *object, int n, double *d);
861
862FcPublic FcResult
863FcPatternGetString (const FcPattern *p, const char *object, int n, FcChar8 ** s);
864
865FcPublic FcResult
866FcPatternGetMatrix (const FcPattern *p, const char *object, int n, FcMatrix **s);
867
868FcPublic FcResult
869FcPatternGetCharSet (const FcPattern *p, const char *object, int n, FcCharSet **c);
870
871FcPublic FcResult
872FcPatternGetBool (const FcPattern *p, const char *object, int n, FcBool *b);
873
874FcPublic FcResult
875FcPatternGetLangSet (const FcPattern *p, const char *object, int n, FcLangSet **ls);
876
877FcPublic FcPattern *
878FcPatternVaBuild (FcPattern *p, va_list va);
879
880FcPublic FcPattern *
881FcPatternBuild (FcPattern *p, ...) FC_ATTRIBUTE_SENTINEL(0);
882
883FcPublic FcChar8 *
884FcPatternFormat (FcPattern *pat, const FcChar8 *format);
885
886/* fcstr.c */
887
888FcPublic FcChar8 *
889FcStrCopy (const FcChar8 *s);
890
891FcPublic FcChar8 *
892FcStrCopyFilename (const FcChar8 *s);
893
894FcPublic FcChar8 *
895FcStrPlus (const FcChar8 *s1, const FcChar8 *s2);
896
897FcPublic void
898FcStrFree (FcChar8 *s);
899
900/* These are ASCII only, suitable only for pattern element names */
901#define FcIsUpper(c) ((0101 <= (c) && (c) <= 0132))
902#define FcIsLower(c) ((0141 <= (c) && (c) <= 0172))
903#define FcToLower(c) (FcIsUpper(c) ? (c) - 0101 + 0141 : (c))
904
905FcPublic FcChar8 *
906FcStrDowncase (const FcChar8 *s);
907
908FcPublic int
909FcStrCmpIgnoreCase (const FcChar8 *s1, const FcChar8 *s2);
910
911FcPublic int
912FcStrCmp (const FcChar8 *s1, const FcChar8 *s2);
913
914FcPublic const FcChar8 *
915FcStrStrIgnoreCase (const FcChar8 *s1, const FcChar8 *s2);
916
917FcPublic const FcChar8 *
918FcStrStr (const FcChar8 *s1, const FcChar8 *s2);
919
920FcPublic int
921FcUtf8ToUcs4 (const FcChar8 *src_orig,
922 FcChar32 *dst,
923 int len);
924
925FcPublic FcBool
926FcUtf8Len (const FcChar8 *string,
927 int len,
928 int *nchar,
929 int *wchar);
930
931#define FC_UTF8_MAX_LEN 6
932
933FcPublic int
934FcUcs4ToUtf8 (FcChar32 ucs4,
935 FcChar8 dest[FC_UTF8_MAX_LEN]);
936
937FcPublic int
938FcUtf16ToUcs4 (const FcChar8 *src_orig,
939 FcEndian endian,
940 FcChar32 *dst,
941 int len); /* in bytes */
942
943FcPublic FcBool
944FcUtf16Len (const FcChar8 *string,
945 FcEndian endian,
946 int len, /* in bytes */
947 int *nchar,
948 int *wchar);
949
950FcPublic FcChar8 *
951FcStrDirname (const FcChar8 *file);
952
953FcPublic FcChar8 *
954FcStrBasename (const FcChar8 *file);
955
956FcPublic FcStrSet *
957FcStrSetCreate (void);
958
959FcPublic FcBool
960FcStrSetMember (FcStrSet *set, const FcChar8 *s);
961
962FcPublic FcBool
963FcStrSetEqual (FcStrSet *sa, FcStrSet *sb);
964
965FcPublic FcBool
966FcStrSetAdd (FcStrSet *set, const FcChar8 *s);
967
968FcPublic FcBool
969FcStrSetAddFilename (FcStrSet *set, const FcChar8 *s);
970
971FcPublic FcBool
972FcStrSetDel (FcStrSet *set, const FcChar8 *s);
973
974FcPublic void
975FcStrSetDestroy (FcStrSet *set);
976
977FcPublic FcStrList *
978FcStrListCreate (FcStrSet *set);
979
980FcPublic void
981FcStrListFirst (FcStrList *list);
982
983FcPublic FcChar8 *
984FcStrListNext (FcStrList *list);
985
986FcPublic void
987FcStrListDone (FcStrList *list);
988
989/* fcxml.c */
990FcPublic FcBool
991FcConfigParseAndLoad (FcConfig *config, const FcChar8 *file, FcBool complain);
992
993_FCFUNCPROTOEND
994
995#undef FC_ATTRIBUTE_SENTINEL
996
997
998#ifndef _FCINT_H_
999
1000/*
1001 * Deprecated functions are placed here to help users fix their code without
1002 * digging through documentation
1003 */
1004
1005#define FcConfigGetRescanInverval FcConfigGetRescanInverval_REPLACE_BY_FcConfigGetRescanInterval
1006#define FcConfigSetRescanInverval FcConfigSetRescanInverval_REPLACE_BY_FcConfigSetRescanInterval
1007
1008#endif
1009
1010#endif /* _FONTCONFIG_H_ */
1011